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

Azure Active Directory OAuth2 Flow。

类型: oauth2
流向: 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	资源管理器用于唯一标识作用域的资源 ID。
name	string	范围的显示名称。
parent	string	父范围的资源 ID。 例如，资源组的订阅资源 ID 或订阅的管理组资源 ID。
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	资源 ID。
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	资源类型。