Tags - Create Or Update

Odwołanie

Service:: Resource Management

API Version:: 2021-04-01

Tworzy wstępnie zdefiniowaną nazwę tagu.
Ta operacja umożliwia dodanie nazwy do listy wstępnie zdefiniowanych nazw tagów dla danej subskrypcji. Nazwa tagu może mieć maksymalnie 512 znaków i nie uwzględnia wielkości liter. Nazwy tagów nie mogą mieć następujących prefiksów zarezerwowanych do użycia na platformie Azure: "microsoft", "azure", "windows".

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
subscriptionId	path	True	string	Identyfikator subskrypcji platformy Microsoft Azure.
tagName	path	True	string	Nazwa tagu do utworzenia.
api-version	query	True	string	Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	TagDetails	Wstępnie zdefiniowana nazwa tagu już istnieje. Zwraca informacje o wstępnie zdefiniowanej nazwie tagu.
201 Created	TagDetails	Pomyślnie utworzono wstępnie zdefiniowaną nazwę tagu. Zwraca informacje o wstępnie zdefiniowanej nazwie tagu.
Other Status Codes	CloudError	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

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

Scopes

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Definicje

Nazwa	Opis
CloudError	Odpowiedź na błąd żądania zarządzania zasobami.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorResponse	Odpowiedź na błąd
TagCount	Liczba tagów.
TagDetails	Szczegóły tagu.
TagValue	Informacje o tagach.

CloudError

Odpowiedź na błąd żądania zarządzania zasobami.

Nazwa	Typ	Opis
error	ErrorResponse	Odpowiedź na błąd Typowa odpowiedź na błędy dla wszystkich interfejsów API usługi Azure Resource Manager zwraca szczegóły błędu dla operacji, które zakończyły się niepowodzeniem. (Jest to również zgodne z formatem odpowiedzi na błąd OData).

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorResponse

Odpowiedź na błąd

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorResponse[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

TagCount

Liczba tagów.

Nazwa	Typ	Opis
type	string	Typ liczby.
value	integer	Wartość liczby.

TagDetails

Szczegóły tagu.

Nazwa	Typ	Opis
count	TagCount	Całkowita liczba zasobów korzystających z tagu zasobu. Gdy tag jest początkowo tworzony i nie ma skojarzonych zasobów, wartość wynosi 0.
id	string	Identyfikator nazwy tagu.
tagName	string	Nazwa tagu.
values	TagValue[]	Lista wartości tagów.

TagValue

Informacje o tagach.

Nazwa	Typ	Opis
count	TagCount	Liczba wartości tagu.
id	string	Identyfikator wartości tagu.
tagValue	string	Wartość tagu.