Managing Tags

Defines a tag and lists the available operations for managing it.

Tags are used to bind user-specific information to managed resources.

The APIs and CLI provide operations for:

Use either the cloud infrastructure API actions or the cloud infrastructure CLI command to perform these operations.

About Tags

Describes the purpose of a tag and its attributes.

A tag is a key and value pair that can be attached to a resource to identify it. The key and the value are strings. All entities in Oracle Enterprise Manager Ops Center are managed resources that can be tagged.

Creating a Tag

Lists the API action and CLI command for creating a tag.

A cloud user can create a tag. Creating a tag adds a new tag or overwrites an existing tag.


Cloud Infrastructure API Action Cloud Infrastructure CLI Command

CreateTagsRequest

iaas-create-tags


Example 3-95 Creating a tag using the Cloud Infrastructure API

https://<EnterpriseControllerHostname>/iaas/?Action=CreateTags&Version=1&Timestamp=1320101484395&Expires=1320101784395&resourceId=VNET-9ba968d5-e64f-4b54-a639-ee3d398e0d50&tags.1.name=myTag&tags.1.value=myTagValue&AccessKeyId=AK_3&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST&SignatureMethod=SHA512withRSA&SignatureVersion=1

Example 3-96 Creating a tag using the Cloud Infrastructure CLI

iaas-create-tags --base-url https://<EnterpriseControllerHostname>/ -a ak.file --id VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t --tags myTag=myTagValue

Removing a Tag

Lists the API action and CLI command for removing a tag.

A cloud user can remove tags from an account resource of an account.


Cloud Infrastructure API Action Cloud Infrastructure CLI Command

DescribeTagsRequest

iaas-delete-tags


Example 3-97 Deleting a tag using the Cloud Infrastructure API

https://<EnterpriseControllerHostname>/iaas/?Action=DeleteTags&Version=1&Timestamp=1320102752960&Expires=1320103052960&resourceId=VNET-9ba968d5-e64f-4b54-a639-ee3d398e0d50&tags.1.name=myTag&AccessKeyId=AK_3&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST&SignatureMethod=SHA512withRSA&SignatureVersion=1

Example 3-98 Deleting a tag using the Cloud Infrastructure CLI

iaas-delete-tags --base-url https://<EnterpriseControllerHostname>/ -a ak.file --id VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t --tags myTag

Viewing Tag Information

Lists the API action and CLI command for displaying tags.

A cloud user can get information about tags attached to an account resource. The cloud user can restrict the tags included in the result by specifying filters. The result includes the ID of the account resource, along with the name and value of the tags found.


Cloud Infrastructure API Action Cloud Infrastructure CLI Command

DescribeTagsRequest

iaas-describe-tags


Example 3-99 Viewing tag information using the Cloud Infrastructure API

https://<EnterpriseControllerHostname>/iaas/?Action=DescribeTags&Version=1&Timestamp=1320101837081&Expires=1320102137081&AccessKeyId=AK_3&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST&SignatureMethod=SHA512withRSA&SignatureVersion=1

Example 3-100 Viewing tag information using the Cloud Infrastructure CLI

iaas-describe-tags --base-url https://<EnterpriseControllerHostname>/ -a ak.file