ModifyInstanceDeployment - Elastic Compute Service - Alibaba Cloud Documentation Center

Memodifikasi deployment set dari instance ECS, atau memigrasikan instance ECS ke dedicated host. Anda juga dapat mengubah tipe instance saat memigrasikan instance ECS.

Deskripsi operasi

Ketika Anda memigrasikan instance ECS ke dedicated host, atau mengubah tipe instance ECS sekaligus memigrasikannya, kondisi berikut harus dipenuhi:

Instance ECS harus dalam status Stopped (Dihentikan). Instance secara otomatis di-restart setelah migrasi.
Hanya instance ECS bertipe Virtual Private Cloud (VPC) yang didukung.
Instance ECS dan dedicated host harus berada pada akun, region, dan zona yang sama.
Instance ECS pay-as-you-go dapat dimigrasikan ke dedicated host subscription. Instance ECS subscription hanya dapat dimigrasikan antar dedicated host subscription, dan waktu kedaluwarsa instance tidak boleh melebihi waktu kedaluwarsa dedicated host tujuan.
Ketika Anda memigrasikan instance ECS dari shared host ke dedicated host, metode penagihan instance hanya dapat berupa pay-as-you-go. Instance subscription dan instance preemptible tidak didukung.
Instance ECS dapat menentukan cluster dedicated host untuk deployment ulang.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ecs:ModifyInstanceDeployment

update

DedicatedHost

