ModifyInstanceDeployment - - Alibaba Cloud Documentation Center

Mengubah set penyebaran instance Elastic Compute Service (ECS) atau memigrasikan instance ECS ke host khusus. Anda juga dapat mengubah tipe instans instance ECS selama migrasi tersebut.

Deskripsi

Saat memanggil operasi ini untuk instance ECS, perhatikan hal-hal berikut:

Instance ECS harus dalam status Stopped. Instance akan otomatis dimulai ulang setelah migrasi selesai.
Jenis jaringan instance ECS harus berupa Virtual Private Cloud (VPC).
Instance ECS dan host khusus tujuan harus berada dalam akun yang sama serta berlokasi di wilayah dan zona yang sama.
Instance ECS pay-as-you-go dapat dimigrasikan ke host khusus subscription. Instance ECS subscription hanya dapat dimigrasikan antar host khusus subscription. Tanggal kedaluwarsa instance ECS subscription tidak boleh lebih lambat daripada tanggal kedaluwarsa host khusus tujuan.
Hanya instance ECS pay-as-you-go yang dapat dimigrasikan dari host bersama ke host khusus. Instance subscription atau preemptible tidak dapat dimigrasikan dari host bersama ke host khusus.
Anda dapat menyebar ulang instance ECS ke kluster host khusus tertentu.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kemudahan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Wajib	Contoh	Deskripsi
Action	String	Ya	ModifyInstanceDeployment	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyInstanceDeployment.
RegionId	String	Ya	cn-hangzhou	ID wilayah instans. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.
InstanceId	String	Ya	i-bp67acfmxazb4ph***	ID dari instans.
DedicatedHostId	String	Tidak	dh-bp67acfmxazb4ph****	ID dari dedicated host tujuan. Anda dapat memanggil operasi DescribeDedicatedHosts untuk mengambil daftar terbaru dedicated host. Saat memigrasikan instans dari shared host ke dedicated host atau antar dedicated host, perhatikan hal-hal berikut: Untuk memigrasikan instans ke dedicated host tertentu, tentukan nilai untuk parameter ini. Untuk memigrasikan instans ke dedicated host yang dipilih sistem, biarkan parameter ini kosong dan atur `Tenancy` ke host. Untuk informasi mengenai fitur automatic deployment, lihat Features of dedicated hosts.
DeploymentSetId	String	Tidak	ds-bp67acfmxazb4ph****	ID dari set penyebaran tujuan. Parameter ini wajib ditentukan saat Anda menambahkan instans ECS ke set penyebaran atau mengubah set penyebaran suatu instans. Catatan Anda tidak dapat mengubah set penyebaran saat memodifikasi konfigurasi host khusus, termasuk parameter seperti `Tenancy`, `Affinity`, dan `DedicatedHostId`.
DeploymentSetGroupNo	Integer	Tidak	3	Jumlah kelompok set penyebaran tempat instans ditempatkan dalam set penyebaran tujuan. Parameter ini hanya berlaku ketika set penyebaran tujuan menggunakan strategi kelompok ketersediaan (AvailabilityGroup). Nilai yang valid: 1 hingga 7. Catatan Jika Anda memanggil operasi ini untuk menempatkan instans ke set penyebaran yang menggunakan strategi kelompok ketersediaan (`AvailabilityGroup`) dan parameter ini dibiarkan kosong, sistem akan mendistribusikan Instance ECS secara merata di antara kelompok-kelompok set penyebaran dalam set penyebaran tersebut. Jika Anda memanggil operasi ini untuk mengubah set penyebaran suatu instans dan menetapkan set penyebaran saat ini dari instans tersebut sebagai set penyebaran tujuan, sistem akan kembali mendistribusikan Instance ECS secara merata di antara kelompok-kelompok set penyebaran dalam set penyebaran tersebut.
Force	Boolean	Tidak	false	Menentukan apakah akan memaksa perubahan host instans saat set penyebaran instans diubah. Nilai yang valid: true: memaksa perubahan host instans saat set penyebaran instans diubah. Host hanya dapat dipaksa diubah untuk instans dalam status Running atau Stopped. Instans dalam status Stopped tidak mencakup instans pay-as-you-go yang dihentikan dalam mode hemat. Catatan Jika Instance ECS yang ditentukan memiliki local disk yang disambungkan, local disk tersebut juga akan dipaksa berpindah saat host instans dipaksa diubah. Hal ini dapat menyebabkan kehilangan data pada local disk. Lakukan dengan hati-hati. false: tidak memaksa perubahan host instans saat set penyebaran instans diubah. Anda hanya dapat menambahkan instans ke set penyebaran jika instans tetap berada di host saat ini. Saat parameter Force diatur ke false, perubahan set penyebaran mungkin gagal. Nilai default: false.
Affinity	String	Tidak	host	Menentukan apakah instans akan dikaitkan dengan dedicated host. Nilai yang valid: host: mengaitkan instans dengan dedicated host. Saat Anda menjalankan kembali instans yang dihentikan dalam mode hemat, instans tetap berada di dedicated host aslinya. default: tidak mengaitkan instans dengan dedicated host. Saat Anda menjalankan kembali instans yang dihentikan dalam mode hemat, instans dapat ditempatkan secara otomatis ke dedicated host lain dalam kolam sumber daya penyebaran otomatis jika sumber daya pada dedicated host aslinya tidak mencukupi. Jika Anda ingin memigrasikan instans dari shared host ke dedicated host, gunakan nilai default. Nilai default: default.
Tenancy	String	Tidak	host	Menentukan apakah akan men-deploy instans pada dedicated host. Atur nilainya ke host untuk men-deploy instans pada dedicated host.
MigrationType	String	Tidak	live	Menentukan apakah instans harus dihentikan sebelum dimigrasikan ke host khusus tujuan. Nilai yang valid: reboot: menghentikan instans sebelum dimigrasikan. live: memigrasikan instans tanpa menghentikannya. Jika Anda mengatur parameter MigrationType ke live, Anda harus menentukan parameter DedicatedHostId. Dalam kasus ini, Anda tidak dapat mengubah tipe instans dari Instance ECS saat instans dimigrasikan. Nilai default: reboot.
InstanceType	String	Tidak	ecs.c6.large	Tipe instans ke mana instans diubah. Anda dapat memanggil operasi DescribeInstanceTypes untuk mengkueri daftar terbaru tipe instans. Anda dapat mengubah tipe instans Instance ECS saat memigrasikan instans tersebut ke host khusus. Tipe instans baru harus sesuai dengan tipe host khusus yang ditentukan. Untuk informasi selengkapnya, lihat Dedicated host types. Jika Anda menentukan parameter ini, Anda juga harus menentukan parameter `DedicatedHostId`. Anda tidak dapat mengubah tipe instans Instance ECS jika menggunakan fitur penyebaran otomatis untuk memigrasikan instans tersebut.
DedicatedHostClusterId	String	Tidak	dc-bp67acfmxazb4ph****	ID kluster host khusus.
RemoveFromDeploymentSet	Boolean	Tidak	false	Menentukan apakah akan menghapus instans yang dipilih dari set penyebaran yang dipilih. Nilai yang valid: true. false. Nilai default: false. Catatan Jika Anda mengatur parameter ini ke true, Anda harus menentukan InstanceId dari instans ECS yang dipilih dan DeploymentSetId dari set penyebaran tempat instans ECS tersebut berada.

