Dimensions - By External Cloud Provider Type

Ссылка

Service:: Cost Management

API Version:: 2023-11-01

Списки измерения по типу внешнего поставщика облачных служб.

GET https://management.azure.com/providers/Microsoft.CostManagement/{externalCloudProviderType}/{externalCloudProviderId}/dimensions?api-version=2023-11-01

With optional parameters:

GET https://management.azure.com/providers/Microsoft.CostManagement/{externalCloudProviderType}/{externalCloudProviderId}/dimensions?api-version=2023-11-01&$filter={$filter}&$expand={$expand}&$skiptoken={$skiptoken}&$top={$top}

Параметры URI

Имя	В	Обязательно	Тип	Описание
externalCloudProviderId	path	True	string	Это может быть "{externalSubscriptionId}" для связанной учетной записи или "{externalBillingAccountId}" для консолидированной учетной записи, используемой с операциями измерения или запроса.
externalCloudProviderType	path	True	externalCloudProviderType	Тип внешнего поставщика облачных служб, связанный с операциями измерения или запроса. Сюда входят externalSubscriptions для связанной учетной записи и externalBillingAccounts для консолидированной учетной записи.
api-version	query	True	string	Версия API, используемая для данной операции.
$expand	query		string	Может использоваться для развертывания свойств или данных в категории измерений. По умолчанию данные не включаются при перечислении измерений.
$filter	query		string	Может использоваться для фильтрации измерений по свойствам/категориям, properties/usageStart, properties/usageEnd. Поддерживаемые операторы: "eq", "lt", "gt", "le", "ge".
$skiptoken	query		string	Skiptoken используется, только если предыдущая операция вернула частичный результат. Если предыдущий ответ содержит элемент nextLink, значение элемента nextLink будет включать параметр skiptoken, указывающий начальную точку для последующих вызовов.
$top	query		integer int32	Может использоваться для ограничения количества результатов самыми последними N-данными измерения.

Ответы

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

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

azure_auth

Поток OAuth2 в Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

Примеры

ExternalBillingAccountDimensionList

ExternalSubscriptionDimensionList

ExternalBillingAccountDimensionList

Sample Request

HTTP

GET https://management.azure.com/providers/Microsoft.CostManagement/externalBillingAccounts/100/dimensions?api-version=2023-11-01

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "providers/Microsoft.CostManagement/externalBillingAccounts/100/dimensions_ResourceType_2019-12-01_2019-12-31",
      "name": "dimensions_ResourceType_2019-12-01_2019-12-31",
      "type": "microsoft.consumption/dimensions",
      "properties": {
        "data": [
          "thoroetrg01",
          "default-notificationhubs-westus",
          "jedikeyvaultrg",
          "contosocodeflow8d4a",
          "noobaa"
        ],
        "total": 0,
        "category": "ResourceType",
        "description": "Resource type",
        "usageStart": "2019-12-01T00:00:00Z",
        "usageEnd": "2019-12-31T00:00:00Z",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    },
    {
      "id": "providers/Microsoft.CostManagement/externalBillingAccounts/100/dimensions_ResourceId_2019-12-01_2019-12-31",
      "name": "dimensions_ResourceId_2019-12-01_2019-12-31",
      "type": "microsoft.consumption/dimensions",
      "properties": {
        "data": [
          "thoroetrg01",
          "default-notificationhubs-westus",
          "jedikeyvaultrg",
          "contosocodeflow8d4a",
          "noobaa"
        ],
        "total": 0,
        "category": "ResourceId",
        "description": "Resource ID",
        "usageStart": "2019-12-01T00:00:00Z",
        "usageEnd": "2019-12-31T00:00:00Z",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    }
  ]
}

ExternalSubscriptionDimensionList

Sample Request

HTTP

