Billing Subscriptions - List By Customer

참조

서비스:: Billing

API 버전:: 2024-04-01

고객의 구독을 나열합니다. 이 작업은 계약 유형이 Microsoft 파트너 계약인 청구 계정에 대해서만 지원됩니다.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/billingSubscriptions?api-version=2024-04-01

선택적 매개 변수:

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/billingSubscriptions?includeDeleted={includeDeleted}&api-version=2024-04-01&expand={expand}&filter={filter}&orderBy={orderBy}&top={top}&skip={skip}&count={count}&search={search}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
billingAccountName	path	True	string	청구 계정을 고유하게 식별하는 ID입니다.
billingProfileName	path	True	string	청구 프로필을 고유하게 식별하는 ID입니다.
customerName	path	True	string	고객을 고유하게 식별하는 ID입니다.
api-version	query	True	string	클라이언트 요청과 함께 사용할 API의 버전입니다. 현재 버전은 2024-04-01입니다.
count	query		boolean	개수 쿼리 옵션을 사용하면 클라이언트가 응답의 리소스에 포함된 일치하는 리소스의 수를 요청할 수 있습니다.
expand	query		string	`Reseller`, `ConsumptionCostCenter`, `LastMonthCharges` 및 `MonthToDateCharges` 확장하는 데 사용할 수 있습니다.
filter	query		string	필터 쿼리 옵션을 사용하면 클라이언트가 요청 URL로 처리되는 리소스 컬렉션을 필터링할 수 있습니다.
includeDeleted	query		boolean	삭제된 청구 구독을 가져오는 데 사용할 수 있습니다.
orderBy	query		string	orderby 쿼리 옵션을 사용하면 클라이언트가 특정 순서로 리소스를 요청할 수 있습니다.
search	query		string	검색 쿼리 옵션을 사용하면 클라이언트가 자유 텍스트 검색 식과 일치하는 컬렉션 내의 항목을 요청할 수 있습니다. 검색은 문자열 필드에 대해서만 지원됩니다.
skip	query		integer int64	건너뛰기 쿼리 옵션은 건너뛰고 결과에 포함되지 않을 쿼리된 컬렉션의 항목 수를 요청합니다.
top	query		integer int64	최상위 쿼리 옵션은 쿼리된 컬렉션의 항목 수를 결과에 포함하도록 요청합니다. 상위에 지원되는 최대값은 50입니다.

응답

Name	형식	Description
200 OK	BillingSubscriptionListResult	청구 구독 목록입니다.
Other Status Codes	ErrorResponse	작업이 실패한 이유를 설명하는 오류 응답입니다.

예제

BillingSubscriptionsListByCustomer

샘플 요청

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingProfiles/ea36e548-1505-41db-bebc-46fff3d37998/customers/Q7GV-UUVA-PJA-TGB/billingSubscriptions?api-version=2024-04-01


/**
 * Samples for BillingSubscriptions ListByCustomer.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/billing/resource-manager/Microsoft.Billing/stable/2024-04-01/examples/
     * billingSubscriptionsListByCustomer.json
     */
    /**
     * Sample code: BillingSubscriptionsListByCustomer.
     * 
     * @param manager Entry point to BillingManager.
     */
    public static void billingSubscriptionsListByCustomer(com.azure.resourcemanager.billing.BillingManager manager) {
        manager.billingSubscriptions().listByCustomer(
            "a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31",
            "ea36e548-1505-41db-bebc-46fff3d37998", "Q7GV-UUVA-PJA-TGB", null, null, null, null, null, null, null, null,
            com.azure.core.util.Context.NONE);
    }
}

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.billing import BillingManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-billing
# USAGE
    python billing_subscriptions_list_by_customer.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = BillingManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.billing_subscriptions.list_by_customer(
        billing_account_name="a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31",
        billing_profile_name="ea36e548-1505-41db-bebc-46fff3d37998",
        customer_name="Q7GV-UUVA-PJA-TGB",
    )
    for item in response:
        print(item)


