Billing Subscriptions - Get

참조

Service:: Billing

API Version:: 2021-10-01

ID로 구독을 가져옵니다. 이 작업은 현재 계약 유형 Microsoft 고객 계약, Microsoft 파트너 계약 및 Microsoft Online Services 프로그램의 청구 계정에 대해 지원됩니다.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions/{billingSubscriptionName}?api-version=2021-10-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
billingAccountName	path	True	string	청구 계정을 고유하게 식별하는 ID입니다.
billingSubscriptionName	path	True	string	구독을 고유하게 식별하는 ID입니다.
api-version	query	True	string	클라이언트 요청과 함께 사용할 API의 버전입니다. 현재 버전은 2021-10-01입니다.

응답

Name	형식	Description
200 OK	BillingSubscription	OK. 요청이 성공했습니다.
Other Status Codes	ErrorResponse	작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

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	사용자 계정 가장

예제

BillingSubscription

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions/418b0e9c-5dc3-4260-918f-30b90619fe07?api-version=2021-10-01

using System;
using System.Threading.Tasks;
using System.Xml;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Billing;
using Azure.ResourceManager.Billing.Models;

// Generated from example definition: specification/billing/resource-manager/Microsoft.Billing/stable/2021-10-01/examples/BillingSubscription.json
// this example is just showing the usage of "BillingSubscriptions_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this BillingSubscriptionResource created on azure
// for more information of creating BillingSubscriptionResource, please refer to the document of BillingSubscriptionResource
string billingAccountName = "{billingAccountName}";
string billingSubscriptionName = "418b0e9c-5dc3-4260-918f-30b90619fe07";
ResourceIdentifier billingSubscriptionResourceId = BillingSubscriptionResource.CreateResourceIdentifier(billingAccountName, billingSubscriptionName);
BillingSubscriptionResource billingSubscription = client.GetBillingSubscriptionResource(billingSubscriptionResourceId);

// invoke the operation
BillingSubscriptionResource result = await billingSubscription.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
BillingSubscriptionData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "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"
  }
}

정의

Name	Description
Amount	금액입니다.
AutoRenew	구독에 대해 자동 갱신이 설정되어 있는지 여부를 나타냅니다.
BillingSubscription	청구 구독입니다.
BillingSubscriptionStatus	구독의 상태입니다. 이 필드는 기업계약 청구 계정에 사용할 수 없습니다.
ErrorDetails	오류의 세부 정보입니다.
ErrorResponse	오류 응답은 서비스가 들어오는 요청을 처리할 수 없음을 나타냅니다. 이유는 오류 메시지에 제공됩니다.
ErrorSubDetails	오류의 하위 세부 정보입니다.
NextBillingCycleDetails	구독의 다음 청구 주기 세부 정보입니다.
RenewalTermDetails	갱신 시 구독의 용어 세부 정보입니다.
Reseller	재판매인의 세부 정보입니다.
SubscriptionEnrollmentAccountStatus	구독의 현재 등록 계정 상태. 이 필드는 기업계약 청구 계정에만 사용할 수 있습니다.

Amount

금액입니다.

Name	형식	Description
currency	string	금액 값의 통화입니다.
value	number	금액 값입니다.

AutoRenew

구독에 대해 자동 갱신이 설정되어 있는지 여부를 나타냅니다.

Name	형식	Description
Off	string
On	string

BillingSubscription

청구 구독입니다.

Name	형식	Description
id	string	리소스 ID입니다.
name	string	리소스 이름입니다.
properties.autoRenew	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	SubscriptionEnrollmentAccountStatus	구독의 현재 등록 계정 상태. 이 필드는 기업계약 청구 계정에만 사용할 수 있습니다.
properties.invoiceSectionDisplayName	string	구독이 청구되는 청구서 섹션의 표시 이름입니다. 필드는 Microsoft 파트너 계약 청구 계정에만 적용됩니다.
properties.invoiceSectionId	string	구독이 청구되는 청구서 섹션의 ID입니다. 필드는 Microsoft 파트너 계약 청구 계정에만 적용됩니다.
properties.invoiceSectionName	string	구독이 청구되는 청구서 섹션의 이름입니다. 필드는 Microsoft 파트너 계약 청구 계정에만 적용됩니다.
properties.lastMonthCharges	Amount	지난 달의 요금입니다. 이 필드는 Microsoft 고객 계약 청구 계정의 사용량 기반 구독에만 사용할 수 있습니다.
properties.monthToDateCharges	Amount	현재 월~날짜 요금입니다. 이 필드는 Microsoft 고객 계약 청구 계정의 사용량 기반 구독에만 사용할 수 있습니다.
properties.nextBillingCycleDetails	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	RenewalTermDetails	다음 갱신 시 구독의 용어 세부 정보입니다.
properties.reseller	Reseller	구독이 만들어지는 재판매인입니다. 이 필드는 Microsoft 파트너 계약 청구 계정에 사용할 수 있습니다.
properties.skuDescription	string	구독을 구매한 제품에 대한 SKU 설명입니다. 이 필드는 Microsoft 고객 계약 청구 계정에만 사용할 수 있습니다.
properties.skuId	string	구독을 구매한 제품의 SKU ID입니다. 이 필드는 Microsoft 고객 계약 청구 계정에만 사용할 수 있습니다.
properties.status	BillingSubscriptionStatus	구독의 상태입니다. 이 필드는 기업계약 청구 계정에 사용할 수 없습니다.
properties.subscriptionId	string	사용량 기반 구독의 ID입니다. 이 필드는 Microsoft 고객 계약 청구 계정의 사용량 기반 구독에만 사용할 수 있습니다.
properties.suspensionReasons	string[]	구독의 일시 중단 이유입니다. 이 필드는 기업계약 청구 계정에 사용할 수 없습니다.
properties.termDuration	string	구독을 사용할 수 있는 기간입니다. 예제 P1Y 및 P1M
properties.termEndDate	string	용어의 종료 날짜(UTC 시간)입니다.
properties.termStartDate	string	용어의 시작 날짜(UTC 시간)입니다.
type	string	리소스 종류.

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	ErrorSubDetails[]	오류의 하위 세부 정보입니다.
message	string	작업이 실패한 이유를 나타내는 오류 메시지입니다.
target	string	특정 오류의 대상입니다.

ErrorResponse

오류 응답은 서비스가 들어오는 요청을 처리할 수 없음을 나타냅니다. 이유는 오류 메시지에 제공됩니다.

Name	형식	Description
error	ErrorDetails	오류의 세부 정보입니다.

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

Billing Subscriptions - Get

URI 매개 변수

응답

보안

azure_auth

Scopes

예제

BillingSubscription

Sample Request

Sample Response

정의

Amount

AutoRenew

BillingSubscription

BillingSubscriptionStatus

ErrorDetails

ErrorResponse

ErrorSubDetails

NextBillingCycleDetails

RenewalTermDetails

Reseller

SubscriptionEnrollmentAccountStatus

추가 리소스