Get Work Request Status
get
/20191010/workRequests/{workRequestId}
Gets the status of the work request with the given ID.
Request
Supported Media Types
- application/json
Path Parameters
-
workRequestId(required): string
The ID of the asynchronous request.
Header Parameters
-
opc-request-id: string
The client request ID for tracing.
Response
Supported Media Types
- application/json
200 Response
The detail of the work request.
Headers
-
etag: string
For optimistic concurrency control. See `if-match`.
-
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: number(float)
A decimal number representing the number of seconds the client should wait before polling this endpoint again.
Root Schema : WorkRequest
Type:
object
A description of workrequest status
Show Source
-
compartmentId(required):
string
The OCID of the compartment that contains the work request. Work requests should be scoped to the same compartment as the resource the work request affects. If the work request affects multiple resources, and those resources are not in the same compartment, it is up to the service team to pick the primary resource whose compartment should be used
-
id(required):
string
The ID of the work request.
-
operationType(required):
string
Allowed Values:
[ "CREATE_PLATFORM", "UPDATE_PLATFORM", "UPGRADE_PLATFORM", "DELETE_PLATFORM", "SCALE_PLATFORM", "START_PLATFORM", "STOP_PLATFORM", "CUSTOMIZE_PLATFORM", "SCALE_STORAGE", "WORKREQUEST_CLEANUP" ]
Type of the work request -
percentComplete(required):
number(float)
Percentage of the request completed.
-
resources(required):
array resources
The resources affected by this work request.
-
status(required):
string
Allowed Values:
[ "ACCEPTED", "IN_PROGRESS", "FAILED", "SUCCEEDED", "CANCELING", "CANCELED" ]
Status of current work request. -
timeAccepted(required):
string(date-time)
The date and time the request was created, as described in [RFC 3339](https://tools.ietf.org/rfc/rfc3339), section 14.29.
-
timeFinished:
string(date-time)
The date and time the object was finished, as described in [RFC 3339](https://tools.ietf.org/rfc/rfc3339).
-
timeStarted:
string(date-time)
The date and time the request was started, as described in [RFC 3339](https://tools.ietf.org/rfc/rfc3339), section 14.29.
Nested Schema : resources
Type:
array
The resources affected by this work request.
Show Source
-
Array of:
object WorkRequestResource
A resource created or operated on by a work request.
Nested Schema : WorkRequestResource
Type:
object
A resource created or operated on by a work request.
Show Source
-
actionType(required):
string
Allowed Values:
[ "CREATED", "UPDATED", "DELETED", "IN_PROGRESS", "RELATED" ]
The way in which this resource is affected by the work tracked in the work request. A resource being created, updated, or deleted will remain in the IN_PROGRESS state until work is complete for that resource at which point it will transition to CREATED, UPDATED, or DELETED, respectively. -
entityType(required):
string
The resource type the work request affects.
-
entityUri:
string
The URI path that the user can do a GET on to access the resource metadata
-
identifier(required):
string
The identifier of the resource the work request affects.
-
subTypeDetails:
array subTypeDetails
Collection of SubType information for a work request resource.
Nested Schema : subTypeDetails
Type:
array
Collection of SubType information for a work request resource.
Show Source
-
Array of:
object WorkRequestResourceSubTypeDetail
Subtype information for a work request resource.
Nested Schema : WorkRequestResourceSubTypeDetail
Type:
object
Subtype information for a work request resource.
Show Source
-
subType(required):
string
Subtype of the work request resource like OSN or peer.
-
subTypeKey(required):
string
The identifier of the resource subtype.
-
subTypeStatus(required):
string
Allowed Values:
[ "CREATED", "UPDATED", "DELETED" ]
Status of the resource subtype, as a result of the work tracked in this work request. The resource subtype would be CREATED, UPDATED or DELETED after the work request is completed.
400 Response
Bad Request
401 Response
Not authorized
404 Response
Invalid parameters
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
Error Information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error string.
500 Response
Service unavailable
Default Response
Unknown 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
Error Information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error string.