Required. The project and location to create hardware in. Format: projects/{project}/locations/{location}
Query parameters
Parameters
hardwareId
string
Optional. ID used to uniquely identify the Hardware 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 hardware.name field in the request will be ignored.
Request body
The request body contains an instance of Hardware.
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-07-11 UTC."],[[["\u003cp\u003eThis endpoint facilitates the creation of new hardware within a specified project and location using a \u003ccode\u003ePOST\u003c/code\u003e request to a designated URL.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter is required to indicate the project and location, and an optional \u003ccode\u003ehardwareId\u003c/code\u003e query parameter can be used to specify a unique ID for the hardware.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include an instance of the \u003ccode\u003eHardware\u003c/code\u003e resource, and a successful request will return an \u003ccode\u003eOperation\u003c/code\u003e resource in the response body.\u003c/p\u003e\n"],["\u003cp\u003eCreating hardware requires the \u003ccode\u003egdchardwaremanagement.hardware.create\u003c/code\u003e IAM permission on the \u003ccode\u003eparent\u003c/code\u003e resource and the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.hardware.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 new hardware in a given project and location.\n\n### HTTP request\n\n`POST https://gdchardwaremanagement.googleapis.com/v1alpha/{parent=projects/*/locations/*}/hardware`\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 [Hardware](/distributed-cloud/edge/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.hardware#Hardware).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Operation](/distributed-cloud/edge/1.7.0/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](https://cloud.google.com/docs/authentication/).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource:\n\n- `gdchardwaremanagement.hardware.create`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]
