Driver status codes

The Platform Orchestrator Drivers use the following HTTP status codes convention:

HTTP 200 - OK #

This status code indicates that the request has succeeded. For the GET and PUT endpoints, this code indicates that the resource is available and the response body contains a DriverOutputs object.

HTTP 202 - Accepted #

This status code indicates that the request has been accepted for processing, but the processing is not yet complete.

For GET, PUT, and DELETE endpoints, this code denotes an ongoing asynchronous operation. The response body contains an AsyncProgressHint object that provides information about the progress of the operation.

HTTP 204 - No Content #

This status code indicates that the server has successfully fulfilled the request, and there’s no additional content to send in the response payload body.

For the DELETE endpoint, this code indicates that the resource has been successfully deleted or wasn’t found.

HTTP 404 - Not Found #

This status code indicates that the server can’t find the requested resource.

For the GET endpoint, it signifies that the requested resource is not found or has been deleted already.

HTTP 405 - Method Not Allowed #

This status code indicates that the server does not support the functionality required to fulfill the request.

For the GET endpoint, it signifies that the driver does not support this functionality and polling should be done with a PUT or DELETE method instead."

HTTP 409 - Conflict #

This status code indicates that the request could not be completed due to a conflict with the current state of the target resource.

For PUT and DELETE endpoints, this code is returned when resource creation/deletion is ongoing and can’t be cancelled, and the current request would result in a different configuration for the resource. The response body contains an AsyncProgressHint object based on the state of the current ongoing process.