Generate Cost Details Report - Get Operation Results

Reference

Service:: Cost Management

API Version:: 2023-11-01

Získá výsledek zadané operace. Tento odkaz najdete v hlavičce Umístění odpovědi na žádost o vytvoření CostDetails.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
operationId	path	True	string	ID cílové operace.
scope	path	True	string	ID prostředku ARM pro předplatné, fakturační účet nebo jiné rozsahy fakturace. Skupina prostředků a skupina pro správu se v současné době nepodporují. Podrobnosti najdete v tématu https://aka.ms/costmgmt/scopes.
api-version	query	True	string	Verze rozhraní API, která se má použít pro tuto operaci.

Odpovědi

Name	Typ	Description
200 OK	CostDetailsOperationResults	OK. Žádost byla úspěšná.
202 Accepted		Přijata. Operace právě probíhá.
Other Status Codes	ErrorResponse	Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2.

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

Scopes

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

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

Definice

Name	Description
BlobInfo	Informace o objektu blob vygenerované touto operací
CostDetailsDataFormat	Formát dat sestavy
CostDetailsMetricType	Typ podrobné sestavy. Ve výchozím nastavení je k dispozici hodnota ActualCost.
CostDetailsOperationResults	Výsledek dlouhotrvající operace pro rozhraní API podrobností o nákladech.
CostDetailsStatusType	Stav operace podrobností o nákladech
CostDetailsTimePeriod	Počáteční a koncové datum pro načítání dat pro podrobnou sestavu nákladů. Rozhraní API umožňuje načíst data pouze po dobu 1 měsíce nebo méně a ne starší než 13 měsíců.
ErrorDetails	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď znamená, že služba nemůže zpracovat příchozí požadavek. Důvod je uvedený v chybové zprávě. Některé chybové odpovědi: 429 TooManyRequests – Požadavek je omezený. Zkuste to znovu po uplynutí doby určené v hlavičce x-ms-ratelimit-microsoft.consumption-retry-after. 503 ServiceUnavailable – Služba je dočasně nedostupná. Po uplynutí časového limitu uvedeného v hlavičce Retry-After zkuste operaci zopakovat.
GenerateCostDetailsReportRequestDefinition	Definice podrobné sestavy nákladů

BlobInfo

Informace o objektu blob vygenerované touto operací

Name	Typ	Description
blobLink	string	Pro stažení souboru vytvořte odkaz na objekt blob.
byteCount	integer	Bajty v objektu blob.

CostDetailsDataFormat

Formát dat sestavy

Name	Typ	Description
Csv	string	Formát dat CSV.

CostDetailsMetricType

Typ podrobné sestavy. Ve výchozím nastavení je k dispozici hodnota ActualCost.

Name	Typ	Description
ActualCost	string	Data skutečných nákladů.
AmortizedCost	string	Data amortizovaných nákladů.

CostDetailsOperationResults

Výsledek dlouhotrvající operace pro rozhraní API podrobností o nákladech.

Name	Typ	Description
error	ErrorDetails	Podrobnosti o chybě.
id	string	ID dlouhotrvající operace.
manifest.blobCount	integer	Celkový počet objektů blob.
manifest.blobs	BlobInfo[]	Seznam informací o objektech blob vygenerovaných touto operací
manifest.byteCount	integer	Celkový počet bajtů ve všech objektech blob.
manifest.compressData	boolean	Jsou data v komprimovaném formátu.
manifest.dataFormat	CostDetailsDataFormat	Formát dat sestavy
manifest.manifestVersion	string	Verze manifestu.
manifest.requestContext.requestBody	GenerateCostDetailsReportRequestDefinition	Text datové části požadavku uvedený ve volání Podrobnosti o nákladech
manifest.requestContext.requestScope	string	Rozsah požadavku.
name	string	Název dlouhotrvající operace.
status	CostDetailsStatusType	Stav operace podrobností o nákladech
type	string	Typ dlouhotrvající operace.
validTill	string	Čas, kdy se adresa URL sestavy stane neplatnou nebo vyprší ve standardu UTC, například 2020-12-08T05:55:59.4394737Z.

CostDetailsStatusType

Stav operace podrobností o nákladech

Name	Typ	Description
Completed	string	Operace je dokončena.
Failed	string	Operace se nezdařila.
NoDataFound	string	Operace je dokončená a nenašla se žádná data nákladů.

CostDetailsTimePeriod

Počáteční a koncové datum pro načítání dat pro podrobnou sestavu nákladů. Rozhraní API umožňuje načíst data pouze po dobu 1 měsíce nebo méně a ne starší než 13 měsíců.

Name	Typ	Description
end	string	Koncové datum pro načtení dat. example format 2020-03-15
start	string	Počáteční datum, ze které se mají načíst data. example format 2020-03-15

ErrorDetails

Podrobnosti o chybě.

Name	Typ	Description
code	string	Kód chyby
message	string	Chybová zpráva s informacemi o tom, proč operace selhala.

ErrorResponse

Chybová odpověď znamená, že služba nemůže zpracovat příchozí požadavek. Důvod je uvedený v chybové zprávě.

Některé chybové odpovědi:

429 TooManyRequests – Požadavek je omezený. Zkuste to znovu po uplynutí doby určené v hlavičce x-ms-ratelimit-microsoft.consumption-retry-after.
503 ServiceUnavailable – Služba je dočasně nedostupná. Po uplynutí časového limitu uvedeného v hlavičce Retry-After zkuste operaci zopakovat.

Name	Typ	Description
error	ErrorDetails	Podrobnosti o chybě.

GenerateCostDetailsReportRequestDefinition

Definice podrobné sestavy nákladů

Name	Typ	Description
billingPeriod	string	Tento parametr můžou používat jenom smlouva Enterprise zákazníci. Použijte formát YearMonth (například 202008). Tento parametr nelze použít společně s parametry invoiceId ani timePeriod. Pokud text požadavku neobsahuje parametr timePeriod, invoiceId nebo billingPeriod, rozhraní API vrátí náklady za aktuální měsíc.
invoiceId	string	Tento parametr můžou používat jenom Smlouva se zákazníkem Microsoftu zákazníci. Kromě toho se dá použít jenom v rozsahu fakturačního profilu nebo zákazníka. Tento parametr nelze použít společně s parametry billingPeriod ani timePeriod. Pokud text požadavku neobsahuje parametr timePeriod, invoiceId nebo billingPeriod, rozhraní API vrátí náklady za aktuální měsíc.
metric	CostDetailsMetricType	Typ podrobné sestavy. Ve výchozím nastavení je k dispozici hodnota ActualCost.
timePeriod	CostDetailsTimePeriod	Konkrétní rozsah dat podrobností o nákladech požadovaných pro sestavu Tento parametr nelze použít společně s parametry invoiceId ani billingPeriod. Pokud text požadavku neobsahuje parametr timePeriod, invoiceId nebo billingPeriod, rozhraní API vrátí náklady za aktuální měsíc. Rozhraní API umožňuje načíst data pouze po dobu 1 měsíce nebo méně a ne starší než 13 měsíců. Pokud se nezadá žádná hodnota timePeriod, billingPeriod nebo invoiceId, rozhraní API nastaví výchozí časové období otevřeného měsíce.

Sdílet prostřednictvím