Settings - Create Or Update By Scope

Service:

Cost Management

API-versie:

2024-08-01

Een instelling binnen het opgegeven bereik maken of bijwerken.

PUT https://management.azure.com/{scope}/providers/Microsoft.CostManagement/settings/taginheritance?api-version=2024-08-01

URI-parameters

Name	In	Vereist	Type	Description
scope	path	True	string	Het bereik dat aan deze instelling is gekoppeld. Dit omvat abonnementen/{subscriptionId} voor abonnementsbereik, providers/Microsoft.Billing/billingAccounts/{billingAccountId} voor het bereik van de factureringsrekening, providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId} voor het factureringsprofielbereik.
type	path	True	SettingType	Instellingstype.
api-version	query	True	string	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

TagInheritanceSetting

Definitie van instelling tagovername.

Name	Vereist	Type	Description
kind	True	string: taginheritance	Hiermee geeft u het soort instellingen op.
properties		TagInheritanceProperties	De eigenschappen van de instelling voor tagovername.

Antwoorden

Name	Type	Description
200 OK	Setting: TagInheritanceSetting	Instelling bijgewerkt.
201 Created	Setting: TagInheritanceSetting	Instelling gemaakt.
Other Status Codes	ErrorResponse	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

CreateOrUpdateSettingByScope

Voorbeeldaanvraag

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/settings/taginheritance?api-version=2024-08-01

{
  "kind": "taginheritance",
  "properties": {
    "preferContainerTags": false
  }
}

Voorbeeldrespons

Statuscode:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/settings/taginheritance",
  "name": "taginheritance",
  "type": "Microsoft.CostManagement/Settings",
  "kind": "taginheritance",
  "properties": {
    "preferContainerTags": false
  }
}

Statuscode:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/settings/taginheritance",
  "name": "taginheritance",
  "type": "Microsoft.CostManagement/Settings",
  "kind": "taginheritance",
  "properties": {
    "preferContainerTags": false
  }
}

Definities

Name	Description
ErrorDetails	De details van de fout.
ErrorResponse	Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden is opgegeven in het foutbericht. Enkele foutberichten: 429 TooManyRequests - Aanvraag wordt beperkt. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header x-ms-ratelimit-microsoft.consumption-retry-after. 503 ServiceUnavailable - Service is tijdelijk niet beschikbaar. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header 'Opnieuw proberen-na'.
SettingType	Instellingstype.
TagInheritanceProperties	De eigenschappen van de instelling voor tagovername.
TagInheritanceSetting	Definitie van instelling tagovername.

ErrorDetails

De details van de fout.

Name	Type	Description
code	string	Foutcode.
message	string	Foutbericht dat aangeeft waarom de bewerking is mislukt.

ErrorResponse

Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden is opgegeven in het foutbericht.

Enkele foutberichten:

• 429 TooManyRequests - Aanvraag wordt beperkt. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header x-ms-ratelimit-microsoft.consumption-retry-after.

• 503 ServiceUnavailable - Service is tijdelijk niet beschikbaar. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header 'Opnieuw proberen-na'.

Name	Type	Description
error	ErrorDetails	De details van de fout.

SettingType

Instellingstype.

Name	Type	Description
taginheritance	string	Deze instelling past factureringsprofiel, factuursectie, abonnements- en resourcegroeptags toe op de gebruiksgegevens van onderliggende resources van de huidige maand.

TagInheritanceProperties

De eigenschappen van de instelling voor tagovername.

Name	Type	Description
preferContainerTags	boolean	Deze eigenschap definieert het gedrag wanneer een overgenomen tag die wordt toegepast overeenkomt met een tag met een lager bereik (bijvoorbeeld Abonnementstag komt overeen met de resourcetag). Als deze optie is ingesteld op true, worden de hoogste bereiktags toegepast wanneer tags overeenkomen. Het factureringsprofiel is het hoogste bereik, gevolgd door factuursecties, abonnementen en resourcegroepen (hiermee kunnen lagere tagwaarden worden overschreven). Als deze optie is ingesteld op onwaar, worden de laagste bereiktags toegepast wanneer tags overeenkomen. Dus als een resource dezelfde tag heeft als een abonnementstag, wordt de resourcetag toegepast (staat het overschrijven van lagere tagwaarden van het bereik niet toe).

TagInheritanceSetting

Definitie van instelling tagovername.

Name	Type	Description
id	string	Volledig gekwalificeerde resource-id voor de resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
kind	string: taginheritance	Hiermee geeft u het soort instellingen op.
name	string	De naam van de resource
properties	TagInheritanceProperties	De eigenschappen van de instelling voor tagovername.
type	string	Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'