# x-ms-original-file: specification/billing/resource-manager/Microsoft.Billing/stable/2024-04-01/examples/billingSubscriptionsListByCustomer.json
if __name__ == "__main__":
    main()

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

const { BillingManagementClient } = require("@azure/arm-billing");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Lists the subscriptions for a customer. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.
 *
 * @summary Lists the subscriptions for a customer. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.
 * x-ms-original-file: specification/billing/resource-manager/Microsoft.Billing/stable/2024-04-01/examples/billingSubscriptionsListByCustomer.json
 */
async function billingSubscriptionsListByCustomer() {
  const billingAccountName =
    "a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31";
  const billingProfileName = "ea36e548-1505-41db-bebc-46fff3d37998";
  const customerName = "Q7GV-UUVA-PJA-TGB";
  const credential = new DefaultAzureCredential();
  const client = new BillingManagementClient(credential);
  const resArray = new Array();
  for await (let item of client.billingSubscriptions.listByCustomer(
    billingAccountName,
    billingProfileName,
    customerName,
  )) {
    resArray.push(item);
  }
  console.log(resArray);
}

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

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

// Generated from example definition: specification/billing/resource-manager/Microsoft.Billing/stable/2024-04-01/examples/billingSubscriptionsListByCustomer.json
// this example is just showing the usage of "BillingSubscriptions_ListByCustomer" 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 BillingProfileCustomerResource created on azure
// for more information of creating BillingProfileCustomerResource, please refer to the document of BillingProfileCustomerResource
string billingAccountName = "a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31";
string billingProfileName = "ea36e548-1505-41db-bebc-46fff3d37998";
string customerName = "Q7GV-UUVA-PJA-TGB";
ResourceIdentifier billingProfileCustomerResourceId = BillingProfileCustomerResource.CreateResourceIdentifier(billingAccountName, billingProfileName, customerName);
BillingProfileCustomerResource billingProfileCustomer = client.GetBillingProfileCustomerResource(billingProfileCustomerResourceId);

// invoke the operation and iterate over the result
BillingProfileCustomerResourceGetBillingSubscriptionsOptions options = new BillingProfileCustomerResourceGetBillingSubscriptionsOptions() { };
await foreach (BillingSubscriptionData item in billingProfileCustomer.GetBillingSubscriptionsAsync(options))
{
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {item.Id}");
}

Console.WriteLine($"Succeeded");

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

샘플 응답

