Batch requests

From a Cloud API perspective, a batch request is a set of requests that are executed in a non-transactional sequence. Each call within the batch request is referred to as a subrequest. The object that contains all of the subrequests is referred to as the main request.

Subrequests are executed serially, in the order they are specified in the request payload. PolicyCenter then gathers the responses to each subrequest and returns them in a single response payload. Once again, the subresponses appear in the same order as the corresponding subrequests.

When the response to a batch request contains a response code of 200, it means the batch request itself was well-formed. However, each individual subrequest may have succeeded or failed.

Batch requests are limited to a maximum number of subrequests. The maximum is specified by the MaximumAllowedNumberOfBatchSubRequests configuration parameter. In the base configuration, this parameter is set to 100. Batch requests with more than the maximum number of subrequests fail with a BadInputException. For more information on modifying the maximum number of subrequests, see Configuring the maximum number of subrequests.