Billing Subscriptions - Get
Kimliğine göre bir abonelik alır. İş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/{billingSubscriptionName}?api-version=2021-10-01
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 2021-10-01'dir. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Tamam ögesini seçin. İstek başarılı oldu. |
|
Other Status Codes |
İş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
BillingSubscription
Sample Request
Sample Response
{
"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"
}
}
Tanımlar
Name | Description |
---|---|
Amount |
Miktar. |
Auto |
Abonelik için otomatik yenilemenin açık mı yoksa kapalı mı olduğunu gösterir. |
Billing |
Faturalama aboneliği. |
Billing |
Aboneliğin durumu. Bu alan Kurumsal Anlaşma ödeme hesapları için kullanılamaz. |
Error |
Hatanın ayrıntıları. |
Error |
Hata yanıtı, hizmetin gelen isteği işleyemediğini gösterir. Nedeni hata iletisinde verilmiştir. |
Error |
Hatanın alt ayrıntıları. |
Next |
Aboneliğin sonraki faturalama dönemi ayrıntıları. |
Renewal |
Yenileme sırasında aboneliğin terim 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 ö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 |
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 |
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 |
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 ü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 |
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 |
Bir sonraki yenilemede aboneliğin terim ayrıntıları. |
|
properties.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 |
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ü. |
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 |
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 |
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 |