ModifyInstanceDeployment - - Alibaba Cloud Dokümantasyon Merkezi

Açıklama

Bu işlemi bir ECS örneği için çağırırken aşağıdaki hususlara dikkat edin:

ECS örneği Stopped durumunda olmalıdır. Örnek, taşıma tamamlandıktan sonra otomatik olarak yeniden başlatılır.
ECS örneğinin ağ tipi Virtual Private Cloud (VPC) olmalıdır.
ECS örneği ve hedef özel ana bilgisayar aynı hesaba ait olmalı ve aynı bölge ile alanda bulunmalıdır.
Kullandıkça öde ECS örneği abonelik tabanlı özel ana bilgisayara taşınabilir. Abonelik tabanlı ECS örneği yalnızca abonelik tabanlı özel ana bilgisayarlar arasında taşınabilir. Abonelik tabanlı ECS örneğinin bitiş tarihi, hedef özel ana bilgisayarın bitiş tarihinden geç olamaz.
Paylaşılan ana bilgisayardan özel ana bilgisayara yalnızca kullandıkça öde ECS örnekleri taşınabilir. Abonelik tabanlı veya öncelikli örnekler paylaşılan ana bilgisayardan özel ana bilgisayara taşınamaz.
Bir ECS örneğini belirli bir özel ana bilgisayar kümesine yeniden dağıtabilirsiniz.

İstek parametreleri

