Tags - Create Or Update

Service:

Resource Management

API Version:

2021-04-01

Crea un nome di tag predefinito.
Questa operazione consente di aggiungere un nome all'elenco di nomi di tag predefiniti per la sottoscrizione specificata. Un nome di tag può avere un massimo di 512 caratteri ed è senza distinzione tra maiuscole e minuscole. I nomi dei tag non possono avere i prefissi seguenti riservati per l'uso di Azure: 'microsoft', 'azure', 'windows'.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
subscriptionId	path	True	string	ID sottoscrizione di Microsoft Azure.
tagName	path	True	string	Nome del tag da creare.
api-version	query	True	string	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	TagDetails	Il nome di tag predefinito esiste già. Restituisce informazioni sul nome del tag predefinito.
201 Created	TagDetails	Nome tag predefinito creato correttamente. Restituisce informazioni sul nome del tag predefinito.
Other Status Codes	CloudError	Risposta di errore che descrive perché l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

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

Scopes

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Definizioni

Nome	Descrizione
CloudError	Risposta di errore per una richiesta di gestione delle risorse.
ErrorAdditionalInfo	Informazioni aggiuntive sulla gestione delle risorse.
ErrorResponse	Risposta di errore
TagCount	Conteggio dei tag.
TagDetails	Dettagli dei tag.
TagValue	Informazioni sul tag.

CloudError

Risposta di errore per una richiesta di gestione delle risorse.

Nome	Tipo	Descrizione
error	ErrorResponse	Risposta di errore Risposta di errore comune per tutte le API di Resource Manager di Azure per restituire i dettagli degli errori per le operazioni non riuscite. Questo segue anche il formato di risposta di errore OData.

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorResponse

Risposta di errore

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorResponse[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

TagCount

Conteggio dei tag.

Nome	Tipo	Descrizione
type	string	Tipo di conteggio.
value	integer	Valore del conteggio.

TagDetails

Dettagli dei tag.

Nome	Tipo	Descrizione
count	TagCount	Numero totale di risorse che usano il tag di risorsa. Quando un tag viene creato inizialmente e non ha risorse associate, il valore è 0.
id	string	ID nome tag.
tagName	string	Nome del tag.
values	TagValue[]	Elenco di valori di tag.

TagValue

Informazioni sul tag.

Nome	Tipo	Descrizione
count	TagCount	Conteggio dei valori del tag.
id	string	ID del valore del tag.
tagValue	string	Il valore del tag.