Generate Cost Details Report - Get Operation Results

참조

Service:: Cost Management

API Version:: 2023-11-01

지정된 작업의 결과를 가져옵니다. 이 링크는 CostDetails 만들기 요청 응답 위치 헤더에 제공됩니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
operationId	path	True	string	대상 작업 ID입니다.
scope	path	True	string	구독, 청구 계정 또는 기타 청구 범위에 대한 ARM 리소스 ID입니다. 현재 리소스 그룹 및 관리 그룹은 지원되지 않습니다. 자세한 내용은 https://aka.ms/costmgmt/scopes를 참조하십시오.
api-version	query	True	string	이 작업에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	CostDetailsOperationResults	OK. 요청이 성공했습니다.
202 Accepted		수락됨 작업이 진행 중입니다.
Other Status Codes	ErrorResponse	작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

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

Scopes

Name	Description
user_impersonation	사용자 계정 가장

예제

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

정의

Name	Description
BlobInfo	이 작업에서 생성된 Blob 정보입니다.
CostDetailsDataFormat	보고서의 데이터 형식
CostDetailsMetricType	자세한 보고서의 형식입니다. 기본적으로 ActualCost가 제공됩니다.
CostDetailsOperationResults	비용 세부 정보 API에 대한 장기 실행 작업의 결과입니다.
CostDetailsStatusType	비용 세부 정보 작업의 상태
CostDetailsTimePeriod	비용 상세 보고서의 데이터를 끌어올리기 위한 시작 및 종료 날짜입니다. API는 1개월 이하 및 13개월 이하의 데이터만 끌어올 수 있도록 허용합니다.
ErrorDetails	오류의 세부 정보입니다.
ErrorResponse	오류 응답은 서비스가 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다. 일부 오류 응답: 429 TooManyRequests - 요청이 제한됩니다. "x-ms-ratelimit-microsoft.consumption-retry-after" 헤더에 지정된 시간을 기다린 후 다시 시도합니다. 503 ServiceUnavailable - 서비스를 일시적으로 사용할 수 없습니다. "Retry-After" 헤더에 지정된 시간 동안 기다린 후 다시 시도합니다.
GenerateCostDetailsReportRequestDefinition	비용 상세 보고서의 정의입니다.

BlobInfo

이 작업에서 생성된 Blob 정보입니다.

Name	형식	Description
blobLink	string	Blob에 연결하여 파일을 다운로드합니다.
byteCount	integer	Blob의 바이트입니다.

CostDetailsDataFormat

보고서의 데이터 형식

Name	형식	Description
Csv	string	Csv 데이터 형식입니다.

CostDetailsMetricType

자세한 보고서의 형식입니다. 기본적으로 ActualCost가 제공됩니다.

Name	형식	Description
ActualCost	string	실제 비용 데이터입니다.
AmortizedCost	string	분할 상환 비용 데이터.

CostDetailsOperationResults

비용 세부 정보 API에 대한 장기 실행 작업의 결과입니다.

Name	형식	Description
error	ErrorDetails	오류의 세부 정보입니다.
id	string	장기 실행 작업의 ID입니다.
manifest.blobCount	integer	총 Blob 수입니다.
manifest.blobs	BlobInfo[]	이 작업에서 생성된 Blob 정보 목록입니다.
manifest.byteCount	integer	모든 Blob의 총 바이트 수입니다.
manifest.compressData	boolean	압축된 형식의 데이터입니다.
manifest.dataFormat	CostDetailsDataFormat	보고서의 데이터 형식
manifest.manifestVersion	string	매니페스트 버전입니다.
manifest.requestContext.requestBody	GenerateCostDetailsReportRequestDefinition	비용 세부 정보 호출에 제공된 요청 페이로드 본문
manifest.requestContext.requestScope	string	요청의 요청 scope.
name	string	장기 실행 작업의 이름입니다.
status	CostDetailsStatusType	비용 세부 정보 작업의 상태
type	string	장기 실행 작업의 형식입니다.
validTill	string	보고서 URL이 유효하지 않거나 만료되는 시간(예: 2020-12-08T05:55:59.4394737Z).

CostDetailsStatusType

비용 세부 정보 작업의 상태

Name	형식	Description
Completed	string	작업이 완료되었습니다.
Failed	string	작업이 실패했습니다.
NoDataFound	string	작업이 완료되었으며 비용 데이터를 찾을 수 없습니다.

CostDetailsTimePeriod

비용 상세 보고서의 데이터를 끌어올리기 위한 시작 및 종료 날짜입니다. API는 1개월 이하 및 13개월 이하의 데이터만 끌어올 수 있도록 허용합니다.

Name	형식	Description
end	string	데이터를 끌어올 종료 날짜입니다. 예제 형식 2020-03-15
start	string	데이터를 끌어올 시작 날짜입니다. 예제 형식 2020-03-15

ErrorDetails

오류의 세부 정보입니다.

Name	형식	Description
code	string	오류 코드
message	string	작업이 실패한 이유를 나타내는 오류 메시지입니다.

ErrorResponse

오류 응답은 서비스가 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다.

일부 오류 응답:

429 TooManyRequests - 요청이 제한됩니다. "x-ms-ratelimit-microsoft.consumption-retry-after" 헤더에 지정된 시간을 기다린 후 다시 시도합니다.
503 ServiceUnavailable - 서비스를 일시적으로 사용할 수 없습니다. "Retry-After" 헤더에 지정된 시간 동안 기다린 후 다시 시도합니다.

Name	형식	Description
error	ErrorDetails	오류의 세부 정보입니다.

GenerateCostDetailsReportRequestDefinition

비용 상세 보고서의 정의입니다.

Name	형식	Description
billingPeriod	string	이 매개 변수는 기업계약 고객만 사용할 수 있습니다. YearMonth(예: 202008) 형식을 사용합니다. 이 매개 변수는 invoiceId 또는 timePeriod 매개 변수와 함께 사용할 수 없습니다. timePeriod, invoiceId 또는 billingPeriod 매개 변수가 요청 본문에 제공되지 않으면 API는 현재 월의 비용을 반환합니다.
invoiceId	string	이 매개 변수는 Microsoft 고객 계약 고객만 사용할 수 있습니다. 또한 청구 프로필 또는 고객 범위에서만 사용할 수 있습니다. 이 매개 변수는 billingPeriod 또는 timePeriod 매개 변수와 함께 사용할 수 없습니다. timePeriod, invoiceId 또는 billingPeriod 매개 변수가 요청 본문에 제공되지 않으면 API는 현재 월의 비용을 반환합니다.
metric	CostDetailsMetricType	자세한 보고서의 형식입니다. 기본적으로 ActualCost가 제공됩니다.
timePeriod	CostDetailsTimePeriod	보고서에 대해 요청된 비용 세부 정보의 특정 날짜 범위입니다. 이 매개 변수는 invoiceId 또는 billingPeriod 매개 변수와 함께 사용할 수 없습니다. timePeriod, invoiceId 또는 billingPeriod 매개 변수가 요청 본문에 제공되지 않으면 API는 현재 월의 비용을 반환합니다. API는 1개월 이하 및 13개월 이하의 데이터만 끌어올 수 있도록 허용합니다. timePeriod 또는 billingPeriod 또는 invoiceId가 제공되지 않으면 API 기본값은 오픈 월 기간으로 설정됩니다.

Share via