acs:ecs:{#regionId}:{#accountId}:ddh/{#ddhId}

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID region tempat instance berada. Anda dapat memanggil DescribeRegions untuk melihat daftar terkini region Alibaba Cloud.	cn-hangzhou
InstanceId	string	Yes	ID instance.	i-bp67acfmxazb4ph***
DedicatedHostId	string	No	ID dedicated host. Anda dapat memanggil DescribeDedicatedHosts untuk melihat daftar dedicated host yang tersedia. Ketika Anda mengubah host dari instance ECS (yaitu, ketika Anda memigrasikan instance ECS dari shared host ke dedicated host, atau memigrasikan instance ECS antar dedicated host yang berbeda): Untuk memigrasikan instance ke dedicated host tertentu, Anda harus mengatur parameter ini. Untuk memigrasikan instance ke dedicated host yang dipilih secara otomatis oleh sistem, Anda harus mengosongkan parameter ini dan mengatur parameter `Tenancy` ke host. Untuk informasi selengkapnya mengenai fitur deployment otomatis, lihat Fitur dedicated host.	dh-bp67acfmxazb4ph****
DeploymentSetId	string	No	ID deployment set. Parameter ini wajib ketika Anda menambahkan instance ECS ke deployment set atau mengubah deployment set dari instance ECS. Catatan Ketika Anda memodifikasi parameter yang terkait dengan dedicated host (`Tenancy`, `Affinity`, dan `DedicatedHostId`), Anda tidak dapat memodifikasi deployment set pada saat yang sama.	ds-bp67acfmxazb4ph****
DeploymentSetGroupNo	integer	No	Ketika kebijakan deployment set yang akan diikuti atau diubah oleh instance ECS adalah kebijakan high availability grup deployment set (AvailabilityGroup), Anda dapat menggunakan parameter ini untuk menentukan nomor grup instance dalam deployment set. Nilai yang valid: 1 hingga 7. Catatan Jika Anda mengubah deployment set untuk instance ECS dan kebijakan deployment set adalah kebijakan high availability grup deployment set (`AvailablilityGroup`), ketika parameter ini tidak ditentukan, sistem secara otomatis mendistribusikan instance ECS secara merata di seluruh grup. Jika deployment set yang Anda tentukan untuk instance ECS masih merupakan deployment set tempat instance saat ini berada, sistem juga akan mendistribusikan ulang instance ECS secara merata di seluruh grup.	3
Force	boolean	No	Menentukan apakah akan secara paksa mengubah host instance ketika deployment set diubah. Nilai yang valid: true: diizinkan. Instance ECS dalam status Running atau Stopped dapat di-restart. Instance Stopped tidak mencakup instance ECS pay-as-you-go yang telah mengaktifkan mode ekonomis. Catatan Jika instance ECS yang ditentukan memiliki local disk terpasang, local disk juga diizinkan untuk diganti secara paksa, yang dapat menyebabkan kehilangan data pada local disk ketika host diubah. Lanjutkan dengan hati-hati. false: tidak diizinkan. Instance hanya dapat bergabung dengan deployment set pada host saat ini. Hal ini dapat menyebabkan perubahan deployment set gagal. Nilai default: false.	false
Affinity	string	No	Menentukan apakah instance terkait dengan dedicated host. Nilai yang valid: host: terkait. Ketika instance yang mode ekonomisnya diaktifkan dijalankan kembali setelah dihentikan, instance tetap di-deploy pada dedicated host asli. default: tidak terkait. Ketika instance yang mode ekonomisnya diaktifkan dijalankan kembali setelah dihentikan, jika sumber daya dedicated host asli tidak mencukupi, instance dapat dimigrasikan ke dedicated host lain dalam pool sumber daya deployment otomatis. Ketika instance dimigrasikan dari shared host ke dedicated host, nilai default-nya adalah default.	host
Tenancy	string	No	Menentukan apakah instance di-deploy pada dedicated host. Nilai yang valid: host, yang menunjukkan bahwa instance hanya dapat di-deploy pada dedicated host.	host
MigrationType	string	No	Menentukan apakah akan menghentikan instance sebelum memigrasikannya ke dedicated host tujuan. Nilai yang valid: reboot: Menghentikan instance sebelum migrasi. live: Memigrasikan instance tanpa menghentikannya. Dalam hal ini, Anda harus menentukan parameter DedicatedHostId. Nilai ini tidak mendukung perubahan tipe instance saat memigrasikan instance ECS. Nilai default: reboot.	live
InstanceType	string	No	Tipe instance tujuan yang akan diubah oleh instance ECS. Anda dapat memanggil operasi DescribeInstanceTypes untuk melihat daftar terkini tipe instance. Ketika Anda mengubah host instance ECS, Anda juga dapat mengubah tipe instance dari instance ECS. Tipe instance tujuan harus sesuai dengan spesifikasi dedicated host yang ditentukan. Untuk informasi selengkapnya, lihat Tipe host. Ketika Anda mengubah tipe instance, Anda harus menentukan ID dedicated host, yaitu mengatur parameter `DedicatedHostId`. Ketika Anda menggunakan fitur deployment otomatis untuk memigrasikan instance ECS, Anda tidak dapat mengubah tipe instance.	ecs.c6.large
DedicatedHostClusterId	string	No	ID cluster dedicated host.	dc-bp67acfmxazb4ph****
RemoveFromDeploymentSet	boolean	No	Menentukan apakah akan menghapus instance yang dipilih dari deployment set yang dipilih. Nilai yang valid: true: ya. false: tidak. Nilai default: false. Catatan Ketika parameter ini diatur ke true, Anda harus menentukan InstanceId dan DeploymentSetId yang saling terkait.	false

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	04F0F334-1335-436C-A1D7-6C044FE7****

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code	Error code	Error message
400	OperationDenied.UnstoppedInstance	Operation denied due to unstopped instance.
400	InvalidDedicatedHostStatus.NotSupport	Operation denied due to dedicated host status.
400	InvalidPeriod.ExceededDedicatedHost	Instance expired date can't exceed dedicated host expired date.
400	NoAvaliableDedicatedHost	There's no enough resource on the specified dedicated host.
400	OperationDenied.LocalDiskInstance	Operation denied due to instance has local disk.
400	InvalidParameter.Param	Requested param is invalid.
400	InvalidParam.Tenancy	The specified Tenancy is invalid.
400	InvalidParam.DedicatedHostId	The specified dedicated host id is the same with present host id!
400	InvalidDedicatedHost.NotEnoughResource	There's no available dedicated host to perform the operation.
400	OperationDenied.InvalidInstance	The specified instance is not dedicated instance.
400	ChargeTypeViolation.PostPaidDedicatedHost	Prepaid instance onto postpaid dedicated host is not allowed.
400	OperationDenied.NotSupport	Ecs on dedicatedHost has been migrated.
400	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.
400	OperationDenied.CannotPerform	Live migration cannot be performed.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.
400	InvalidParameter.Tenancy	The specified Tenancy is invalid.
400	InvalidParameter.Affinity	The specified Affinity is invalid.
400	InvalidInstanceType.NotSupport	The parameter EcsMigrationType conflict with InstanceType, live migration do not support InstanceType alter on ddh.
400	InvalidParam.InstanceId	The specified InstanceId should be on dedicatedHost.
400	InvalidDedicatedHostClusterId.NotFound	The specified DedicatedHostClusterId does not exist.
400	InvalidDedicatedHostClusterId.Invalid	The specified Dedicated Host Cluster is invalid.
400	InvalidDestinationZone.DeploymentSetMismatch	Error happened, %s.
403	IncorrectInstanceStatus	%s
403	OperationDenied.NoStock	The resource is out of usage.
403	InvalidDeploymentSetId.NoAvailableResources	There are no available resources for the specified deployment, you can set the parameter force to true to retry, or wait for additional resource to become available.
403	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not support the current category of data disk.
404	InvalidDeploymentSetId.NotFound	The specified deployment set does not exist.
404	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.
404	OperationDenied.UnstoppedInstance	Operation denied due to unstopped instance.
404	InvalidInstanceNetworkType.NotSupport	The specified Instance network type not support.
404	InvalidInstanceChargeType.NotSupport	The Dedicated host not support the specified instance charge type.
404	InvalidInstanceType.NotSupport	The Dedicated host not support the specified instance type.
404	InvalidParameter.DeploymentSetGroupNo	Parameter DeploymentSetGroupNo is invalid.
404	InvalidDedicatedHostId.NotSupport	Cannot choose instance present host as destination host.
404	InvalidDedicatedHost.NotFound	No available host.
404	InvalidParam.DedicatedHostId	Parameter dedicated host id must been provided in such operation.
404	InvalidDedicatedHost.ZoneNotMatch	The specify dedicated host zone location not match the instance zone location.
404	InvalidOperation.NotSupport	The specified DedicatedHost operation not supported on MPS.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.