Tüm Ürünler
Search
Belge Merkezi

:PurchaseReservedInstancesOffering

Son Güncelleme:Sep 29, 2026

Ayrılmış örnek satın alır. Ayrılmış örnekler, kullandıkça öde örneklerle otomatik olarak eşleşerek bu örneklerin faturalarını mahsup eder.

Açıklama

  • Bu işlemi çağırmadan önce ayrılmış örneklerin faturalandırma yöntemini tam olarak anladığınızdan emin olun. Daha fazla bilgi için bkz. Ayrılmış örnekler.

  • Ayrılmış örnek satın almadan önce mevcut kaynakları sorgulamak için DescribeAvailableResource işlemini çağırabilirsiniz.

Hata Ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için örnek kodu dinamik olarak oluşturur.

İstek parametreleri

ParametreTürZorunluÖrnekAçıklama
ActionStringEvetPurchaseReservedInstancesOffering

Gerçekleştirmek istediğiniz işlem. Değeri PurchaseReservedInstancesOffering olarak ayarlayın.

RegionIdStringEvetcn-hangzhou

Ayrılmış örneğin satın alınacağı bölgenin kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

Tag.N.KeyStringHayırTestKey

Ayrılmış örneğe eklenecek N. etiketin anahtarı. N için geçerli değerler: 1 ile 20. Etiket anahtarı boş bir dize olamaz. Uzunluğu en fazla 128 karakter olabilir ve http:// veya https:// içeremez. acs: veya aliyun ile başlayamaz.

Tag.N.ValueStringHayırTestValue

Ayrılmış örneğe eklenecek N. etiketin değeri. N için geçerli değerler: 1 ile 20. Etiket değeri boş bir dize olamaz. Uzunluğu en fazla 128 karakter olabilir ve http:// veya https:// içeremez. acs: veya aliyun ile başlayamaz.

ResourceGroupIdStringHayırrg-bp199lyny9b3****

Kaynak grubunun kimliği.

ZoneIdStringHayırcn-hangzhou-g

Ayrılmış örneğin satın alınacağı alanın kimliği. Scope parametresi Zone olarak ayarlandığında bu parametre zorunludur. En güncel alan listesini sorgulamak için DescribeZones işlemini çağırabilirsiniz.

ReservedInstanceNameStringHayırtestReservedInstanceName

Ayrılmış örneğin adı. Ad 2 ila 128 karakter uzunluğunda olmalıdır. Bir harfle başlamalı ve http:// veya https:// ile başlayamaz. Ad rakam, harf, iki nokta üst üste (:), alt çizgi (_) ve tire (-) içerebilir.

InstanceTypeStringEvetecs.g5.large

Örnek türü. Daha fazla bilgi için bkz. Örnek aileleri.

ScopeStringHayırZone

Ayrılmış örneğin kapsamı. Geçerli değerler:

  • Region: bölgesel
  • Zone: alansal

Varsayılan değer: Region.

InstanceAmountIntegerHayır3

Ayrılmış örneğin aynı anda eşlenebileceği, aynı örnek türüne sahip kullandıkça öde örneklerinin sayısı. Geçerli değerler: 1 ila 50.

Örneğin, InstanceType ecs.g5.large olarak ayarlandığında InstanceAmount 3 olarak belirlenirse, ayrılmış örnek aynı anda üç adet ecs.g5.large kullandıkça öde örnekle eşleşebilir.

OfferingTypeStringHayırAll Upfront

Ayrılmış örneğin ödeme seçeneği. Geçerli değerler:

  • No Upfront
  • Partial Upfront
  • All Upfront

Varsayılan değer: All Upfront.

DescriptionStringHayırtestDescription

Ayrılmış örneğin açıklaması. Açıklama 2 ila 256 karakter uzunluğunda olmalı ve http:// veya https:// ile başlayamaz.

Bu parametre varsayılan olarak boştur.

PlatformStringHayırLinux

Örnek tarafından kullanılan görüntünün işletim sistemi. Geçerli değerler:

  • Windows: Windows Server işletim sistemi
  • Linux: Linux ve UNIX benzeri işletim sistemi