Parametre	Tür	Zorunlu	Örnek	Açıklama
Action	String	Evet	ModifyInstanceDeployment	Gerçekleştirmek istediğiniz işlem. Değeri ModifyInstanceDeployment olarak ayarlayın.
RegionId	String	Evet	cn-hangzhou	Örneğin bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.
InstanceId	String	Evet	i-bp67acfmxazb4ph***	Örneklerin kimlikleri.
DedicatedHostId	String	Hayır	dh-bp67acfmxazb4ph****	Hedef özel ana bilgisayarın kimliği. En güncel özel ana bilgisayar listesini sorgulamak için DescribeDedicatedHosts işlemini çağırabilirsiniz. Bir örneği paylaşılan ana bilgisayardan özel ana bilgisayara veya özel ana bilgisayarlar arasında taşırken aşağıdaki hususlara dikkat edin: Örneği belirli bir özel ana bilgisayara taşımak için bu parametreye bir değer belirtin. Örneği sistem tarafından seçilen bir özel ana bilgisayara taşımak için bu parametreyi boş bırakın ve `Tenancy` parametresini host olarak ayarlayın. Otomatik dağıtım özelliği hakkında bilgi için bkz. Özel ana bilgisayarların özellikleri.
DeploymentSetId	String	Hayır	ds-bp67acfmxazb4ph****	Hedef dağıtım kümesinin kimliği. Bir ECS örneğini dağıtım kümesine eklerken veya bir örneğin dağıtım kümesini değiştirirken bu parametre gereklidir. Not `Tenancy`, `Affinity` ve `DedicatedHostId` gibi parametreler dahil olmak üzere özel ana bilgisayarların yapılandırmasını değiştirirken dağıtım kümesini değiştiremezsiniz.
DeploymentSetGroupNo	Integer	Hayır	3	Örneğin hedef dağıtım kümesinde konuşlandırılacağı dağıtım kümesi grubunun numarası. Bu parametre yalnızca hedef dağıtım kümesi yüksek kullanılabilirlik grubu stratejisini (AvailabilityGroup) kullandığında geçerlidir. Geçerli değerler: 1 ila 7. Not Bu işlemi bir örneği yüksek kullanılabilirlik grubu stratejisi (`AvailabilityGroup`) kullanan bir dağıtım kümesine dağıtmak için çağırırsanız ve bu parametre boş bırakılırsa sistem ECS örneklerini dağıtım kümesindeki gruplar arasında eşit şekilde dağıtır. Bu işlemi bir örneğin dağıtım kümesini değiştirmek için çağırır ve hedef dağıtım kümesi olarak örneğin mevcut dağıtım kümesini belirtirseniz sistem ECS örneklerini dağıtım kümesindeki gruplar arasında tekrar eşit şekilde dağıtır.
Force	Boolean	Hayır	false	Örneğin dağıtım kümesi değiştirilirken örneğin ana bilgisayarının zorla değiştirilip değiştirilmeyeceğini belirtir. Geçerli değerler: true: Örneğin dağıtım kümesi değiştirildiğinde örneğin ana bilgisayarını zorla değiştirir. Ana bilgisayarlar yalnızca Running veya Stopped durumundaki örnekler için zorla değiştirilebilir. Stopped durumundaki örnekler tasarruf modunda durdurulan kullandıkça öde örneklerini içermez. Not Belirtilen ECS örneğine yerel diskler bağlıysa örneğin ana bilgisayarı zorla değiştirildiğinde yerel diskler de zorla değiştirilir. Bu durum yerel disklerde veri kaybına neden olabilir. Dikkatli ilerleyin. false: Örneğin dağıtım kümesi değiştirildiğinde örneğin ana bilgisayarını zorla değiştirmez. Örneği bir dağıtım kümesine yalnızca örnek mevcut ana bilgisayarda kalırken ekleyebilirsiniz. Force parametresi false olarak ayarlandığında dağıtım kümesinin değiştirilmesi başarısız olabilir. Varsayılan değer: false.
Affinity	String	Hayır	host	Örneğin bir özel ana bilgisayarla ilişkilendirilip ilişkilendirilmeyeceğini belirtir. Geçerli değerler: host: Örneği bir özel ana bilgisayarla ilişkilendirir. Tasarruf modunda durdurulmuş bir örneği başlattığınızda örnek özgün özel ana bilgisayarında kalır. default: Örneği bir özel ana bilgisayarla ilişkilendirmez. Tasarruf modunda durdurulmuş bir örneği başlattığınızda özgün özel ana bilgisayarının kaynakları yetersiz kalırsa örnek otomatik dağıtım kaynak havuzundaki başka bir özel ana bilgisayara otomatik olarak dağıtılabilir. Örneği paylaşılan ana bilgisayardan özel ana bilgisayara taşımak istiyorsanız varsayılan değeri kullanın. Varsayılan değer: default.
Tenancy	String	Hayır	host	Örneğin özel bir ana bilgisayara dağıtılıp dağıtılmayacağını belirtir. Örneği özel bir ana bilgisayara dağıtmak için değeri host olarak ayarlayın.
MigrationType	String	Hayır	live	Örnek hedef özel ana bilgisayara taşınmadan önce durdurulup durdurulmayacağını belirtir. Geçerli değerler: reboot: Taşımadan önce örneği durdurur. live: Örneği durdurmadan taşır. MigrationType parametresini live olarak ayarlarsanız DedicatedHostId parametresini belirtmeniz gerekir. Bu durumda örnek taşıma sırasında ECS örneğinin örnek türünü değiştiremezsiniz. Varsayılan değer: reboot.
InstanceType	String	Hayır	ecs.c6.large	Örneğin değiştirileceği örnek türü. En güncel örnek türü listesini sorgulamak için DescribeInstanceTypes işlemini çağırabilirsiniz. Örneği özel bir ana bilgisayara taşırken ECS örneğinin örnek türünü değiştirebilirsiniz. Yeni örnek türü belirtilen özel ana bilgisayarın türüyle eşleşmelidir. Daha fazla bilgi için bkz. Özel ana bilgisayar türleri. Bu parametreyi belirtirseniz `DedicatedHostId` parametresini de belirtmeniz gerekir. Örneği taşımak için otomatik dağıtım özelliğini kullanıyorsanız ECS örneğinin örnek türünü değiştiremezsiniz.
DedicatedHostClusterId	String	Hayır	dc-bp67acfmxazb4ph****	Özel ana bilgisayar kümesinin kimliği.
RemoveFromDeploymentSet	Boolean	Hayır	false	Seçili örneğin seçili dağıtım kümesinden kaldırılıp kaldırılmayacağını belirtir. Geçerli değerler: true. false. Varsayılan değer: false. Not Bu parametreyi true olarak ayarlarsanız seçili ECS örneğinin InstanceId değerini ve ECS örneğinin ait olduğu dağıtım kümesinin DeploymentSetId değerini belirtmeniz gerekir.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
RequestId	String	04F0F334-1335-436C-A1D7-6C044FE7****	İsteğin kimliği.

