CreateDhcpOptionsSet - Virtual Private Cloud - Alibaba Cloud Documentation Center

Membuat set opsi DHCP.

Deskripsi operasi

CreateDhcpOptionsSet merupakan operasi asinkron. Setelah Anda memanggil operasi ini, sistem akan mengembalikan ID instans, tetapi set opsi DHCP belum selesai dibuat karena prosesnya masih berjalan di node latar belakang. Anda dapat memanggil GetDhcpOptionsSet untuk mengekueri status pembuatan set opsi DHCP:
- Jika vSwitch berada dalam status Pending, set opsi DHCP sedang dikonfigurasi.
- Jika vSwitch berada dalam status Available, set opsi DHCP aktif.

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

create

*DhcpOptionsSet.

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	Wilayah tempat set opsi DHCP berada. Anda dapat memanggil DescribeRegions untuk mengekueri ID wilayah.	cn-hangzhou
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, Instance ECS akan 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
DhcpOptionsSetName	string	No	Nama set opsi DHCP. Nama harus terdiri dari 1 hingga 128 karakter dan harus dimulai 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 terdiri dari 1 hingga 256 karakter. Deskripsi harus dimulai dengan huruf atau karakter Tionghoa dan tidak boleh dimulai dengan `http://` atau `https://`.	description
DomainName	string	No	Sufiks hostname. Contoh: example.com. Setelah set opsi DHCP dikaitkan dengan VPC, sufiks hostname akan disinkronkan secara otomatis ke Instance ECS di VPC yang terkait.	example.com
ResourceGroupId	string	No	ID kelompok sumber daya tempat set opsi DHCP berada.	rg-acfmxazb4ph****
Tag	array<object>	No	Tag resource.
	object	No	Tag.
Key	string	No	Kunci tag resource. Anda dapat menentukan hingga 20 kunci tag. Kunci tag tidak boleh berupa string kosong. Kunci tag dapat terdiri dari maksimal 128 karakter. Kunci tag tidak boleh dimulai dengan `aliyun` atau `acs:` dan tidak boleh mengandung `http://` atau `https://`.	FinanceDept
Value	string	No	Nilai tag resource. Anda dapat menentukan hingga 20 nilai tag. Nilai tag dapat berupa string kosong. Nilai tag dapat terdiri dari maksimal 128 karakter. Nilai tag tidak boleh dimulai dengan `aliyun` atau `acs:` dan tidak boleh mengandung `http://` atau `https://`.	FinanceJoshua
ClientToken	string	No	Token client yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menghasilkan token ini di sisi client, tetapi pastikan token tersebut unik di antara permintaan yang berbeda. Nilai ClientToken hanya boleh berisi karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem akan secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.	0c593ea1-3bea-11e9-b96b-88e9fe637760
DryRun	boolean	No	Menentukan apakah akan melakukan dry run. Nilai yang valid: true: melakukan dry run. Sistem akan memeriksa parameter yang diperlukan, sintaks permintaan, dan batasan. Jika permintaan gagal dalam dry run, pesan kesalahan akan dikembalikan. Jika permintaan lolos dry run, kode kesalahan `DryRunOperation` akan dikembalikan. false (default): melakukan dry run dan mengirim permintaan. Jika permintaan lolos dry run, kode status HTTP 2xx akan dikembalikan dan set opsi DHCP akan dibuat.	false
LeaseTime	string	No	Waktu sewa set opsi DHCP IPv4. Jika waktu sewa dalam satuan jam, satuannya adalah h. Nilai yang valid: 24h hingga 1176h dan 87600h hingga 175200h. Nilai default: 87600h. Jika waktu sewa dalam satuan hari, satuannya adalah d. Nilai yang valid: 1d hingga 49d dan 3650d hingga 7300d. Nilai default: 3650d. Catatan Anda harus menyertakan satuan saat menentukan nilai.	3650d
Ipv6LeaseTime	string	No	Waktu sewa set opsi DHCP IPv6. Jika waktu sewa dalam satuan jam, satuannya adalah h. Nilai yang valid: 24h hingga 1176h dan 87600h hingga 175200h. Nilai default: 24h. Jika waktu sewa dalam satuan hari, satuannya adalah d. Nilai yang valid: 1d hingga 49d dan 3650d hingga 7300d. Nilai default: 1d. Catatan Anda harus menyertakan satuan saat menentukan nilai.	3650d

Elemen respons

Element	Type	Description	Example
	object	ID set opsi DHCP yang dibuat.
DhcpOptionsSetId	string	ID set opsi DHCP yang dibuat.	dopt-o6w0df4epg9zo8isy****
RequestId	string	ID permintaan.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0
ResourceGroupId	string	ID kelompok sumber daya tempat set opsi DHCP berada.	rg-acfmxazb4ph****

Contoh

Respons sukses

JSONformat

{
  "DhcpOptionsSetId": "dopt-o6w0df4epg9zo8isy****",
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "ResourceGroupId": "rg-acfmxazb4ph****"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
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	InvalidDomainNameServers.Malformed	The specified format of DomainNameServers is invalid.	Format parameter DomainNameServers yang ditentukan salah. Periksa apakah parameter sudah benar.
400	QuotaExceeded.DomainNameServers	The maximum number of domain name servers cannot exceed 4.	Jumlah DomainNameServers yang dikonfigurasi melebihi 4.
400	IllegalParam.DomainNameServers	The specified DomainNameServers is invalid.	Parameter DomainNameServers yang ditentukan tidak valid. Periksa apakah parameter sudah benar.
400	IllegalParam.DomainName	The specified DomainName is invalid.	Parameter DomainName yang ditentukan tidak valid. Periksa apakah parameter sudah benar.
400	IllegalParam.DhcpOptionsSetName	The specified DhcpOptionsSetName is invalid.	Parameter DhcpOptionsSetName yang ditentukan tidak valid. Periksa apakah parameter sudah benar.
400	IllegalParam.DhcpOptionsSetDescription	The specified DhcpOptionsSetDescription is invalid.	Parameter DhcpOptionsSetDescription yang ditentukan tidak valid. Periksa apakah parameter sudah benar.
400	QuotaExceeded.RegionDhcpOptionsSet	The quota of dhcpOptionsSet in the region is exceeded.	Jumlah instans set opsi DHCP yang dapat dibuat oleh satu pengguna telah melebihi kuota.
400	OperationUnsupported.DhcpLeaseTime	The DhcpOptionsSet of this region does not support custom LeaseTime.	Set opsi DHCP di wilayah ini tidak mendukung LeaseTime kustom.
400	IllegalParam.LeaseTime	LeaseTime [%s] is illegal.	Parameter LeaseTime yang ditentukan tidak valid.
400	InvalidRegionId.NotFound	The specified RegionId does not exist.	RegionId yang ditentukan tidak ada. Periksa apakah produk ini tersedia di wilayah yang ditentukan.
400	IllegalParam.Ipv6LeaseTime	Ipv6LeaseTime [%s] is illegal.	Parameter Ipv6LeaseTime yang ditentukan tidak valid.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.