# REST Resource: projects.locations.groups

- [Resource: Group](https://docs.cloud.google.com/migration-center/docs/reference/rest/v1alpha1/projects.locations.groups#Group)
  - [JSON representation](https://docs.cloud.google.com/migration-center/docs/reference/rest/v1alpha1/projects.locations.groups#Group.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/migration-center/docs/reference/rest/v1alpha1/projects.locations.groups#METHODS_SUMMARY)

## Resource: Group

A resource that represents an asset group. The purpose of an asset group is to bundle a set of assets that have something in common, while allowing users to add annotations to the group. An asset can belong to multiple groups.

| JSON representation |
|---|
| ``` { "name": string, "createTime": string, "updateTime": string, "labels": { string: string, ... }, "displayName": string, "description": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Output only. The name of the group. |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The timestamp when the group was created. Uses RFC 3339, where generated output will always be Z-normalized and uses 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. The timestamp when the group was last updated. Uses RFC 3339, where generated output will always be Z-normalized and uses 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)` Labels as key value pairs. An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |
| `displayName` | `string` Optional. User-friendly display name. |
| `description` | `string` Optional. The description of the group. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/migration-center/docs/reference/rest/v1alpha1/projects.locations.groups/addAssets` | Adds assets to a group. |
| ### `https://docs.cloud.google.com/migration-center/docs/reference/rest/v1alpha1/projects.locations.groups/create` | Creates a new group in a given project and location. |
| ### `https://docs.cloud.google.com/migration-center/docs/reference/rest/v1alpha1/projects.locations.groups/delete` | Deletes a group. |
| ### `https://docs.cloud.google.com/migration-center/docs/reference/rest/v1alpha1/projects.locations.groups/get` | Gets the details of a group. |
| ### `https://docs.cloud.google.com/migration-center/docs/reference/rest/v1alpha1/projects.locations.groups/list` | Lists all groups in a given project and location. |
| ### `https://docs.cloud.google.com/migration-center/docs/reference/rest/v1alpha1/projects.locations.groups/patch` | Updates the parameters of a group. |
| ### `https://docs.cloud.google.com/migration-center/docs/reference/rest/v1alpha1/projects.locations.groups/removeAssets` | Removes assets from a group. |