Dela via


Settings - Get By Scope

Hämta inställningen från det angivna omfånget efter namn.

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

URI-parametrar

Name I Obligatorisk Typ Description
scope
path True

string

Omfånget som är associerat med den här inställningen. Detta inkluderar "subscriptions/{subscriptionId}" för prenumerationsomfång, "providers/Microsoft.Billing/billingAccounts/{billingAccountId}" för faktureringskontoomfång, "providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}" för faktureringsprofilomfånget.

type
path True

SettingType

Inställningstyp.

api-version
query True

string

DEN API-version som ska användas för den här åtgärden.

Svar

Name Typ Description
200 OK Setting:

TagInheritanceSetting

Begäran har slutförts.

Other Status Codes

ErrorResponse

Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

SettingByScope

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name Description
ErrorDetails

Information om felet.

ErrorResponse

Felsvaret anger att tjänsten inte kan bearbeta den inkommande begäran. Orsaken anges i felmeddelandet.

Några felsvar:

  • 429 TooManyRequests – Begäran begränsas. Försök igen efter att ha väntat på den tid som anges i rubriken "x-ms-ratelimit-microsoft.consumption-retry-after".

  • 503 ServiceUnavailable – Tjänsten är inte tillgänglig för tillfället. Försök igen efter att ha väntat på den tid som anges i rubriken "Försök igen".

SettingType

Inställningstyp.

TagInheritanceProperties

Egenskaperna för inställningen för taggarv.

TagInheritanceSetting

Tagga definition av arvsinställning.

ErrorDetails

Information om felet.

Name Typ Description
code

string

Felkod.

message

string

Felmeddelande som anger varför åtgärden misslyckades.

ErrorResponse

Felsvaret anger att tjänsten inte kan bearbeta den inkommande begäran. Orsaken anges i felmeddelandet.

Några felsvar:

  • 429 TooManyRequests – Begäran begränsas. Försök igen efter att ha väntat på den tid som anges i rubriken "x-ms-ratelimit-microsoft.consumption-retry-after".

  • 503 ServiceUnavailable – Tjänsten är inte tillgänglig för tillfället. Försök igen efter att ha väntat på den tid som anges i rubriken "Försök igen".

Name Typ Description
error

ErrorDetails

Information om felet.

SettingType

Inställningstyp.

Name Typ Description
taginheritance

string

Den här inställningen tillämpar taggar för faktureringsprofil, fakturaavsnitt, prenumeration och resursgrupp på den aktuella månadens användningsdata för underordnade resurser.

TagInheritanceProperties

Egenskaperna för inställningen för taggarv.

Name Typ Description
preferContainerTags

boolean

Den här egenskapen definierar beteendet när en ärvd tagg som tillämpas matchar en tagg med lägre omfång (t.ex. Prenumerationstaggen matchar resurstaggen). Om värdet är true – när taggarna matchar tillämpas de högsta omfångstaggar. Faktureringsprofilen är det högsta omfånget följt av fakturaavsnitt, prenumerationer och resursgrupper (tillåter åsidosättande av taggvärden med lägre omfång). Om värdet är false – när taggarna matchar tillämpas de lägsta omfångstaggar. Så om en resurs har samma tagg som en prenumerationstagg tillämpas resurstaggen (tillåter inte åsidosättande av lägre omfångstaggvärden).

TagInheritanceSetting

Tagga definition av arvsinställning.

Name Typ Description
id

string

Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

kind string:

taginheritance

Anger typen av inställningar.

name

string

Namnet på resursen

properties

TagInheritanceProperties

Egenskaperna för inställningen för taggarv.

type

string

Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"