Tags - Create Or Update Value

Creates a tag value. The name of the tag must already exist.

PUT https://management.azure.com/subscriptions/{subscriptionId}/tagNames/{tagName}/tagValues/{tagValue}?api-version=2019-08-01

URI Parameters

Name In Required Type Description
subscriptionId
path True
  • string

The ID of the target subscription.

tagName
path True
  • string

The name of the tag.

tagValue
path True
  • string

The value of the tag to create.

api-version
query True
  • string

The API version to use for this operation.

Responses

Name Type Description
200 OK

OK - Returns information about the tag value.

201 Created

Created - Returns information about the tag value.

Other Status Codes

Error response describing why the operation failed.

Security

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation impersonate your user account

Definitions

CloudError

An error response for a resource management request.

ErrorAdditionalInfo

The resource management error additional info.

ErrorResponse

The resource management error response.

TagCount

Tag count.

TagValue

Tag information.

CloudError

An error response for a resource management request.

Name Type Description
error

The resource management error response.

ErrorAdditionalInfo

The resource management error additional info.

Name Type Description
info
  • object

The additional info.

type
  • string

The additional info type.

ErrorResponse

The resource management error response.

Name Type Description
additionalInfo

The error additional info.

code
  • string

The error code.

details

The error details.

message
  • string

The error message.

target
  • string

The error target.

TagCount

Tag count.

Name Type Description
type
  • string

Type of count.

value
  • integer

Value of count.

TagValue

Tag information.

Name Type Description
count

The tag value count.

id
  • string

The tag ID.

tagValue
  • string

The tag value.