다음을 통해 공유


Generate Cost Details Report - Create Operation

이 API는 이전에 릴리스된 모든 사용량 세부 정보 API를 대체합니다. 특정 범위에서 제공된 날짜 범위, 청구 기간(기업 고객만 해당) 또는 청구서 ID에 대한 비용 세부 정보 보고서를 비동기적으로 생성하도록 요청합니다. 보고서를 요청하는 초기 호출은 '위치' 및 'Retry-After' 헤더가 있는 202를 반환합니다. '위치' 헤더는 폴링할 엔드포인트를 제공하여 보고서 생성 결과를 가져옵니다. 'Retry-After'는 생성된 보고서를 폴링하기 전에 대기하는 기간을 제공합니다. 보고서 작업을 폴링하는 호출은 작업이 아직 진행 중인 경우 '위치' 헤더와 함께 202 응답을 제공합니다. 보고서 생성 작업이 완료되면 폴링 엔드포인트는 다운로드할 수 있는 보고서 Blob에 대한 세부 정보와 함께 200개 응답을 제공합니다. 다운로드할 수 있는 파일에 대한 세부 정보는 폴링 응답 본문에서 확인할 수 있습니다. 파일에 있는 비용 세부 정보(이전의 사용량 세부 정보) 필드를 이해하려면 https://learn.microsoft.com/en-us/azure/cost-management-billing/automate/understand-usage-details-fields 참조하세요.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
scope
path True

string

구독, 청구 계정 또는 기타 청구 범위에 대한 ARM 리소스 ID입니다. 현재 리소스 그룹 및 관리 그룹은 지원되지 않습니다. 자세한 내용은 https://aka.ms/costmgmt/scopes참조하세요.

api-version
query True

string

이 작업에 사용할 API 버전입니다.

요청 본문

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 기본값은 오픈 월 기간입니다.

응답

Name 형식 Description
200 OK

CostDetailsOperationResults

요청 처리가 완료되었습니다.

202 Accepted

허용. 요청이 처리됩니다. 위치 헤더를 사용하여 상태를 확인합니다.

헤더

  • Location: string
  • Retry-After: integer
204 No Content

콘텐츠가 없습니다. 요청이 성공했지만 결과를 반환하지 않았습니다.

Other Status Codes

GenerateCostDetailsReportErrorResponse

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

GenerateCostDetailsReportByBillingAccountEnterpriseAgreementCustomerAndBillingPeriod
GenerateCostDetailsReportByBillingProfileAndInvoiceId
GenerateCostDetailsReportByBillingProfileAndInvoiceIdAndCustomerId
GenerateCostDetailsReportByCustomerAndTimePeriod
GenerateCostDetailsReportByDepartmentsAndTimePeriod
GenerateCostDetailsReportByEnrollmentAccountsAndTimePeriod
GenerateCostDetailsReportBySubscriptionAndTimePeriod

GenerateCostDetailsReportByBillingAccountEnterpriseAgreementCustomerAndBillingPeriod

샘플 요청

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345/providers/Microsoft.CostManagement/generateCostDetailsReport?api-version=2024-08-01

{
  "metric": "ActualCost",
  "billingPeriod": "202205"
}

샘플 응답

{
  "id": "providers/Microsoft.Billing/billingAccounts/12345/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": "providers/Microsoft.Billing/billingAccounts/12345",
      "requestBody": {
        "metric": "ActualCost",
        "billingPeriod": "202205"
      }
    },
    "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"
}
Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000?api-version=2024-08-01
Retry-After: 60

GenerateCostDetailsReportByBillingProfileAndInvoiceId

샘플 요청

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/providers/Microsoft.CostManagement/generateCostDetailsReport?api-version=2024-08-01

{
  "metric": "ActualCost",
  "invoiceId": "M1234567"
}

샘플 응답

{
  "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/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": "providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579",
      "requestBody": {
        "metric": "ActualCost",
        "billingPeriod": "202205"
      }
    },
    "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"
}
Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000?api-version=2024-08-01
Retry-After: 60

GenerateCostDetailsReportByBillingProfileAndInvoiceIdAndCustomerId

샘플 요청

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/customers/13579/providers/Microsoft.CostManagement/generateCostDetailsReport?api-version=2024-08-01

{
  "metric": "ActualCost",
  "invoiceId": "M1234567"
}

샘플 응답

{
  "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/customers/13579/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": "providers/Microsoft.Billing/billingAccounts/12345:6789/customers/13579",
      "requestBody": {
        "metric": "ActualCost",
        "billingPeriod": "202205"
      }
    },
    "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"
}
Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/customers/13579/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000?api-version=2024-08-01
Retry-After: 60

GenerateCostDetailsReportByCustomerAndTimePeriod

샘플 요청

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/customers/13579/providers/Microsoft.CostManagement/generateCostDetailsReport?api-version=2024-08-01

{
  "metric": "ActualCost",
  "timePeriod": {
    "start": "2020-03-01",
    "end": "2020-03-15"
  }
}

