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
Parameters
externalId
string
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-30 UTC."],[[["\u003cp\u003eThis page details the process of creating an Assured Workload using a \u003ccode\u003ePOST\u003c/code\u003e HTTP request to a specific endpoint, formatted as \u003ccode\u003ehttps://{endpoint}/v1beta1/{parent=organizations/*/locations/*}/workloads\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter, in the format \u003ccode\u003eorganizations/{org_id}/locations/{locationId}\u003c/code\u003e, is required and necessitates the \u003ccode\u003eassuredworkloads.workload.create\u003c/code\u003e IAM permission.\u003c/p\u003e\n"],["\u003cp\u003eAn optional \u003ccode\u003eexternalId\u003c/code\u003e query parameter can be provided to associate a billing identifier with the workload and its underlying projects.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include an instance of \u003ccode\u003eWorkload\u003c/code\u003e, and a successful response will return a newly created \u003ccode\u003eOperation\u003c/code\u003e instance.\u003c/p\u003e\n"],["\u003cp\u003eCreating a workload requires the OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e and the \u003ccode\u003eassuredworkloads.workload.create\u003c/code\u003e IAM permission on the \u003ccode\u003eparent\u003c/code\u003e resource.\u003c/p\u003e\n"]]],[],null,["# Method: organizations.locations.workloads.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n\nCreates Assured Workload.\n\n### HTTP request\n\n`POST https://{endpoint}/v1beta1/{parent=organizations/*/locations/*}/workloads`\n\nWhere `{endpoint}` is one of the [supported service endpoints](/assured-workloads/docs/reference/rest#rest_endpoints).\n\nThe URLs use [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body contains an instance of [Workload](/assured-workloads/docs/reference/rest/v1beta1/organizations.locations.workloads#Workload).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Operation](/assured-workloads/docs/reference/rest/Shared.Types/ListOperationsResponse#Operation).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource:\n\n- `assuredworkloads.workload.create`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]