Örnekler

Örnek istekler

http(s)://ecs.aliyuncs.com/?Action=ModifyInstanceDeployment
&RegionId=cn-hangzhou
&InstanceId=i-bp67acfmxazb4ph***
&DedicatedHostId=dh-bp67acfmxazb4ph****
&DeploymentSetId=ds-bp67acfmxazb4ph****
&Tenancy=host
&MigrationType=live
&DedicatedHostClusterId=dc-bp67acfmxazb4ph****
&<Common request parameters>

Başarılı yanıt örnekleri

XML biçimi

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

<ModifyInstanceDeploymentResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FE7****</RequestId>
</ModifyInstanceDeploymentResponse>

JSON biçimi

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

{
  "RequestId" : "04F0F334-1335-436C-A1D7-6C044FE7****"
}

Hata kodları

HttpCode	Hata kodu	Hata mesajı	Açıklama
400	OperationDenied.UnstoppedInstance	Operation denied due to unstopped instance.	Geçerli işlemin geçersiz olması nedeniyle dönen hata mesajı. Örneğin Stopped durumunda olup olmadığını kontrol edin.
400	InvalidDedicatedHostStatus.NotSupport	Operation denied due to dedicated host status.	Özel ana bilgisayarın mevcut durumunda işlem desteklenmediği için dönen hata mesajı.
400	InvalidPeriod.ExceededDedicatedHost	Instance expired date can't exceed dedicated host expired date.	Örneğin bitiş tarihinin özel ana bilgisayarın bitiş tarihinden sonra olması nedeniyle dönen hata mesajı.
400	InvalidParam.Tenancy	The specified Tenancy is invalid.	Belirtilen Tenancy parametresinin geçersiz olması nedeniyle dönen hata mesajı.
400	OperationDenied.InvalidInstance	The specified instance is not dedicated instance.	Belirtilen örneğin özel bir ana bilgisayara dağıtılmamış olması nedeniyle dönen hata mesajı.
400	ChargeTypeViolation.PostPaidDedicatedHost	Prepaid instance onto postpaid dedicated host is not allowed.	Abonelik tabanlı örneklerin kullandıkça öde özel ana bilgisayarlara dağıtılamaması nedeniyle dönen hata mesajı.
400	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.	Belirtilen DedicatedHostId parametresinin mevcut olmaması nedeniyle dönen hata mesajı.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	Belirtilen InstanceType parametresinin mevcut olmaması veya belirtilen örnek türündeki örnekleri yönetme yetkinizin bulunmaması nedeniyle dönen hata mesajı.
403	IncorrectInstanceStatus	%s	Örneğin mevcut durumunda işlem desteklenmediği için dönen hata mesajı.
403	OperationDenied.NoStock	The resource is out of usage.	Örneğin Running durumunda olmaması nedeniyle dönen hata mesajı. Örneği başlatın veya işlemin geçerli olup olmadığını kontrol edin.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Belirtilen örnek kimliğinin mevcut olmaması nedeniyle dönen hata mesajı. Örnek kimliğinin doğru olup olmadığını kontrol edin.
404	InvalidInstanceNetworkType.NotSupport	The specified Instance network type not support.	Örneğin ağ tipinin bu işlemi desteklememesi nedeniyle dönen hata mesajı.
404	InvalidInstanceType.NotSupport	The Dedicated host not support the specified instance type.	Geçerli özel ana bilgisayarın belirtilen örnek türünü desteklememesi nedeniyle dönen hata mesajı.

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