Method: organizations.locations.workloads.create

Creates Assured Workload.

HTTP request

POST https://{endpoint}/v1/{parent=organizations/*/locations/*}/workloads

Where {endpoint} is one of the supported service endpoints.

The URLs use gRPC Transcoding syntax.

Path parameters



Required. The resource name of the new Workload's parent. Must be of the form organizations/{org_id}/locations/{locationId}.

Authorization requires the following IAM permission on the specified resource parent:

  • assuredworkloads.workload.create

Query parameters



Optional. A identifier associated with the workload and underlying projects which allows for the break down of billing costs for a workload. The value provided for the identifier will add a label to the workload and contained projects with the identifier as the value.

Request body

The request body contains an instance of Workload.

Response body

If successful, the response body contains a newly created instance of Operation.

Authorization scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the parent resource:

  • assuredworkloads.workload.create

For more information, see the IAM documentation.