Tags - Create Or Update

Referenz

Service:: Resource Management

API Version:: 2021-04-01

Erstellt einen vordefinierten Tagnamen.
Dieser Vorgang ermöglicht das Hinzufügen eines Namens zur Liste der vordefinierten Tagnamen für das angegebene Abonnement. Ein Tagname kann maximal 512 Zeichen lang sein, wobei die Groß-/Kleinschreibung nicht beachtet wird. Tagnamen dürfen nicht die folgenden Präfixe aufweisen, die für die Azure-Verwendung reserviert sind: "microsoft", "azure", "windows".

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
subscriptionId	path	True	string	Die Microsoft Azure-Abonnement-ID.
tagName	path	True	string	Der Name des zu erstellenden Tags.
api-version	query	True	string	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Antworten

Name	Typ	Beschreibung
200 OK	TagDetails	Vordefinierter Tagname ist bereits vorhanden. Gibt Informationen zum vordefinierten Tagnamen zurück.
201 Created	TagDetails	Vordefinierter Tagname erfolgreich erstellt. Gibt Informationen zum vordefinierten Tagnamen zurück.
Other Status Codes	CloudError	Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

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

Scopes

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Definitionen

Name	Beschreibung
CloudError	Eine Fehlerantwort für eine Ressourcenverwaltungsanforderung.
ErrorAdditionalInfo	Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
ErrorResponse	Fehlerantwort
TagCount	Anzahl der Tags.
TagDetails	Tagdetails.
TagValue	Taginformationen.

CloudError

Eine Fehlerantwort für eine Ressourcenverwaltungsanforderung.

Name	Typ	Beschreibung
error	ErrorResponse	Fehlerantwort Allgemeine Fehlerantwort für alle Azure Resource Manager-APIs, zur Rückgabe von Fehlerdetails für fehlgeschlagene Vorgänge. (Dies folgt auch dem OData-Fehlerantwortformat.)

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name	Typ	Beschreibung
info	object	Zusätzliche Informationen.
type	string	Typ der zusätzlichen Informationen.

ErrorResponse

Fehlerantwort

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Fehlerinformationen.
code	string	Der Fehlercode.
details	ErrorResponse[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

TagCount

Anzahl der Tags.

Name	Typ	Beschreibung
type	string	Typ der Anzahl.
value	integer	Wert der Anzahl.

TagDetails

Tagdetails.

Name	Typ	Beschreibung
count	TagCount	Die Gesamtanzahl der Ressourcen, die das Ressourcentag verwenden. Wenn ein Tag ursprünglich erstellt wird und keine Ressourcen zugeordnet sind, ist der Wert 0.
id	string	Die Tagnamen-ID.
tagName	string	Der Tagname.
values	TagValue[]	Die Liste der Tagwerte.

TagValue

Taginformationen.

Name	Typ	Beschreibung
count	TagCount	Die Tagwertanzahl.
id	string	Die Tagwert-ID.
tagValue	string	Der Tagwert.