All Products
Search
Document Center

Virtual Private Cloud:AssociateNetworkAcl

Last Updated:Jun 12, 2026

Memanggil operasi AssociateNetworkAcl untuk menyambungkan ACL jaringan ke vSwitch.

Deskripsi operasi

  • AssociateNetworkAcl adalah operasi asinkron. Setelah Anda mengirim permintaan, sistem akan mengembalikan ID permintaan, tetapi ACL jaringan belum tersambung. Tugas penyambungan terus berjalan di latar belakang. Anda dapat memanggil DescribeNetworkAclAttributes untuk mengkueri status penyambungan ACL jaringan:
    • Jika ACL jaringan berada dalam status BINDING, ACL jaringan sedang disambungkan.

    • Jika ACL jaringan berada dalam status BINDED, ACL jaringan telah tersambung.

  • AssociateNetworkAcl tidak mendukung penyambungan konkuren untuk ACL jaringan 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

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

Parameter permintaan

Parameter

Type

Required

Description

Example

Resource

array<object>

No

Informasi mengenai Sumber daya yang tersambung.

object

No

Informasi mengenai Sumber daya yang tersambung.

ResourceType

string

Yes

Tipe Sumber daya yang tersambung. Nilai valid: VSwitch: vSwitch.

Nilai valid N: 0 hingga 29. Anda dapat menyambungkan hingga 30 Sumber daya.

VSwitch

ResourceId

string

Yes

ID Sumber daya yang tersambung.

vsw-bp1de348lntdw****

NetworkAclId

string

Yes

ID ACL jaringan.

nacl-a2do9e413e0sp****

RegionId

string

Yes

ID wilayah tempat ACL jaringan berada. Anda dapat memanggil operasi DescribeRegions untuk mendapatkan ID wilayah.

cn-hangzhou

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. 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 dari setiap permintaan API mungkin berbeda.

123e4567-e89b-12d3-a456-426655440000

DryRun

boolean

No

Apakah akan menjalankan dry run. Nilai valid:

  • true: Menjalankan dry run. Sistem memeriksa parameter wajib, sintaks permintaan, dan batas.

  • false (default): Mengirim permintaan.

false

RegionId

string

Yes

网络 ACL 所在的地域 ID。您可以通过调用 DescribeRegions 接口获取地域 ID。

cn-hangzhou

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

4CF20CC7-D1FC-425B-A15B-DF7C8E2131A7

Contoh

Respons sukses

JSONformat

{
  "RequestId": "4CF20CC7-D1FC-425B-A15B-DF7C8E2131A7"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 ParameterMissing.AliUid ParameterMissing.AliUid
400 ParameterMissing.Bid ParameterMissing.Bid
400 ParameterMissing.RegionId ParameterMissing.RegionId
400 ParameterEmpty.RegionId ParameterEmpty.RegionId
400 ParameterMissing.NetworkAclId ParameterMissing.NetworkAclId
400 ParameterEmpty.NetworkAclId ParameterEmpty.NetworkAclId
400 ParameterMissing.Resources ParameterMissing.Resources
400 ParameterEmpty.Resources ParameterEmpty.Resources
400 InvalidNetworkAcl.NotFound The special Network Acl is not found.
400 NetworkStatus.Modifying The special Network Acl is in modifying.
400 ResourceStatus.Error The binding instance is in middle status.
400 InvalidResource.NotFound The binding instance is not found.
400 InvalidResource.VpcError The network acl and resource not in same vpc.
400 InvalidResource.BindingExist The binding instance has been binded.
400 NotSupport.NetworkAcl Network acl is not support now.
400 ParameterIllegal.ResourceType The specified resource type is illegal.
400 MissingParam.Resource Missing parameter Resource.
400 OperationDenied.NetworkAclAttachmentInMiddleStatus The network ACL is being bound to or unbound from the switch.
500 InternalError The request processing has failed due to some unknown error.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.