샘플 응답

{
  "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/customers/13579/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": "providers/Microsoft.Billing/billingAccounts/12345:6789/customers/13579",
      "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"
}
Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/customers/13579/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000?api-version=2024-08-01
Retry-After: 60

GenerateCostDetailsReportByDepartmentsAndTimePeriod

샘플 요청

POST https://management.azure.com/providers/Microsoft.Billing/departments/12345/providers/Microsoft.CostManagement/generateCostDetailsReport?api-version=2024-08-01

{
  "metric": "ActualCost",
  "timePeriod": {
    "start": "2020-03-01",
    "end": "2020-03-15"
  }
}

샘플 응답

{
  "id": "providers/Microsoft.Billing/departments/12345/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": "providers/Microsoft.Billing/departments/12345",
      "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"
}
Location: https://management.azure.com/providers/Microsoft.Billing/departments/12345/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000?api-version=2024-08-01
Retry-After: 60

GenerateCostDetailsReportByEnrollmentAccountsAndTimePeriod

샘플 요청

POST https://management.azure.com/providers/Microsoft.Billing/enrollmentAccounts/1234/providers/Microsoft.CostManagement/generateCostDetailsReport?api-version=2024-08-01

{
  "metric": "ActualCost",
  "timePeriod": {
    "start": "2020-03-01",
    "end": "2020-03-15"
  }
}

샘플 응답

{
  "id": "providers/Microsoft.Billing/enrollmentAccounts/1234/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": "providers/Microsoft.Billing/enrollmentAccounts/1234",
      "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"
}
Location: https://management.azure.com/providers/Microsoft.Billing/enrollmentAccounts/1234/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000?api-version=2024-08-01
Retry-After: 60

GenerateCostDetailsReportBySubscriptionAndTimePeriod

샘플 요청

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

{
  "metric": "ActualCost",
  "timePeriod": {
    "start": "2020-03-01",
    "end": "2020-03-15"
  }
}

샘플 응답

{
  "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"
}
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

정의

Name Description
BlobInfo

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

CostDetailsDataFormat

보고서의 데이터 형식

CostDetailsMetricType

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

CostDetailsOperationResults

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

CostDetailsStatusType

비용 세부 정보 작업의 상태

CostDetailsTimePeriod

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

ErrorDetails

오류의 세부 정보입니다.

GenerateCostDetailsReportErrorResponse

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

일부 오류 응답:

  • 400 잘못된 요청 - 잘못된 요청 페이로드입니다. 제공된 요청 페이로드가 json 형식이 아니거나 요청 페이로드에 잘못된 멤버가 허용되지 않았습니다.

  • 400 잘못된 요청 - 잘못된 요청 페이로드: timePeriod 또는 invoiceId 또는 billingPeriod만 가질 수 있습니다. API는 timePeriod 또는 invoiceId 또는 billingPeriod에 대해서만 데이터를 끌어올 수 있도록 허용합니다. 고객은 이러한 매개 변수 중 하나만 제공해야 합니다.

  • 400 잘못된 요청 - 시작 날짜는 다음이어야 합니다. API는 지금부터 13개월 이하의 데이터만 끌어올 수 있도록 허용합니다.

  • 400 잘못된 요청 - 허용되는 최대 날짜 범위는 1개월입니다. API는 1개월 이하의 데이터만 끌어올 수 있도록 허용합니다.

  • 429 TooManyRequests - 요청이 제한됩니다. "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

요청의 요청 범위입니다.

name

string

장기 실행 작업의 이름입니다.

status

CostDetailsStatusType

비용 세부 정보 작업의 상태

type

string

장기 실행 작업의 형식입니다.

validTill

string

보고서 URL이 UTC에서 유효하지 않거나 만료되는 시간(예: 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

작업이 실패한 이유를 나타내는 오류 메시지입니다.

GenerateCostDetailsReportErrorResponse

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

일부 오류 응답:

  • 400 잘못된 요청 - 잘못된 요청 페이로드입니다. 제공된 요청 페이로드가 json 형식이 아니거나 요청 페이로드에 잘못된 멤버가 허용되지 않았습니다.

  • 400 잘못된 요청 - 잘못된 요청 페이로드: timePeriod 또는 invoiceId 또는 billingPeriod만 가질 수 있습니다. API는 timePeriod 또는 invoiceId 또는 billingPeriod에 대해서만 데이터를 끌어올 수 있도록 허용합니다. 고객은 이러한 매개 변수 중 하나만 제공해야 합니다.

  • 400 잘못된 요청 - 시작 날짜는 다음이어야 합니다. API는 지금부터 13개월 이하의 데이터만 끌어올 수 있도록 허용합니다.

  • 400 잘못된 요청 - 허용되는 최대 날짜 범위는 1개월입니다. API는 1개월 이하의 데이터만 끌어올 수 있도록 허용합니다.

  • 429 TooManyRequests - 요청이 제한됩니다. "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 기본값은 오픈 월 기간입니다.