UpdateDhcpOptionsSetAttribute - Virtual Private Cloud - Alibaba Cloud Documentation Center

Mengubah konfigurasi set opsi DHCP.

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

vpc:UpdateDhcpOptionsSetAttribute

update

*DhcpOptionsSet.

acs:vpc:{#regionId}:{#accountId}:dhcpoptionsset/{#DhcpOptionsSetId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	Wilayah tempat set opsi DHCP yang akan diubah berada. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.	cn-hangzhou
DhcpOptionsSetId	string	Yes	ID set opsi DHCP yang akan diubah.	dopt-o6w0df4epg9zo8isy****
DomainNameServers	string	No	Alamat IP server DNS. Anda dapat menentukan hingga empat alamat IP server DNS. Pisahkan beberapa alamat IP dengan koma (,). Catatan Jika Anda tidak menentukan alamat IP server DNS, instans ECS menggunakan alamat IP server DNS yang disediakan oleh Alibaba Cloud secara default (100.100.2.136 dan 100.100.2.138).	192.XX.XX.123
DomainName	string	No	Sufiks hostname, seperti example.com. Setelah set opsi DHCP dikaitkan dengan VPC, sufiks hostname disinkronkan secara otomatis ke instans ECS di VPC.	example.com
DhcpOptionsSetName	string	No	Nama set opsi DHCP. Panjang nama harus 2 hingga 128 karakter dan harus diawali dengan huruf atau karakter Tionghoa. Nama dapat berisi angka, garis bawah (_), dan tanda hubung (-).	name
DhcpOptionsSetDescription	string	No	Deskripsi set opsi DHCP. Deskripsi dapat kosong atau memiliki panjang 2 hingga 256 karakter. Deskripsi harus diawali dengan huruf atau karakter Tionghoa dan tidak dapat diawali dengan `http://` atau `https://`.	description
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token hanya dapat berisi karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.	0c593ea1-3bea-11e9-b96b-88e9fe637760
DryRun	boolean	No	Apakah akan menjalankan dry run. Nilai valid: true: menjalankan dry run tanpa mengubah konfigurasi set opsi DHCP. Sistem memeriksa parameter yang diperlukan, format permintaan, dan batas. Jika permintaan gagal dalam dry run, pesan kesalahan dikembalikan. Jika permintaan berhasil dalam dry run, kode kesalahan `DryRunOperation` dikembalikan. false (default): menjalankan dry run dan mengirimkan permintaan. Jika permintaan berhasil dalam dry run, kode status HTTP 2xx dikembalikan dan konfigurasi set opsi DHCP diubah.	false
LeaseTime	string	No	Waktu sewa set opsi DHCP IPv4. Pengatur waktu sewa ditetapkan dalam jam: Unit: h. Nilai valid: 24h hingga 1176h dan 87600h hingga 175200h. Nilai default: 87600h. Pengatur waktu sewa ditetapkan dalam hari: Unit: d. Nilai valid: 1d hingga 49d dan 3650d hingga 7300d. Nilai default: 3650d. Catatan Anda harus menyertakan unit saat menentukan nilai.	3650d
Ipv6LeaseTime	string	No	Waktu sewa set opsi DHCP IPv6. Pengatur waktu sewa ditetapkan dalam jam: Unit: h. Nilai valid: 24h hingga 1176h dan 87600h hingga 175200h. Nilai default: 24h. Pengatur waktu sewa ditetapkan dalam hari: Unit: d. Nilai valid: 1d hingga 49d dan 3650d hingga 7300d. Nilai default: 1d. Catatan Anda harus menyertakan unit saat menentukan nilai.	3650d

Elemen respons

Element	Type	Description	Example
	object	ID permintaan.
RequestId	string	ID permintaan.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0

Contoh

Respons sukses

JSONformat

{
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidDhcpOptionsSetId.NotFound	The specified dhcpOptionsSetId does not exist.	Instans set opsi DHCP tidak ada. Periksa apakah parameter benar.
400	IncorrectStatus.DhcpOptionsSet	The DhcpOptionsSet status does not support this operation.	Instans set opsi DHCP berada dalam status transisi. Tunggu hingga status instans mencapai keadaan stabil dan coba lagi.
400	IllegalParam.DomainNameServers	The specified DomainNameServers is invalid.	Parameter DomainNameServers yang ditentukan tidak valid. Periksa apakah parameter tersebut benar.
400	IllegalParam.DomainName	The specified DomainName is invalid.	DomainName yang ditentukan tidak valid.
400	IllegalParam.DhcpOptionsSetName	The specified DhcpOptionsSetName is invalid.	Parameter DhcpOptionsSetName yang ditentukan tidak valid. Periksa apakah parameter tersebut benar.
400	IllegalParam.DhcpOptionsSetDescription	The specified DhcpOptionsSetDescription is invalid.	Parameter DhcpOptionsSetDescription yang ditentukan tidak valid. Periksa apakah parameter tersebut benar.
400	OperationUnsupported.DhcpLeaseTime	The DhcpOptionsSet of this region does not support custom LeaseTime.	Set opsi DHCP di wilayah ini tidak mendukung LeaseTime kustom.
400	OperationUnsupported.DhcpOptionsSet	The DHCP options set feature in this region is not supported.	Fitur set opsi DHCP tidak didukung di wilayah saat ini.
400	OperationDenied.ModifyDefaultDhcpOptionsSet	The default DHCP options set is not allowed to be modified.	Set opsi DHCP default tidak dapat dimodifikasi.
400	InvalidRegionId.NotFound	The specified RegionId does not exist.	Parameter tidak valid.
400	IllegalParam.LeaseTime	LeaseTime [%s] is illegal.	Parameter LeaseTime yang ditentukan tidak valid.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.