상태 코드:: 200

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingSubscriptions/6b96d3f2-9008-4a9d-912f-f87744185aa3",
      "name": "6b96d3f2-9008-4a9d-912f-f87744185aa3",
      "properties": {
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingProfiles/ea36e548-1505-41db-bebc-46fff3d37998",
        "billingProfileDisplayName": "BillingProfile1",
        "billingProfileName": "ea36e548-1505-41db-bebc-46fff3d37998",
        "customerId": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingProfiles/ea36e548-1505-41db-bebc-46fff3d37998/customers/Q7GV-UUVA-PJA-TGB",
        "customerDisplayName": "Customer1",
        "displayName": "My Subscription",
        "reseller": {
          "resellerId": "89e87bdf-a2a2-4687-925f-4c18b27bccfd",
          "description": "Reseller1"
        },
        "skuId": "0002",
        "skuDescription": "Microsoft Azure Standard",
        "resourceUri": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingSubscriptions/6b96d3f2-9008-4a9d-912f-f87744185aa3",
        "status": "Active",
        "subscriptionId": "6b96d3f2-9008-4a9d-912f-f87744185aa3"
      },
      "type": "Microsoft.Billing/billingAccounts/billingSubscriptions"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingSubscriptions/CD0BBD7A-461A-4D9A-9C59-EAE51A0D5D12",
      "name": "CD0BBD7A-461A-4D9A-9C59-EAE51A0D5D12",
      "properties": {
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingProfiles/ea36e548-1505-41db-bebc-46fff3d37998",
        "billingProfileDisplayName": "BillingProfile1",
        "billingProfileName": "ea36e548-1505-41db-bebc-46fff3d37998",
        "customerId": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/customers/Q7GV-UUVA-PJA-TGB",
        "customerDisplayName": "Customer1",
        "displayName": "Test Subscription",
        "reseller": {
          "resellerId": "3b65b5a8-bd4f-4084-90e9-e1bd667a2b19",
          "description": "Reseller3"
        },
        "skuId": "0002",
        "skuDescription": "Microsoft Azure Standard",
        "resourceUri": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingSubscriptions/CD0BBD7A-461A-4D9A-9C59-EAE51A0D5D12",
        "status": "Active",
        "subscriptionId": "CD0BBD7A-461A-4D9A-9C59-EAE51A0D5D12"
      },
      "type": "Microsoft.Billing/billingAccounts/billingSubscriptions"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingSubscriptions/9e90f86b-22fc-42f3-bfe2-0ac3e7c01d32",
      "name": "9e90f86b-22fc-42f3-bfe2-0ac3e7c01d32",
      "properties": {
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingProfiles/ea36e548-1505-41db-bebc-46fff3d37998",
        "billingProfileDisplayName": "BillingProfile1",
        "billingProfileName": "ea36e548-1505-41db-bebc-46fff3d37998",
        "customerId": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/customers/Q7GV-UUVA-PJA-TGB",
        "customerDisplayName": "Customer1",
        "displayName": "Dev Test Subscription",
        "skuId": "0001",
        "skuDescription": "Domain Name Registration ORG",
        "resourceUri": "/providers/Microsoft.Domain/domainSubscriptions/9e90f86b-22fc-42f3-bfe2-0ac3e7c01d32",
        "status": "Active",
        "subscriptionId": "9e90f86b-22fc-42f3-bfe2-0ac3e7c01d32"
      },
      "type": "Microsoft.Billing/billingAccounts/billingSubscriptions"
    }
  ]
}

정의

Name	Description
Amount	금액입니다.
AutoRenew	제품에 대해 자동 갱신을 설정하거나 해제할지 여부를 나타냅니다.
Beneficiary	수혜자의 세부 정보입니다.
BillingSubscription	구독의 청구 속성입니다.
BillingSubscriptionListResult	리소스 목록에 대한 컨테이너
BillingSubscriptionOperationStatus	구독에 대한 작업의 상태입니다. None이면 진행 중인 작업이 없습니다. LockedForUpdate인 경우 청구 구독에서 쓰기 작업이 차단됩니다. 다른 기본값은 기본값이며, 자세한 내용은 최신 API 버전을 참조해야 할 수 있습니다.
BillingSubscriptionStatus	구독의 상태입니다. 기업계약 청구 계정에는 이 필드를 사용할 수 없습니다.
BillingSubscriptionStatusDetails	구독에 대한 일시 중단 세부 정보입니다. 기업계약 청구 계정에는 이 필드를 사용할 수 없습니다.
Cancellation	구독에 대한 정책 재정의는 셀프 서비스 취소 또는 좌석 감소가 허용되는지 여부를 나타냅니다.
createdByType	리소스를 만든 ID의 형식입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
NextBillingCycleDetails	제품의 청구 주기 세부 정보입니다.
ProvisioningState	장기 실행 작업 중 리소스의 프로비전 상태입니다.
RenewalTermDetails	구독의 다음 갱신 기간에 대한 세부 정보입니다.
Reseller	재판매인의 세부 정보입니다.
SubscriptionEnrollmentAccountStatus	구독의 현재 등록 계정 상태입니다. 이 필드는 기업계약 유형에만 사용할 수 있습니다.
SubscriptionStatusReason	구독의 일시 중단 이유입니다. 기업계약 청구 계정에는 이 필드를 사용할 수 없습니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
SystemOverrides	구독의 동작을 규제하는 시스템 적용 정책입니다.

Amount

금액입니다.

Name	형식	Description
currency	string	금액 값의 통화입니다.
value	number	금액 값입니다. 예를 들어 통화가 USD이면 600의 값은 $600.00입니다.

