Delete Partition OS Message
The Delete Partition OS Message operation deletes a single OS message.
HTTP method and URI
POST /api/partitions/{partition-id}/operations/delete-os-message
In this request, the URI variable {partition-id} is the object ID of the target partition.
Request body contents
The request body is expected to contain a JSON object with the following fields:
Name | Type | Rqd/Opt | Description |
---|---|---|---|
sequence-number | Long | Required |
The sequence-number property of the OS message on the partition to delete. |
Description
This operation deletes a specific partition OS message. The OS message to be deleted is uniquely identified by the combination of the {partition-id} variable in the URI and the sequence-number in the request body.
The URI path must designate an existing partition and the API user must have object-access permission to it; otherwise status code 404 (Not Found) is returned.
The request body must designate an existing OS message; otherwise, status code 404 (Not Found) is returned. In addition, the API user must have Action/Task permission to the Operating System Messages task; otherwise, status code 403 (Forbidden) is returned.
Authorization requirements
- Object-access permission to the Partition object designated by {partition-id}.
- Action/task permission for the Operating System Messages task.
HTTP status and reason codes
On success, HTTP status code 204 (No Content) is returned with no response body provided.
The following HTTP status codes are returned for the indicated errors. 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) | 1 | The API user does not have action/task permission for the Operating System Messages task. |
404 (Not Found) | 1 | The object ID in the URI {partition-id} does not designate an existing Partition object, or the API user does not have object-access permission to the object. |
336 | The sequence-number in the request body does not designate an existing OS message on the partition. | |
409 (Conflict) | 332 | The messages interface is not available. |
Additional standard status and reason codes can be returned, as described in Invoking API operations.