ModifyDedicatedHostAttribute - Elastic Compute Service - Alibaba Cloud Documentation Center

Memanggil ModifyDedicatedHostAttribute untuk mengubah informasi host spesifikasi khusus, termasuk nama, deskripsi, dan atribut ketidaktersediaan layanan pada host spesifikasi khusus.

Deskripsi operasi

Catatan penggunaan

Saat Anda mengubah rasio overcommit CPU, instans ECS pada host spesifikasi khusus harus berada dalam status Berhenti (Stopped).
Mengubah rasio overcommit CPU tidak memengaruhi status berjalan DDH. Namun, perhatikan bahwa jumlah vCPU yang dialokasikan pada DDH tidak boleh melebihi jumlah total vCPU setelah modifikasi. Jika tidak, instans ECS yang melebihi batas tidak dapat dimulai.

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:ModifyDedicatedHostAttribute

update

*DedicatedHost

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

DedicatedHostCluster

acs:ecs:{#regionId}:{#accountId}:ddhcluster/{#ddhclusterId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah host khusus. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
DedicatedHostId	string	Yes	ID host khusus.	dh-bp165p6xk2tlw61e****
DedicatedHostName	string	No	Nama host khusus. Panjang nama harus 2 hingga 128 karakter. Nama harus diawali dengan huruf atau karakter Tionghoa dan tidak boleh diawali dengan http:// atau https://. Nama dapat berisi huruf, angka, titik dua (:), garis bawah (_), dan tanda hubung (-).	testDedicatedHostName
Description	string	No	Deskripsi host khusus. Panjang deskripsi harus 2 hingga 256 karakter dan tidak boleh diawali dengan `http://` atau `https://`.	testDescription
ActionOnMaintenance	string	No	Solusi migrasi untuk instans yang dihosting pada host khusus saat host khusus mengalami kegagalan atau diperbaiki secara online. Nilai valid: Migrate: Instans dimigrasi ke mesin fisik lain dan dimulai ulang. Stop: Instans pada host khusus dihentikan. Setelah dikonfirmasi bahwa host khusus tidak dapat diperbaiki, instans dimigrasi ke mesin fisik lain dan dimulai ulang. Nilai default: Migrate. Jika cloud disk terpasang pada host khusus, nilai default adalah Migrate. Jika local disk terpasang pada host khusus, nilai default adalah Stop.	Migrate
NetworkAttributes.SlbUdpTimeout	integer	No	The timeout period of UDP sessions for Server Load Balancer (SLB) connections. Unit: seconds. Valid values: 15 to 310.	60
NetworkAttributes.UdpTimeout	integer	No	The timeout period of UDP sessions for user access to the cloud services that run on the dedicated host. Unit: seconds. Valid values: 15 to 310.	60
AutoPlacement	string	No	Apakah akan menambahkan host spesifikasi khusus ke kolam sumber daya untuk penyebaran otomatis. Jika Anda tidak menentukan DedicatedHostId saat membuat instans pada host spesifikasi khusus, Alibaba Cloud secara otomatis memilih host spesifikasi khusus dari kolam sumber daya untuk menghosting instans. Nilai valid: on: menambahkan host spesifikasi khusus ke kolam sumber daya untuk penyebaran otomatis. off: tidak menambahkan host spesifikasi khusus ke kolam sumber daya untuk penyebaran otomatis. Untuk informasi lebih lanjut tentang fitur penyebaran otomatis, lihat Features.	on
DedicatedHostClusterId	string	No	ID kluster host khusus.	dc-bp165p6xk2tlw61e****
CpuOverCommitRatio	number	No	Rasio overcommit CPU. Rasio overcommit CPU hanya dapat diatur untuk keluarga instans kustom g6s, c6s, dan r6s. Nilai valid: 1 hingga 5. Rasio overcommit CPU memengaruhi jumlah vCPU yang tersedia pada host spesifikasi khusus (DDH). Jumlah vCPU yang tersedia pada DDH = jumlah inti CPU fisik * 2 * rasio overcommit CPU. Misalnya, jumlah inti CPU fisik pada instans g6s adalah 52. Jika rasio overcommit CPU diatur ke 4, jumlah total vCPU yang ditampilkan setelah modifikasi adalah 416. Untuk skenario yang tidak memiliki persyaratan ketat pada stabilitas CPU absolut atau yang memiliki beban CPU rendah, seperti lingkungan pengembangan dan pengujian, peningkatan rasio overcommit dapat meningkatkan jumlah vCPU yang tersedia dan memungkinkan Anda menerapkan lebih banyak instans ECS dengan spesifikasi yang sama, sehingga mengurangi biaya penyebaran per unit.	1

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	2A4EA075-CB5B-41B7-B0EB-70D339F6****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "2A4EA075-CB5B-41B7-B0EB-70D339F6****"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	InvalidDedicatedHostName.Malformed	The specified parameter DedicatedHostName is not valid.
400	InvalidDescription.Malformed	The specified parameter Description is not valid.
400	InvalidParameter.SlbUdpTimeout	The specified value is invalid.
400	InvalidParameter.UdpTimeout	The specified value is invalid.
400	InvalidDedicatedHostType.CpuOverCommitRatioNotSupported	%s
400	InvalidCpuOverCommitRatio.ValueNotSupported	%s
403	InvalidUser.Unauthorized	The user is not authorized
404	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.
404	InvalidDedicatedHostClusterId.NotFound	The specified DedicatedHostClusterId does not exist.
404	InvalidDedicatedHostClusterId.ExceedMaxSize	The specified Dedicated Host Cluster exceeded max capacity.
404	InvalidDedicatedHostClusterId.NotMatch	The specified DedicatedHostCluster does not match request.
404	InvalidParameter.ActionOnMaintenance	The specified ActionOnMaintenance does not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.