청구 및 청구되지 않은 일일 등급 사용량 조정 API v2(GA)

적용 대상: 파트너 센터(Azure Government 또는 Azure 중국 21Vianet에서 사용할 수 없음)

비동기 API는 Azure Blob을 통해 청구 및 조정 데이터에 액세스하는 더 빠르고 관리하기 쉬운 방법을 제공합니다. 이러한 API를 사용하면 몇 시간 동안 연결을 열어 두거나 2,000개의 품목 일괄 처리를 반복할 필요가 없습니다.

발레 키 및 비동기 요청-회신 패턴을 사용하여 새로운 상거래 일일 등급 사용량 조정 API를 최적화했습니다. 이러한 API를 사용하는 경우 모든 특성 또는 일일 등급 사용량 조정 데이터의 하위 집합에 액세스하는 데 사용할 수 있는 토큰을 받게 됩니다.

MS Graph 퍼블릭/글로벌 클라우드에만 이러한 API를 사용할 수 있습니다. Azure Government 또는 Azure 중국 21Vianet에는 아직 사용할 수 없습니다.

API 개요

새 상거래 일별 등급 사용량 품목을 비동기적으로 검색하려면 두 개의 API 엔드포인트를 사용합니다. 프로세스는 다음과 같습니다.

사용량 줄 항목 엔드포인트

이 API를 사용하여 청구되거나 청구되지 않은 일일 등급 사용 현황 품목을 검색합니다. 위치 헤더에 202 HTTP 상태 및 URL이 표시됩니다. 매니페스트 URL을 사용하여 성공 상태를 받을 때까지 정기적으로 이 URL을 폴링합니다.

작업 상태 엔드포인트

성공 상태를 얻으려면 정기적으로 이 API를 계속 호출합니다. 데이터가 준비되지 않은 경우 API 응답에는 다시 시도하기 전에 대기 시간을 알려주는 Retry-After 헤더가 포함됩니다. 작업이 완료되면 사용량 현황 데이터를 다운로드할 수 있는 스토리지 폴더가 있는 매니페스트 리소스를 가져옵니다. 응답은 최적화된 처리량 및 I/O 병렬 처리를 위해 파일을 더 작은 조각으로 분할합니다.

시퀀스 다이어그램

다음은 조정 데이터를 다운로드하는 단계를 보여 주는 시퀀스 다이어그램입니다.

사용자 작업 순서

새 상거래 일별 등급 사용량 조정 품목을 검색하려면 다음 단계를 수행합니다.

1단계: 요청 제출

API 엔드포인트에 POST 요청을 제출합니다.

청구되지 않은 일일 등급 사용 현황 품목 가져오기

현재 또는 지난 달 또는 청구 기간에 대한 새로운 상거래 미청구 일일 등급 사용 현황 품목을 가져옵니다.

API 요청

POST https://graph.microsoft.com/v1.0/reports/partners/billing/usage/unbilled/export

Accept: application/json

Content-Type: application/json

{

"currencyCode": "USD",

"billingPeriod": "current",

"attributeSet": "basic"

}

요청 본문

요청 헤더

API에 대한 헤더를 요청하려면 안정성 및 지원을 참조하세요.

API 응답

HTTP/1.1 202 Accepted  
Location: https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14

API를 사용하는 경우 일반적으로 HTTP 202 상태를 반환합니다. 요청에 따라 다른 가능한 상태를 보려면 표준 API 응답 상태를 참조 하세요.

청구된 일일 정격 사용 현황 품목 가져오기

마감된 청구 기간 동안 청구서에 대한 새 상거래 청구 일별 등급 사용량 품목을 가져옵니다.

API 요청

POST https://graph.microsoft.com/v1.0/reports/partners/billing/usage/billed/export

{  
"invoiceId": "G00012345",  
"attributeSet": "full"  
}

쿼리 매개 변수

해당 없음

요청 본문

요청 헤더

API에 대한 요청 헤더입니다. 자세한 내용은 안정성 및 지원을 참조하세요.

API 응답

HTTP/1.1 202 수락됨
위치: https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14

