Savings Plans - Get By Billing Account

Hizmet:: Billing

API Sürümü:: 2024-04-01

Ödeme hesabına göre tasarruf planını alın.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/savingsPlanOrders/{savingsPlanOrderId}/savingsPlans/{savingsPlanId}?api-version=2024-04-01

İsteğe bağlı parametrelerle:

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/savingsPlanOrders/{savingsPlanOrderId}/savingsPlans/{savingsPlanId}?api-version=2024-04-01&expand={expand}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
billingAccountName	path	True	string pattern: ^([0-9]+\|([Pp][Cc][Nn]\.[A-Za-z0-9]+)\|[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}(:[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}_[0-9]{4}(-[0-9]{2}){2})?)$	Bir ödeme hesabını benzersiz olarak tanımlayan kimlik.
savingsPlanId	path	True	string	Tasarruf planının kimliği
savingsPlanOrderId	path	True	string	Tasarruf planının sipariş kimliği
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.
expand	query		string	planInformation'ı genişletmek için kullanılabilir.

Yanıtlar

Name	Tür	Description
200 OK	SavingsPlanModel	Azure işlemi başarıyla tamamlandı.
Other Status Codes	ErrorResponse	Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

SavingsPlanGet

SavingsPlanGetExpandRenewProperties

SavingsPlanGet

Örnek isteği

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/savingsPlanOrders/20000000-0000-0000-0000-000000000000/savingsPlans/30000000-0000-0000-0000-000000000000?api-version=2024-04-01

Örnek yanıt

Durum kodu:: 200

{
  "name": "30000000-0000-0000-0000-000000000000",
  "type": "microsoft.billing/billingAccounts/savingsPlanOrders/savingsPlans",
  "id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/savingsPlanOrders/20000000-0000-0000-0000-000000000000/savingsPlans/30000000-0000-0000-0000-000000000000",
  "properties": {
    "appliedScopeProperties": {
      "displayName": "TestRg",
      "managementGroupId": "/providers/Microsoft.Management/managementGroups/TestRg",
      "tenantId": "70000000-0000-0000-0000-000000000000"
    },
    "appliedScopeType": "ManagementGroup",
    "benefitStartTime": "2022-11-16T02:25:11.7183866Z",
    "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
    "billingPlan": "P1M",
    "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/AAAA-BBBB-CCC-DDD",
    "billingScopeId": "/subscriptions/50000000-0000-0000-0000-000000000000",
    "commitment": {
      "amount": 0.001,
      "currencyCode": "USD",
      "grain": "Hourly"
    },
    "displayName": "SP1",
    "displayProvisioningState": "NoBenefit",
    "effectiveDateTime": "2022-12-16T01:35:36.2909462Z",
    "expiryDateTime": "2025-11-16T02:25:11.7183866Z",
    "productCode": "20000000-0000-0000-0000-000000000005",
    "provisioningState": "Succeeded",
    "purchaseDateTime": "2022-11-16T02:23:21.3864783Z",
    "renew": false,
    "term": "P3Y",
    "userFriendlyAppliedScopeType": "ManagementGroup",
    "utilization": {
      "aggregates": [
        {
          "grain": 1,
          "grainUnit": "days",
          "value": 0,
          "valueUnit": "percentage"
        },
        {
          "grain": 7,
          "grainUnit": "days",
          "value": 0,
          "valueUnit": "percentage"
        },
        {
          "grain": 30,
          "grainUnit": "days",
          "value": 0,
          "valueUnit": "percentage"
        }
      ],
      "trend": "SAME"
    }
  },
  "sku": {
    "name": "Compute_Savings_Plan"
  },
  "tags": {
    "key1": "value1",
    "key2": "value2"
  }
}

SavingsPlanGetExpandRenewProperties

Örnek isteği

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/savingsPlanOrders/20000000-0000-0000-0000-000000000000/savingsPlans/30000000-0000-0000-0000-000000000000?api-version=2024-04-01

Örnek yanıt

Durum kodu:: 200

