Generate Cost Details Report - Get Operation Results

Referentie

Service:: Cost Management

API-versie:: 2024-08-01

Haal het resultaat van de opgegeven bewerking op. Deze koppeling wordt opgegeven in de header van de aanvraag voor het maken van aanvraagantwoordlocatie van CostDetails.

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

URI-parameters

Name	In	Vereist	Type	Description
operationId	path	True	string	De doelbewerkings-id.
scope	path	True	string	De ARM-resource-id voor abonnementen, factureringsaccounts of andere factureringsbereiken. Momenteel worden resourcegroep en beheergroep niet ondersteund. Zie https://aka.ms/costmgmt/scopesvoor meer informatie.
api-version	query	True	string	De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name	Type	Description
200 OK	CostDetailsOperationResults	OK. De aanvraag is voltooid.
202 Accepted		Geaccepteerd. De bewerking wordt uitgevoerd.
Other Status Codes	ErrorResponse	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Get details of the operation result

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:: 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": "2024-08-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"
}

Statuscode:: 202

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

Definities

Name	Description
BlobInfo	De blobgegevens die door deze bewerking worden gegenereerd.
CostDetailsDataFormat	De gegevensindeling van het rapport
CostDetailsMetricType	Het type van het gedetailleerde rapport. ActualCost is standaard opgegeven
CostDetailsOperationResults	Het resultaat van de langdurige bewerking voor de API voor kostendetails.
CostDetailsStatusType	De status van de bewerking met kostendetails
CostDetailsTimePeriod	De begin- en einddatum voor het ophalen van gegevens voor het gedetailleerde kostenrapport. Met de API kunnen alleen gegevens worden opgehaald voor 1 maand of minder en niet ouder dan 13 maanden.
ErrorDetails	De details van de fout.
ErrorResponse	Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden is opgegeven in het foutbericht. Enkele foutberichten: 429 TooManyRequests - Aanvraag wordt beperkt. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header x-ms-ratelimit-microsoft.consumption-retry-after. 503 ServiceUnavailable - Service is tijdelijk niet beschikbaar. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header 'Opnieuw proberen-na'.
GenerateCostDetailsReportRequestDefinition	De definitie van een gedetailleerd kostenrapport.

BlobInfo

De blobgegevens die door deze bewerking worden gegenereerd.

Name	Type	Description
blobLink	string	Koppeling naar de blob om het bestand te downloaden.
byteCount	integer	Bytes in de blob.

CostDetailsDataFormat

De gegevensindeling van het rapport

Name	Type	Description
Csv	string	Csv-gegevensindeling.

CostDetailsMetricType

Het type van het gedetailleerde rapport. ActualCost is standaard opgegeven

Name	Type	Description
ActualCost	string	Werkelijke kostengegevens.
AmortizedCost	string	Afgeschreven kostengegevens.

CostDetailsOperationResults

Het resultaat van de langdurige bewerking voor de API voor kostendetails.

Name	Type	Description
error	ErrorDetails	De details van de fout.
id	string	De id van de langdurige bewerking.
manifest.blobCount	integer	Het totale aantal blobs.
manifest.blobs	BlobInfo[]	Lijst met blobgegevens die door deze bewerking zijn gegenereerd.
manifest.byteCount	integer	Het totale aantal bytes in alle blobs.
manifest.compressData	boolean	Is de gegevens in gecomprimeerde indeling.
manifest.dataFormat	CostDetailsDataFormat	De gegevensindeling van het rapport
manifest.manifestVersion	string	De manifestversie.
manifest.requestContext.requestBody	GenerateCostDetailsReportRequestDefinition	De hoofdtekst van de nettolading van de aanvraag die is opgegeven in de aanroep Kostendetails
manifest.requestContext.requestScope	string	Het aanvraagbereik van de aanvraag.
name	string	De naam van de langdurige bewerking.
status	CostDetailsStatusType	De status van de bewerking met kostendetails
type	string	Het type langdurige bewerking.
validTill	string	Het tijdstip waarop de rapport-URL ongeldig/verloopt in UTC, bijvoorbeeld 2020-12-08T05:55:59.4394737Z.

CostDetailsStatusType

De status van de bewerking met kostendetails

Name	Type	Description
Completed	string	De bewerking is voltooid.
Failed	string	Bewerking mislukt.
NoDataFound	string	De bewerking is voltooid en er zijn geen kostengegevens gevonden.

CostDetailsTimePeriod

De begin- en einddatum voor het ophalen van gegevens voor het gedetailleerde kostenrapport. Met de API kunnen alleen gegevens worden opgehaald voor 1 maand of minder en niet ouder dan 13 maanden.

Name	Type	Description
end	string	De einddatum voor het ophalen van gegevens naar. voorbeeldindeling 2020-03-15
start	string	De begindatum waaruit gegevens moeten worden opgehaald. voorbeeldindeling 2020-03-15

ErrorDetails

De details van de fout.

Name	Type	Description
code	string	Foutcode.
message	string	Foutbericht dat aangeeft waarom de bewerking is mislukt.

ErrorResponse

Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden is opgegeven in het foutbericht.

Enkele foutberichten:

429 TooManyRequests - Aanvraag wordt beperkt. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header x-ms-ratelimit-microsoft.consumption-retry-after.
503 ServiceUnavailable - Service is tijdelijk niet beschikbaar. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header 'Opnieuw proberen-na'.

Name	Type	Description
error	ErrorDetails	De details van de fout.

GenerateCostDetailsReportRequestDefinition

De definitie van een gedetailleerd kostenrapport.

Name	Type	Description
billingPeriod	string	Deze parameter kan alleen worden gebruikt door Enterprise Agreement-klanten. Gebruik de indeling YearMonth(bijvoorbeeld 202008). Deze parameter kan niet worden gebruikt naast de parameters invoiceId of timePeriod. Als een timePeriod-, invoiceId- of billingPeriod-parameter niet is opgegeven in de aanvraagbody, retourneert de API de kosten van de huidige maand.
invoiceId	string	Deze parameter kan alleen worden gebruikt door klanten met een Microsoft-klantovereenkomst. Bovendien kan deze alleen worden gebruikt op het bereik factureringsprofiel of klant. Deze parameter kan niet worden gebruikt naast de parameters billingPeriod of timePeriod. Als een timePeriod-, invoiceId- of billingPeriod-parameter niet is opgegeven in de aanvraagbody, retourneert de API de kosten van de huidige maand.
metric	CostDetailsMetricType	Het type van het gedetailleerde rapport. ActualCost is standaard opgegeven
timePeriod	CostDetailsTimePeriod	Het specifieke datumbereik met kostendetails die voor het rapport zijn aangevraagd. Deze parameter kan niet worden gebruikt naast de parameters invoiceId of billingPeriod. Als een timePeriod-, invoiceId- of billingPeriod-parameter niet is opgegeven in de aanvraagbody, retourneert de API de kosten van de huidige maand. Met de API kunnen alleen gegevens worden opgehaald voor 1 maand of minder en niet ouder dan 13 maanden. Als er geen timePeriod of billingPeriod of invoiceId is opgegeven, wordt de API standaard ingesteld op de periode van de geopende maand

Delen via