AutoRenew

제품에 대해 자동 갱신을 설정하거나 해제할지 여부를 나타냅니다.

Name	형식	Description
Off	string
On	string

Beneficiary

수혜자의 세부 정보입니다.

Name	형식	Description
objectId	string	테넌트에서 사용자를 고유하게 식별하는 ID입니다.
tenantId	string	테넌트를 고유하게 식별하는 ID입니다.

BillingSubscription

구독의 청구 속성입니다.

Name	형식	Description
id	string	리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	리소스의 이름
properties.autoRenew	AutoRenew	제품에 대해 자동 갱신을 설정하거나 해제할지 여부를 나타냅니다.
properties.beneficiary	Beneficiary	청구 구독의 수혜자입니다.
properties.beneficiaryTenantId	string	구독의 프로비전 테넌트입니다.
properties.billingFrequency	string	구독에서 제품의 ISO8601 형식의 청구 빈도입니다. 예: P1M, P3M, P1Y
properties.billingPolicies	object	구독과 연결된 청구 정책의 사전입니다.
properties.billingProfileDisplayName	string	청구 프로필의 이름입니다.
properties.billingProfileId	string	청구 프로필을 고유하게 식별하는 정규화된 ID입니다.
properties.billingProfileName	string	청구 프로필을 고유하게 식별하는 ID입니다.
properties.consumptionCostCenter	string	구독에 적용된 비용 센터입니다. 이 필드는 Microsoft 고객 계약 또는 기업계약 유형 청구 계정의 소비 구독에만 사용할 수 있습니다.
properties.customerDisplayName	string	고객의 이름입니다.
properties.customerId	string	고객을 고유하게 식별하는 정규화된 ID입니다.
properties.customerName	string	고객을 고유하게 식별하는 ID입니다.
properties.displayName	string	청구 구독의 이름입니다.
properties.enrollmentAccountDisplayName	string	구독과 연결된 등록 계정 이름입니다. 이 필드는 기업계약 유형 청구 계정에만 사용할 수 있습니다.
properties.enrollmentAccountId	string	구독과 연결된 등록 계정 ID입니다. 이 필드는 기업계약 유형 청구 계정에만 사용할 수 있습니다.
properties.enrollmentAccountSubscriptionDetails.enrollmentAccountStartDate	string	등록 계정 및 구독 연결 시작 날짜입니다. 이 필드는 기업계약 유형에만 사용할 수 있습니다.
properties.enrollmentAccountSubscriptionDetails.subscriptionEnrollmentAccountStatus	SubscriptionEnrollmentAccountStatus	구독의 현재 등록 계정 상태입니다. 이 필드는 기업계약 유형에만 사용할 수 있습니다.
properties.invoiceSectionDisplayName	string	청구서 섹션의 이름입니다.
properties.invoiceSectionId	string	청구서 섹션을 고유하게 식별하는 정규화된 ID입니다.
properties.invoiceSectionName	string	청구서 섹션을 고유하게 식별하는 ID입니다.
properties.lastMonthCharges	Amount	지난 달의 요금입니다. 이 필드는 Microsoft 고객 계약 청구 계정의 사용량 기반 구독에만 사용할 수 있습니다.
properties.monthToDateCharges	Amount	현재 월에서 현재까지의 요금입니다. 이 필드는 Microsoft 고객 계약 청구 계정의 사용량 기반 구독에만 사용할 수 있습니다.
properties.nextBillingCycleDetails	NextBillingCycleDetails	구독의 다음 청구 주기 세부 정보입니다.
properties.offerId	string	구독의 제품 ID입니다. 이 필드는 Microsoft Online Services 프로그램 청구 계정에만 사용할 수 있습니다.
properties.operationStatus	BillingSubscriptionOperationStatus	구독에 대한 작업의 상태입니다. None이면 진행 중인 작업이 없습니다. LockedForUpdate인 경우 청구 구독에서 쓰기 작업이 차단됩니다. 다른 기본값은 기본값이며, 자세한 내용은 최신 API 버전을 참조해야 할 수 있습니다.
properties.productCategory	string	구독을 구매한 제품의 범주입니다. 가능한 값은 AzureSupport, 하드웨어, ReservationOrder, SaaS, SavingsPlanOrder, 소프트웨어, UsageBased, 기타입니다.
properties.productType	string	구독을 구매한 제품의 유형입니다.
properties.productTypeId	string	구독을 구매한 제품의 ID입니다.
properties.provisioningState	ProvisioningState	장기 실행 작업 중 리소스의 프로비전 상태입니다.
properties.provisioningTenantId	string	구독이 프로비전되는 테넌트입니다.
properties.purchaseDate	string	제품의 구매 날짜(UTC 시간)입니다.
properties.quantity	integer	구독에 대한 라이선스 또는 처리 단위의 수입니다.
properties.renewalTermDetails	RenewalTermDetails	구독의 다음 갱신 기간에 대한 세부 정보입니다.
properties.reseller	Reseller	이 구독에 대한 재판매인입니다. Microsoft 파트너 계약 청구 계정에는 필드를 사용할 수 없습니다.
properties.resourceUri	string	연결된 리소스의 고유 식별자입니다.
properties.skuDescription	string	구독을 구매한 제품에 대한 SKU 설명입니다. 이 필드는 계약 유형이 Microsoft 고객 계약 및 Microsoft 파트너 계약인 청구 계정에만 사용할 수 있습니다.
properties.skuId	string	구독을 구매한 제품의 SKU ID입니다. 이 필드는 Microsoft 고객 계약 청구 계정에만 사용할 수 있습니다.
properties.status	BillingSubscriptionStatus	구독의 상태입니다. 기업계약 청구 계정에는 이 필드를 사용할 수 없습니다.
properties.subscriptionId	string	구독의 ID입니다.
properties.suspensionReasonDetails	BillingSubscriptionStatusDetails[]	구독에 대한 일시 중단 세부 정보입니다. 기업계약 청구 계정에는 이 필드를 사용할 수 없습니다.
properties.suspensionReasons	string[]	구독의 일시 중단 이유입니다. 기업계약 청구 계정에는 이 필드를 사용할 수 없습니다.
properties.systemOverrides	SystemOverrides	구독의 동작을 규제하는 시스템 적용 정책입니다.
properties.termDuration	string	구독을 사용할 수 있는 ISO8601 형식의 기간입니다. 예: P1M, P3M, P1Y
properties.termEndDate	string	용어의 종료 날짜(UTC 시간)입니다.
properties.termStartDate	string	용어의 시작 날짜(UTC 시간)입니다.
systemData	systemData	createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
tags	object	리소스와 연결된 메타데이터의 사전입니다. 모든 리소스 종류에 대해 채워지지 않을 수 있습니다. 최대 키/값 길이는 256자로 지원됩니다. 키/값은 값이나 null을 비워서는 안 됩니다. 키에는 <> % & \ ? /
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

