Billing Subscriptions - List By Billing Account
청구 계정에 대한 구독을 나열합니다. 이 작업은 현재 계약 유형 Microsoft 고객 계약, Microsoft 파트너 계약 및 Microsoft Online Services 프로그램의 청구 계정에 대해 지원됩니다.
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions?api-version=2021-10-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
billing
|
path | True |
string |
청구 계정을 고유하게 식별하는 ID입니다. |
api-version
|
query | True |
string |
클라이언트 요청과 함께 사용할 API의 버전입니다. 현재 버전은 2021-10-01입니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
OK. 요청이 성공했습니다. |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
보안
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | 사용자 계정 가장 |
예제
BillingSubscriptionsListByBillingAccount
Sample Request
Sample Response
{
"totalCount": 3,
"value": [
{
"id": "/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/billingSubscriptions/418b0e9c-5dc3-4260-918f-30b90619fe07",
"name": "418b0e9c-5dc3-4260-918f-30b90619fe07",
"type": "Microsoft.Billing/billingAccounts/billingSubscriptions",
"properties": {
"autoRenew": "Off",
"billingFrequency": "P1M",
"billingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/2b72f936-0166-47d6-91a3-ef9f84f36664",
"billingProfileDisplayName": "Contoso operations billing profile",
"billingProfileName": "2b72f936-0166-47d6-91a3-ef9f84f36664",
"displayName": "Subscription 1",
"invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/2b72f936-0166-47d6-91a3-ef9f84f36664/invoiceSections/5c562559-e31b-4bfe-b608-f8b5b3fbd073",
"invoiceSectionDisplayName": "Contoso operations invoice section",
"invoiceSectionName": "5c562559-e31b-4bfe-b608-f8b5b3fbd073",
"lastMonthCharges": {
"currency": "USD",
"value": 5000
},
"monthToDateCharges": {
"currency": "USD",
"value": 600
},
"productCategory": "UsageBased",
"productType": "Usage based",
"productTypeId": "DZH318Z0BPS6",
"purchaseDate": "2021-10-01T00:00:00Z",
"quantity": 1,
"skuId": "0001",
"skuDescription": "Microsoft Azure Plan",
"status": "Active",
"subscriptionId": "6b96d3f2-9008-4a9d-912f-f87744185aa3"
}
},
{
"id": "/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/billingSubscriptions/9e030ae5-51ed-4e02-8e17-d51b3aa55980",
"name": "9e030ae5-51ed-4e02-8e17-d51b3aa55980",
"type": "Microsoft.Billing/billingAccounts/billingSubscriptions",
"properties": {
"autoRenew": "Off",
"billingFrequency": "P1M",
"billingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/2b72f936-0166-47d6-91a3-ef9f84f36664",
"billingProfileDisplayName": "Contoso operations billing profile",
"billingProfileName": "2b72f936-0166-47d6-91a3-ef9f84f36664",
"displayName": "Subscription 2",
"invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/2b72f936-0166-47d6-91a3-ef9f84f36664/invoiceSections/5c562559-e31b-4bfe-b608-f8b5b3fbd073",
"invoiceSectionDisplayName": "Contoso operations invoice section",
"invoiceSectionName": "5c562559-e31b-4bfe-b608-f8b5b3fbd073",
"lastMonthCharges": {
"currency": "USD",
"value": 1000
},
"monthToDateCharges": {
"currency": "USD",
"value": 400
},
"productCategory": "UsageBased",
"productType": "Usage based",
"productTypeId": "DZH318Z0BPS6",
"purchaseDate": "2021-10-01T00:00:00Z",
"quantity": 1,
"skuId": "0001",
"skuDescription": "Microsoft Azure Plan",
"status": "Active",
"subscriptionId": "6b96d3f2-9008-4a9d-912f-6b96d3f2"
}
},
{
"id": "/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}billingSubscriptions/7f271b5e-a89e-45cc-8fa5-cd5c643f8b5e",
"name": "7f271b5e-a89e-45cc-8fa5-cd5c643f8b5e",
"type": "Microsoft.Billing/billingAccounts/billingSubscriptions",
"properties": {
"autoRenew": "Off",
"billingFrequency": "P1M",
"billingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/2b72f936-0166-47d6-91a3-ef9f84f36664",
"billingProfileDisplayName": "Contoso operations billing profile",
"billingProfileName": "2b72f936-0166-47d6-91a3-ef9f84f36664",
"displayName": "Subscription 3",
"invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/2b72f936-0166-47d6-91a3-ef9f84f36664/invoiceSections/5c562559-e31b-4bfe-b608-f8b5b3fbd0730",
"invoiceSectionDisplayName": "Contoso operations invoice section",
"invoiceSectionName": "5c562559-e31b-4bfe-b608-f8b5b3fbd073",
"lastMonthCharges": {
"currency": "USD",
"value": 6000
},
"monthToDateCharges": {
"currency": "USD",
"value": 900
},
"productCategory": "SeatBased",
"productType": "Microsoft 365 Business Standard",
"productTypeId": "CFQ7TTC0LDPB",
"purchaseDate": "2021-08-01T00:12:49.7261677+00:00",
"quantity": 4,
"skuId": "0001",
"skuDescription": "Microsoft 365 Business Standard",
"status": "Active",
"termDuration": "P1Y",
"termStartDate": "2021-10-01T00:00:00Z",
"termEndDate": "2022-09-30T00:00:00Z"
}
}
]
}
정의
Name | Description |
---|---|
Amount |
금액입니다. |
Auto |
구독에 대해 자동 갱신이 설정되어 있는지 여부를 나타냅니다. |
Billing |
청구 구독. |
Billing |
청구 구독 목록입니다. |
Billing |
구독의 상태입니다. 이 필드는 기업계약 청구 계정에 사용할 수 없습니다. |
Error |
오류의 세부 정보입니다. |
Error |
오류 응답은 서비스가 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다. |
Error |
오류의 하위 세부 정보입니다. |
Next |
구독의 다음 청구 주기 세부 정보입니다. |
Renewal |
갱신 시 구독의 용어 세부 정보입니다. |
Reseller |
재판매인의 세부 정보입니다. |
Subscription |
구독의 현재 등록 계정 상태. 이 필드는 기업계약 청구 계정에만 사용할 수 있습니다. |
Amount
금액입니다.
Name | 형식 | Description |
---|---|---|
currency |
string |
금액 값의 통화입니다. |
value |
number |
금액 값입니다. |
AutoRenew
구독에 대해 자동 갱신이 설정되어 있는지 여부를 나타냅니다.
Name | 형식 | Description |
---|---|---|
Off |
string |
|
On |
string |
BillingSubscription
청구 구독.
Name | 형식 | Description |
---|---|---|
id |
string |
리소스 ID입니다. |
name |
string |
리소스 이름입니다. |
properties.autoRenew |
구독에 대해 자동 갱신이 설정되어 있는지 여부를 나타냅니다. |
|
properties.beneficiaryTenantId |
string |
구독의 프로비전 테넌트입니다. |
properties.billingFrequency |
string |
ISO8601 형식의 구독 청구 빈도입니다. 예: P1M, P3M, P1Y |
properties.billingPolicies |
object |
구독과 연결된 청구 정책 사전입니다. |
properties.billingProfileDisplayName |
string |
구독이 청구되는 청구 프로필의 표시 이름입니다. 이 필드는 Microsoft 고객 계약 청구 계정에만 적용됩니다. |
properties.billingProfileId |
string |
구독이 청구되는 청구 프로필의 ID입니다. 이 필드는 Microsoft 고객 계약 청구 계정에만 적용됩니다. |
properties.billingProfileName |
string |
구독이 청구되는 청구 프로필의 이름입니다. 이 필드는 Microsoft 고객 계약 청구 계정에만 적용됩니다. |
properties.consumptionCostCenter |
string |
구독에 적용된 비용 센터입니다. 이 필드는 Microsoft 고객 계약 형식 청구 계정의 소비 구독에만 사용할 수 있습니다. |
properties.customerDisplayName |
string |
구독을 만든 고객의 이름입니다. 필드는 Microsoft 파트너 계약 청구 계정에만 적용됩니다. |
properties.customerId |
string |
구독을 만든 고객의 ID입니다. 필드는 Microsoft 파트너 계약 청구 계정에만 적용됩니다. |
properties.customerName |
string |
구독을 만든 고객의 이름입니다. 필드는 Microsoft 파트너 계약 청구 계정에만 적용됩니다. |
properties.displayName |
string |
구독 이름입니다. |
properties.enrollmentAccountDisplayName |
string |
구독과 연결된 등록 계정 이름입니다. 이 필드는 기업계약 청구 계정에만 사용할 수 있습니다. |
properties.enrollmentAccountId |
string |
구독과 연결된 등록 계정 ID입니다. 이 필드는 기업계약 청구 계정에만 사용할 수 있습니다. |
properties.enrollmentAccountSubscriptionDetails.enrollmentAccountStartDate |
string |
등록 계정 및 구독 연결 시작 날짜입니다. 이 필드는 기업계약 청구 계정에만 사용할 수 있습니다. |
properties.enrollmentAccountSubscriptionDetails.subscriptionEnrollmentAccountStatus |
구독의 현재 등록 계정 상태. 이 필드는 기업계약 청구 계정에만 사용할 수 있습니다. |
|
properties.invoiceSectionDisplayName |
string |
구독이 청구되는 청구서 섹션의 표시 이름입니다. 필드는 Microsoft 파트너 계약 청구 계정에만 적용됩니다. |
properties.invoiceSectionId |
string |
구독이 청구되는 청구서 섹션의 ID입니다. 필드는 Microsoft 파트너 계약 청구 계정에만 적용됩니다. |
properties.invoiceSectionName |
string |
구독이 청구되는 청구서 섹션의 이름입니다. 필드는 Microsoft 파트너 계약 청구 계정에만 적용됩니다. |
properties.lastMonthCharges |
지난 달의 요금입니다. 이 필드는 Microsoft 고객 계약 청구 계정의 사용량 기반 구독에만 사용할 수 있습니다. |
|
properties.monthToDateCharges |
현재 월에서 날짜까지의 요금입니다. 이 필드는 Microsoft 고객 계약 청구 계정의 사용량 기반 구독에만 사용할 수 있습니다. |
|
properties.nextBillingCycleDetails |
다음으로 구독 세부 정보를 청구 주기. |
|
properties.offerId |
string |
구독의 제품 ID입니다. 이 필드는 Microsoft Online Services 프로그램 청구 계정에만 사용할 수 있습니다. |
properties.productCategory |
string |
구독을 구매한 제품의 범주입니다. 가능한 값은 다음과 같습니다. AzureSupport, 하드웨어, ReservationOrder, SaaS, SavingsPlanOrder, 소프트웨어, UsageBased, 기타 |
properties.productType |
string |
구독을 구매한 제품의 유형입니다. |
properties.productTypeId |
string |
구독을 구매한 제품의 ID입니다. |
properties.purchaseDate |
string |
구독의 구매 날짜(UTC 시간)입니다. |
properties.quantity |
integer |
구독에 대해 구매한 라이선스 수 |
properties.renewalTermDetails |
다음 갱신 시 구독의 용어 세부 정보입니다. |
|
properties.reseller |
구독이 만들어지는 재판매인입니다. 이 필드는 Microsoft 파트너 계약 청구 계정에 사용할 수 있습니다. |
|
properties.skuDescription |
string |
구독을 구매한 제품에 대한 SKU 설명입니다. 이 필드는 Microsoft 고객 계약 청구 계정에만 사용할 수 있습니다. |
properties.skuId |
string |
구독을 구매한 제품의 SKU ID입니다. 이 필드는 Microsoft 고객 계약 청구 계정에만 사용할 수 있습니다. |
properties.status |
구독의 상태입니다. 이 필드는 기업계약 청구 계정에 사용할 수 없습니다. |
|
properties.subscriptionId |
string |
사용량 기반 구독의 ID입니다. 이 필드는 Microsoft 고객 계약 청구 계정의 사용량 기반 구독에만 사용할 수 있습니다. |
properties.suspensionReasons |
string[] |
구독에 대한 일시 중단 이유입니다. 이 필드는 기업계약 청구 계정에 사용할 수 없습니다. |
properties.termDuration |
string |
구독을 사용할 수 있는 기간입니다. 예제 P1Y 및 P1M |
properties.termEndDate |
string |
용어의 종료 날짜(UTC 시간)입니다. |
properties.termStartDate |
string |
용어의 시작 날짜(UTC 시간)입니다. |
type |
string |
리소스 종류. |
BillingSubscriptionsListResult
청구 구독 목록입니다.
Name | 형식 | Description |
---|---|---|
nextLink |
string |
결과의 다음 페이지에 대한 링크(URL)입니다. |
totalCount |
number |
총 레코드 수입니다. |
value |
청구 구독 목록입니다. |
BillingSubscriptionStatus
구독의 상태입니다. 이 필드는 기업계약 청구 계정에 사용할 수 없습니다.
Name | 형식 | Description |
---|---|---|
Active |
string |
|
AutoRenew |
string |
|
Cancelled |
string |
|
Deleted |
string |
|
Disabled |
string |
|
Expired |
string |
|
Expiring |
string |
|
Suspended |
string |
|
Unknown |
string |
|
Warned |
string |
ErrorDetails
오류의 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
code |
string |
오류 코드 |
details |
오류의 하위 세부 정보입니다. |
|
message |
string |
작업이 실패한 이유를 나타내는 오류 메시지입니다. |
target |
string |
특정 오류의 대상입니다. |
ErrorResponse
오류 응답은 서비스가 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다.
Name | 형식 | Description |
---|---|---|
error |
오류의 세부 정보입니다. |
ErrorSubDetails
오류의 하위 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
code |
string |
오류 코드 |
message |
string |
작업이 실패한 이유를 나타내는 오류 메시지입니다. |
target |
string |
특정 오류의 대상입니다. |
NextBillingCycleDetails
구독의 다음 청구 주기 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
billingFrequency |
string |
다음 청구 주기 구독의 청구 빈도입니다. |
RenewalTermDetails
갱신 시 구독의 용어 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
billingFrequency |
string |
구독의 청구 빈도입니다. |
productTypeId |
string |
제품의 ID입니다. |
quantity |
integer |
라이선스 수 |
skuId |
string |
제품의 SKU ID |
termDuration |
string |
구독 기간입니다. 예제 P1M 및 P1Y |
Reseller
재판매인의 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
description |
string |
재판매인의 이름입니다. |
resellerId |
string |
재판매인의 MPN ID입니다. |
SubscriptionEnrollmentAccountStatus
구독의 현재 등록 계정 상태. 이 필드는 기업계약 청구 계정에만 사용할 수 있습니다.
Name | 형식 | Description |
---|---|---|
Active |
string |
|
Cancelled |
string |
|
Deleted |
string |
|
Expired |
string |
|
TransferredOut |
string |
|
Transferring |
string |