All Products
Search

This Product

    Virtual Private Cloud:UpdateNetworkAclEntries

    Document Center

    Virtual Private Cloud:UpdateNetworkAclEntries

    Last Updated:Jun 12, 2026

    Memperbarui aturan ACL jaringan dengan memanggil operasi UpdateNetworkAclEntries.

    Deskripsi operasi

    • Operasi UpdateNetworkAclEntries adalah operasi asinkron. Setelah permintaan dikirim, sistem mengembalikan ID permintaan, tetapi aturan ACL jaringan belum diperbarui. Sistem menjalankan tugas pembaruan di latar belakang. Anda dapat memanggil operasi DescribeNetworkAclAttributes untuk mengkueri status pembaruan aturan ACL jaringan:

      • Jika aturan ACL jaringan berada dalam status Modifying, aturan ACL jaringan sedang diperbarui.

      • Jika aturan ACL jaringan berada dalam status Available, aturan ACL jaringan telah diperbarui.

    • Operasi UpdateNetworkAclEntries tidak dapat dipanggil untuk memperbarui aturan ACL jaringan yang sama secara bersamaan.

    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
    IngressAclEntries

    array<object>

    No

    Informasi tentang aturan arah masuk.

    object

    No

    Informasi tentang aturan arah masuk.

    NetworkAclEntryId

    string

    No

    ID entri aturan arah masuk.

    Nilai N berkisar dari 0 hingga 99. Anda dapat memperbarui informasi untuk hingga 100 aturan arah masuk.

    nae-2zepn32de59j8m4****
    EntryType

    string

    No

    Jenis aturan. Tetapkan nilai ke custom, yang menunjukkan aturan kustom.

    custom
    NetworkAclEntryName

    string

    No

    Nama entri aturan arah masuk.

    Panjang nama harus 1 hingga 128 karakter dan tidak boleh diawali dengan http:// atau https://.

    acl-3
    Policy

    string

    No

    Kebijakan otorisasi. Nilai valid:

    • accept: mengizinkan akses.

    • drop: menolak akses.

    Valid values:

    • drop :

      drop

    • accept :

      accept

    accept
    SourceCidrIp

    string

    No

    Blok CIDR sumber. Daftar awalan juga didukung.

    10.0.0.0/24 pl-xxxxxx
    IpVersion

    string

    No

    Versi IP:

    • IPv4

    • IPv6.

    Valid values:

    • IPv6 :

      IPv6

    • IPv4 :

      IPv4

    IPv4
    Description

    string

    No

    Deskripsi aturan arah masuk.

    Panjang deskripsi harus 1 hingga 256 karakter dan tidak boleh diawali dengan http:// atau https://.

    This is IngressAclEntries.
    Protocol

    string

    No

    Jenis protokol. Nilai valid:

    • icmp: Internet Control Message Protocol.

    • gre: Generic Routing Encapsulation Protocol.

    • tcp: Transmission Control Protocol.

    • udp: User Datagram Protocol.

    • all: semua protokol.

    • icmpv6: Internet Control Message Protocol for IPv6.

    Valid values:

    • all :

      all

    • tcp :

      tcp

    • udp :

      udp

    • gre :

      gre

    • icmp :

      icmp

    • icmpv6 :

      icmpv6

    all
    Port

    string

    No

    Range Port sumber aturan arah masuk.

    • Jika Protocol aturan arah masuk diatur ke all, icmp, atau gre, range Port adalah -1/-1, yang menunjukkan semua Port.

    • Jika Protocol aturan arah masuk diatur ke tcp atau udp, range Port adalah 1 hingga 65535. Tentukan range dalam format 1/200 atau 80/80, yang menunjukkan Port 1 hingga Port 200 atau Port 80.

    -1/-1
    EgressAclEntries

    array<object>

    No

    Informasi tentang aturan arah keluar.

    object

    No

    Informasi tentang aturan arah keluar.

    NetworkAclEntryId

    string

    No

    ID entri aturan arah keluar.

    Nilai N berkisar dari 0 hingga 99. Anda dapat memperbarui informasi untuk hingga 100 aturan arah keluar.

    nae-2zecs97e0brcge46****
    EntryType

    string

    No

    Jenis aturan. Tetapkan nilai ke custom, yang menunjukkan aturan kustom.

    custom
    NetworkAclEntryName

    string

    No

    Nama entri aturan arah keluar.

    Panjang nama harus 1 hingga 128 karakter dan tidak boleh diawali dengan http:// atau https://.

    acl-2
    Policy

    string

    No

    Kebijakan otorisasi. Nilai valid:

    • accept: mengizinkan akses.

    • drop: menolak akses.

    Valid values:

    • drop :

      drop

    • accept :

      accept

    accept
    Description

    string

    No

    Deskripsi aturan arah keluar.

    Panjang deskripsi harus 1 hingga 256 karakter dan tidak boleh diawali dengan http:// atau https://.

    This is EgressAclEntries.
    Protocol

    string

    No

    Jenis protokol. Nilai valid:

    • icmp: Internet Control Message Protocol.

    • gre: Generic Routing Encapsulation Protocol.

    • tcp: Transmission Control Protocol.

    • udp: User Datagram Protocol.

    • all: semua protokol.

    • icmpv6: Internet Control Message Protocol for IPv6.

    Valid values:

    • all :

      all

    • tcp :

      tcp

    • udp :

      udp

    • gre :

      gre

    • icmp :

      icmp

    • icmpv6 :

      icmpv6

    all
    DestinationCidrIp

    string

    No

    Blok CIDR tujuan. Daftar awalan juga didukung.

    10.0.0.0/24 pl-xxxxxx
    IpVersion

    string

    No

    Versi IP:

    • IPv4

    • IPv6.

    Valid values:

    • IPv6 :

      IPv6

    • IPv4 :

      IPv4

    IPv4
    Port

    string

    No

    Range Port tujuan aturan arah keluar.

    • Jika Protocol aturan arah keluar diatur ke all, icmp, atau gre, range Port adalah -1/-1, yang menunjukkan semua Port.

    • Jika Protocol aturan arah keluar diatur ke tcp atau udp, range Port adalah 1 hingga 65535. Tentukan range dalam format 1/200 atau 80/80, yang menunjukkan Port 1 hingga Port 200 atau Port 80.

    -1/-1
    UpdateIngressAclEntries

    boolean

    No

    Apakah akan memperbarui aturan arah masuk. Nilai valid:

    • true: memperbarui aturan.

    • false (default): tidak memperbarui aturan.

    Catatan

    Parameter ini tidak mendukung modifikasi inkremental. Jika ACL sudah memiliki aturan arah masuk dan Anda ingin menambahkan aturan arah masuk lain, Anda harus meneruskan kedua aturan saat memanggil API ini. Jika Anda hanya meneruskan aturan arah masuk yang baru ditambahkan, aturan arah masuk yang ada akan dihapus.

    false
    UpdateEgressAclEntries

    boolean

    No

    Apakah akan memperbarui aturan arah keluar. Nilai valid:

    • true: memperbarui aturan.

    • false (default): tidak memperbarui aturan.

    Catatan

    Parameter ini tidak mendukung modifikasi inkremental. Jika ACL sudah memiliki aturan arah keluar dan Anda ingin menambahkan aturan arah keluar lain, Anda harus meneruskan kedua aturan saat memanggil API ini. Jika Anda hanya meneruskan aturan arah keluar yang baru ditambahkan, aturan arah keluar yang ada akan dihapus.

    false
    NetworkAclId

    string

    Yes

    ID ACL jaringan.

    nacl-bp1lhl0taikrzxsc****
    RegionId

    string

    Yes

    ID wilayah ACL jaringan.

    Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.

    cn-hangzhou
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

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

    Catatan

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

    123e4567-e89b-12d3-a456-426655440000
    DryRun

    boolean

    No

    Apakah akan menjalankan dry run.

    true
    RegionId

    string

    Yes

    The region ID of the network ACL.

    You can call the DescribeRegions operation to query the region ID.

    cn-hangzhou

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    1170A5A0-E760-4331-9133-A7D38D973215

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "1170A5A0-E760-4331-9133-A7D38D973215"
}

    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.Port ParameterMissing.Port
    400 ParameterIllegal.Port ParameterIllegal.Port
    400 ParameterIllegal.Policy ParameterIllegal.Policy
    400 ParameterMissing.Policy ParameterMissing.Policy
    400 ParameterIllegal.Protocol ParameterIllegal.Protocol
    400 ParameterMissing.Protocol ParameterMissing.Protocol
    400 ParameterLengthIllegal.Name ParameterLengthIllegal.Name
    400 ParameterIllegal.Name ParameterIllegal.Name
    400 ParameterLengthIllegal.Description ParameterLengthIllegal.Description
    400 ParameterIllegal.Description ParameterIllegal.Description
    400 ParameterIllegal.SourceCidrIp ParameterIllegal.SourceCidrIp
    400 ParameterMissing.SourceCidrIp ParameterMissing.SourceCidrIp
    400 ParameterIllegal.DestinationCidrIp ParameterIllegal.DestinationCidrIp
    400 ParameterMissing.DestinationCidrIp ParameterMissing.DestinationCidrIp
    400 QuotaExceed.NetworkAclEntry Network acl entry is over limit.
    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 NotSupport.NetworkAcl Network acl is not support now.
    400 IllegalParam.IngressAclEntryId The specified IngressAclEntryId is invalid.
    400 IllegalParam.EgressAclEntryId The specified EgressAclEntryId is invalid.
    400 OperationDenied.VpcIpv6NotEnabled IPv6 has not been enabled for the VPC.
    400 IllegalParam.SourceCidrIp Param SourceCidrIp is illegal.
    400 IllegalParam.Policy Param Policy illegal.
    400 IllegalParam.Protocol Param Protocol illegal.
    400 IllegalParam.DestinationCidrIp Param DestinationCidrIp illegal.
    400 IllegalParam.IpVersion Param IpVersion illegal.
    400 IllegalParam.PortRange The specified port range is invalid.
    400 ResourceNotFound.PrefixList The specified resource of prefixList is not found.
    400 OperationDenied.IpVersionInconsistencyWithPrefixList The ip version of the prefix list %s you passed in is inconsistent with the actual ip version of the prefix list.
    400 OperationDenied.SystemPrefixList The operation is not allowed because of SystemPrefixList.
    400 IncorrectStatus.PrefixList The status of prefixList is incorrect.
    400 UnsupportedRegion.PrefixListEntry The feature of prefixList entry is not supported in this region.
    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.