All Products
Search

This Product

    Virtual Private Cloud:UpdateDhcpOptionsSetAttribute

    Document Center

    Virtual Private Cloud:UpdateDhcpOptionsSetAttribute

    Last Updated:Jun 12, 2026

    Memanggil operasi UpdateDhcpOptionsSetAttribute untuk memodifikasi konfigurasi himpunan 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

    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

    Region tempat himpunan opsi DHCP yang ingin Anda modifikasi berada. Anda dapat memanggil operasi DescribeRegions untuk meminta ID region.

    cn-hangzhou
    DhcpOptionsSetId

    string

    Yes

    ID dari himpunan opsi DHCP yang ingin Anda modifikasi.

    dopt-o6w0df4epg9zo8isy****
    DomainNameServers

    string

    No

    Alamat IP dari 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 apa pun, instance 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 dari hostname, misalnya, example.com.

    Setelah himpunan opsi DHCP dikaitkan dengan suatu VPC, sufiks hostname secara otomatis disinkronkan ke instance ECS di VPC tersebut.

    example.com
    DhcpOptionsSetName

    string

    No

    Nama dari himpunan opsi DHCP.

    Nama harus memiliki panjang 2 hingga 128 karakter dan harus dimulai dengan huruf atau karakter Tionghoa. Nama dapat berisi digit, garis bawah (_), dan tanda hubung (-).

    name
    DhcpOptionsSetDescription

    string

    No

    Masukkan deskripsi dari himpunan opsi DHCP.

    Deskripsi dapat kosong atau memiliki panjang 2 hingga 256 karakter. Deskripsi harus dimulai dengan huruf atau karakter Tionghoa dan tidak dapat dimulai dengan http:// atau https://.

    description
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi dari permintaan.

    Anda dapat menggunakan klien untuk menghasilkan nilai, tetapi Anda harus memastikan bahwa nilai tersebut unik di antara permintaan yang berbeda. Nilai ClientToken hanya dapat berisi karakter ASCII.

    Catatan

    Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId berbeda untuk setiap permintaan API.

    0c593ea1-3bea-11e9-b96b-88e9fe637760
    DryRun

    boolean

    No

    Menentukan apakah hanya akan melakukan dry run, tanpa melakukan permintaan yang sebenarnya. Nilai yang valid:

    true: melakukan dry run. Sistem memeriksa parameter yang diperlukan, sintaks permintaan, dan batasan. Jika permintaan gagal dalam dry run, pesan kesalahan dikembalikan. Jika permintaan lulus dry run, kode kesalahan DryRunOperation dikembalikan.

    false (default): melakukan dry run dan mengirimkan permintaan. Jika permintaan lulus dry run, kode status HTTP 2xx dikembalikan dan konfigurasi himpunan opsi DHCP dimodifikasi.

    false
    LeaseTime

    string

    No

    Waktu sewa dari himpunan opsi DHCP IPv4.

    • Jika waktu sewa ditentukan dalam jam: Satuan: h. Nilai yang valid: 24h hingga 1176h dan 87600h hingga 175200h. Nilai default: 87600h.

    • Jika waktu sewa ditentukan dalam hari: Satuan: d. Nilai yang valid: 1d hingga 49d dan 3650d hingga 7300d. Nilai default: 3650d.

    Catatan

    Saat Anda memasukkan nilai, Anda juga harus menentukan satuannya.

    3650d
    Ipv6LeaseTime

    string

    No

    Waktu sewa dari himpunan opsi DHCP IPv6.

    • Jika waktu sewa ditentukan dalam jam: Satuan: h. Nilai yang valid: 24h hingga 1176h dan 87600h hingga 175200h. Nilai default: 24h.

    • Jika waktu sewa ditentukan dalam hari: Satuan: d. Nilai yang valid: 1d hingga 49d dan 3650d hingga 7300d. Nilai default: 1d.

    Catatan

    Saat Anda memasukkan nilai, Anda juga harus menentukan satuannya.

    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.
    400 IncorrectStatus.DhcpOptionsSet The DhcpOptionsSet status does not support this operation.
    400 IllegalParam.DomainNameServers The specified DomainNameServers is invalid.
    400 IllegalParam.DomainName The specified DomainName is invalid.
    400 IllegalParam.DhcpOptionsSetName The specified DhcpOptionsSetName is invalid.
    400 IllegalParam.DhcpOptionsSetDescription The specified DhcpOptionsSetDescription is invalid.
    400 OperationUnsupported.DhcpLeaseTime The DhcpOptionsSet of this region does not support custom LeaseTime.
    400 OperationUnsupported.DhcpOptionsSet The DHCP options set feature in this region is not supported.
    400 OperationDenied.ModifyDefaultDhcpOptionsSet The default DHCP options set is not allowed to be modified.
    400 InvalidRegionId.NotFound The specified RegionId does not exist.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.