Required. The order to create the hardware group in. Format: projects/{project}/locations/{location}/orders/{order}
Query parameters
Parameters
hardwareGroupId
string
Optional. ID used to uniquely identify the HardwareGroup 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 hardwareGroup.name field in the request will be ignored.
requestId
string
Optional. An optional unique identifier for this request. See AIP-155.
Request body
The request body contains an instance of HardwareGroup.
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 page details the process of creating a new hardware group within a specified order using a POST request to the \u003ccode\u003ehttps://gdchardwaremanagement.googleapis.com/v1alpha/{parent=projects/*/locations/*/orders/*}/hardwareGroups\u003c/code\u003e endpoint.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter is required and specifies the order's location and project using the format \u003ccode\u003eprojects/{project}/locations/{location}/orders/{order}\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters such as \u003ccode\u003ehardwareGroupId\u003c/code\u003e for custom IDs and \u003ccode\u003erequestId\u003c/code\u003e for request tracking can be used in the HTTP request.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires a \u003ccode\u003eHardwareGroup\u003c/code\u003e instance, and a successful response will contain an \u003ccode\u003eOperation\u003c/code\u003e instance.\u003c/p\u003e\n"],["\u003cp\u003eCreating a hardware group requires the OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e and the IAM permission \u003ccode\u003egdchardwaremanagement.hardwareGroups.create\u003c/code\u003e on the \u003ccode\u003eparent\u003c/code\u003e resource.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.orders.hardwareGroups.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 hardware group in a given order.\n\n### HTTP request\n\n`POST https://gdchardwaremanagement.googleapis.com/v1alpha/{parent=projects/*/locations/*/orders/*}/hardwareGroups`\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 [HardwareGroup](/distributed-cloud/edge/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.orders.hardwareGroups#HardwareGroup).\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.hardwareGroups.create`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]
