Settings - Get

Tjänst:

Cost Management

API-version:

2019-11-01

Hämtar det aktuella värdet för en specifik inställning.

GET https://management.azure.com/providers/Microsoft.CostManagement/settings/{settingName}?api-version=2019-11-01

URI-parametrar

Name	I	Obligatorisk	Typ	Description
settingName	path	True	string maxLength: 32	Namnet på inställningen. Tillåtna värden: myscope
api-version	query	True	string	Version av API:et som ska användas med klientbegäran. Den aktuella versionen är 2019-11-01.

Svar

Name	Typ	Description
200 OK	Setting	OKEJ. 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-flöde.

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

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Settings

Exempelbegäran

HTTP

GET https://management.azure.com/providers/Microsoft.CostManagement/settings/myscope?api-version=2019-11-01

Exempelsvar

Statuskod:

200

{
  "id": "/providers/Microsoft.CostManagement/settings/myscope",
  "name": "myscope",
  "kind": "user",
  "type": "Microsoft.CostManagement/Settings",
  "properties": {
    "scope": "/subscriptions/00000000-0000-0000-0000-000000000000",
    "startOn": "LastUsed",
    "cache": [
      {
        "id": "/providers/Microsoft.Management/managementGroups/72f988bf-86f1-41af-91ab-2d7cd011db47",
        "name": "72f988bf-86f1-41af-91ab-2d7cd011db47",
        "channel": "Modern",
        "subchannel": "NotApplicable",
        "parent": "/providers/Microsoft.Management/managementGroups/acm",
        "status": "enabled"
      }
    ]
  }
}

Definitioner

Name	Description
Cache	Matris med omfång med ytterligare information som används av Cost Management i Azure-portalen.
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".
Setting	Status för myscope-inställningen.

Cache

Objekt

Matris med omfång med ytterligare information som används av Cost Management i Azure-portalen.

Name	Typ	Description
channel	string	Anger kontotypen. Tillåtna värden är: EA, PAYG, Modern, Intern, Okänd.
id	string	Resurs-ID som används av Resource Manager för att unikt identifiera omfånget.
name	string	Visningsnamn för omfånget.
parent	string	Resurs-ID för det överordnade omfånget. Till exempel prenumerationens resurs-ID för en resursgrupp eller ett resurs-ID för en prenumeration.
status	string	Anger omfångets status. Status gäller endast för prenumerationer och faktureringskonton.
subchannel	string	Anger typen av modernt konto. Tillåtna värden är: Individual, Enterprise, Partner, Indirect, NotApplicable

ErrorDetails

Objekt

Information om felet.

Name	Typ	Description
code	string	Felkod.
message	string	Felmeddelande som anger varför åtgärden misslyckades.

ErrorResponse

Objekt

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.

Setting

Objekt

Status för myscope-inställningen.

Name	Typ	Description
id	string	Resurs-ID.
kind	string maxLength: 10	Resurstyp.
name	string	Resursnamn.
properties.cache	Cache[]	Matris med omfång med ytterligare information som används av Cost Management i Azure-portalen.
properties.scope	string	Anger standardomfånget som den aktuella användaren ser när de loggar in på Azure Cost Management i Azure-portalen.
properties.startOn	enum: LastUsed ScopePicker SpecificScope	Anger vilket omfång Cost Management i Azure-portalen ska vara som standard. Tillåtna värden: Senast använda.
type	string	Resurstyp.