Azure 청구 및 사용량 API를 사용하여 청구 계정의 Microsoft Azure 사용량 약정(MACC)을 프로그래밍 방식으로 가져올 수 있습니다.
아래에 표시된 예제에서는 REST API를 사용합니다. 현재 PowerShell 및 Azure CLI는 지원되지 않습니다. 예제 출력은 Microsoft 고객 계약에 대한 것이므로 기업계약에 대한 출력은 다릅니다.
액세스 권한이 있는 청구 계정 찾기
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2020-05-01
API 응답은 청구 계정 목록을 반환합니다.
{
"value": [
{
"id": "/providers/Microsoft.Billing/billingAccounts/9a157b81-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx",
"name": "9a157b81-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx",
"type": "Microsoft.Billing/billingAccounts",
"properties": {
"displayName": "Contoso",
"agreementType": "MicrosoftCustomerAgreement",
"accountStatus": "Active",
"accountType": "Enterprise",
"hasReadAccess": true,
}
},
{
"id": "/providers/Microsoft.Billing/billingAccounts/9a12f056-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx",
"name": "9a12f056-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx",
"type": "Microsoft.Billing/billingAccounts",
"properties": {
"displayName": "Kayla Lewis",
"agreementType": "MicrosoftCustomerAgreement",
"accountStatus": "Active",
"accountType": "Individual",
"hasReadAccess": true,
}
}
]
}
청구 계정의 displayName
속성을 사용하여 MACC을 추적하려는 청구 계정을 식별합니다. 청구 계정 name
을 복사합니다. 예를 들어, Contoso 청구 계정에 대한 MACC를 추적하려면 9a157b81-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx
을 복사합니다. 다음 단계에서 사용할 수 있도록 이 값을 어딘가에 붙여 넣습니다.
Microsoft Azure 사용 약정 목록 가져오기
<billingAccountName>
를 첫 번째 단계(9a157b81-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx
)에서 복사한 name
로 바꿔서 다음 요청을 수행합니다.
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/<billingAccountName>/providers/Microsoft.Consumption/lots?api-version=2021-05-01&$filter=source%20eq%20%27ConsumptionCommitment%27
API 응답은 청구 계정에 대한 MACC 목록을 반환합니다.
{
"value": [
{
"id": "/providers/Microsoft.Billing/billingAccounts/9a157b81-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/providers/Microsoft.Consumption/lots/G2021032459206000XXXX",
"name": "G2021032459206000XXXX",
"type": "Microsoft.Consumption/lots",
"eTag": null,
"properties": {
"purchasedDate": "2021-03-24T16:26:46.0000000Z",
"status": "Active",
"originalAmount": {
"currency": "USD",
"value": 10000.0
},
"closedBalance": {
"currency": "USD",
"value": 9899.42
},
"source": "ConsumptionCommitment",
"startDate": "2021-03-01T00:00:00.0000000Z",
"expirationDate": "2024-02-28T00:00:00.0000000Z"
}
},
{
"id": "/providers/Microsoft.Billing/billingAccounts/9a157b81-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/providers/Microsoft.Consumption/lots/G1011082459206000XXXX",
"name": "G1011082459206000XXXX",
"type": "Microsoft.Consumption/lots",
"eTag": null,
"properties": {
"purchasedDate": "2021-03-24T16:26:46.0000000Z",
"status": "Complete",
"originalAmount": {
"currency": "USD",
"value": 10000.0
},
"closedBalance": {
"currency": "USD",
"value": 0.00
},
"source": "ConsumptionCommitment",
"startDate": "2020-03-01T00:00:00.0000000Z",
"expirationDate": "2021-02-28T00:00:00.0000000Z"
}
}
]
}
요소 이름 |
설명 |
purchasedDate |
MACC를 구매한 날짜. |
status |
약정 상태입니다. |
originalAmount |
원래의 약정 금액. |
closedBalance |
마지막 청구 이후 남은 약정. |
source |
MACC의 경우, 원본은 항상 ConsumptionCommitment입니다. |
startDate |
MACC가 활성화된 날짜. |
expirationDate |
MACC가 만료되는 날짜. |
MACC는 다음 상태 중 하나일 수 있습니다.
- 활성: MACC가 활성 상태입니다. 모든 가능 소비는 MACC 약정에 반영됩니다.
- 완료됨: MACC 약정을 완료되었습니다.
- 만료됨: MACC가 만료되었습니다. 자세한 정보는 Microsoft 계정 팀에 문의하세요.
- 취소됨: MACC가 취소되었습니다. 새 Azure 지출은 MACC 약정에 영향을 주지 않습니다.
MACC 약정에 영향을 주는 이벤트 가져오기
<billingAccountName>
를 첫 번째 단계(5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx
)에서 복사한 name
로 바꿔서 다음 요청을 수행합니다. 필요한 기간의 이벤트를 가져오려면 startDate 및 endDate를 전달해야 합니다.
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/<billingAccountName>/providers/Microsoft.Consumption/events?api-version=2021-05-01&startDate=<startDate>&endDate=<endDate>&$filter=lotsource%20eq%20%27ConsumptionCommitment%27
API 응답은 MACC 약정에 영향을 준 모든 이벤트를 반환합니다.
{
"value": [
{
"id": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/providers/Microsoft.Consumption/events/103axxxx-2c25-7xx3-f2a0-ad9a3f1c91xx",
"name": "103axxxx-2c25-7xx3-f2a0-ad9a3f1c91xx",
"type": "Microsoft.Consumption/events",
"eTag": null,
"properties": {
"billingProfileId": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/billingProfiles/SWFF-DVM4-XXX-XXX",
"billingProfileDisplayName": "Finance",
"lotId": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/providers/Microsoft.Consumption/lots/G2021032459206000XXXX",
"lotSource": "ConsumptionCommitment",
"transactionDate": "2021-05-05T00:09:13.0000000Z",
"description": "Balance after invoice T00075XXXX",
"charges": {
"currency": "USD",
"value": -100.0
},
"closedBalance": {
"currency": "USD",
"value": 9899.71
},
"eventType": "SettledCharges",
"invoiceNumber": "T00075XXXX"
}
},
{
"id": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/providers/Microsoft.Consumption/events/203axxxx-2c25-7xx3-f2a0-ad9a3f1c91xx",
"name": "203axxxx-2c25-7xx3-f2a0-ad9a3f1c91xx",
"type": "Microsoft.Consumption/events",
"eTag": null,
"properties": {
"billingProfileId": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/billingProfiles/SWFF-DVM4-XXX-XXX",
"billingProfileDisplayName": "Engineering",
"lotId": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/providers/Microsoft.Consumption/lots/G2021032459206000XXXX",
"lotSource": "ConsumptionCommitment",
"transactionDate": "2021-04-05T00:09:13.0000000Z",
"description": "Balance after invoice T00074XXXX",
"charges": {
"currency": "USD",
"value": -0.29
},
"closedBalance": {
"currency": "USD",
"value": 9999.71
},
"eventType": "SettledCharges",
"invoiceNumber": "T00074XXXX"
}
}
]
}
요소 이름 |
설명 |
billingProfileId |
이벤트가 발생한 청구 프로필에 대한 고유 식별자. |
billingProfileDisplayName |
이벤트가 발생한 청구 프로필에 대한 표시 이름. |
lotId |
MACC에 대한 고유 식별자. |
lotSource |
MACC에 대해 ConsumptionCommitment됩니다. |
transactionDate |
이벤트가 발생한 날짜. |
description |
이벤트에 대한 설명입니다. |
charges |
MACC 감소 양. |
closedBalance |
이벤트 후 잔액. |
eventType |
SettledCharges 이벤트만 MACC를 지원합니다. |
invoiceNumber |
MACC를 감소시키는 송장의 고유 ID. |