Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

GetWorkUnits

Retrieves the work units generated by the StartQueryPlanning operation.

Request Syntax


POST /GetWorkUnits HTTP/1.1
Content-type: application/json

{
   "NextToken": "string",
   "PageSize": number,
   "QueryId": "string"
}

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in JSON format.

NextToken

A continuation token, if this is a continuation call.

Type: String

Required: No

PageSize

The size of each page to get in the Amazon service call. This does not affect the number of items returned in the command's output. Setting a smaller page size results in more calls to the Amazon service, retrieving fewer items in each call. This can help prevent the Amazon service calls from timing out.

Type: Integer

Required: No

QueryId

The ID of the plan query operation.

Type: String

Length Constraints: Fixed length of 36.

Required: Yes

Response Syntax


HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "QueryId": "string",
   "WorkUnitRanges": [ 
      { 
         "WorkUnitIdMax": number,
         "WorkUnitIdMin": number,
         "WorkUnitToken": "string"
      }
   ]
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

NextToken

A continuation token for paginating the returned list of tokens, returned if the current segment of the list is not the last.

Type: String

QueryId

The ID of the plan query operation.

Type: String

WorkUnitRanges

A WorkUnitRangeList object that specifies the valid range of work unit IDs for querying the execution service.

Type: Array of WorkUnitRange objects

Errors

For information about the errors that are common to all actions, see Common Error Types.

AccessDeniedException

Access to a resource was denied.

Message: A message describing the problem.

HTTP Status Code: 403

ExpiredException

Contains details about an error where the query request expired.

Message: A message describing the error.

HTTP Status Code: 410

InternalServiceException

An internal service error occurred.

Message: A message describing the problem.

HTTP Status Code: 500

InvalidInputException

The input provided was not valid.

Message: A message describing the problem.

HTTP Status Code: 400

WorkUnitsNotReadyYetException

Contains details about an error related to work units not being ready.

Message: A message describing the error.

HTTP Status Code: 420