자습서: 내보내기 API를 사용하여 과거 비용 데이터 세트 시드

아티클
08/02/2024

대규모 조직에서는 1년 이상의 과거 비용을 분석해야 하는 경우가 많습니다. 일회성 조회를 대상으로 하거나 보고 대시보드를 설정하여 시간 경과에 따른 비용 추세를 시각화하려면 데이터 세트를 만들어야 할 수 있습니다. 두 경우 모두 쿼리할 수 있는 데이터 저장소에 데이터를 로드할 수 있도록 데이터를 안정적으로 가져오는 방법이 필요합니다. 과거 비용 데이터 세트가 시드된 후 보고가 최신 상태로 유지되도록 새로운 비용이 들어올 때 데이터 저장소를 업데이트할 수 있습니다. 과거 비용은 거의 변경되지 않으며 변경될 경우 알림을 받게 됩니다. 따라서 한 달에 한 번 이하로만 과거 비용을 새로 고치는 것이 좋습니다.

이 자습서에서는 다음을 하는 방법을 알아볼 수 있습니다.

서비스 주체에 대한 전달자 토큰 가져오기
요청 형식 지정
1개월 단위로 요청 실행

필수 조건

내보내기 API를 성공적으로 호출하려면 적절한 권한이 필요합니다. 자동화 시나리오에서는 서비스 주체를 사용하는 것이 좋습니다.

자세한 내용은 Cost Management API에 권한 할당을 참조하세요.
내보내기 API에 필요한 특정 권한에 대한 자세한 내용은 범위 이해 및 작업을 참조하세요.

또한 API를 직접 쿼리하는 방법도 필요합니다. 다음은 API를 쿼리하는 데 많이 사용되는 몇 가지 방법입니다.

서비스 주체에 대한 전달자 토큰 가져오기

서비스 주체를 사용하여 전달자 토큰을 가져오는 방법을 알아보려면 액세스 토큰 획득을 참조하세요.

요청 형식 지정

다음 예제 요청을 참조하여 일회용 데이터 내보내기를 만듭니다. 다음 예제 요청에서는 지정된 Azure 스토리지 계정에 1개월 실제 비용 데이터 세트를 만듭니다. 보고서당 한 달 이내의 데이터를 요청하는 것이 좋습니다. 매월 대용량 데이터 세트가 있는 경우 일회성 내보내기에 대해 partitionData = true를 설정하여 여러 파일로 분할하는 것이 좋습니다. 자세한 내용은 대규모 데이터 세트의 파일 분할을 참조하세요.

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{enrollmentId}/providers/Microsoft.CostManagement/exports/{ExportName}?api-version=2021-10-01

요청 헤더

Authorization: <YOUR BEARER TOKEN>
Accept: /*/
Content-Type: application/json

요청 본문

{
  "properties": {
    "definition": {
      "dataset": {
        "granularity": "Daily",
        "grouping": []
      },
      "timePeriod": {
        "from": "2021-09-01T00:00:00.000Z",
        "to": "2021-09-30T00:00:00.000Z"
      },
      "timeframe": "Custom",
      "type": "ActualCost"
    },
    "deliveryInfo": {
      "destination": {
        "container": "{containerName}",
        "rootFolderPath": "{folderName}",
        "resourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{storageAccountName}"
      }
    },
    "format": "Csv",
    "partitionData": false
  }
}

1개월 단위로 내보내기 만들기

한 달 단위로 일회성 데이터 내보내기를 만드는 것이 좋습니다. 1년 기록 데이터 세트를 시드하려면 매월 한 번씩 12번의 내보내기 API 요청을 실행해야 합니다. 기록 데이터 세트를 시드한 후 예약된 내보내기를 만들어 시간이 지나 요금이 발생함에 따라 Azure Storage에 비용 데이터를 계속 채울 수 있습니다.

각 내보내기 실행

매월 내보내기를 만들었으므로 이제 실행 API를 호출하여 각각을 수동으로 실행해야 합니다. 다음은 API에 대한 요청 예제입니다.

POST https://management.azure.com/{scope}/providers/Microsoft.CostManagement/exports/{exportName}/run?api-version=2021-10-01

다음 단계

이 자습서에서는 다음 작업 방법을 알아보았습니다.

서비스 주체에 대한 전달자 토큰 가져오기
요청 형식 지정
1개월 단위로 요청 실행

비용 세부 정보에 대한 자세한 내용은 비용 세부 정보 데이터 수집을 참조하세요.

비용 세부 정보 데이터 세트에서 사용할 수 있는 데이터에 대한 자세한 내용은 비용 세부 정보 데이터 필드 이해를 참조하세요.

다음을 통해 공유