Dimensions - By External Cloud Provider Type

Riferimento

Service:: Cost Management

API Version:: 2023-11-01

Elenchi le dimensioni in base al tipo di provider cloud esterno.

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}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
externalCloudProviderId	path	True	string	Questo può essere '{externalSubscriptionId}' per l'account collegato o '{externalBillingAccountId}' per l'account consolidato usato con operazioni di dimensione/query.
externalCloudProviderType	path	True	externalCloudProviderType	Tipo di provider cloud esterno associato alle operazioni di dimensione/query. Sono inclusi "externalSubscriptions" per l'account collegato e "externalBillingAccounts" per l'account consolidato.
api-version	query	True	string	Versione dell'API da usare per questa operazione.
$expand	query		string	Può essere usato per espandere le proprietà/i dati all'interno di una categoria di dimensioni. Per impostazione predefinita, i dati non vengono inclusi quando si elencano le dimensioni.
$filter	query		string	Può essere usato per filtrare le dimensioni per proprietà/categoria, proprietà/utilizzoStart, proprietà/utilizzoEnd. Gli operatori supportati sono "eq",'lt', 'gt', 'le', 'ge'.
$skiptoken	query		string	Skiptoken viene usato solo se un'operazione precedente ha restituito un risultato parziale. Se una risposta precedente contiene un elemento nextLink, il valore dell'elemento nextLink includerà un parametro skiptoken che specifica un punto di partenza da usare per le chiamate successive.
$top	query		integer int32	Può essere usato per limitare il numero di risultati ai dati di dimensione N più recenti.

Risposte

Nome	Tipo	Descrizione
200 OK	DimensionsListResult	OK. La richiesta ha avuto esito positivo.
Other Status Codes	ErrorResponse	Risposta di errore che descrive perché l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

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

Scopes

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

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

Definizioni

Nome	Descrizione
Dimension	Elenco di dimensioni.
DimensionsListResult	Risultato delle dimensioni di elenco. Contiene un elenco di dimensioni disponibili.
ErrorDetails	Dettagli dell'errore.
ErrorResponse	Risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore. Alcune risposte di errore: 429 TooManyRequests - La richiesta è limitata. Riprovare dopo l'attesa dell'ora specificata nell'intestazione "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable : il servizio non è temporaneamente disponibile. Riprovare dopo aver atteso il tempo specificato nell'intestazione "Retry-After".
externalCloudProviderType	Tipo di provider cloud esterno associato alle operazioni di dimensione/query. Sono inclusi "externalSubscriptions" per l'account collegato e "externalBillingAccounts" per l'account consolidato.

Dimension

Elenco di dimensioni.

Nome	Tipo	Descrizione
eTag	string	ETag della risorsa.
id	string	ID risorsa.
location	string	Posizione della risorsa.
name	string	Nome risorsa.
properties.category	string	Categoria dimensione.
properties.data	string[]	Dati delle dimensioni.
properties.description	string	Descrizione dimensione.
properties.filterEnabled	boolean	Filtro abilitato.
properties.groupingEnabled	boolean	Raggruppamento abilitato.
properties.nextLink	string	Collegamento (URL) alla pagina successiva dei risultati.
properties.total	integer	Numero totale di dati per la dimensione.
properties.usageEnd	string	Fine utilizzo.
properties.usageStart	string	Inizio utilizzo.
sku	string	SKU della risorsa.
tags	object	Tag di risorse.
type	string	Tipo di risorsa.

DimensionsListResult

Risultato delle dimensioni di elenco. Contiene un elenco di dimensioni disponibili.

Nome	Tipo	Descrizione
value	Dimension[]	Elenco di dimensioni.

ErrorDetails

Dettagli dell'errore.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore che indica perché l'operazione non è riuscita.

ErrorResponse

Risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.

Alcune risposte di errore:

429 TooManyRequests - La richiesta è limitata. Riprovare dopo l'attesa dell'ora specificata nell'intestazione "x-ms-ratelimit-microsoft.consumption-retry-after".
503 ServiceUnavailable : il servizio non è temporaneamente disponibile. Riprovare dopo aver atteso il tempo specificato nell'intestazione "Retry-After".

Nome	Tipo	Descrizione
error	ErrorDetails	Dettagli dell'errore.

externalCloudProviderType

Tipo di provider cloud esterno associato alle operazioni di dimensione/query. Sono inclusi "externalSubscriptions" per l'account collegato e "externalBillingAccounts" per l'account consolidato.

Nome	Tipo	Descrizione
externalBillingAccounts	string
externalSubscriptions	string

Share via

Dimensions - By External Cloud Provider Type

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Scopes

Esempio

ExternalBillingAccountDimensionList

Sample Request

Sample Response

ExternalSubscriptionDimensionList

Sample Request

Sample Response

Definizioni

Dimension

DimensionsListResult

ErrorDetails

ErrorResponse

externalCloudProviderType

Risorse aggiuntive