Billing Subscriptions - Get
Kimliğine göre bir abonelik alır. İşlem, sözleşme türü Microsoft Müşteri Sözleşmesi, Microsoft İş Ortağı Sözleşmesi ve Kurumsal Anlaşma olan ödeme hesapları için desteklenir.
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions/{billingSubscriptionName}?api-version=2024-04-01
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions/{billingSubscriptionName}?api-version=2024-04-01&expand={expand}
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
billing
|
path | True |
string |
Bir ödeme hesabını benzersiz olarak tanımlayan kimlik. |
billing
|
path | True |
string |
Aboneliği benzersiz olarak tanımlayan kimlik. |
api-version
|
query | True |
string |
İstemci isteğiyle kullanılacak API sürümü. Geçerli sürüm 2024-04-01'dir. |
expand
|
query |
string |
|
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Faturalama aboneliği. |
|
Other Status Codes |
İşlemin neden başarısız olduğunu açıklayan hata yanıtı. |
Örnekler
BillingSubscriptionsGet
Örnek isteği
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingSubscriptions/11111111-1111-1111-1111-111111111111?api-version=2024-04-01
Örnek yanıt
{
"id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingSubscriptions/90000000-0000-0000-0000-000000000000",
"name": "90000000-0000-0000-0000-000000000000",
"properties": {
"autoRenew": "On",
"billingProfileId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx",
"billingProfileDisplayName": "Billing Profile Display Name",
"billingProfileName": "xxxx-xxxx-xxx-xxx",
"displayName": "My subscription",
"invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx/invoiceSections/yyyy-yyyy-yyy-yyy",
"invoiceSectionDisplayName": "Invoice Section Display Name",
"invoiceSectionName": "yyyy-yyyy-yyy-yyy",
"productCategory": "SeatBased",
"productType": "Seat-Based Product Type",
"productTypeId": "XYZ56789",
"purchaseDate": "2023-01-04T22:39:34.2606750Z",
"quantity": 1,
"skuId": "0001",
"skuDescription": "SKU Description",
"systemOverrides": {
"cancellationAllowedEndDate": "2023-02-01T22:39:34.2606750Z"
},
"resourceUri": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingSubscriptions/90000000-0000-0000-0000-000000000000",
"termDuration": "P1M",
"termStartDate": "2023-01-05T22:39:34.2606750Z",
"termEndDate": "2023-02-05T22:39:34.2606750Z",
"status": "Active"
},
"type": "Microsoft.Billing/billingAccounts/billingSubscriptions",
"systemData": {
"createdAt": "2023-01-04T22:39:34.2606750Z",
"lastModifiedAt": "2023-01-05T22:39:34.2606750Z"
}
}
Tanımlar
Name | Description |
---|---|
Amount |
Miktar. |
Auto |
Bir ürün için otomatik yenilemenin açık mı yoksa kapalı mı olduğunu gösterir. |
Beneficiary |
Lehdarın ayrıntıları. |
Billing |
Aboneliğin faturalama özellikleri. |
Billing |
Abonelikte bir işlemin durumu. Yok olduğunda, devam eden bir işlem yoktur. LockedForUpdate olduğunda, Faturalama Aboneliğinde yazma işlemleri engellenir. Diğer varsayılan değerdir ve daha fazla ayrıntı için en son API sürümüne başvurmanız gerekebilir. |
Billing |
Aboneliğin durumu. Bu alan Kurumsal Anlaşma ödeme hesapları için kullanılamaz |
Billing |
Aboneliğin askıya alma ayrıntıları. Bu alan Kurumsal Anlaşma ödeme hesapları için kullanılamaz. |
Cancellation |
Abonelik için ilke geçersiz kılma, self servis iptaline veya koltuk azaltmaya izin verilip verilmediğini gösterir. |
created |
Kaynağı oluşturan kimliğin türü. |
Error |
Kaynak yönetimi hatası ek bilgileri. |
Error |
Hata ayrıntısı. |
Error |
Hata yanıtı |
Next |
Ürünün faturalama dönemi ayrıntıları. |
Provisioning |
Uzun süre çalışan bir işlem sırasında kaynağın sağlama durumu. |
Renewal |
Aboneliğin bir sonraki yenileme döneminin ayrıntıları. |
Reseller |
Satıcının ayrıntıları. |
Subscription |
Aboneliğin geçerli kayıt hesabı durumu. Bu alan yalnızca Kurumsal Anlaşma Türü için kullanılabilir. |
Subscription |
Aboneliğin askıya alınma nedeni. Bu alan Kurumsal Anlaşma ödeme hesapları için kullanılamaz. |
system |
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler. |
System |
Sistem tarafından uygulanan ve aboneliğin davranışını düzenleyen ilkeler. |
Amount
Miktar.
Name | Tür | Description |
---|---|---|
currency |
string |
Tutar değerinin para birimi. |
value |
number |
Tutar değeri. Örneğin, para birimi ABD doları ise 600 ABD doları değeri 600,00 TL olacaktır. |
AutoRenew
Bir ürün için otomatik yenilemenin açık mı yoksa kapalı mı olduğunu gösterir.
Name | Tür | Description |
---|---|---|
Off |
string |
|
On |
string |
Beneficiary
Lehdarın ayrıntıları.
Name | Tür | Description |
---|---|---|
objectId |
string |
Kiracıdaki bir kullanıcıyı benzersiz olarak tanımlayan kimlik. |
tenantId |
string |
Bir kiracıyı benzersiz olarak tanımlayan kimlik. |
BillingSubscription
Aboneliğin faturalama özellikleri.
Name | Tür | Description |
---|---|---|
id |
string |
Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
Kaynağın adı |
properties.autoRenew |
Bir ürün için otomatik yenilemenin açık mı yoksa kapalı mı olduğunu gösterir. |
|
properties.beneficiary |
Faturalama aboneliğinin yararlanıcısı. |
|
properties.beneficiaryTenantId |
string |
Aboneliğin sağlama kiracısı. |
properties.billingFrequency |
string |
Abonelikteki ürünün ISO8601 biçiminde faturalama sıklığı. Örnek: P1M, P3M, P1Y |
properties.billingPolicies |
object |
Abonelikle ilişkili faturalama ilkeleri sözlüğü. |
properties.billingProfileDisplayName |
string |
Faturalama profilinin adı. |
properties.billingProfileId |
string |
Faturalama profilini benzersiz olarak tanımlayan tam kimlik. |
properties.billingProfileName |
string |
Faturalama profilini benzersiz olarak tanımlayan kimlik. |
properties.consumptionCostCenter |
string |
Aboneliğe uygulanan maliyet merkezi. Bu alan yalnızca Microsoft Müşteri Sözleşmesi veya Kurumsal Anlaşma Türü faturalama hesaplarının tüketim abonelikleri için kullanılabilir. |
properties.customerDisplayName |
string |
Müşterinin adı. |
properties.customerId |
string |
Bir müşteriyi benzersiz olarak tanımlayan tam kimlik. |
properties.customerName |
string |
Bir müşteriyi benzersiz olarak tanımlayan kimlik. |
properties.displayName |
string |
Faturalama aboneliğinin adı. |
properties.enrollmentAccountDisplayName |
string |
Abonelikle ilişkili kayıt Hesabı adı. Bu alan yalnızca Kurumsal Anlaşma Türü faturalama hesapları için kullanılabilir. |
properties.enrollmentAccountId |
string |
Abonelikle ilişkili kayıt Hesabı Kimliği. Bu alan yalnızca Kurumsal Anlaşma Türü faturalama 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 Türü için kullanılabilir. |
properties.enrollmentAccountSubscriptionDetails.subscriptionEnrollmentAccountStatus |
Aboneliğin geçerli kayıt hesabı durumu. Bu alan yalnızca Kurumsal Anlaşma Türü için kullanılabilir. |
|
properties.invoiceSectionDisplayName |
string |
Fatura bölümünün adı. |
properties.invoiceSectionId |
string |
Bir fatura bölümünü benzersiz olarak tanımlayan tam kimlik. |
properties.invoiceSectionName |
string |
Bir fatura bölümünü benzersiz olarak tanımlayan kimlik. |
properties.lastMonthCharges |
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 |
Geçerli aydan bugüne kadarki ücretler. Bu alan yalnızca Microsoft Müşteri Sözleşmesi ödeme hesaplarının kullanım tabanlı abonelikleri için kullanılabilir. |
|
properties.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.operationStatus |
Abonelikte bir işlemin durumu. Yok olduğunda, devam eden bir işlem yoktur. LockedForUpdate olduğunda, Faturalama Aboneliğinde yazma işlemleri engellenir. Diğer varsayılan değerdir ve daha fazla ayrıntı için en son API sürümüne başvurmanız gerekebilir. |
|
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.provisioningState |
Uzun süre çalışan bir işlem sırasında kaynağın sağlama durumu. |
|
properties.provisioningTenantId |
string |
Aboneliğin sağlandığı kiracı. |
properties.purchaseDate |
string |
Ürünün UTC saatiyle satın alma tarihi. |
properties.quantity |
integer |
Abonelik için lisans veya karşılama birimi miktarı. |
properties.renewalTermDetails |
Aboneliğin bir sonraki yenileme döneminin ayrıntıları. |
|
properties.reseller |
Bu abonelik için kurumsal bayi. Alanlar Microsoft İş Ortağı Sözleşmesi ödeme hesaplarında kullanılamaz. |
|
properties.resourceUri |
string |
Bağlı kaynağın benzersiz tanımlayıcısı. |
properties.skuDescription |
string |
Aboneliğin satın alındığı ürünün SKU açıklaması. Bu alan yalnızca Sözleşme türü Microsoft Müşteri Sözleşmesi ve Microsoft İş Ortağı Sözleşmesi olan ö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 |
Aboneliğin durumu. Bu alan Kurumsal Anlaşma ödeme hesapları için kullanılamaz |
|
properties.subscriptionId |
string |
Aboneliğin kimliği. |
properties.suspensionReasonDetails |
Aboneliğin askıya alma ayrıntıları. Bu alan Kurumsal Anlaşma ödeme hesapları için kullanılamaz. |
|
properties.suspensionReasons |
string[] |
Aboneliğin askıya alınma nedeni. Bu alan Kurumsal Anlaşma ödeme hesapları için kullanılamaz. |
properties.systemOverrides |
Sistem tarafından uygulanan ve aboneliğin davranışını düzenleyen ilkeler. |
|
properties.termDuration |
string |
Aboneliği kullanabileceğiniz ISO8601 biçimdeki süre. Örnek: P1M, P3M, P1Y |
properties.termEndDate |
string |
Utc saatinde terimin bitiş tarihi. |
properties.termStartDate |
string |
Utc saatinde terimin başlangıç tarihi. |
systemData |
createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri. |
|
tags |
object |
Kaynakla ilişkilendirilmiş meta verilerin sözlüğü. Tüm kaynak türleri için doldurulmayabilir. Desteklenen en fazla anahtar/değer uzunluğu 256 karakterdir. Anahtarlar/değer boş değer veya null olmamalıdır. Anahtarlar <> % & \ ? içeremez / |
type |
string |
Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts" |
BillingSubscriptionOperationStatus
Abonelikte bir işlemin durumu. Yok olduğunda, devam eden bir işlem yoktur. LockedForUpdate olduğunda, Faturalama Aboneliğinde yazma işlemleri engellenir. Diğer varsayılan değerdir ve daha fazla ayrıntı için en son API sürümüne başvurmanız gerekebilir.
Name | Tür | Description |
---|---|---|
LockedForUpdate |
string |
|
None |
string |
|
Other |
string |
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 |
|
Failed |
string |
|
Other |
string |
|
Suspended |
string |
|
Unknown |
string |
|
Warned |
string |
BillingSubscriptionStatusDetails
Aboneliğin askıya alma ayrıntıları. Bu alan Kurumsal Anlaşma ödeme hesapları için kullanılamaz.
Name | Tür | Description |
---|---|---|
effectiveDate |
string |
Aboneliğin askıya alma geçerlilik tarihi. Bu alan Kurumsal Anlaşma ödeme hesapları için kullanılamaz. |
reason |
Aboneliğin askıya alınma nedeni. Bu alan Kurumsal Anlaşma ödeme hesapları için kullanılamaz. |
Cancellation
Abonelik için ilke geçersiz kılma, self servis iptaline veya koltuk azaltmaya izin verilip verilmediğini gösterir.
Name | Tür | Description |
---|---|---|
Allowed |
string |
|
NotAllowed |
string |
createdByType
Kaynağı oluşturan kimliğin türü.
Name | Tür | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Kaynak yönetimi hatası ek bilgileri.
Name | Tür | Description |
---|---|---|
info |
object |
Ek bilgiler. |
type |
string |
Ek bilgi türü. |
ErrorDetail
Hata ayrıntısı.
Name | Tür | Description |
---|---|---|
additionalInfo |
Hata ek bilgileri. |
|
code |
string |
Hata kodu. |
details |
Hata ayrıntıları. |
|
message |
string |
Hata iletisi. |
target |
string |
Hata hedefi. |
ErrorResponse
Hata yanıtı
Name | Tür | Description |
---|---|---|
error |
Hata nesnesi. |
NextBillingCycleDetails
Ürünün faturalama dönemi ayrıntıları.
Name | Tür | Description |
---|---|---|
billingFrequency |
string |
Aboneliğin altındaki ürünün faturalama sıklığı. |
ProvisioningState
Uzun süre çalışan bir işlem sırasında kaynağın sağlama durumu.
Name | Tür | Description |
---|---|---|
Canceled |
string |
|
Failed |
string |
|
New |
string |
|
Pending |
string |
|
Provisioning |
string |
|
Succeeded |
string |
RenewalTermDetails
Aboneliğin bir sonraki yenileme döneminin ayrıntıları.
Name | Tür | Description |
---|---|---|
billingFrequency |
string |
Abonelikteki ürünün ISO8601 biçiminde faturalama sıklığı. Örnek: P1M, P3M, P1Y |
productId |
string |
Aboneliğin satın alındığı ürünün kimliği. |
productTypeId |
string |
Aboneliğin satın alındığı ürünün türü. |
quantity |
integer |
Abonelik için lisans veya karşılama birimi miktarı. |
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. |
termDuration |
string |
Aboneliği kullanabileceğiniz ISO8601 biçimdeki süre. Örnek: P1M, P3M, P1Y |
termEndDate |
string |
Utc saatinde terimin bitiş tarihi. |
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 Türü için kullanılabilir.
Name | Tür | Description |
---|---|---|
Active |
string |
|
Cancelled |
string |
|
Deleted |
string |
|
Expired |
string |
|
Inactive |
string |
|
TransferredOut |
string |
|
Transferring |
string |
SubscriptionStatusReason
Aboneliğin askıya alınma nedeni. Bu alan Kurumsal Anlaşma ödeme hesapları için kullanılamaz.
Name | Tür | Description |
---|---|---|
Cancelled |
string |
|
Expired |
string |
|
None |
string |
|
Other |
string |
|
PastDue |
string |
|
PolicyViolation |
string |
|
SpendingLimitReached |
string |
|
SuspiciousActivity |
string |
|
Transferred |
string |
systemData
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
Name | Tür | Description |
---|---|---|
createdAt |
string |
Kaynak oluşturma (UTC) zaman damgası. |
createdBy |
string |
Kaynağı oluşturan kimlik. |
createdByType |
Kaynağı oluşturan kimliğin türü. |
|
lastModifiedAt |
string |
Kaynağın son değişikliğinin zaman damgası (UTC) |
lastModifiedBy |
string |
Kaynağı en son değiştiren kimlik. |
lastModifiedByType |
Kaynağı en son değiştiren kimlik türü. |
SystemOverrides
Sistem tarafından uygulanan ve aboneliğin davranışını düzenleyen ilkeler.
Name | Tür | Description |
---|---|---|
cancellation |
Abonelik için ilke geçersiz kılma, self servis iptaline veya koltuk azaltmaya izin verilip verilmediğini gösterir. |
|
cancellationAllowedEndDate |
string |
Self servis iptalin sona erdiği utc saatiyle bitiş tarihi. |