Settings - Get

Szolgáltatás:

Cost Management

API-verzió:

2019-11-01

Egy adott beállítás aktuális értékét kéri le.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
settingName	path	True	string maxLength: 32	A beállítás neve. Engedélyezett értékek: myscope
api-version	query	True	string	Az ügyfélkéréshez használandó API verziója. A jelenlegi verzió: 2019-11-01.

Válaszok

Name	Típus	Description
200 OK	Setting	OKÉ. A kérés sikeres volt.
Other Status Codes	ErrorResponse	Hibaválasz, amely leírja, hogy miért nem sikerült a művelet.

Biztonság

azure_auth

Azure Active Directory Oauth2-folyamat.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

Settings

Mintakérelem

HTTP

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

Mintaválasz

Állapotkód:

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"
      }
    ]
  }
}

Definíciók

Name	Description
Cache	Hatókörök tömbje a Cost Management által az Azure Portalon használt további részletekkel.
ErrorDetails	A hiba részletei.
ErrorResponse	A hibaválasz azt jelzi, hogy a szolgáltatás nem tudja feldolgozni a bejövő kérést. Ennek okát a hibaüzenet adja meg. Néhány hibaválasz: 429 TooManyRequests – A kérés szabályozva van. Próbálkozzon újra az "x-ms-ratelimit-microsoft.consumption-retry-after" fejlécben megadott időre való várakozás után. 503 ServiceUnavailable – A szolgáltatás átmenetileg nem érhető el. Próbálkozzon újra az "Újrapróbálkozás után" fejlécben megadott időre való várakozás után.
Setting	A myscope beállítás állapota.

Cache

Objektum

Hatókörök tömbje a Cost Management által az Azure Portalon használt további részletekkel.

Name	Típus	Description
channel	string	A fiók típusát jelzi. Az engedélyezett értékek a következők: EA, PAYG, Modern, Belső, Ismeretlen.
id	string	A Resource Manager által a hatókör egyedi azonosítására használt erőforrás-azonosító.
name	string	A hatókör megjelenítendő neve.
parent	string	A szülőhatókör erőforrás-azonosítója. Például az előfizetés erőforrás-azonosítója egy erőforráscsoporthoz vagy egy előfizetés felügyeleticsoport-erőforrás-azonosítója.
status	string	A hatókör állapotát jelzi. Az állapot csak az előfizetésekre és a számlázási fiókokra vonatkozik.
subchannel	string	A modern fiók típusát jelzi. Az engedélyezett értékek a következők: Individual, Enterprise, Partner, Indirect, NotApplicable

ErrorDetails

Objektum

A hiba részletei.

Name	Típus	Description
code	string	Hibakód.
message	string	A művelet sikertelen voltát jelző hibaüzenet.

ErrorResponse

Objektum

A hibaválasz azt jelzi, hogy a szolgáltatás nem tudja feldolgozni a bejövő kérést. Ennek okát a hibaüzenet adja meg.

Néhány hibaválasz:

• 429 TooManyRequests – A kérés szabályozva van. Próbálkozzon újra az "x-ms-ratelimit-microsoft.consumption-retry-after" fejlécben megadott időre való várakozás után.

• 503 ServiceUnavailable – A szolgáltatás átmenetileg nem érhető el. Próbálkozzon újra az "Újrapróbálkozás után" fejlécben megadott időre való várakozás után.

Name	Típus	Description
error	ErrorDetails	A hiba részletei.

Setting

Objektum

A myscope beállítás állapota.

Name	Típus	Description
id	string	Erőforrás-azonosító.
kind	string maxLength: 10	Erőforrás típusa.
name	string	Erőforrás neve.
properties.cache	Cache[]	Hatókörök tömbje a Cost Management által az Azure Portalon használt további részletekkel.
properties.scope	string	Beállítja az alapértelmezett hatókört, amely akkor jelenik meg, amikor az aktuális felhasználó bejelentkezik az Azure Cost Managementbe az Azure Portalon.
properties.startOn	enum: LastUsed ScopePicker SpecificScope	Azt jelzi, hogy az Azure Portalon milyen hatókörbe kell alapértelmezetten bekerülnie a Cost Management szolgáltatásnak. Engedélyezett értékek: LastUsed.
type	string	Erőforrás típusa.