Partilhar via


Tags - Create Or Update

Cria um nome de etiqueta predefinido.
Esta operação permite adicionar um nome à lista de nomes de etiquetas predefinidos para a subscrição especificada. Um nome de etiqueta pode ter um máximo de 512 carateres e não é sensível a maiúsculas e minúsculas. Os nomes das etiquetas não podem ter os seguintes prefixos reservados para utilização do Azure: "microsoft", "azure", "windows".

PUT https://management.azure.com/subscriptions/{subscriptionId}/tagNames/{tagName}?api-version=2021-04-01

Parâmetros do URI

Name Em Necessário Tipo Description
subscriptionId
path True

string

O ID da subscrição do Microsoft Azure.

tagName
path True

string

O nome da etiqueta a criar.

api-version
query True

string

A versão da API a utilizar para esta operação.

Respostas

Name Tipo Description
200 OK

TagDetails

O nome da etiqueta predefinido já existe. Devolve informações sobre o nome da etiqueta predefinida.

201 Created

TagDetails

Nome da etiqueta predefinido criado com êxito. Devolve informações sobre o nome da etiqueta predefinida.

Other Status Codes

CloudError

Resposta de erro que descreve a razão pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Definições

Name Description
CloudError

Uma resposta de erro para um pedido de gestão de recursos.

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

ErrorResponse

Resposta a Erros

TagCount

Contagem de etiquetas.

TagDetails

Detalhes da etiqueta.

TagValue

Informações da etiqueta.

CloudError

Uma resposta de erro para um pedido de gestão de recursos.

Name Tipo Description
error

ErrorResponse

Resposta a Erros
Resposta de erro comum para todas as APIs Resource Manager do Azure para devolver detalhes de erro para operações falhadas. (Isto também segue o formato de resposta a erros OData.)

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorResponse

Resposta a Erros

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorResponse[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

TagCount

Contagem de etiquetas.

Name Tipo Description
type

string

Tipo de contagem.

value

integer

Valor da contagem.

TagDetails

Detalhes da etiqueta.

Name Tipo Description
count

TagCount

O número total de recursos que utilizam a etiqueta de recurso. Quando uma etiqueta é criada inicialmente e não tem recursos associados, o valor é 0.

id

string

O ID do nome da etiqueta.

tagName

string

O nome da etiqueta.

values

TagValue[]

A lista de valores de etiquetas.

TagValue

Informações da etiqueta.

Name Tipo Description
count

TagCount

A contagem de valores de etiquetas.

id

string

O ID do valor da etiqueta.

tagValue

string

O valor da etiqueta.