Billing Subscriptions - List By Billing Account

Başvuru

Service:: Billing

API Version:: 2021-10-01

Ödeme hesabının aboneliklerini listeler. İşlem şu anda sözleşme türü Microsoft Müşteri Sözleşmesi, Microsoft İş Ortağı Sözleşmesi ve Microsoft Online Services Programı olan ödeme hesapları için desteklenmektedir.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
billingAccountName	path	True	string	Bir ödeme hesabını benzersiz olarak tanımlayan kimlik.
api-version	query	True	string	İstemci isteğiyle kullanılacak API'nin sürümü. Geçerli sürüm 2021-10-01'dir.

Yanıtlar

Name	Tür	Description
200 OK	BillingSubscriptionsListResult	Tamam ögesini seçin. İstek başarılı oldu.
Other Status Codes	ErrorResponse	İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Güvenlik

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	kullanıcı hesabınızın kimliğine bürünme

Örnekler

BillingSubscriptionsListByBillingAccount

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

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

// Generated from example definition: specification/billing/resource-manager/Microsoft.Billing/stable/2021-10-01/examples/BillingSubscriptionsListByBillingAccount.json
// this example is just showing the usage of "BillingSubscriptions_ListByBillingAccount" 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 TenantResource created on azure
// for more information of creating TenantResource, please refer to the document of TenantResource
var tenantResource = client.GetTenants().GetAllAsync().GetAsyncEnumerator().Current;

// get the collection of this BillingSubscriptionResource
string billingAccountName = "{billingAccountName}";
BillingSubscriptionCollection collection = tenantResource.GetBillingSubscriptions(billingAccountName);