Varsayılan değer: Linux.

PeriodIntegerHayır1

Ayrılmış örneğin süresi.

Geçerli değerler: 1 ve 3.

Varsayılan değer: 1.

PeriodUnitStringHayırYear

Ayrılmış örneğin süresinin birimi.

Geçerli değer: Year.

Varsayılan değer: Year.

ClientTokenStringHayır123e4567-e89b-12d3-a456-426655440000

İsteğin yinelenmezliğini (idempotence) sağlamak için kullanılan istemci belirteci. Değeri istemci tarafında üretebilirsiniz ancak farklı istekler arasında benzersiz olduğundan emin olmalısınız. ClientToken değeri yalnızca ASCII karakterleri içerebilir ve uzunluğu 64 karakteri aşamaz. Daha fazla bilgi için bkz. Yinelenmezlik nasıl sağlanır.

AutoRenewBooleanHayırtrue

Ayrılmış örnek için otomatik yenilemenin etkinleştirilip etkinleştirilmeyeceğini belirtir.

true: Ayrılmış örnek için otomatik yenilemeyi etkinleştirir. false: Ayrılmış örnek için otomatik yenilemeyi etkinleştirmez.

AutoRenewPeriodIntegerHayır1

Ayrılmış örneğin otomatik yenileme süresi. Bu parametre yalnızca AutoRenew true olarak ayarlandığında etkili olur.

Geçerli değerler: 12, 36.

PeriodUnit Year olarak ayarlandığında varsayılan değer: 12

Yanıt parametreleri

Parametre Tür Örnek Açıklama
RequestId String 8C314443-AF0D-4766-9562-C83B7F1A3C8B


İsteğin kimliği.

ReservedInstanceIdSets Array of String ecsri-2ze53qonjqxg7r****


Ayrılmış örneklerin kimlikleri.

Örnekler

Örnek istekler

https://ecs.aliyuncs.com/?Action=PurchaseReservedInstancesOffering
&RegionId=cn-hangzhou
&Scope=Zone
&ZoneId=cn-hangzhou-a
&ReservedInstanceName=test
&InstanceType=ecs.g5.2xlarge
&InstanceAmount=1
&OfferingType=AllUpfront
&Period=1
&PeriodUnit=Year
&<Common request parameters>

Başarılı yanıt örnekleri

XML biçimi

HTTP/1.1 200 OK
Content-Type:application/xml

<PurchaseReservedInstancesOfferingResponse>
    <RequestId>8C314443-AF0D-4766-9562-C83B7F1A3C8B</RequestId>
    <ReservedInstanceIdSets>
        <ReservedInstanceId>ecsri-2ze53qonjqxg7r****</ReservedInstanceId>
    </ReservedInstanceIdSets>
</PurchaseReservedInstancesOfferingResponse>

JSON biçimi

HTTP/1.1 200 OK
Content-Type:application/json

{
  "ReservedInstanceIdSets" : {
    "ReservedInstanceId" : [ "ecsri-2ze53qonjqxg7r****" ]
  },
  "RequestId" : "8C314443-AF0D-4766-9562-C83B7F1A3C8B"
}

Hata kodları