API를 사용하는 경우 일반적으로 HTTP 202 상태를 반환합니다. 요청에 따라 가능한 다른 상태는 상태를 참조 하세요.

2단계: 요청 상태 확인

요청 상태를 확인하려면 "성공" 또는 "실패" 상태의 HTTP 200 응답을 기다립니다. 요청이 성공하면 매니페스트 URL이 "resourceLocation" 특성에 제공됩니다.

작업 상태 가져오기

요청의 상태를 검색합니다.

API 요청

GET https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14

요청 매개 변수

요청 헤더

API에 대한 헤더를 요청하려면 안정성 및 지원을 참조하세요.

요청 본문

해당 없음.

응답 상태

표준 HTTP 상태 외에도 API는 다음 HTTP 상태를 반환할 수 있습니다.

응답 페이로드

API 응답 페이로드에는 다음 특성이 포함됩니다.

리소스 위치 개체

API 요청

GET <https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14>

API 응답

응답은 데이터를 처리할 때 다시 시도하기 전에 10초 동안 대기하는 것이 좋습니다.

HTTP/1.1 200 OK  
Retry-After: 10  
{  
"id": "9ab9cb54-d07f-4f52-9ea6-a09d7de52c14",  
"createdDateTime": "2022-06-1T10-01-03.4Z",  
"lastActionDateTime": "2022-06-1T10-01-05Z",  
"status": "running"  
}

API 요청

(이전 요청 후 10초 후...)

GET <https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14>

API 응답

API는 "succeeded" 상태와 "resourceLocation"에 대한 URI를 반환합니다.

HTTP/1.1 200 OK  
Content-Type: application/json  
{

    "@odata.context": "https://graph.microsoft.com/v1.0/\$metadata#reports/partners/billing/operations/\$entity",

    "@odata.type": "#microsoft.graph.partners.billing.exportSuccessOperation",

    "id": "f2170b13-6a8e-47d6-b481-6988490dc0cb",

    "createdDateTime": "2023-12-05T21:17:29Z",

    "lastActionDateTime": "2023-12-05T21:18:00.8897902Z",

    "status": "succeeded",

    "resourceLocation": {

        "id": "44e8500b-ab92-490e-8ac3-90500a1d3427",

        "createdDateTime": "2023-11-06T19:58:47.513Z",

        "schemaVersion": "2",

        "dataFormat": "compressedJSON",

        "partitionType": "default",

        "eTag": "RwDrn7fbiTXy6UULE",

        "partnerTenantId": "0e195b37-4574-4539-bc42-0e539b9684c0",

        "rootDirectory": "https://adlsreconbuprodeastus201.blob.core.windows.net/path_id",

        "sasToken": "{token}",

        "blobCount": 1,

        "blobs": \[

            {

                "name": "part-00123-5a93fa5d-749f-48bc-a372-9b021d93c3fa.c000.json.gz",

                "partitionValue": "default"

            }

        \]

    }

}

3단계: Azure Blob Storage에서 일일 등급 사용량 조정 품목 다운로드

"sasToken" 및 "rootDirectory"에서 SAS(공유 액세스 서명) 토큰 및 Blob Storage 위치를 가져오면 매니페스트 페이로드 API 응답이 속성됩니다. Azure Storage SDK/도구를 사용하여 Blob 파일을 다운로드하고 압축을 풉니다. JSONLines 형식입니다.

표준 API 응답 상태

API 응답에서 다음 HTTP 상태를 받을 수 있습니다.

베타 및 GA 버전 비교

베타 버전과 일반 공급(GA) 버전 간의 차이점을 이해하려면 비교 표를 참조하세요. 베타 버전을 사용하는 경우 GA 버전으로 전환하는 것은 간단합니다.

일일 등급 사용량 조정 품목 특성

"전체" 또는 "기본" 특성 집합에 대한 일일 정격 사용량 조정 API에서 반환된 특성을 비교하려면 다음 정보를 참조하세요. 이러한 특성에 대한 자세한 내용은 이 설명서를 참조하세요.

샘플 코드

자세한 내용은 파트너 센터 API 샘플: 청구 조정 데이터 가져오기를 참조하세요.