Settings - Get

Usługa:

Cost Management

Wersja interfejsu API:

2019-11-01

Pobiera bieżącą wartość dla określonego ustawienia.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
settingName	path	True	string maxLength: 32	Nazwa ustawienia. Dozwolone wartości: myscope
api-version	query	True	string	Wersja interfejsu API do użycia z żądaniem klienta. Bieżąca wersja to 2019-11-01.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Setting	OK. Żądanie zakończyło się pomyślnie.
Other Status Codes	ErrorResponse	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Settings

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:

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

Definicje

Nazwa	Opis
Cache	Tablica zakresów z dodatkowymi szczegółami używanymi przez usługę Cost Management w witrynie Azure Portal.
ErrorDetails	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd wskazuje, że usługa nie może przetworzyć przychodzącego żądania. Przyczyna jest podana w komunikacie o błędzie. Niektóre odpowiedzi na błędy: 429 TooManyRequests — żądanie jest ograniczane. Ponów próbę po upływie czasu określonego w nagłówku "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable — usługa jest tymczasowo niedostępna. Ponów próbę po upływie czasu określonego w nagłówku "Ponów próbę po".
Setting	Stan ustawienia myscope.

Cache

Objekt

Tablica zakresów z dodatkowymi szczegółami używanymi przez usługę Cost Management w witrynie Azure Portal.

Nazwa	Typ	Opis
channel	string	Wskazuje typ konta. Dozwolone wartości to: EA, PAYG, Modern, Internal, Unknown.
id	string	Identyfikator zasobu używany przez usługę Resource Manager do unikatowego identyfikowania zakresu.
name	string	Nazwa wyświetlana zakresu.
parent	string	Identyfikator zasobu zakresu nadrzędnego. Na przykład identyfikator zasobu subskrypcji dla grupy zasobów lub identyfikator zasobu grupy zarządzania dla subskrypcji.
status	string	Wskazuje stan zakresu. Stan dotyczy tylko subskrypcji i kont rozliczeniowych.
subchannel	string	Wskazuje typ nowoczesnego konta. Dozwolone wartości to: Individual, Enterprise, Partner, Indirect, NotApplicable

ErrorDetails

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
code	string	Kod błędu.
message	string	Komunikat o błędzie wskazujący, dlaczego operacja nie powiodła się.

ErrorResponse

Objekt

Odpowiedź na błąd wskazuje, że usługa nie może przetworzyć przychodzącego żądania. Przyczyna jest podana w komunikacie o błędzie.

Niektóre odpowiedzi na błędy:

• 429 TooManyRequests — żądanie jest ograniczane. Ponów próbę po upływie czasu określonego w nagłówku "x-ms-ratelimit-microsoft.consumption-retry-after".

• 503 ServiceUnavailable — usługa jest tymczasowo niedostępna. Ponów próbę po upływie czasu określonego w nagłówku "Ponów próbę po".

Nazwa	Typ	Opis
error	ErrorDetails	Szczegóły błędu.

Setting

Objekt

Stan ustawienia myscope.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
kind	string maxLength: 10	Rodzaj zasobu.
name	string	Nazwa zasobu.
properties.cache	Cache[]	Tablica zakresów z dodatkowymi szczegółami używanymi przez usługę Cost Management w witrynie Azure Portal.
properties.scope	string	Ustawia domyślny zakres, który bieżący użytkownik zobaczy po zalogowaniu się do usługi Azure Cost Management w witrynie Azure Portal.
properties.startOn	enum: LastUsed ScopePicker SpecificScope	Wskazuje zakres usługi Cost Management w witrynie Azure Portal, domyślnie. Dozwolone wartości: LastUsed.
type	string	Typ zasobu.