Deactivate CPC
The Deactivate CPC operation deactivates the CPC object designated by {cpc-id}. This operation is not permitted when the CPC is enabled for DPM. This operation is supported using the BCPii interface.
HTTP method and URI
POST /api/cpcs/{cpc-id}/operations/deactivate
In this request, the URI variable {cpc-id} is the object ID of the target CPC object.
Request body contents
The request body is expected to contain a JSON object with the following fields. If none of the optional fields are included, an empty request body must be supplied.
Field name | Type | Rqd/Opt | Description |
---|---|---|---|
force | Boolean | Optional | Whether this operation is permitted when the CPC is in "operating" status (true) or not (false). The default is false. |
Response body contents
Once the operation is accepted, the response body contains a JSON object with the following fields:
Field name | Type | Description |
---|---|---|
job-uri | String/ URI | URI that may be queried to retrieve activation status updates. |
Asynchronous result description
Once the operation has completed, a job-completion notification is sent and results are available for the asynchronous portion of this operation. These results are retrieved using the Query Job Status operation directed at the job URI provided in the response body.
Field name | Type | Description |
---|---|---|
message | String | The message text describing the detailed error that occurred when the operation was partially successful or not successful. |
Description
Deactivation is an orderly process for shutting down and turning off the CPC.
Shutting down and turning off the CPC, referred to also as deactivating the CPC, includes:
- Ending hardware and software activity
- Clearing, releasing, and de-allocating hardware resources
- Turning off power.
When the operation is initiated, a 202 (Accepted) status code is returned. The response body includes a URI that may be queried to retrieve the status of the operation. See Query Job Status for information on how to query job status. When the operation has completed, an asynchronous result message is sent, with Job Status and Reason Codes seen in Job status and reason codes.
Authorization requirements
- For the web services interface:
- Object-access permission to the CPC object designated by {cpc-id}
- Action/task permission for the Deactivate task.
- For the BCPii interface the source partition must have receive BCPii security controls permissions for the CPC object.
HTTP status and reason codes
On success, HTTP status code 202 (Accepted) is returned and the response body is provided as described in Response body contents.
The following HTTP status codes are returned for the indicated errors, and the response body is a standard error response body providing the reason code indicated and associated error message.
HTTP error status code | Reason code | Description |
---|---|---|
400 (Bad Request) | Various | Errors were detected during common request validation. See Common request validation reason codes for a list of the possible reason codes. |
403 (Forbidden) | 0 | The request used the BCPii interface and the source partition does not have receive BCPii security controls permission for the CPC object. |
1 | The API user does not have the required permission for this operation. | |
404 (Not Found) | 1 | The object ID in the URI ({cpc-id}) does not designate an existing CPC object, or the API user does not have object-access permission to the object. |
409 (Conflict) | 4 | The operation cannot be preformed because the CPC object designated by {cpc-id} is currently enabled for DPM, which is not supported in this operation. |
329 | The operation cannot be performed because the CPC designated by the request URI is an unmanaged CPC, which is not supported by this operation. | |
500 (Server Error) | 280 | An IO exception occurred during the scheduling of the asynchronous request. |
503 (Service Unavailable) | 1 | The request could not be processed because the HMC is not communicating with the SE needed to perform the requested operation. |
Additional standard status and reason codes can be returned, as described in Invoking API operations.
Job status and reason codes
Job status code | Job reason code | Description |
---|---|---|
204 (No Content) | N/A | Operation completed successfully. |
500 (Server Error) | 263 | Operation failed or was rejected due to the current CPC status and use of the force=false parameter. If rejected due to force=false, the CPC status is unchanged. If the operation failed, the CPC status is unknown. Refer to the message parameter in the error response body for details. |
Additional standard status and reason codes can be returned, as described in Invoking API operations.
Usage note
This operation deactivates a CPC object that is not enabled for DPM. If the targeted CPC object is enabled for DPM, the Stop CPC operation may be used instead. Refer to Stop CPC for details.