Tags - Create Or Update At Scope

Tjänst:: Resource Management

API-version:: 2021-04-01

Skapar eller uppdaterar hela uppsättningen taggar för en resurs eller prenumeration.
Med den här åtgärden kan du lägga till eller ersätta hela uppsättningen taggar på den angivna resursen eller prenumerationen. Den angivna entiteten kan ha högst 50 taggar.

PUT https://management.azure.com/{scope}/providers/Microsoft.Resources/tags/default?api-version=2021-04-01

URI-parametrar

Namn	I	Krävs	Typ	Beskrivning
scope	path	True	string	Resursomfånget.
api-version	query	True	string	DEN API-version som ska användas för den här åtgärden.

Brödtext för begäran

Namn	Krävs	Typ	Beskrivning
properties	True	Tags	Uppsättningen taggar.

Svaren

Namn	Typ	Beskrivning
200 OK	TagsResource	Taggar har uppdaterats. Returnerar taggar från det angivna objektet.
Other Status Codes	CloudError	Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde

Typ: oauth2
Rinna: implicit
URL för auktorisering: https://login.microsoftonline.com/common/oauth2/authorize

Scope

Namn	Beskrivning
user_impersonation	personifiera ditt användarkonto

Exempel

Update tags on a resource

Update tags on a subscription

Update tags on a resource

Exempel på begäran

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/myPRNameSpace/VM/myVm/providers/Microsoft.Resources/tags/default?api-version=2021-04-01

{
  "properties": {
    "tags": {
      "tagKey1": "tag-value-1",
      "tagKey2": "tag-value-2"
    }
  }
}

Exempel på svar

Status kod:: 200

{
  "properties": {
    "tags": {
      "tagKey1": "tag-value-1",
      "tagKey2": "tag-value-2"
    }
  }
}

Update tags on a subscription

Exempel på begäran

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/tags/default?api-version=2021-04-01

{
  "properties": {
    "tags": {
      "tagKey1": "tag-value-1",
      "tagKey2": "tag-value-2"
    }
  }
}

Exempel på svar

Status kod:: 200

{
  "properties": {
    "tags": {
      "tagKey1": "tag-value-1",
      "tagKey2": "tag-value-2"
    }
  }
}

Definitioner

Namn	Beskrivning
CloudError	Ett felsvar för en resurshanteringsbegäran.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorResponse	Felsvar
Tags	En ordlista med namn- och värdepar.
TagsResource	Omslutningsresurs för taggar API-begäranden och svar.

CloudError

Objekt

Ett felsvar för en resurshanteringsbegäran.

Namn	Typ	Beskrivning
error	ErrorResponse	Felsvar Vanligt felsvar för alla Azure Resource Manager-API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även formatet för OData-felsvar.)

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Namn	Typ	Beskrivning
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorResponse

Objekt

Felsvar

Namn	Typ	Beskrivning
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorResponse[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

Namn	Typ	Beskrivning
tags	object

TagsResource

Objekt

Omslutningsresurs för taggar API-begäranden och svar.

Namn	Typ	Beskrivning
id	string	ID:t för omslutningsresursen för taggar.
name	string	Namnet på omslutningsresursen för taggar.
properties	Tags	Uppsättningen taggar.
type	string	Typ av omslutningsresurs för taggar.