List Work Requests
get
/20191010/workRequests
Lists the work requests in a compartment.
Request
Supported Media Types
- application/json
Query Parameters
-
blockchainPlatformId(required): string
Unique service identifier.
-
compartmentId(required): string
The ID of the compartment in which to list resources.
-
limit: integer
Minimum Value:
1
Maximum Value:1000
The maximum number of items to return.Default Value:10
-
page: string
Minimum Length:
1
Maximum Length:2048
The page at which to start retrieving results. -
sortBy: string
The field to sort by. Only one sort order may be provided. Default order for TIMESTARTED is descending. Default order for WORKREQUESTID is ascending. If no value is specified TIMESTARTED is default.Default Value:
timeStarted
Allowed Values:[ "timeStarted", "workRequestId" ]
-
sortOrder: string
The sort order to use, either 'ASC' for ascending or 'DESC' for decending.Default Value:
ASC
Allowed Values:[ "ASC", "DESC" ]
Header Parameters
-
opc-request-id: string
The client request ID for tracing.
Response
Supported Media Types
- application/json
200 Response
The list of work requests.
Headers
-
opc-next-page: string
For pagination of a list of items. When paging through a list, if this header appears in the response, then a partial list might have been returned. Include this value as the `page` parameter for the subsequent GET request to get the next batch of items.
-
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 : WorkRequestCollection
Type:
object
Result of a platform list or search. Contains WorkRequestSummary
Show Source
-
items(required):
array items
Collection of WorkRequestSummary
Nested Schema : items
Type:
array
Collection of WorkRequestSummary
Show Source
-
Array of:
object WorkRequestSummary
A description of workrequest status
Nested Schema : WorkRequestSummary
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:
string
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.