Settings - Get

Служба:

Cost Management

Версия API:

2019-11-01

Извлекает текущее значение для определенного параметра.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
settingName	path	True	string maxLength: 32	Имя параметра. Допустимые значения: myscope
api-version	query	True	string	Версия API для использования с клиентским запросом. Текущая версия — 2019-11-01.

Ответы

Имя	Тип	Описание
200 OK	Setting	ХОРОШО. Запрос выполнен успешно.
Other Status Codes	ErrorResponse	Ответ на ошибку, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

Settings

Образец запроса

HTTP

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

Пример ответа

Код состояния:

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

Определения

Имя	Описание
Cache	Массив областей с дополнительными сведениями, используемыми управлением затратами на портале Azure.
ErrorDetails	Сведения об ошибке.
ErrorResponse	Ответ на ошибку указывает, что служба не может обработать входящий запрос. Причина указана в сообщении об ошибке. Некоторые ответы на ошибки: 429 TooManyRequests — запрос регулируется. Повторите попытку после ожидания времени, указанного в заголовке x-ms-ratelimit-microsoft.consumption-retry-after. 503 ServiceUnavailable — служба временно недоступна. Повторите попытку после ожидания времени, указанного в заголовке Retry-After.
Setting	Состояние параметра myscope.

Cache

Object

Массив областей с дополнительными сведениями, используемыми управлением затратами на портале Azure.

Имя	Тип	Описание
channel	string	Указывает тип учетной записи. Допустимые значения: EA, PAYG, Modern, Internal, Unknown.
id	string	Идентификатор ресурса, используемый Resource Manager для уникальной идентификации области.
name	string	Отображаемое имя области.
parent	string	Идентификатор ресурса родительской области. Например, идентификатор ресурса подписки для группы ресурсов или идентификатора ресурса группы управления для подписки.
status	string	Указывает состояние области. Состояние применяется только к подпискам и учетным записям выставления счетов.
subchannel	string	Указывает тип современной учетной записи. Допустимые значения: Индивидуальный, Корпоративный, Партнер, Косвенный, NotApplicable

ErrorDetails

Object

Сведения об ошибке.

Имя	Тип	Описание
code	string	Код ошибки.
message	string	Сообщение об ошибке, указывающее, почему операция завершилась ошибкой.

ErrorResponse

Object

Ответ на ошибку указывает, что служба не может обработать входящий запрос. Причина указана в сообщении об ошибке.

Некоторые ответы на ошибки:

• 429 TooManyRequests — запрос регулируется. Повторите попытку после ожидания времени, указанного в заголовке x-ms-ratelimit-microsoft.consumption-retry-after.

• 503 ServiceUnavailable — служба временно недоступна. Повторите попытку после ожидания времени, указанного в заголовке Retry-After.

Имя	Тип	Описание
error	ErrorDetails	Сведения об ошибке.

Setting

Object

Состояние параметра myscope.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
kind	string maxLength: 10	Тип ресурса.
name	string	Имя ресурса.
properties.cache	Cache[]	Массив областей с дополнительными сведениями, используемыми управлением затратами на портале Azure.
properties.scope	string	Задает область по умолчанию, когда текущий пользователь будет видеть при входе в службу "Управление затратами Azure" на портале Azure.
properties.startOn	enum: LastUsed ScopePicker SpecificScope	Указывает, какая область управления затратами на портале Azure должна быть по умолчанию. Допустимые значения: LastUsed.
type	string	Тип ресурса.