Dimensions - By External Cloud Provider Type

Referência

Service:: Cost Management

API Version:: 2023-11-01

Listas as dimensões pelo tipo de provedor de nuvem externo.

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}

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
externalCloudProviderId	path	True	string	Isso pode ser '{externalSubscriptionId}' para a conta vinculada ou '{externalBillingAccountId}' para a conta consolidada usada com operações de dimensão/consulta.
externalCloudProviderType	path	True	externalCloudProviderType	O tipo de provedor de nuvem externo associado a operações de dimensão/consulta. Isso inclui 'externalSubscriptions' para a conta vinculada e 'externalBillingAccounts' para a conta consolidada.
api-version	query	True	string	A versão da API a ser usada para esta operação.
$expand	query		string	Pode ser usado para expandir as propriedades/dados dentro de uma categoria de dimensão. Por padrão, os dados não são incluídos ao listar dimensões.
$filter	query		string	Pode ser usado para filtrar dimensões por propriedades/categoria, propriedades/usageStart, propriedades/usageEnd. Os operadores com suporte são 'eq','lt', 'gt', 'le', 'ge'.
$skiptoken	query		string	Skiptoken só será usado se uma operação anterior retornar um resultado parcial. Se uma resposta anterior contiver um elemento nextLink, o valor do elemento nextLink incluirá um parâmetro skiptoken que especifica um ponto de partida a ser usado para chamadas subsequentes.
$top	query		integer int32	Pode ser usado para limitar o número de resultados aos dados de dimensão N mais recentes.

Respostas

Nome	Tipo	Description
200 OK	DimensionsListResult	OK. A solicitação foi bem-sucedida.
Other Status Codes	ErrorResponse	Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Scopes

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

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

Definições

Nome	Description
Dimension	Lista de Dimensões.
DimensionsListResult	Resultado da listagem de dimensões. Ele contém uma lista de dimensões disponíveis.
ErrorDetails	Os detalhes do erro.
ErrorResponse	A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro. Algumas respostas de erro: 429 TooManyRequests - A solicitação é limitada. Tente novamente depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable - O serviço está temporariamente indisponível. Repita depois de aguardar o tempo especificado no cabeçalho "Retry-After".
externalCloudProviderType	O tipo de provedor de nuvem externo associado a operações de dimensão/consulta. Isso inclui 'externalSubscriptions' para a conta vinculada e 'externalBillingAccounts' para a conta consolidada.

Dimension

Lista de Dimensões.

Nome	Tipo	Description
eTag	string	ETag do recurso.
id	string	ID do recurso.
location	string	Local do recurso.
name	string	Nome do recurso.
properties.category	string	Categoria de dimensão.
properties.data	string[]	Dados de dimensão.
properties.description	string	Descrição da dimensão.
properties.filterEnabled	boolean	Filtro habilitado.
properties.groupingEnabled	boolean	Agrupamento habilitado.
properties.nextLink	string	O link (URL) para a próxima página de resultados.
properties.total	integer	Número total de dados para a dimensão.
properties.usageEnd	string	Fim do uso.
properties.usageStart	string	Início do uso.
sku	string	SKU do recurso.
tags	object	Marcas de recurso.
type	string	Tipo de recurso.

DimensionsListResult

Resultado da listagem de dimensões. Ele contém uma lista de dimensões disponíveis.

Nome	Tipo	Description
value	Dimension[]	A lista de dimensões.

ErrorDetails

Os detalhes do erro.

Nome	Tipo	Description
code	string	Código do erro.
message	string	Mensagem de erro indicando por que a operação falhou.

ErrorResponse

A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.

Algumas respostas de erro:

429 TooManyRequests - A solicitação é limitada. Tente novamente depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after".
503 ServiceUnavailable - O serviço está temporariamente indisponível. Repita depois de aguardar o tempo especificado no cabeçalho "Retry-After".

Nome	Tipo	Description
error	ErrorDetails	Os detalhes do erro.

externalCloudProviderType

O tipo de provedor de nuvem externo associado a operações de dimensão/consulta. Isso inclui 'externalSubscriptions' para a conta vinculada e 'externalBillingAccounts' para a conta consolidada.

Nome	Tipo	Description
externalBillingAccounts	string
externalSubscriptions	string

Dimensions - By External Cloud Provider Type

Parâmetros de URI

Respostas

Segurança

azure_auth

Scopes

Exemplos

ExternalBillingAccountDimensionList

Sample Request

Sample Response

ExternalSubscriptionDimensionList

Sample Request

Sample Response

Definições

Dimension

DimensionsListResult

ErrorDetails

ErrorResponse

externalCloudProviderType

Recursos adicionais