{
  "name": "30000000-0000-0000-0000-000000000000",
  "type": "microsoft.billing/billingAccounts/savingsPlanOrders/savingsPlans",
  "id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/savingsPlanOrders/20000000-0000-0000-0000-000000000000/savingsPlans/30000000-0000-0000-0000-000000000000",
  "properties": {
    "appliedScopeProperties": {
      "displayName": "TestRg",
      "managementGroupId": "/providers/Microsoft.Management/managementGroups/TestRg",
      "tenantId": "70000000-0000-0000-0000-000000000000"
    },
    "appliedScopeType": "ManagementGroup",
    "benefitStartTime": "2022-11-16T02:25:11.7183866Z",
    "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
    "billingPlan": "P1M",
    "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/AAAA-BBBB-CCC-DDD",
    "billingScopeId": "/subscriptions/50000000-0000-0000-0000-000000000000",
    "commitment": {
      "amount": 0.001,
      "currencyCode": "USD",
      "grain": "Hourly"
    },
    "displayName": "SP1",
    "displayProvisioningState": "NoBenefit",
    "effectiveDateTime": "2022-12-16T01:35:36.2909462Z",
    "expiryDateTime": "2025-11-16T02:25:11.7183866Z",
    "productCode": "20000000-0000-0000-0000-000000000005",
    "provisioningState": "Succeeded",
    "purchaseDateTime": "2022-11-16T02:23:21.3864783Z",
    "renew": false,
    "renewProperties": {
      "purchaseProperties": {
        "properties": {
          "appliedScopeProperties": {
            "managementGroupId": "/providers/Microsoft.Management/managementGroups/TestRg",
            "tenantId": "70000000-0000-0000-0000-000000000000"
          },
          "appliedScopeType": "ManagementGroup",
          "billingPlan": "Monthly",
          "billingScopeId": "/subscriptions/50000000-0000-0000-0000-000000000000",
          "commitment": {
            "amount": 0.001,
            "currencyCode": "USD",
            "grain": "Hourly"
          },
          "displayName": "SP1_renewed",
          "term": "P3Y"
        },
        "sku": {
          "name": "Compute_Savings_Plan"
        }
      }
    },
    "term": "P3Y",
    "userFriendlyAppliedScopeType": "ManagementGroup",
    "utilization": {
      "aggregates": [
        {
          "grain": 1,
          "grainUnit": "days",
          "value": 0,
          "valueUnit": "percentage"
        },
        {
          "grain": 7,
          "grainUnit": "days",
          "value": 0,
          "valueUnit": "percentage"
        },
        {
          "grain": 30,
          "grainUnit": "days",
          "value": 0,
          "valueUnit": "percentage"
        }
      ],
      "trend": "SAME"
    }
  },
  "sku": {
    "name": "Compute_Savings_Plan"
  },
  "tags": {
    "key1": "value1",
    "key2": "value2"
  }
}

Tanımlar

Name	Description
AppliedScopeProperties	Uygulanan kapsam türüne özgü özellikler. Geçerli değilse gerekli değildir.
AppliedScopeType	Uygulanan Kapsamın türü.
BillingPlan	Faturalama planını ISO 8601 biçiminde temsil eder. Yalnızca aylık satın almalar için gereklidir.
Commitment	Avantaja bağlılık.
CommitmentGrain	Taahhüt dilimi.
createdByType	Kaynağı oluşturan kimliğin türü.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
ExtendedStatusInfo	Genişletilmiş durum bilgileri
ProvisioningState	Uzun süreli bir operasyon sırasında kaynağın sağlama durumu.
PurchaseRequest	Satın alma isteği.
RenewProperties	Yenilemeye özgü özellikler.
SavingsPlanModel	Tasarruf planı
SavingsPlanTerm	Tasarruf planı terimini ISO 8601 biçiminde temsil eder.
Sku	Bu kaynak için uygulanacak SKU
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
Utilization	Tasarruf planı kullanımı
UtilizationAggregates	Tasarruf planı kullanımının toplam değerleri

AppliedScopeProperties

Nesne