// invoke the operation and iterate over the result
await foreach (BillingSubscriptionResource item in collection.GetAllAsync())
{
    // the variable item 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 = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.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

Sample Response

Status code:: 200

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

Tanımlar

Name	Description
Amount	Miktar.
AutoRenew	Abonelik için otomatik yenilemenin açık mı yoksa kapalı mı olduğunu gösterir.
BillingSubscription	Faturalama aboneliği.
BillingSubscriptionsListResult	Faturalama aboneliklerinin listesi.
BillingSubscriptionStatus	Aboneliğin durumu. Bu alan Kurumsal Anlaşma ödeme hesapları için kullanılamaz.
ErrorDetails	Hatanın ayrıntıları.
ErrorResponse	Hata yanıtı, hizmetin gelen isteği işleyemediğini gösterir. Nedeni hata iletisinde verilmiştir.
ErrorSubDetails	Hatanın alt ayrıntıları.
NextBillingCycleDetails	Aboneliğin sonraki faturalama dönemi ayrıntıları.
RenewalTermDetails	Yenileme sırasında aboneliğin terim ayrıntıları.
Reseller	Satıcının ayrıntıları.
SubscriptionEnrollmentAccountStatus	Aboneliğin geçerli kayıt hesabı durumu. Bu alan yalnızca Kurumsal Anlaşma ödeme hesapları için kullanılabilir.

Amount

Miktar.

Name	Tür	Description
currency	string	Tutar değerinin para birimi.
value	number	Tutar değeri.

AutoRenew

Abonelik için otomatik yenilemenin açık mı yoksa kapalı mı olduğunu gösterir.

Name	Tür	Description
Off	string
On	string

BillingSubscription

Faturalama aboneliği.

Name	Tür	Description
id	string	Kaynak Kimliği.
name	string	Kaynak adı.
properties.autoRenew	AutoRenew	Abonelik için otomatik yenilemenin açık mı yoksa kapalı mı olduğunu gösterir.
properties.beneficiaryTenantId	string	Aboneliğin sağlama kiracısı.
properties.billingFrequency	string	Aboneliğin ISO8601 biçimindeki faturalama sıklığı. Örnek: P1M, P3M, P1Y
properties.billingPolicies	object	Abonelikle ilişkili faturalama ilkelerinin sözlüğü.
properties.billingProfileDisplayName	string	Aboneliğin faturalandırıldığı faturalama profilinin görünen adı. Bu alan yalnızca Microsoft Müşteri Sözleşmesi ödeme hesapları için geçerlidir.
properties.billingProfileId	string	Aboneliğin faturalandırıldığı faturalama profilinin kimliği. Bu alan yalnızca Microsoft Müşteri Sözleşmesi ödeme hesapları için geçerlidir.
properties.billingProfileName	string	Aboneliğin faturalandırıldığı faturalama profilinin adı. Bu alan yalnızca Microsoft Müşteri Sözleşmesi ödeme hesapları için geçerlidir.
properties.consumptionCostCenter	string	Aboneliğe uygulanan maliyet merkezi. Bu alan yalnızca Microsoft Müşteri Sözleşmesi Türü faturalama hesaplarının tüketim abonelikleri için kullanılabilir.
properties.customerDisplayName	string	Aboneliğin oluşturulduğu müşterinin adı. Bu alan yalnızca Microsoft İş Ortağı Sözleşmesi ödeme hesapları için geçerlidir.
properties.customerId	string	Aboneliğin oluşturulduğu müşterinin kimliği. Bu alan yalnızca Microsoft İş Ortağı Sözleşmesi ödeme hesapları için geçerlidir.
properties.customerName	string	Aboneliğin oluşturulduğu müşterinin adı. Bu alan yalnızca Microsoft İş Ortağı Sözleşmesi ödeme hesapları için geçerlidir.
properties.displayName	string	Aboneliğin adı.
properties.enrollmentAccountDisplayName	string	Abonelikle ilişkili kayıt Hesabı adı. Bu alan yalnızca Kurumsal Anlaşma ödeme hesapları için kullanılabilir.
properties.enrollmentAccountId	string	Abonelikle ilişkili kayıt Hesabı Kimliği. Bu alan yalnızca Kurumsal Anlaşma ödeme hesapları için kullanılabilir.
properties.enrollmentAccountSubscriptionDetails.enrollmentAccountStartDate	string	Kayıt Hesabı ve abonelik ilişkilendirme başlangıç tarihi. Bu alan yalnızca Kurumsal Anlaşma ödeme hesapları için kullanılabilir.
properties.enrollmentAccountSubscriptionDetails.subscriptionEnrollmentAccountStatus	SubscriptionEnrollmentAccountStatus	Aboneliğin geçerli kayıt hesabı durumu. Bu alan yalnızca Kurumsal Anlaşma ödeme hesapları için kullanılabilir.
properties.invoiceSectionDisplayName	string	Aboneliğin faturalandırıldığı fatura bölümünün görünen adı. Bu alan yalnızca Microsoft İş Ortağı Sözleşmesi ödeme hesapları için geçerlidir.
properties.invoiceSectionId	string	Aboneliğin faturalandırıldığı fatura bölümünün kimliği. Bu alan yalnızca Microsoft İş Ortağı Sözleşmesi ödeme hesapları için geçerlidir.
properties.invoiceSectionName	string	Aboneliğin faturalandırıldığı fatura bölümünün adı. Bu alan yalnızca Microsoft İş Ortağı Sözleşmesi ödeme hesapları için geçerlidir.
properties.lastMonthCharges	Amount	Geçen ayın ücretleri. Bu alan yalnızca Microsoft Müşteri Sözleşmesi ödeme hesaplarının kullanım tabanlı abonelikleri için kullanılabilir.
properties.monthToDateCharges	Amount	Geçerli aydan bugüne ücretleri. Bu alan yalnızca Microsoft Müşteri Sözleşmesi ödeme hesaplarının kullanım tabanlı abonelikleri için kullanılabilir.
properties.nextBillingCycleDetails	NextBillingCycleDetails	Aboneliğin sonraki faturalama dönemi ayrıntıları.
properties.offerId	string	Aboneliğin teklif kimliği. Bu alan yalnızca Microsoft Online Services Programı ödeme hesapları için kullanılabilir.
properties.productCategory	string	Aboneliğin satın alındığı ürünün kategorisi. Olası değerler şunlardır: AzureSupport, Donanım, ReservationOrder, SaaS, SavingsPlanOrder, Yazılım, UsageBased, Diğer
properties.productType	string	Aboneliğin satın alındığı ürünün türü
properties.productTypeId	string	Aboneliğin satın alındığı ürünün kimliği
properties.purchaseDate	string	Utc saatinde aboneliğin satın alma tarihi.
properties.quantity	integer	Abonelik için satın alınan lisans sayısı
properties.renewalTermDetails	RenewalTermDetails	Bir sonraki yenilemede aboneliğin terim ayrıntıları.
properties.reseller	Reseller	Aboneliğin oluşturulduğu kurumsal bayi. alanı Microsoft İş Ortağı Sözleşmesi ödeme hesapları için kullanılabilir.
properties.skuDescription	string	Aboneliğin satın alındığı ürünün SKU açıklaması. Bu alan yalnızca Microsoft Müşteri Sözleşmesi ödeme hesapları için kullanılabilir.
properties.skuId	string	Aboneliğin satın alındığı ürünün SKU kimliği. Bu alan yalnızca Microsoft Müşteri Sözleşmesi ödeme hesapları için kullanılabilir.
properties.status	BillingSubscriptionStatus	Aboneliğin durumu. Bu alan Kurumsal Anlaşma ödeme hesapları için kullanılamaz.
properties.subscriptionId	string	Kullanım tabanlı aboneliğin kimliği. Bu alan yalnızca Microsoft Müşteri Sözleşmesi ödeme hesaplarının kullanım tabanlı abonelikleri için kullanılabilir.
properties.suspensionReasons	string[]	Aboneliğin askıya alınma nedeni. Bu alan Kurumsal Anlaşma ödeme hesapları için kullanılamaz.
properties.termDuration	string	Aboneliği kullanabileceğiniz süre. Örnek P1Y ve P1M
properties.termEndDate	string	Utc saatinde terimin bitiş tarihi.
properties.termStartDate	string	Utc saatinde terimin başlangıç tarihi.
type	string	Kaynak türü.

BillingSubscriptionsListResult

Faturalama aboneliklerinin listesi.

Name	Tür	Description
nextLink	string	Sonuçların sonraki sayfasına bağlantı (URL).
totalCount	number	Toplam kayıt sayısı.
value	BillingSubscription[]	Faturalama aboneliklerinin listesi.

BillingSubscriptionStatus

Aboneliğin durumu. Bu alan Kurumsal Anlaşma ödeme hesapları için kullanılamaz.

Name	Tür	Description
Active	string
AutoRenew	string
Cancelled	string
Deleted	string
Disabled	string
Expired	string
Expiring	string
Suspended	string
Unknown	string
Warned	string

ErrorDetails

Hatanın ayrıntıları.

Name	Tür	Description
code	string	Hata kodu.
details	ErrorSubDetails[]	Hatanın alt ayrıntıları.
message	string	İşlemin neden başarısız olduğunu belirten hata iletisi.
target	string	Belirli bir hatanın hedefi.

ErrorResponse

Hata yanıtı, hizmetin gelen isteği işleyemediğini gösterir. Nedeni hata iletisinde verilmiştir.

Name	Tür	Description
error	ErrorDetails	Hatanın ayrıntıları.

ErrorSubDetails

Hatanın alt ayrıntıları.

Name	Tür	Description
code	string	Hata kodu.
message	string	İşlemin neden başarısız olduğunu belirten hata iletisi.
target	string	Belirli bir hatanın hedefi.

NextBillingCycleDetails

Aboneliğin sonraki faturalama dönemi ayrıntıları.

Name	Tür	Description
billingFrequency	string	Aboneliğin bir sonraki faturalama döngüsündeki faturalama sıklığı.

RenewalTermDetails

Yenileme sırasında aboneliğin terim ayrıntıları.

Name	Tür	Description
billingFrequency	string	Aboneliğin faturalama sıklığı.
productTypeId	string	Ürünün kimliği.
quantity	integer	Lisans sayısı
skuId	string	Ürünün SKU kimliği
termDuration	string	Aboneliğin süresi. Örnek P1M ve P1Y

Reseller

Satıcının ayrıntıları.

Name	Tür	Description
description	string	Satıcının adı.
resellerId	string	Satıcının MPN kimliği.

SubscriptionEnrollmentAccountStatus

Aboneliğin geçerli kayıt hesabı durumu. Bu alan yalnızca Kurumsal Anlaşma ödeme hesapları için kullanılabilir.

Name	Tür	Description
Active	string
Cancelled	string
Deleted	string
Expired	string
TransferredOut	string
Transferring	string