GET Work Request Status
get
/20210415/workRequests/{work_request_id}
Gets the status of the work request with the given ID.
Request
Supported Media Types
- application/json
Path Parameters
-
workRequestId(required): string
Minimum Length:
1
Maximum Length:255
The OCID of the work request.
Header Parameters
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. Provide this request OCID if you need to contact Oracle about this request.
Response
Supported Media Types
- application/json
200 Response
The detail of the work request.
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
-
retry-after: integer
A decimal number representing the number of seconds the client should wait before polling this endpoint again.
Root Schema : WorkRequest
Type:
object
An asynchronous work request.
Show Source
-
compartmentId(required):
string
The OCID of the compartment that contains the work request.
-
id(required):
string
The OCID of the work request.
-
operationType(required):
string
The asynchronous operation tracked by this work request.
-
percentComplete(required):
number(float)
The percentage complete of the operation tracked by this work request.
-
resources(required):
array resources
The resources that are affected by this work request.
-
status(required):
string
Allowed Values:
[ "ACCEPTED", "IN_PROGRESS", "FAILED", "SUCCEEDED", "CANCELING", "CANCELED" ]
The status of the work request. -
timeAccepted(required):
string(date-time)
The date and time the work request was created, in the format defined by [RFC 3339](https://tools.ietf.org/html/rfc3339).
-
timeFinished:
string(date-time)
The date and time the work request reached a terminal state, either FAILED or SUCCEEDED, in the format defined by RFC3339.
-
timeStarted:
string(date-time)
The date and time the work request transitioned from ACCEPTED to IN_PROGRESS, in the format defined by RFC3339.
Nested Schema : resources
Type:
array
The resources that are affected by this work request.
Show Source
-
Array of:
object WorkRequestResource
A resource that is created or operated on by an asynchronous operation that is tracked by a work request.
Nested Schema : WorkRequestResource
Type:
object
A resource that is created or operated on by an asynchronous operation that is tracked by a work request.
Show Source
-
actionType(required):
string
Allowed Values:
[ "CREATED", "UPDATED", "DELETED", "RELATED", "IN_PROGRESS", "FAILED" ]
The way in which this resource was affected by the operation that spawned the work request. -
entityType(required):
string
The resource type the work request affects.
-
entityUri:
string
The URI path that you can use for a GET request to access the resource metadata.
-
identifier(required):
string
An OCID or other unique identifier for the resource.
400 Response
Bad Request
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
object
The properties that define an error.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm).
-
message(required):
string
A human-readable error string.
401 Response
Unauthorized
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
object
The properties that define an error.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm).
-
message(required):
string
A human-readable error string.
404 Response
Not Found
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
object
The properties that define an error.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm).
-
message(required):
string
A human-readable error string.
429 Response
Too Many Requests
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
object
The properties that define an error.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm).
-
message(required):
string
A human-readable error string.
500 Response
Internal Server Error
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
object
The properties that define an error.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm).
-
message(required):
string
A human-readable error string.
Default Response
Unknown Error
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you must contact Oracle about a particular request, then provide the request identifier.
Root Schema : Error
Type:
object
The properties that define an error.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm).
-
message(required):
string
A human-readable error string.