Uygulanan kapsam türüne özgü özellikler. Geçerli değilse gerekli değildir.

Name	Tür	Description
displayName	string	Görünen ad
managementGroupId	string	Avantajın uygulandığı yönetim grubunun tam tanımlayıcısı.
resourceGroupId	string	Avantajın uygulandığı kaynak grubunun tam tanımlayıcısı.
subscriptionId	string	Avantajın uygulandığı aboneliğin tam tanımlayıcısı.
tenantId	string	Avantajın uygulandığı tasarruf planının bulunduğu Kiracı Kimliği.

AppliedScopeType

Numaralandırma

Uygulanan Kapsamın türü.

Değer	Description
Single	Single
Shared	Shared
ManagementGroup	ManagementGroup

BillingPlan

Numaralandırma

Faturalama planını ISO 8601 biçiminde temsil eder. Yalnızca aylık satın almalar için gereklidir.

Değer	Description
P1M	P1M

Commitment

Nesne

Avantaja bağlılık.

Name	Tür	Description
amount	number (double)
currencyCode	string	Bu satın alma kaydı tarafından kullanılan para birimi için ISO 4217 3 harfli para birimi kodu.
grain	CommitmentGrain	Taahhüt dilimi.

CommitmentGrain

Numaralandırma

Taahhüt dilimi.

Değer	Description
Hourly	Saatlik

createdByType

Numaralandırma

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

Değer	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Nesne

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

Nesne

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

ExtendedStatusInfo

Nesne

Genişletilmiş durum bilgileri

Name	Tür	Description
message	string	Durum kodu hakkında ayrıntılı bilgi veren ileti.
properties.subscriptionId	string	Kredi satırı denetimi başarısız olan abonelik.
statusCode	string	Ek bilgi sağlayan durum kodu.

ProvisioningState

Numaralandırma

Uzun süreli bir operasyon sırasında kaynağın sağlama durumu.

Değer	Description
Succeeded	Succeeded
Canceled	İptal edildi
Failed	Başarısız oldu
New	Yeni
Pending	Beklemede
Provisioning	Provisioning
PendingBilling	Bekleme
ConfirmedBilling	Onaylanmış Faturalama
Creating	Oluşturma
Created	Oluşturuldu
Expired	Süresi doldu

PurchaseRequest

Nesne

Satın alma isteği.

Name	Tür	Default value	Description
properties.appliedScopeProperties	AppliedScopeProperties		Uygulanan kapsam türüne özgü özellikler. Geçerli değilse gerekli değildir.
properties.appliedScopeType	AppliedScopeType		Uygulanan Kapsamın türü.
properties.billingPlan	BillingPlan		Faturalama planını ISO 8601 biçiminde temsil eder. Yalnızca aylık satın almalar için gereklidir.
properties.billingScopeId	string		SavingsPlan satın almak için ücretlendirilecek abonelik
properties.commitment	Commitment		Avantaja bağlılık.
properties.displayName	string		Tasarruf planının kolay adı
properties.renew	boolean	False	Bunu true olarak ayarlamak, son kullanma tarihi saatinde otomatik olarak yeni bir avantaj satın alır.
properties.term	SavingsPlanTerm		Tasarruf planı terimini ISO 8601 biçiminde temsil eder.
sku	Sku		Bu kaynak için uygulanacak SKU

RenewProperties

Nesne

Yenilemeye özgü özellikler.

Name	Tür	Description
purchaseProperties	PurchaseRequest	Satın alma isteği.

SavingsPlanModel

Nesne

Tasarruf planı

