Azure Enterprise Reporting에서 Microsoft Cost Management API로 마이그레이션 개요

  • 아티클

이 문서에서는 Azure Enterprise Reporting API를 사용하여 사용자 지정 솔루션을 빌드한 개발자에게 중요한 변경 사항에 대해 설명합니다. 최신 Microsoft Cost Management API는 이제 향상된 기능과 서비스 주체에 대한 지원을 제공하여 프로젝트에 보다 강력한 선택을 제공합니다.

주요 정보:

  • 마이그레이션 권장 - 사용자 지정 솔루션을 Microsoft Cost Management API로 마이그레이션하는 것이 좋습니다. 적극적으로 개발 중이며 향상된 기능을 제공합니다.
  • 사용 중지일 - 모든 Azure Enterprise Reporting API가 사용 중지되었습니다.

이 문서는 다음을 제공합니다.

  • Azure Enterprise Reporting API와 Cost Management API 간의 차이점에 대한 개요입니다.
  • Cost Management API로 마이그레이션할 때 예상되는 사항에 대한 지침입니다.
  • Cost Management API에서 사용할 수 있는 새로운 기능에 대한 인사이트입니다.

활용 방안:

  • 원활한 전환을 위해 사용 중지 날짜 이전에 Cost Management API로 마이그레이션 계획을 시작하는 것이 좋습니다.

API 차이점

다음은 이전 버전의 Azure Enterprise Reporting API와 최신 Cost Management API의 차이점을 설명하는 정보입니다.

사용할 용어 Azure Enterprise Reporting API Microsoft Cost Management API
인증 Azure Portal에서 프로비전된 API 키 사용자 토큰 또는 서비스 주체를 사용한 Microsoft Entra 인증. 서비스 주체가 API 키를 대신합니다.
범위 및 사용 권한 모든 요청은 등록 범위에 있습니다. API 키 권한 할당에 따라 전체 등록, 부서 또는 특정 계정에 대한 데이터가 반환됩니다. 사용자 인증 없음 사용자 또는 서비스 주체에게 등록, 부서 또는 계정 범위에 대한 액세스 권한이 할당됩니다.
URI 엔드포인트 https://consumption.azure.com https://management.azure.com
개발 상태 유지 관리 모드. 곧 사용 중단됩니다. 현재 개발 중
사용 가능한 API 현재 사용 가능한 기능으로 제한됨 동일한 API를 사용하여 각 EA API를 대체할 수 있습니다. 다음을 비롯한 추가 Cost Management API도 사용할 수 있습니다.
- 예산
- 경고
- 내보내기

마이그레이션 검사 목록

  • Azure Resource Manager REST API를 숙지합니다.
  • 사용하는 Enterprise Reporting API를 확인하고 Azure Enterprise Reporting에서 Microsoft Cost Management API로 마이그레이션에서 이동할 Cost Management API를 확인합니다.
  • Cost Management API에 대한 서비스 권한 부여 및 인증 구성 자세한 내용은 ACM API에 권한 할당을 참조하세요.
  • API를 테스트한 다음, Enterprise Reporting API 호출을 Cost Management API 호출로 바꾸도록 프로그래밍 코드를 업데이트합니다.
  • 새 오류 코드를 사용하도록 오류 처리를 업데이트합니다. 그 외에도 다음과 같은 사항을 고려해야 합니다.
    • Cost Management API의 제한 시간은 60초입니다.
    • Cost Management API에는 속도 제한이 적용됩니다. 이 속도 제한을 초과하면 429 throttling error가 발생합니다. 짧은 시간 내에 API 호출이 너무 많이 발생하지 않도록 솔루션을 빌드하세요.
  • 나중에 사용할 수 있도록 Azure Resource Manager를 통해 제공되는 다른 Cost Management API를 검토하고 평가합니다. 자세한 내용은 Azure Enterprise Reporting에서 Microsoft Cost Management API로 마이그레이션을 참조하세요.

새 Cost Management API에 대한 Enterprise Reporting API 매핑

다음 정보를 사용하여 현재 사용하는 Enterprise Reporting API 및 대신 사용할 대체 A Cost Management API를 확인하세요.

시나리오 Enterprise Reporting API Cost Management API
EA 사용량 세부 정보 API에서 마이그레이션 /usagedetails/download
/usagedetails/submit
/usagedetails
/usagedetailsbycustomdate		 모든 되풀이 데이터 수집 워크로드에 Microsoft.CostManagement/Exports를 사용합니다.
작은 주문형 데이터 세트에 대한 비용 세부 정보 보고서를 사용합니다.
EA 잔액 요약 API에서 마이그레이션 /balancesummary Microsoft.Consumption/balances
EA 가격표 API에서 마이그레이션 /pricesheet 협상된 가격의 경우 Microsoft.Consumption/pricesheets/default를 사용합니다.
소매 가격의 경우 소매 가격 API를 사용합니다.
EA 예약 인스턴스 사용량 세부 정보 API에서 마이그레이션 /reservationdetails Microsoft.CostManagement/generateReservationDetailsReport
EA 예약 인스턴스 사용량 요약 API에서 마이그레이션 /reservationsummaries Microsoft.Consumption/reservationSummaries
EA 예약 인스턴스 권장 사항 API에서 마이그레이션 /SharedReservationRecommendations
/SingleReservationRecommendations		 Microsoft.Consumption/reservationRecommendations
EA 예약 인스턴스 요금 API에서 마이그레이션 /reservationcharges Microsoft.Consumption/reservationTransactions

추가 Cost Management API 사용

기존 보고 시나리오의 Cost Management API로 마이그레이션한 후에는 다른 여러 API를 사용할 수 있습니다. API는 Azure Resource Manager를 통해서도 사용할 수 있으며, 서비스 주체 기반 인증을 사용하여 자동화할 수 있습니다. 다음은 사용할 수 있는 새 기능에 대한 간략한 요약 정보입니다.

  • 예산 - 사전에 비용을 모니터링하고, 관련자에게 경고하고, 임계값 위반에 대응하는 조치를 자동화하도록 임계값을 설정하는 데 사용합니다.
  • 경고 - 예산 경고, 청구서 경고, 신용 경고 및 할당량 경고를 비롯한(이에 국한되지 않음) 경고 정보를 보는 데 사용합니다.
  • 내보내기 - 사용자가 선택한 Azure Storage 계정으로 요금 데이터 내보내기 되풀이를 예약하는 데 사용합니다. 데이터를 분석하여 자체 내부 시스템에서 사용하고자 하는 대규모 Azure 시스템을 보유한 고객에게 권장하는 솔루션입니다.

관련 콘텐츠