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
İstek parametreleri
| Parametre | Tür | Zorunlu | Örnek | Açıklama |
| Action | String | Evet | PurchaseReservedInstancesOffering | Gerçekleştirmek istediğiniz işlem. Değeri PurchaseReservedInstancesOffering olarak ayarlayın. |
| RegionId | String | Evet | cn-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.Key | String | Hayır | TestKey | 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 |
| Tag.N.Value | String | Hayır | TestValue | 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 |
| ResourceGroupId | String | Hayır | rg-bp199lyny9b3**** | Kaynak grubunun kimliği. |
| ZoneId | String | Hayır | cn-hangzhou-g | Ayrılmış örneğin satın alınacağı alanın kimliği. |
| ReservedInstanceName | String | Hayır | testReservedInstanceName | 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. |
| InstanceType | String | Evet | ecs.g5.large | Örnek türü. Daha fazla bilgi için bkz. Örnek aileleri. |
| Scope | String | Hayır | Zone | Ayrılmış örneğin kapsamı. Geçerli değerler:
Varsayılan değer: Region. |
| InstanceAmount | Integer | Hayır | 3 | 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. |
| OfferingType | String | Hayır | All Upfront | Ayrılmış örneğin ödeme seçeneği. Geçerli değerler:
Varsayılan değer: All Upfront. |
| Description | String | Hayır | testDescription | 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. |
| Platform | String | Hayır | Linux | Örnek tarafından kullanılan görüntünün işletim sistemi. Geçerli değerler:
Varsayılan değer: Linux. |
| Period | Integer | Hayır | 1 | Ayrılmış örneğin süresi. Geçerli değerler: 1 ve 3. Varsayılan değer: 1. |
| PeriodUnit | String | Hayır | Year | Ayrılmış örneğin süresinin birimi. Geçerli değer: Year. Varsayılan değer: Year. |
| ClientToken | String | Hayır | 123e4567-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. |
| AutoRenew | Boolean | Hayır | true | 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. |
| AutoRenewPeriod | Integer | Hayır | 1 | 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 |
|
| ReservedInstanceIdSets | Array of String | ecsri-2ze53qonjqxg7r**** |
|
Ö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.