Required. The project and location to create the zone in. Format: projects/{project}/locations/{location}
Query parameters
Parameters
zoneId
string
Optional. ID used to uniquely identify the Zone within its parent scope. This field should contain at most 63 characters and must start with lowercase characters. Only lowercase characters, numbers and - are accepted. The - character cannot be the first or the last one. A system generated ID will be used if the field is not set.
The zone.name field in the request will be ignored.
requestId
string
Optional. An optional unique identifier for this request. See AIP-155.
[[["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-07-11 UTC."],[[["\u003cp\u003eThis API creates a new zone within a specified project and location using a POST request.\u003c/p\u003e\n"],["\u003cp\u003eThe request URL utilizes gRPC Transcoding syntax and requires the \u003ccode\u003eparent\u003c/code\u003e path parameter for the project and location.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters \u003ccode\u003ezoneId\u003c/code\u003e and \u003ccode\u003erequestId\u003c/code\u003e allow for custom zone identification and request tracking.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain a \u003ccode\u003eZone\u003c/code\u003e resource, while the successful response provides an \u003ccode\u003eOperation\u003c/code\u003e resource.\u003c/p\u003e\n"],["\u003cp\u003eCreating a new zone requires the \u003ccode\u003egdchardwaremanagement.zones.create\u003c/code\u003e IAM permission and the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.zones.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- [Try it!](#try-it)\n\nCreates a new zone in a given project and location.\n\n### HTTP request\n\n`POST https://gdchardwaremanagement.googleapis.com/v1alpha/{parent=projects/*/locations/*}/zones`\n\nThe URL uses [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 [Zone](/distributed-cloud/edge/latest/docs/reference/hardware/rest/v1alpha/projects.locations.zones#Zone).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Operation](/distributed-cloud/edge/latest/docs/reference/hardware/rest/v1alpha/projects.locations.operations#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- `gdchardwaremanagement.zones.create`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]
