Aracılığıyla paylaş


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
billingAccountName
path True

string

Bir ödeme hesabını benzersiz olarak tanımlayan kimlik.

billingSubscriptionName
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

Reseller, ConsumptionCostCenter, LastMonthCharges ve MonthToDateCharges genişletmek için kullanılabilir

Yanıtlar

Name Tür Description
200 OK

BillingSubscription

Faturalama aboneliği.

Other Status Codes

ErrorResponse

İş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.

AutoRenew

Bir ürün için otomatik yenilemenin açık mı yoksa kapalı mı olduğunu gösterir.

Beneficiary

Lehdarın ayrıntıları.

BillingSubscription

Aboneliğin faturalama özellikleri.

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.

BillingSubscriptionStatus

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

BillingSubscriptionStatusDetails

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.

createdByType

Kaynağı oluşturan kimliğin türü.

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

ErrorDetail

Hata ayrıntısı.

ErrorResponse

Hata yanıtı

NextBillingCycleDetails

Ürünün faturalama dönemi ayrıntıları.

ProvisioningState

Uzun süre çalışan bir işlem sırasında kaynağın sağlama durumu.

RenewalTermDetails

Aboneliğin bir sonraki yenileme döneminin 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 Türü için kullanılabilir.

SubscriptionStatusReason

Aboneliğin askıya alınma nedeni. Bu alan Kurumsal Anlaşma ödeme hesapları için kullanılamaz.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

SystemOverrides

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

AutoRenew

Bir ürün için otomatik yenilemenin açık mı yoksa kapalı mı olduğunu gösterir.

properties.beneficiary

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

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

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 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

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

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.

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

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

RenewalTermDetails

Aboneliğin bir sonraki yenileme döneminin ayrıntıları.

properties.reseller

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

BillingSubscriptionStatus

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

properties.subscriptionId

string

Aboneliğin kimliği.

properties.suspensionReasonDetails

BillingSubscriptionStatusDetails[]

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

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

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

SubscriptionStatusReason

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

ErrorAdditionalInfo[]

Hata ek bilgileri.

code

string

Hata kodu.

details

ErrorDetail[]

Hata ayrıntıları.

message

string

Hata iletisi.

target

string

Hata hedefi.

ErrorResponse

Hata yanıtı

Name Tür Description
error

ErrorDetail

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

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

createdByType

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

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.