ListDhcpOptionsSets - Virtual Private Cloud - Alibaba Cloud Documentation Center

Memanggil operasi ListDhcpOptionsSets untuk mengkueri daftar kumpulan opsi DHCP yang telah dibuat.

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

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID region tempat kumpulan opsi DHCP berada. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID region.	cn-hangzhou
NextToken	string	No	Token yang menentukan titik awal kueri. Nilai valid: Anda tidak perlu menentukan parameter ini untuk permintaan pertama atau jika tidak ada kueri berikutnya yang akan dikirim. Jika kueri berikutnya akan dikirim, setel nilainya ke nilai NextToken yang dikembalikan pada pemanggilan terakhir.	FFmyTO70tTpLG6I3FmYAXGKPd****
MaxResults	integer	No	Jumlah entri yang dikembalikan per halaman. Nilai valid: 1 hingga 100. Nilai default: 10.	10
DomainName	string	No	Sufiks hostname, misalnya example.com. Setelah kumpulan opsi DHCP dikaitkan dengan virtual private cloud (VPC), sufiks hostname secara otomatis disinkronkan ke instans Elastic Compute Service (ECS) di dalam VPC. Valid values: example.com : example.com	example.com
DhcpOptionsSetName	string	No	Nama kumpulan opsi DHCP. Nama harus terdiri dari 1 hingga 128 karakter dan tidak boleh diawali dengan `http://` atau `https://`. Nama harus diawali dengan huruf dan dapat berisi digit, garis bawah (_), serta tanda hubung (-). Valid values: tf-testAccVpcDhcpOptionsSets-1585169790614573448 : tf-testAccVpcDhcpOptionsSets-1585169790614573448	test
DhcpOptionsSetId	array	No	ID kumpulan opsi DHCP. Anda dapat menentukan maksimal 20 ID kumpulan opsi DHCP.	dopt-o6w0df4epg9zo8isy****
	string	No	ID kumpulan opsi DHCP. Anda dapat menentukan maksimal 20 ID kumpulan opsi DHCP.	dopt-o6w0df4epg9zo8isy****
ResourceGroupId	string	No	ID grup sumber daya tempat kumpulan opsi DHCP berada.	rg-acfmxazb4ph****
Tags	array<object>	No	Daftar tag.
	object	No	Daftar tag.
Key	string	No	Kunci tag sumber daya. Anda dapat menentukan maksimal 20 kunci tag. Kunci tag tidak boleh berupa string kosong. Kunci tag dapat berukuran hingga 128 karakter. Kunci tag tidak boleh diawali dengan `aliyun` atau `acs:`, dan tidak boleh berisi `http://` atau `https://`.	FinanceDept
Value	string	No	Nilai tag sumber daya. Anda dapat menentukan maksimal 20 nilai tag. Nilai tag boleh berupa string kosong. Nilai tag dapat berukuran hingga 128 karakter. Nilai tag tidak boleh diawali dengan `aliyun` atau `acs:`, dan tidak boleh berisi `http://` atau `https://`.	FinanceJoshua

Elemen respons

Element	Type	Description	Example
	object	Token yang menentukan titik awal kueri berikutnya. Nilai valid: Jika NextToken kosong, tidak ada kueri berikutnya yang akan dikirim. Jika NextToken tidak kosong, nilainya menunjukkan token yang digunakan untuk kueri berikutnya.
NextToken	string	Token yang menentukan titik awal kueri berikutnya. Nilai valid: Jika NextToken kosong, tidak ada kueri berikutnya yang akan dikirim. Jika NextToken tidak kosong, nilainya menunjukkan token yang digunakan untuk kueri berikutnya.	FFmyTO70tTpLG6I3FmYAXGKPd********
RequestId	string	ID permintaan.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0
DhcpOptionsSets	array<object>	Daftar kumpulan opsi DHCP.
	array<object>	Daftar kumpulan opsi DHCP.
DhcpOptionsSetDescription	string	Deskripsi kumpulan opsi DHCP.	test
Status	string	Status kumpulan opsi DHCP. Nilai valid: Available InUse Pending Deleted	Available
DhcpOptionsSetId	string	ID kumpulan opsi DHCP.	dopt-o6w0df4epg9zo8isy****
DhcpOptionsSetName	string	Nama kumpulan opsi DHCP.	test
AssociateVpcCount	integer	Jumlah VPC yang dikaitkan dengan kumpulan opsi DHCP.	2
OwnerId	integer	ID akun Alibaba Cloud tempat kumpulan opsi DHCP berada.	253460731706911258
DhcpOptions	object	Informasi konfigurasi tentang kumpulan opsi DHCP.
DomainNameServers	string	The IP address of the DNS server.	192.168.XX.XX
DomainName	string	The suffix of the hostname.	example.com
LeaseTime	string	The lease time of the IPv4 addresses for the DHCP options set. If you use hours as the unit, valid values are 24h to 1176h and 87600h to 175200h. Default value: 87600h. If you use days as the unit, valid values are 1d to 49d and 3650d to 7300d. Default value: 3650d.	3650d
Ipv6LeaseTime	string	The lease time of the IPv6 DHCP options set. If you use hours as the unit, Unit: h. Valid values are 24h to 1176h and 87600h to 175200h. Default value: 24h. If you use days as the unit, Unit: d. Valid values are 1d to 49d and 3650d to 7300d. Default value: 1d.	3650d
ResourceGroupId	string	ID grup sumber daya tempat kumpulan opsi DHCP berada.	rg-acfmxazb4ph****
Tags	array<object>	Daftar tag.
	object	Daftar tag.
Key	string	The key of tag N added to the resource.	FinanceDept
Value	string	The value of tag N added to the resource.	FinanceJoshua
CreationTime	string	Waktu pembuatan.	2025-08-21 ***
TotalCount	string	Jumlah entri yang dikembalikan.	10

Contoh

Respons sukses

JSONformat

{
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd********",
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "DhcpOptionsSets": [
    {
      "DhcpOptionsSetDescription": "test",
      "Status": "Available",
      "DhcpOptionsSetId": "dopt-o6w0df4epg9zo8isy****",
      "DhcpOptionsSetName": "test",
      "AssociateVpcCount": 2,
      "OwnerId": 253460731706911260,
      "DhcpOptions": {
        "DomainNameServers": "192.168.XX.XX",
        "DomainName": "example.com",
        "LeaseTime": "3650d",
        "Ipv6LeaseTime": "3650d"
      },
      "ResourceGroupId": "rg-acfmxazb4ph****",
      "Tags": [
        {
          "Key": "FinanceDept",
          "Value": "FinanceJoshua"
        }
      ],
      "CreationTime": "2025-08-21 ***"
    }
  ],
  "TotalCount": "10"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	IllegalParam.NextToken	The specified NextToken is invalid.
400	InvalidRegionId.NotFound	The specified RegionId does not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.