Features that execute multiple requests at once

Cloud API has several features that let caller applications execute multiple requests in a single call: request inclusion, batch requests, and composite requests.

Request inclusion is a technique for POSTs and PATCHes in which the call consists of the following:

• A single parent request that creates or modifies a resource
• One or more child requests that create or modify resources related to the parent resource

If either the parent request or any child request fails, the entire request fails.

For details about request inclusion, see Request inclusion.

Batch requests are requests which consist of multiple sibling subrequests, with no parent request. Each subrequest is executed non-transactionally in the order it appears. If a given subrequest fails, other subrequests in the batch might still be attempted. Also, there is no mechanism for passing information from one subrequest to another. Each subrequest is essentially independent from the others.

For details about batch requests, see Batch requests.

Composite requests are requests which consist of multiple sibling subrequests, with no parent request. Each subrequest is executed transactionally in the order it appears. If a given subrequest that attempts to commit data fails, the entire composite request fails. Information can be passed from one subrequest to another.

For details about composite requests, see Composite requests.