Generate Cost Details Report - Get Operation Results

Riferimento

Service:: Cost Management

API Version:: 2023-11-01

Ottenere il risultato dell'operazione specificata. Questo collegamento viene fornito nell'intestazione Location della richiesta di creazione CostDetails.

GET https://management.azure.com/{scope}/providers/Microsoft.CostManagement/costDetailsOperationResults/{operationId}?api-version=2023-11-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
operationId	path	True	string	ID operazione di destinazione.
scope	path	True	string	ID risorsa ARM per la sottoscrizione, l'account di fatturazione o altri ambiti di fatturazione. Attualmente il gruppo di risorse e il gruppo di gestione non sono supportati. Per informazioni dettagliate, vedere https://aka.ms/costmgmt/scopes.
api-version	query	True	string	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	CostDetailsOperationResults	OK. La richiesta ha avuto esito positivo.
202 Accepted		Accettato. L'operazione è in corso.
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui 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

Get details of the operation result

Sample Request

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000?api-version=2023-11-01

Sample Response

Status code:: 200

{
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000",
  "name": "00000000-0000-0000-0000-000000000000",
  "status": "Completed",
  "manifest": {
    "manifestVersion": "2023-11-01",
    "dataFormat": "Csv",
    "blobCount": 1,
    "byteCount": 32741,
    "compressData": false,
    "requestContext": {
      "requestScope": "subscriptions/00000000-0000-0000-0000-000000000000",
      "requestBody": {
        "metric": "ActualCost",
        "timePeriod": {
          "start": "2020-03-01",
          "end": "2020-03-15"
        }
      }
    },
    "blobs": [
      {
        "blobLink": "https://ccmreportstorageeastus.blob.core.windows.net/armreports/00000/00000000-0000-0000-0000-000000000000?sv=2020-05-31&sr=b&sig=abcd",
        "byteCount": 32741
      }
    ]
  },
  "validTill": "2022-05-10T08:08:46.1973252Z"
}

Status code:: 202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000?api-version=2023-11-01
Retry-After: 60

Definizioni

Nome	Descrizione
BlobInfo	Informazioni sul BLOB generate da questa operazione.
CostDetailsDataFormat	Formato dei dati del report
CostDetailsMetricType	Tipo del report dettagliato. Per impostazione predefinita viene fornito ActualCost
CostDetailsOperationResults	Risultato dell'operazione a esecuzione prolungata per l'API dei dettagli dei costi.
CostDetailsStatusType	Stato dell'operazione relativa ai dettagli dei costi
CostDetailsTimePeriod	Data di inizio e fine per il pull dei dati per il report dettagliato sui costi. L'API consente solo il pull dei dati per 1 mese o meno e non più di 13 mesi.
ErrorDetails	Dettagli dell'errore.
ErrorResponse	La 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 del tempo specificato 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".
GenerateCostDetailsReportRequestDefinition	Definizione di un report dettagliato sui costi.

BlobInfo

Informazioni sul BLOB generate da questa operazione.

Nome	Tipo	Descrizione
blobLink	string	Collegamento al BLOB per scaricare il file.
byteCount	integer	Byte nel BLOB.

CostDetailsDataFormat

Formato dei dati del report

Nome	Tipo	Descrizione
Csv	string	Formato dati CSV.

CostDetailsMetricType

Tipo del report dettagliato. Per impostazione predefinita viene fornito ActualCost

Nome	Tipo	Descrizione
ActualCost	string	Dati di costo effettivi.
AmortizedCost	string	Dati dei costi ammortizzati.

CostDetailsOperationResults

Risultato dell'operazione a esecuzione prolungata per l'API dei dettagli dei costi.

Nome	Tipo	Descrizione
error	ErrorDetails	Dettagli dell'errore.
id	string	ID dell'operazione a esecuzione prolungata.
manifest.blobCount	integer	Numero totale di BLOB.
manifest.blobs	BlobInfo[]	Elenco di informazioni SUI BLOB generate da questa operazione.
manifest.byteCount	integer	Numero totale di byte in tutti i BLOB.
manifest.compressData	boolean	Dati in formato compresso.
manifest.dataFormat	CostDetailsDataFormat	Formato dei dati del report
manifest.manifestVersion	string	Versione del manifesto.
manifest.requestContext.requestBody	GenerateCostDetailsReportRequestDefinition	Corpo del payload della richiesta fornito nella chiamata Dettagli costi
manifest.requestContext.requestScope	string	Ambito della richiesta.
name	string	Nome dell'operazione a esecuzione prolungata.
status	CostDetailsStatusType	Stato dell'operazione relativa ai dettagli dei costi
type	string	Tipo dell'operazione a esecuzione prolungata.
validTill	string	Ora in cui l'URL del report diventa non valido/scade in formato UTC, ad esempio 2020-12-08T05:55:59.4394737Z.

CostDetailsStatusType

Stato dell'operazione relativa ai dettagli dei costi

Nome	Tipo	Descrizione
Completed	string	L'operazione è Completata.
Failed	string	Operazione non riuscita.
NoDataFound	string	L'operazione è Completata e non sono stati trovati dati relativi ai costi.

CostDetailsTimePeriod

Data di inizio e fine per il pull dei dati per il report dettagliato sui costi. L'API consente solo il pull dei dati per 1 mese o meno e non più di 13 mesi.

Nome	Tipo	Descrizione
end	string	Data di fine in cui eseguire il pull dei dati. formato di esempio 2020-03-15
start	string	Data di inizio da cui estrarre i dati. formato di esempio 2020-03-15

ErrorDetails

Dettagli dell'errore.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

ErrorResponse

La 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 del tempo specificato 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.

GenerateCostDetailsReportRequestDefinition

Definizione di un report dettagliato sui costi.

Nome	Tipo	Descrizione
billingPeriod	string	Questo parametro può essere usato solo da Enterprise Agreement clienti. Usa il formato YearMonth(ad esempio 202008). Questo parametro non può essere usato insieme ai parametri invoiceId o timePeriod. Se un parametro timePeriod, invoiceId o billingPeriod non viene fornito nel corpo della richiesta, l'API restituirà il costo del mese corrente.
invoiceId	string	Questo parametro può essere usato solo dai clienti Contratto del cliente Microsoft. Inoltre, può essere usato solo nell'ambito del profilo di fatturazione o del cliente. Questo parametro non può essere usato insieme ai parametri billingPeriod o timePeriod. Se un parametro timePeriod, invoiceId o billingPeriod non viene fornito nel corpo della richiesta, l'API restituirà il costo del mese corrente.
metric	CostDetailsMetricType	Tipo del report dettagliato. Per impostazione predefinita viene fornito ActualCost
timePeriod	CostDetailsTimePeriod	Intervallo di date specifico dei dettagli dei costi richiesti per il report. Questo parametro non può essere usato insieme ai parametri invoiceId o billingPeriod. Se un parametro timePeriod, invoiceId o billingPeriod non viene fornito nel corpo della richiesta, l'API restituirà il costo del mese corrente. L'API consente solo il pull dei dati per 1 mese o meno e non più di 13 mesi. Se non viene fornito alcun valore timePeriod o billingPeriod o invoiceId, l'API viene usata per impostazione predefinita per il periodo di tempo del mese di apertura

Condividi tramite