HTTP durum kodu Hata kodu Hata mesajı Açıklama
400 InvalidInstanceType.ValueUnauthorized The specified InstanceType is not authorized. Belirtilen örnek türünü kullanma yetkiniz olmadığından hata döndürüldü.
400 InvalidDescription.Malformed The specified parameter "Description" is not valid. Belirtilen Description parametresi geçersiz olduğundan hata döndürüldü. Açıklama 2 ila 256 karakter uzunluğunda olmalı ve http:// veya https:// ile başlayamaz.
400 InvalidParameter.Conflict The specified region and cluster do not match. Belirtilen bölge ve küme birbirine karşılık gelmediğinden hata döndürüldü.
400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid. Belirtilen Tag.N.Key parametresi geçersiz olduğundan hata döndürüldü.
400 RegionUnauthorized %s Belirtilen bölgede işlem gerçekleştirme yetkiniz olmadığından hata döndürüldü. %s bir değişkendir. Çağrı koşullarına göre dinamik olarak bir hata mesajı döndürülür.
400 Zone.NotOnSale %s İstenen kaynaklar belirtilen alanda kullanılamadığından hata döndürüldü. %s bir değişkendir. Çağrı koşullarına göre dinamik olarak bir hata mesajı döndürülür.
400 InvalidPeriodUnit.ValueNotSupported The specified parameter PeriodUnit is not valid. Belirtilen PeriodUnit parametresi geçersiz olduğundan hata döndürüldü.
400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid. Belirtilen Tag.N.Value parametresi geçersiz olduğundan hata döndürüldü.
400 InvalidChargeType.ValueNotSupported ChargeType is not valid. Belirtilen faturalandırma yöntemi desteklenmediğinden hata döndürüldü. Desteklenen bir faturalandırma yöntemi ayarlayın.
400 InvalidInstanceType.ValueNotSupported The specified InstanceType beyond the permitted range. Belirtilen InstanceType parametresi geçersiz olduğundan hata döndürüldü.
400 InvalidInstanceType.ValueNotSupported The specified InstanceType does not exist or beyond the permitted range. Belirtilen InstanceType parametresi mevcut olmadığından veya bu örnek türündeki örnekleri yönetme yetkiniz olmadığından hata döndürüldü.
403 OperationDenied The creation of Host to the specified Zone is not allowed. Belirtilen alanda özel ana bilgisayar oluşturma yetkiniz olmadığından hata döndürüldü.
403 OperationDenied.NoStock The requested resource is sold out in the specified zone; try other types of resources or other regions and zones. İstenen kaynaklar belirtilen alanda kullanılamadığından hata döndürüldü. Farklı bir örnek türü veya alan deneyin. Kullanılabilir kaynakları sorgulamak için DescribeZones işlemini çağırabilirsiniz.
403 OperationDenied Sales of this resource are temporarily suspended in the specified region; please try again later. İstenen kaynaklar belirtilen bölgede kullanılamadığından hata döndürüldü. Daha sonra tekrar deneyin.
403 NodeControllerUnavailable The Node Controller is temporarily unavailable. Düğüm denetleyicisi kullanılamadığından hata döndürüldü.
403 OperationDenied The resource is out of usage. Örnek Çalışıyor (Running) durumunda olmadığından hata döndürüldü. Örneği başlatın veya belirtilen işlemin geçerli olup olmadığını kontrol edin.
403 InvalidParameter.ResourceOwnerAccount ResourceOwnerAccount is Invalid. Belirtilen ResourceOwnerAccount parametresi geçersiz olduğundan hata döndürüldü.
403 Zone.NotOpen The specified zone is not granted to you to buy resources yet. Belirtilen alanda kaynak satın alma yetkiniz olmadığından hata döndürüldü.
403 Zone.NotOnSale The specified zone is not available for purchase. İstenen kaynaklar belirtilen alanda kullanılamadığından hata döndürüldü. Diğer örnek türlerini deneyin veya diğer bölgeleri ya da alanları seçin.
403 InvalidParameter.NotMatch %s Belirtilen bir parametre geçersiz olduğundan hata döndürüldü. Parametre çakışması olup olmadığını kontrol edin.
403 Account.Arrearage Your account has been in arrears. Hesap bakiyeniz yetersiz olduğundan hata döndürüldü. Alibaba Cloud hesabınıza fon ekleyin ve tekrar deneyin.
404 PaymentMethodNotFound No payment method has been registered on the account. Hesabınız için bir ödeme yöntemi yapılandırmadığınızdan hata döndürüldü.
500 InternalError The request processing has failed due to some unknown error. Dahili bir hata oluştuğundan hata döndürüldü. Daha sonra tekrar deneyin.
500 InternalError %s Dahili bir hata oluştuğundan hata döndürüldü.
500 InternalError The request processing has failed due to some unknown error, exception or failure. Dahili bir hata oluştuğundan hata döndürüldü. Daha sonra tekrar deneyin.

Hata kodlarının listesi için API Hata Merkezi adresini ziyaret edin.