Settings - Get

Služba:

Cost Management

Verze rozhraní API:

2019-11-01

Načte aktuální hodnotu pro konkrétní nastavení.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
settingName	path	True	string maxLength: 32	Název nastavení Povolené hodnoty: myscope
api-version	query	True	string	Verze rozhraní API, která se má použít s požadavkem klienta. Aktuální verze je 11. 11. 2019.

Odpovědi

Name	Typ	Description
200 OK	Setting	OK. Požadavek byl úspěšný.
Other Status Codes	ErrorResponse	Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Settings

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kó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"
      }
    ]
  }
}

Definice

Name	Description
Cache	Pole oborů s dalšími podrobnostmi používanými službou Cost Management na webu Azure Portal
ErrorDetails	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď značí, že služba nemůže zpracovat příchozí požadavek. Důvod je uvedený v chybové zprávě. Některé chybové odpovědi: 429 TooManyRequests – Požadavek je omezený. Opakujte akci po čekání na dobu uvedenou v hlavičce x-ms-ratelimit-microsoft.consumption-retry-after. 503 ServiceUnavailable – Služba je dočasně nedostupná. Opakujte akci po čekání na dobu uvedenou v hlavičce Opakovat až po spuštění.
Setting	Stav nastavení myscope.

Cache

Objekt

Pole oborů s dalšími podrobnostmi používanými službou Cost Management na webu Azure Portal

Name	Typ	Description
channel	string	Určuje typ účtu. Mezi povolené hodnoty patří: EA, PAYG, Modern, Internal, Unknown.
id	string	ID prostředku používané Resource Managerem k jednoznačné identifikaci oboru
name	string	Zobrazovaný název oboru.
parent	string	ID prostředku nadřazeného oboru Id prostředku předplatného například pro skupinu prostředků nebo ID prostředku skupiny pro správu předplatného.
status	string	Označuje stav oboru. Stav platí jenom pro předplatná a fakturační účty.
subchannel	string	Označuje typ moderního účtu. Mezi povolené hodnoty patří: individual, Enterprise, Partner, Indirect, NotApplicable

ErrorDetails

Objekt

Podrobnosti o chybě.

Name	Typ	Description
code	string	Kód chyby
message	string	Chybová zpráva označující, proč operace selhala.

ErrorResponse

Objekt

Chybová odpověď značí, že služba nemůže zpracovat příchozí požadavek. Důvod je uvedený v chybové zprávě.

Některé chybové odpovědi:

• 429 TooManyRequests – Požadavek je omezený. Opakujte akci po čekání na dobu uvedenou v hlavičce x-ms-ratelimit-microsoft.consumption-retry-after.

• 503 ServiceUnavailable – Služba je dočasně nedostupná. Opakujte akci po čekání na dobu uvedenou v hlavičce Opakovat až po spuštění.

Name	Typ	Description
error	ErrorDetails	Podrobnosti o chybě.

Setting

Objekt

Stav nastavení myscope.

Name	Typ	Description
id	string	ID prostředku.
kind	string maxLength: 10	Druh prostředku.
name	string	Název prostředku
properties.cache	Cache[]	Pole oborů s dalšími podrobnostmi používanými službou Cost Management na webu Azure Portal
properties.scope	string	Nastaví výchozí obor, který aktuální uživatel uvidí, když se přihlásí ke službě Azure Cost Management na webu Azure Portal.
properties.startOn	enum: LastUsed ScopePicker SpecificScope	Určuje, jaký rozsah služby Cost Management na webu Azure Portal by měl být výchozí. Povolené hodnoty: LastUsed.
type	string	Typ prostředku.