tag_binding_collections
Creates, updates, deletes, gets or lists a tag_binding_collections
resource.
Overview
Name | tag_binding_collections |
Type | Resource |
Id | google.cloudresourcemanager.tag_binding_collections |
Fields
The following fields are returned by SELECT
queries:
- get
Successful response
Name | Datatype | Description |
---|---|---|
name | string | Identifier. The name of the TagBindingCollection, following the convention: locations/{location}/tagBindingCollections/{encoded-full-resource-name} where the encoded-full-resource-name is the UTF-8 encoded name of the GCP resource the TagBindings are bound to. "locations/global/tagBindingCollections/%2f%2fcloudresourcemanager.googleapis.com%2fprojects%2f123" |
etag | string | Optional. A checksum based on the current bindings which can be passed to prevent race conditions. This field is always set in server responses. |
fullResourceName | string | The full resource name of the resource the TagBindings are bound to. E.g. //cloudresourcemanager.googleapis.com/projects/123 |
tags | object | Tag keys/values directly bound to this resource, specified in namespaced format. For example: "123/environment": "production" |
Methods
The following methods are available for this resource:
Name | Accessible by | Required Params | Optional Params | Description |
---|---|---|---|---|
get | select | locationsId , tagBindingCollectionsId | Returns tag bindings directly attached to a GCP resource. | |
update | replace | locationsId , tagBindingCollectionsId | Updates tag bindings directly attached to a GCP resource. |
Parameters
Parameters can be passed in the WHERE
clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
Name | Datatype | Description |
---|---|---|
locationsId | string | |
tagBindingCollectionsId | string |
SELECT
examples
- get
Returns tag bindings directly attached to a GCP resource.
SELECT
name,
etag,
fullResourceName,
tags
FROM google.cloudresourcemanager.tag_binding_collections
WHERE locationsId = '{{ locationsId }}' -- required
AND tagBindingCollectionsId = '{{ tagBindingCollectionsId }}' -- required;
REPLACE
examples
- update
Updates tag bindings directly attached to a GCP resource.
REPLACE google.cloudresourcemanager.tag_binding_collections
SET
data__name = '{{ name }}',
data__fullResourceName = '{{ fullResourceName }}',
data__tags = '{{ tags }}',
data__etag = '{{ etag }}'
WHERE
locationsId = '{{ locationsId }}' --required
AND tagBindingCollectionsId = '{{ tagBindingCollectionsId }}' --required
RETURNING
name,
done,
error,
metadata,
response;