Name	Tür	Default value	Description
id	string (arm-id)		Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string		Kaynağın adı
properties.appliedScopeProperties	AppliedScopeProperties		Uygulanan kapsam türüne özgü özellikler. Geçerli değilse gerekli değildir.
properties.appliedScopeType	AppliedScopeType		Uygulanan Kapsamın türü.
properties.benefitStartTime	string (date-time)		Bu, tasarruf planı avantajının başladığı Tarih Saat'tir.
properties.billingAccountId	string		Tasarruf planının uygulandığı ödeme hesabının tam tanımlayıcısı.
properties.billingPlan	BillingPlan		Faturalama planını ISO 8601 biçiminde temsil eder. Yalnızca aylık satın almalar için gereklidir.
properties.billingProfileId	string		Tasarruf planının uygulandığı faturalama profilinin tam tanımlayıcısı. Yalnızca Alan liderliğinde veya Müşteri liderliğinde müşteriler için sunulur.
properties.billingScopeId	string		SavingsPlan satın almak için ücretlendirilecek abonelik
properties.commitment	Commitment		Avantaja bağlılık.
properties.customerId	string		Tasarruf planının uygulandığı müşterinin tam tanımlayıcısı. Yalnızca İş ortağı tarafından yönetilen müşteriler için sunulur.
properties.displayName	string		Görünen ad
properties.displayProvisioningState	string		Görüntüleme için tasarruf planının sağlama durumu, örneğin Başarılı
properties.effectiveDateTime	string (date-time)		Bu sürüm geçerli olduğunda başlayan tasarruf planının DateTime değeri.
properties.expiryDateTime	string (date-time)		Bu, tasarruf planının süresinin dolacağı tarih-saattir.
properties.extendedStatusInfo	ExtendedStatusInfo		Genişletilmiş durum bilgileri
properties.productCode	string		UPN'i temsil eder
properties.provisioningState	ProvisioningState		Uzun süreli bir operasyon sırasında kaynağın sağlama durumu.
properties.purchaseDateTime	string (date-time)		Tasarruf planının satın alındığı tarih.
properties.renew	boolean	False	Bunu true olarak ayarlamak, son kullanma tarihi saatinde otomatik olarak yeni bir avantaj satın alır.
properties.renewDestination	string		Yenileme nedeniyle satın alınan SavingsPlan'ın SavingsPlan Kimliği.
properties.renewProperties	RenewProperties		Yenilemeye özgü özellikler.
properties.renewSource	string		Bu SavingsPlan'ın yenilendiği SavingsPlan'ın SavingsPlan Kimliği.
properties.term	SavingsPlanTerm		Tasarruf planı terimini ISO 8601 biçiminde temsil eder.
properties.userFriendlyAppliedScopeType	string		Görüntüleme için tasarruf planının uygulanan kapsam türü, örneğin Paylaşılan
properties.utilization	Utilization		Tasarruf planı kullanımı
sku	Sku		Tasarruf planı SKU'su
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"

SavingsPlanTerm

Numaralandırma

Tasarruf planı terimini ISO 8601 biçiminde temsil eder.

Değer	Description
P1Y	P1Y
P3Y	P3Y
P5Y	P5Y

Sku

Nesne

Bu kaynak için uygulanacak SKU

Name	Tür	Description
name	string	Uygulanacak SKU'nun adı

systemData

Nesne

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

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	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ü.

Utilization

Nesne

Tasarruf planı kullanımı

Name	Tür	Description
aggregates	UtilizationAggregates[]	Bir tasarruf planının kullanım toplamları dizisi
trend	string	Tasarruf planının kullanımına yönelik eğilim

UtilizationAggregates

Nesne

Tasarruf planı kullanımının toplam değerleri

Name	Tür	Description
grain	number (float)	Toplamanın dilimi
grainUnit	string	Toplamanın tane birimi
value	number (float)	Toplama değeri
valueUnit	string	Toplama değeri birimi

Aracılığıyla paylaş

Savings Plans - Get By Billing Account

URI Parametreleri

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Örnekler

SavingsPlanGet

Örnek isteği

Örnek yanıt

SavingsPlanGetExpandRenewProperties

Örnek isteği

Örnek yanıt

Tanımlar

AppliedScopeProperties

AppliedScopeType

BillingPlan

Commitment

CommitmentGrain

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedStatusInfo

ProvisioningState

PurchaseRequest

RenewProperties

SavingsPlanModel

SavingsPlanTerm

Sku

systemData

Utilization

UtilizationAggregates