EA 사용량 세부 정보 API에서 마이그레이션
이전에 consumption.azure.com 엔드포인트를 기반으로 기업 보고 API를 사용하여 사용량 세부 정보 및 시장 비용을 확보했던 EA 고객은 새롭고 개선된 솔루션으로 마이그레이션해야 합니다. 아래에는 이전 API와 새로운 솔루션 간의 계약 차이와 함께 지침이 요약되어 있습니다.
데이터 세트는 사용량 세부 정보 대신 비용 세부 정보로 표시됩니다.
참고 항목
모든 Azure Enterprise Reporting API는 사용 중지됩니다. 가능한 한 빨리 Microsoft Cost Management API로 마이그레이션해야 합니다.
새로운 솔루션 일반 공급
다음 표에서는 최적 솔루션을 선택할 때 고려할 사항에 대한 요약 정보와 함께 마이그레이션 대상 요약 정보를 보여 줍니다.
| 솔루션 | 설명 | 고려 사항 | 온보딩 정보 |
|---|---|---|---|
| 내보내기 | 일정에 따라 스토리지에 대한 반복 데이터 덤프 | - 워크로드에 대한 가장 확장 가능한 솔루션입니다. - 더 큰 데이터 세트에 파일 분할을 사용하도록 구성할 수 있습니다. - 쿼리 가능한 자체 데이터 저장소와 통합할 수 있는 비용 데이터 세트를 설정하고 늘리는 데 적합합니다. - 데이터를 저장할 수 있는 스토리지 계정에 대한 액세스 권한이 필요합니다. |
- Azure Portal에서 구성 API를 사용하여 내보내기 만들기 자동화 - 내보내기 API 참조 |
| 비용 세부 정보 API | 요청 시 다운로드 | - 저비용의 데이터 세트에 유용합니다. - 보안 또는 관리 효율성 문제로 인해 Azure Storage로 내보내기를 수행할 수 없는 시나리오에 유용합니다. |
- 요청 시 적은 비용 데이터 세트 가져오기 - 비용 세부 정보 API |
지속적인 데이터 수집이 필요하고 또는 대규모 월별 비용 세부 정보 데이터 세트가 있는 경우 일반적으로 내보내기를 사용하는 것이 좋습니다. 자세한 내용은 비용 세부 정보 데이터 수집을 참조하세요. 워크로드를 결정하는 데 도움이 되는 추가 정보가 필요한 경우 비용 세부 정보 솔루션 선택을 참조하세요.
SPN에 API 호출 권한 할당
내보내기 또는 비용 세부 정보 API를 프로그래밍 방식으로 호출하려는 경우 올바른 권한으로 서비스 주체를 구성해야 합니다. 자세한 내용은 ACM API에 권한 할당을 참조하세요.
Microsoft 소비 사용량 세부 정보 API 방지
소비 사용량 세부 정보 API는 현재 EA 고객을 지원하는 또 다른 엔드포인트입니다. 이 API로 마이그레이션하지 마세요. 이 문서의 앞부분에서 설명한 대로 내보내기 또는 비용 세부 정보 API로 마이그레이션하세요. 소비 사용량 세부 정보 API는 향후 더 이상 사용되지 않으며 다음 엔드포인트 뒤에 있습니다.
GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/usageDetails?api-version=2021-10-01
이 API는 동기 엔드포인트이며 지출 및 월별 비용 데이터 세트 크기 증가에 따라 확장할 수 없습니다. 현재 소비 사용량 세부 정보 API를 사용 중이면 가능한 한 빨리 내보내기 또는 비용 세부 정보 API로 마이그레이션하는 것이 좋습니다. 공식적인 사용 중단 발표는 향후 발표될 예정입니다. 소비 사용량 세부 정보에서 마이그레이션하는 방법은 소비 사용량 세부 정보 API에서 마이그레이션을 참조하세요.
마이그레이션 이점
새 솔루션은 EA 보고 사용량 세부 정보 API보다 많은 이점을 제공합니다. 다음은 요약입니다.
- 보안 및 안정성 - 새 솔루션에서는 데이터 액세스를 위해 서비스 주체 및/또는 사용자 토큰이 필요합니다. 이러한 토큰은 EA 보고 API 인증에 사용되는 API 키보다 더 안전합니다. 이러한 레거시 API의 키는 6개월 동안 유효하고 유출될 경우 중요한 재무 데이터가 노출될 수 있습니다. 또한 키가 갱신되지 않고 6개월 만료 시점 이전에 워크로드에 통합되지 않으면 데이터 액세스가 취소됩니다. 이로 인해 고객 워크로드가 중단됩니다.
- 확장성 - EA 보고 API는 Azure 사용량 증가에 따라 적절하게 확장되도록 빌드되지 않았습니다. 클라우드에 더 많은 리소스를 배포하면 사용량 세부 정보 데이터 세트가 너무 커질 수 있습니다. 새로운 솔루션은 비동기식이며 모든 크기의 데이터 세트에 대해 성공적인 다운로드를 보장하기 위해 광범위한 인프라 개선 기능이 갖춰져 있습니다.
- 모든 사용량 세부 정보에 대한 단일 데이터 세트 - Azure 및 Azure Marketplace 사용량 세부 정보는 새 솔루션에서 하나의 데이터 세트로 병합되었습니다. 단일 데이터 세트는 모든 요금을 확인하기 위해 호출해야 하는 API 수를 줄여 줍니다.
- 구매 상각 - 예약을 구입한 고객은 새 솔루션을 사용하여 비용이 상각된 보기를 볼 수 있습니다.
- 스키마 일관성 - 사용 가능한 각 솔루션에서 일치하는 필드가 포함된 파일이 제공됩니다. 시나리오에 따라 각 솔루션으로 쉽게 이동할 수 있습니다.
- 비용 할당 통합 - 기업계약 및 Microsoft 고객 계약 고객은 새로운 솔루션을 사용하여 구성한 비용 할당 규칙과 관련된 요금을 볼 수 있습니다. 비용 할당에 대한 자세한 내용은 비용 할당을 참조하세요.
- 지속적인 기능 개선 - 새로운 솔루션은 계속해서 적극적으로 개발되고 있습니다. 솔루션은 출시될 때 모든 새로운 기능을 받습니다.
마이그레이션이 필요한 기업 사용량 API
다음 표에는 현재 비용 세부 정보 데이터를 수집하는 데 사용할 수 있는 다양한 API가 요약되어 있습니다. 다음 API 중 하나를 사용하는 경우 이전에 설명한 새 솔루션 중 하나로 마이그레이션해야 합니다. 모든 API는 https://consumption.azure.com 엔드포인트 뒤에 있습니다.
| 엔드포인트 | API 주석 |
|---|---|
/v3/enrollments/{enrollmentNumber}/usagedetails/download?billingPeriod={billingPeriod} |
- API 메서드: GET - 동기(비폴링) - 데이터 형식: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails/download?startTime=2017-01-01&endTime=2017-01-10 |
- API 메서드: GET - 동기(비폴링) - 데이터 형식: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails |
- API 메서드: GET - 동기(비폴링) - 데이터 형식: JSON |
/v3/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/usagedetails |
- API 메서드: GET - 동기(비폴링) - 데이터 형식: JSON |
/v3/enrollments/{enrollmentNumber}/usagedetailsbycustomdate?startTime=2017-01-01&endTime=2017-01-10 |
- API 메서드: GET - 동기(비폴링) - 데이터 형식: JSON |
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?billingPeriod={billingPeriod} |
- API 메서드: POST - 비동기(폴링 기반) - 데이터 형식: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?startTime=2017-04-01&endTime=2017-04-10 |
- API 메서드: POST - 비동기(폴링 기반) - 데이터 형식: CSV |
데이터 필드 매핑
다음 표에서는 현재 사용 중인 솔루션에서 제공되는 이전 필드와 새 솔루션에서 사용할 필드를 요약해서 보여 줍니다.
| 이전 필드 | 새 필드 | 설명 |
|---|---|---|
| accountId | ||
| accountName | AccountName | |
| accountOwnerEmail | AccountOwnerId | |
| additionalInfo | AdditionalInfo | |
| chargesBilledSeparately | isAzureCreditEligible | 속성은 반대입니다. isAzureCreditEnabled이(가) true이면 ChargesBilledSeparately은(는) false입니다. |
| consumedQuantity | 수량 | |
| consumedService | ConsumedService | |
| consumedServiceId | ConsumedService | consumedServiceId는 숫자 값만 제공합니다.ConsumedService는 서비스 이름을 제공합니다. |
| 비용 | CostInBillingCurrency | |
| costCenter | CostCenter | |
| date | 날짜 | 이전 필드의 형식은 yyyy-mm-dd이고 새 필드는 mm/dd/yyyy 형식입니다. |
| departmentId | InvoiceSectionId | |
| departmentName | InvoiceSectionName | |
| extendedCost | CostInBillingCurrency | |
| instanceId | ResourceId | |
| isRecurringCharge | 해당되는 경우 앞으로 Frequency 및 Term fields을(를) 사용합니다. |
|
| location | ResourceLocationNormalized | |
| meterCategory | MeterCategory | |
| meterId | MeterId | |
| meterName | MeterName | |
| meterRegion | MeterRegion | |
| meterSubCategory | MeterSubCategory | |
| offerId | OfferId | |
| orderNumber | 사용할 수 없음. | |
| partNumber | PartNumber | |
| planName | PlanName | |
| product | ProductName | |
| publisherName | PublisherName | |
| resourceGroup | ResourceGroup | |
| resourceGuid | MeterId | 값은 다양합니다. resourceGuid는 GUID 값입니다. meterId는 long 숫자입니다. |
| resourceLocation | ResourceLocation | |
| resourceLocationId | 사용할 수 없음. | |
| resourceRate | EffectivePrice | |
| serviceInfo1 | ServiceInfo1 | |
| serviceInfo2 | ServiceInfo2 | |
| serviceName | MeterCategory | |
| serviceTier | MeterSubCategory | |
| storeServiceIdentifier | 사용할 수 없음. | |
| subscriptionGuid | SubscriptionId | |
| subscriptionId | SubscriptionId | |
| subscriptionName | SubscriptionName | |
| tags | 태그 | 새 필드에는 키-값 쌍을 둘러싼 바깥쪽 {}이(가) 없습니다. |
| unitOfMeasure | UnitOfMeasure |