AttachDhcpOptionsSetToVpc - Virtual Private Cloud - Alibaba Cloud Documentation Center

Memanggil operasi AttachDhcpOptionsSetToVpc untuk menyambungkan set opsi DHCP ke VPC.

Deskripsi operasi

AttachDhcpOptionsSetToVpc adalah operasi asinkron. Setelah Anda mengirim permintaan, sistem akan mengembalikan ID permintaan, tetapi set opsi DHCP belum tersambung ke VPC. Tugas penyambungan masih berjalan di latar belakang. Anda dapat memanggil DescribeVpcAttribute untuk mengecek status penyambungan set opsi DHCP:
- Jika set opsi DHCP berada dalam status Pending, set opsi DHCP sedang dalam proses penyambungan.
- Jika set opsi DHCP berada dalam status InUse, set opsi DHCP telah tersambung.
AttachDhcpOptionsSetToVpc tidak mendukung penyambungan beberapa set opsi DHCP secara bersamaan ke VPC yang sama.

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

update

*DhcpOptionsSet.

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

*VPC.

acs:vpc:{#regionId}:{#accountId}:vpc/{#VpcId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	Wilayah tempat set opsi DHCP berada. Anda dapat memanggil operasi DescribeRegions untuk menanyakan ID wilayah.	cn-hangzhou
DhcpOptionsSetId	string	Yes	ID set opsi DHCP.	dopt-o6w0df4epg9zo8isy****
VpcId	string	Yes	ID VPC yang ingin Anda sambungkan dengan set opsi DHCP.	vpc-sfdkfdjkdf****
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token tersebut, tetapi harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Nilai ClientToken hanya boleh berisi karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem akan menggunakan RequestId sebagai ClientToken. RequestId dapat 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 tanpa mengasosiasikan set opsi DHCP dengan VPC terkait. Sistem akan memeriksa permintaan terhadap potensi masalah, termasuk apakah AccessKey valid, otorisasi pengguna Resource Access Management (RAM), dan apakah parameter yang diperlukan telah ditentukan. Jika pemeriksaan gagal, kesalahan yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode kesalahan `DryRunOperation` akan dikembalikan. false (default): mengirim permintaan normal. Jika pemeriksaan berhasil, kode status HTTP 2XX akan dikembalikan dan set opsi DHCP akan diasosiasikan dengan VPC.	false

Elemen respons

Element	Type	Description	Example
	object
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	Forbidden.OperateShareResource	You cannot operate shared resources.	Operasi dilarang karena Sumber daya adalah resource yang dibagikan.
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	InvalidVpcId.NotFound	Specified value of VpcId is not found in our record.
400	IncorrectStatus.VpcDhcpOptionsSet	The dhcpOptionsSet status of VPC does not support this operation.	Operasi tidak diizinkan karena set opsi DHCP yang terkait dengan VPC saat ini berada dalam status transisi.
400	OperationFailed.AttachmentExist	The current VPC is already attached to a DHCP options set.	VPC saat ini sudah diasosiasikan dengan instans set opsi DHCP. Anda tidak dapat mengasosiasikan instans lain.
400	QuotaExceeded.AttachVpcNumber	The maximum number of VPCs that can be attached to a DHCP options set is exceeded.	Jumlah VPC yang dapat diasosiasikan dengan satu set opsi DHCP telah melebihi kuota.
400	TaskConflict	The operation is too frequent. Please wait a moment and try again.	Operasi terlalu sering. Tunggu sebentar dan coba lagi.
400	MissingParam.VpcId	You must specify VpcId.	Parameter tidak ada. Parameter vpcId diperlukan.
400	MissingParam.DhcpOptionsSetId	Missing parameter DhcpOptionsSetId.	Parameter DhcpOptionsSetId tidak ada.
400	InvalidRegionId.NotFound	The specified RegionId does not exist.	Parameter tidak valid.
400	IncorrectStatus.VpcDnsHostnameStatus	The DnsHostname status of vpc does not support this operation.	Status nama domain privat VPC saat ini tidak mendukung operasi ini.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.