# REST Resource: projects.locations.orders.hardwareGroups

- [Resource: HardwareGroup](https://docs.cloud.google.com/distributed-cloud/connected/1.12.0/docs/reference/hardware/rest/v1alpha/projects.locations.orders.hardwareGroups#HardwareGroup)
  - [JSON representation](https://docs.cloud.google.com/distributed-cloud/connected/1.12.0/docs/reference/hardware/rest/v1alpha/projects.locations.orders.hardwareGroups#HardwareGroup.SCHEMA_REPRESENTATION)
- [State](https://docs.cloud.google.com/distributed-cloud/connected/1.12.0/docs/reference/hardware/rest/v1alpha/projects.locations.orders.hardwareGroups#State)
- [Methods](https://docs.cloud.google.com/distributed-cloud/connected/1.12.0/docs/reference/hardware/rest/v1alpha/projects.locations.orders.hardwareGroups#METHODS_SUMMARY)

## Resource: HardwareGroup

A group of hardware that is part of the same order, has the same SKU, and is delivered to the same site.

| JSON representation |
|---|
| ``` { "name": string, "createTime": string, "updateTime": string, "labels": { string: string, ... }, "hardwareCount": integer, "config": { object (`https://docs.cloud.google.com/distributed-cloud/edge/1.12.0/docs/reference/hardware/rest/v1alpha/HardwareConfig`) }, "site": string, "state": enum (`https://docs.cloud.google.com/distributed-cloud/edge/1.12.0/docs/reference/hardware/rest/v1alpha/projects.locations.orders.hardwareGroups#State`), "zone": string, "requestedInstallationDate": { object (`https://docs.cloud.google.com/distributed-cloud/edge/1.12.0/docs/reference/hardware/rest/v1alpha/Date`) } } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. Name of this hardware group. Format: `projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardwareGroup}` |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. Time when this hardware group was created. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `updateTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. Time when this hardware group was last updated. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `labels` | `map (key: string, value: string)` Optional. Labels associated with this hardware group as key value pairs. For more information about labels, see [Create and manage labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels). An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |
| `hardwareCount` | `integer` Required. Number of hardware in this HardwareGroup. |
| `config` | ``object (`https://docs.cloud.google.com/distributed-cloud/edge/1.12.0/docs/reference/hardware/rest/v1alpha/HardwareConfig`)`` Required. Configuration for hardware in this HardwareGroup. |
| `site` | `string` Required. Name of the site where the hardware in this HardwareGroup will be delivered. Format: `projects/{project}/locations/{location}/sites/{site}` |
| `state` | ``enum (`https://docs.cloud.google.com/distributed-cloud/edge/1.12.0/docs/reference/hardware/rest/v1alpha/projects.locations.orders.hardwareGroups#State`)`` Output only. Current state of this HardwareGroup. |
| `zone` | `string` Optional. Name of the zone that the hardware in this HardwareGroup belongs to. Format: `projects/{project}/locations/{location}/zones/{zone}` |
| `requestedInstallationDate (deprecated)` | ``object (`https://docs.cloud.google.com/distributed-cloud/edge/1.12.0/docs/reference/hardware/rest/v1alpha/Date`)`` > [!WARNING] > This item is deprecated! Optional. Deprecated: This value is not used. Use the requestedInstallationDate field in the Order resource instead. |

## State

Valid states of a HardwareGroup.

| Enums ||
|---|---|
| `STATE_UNSPECIFIED` | State of the HardwareGroup is unspecified. |
| `ADDITIONAL_INFO_NEEDED` | More information is required from the customer to make progress. |
| `BUILDING` | Google has initiated building hardware for this HardwareGroup. |
| `SHIPPING` | The hardware has been built and is being shipped. |
| `INSTALLING` | The hardware is being installed. |
| `PARTIALLY_INSTALLED` | Some hardware in the HardwareGroup have been installed. |
| `INSTALLED` | All hardware in the HardwareGroup have been installed. |
| `FAILED` | An error occurred and customer intervention is required. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/distributed-cloud/edge/1.12.0/docs/reference/hardware/rest/v1alpha/projects.locations.orders.hardwareGroups/create` | Creates a new hardware group in a given order. |
| ### `https://docs.cloud.google.com/distributed-cloud/edge/1.12.0/docs/reference/hardware/rest/v1alpha/projects.locations.orders.hardwareGroups/delete` | Deletes a hardware group. |
| ### `https://docs.cloud.google.com/distributed-cloud/edge/1.12.0/docs/reference/hardware/rest/v1alpha/projects.locations.orders.hardwareGroups/get` | Gets details of a hardware group. |
| ### `https://docs.cloud.google.com/distributed-cloud/edge/1.12.0/docs/reference/hardware/rest/v1alpha/projects.locations.orders.hardwareGroups/list` | Lists hardware groups in a given order. |
| ### `https://docs.cloud.google.com/distributed-cloud/edge/1.12.0/docs/reference/hardware/rest/v1alpha/projects.locations.orders.hardwareGroups/patch` | Updates the parameters of a hardware group. |