BillingSubscriptionListResult

리소스 목록에 대한 컨테이너

Name	형식	Description
nextLink	string	결과의 다음 페이지에 대한 링크(URL)입니다.
totalCount	number	총 레코드 수입니다.
value	BillingSubscription[]	리소스 목록입니다.

BillingSubscriptionOperationStatus

구독에 대한 작업의 상태입니다. None이면 진행 중인 작업이 없습니다. LockedForUpdate인 경우 청구 구독에서 쓰기 작업이 차단됩니다. 다른 기본값은 기본값이며, 자세한 내용은 최신 API 버전을 참조해야 할 수 있습니다.

Name	형식	Description
LockedForUpdate	string
None	string
Other	string

BillingSubscriptionStatus

구독의 상태입니다. 기업계약 청구 계정에는 이 필드를 사용할 수 없습니다.

Name	형식	Description
Active	string
AutoRenew	string
Cancelled	string
Deleted	string
Disabled	string
Expired	string
Expiring	string
Failed	string
Other	string
Suspended	string
Unknown	string
Warned	string

BillingSubscriptionStatusDetails

구독에 대한 일시 중단 세부 정보입니다. 기업계약 청구 계정에는 이 필드를 사용할 수 없습니다.

Name	형식	Description
effectiveDate	string	구독의 일시 중단 유효 날짜입니다. 기업계약 청구 계정에는 이 필드를 사용할 수 없습니다.
reason	SubscriptionStatusReason	구독의 일시 중단 이유입니다. 기업계약 청구 계정에는 이 필드를 사용할 수 없습니다.

