Generate Cost Details Report - Get Operation Results

Referens

Tjänst:: Cost Management

API-version:: 2024-08-01

Hämta resultatet av den angivna åtgärden. Den här länken finns i begärandesvarets platsrubrik för CostDetails-skapandebegäran.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
operationId	path	True	string	Målåtgärdens ID.
scope	path	True	string	ARM-resurs-ID för prenumeration, faktureringskonto eller andra faktureringsomfång. För närvarande stöds inte resursgrupp och hanteringsgrupp. Mer information finns i https://aka.ms/costmgmt/scopes.
api-version	query	True	string minLength: 1	DEN API-version som ska användas för den här åtgärden.

Svar

Name	Typ	Description
200 OK	CostDetailsOperationResults	OKEJ. Begäran har slutförts.
202 Accepted		Accepterad. Åtgärden pågår.
Other Status Codes	ErrorResponse	Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Get details of the operation result

Exempelbegäran

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

Exempelsvar

Statuskod:: 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"
}

Statuskod:: 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

Definitioner

Name	Description
BlobInfo	Blobinformationen som genereras av den här åtgärden.
CostDetailsDataFormat	Rapportens dataformat
CostDetailsMetricType	Typen av detaljerad rapport. Som standard tillhandahålls ActualCost
CostDetailsOperationResults	Resultatet av den tidskrävande åtgärden för api för kostnadsinformation.
CostDetailsStatusType	Status för kostnadsinformationsåtgärden
CostDetailsTimePeriod	Start- och slutdatumet för att hämta data för den kostnads detaljerade rapporten. API tillåter endast att data hämtas i en månad eller mindre och inte äldre än 13 månader.
ErrorDetails	Information om felet.
ErrorResponse	Felsvaret anger att tjänsten inte kan bearbeta den inkommande begäran. Orsaken anges i felmeddelandet. Några felsvar: 429 TooManyRequests – Begäran begränsas. Försök igen efter att ha väntat på den tid som anges i rubriken "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable – Tjänsten är inte tillgänglig för tillfället. Försök igen efter att ha väntat på den tid som anges i rubriken "Försök igen".
GenerateCostDetailsReportRequestDefinition	Definitionen av en kostnadsbegränsade rapport.

BlobInfo

Objekt

Blobinformationen som genereras av den här åtgärden.

Name	Typ	Description
blobLink	string	Länka till bloben för att ladda ned filen.
byteCount	integer (int64)	Byte i bloben.

CostDetailsDataFormat

Uppräkning

Rapportens dataformat

Värde	Description
Csv	Csv-dataformat.

CostDetailsMetricType

Uppräkning

Typen av detaljerad rapport. Som standard tillhandahålls ActualCost

Värde	Description
ActualCost	Faktiska kostnadsdata.
AmortizedCost	Amorterade kostnadsdata.

CostDetailsOperationResults

Objekt

Resultatet av den tidskrävande åtgärden för api för kostnadsinformation.

Name	Typ	Description
error	ErrorDetails	Information om felet.
id	string	ID:t för den tidskrävande åtgärden.
manifest.blobCount	integer (int32)	Det totala antalet blobar.
manifest.blobs	BlobInfo[]	Lista över blobinformation som genereras av den här åtgärden.
manifest.byteCount	integer (int64)	Det totala antalet byte i alla blobar.
manifest.compressData	boolean	Är data i komprimerat format.
manifest.dataFormat	CostDetailsDataFormat	Rapportens dataformat
manifest.manifestVersion	string	Manifestversionen.
manifest.requestContext.requestBody	GenerateCostDetailsReportRequestDefinition	Begärandenyttolasttexten som anges i kostnadsinformationsanropet
manifest.requestContext.requestScope	string	Begärans omfattning.
name	string	Namnet på den tidskrävande åtgärden.
status	CostDetailsStatusType	Status för kostnadsinformationsåtgärden
type	string	Typen av tidskrävande åtgärd.
validTill	string (date-time)	Den tid då rapport-URL:en blir ogiltig/upphör att gälla i UTC, t.ex. 2020-12-08T05:55:59.4394737Z.

CostDetailsStatusType

Uppräkning

Status för kostnadsinformationsåtgärden

Värde	Description
Completed	Åtgärden har slutförts.
Failed	Åtgärden misslyckades.
NoDataFound	Åtgärden har slutförts och inga kostnadsdata hittades.

CostDetailsTimePeriod

Objekt

Start- och slutdatumet för att hämta data för den kostnads detaljerade rapporten. API tillåter endast att data hämtas i en månad eller mindre och inte äldre än 13 månader.

Name	Typ	Description
end	string	Slutdatumet för att hämta data till. exempelformat 2020-03-15
start	string	Startdatumet för att hämta data från. exempelformat 2020-03-15

ErrorDetails

Objekt

Information om felet.

Name	Typ	Description
code	string	Felkod.
message	string	Felmeddelande som anger varför åtgärden misslyckades.

ErrorResponse

Objekt

Felsvaret anger att tjänsten inte kan bearbeta den inkommande begäran. Orsaken anges i felmeddelandet.

Några felsvar:

429 TooManyRequests – Begäran begränsas. Försök igen efter att ha väntat på den tid som anges i rubriken "x-ms-ratelimit-microsoft.consumption-retry-after".
503 ServiceUnavailable – Tjänsten är inte tillgänglig för tillfället. Försök igen efter att ha väntat på den tid som anges i rubriken "Försök igen".

Name	Typ	Description
error	ErrorDetails	Information om felet.

GenerateCostDetailsReportRequestDefinition

Objekt

Definitionen av en kostnadsbegränsade rapport.

Name	Typ	Description
billingPeriod	string	Den här parametern kan endast användas av Enterprise-avtalskunder. Använd formatet YearMonth(t.ex. 202008). Den här parametern kan inte användas tillsammans med parametrarna invoiceId eller timePeriod. Om parametern timePeriod, invoiceId eller billingPeriod inte anges i begärandetexten returnerar API:et den aktuella månadens kostnad.
invoiceId	string	Den här parametern kan endast användas av Kunder med Microsoft-kundavtal. Dessutom kan den endast användas i faktureringsprofilen eller kundomfånget. Den här parametern kan inte användas tillsammans med parametrarna billingPeriod eller timePeriod. Om parametern timePeriod, invoiceId eller billingPeriod inte anges i begärandetexten returnerar API:et den aktuella månadens kostnad.
metric	CostDetailsMetricType	Typen av detaljerad rapport. Som standard tillhandahålls ActualCost
timePeriod	CostDetailsTimePeriod	Det specifika datumintervall för kostnadsinformation som begärs för rapporten. Den här parametern kan inte användas tillsammans med parametrarna invoiceId eller billingPeriod. Om parametern timePeriod, invoiceId eller billingPeriod inte anges i begärandetexten returnerar API:et den aktuella månadens kostnad. API tillåter endast att data hämtas i en månad eller mindre och inte äldre än 13 månader. Om ingen timePeriod eller billingPeriod eller invoiceId tillhandahålls anges API:et som standard till den öppna månadsperioden

Dela via

Generate Cost Details Report - Get Operation Results

URI-parametrar

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

Get details of the operation result

Exempelbegäran

Exempelsvar

Definitioner

BlobInfo

CostDetailsDataFormat

CostDetailsMetricType

CostDetailsOperationResults

CostDetailsStatusType

CostDetailsTimePeriod

ErrorDetails

ErrorResponse

GenerateCostDetailsReportRequestDefinition

Ytterligare resurser