Parameter respons

Parameter	Type	Contoh	Deskripsi
RequestId	String	04F0F334-1335-436C-A1D7-6C044FE7****	ID permintaan.

Contoh

Contoh permintaan

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>

Contoh respons sukses

XML format

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

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

JSON format

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

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

Kode kesalahan

Kode HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	OperationDenied.UnstoppedInstance	Operation denied due to unstopped instance.	Pesan kesalahan yang dikembalikan karena operasi saat ini tidak valid. Periksa apakah Instans berada dalam status Stopped.
400	InvalidDedicatedHostStatus.NotSupport	Operation denied due to dedicated host status.	Pesan kesalahan yang dikembalikan karena operasi tidak didukung saat host khusus berada dalam status saat ini.
400	InvalidPeriod.ExceededDedicatedHost	Instance expired date can't exceed dedicated host expired date.	Pesan kesalahan yang dikembalikan karena tanggal kedaluwarsa Instans melebihi tanggal kedaluwarsa host khusus.
400	InvalidParam.Tenancy	The specified Tenancy is invalid.	Pesan kesalahan yang dikembalikan karena parameter Tenancy yang ditentukan tidak valid.
400	OperationDenied.InvalidInstance	The specified instance is not dedicated instance.	Pesan kesalahan yang dikembalikan karena instans yang ditentukan tidak ditempatkan pada host khusus.
400	ChargeTypeViolation.PostPaidDedicatedHost	Prepaid instance onto postpaid dedicated host is not allowed.	Pesan kesalahan yang dikembalikan karena instansi langganan tidak dapat ditempatkan pada host khusus bayar sesuai penggunaan.
400	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.	Pesan kesalahan yang dikembalikan karena parameter DedicatedHostId yang ditentukan tidak ada.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	Pesan kesalahan yang dikembalikan karena parameter InstanceType yang ditentukan tidak ada atau karena Anda tidak memiliki otorisasi untuk mengelola instans dari tipe instans yang ditentukan.
403	IncorrectInstanceStatus	%s	Pesan kesalahan yang dikembalikan karena operasi tidak didukung saat instans berada dalam status saat ini.
403	OperationDenied.NoStock	The resource is out of usage.	Pesan kesalahan yang dikembalikan karena instans tidak berada dalam status Running. Mulai instans atau periksa apakah operasi tersebut valid.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Pesan kesalahan yang dikembalikan karena ID instans yang ditentukan tidak ada. Periksa apakah ID instans tersebut benar.
404	InvalidInstanceNetworkType.NotSupport	The specified Instance network type not support.	Pesan kesalahan yang dikembalikan karena jenis jaringan Instans tidak mendukung operasi ini.
404	InvalidInstanceType.NotSupport	The Dedicated host not support the specified instance type.	Pesan kesalahan yang dikembalikan karena host khusus saat ini tidak mendukung tipe instans yang ditentukan.

Untuk daftar kode kesalahan, kunjungi API Error Center.