# REST Resource: tagValues.tagHolds

- [Resource: TagHold](https://docs.cloud.google.com/resource-manager/reference/rest/v3/tagValues.tagHolds#TagHold)
  - [JSON representation](https://docs.cloud.google.com/resource-manager/reference/rest/v3/tagValues.tagHolds#TagHold.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/resource-manager/reference/rest/v3/tagValues.tagHolds#METHODS_SUMMARY)

## Resource: TagHold

A TagHold represents the use of a TagValue that is not captured by TagBindings. If a TagValue has any TagHolds, deletion will be blocked. This resource is intended to be created in the same cloud location as the `holder`.

| JSON representation |
|---|
| ``` { "name": string, "holder": string, "origin": string, "helpLink": string, "createTime": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Output only. The resource name of a TagHold. This is a String of the form: `tagValues/{tag-value-id}/tagHolds/{tag-hold-id}` (e.g. `tagValues/123/tagHolds/456`). This resource name is generated by the server. |
| `holder` | `string` Required. The name of the resource where the TagValue is being used. Must be less than 200 characters. E.g. `//compute.googleapis.com/compute/projects/myproject/regions/us-east-1/instanceGroupManagers/instance-group` |
| `origin` | `string` Optional. An optional string representing the origin of this request. This field should include human-understandable information to distinguish origins from each other. Must be less than 200 characters. E.g. `migs-35678234` |
| `helpLink` | `string` Optional. A URL where an end user can learn more about removing this hold. E.g. `https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing` |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The time this TagHold 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"`. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/resource-manager/reference/rest/v3/tagValues.tagHolds/create` | Creates a TagHold. |
| ### `https://docs.cloud.google.com/resource-manager/reference/rest/v3/tagValues.tagHolds/delete` | Deletes a TagHold. |
| ### `https://docs.cloud.google.com/resource-manager/reference/rest/v3/tagValues.tagHolds/list` | Lists TagHolds under a TagValue. |