--- title: "POST /listSimulationJobBatches" method: POST path: "/listSimulationJobBatches" --- # POST /listSimulationJobBatches `POST /listSimulationJobBatches` Returns a list simulation job batches. You can optionally provide filters to retrieve specific simulation batch jobs. ## Query parameters - `maxResults` string - `nextToken` string ## Request body - object - `nextToken` string — If the previous paginated request did not return all of the remaining results, the response object's nextToken parameter value is set to a token. To retrieve the next set of results, call ListSimulationJobBatches again and assign that token to the request object's nextToken parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null. - `maxResults` integer — When this parameter is used, ListSimulationJobBatches only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListSimulationJobBatches request with the returned nextToken value. - `filters` Filter[] — Optional filters to limit results. - `name` string — The name of the filter. - `values` Name[] — A list of values. ## Response `200` Success - ListSimulationJobBatchesResponse - `simulationJobBatchSummaries` SimulationJobBatchSummary[] — A list of simulation job batch summaries. - `arn` string — The Amazon Resource Name (ARN) of the batch. - `lastUpdatedAt` string, date-time — The time, in milliseconds since the epoch, when the simulation job batch was last updated. - `createdAt` string, date-time — The time, in milliseconds since the epoch, when the simulation job batch was created. - `status` 'Pending' | 'InProgress' | 'Failed' | 'Completed' | 'Canceled' | 'Canceling' | 'Completing' | 'TimingOut' | 'TimedOut' —

The status of the simulation job batch.

Pending

The simulation job batch request is pending.

InProgress

The simulation job batch is in progress.

Failed

The simulation job batch failed. One or more simulation job requests could not be completed due to an internal failure (like InternalServiceError). See failureCode and failureReason for more information.

Completed

The simulation batch job completed. A batch is complete when (1) there are no pending simulation job requests in the batch and none of the failed simulation job requests are due to InternalServiceError and (2) when all created simulation jobs have reached a terminal state (for example, Completed or Failed).

Canceled

The simulation batch job was cancelled.

Canceling

The simulation batch job is being cancelled.

Completing

The simulation batch job is completing.

TimingOut

The simulation job batch is timing out.

If a batch timing out, and there are pending requests that were failing due to an internal failure (like InternalServiceError), the batch status will be Failed. If there are no such failing request, the batch status will be TimedOut.

TimedOut

The simulation batch job timed out.

- `failedRequestCount` integer — The number of failed simulation job requests. - `pendingRequestCount` integer — The number of pending simulation job requests. - `createdRequestCount` integer — The number of created simulation job requests. - `nextToken` string — If the previous paginated request did not return all of the remaining results, the response object's nextToken parameter value is set to a token. To retrieve the next set of results, call ListSimulationJobBatches again and assign that token to the request object's nextToken parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null. ## Other responses - `480` — InvalidParameterException - `481` — InternalServerException --- [API](https://skmtc.net/aws/apis/robomaker.md) · [All operations](https://skmtc.net/aws/apis/robomaker/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/robomaker/versions/a6f68d7d4866/schema)