GET https://management.azure.com/providers/Microsoft.CostManagement/externalSubscriptions/100/dimensions?api-version=2023-11-01

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "providers/Microsoft.CostManagement/externalSubscriptions/123/dimensions_ResourceType_2019-12-01_2019-12-31",
      "name": "dimensions_ResourceType_2019-12-01_2019-12-31",
      "type": "microsoft.consumption/dimensions",
      "properties": {
        "data": [
          "thoroetrg01",
          "default-notificationhubs-westus",
          "jedikeyvaultrg",
          "contosocodeflow8d4a",
          "noobaa"
        ],
        "total": 0,
        "category": "ResourceType",
        "description": "Resource type",
        "usageStart": "2019-12-01T00:00:00Z",
        "usageEnd": "2019-12-31T00:00:00Z",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    },
    {
      "id": "providers/Microsoft.CostManagement/externalSubscriptions/123/dimensions_ResourceId_2019-12-01_2019-12-31",
      "name": "dimensions_ResourceId_2019-12-01_2019-12-31",
      "type": "microsoft.consumption/dimensions",
      "properties": {
        "data": [
          "thoroetrg01",
          "default-notificationhubs-westus",
          "jedikeyvaultrg",
          "contosocodeflow8d4a",
          "noobaa"
        ],
        "total": 0,
        "category": "ResourceId",
        "description": "Resource ID",
        "usageStart": "2019-12-01T00:00:00Z",
        "usageEnd": "2019-12-31T00:00:00Z",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    }
  ]
}

Определения

Имя	Описание
Dimension	Список измерений.
DimensionsListResult	Результат перечисления измерений. Он содержит список доступных измерений.
ErrorDetails	Сведения об ошибке.
ErrorResponse	Ответ об ошибке указывает, что служба не может обработать входящий запрос. Причина указана в сообщении об ошибке. Некоторые ответы об ошибках: 429 TooManyRequests — запрос регулируется. Повторите попытку после ожидания времени, указанного в заголовке "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable — служба временно недоступна. Повторите попытку по окончании периода времени, указанного в заголовке Retry-After.
externalCloudProviderType	Тип внешнего поставщика облачных служб, связанный с операциями измерения или запроса. Сюда входят externalSubscriptions для связанной учетной записи и externalBillingAccounts для консолидированной учетной записи.

Dimension

Список измерений.

Имя	Тип	Описание
eTag	string	ETag ресурса.
id	string	Идентификатор ресурса.
location	string	Расположение ресурса.
name	string	Имя ресурса.
properties.category	string	Категория измерения.
properties.data	string[]	Данные измерений.
properties.description	string	Описание измерения.
properties.filterEnabled	boolean	Фильтр включен.
properties.groupingEnabled	boolean	Группирование включено.
properties.nextLink	string	Ссылка (URL-адрес) на следующую страницу результатов.
properties.total	integer	Общее количество данных для измерения.
properties.usageEnd	string	Конец использования.
properties.usageStart	string	Начало использования.
sku	string	SKU ресурса.
tags	object	Теги ресурсов.
type	string	Тип ресурса.

DimensionsListResult

Результат перечисления измерений. Он содержит список доступных измерений.

Имя	Тип	Описание
value	Dimension[]	Список измерений.

ErrorDetails

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

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

ErrorResponse

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

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

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

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

externalCloudProviderType

Тип внешнего поставщика облачных служб, связанный с операциями измерения или запроса. Сюда входят externalSubscriptions для связанной учетной записи и externalBillingAccounts для консолидированной учетной записи.

Имя	Тип	Описание
externalBillingAccounts	string
externalSubscriptions	string

Dimensions - By External Cloud Provider Type

Параметры URI

Ответы

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

azure_auth

Scopes

Примеры

ExternalBillingAccountDimensionList

Sample Request

Sample Response

ExternalSubscriptionDimensionList

Sample Request

Sample Response

Определения

Dimension

DimensionsListResult

ErrorDetails

ErrorResponse

externalCloudProviderType

Дополнительные ресурсы