Cancellation

구독에 대한 정책 재정의는 셀프 서비스 취소 또는 좌석 감소가 허용되는지 여부를 나타냅니다.

Name	형식	Description
Allowed	string
NotAllowed	string

createdByType

리소스를 만든 ID의 형식입니다.

Name	형식	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

NextBillingCycleDetails

제품의 청구 주기 세부 정보입니다.

Name	형식	Description
billingFrequency	string	구독에서 제품의 청구 빈도입니다.

ProvisioningState

장기 실행 작업 중 리소스의 프로비전 상태입니다.

Name	형식	Description
Canceled	string
Failed	string
New	string
Pending	string
Provisioning	string
Succeeded	string

RenewalTermDetails

구독의 다음 갱신 기간에 대한 세부 정보입니다.

Name	형식	Description
billingFrequency	string	구독에서 제품의 ISO8601 형식의 청구 빈도입니다. 예: P1M, P3M, P1Y
productId	string	구독을 구매한 제품의 ID입니다.
productTypeId	string	구독을 구매한 제품의 유형 ID입니다.
quantity	integer	구독에 대한 라이선스 또는 처리 단위의 수입니다.
skuId	string	구독을 구매한 제품의 SKU ID입니다. 이 필드는 Microsoft 고객 계약 청구 계정에만 사용할 수 있습니다.
termDuration	string	구독을 사용할 수 있는 ISO8601 형식의 기간입니다. 예: P1M, P3M, P1Y
termEndDate	string	용어의 종료 날짜(UTC 시간)입니다.

Reseller

재판매인의 세부 정보입니다.

Name	형식	Description
description	string	재판매인의 이름입니다.
resellerId	string	재판매인의 MPN ID입니다.

SubscriptionEnrollmentAccountStatus

구독의 현재 등록 계정 상태입니다. 이 필드는 기업계약 유형에만 사용할 수 있습니다.

Name	형식	Description
Active	string
Cancelled	string
Deleted	string
Expired	string
Inactive	string
TransferredOut	string
Transferring	string

SubscriptionStatusReason

구독의 일시 중단 이유입니다. 기업계약 청구 계정에는 이 필드를 사용할 수 없습니다.

Name	형식	Description
Cancelled	string
Expired	string
None	string
Other	string
PastDue	string
PolicyViolation	string
SpendingLimitReached	string
SuspiciousActivity	string
Transferred	string

systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

SystemOverrides

구독의 동작을 규제하는 시스템 적용 정책입니다.

Name	형식	Description
cancellation	Cancellation	구독에 대한 정책 재정의는 셀프 서비스 취소 또는 좌석 감소가 허용되는지 여부를 나타냅니다.
cancellationAllowedEndDate	string	셀프 서비스 취소가 종료되는 시점의 종료 날짜(UTC 시간)입니다.

다음을 통해 공유

Billing Subscriptions - List By Customer

URI 매개 변수

응답

예제

BillingSubscriptionsListByCustomer

샘플 요청

샘플 응답

정의

Amount

AutoRenew

Beneficiary

BillingSubscription

BillingSubscriptionListResult

BillingSubscriptionOperationStatus

BillingSubscriptionStatus

BillingSubscriptionStatusDetails

Cancellation

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

NextBillingCycleDetails

ProvisioningState

RenewalTermDetails

Reseller

SubscriptionEnrollmentAccountStatus

SubscriptionStatusReason

systemData

SystemOverrides

추가 리소스