CreateNetworkAcl - Virtual Private Cloud - Alibaba Cloud Documentation Center

Membuat daftar kontrol akses jaringan (network ACL).

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
VpcId	string	Yes	ID virtual private cloud (VPC) tempat network ACL berada.	vpc-dsfd34356vdf****
NetworkAclName	string	No	Nama network ACL. Nama harus terdiri dari 1 hingga 128 karakter, dan tidak boleh diawali dengan `http://` atau `https://`.	acl-1
Description	string	No	Deskripsi network ACL. Deskripsi harus terdiri dari 1 hingga 256 karakter, dan tidak boleh diawali dengan `http://` atau `https://`.	This is my NetworkAcl.
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan nilainya, tetapi Anda harus memastikan bahwa nilai tersebut unik di antara permintaan yang berbeda. Token klien hanya boleh 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 akan memeriksa permintaan. Nilai yang valid: true: mengirim permintaan pemeriksaan. false (default): mengirim permintaan normal.	false
Tag	array<object>	No	Tag dari sumber daya.
	object	No	Tag.
Key	string	No	Kunci tag. Anda dapat menentukan hingga 20 kunci tag. Kunci tag tidak boleh berupa string kosong. Kunci tag dapat memiliki panjang hingga 128 karakter, dan tidak boleh diawali dengan `aliyun` atau `acs:`. Kunci tag tidak boleh berisi `http://` atau `https://`.	FinanceDept
Value	string	No	Nilai tag. Anda dapat menentukan hingga 20 nilai tag. Nilai tag dapat berupa string kosong. Nilai tag dapat memiliki panjang hingga 128 karakter, dan tidak boleh diawali dengan `aliyun` atau `acs:`. Nilai tag tidak boleh berisi `http://` atau `https://`.	FinanceJoshua
RegionId	string	Yes	ID region dari network ACL. Anda dapat memanggil operasi DescribeRegions untuk menanyakan daftar region terbaru.	cn-hangzhou

Elemen respons

Element	Type	Description	Example
	object
NetworkAclId	string	ID dari network ACL.	nacl-a2do9e413e0spzasx****
RequestId	string	ID permintaan.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0
NetworkAclAttribute	object	Atribut dari network ACL.
Status	string	Status dari network ACL. Nilai yang valid: Available: tersedia. Modifying: sedang dikonfigurasi.	Modifying
VpcId	string	ID dari VPC tempat network ACL berada.	vpc-a2d33rfpl72k5xsscd****
CreationTime	string	Waktu network ACL dibuat.	2021-12-25 11:33:27
Description	string	Deskripsi network ACL.	This is my NetworkAcl.
NetworkAclName	string	Nama network ACL.	acl-1
NetworkAclId	string	ID dari network ACL.	nacl-a2do9e413e0spdefr****
RegionId	string	ID region dari network ACL.	cn-hangzhou
IngressAclEntries	object
IngressAclEntry	array<object>	The inbound rules.
	object
NetworkAclEntryId	string	The ID of the inbound rule.	nae-a2dk86arlydmexscd****
NetworkAclEntryName	string	The name of the inbound rule.	acl-3
Policy	string	The action to be performed on network traffic that matches the rule. Valid values: accept drop	accept
Description	string	The description of the inbound rule.	This is IngressAclEntries.
SourceCidrIp	string	The source CIDR block.	10.0.0.0/24
Protocol	string	The protocol. Valid values: icmp gre tcp udp all	all
Port	string	The destination port range of the inbound traffic. If the protocol of the inbound rule is set to all, icmp, or gre, the port range is -1/-1, which specifies all ports. If the protocol of the inbound rule is set to tcp or udp, set the port range in the following format: 1/200 or 80/80, which specifies port 1 to port 200 or port 80. Valid ports: 1 to 65535.	-1/-1
EgressAclEntries	object
EgressAclEntry	array<object>	The outbound rules.
	object
NetworkAclEntryId	string	The ID of the outbound rule.	nae-a2d447uw4tillxsdc****
NetworkAclEntryName	string	The name of the outbound rule.	acl-2
Policy	string	The action to be performed on network traffic that matches the rule. Valid values: accept drop	accept
Description	string	The description of the outbound rule.	This is EgressAclEntries.
Protocol	string	The protocol. Valid values: icmp gre tcp udp all	all
DestinationCidrIp	string	The destination CIDR block.	10.0.0.0/24
Port	string	The destination port range of the outbound traffic. If the protocol of the outbound rule is set to all, icmp, or gre, the port range is -1/-1, which specified all ports. If the protocol of the outbound rule is set to tcp or udp, set the port range in the following format: 1/200 or 80/80, which specifies port 1 to port 200 or port 80. Valid values for a port: 1 to 65535.	-1/-1
Resources	object
Resource	array<object>	The information about the associated resources.
	object
Status	string	The association status of the resource. Valid values: BINDED BINDING UNBINDING	BINDED
ResourceType	string	The type of resource with which you want to associate the network ACL.	VSwitch
ResourceId	string	The ID of the associated resource.	vsw-bp1de348lntdwgthy****

Contoh

Respons sukses

JSONformat

{
  "NetworkAclId": "nacl-a2do9e413e0spzasx****",
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "NetworkAclAttribute": {
    "Status": "Modifying",
    "VpcId": "vpc-a2d33rfpl72k5xsscd****",
    "CreationTime": "2021-12-25 11:33:27",
    "Description": "This is my NetworkAcl.",
    "NetworkAclName": "acl-1\t",
    "NetworkAclId": "nacl-a2do9e413e0spdefr****",
    "RegionId": "cn-hangzhou\t",
    "IngressAclEntries": {
      "IngressAclEntry": [
        {
          "NetworkAclEntryId": "nae-a2dk86arlydmexscd****",
          "NetworkAclEntryName": "acl-3\t",
          "Policy": "accept",
          "Description": "This is IngressAclEntries.\t",
          "SourceCidrIp": "10.0.0.0/24\t",
          "Protocol": "all",
          "Port": "-1/-1"
        }
      ]
    },
    "EgressAclEntries": {
      "EgressAclEntry": [
        {
          "NetworkAclEntryId": "nae-a2d447uw4tillxsdc****",
          "NetworkAclEntryName": "acl-2",
          "Policy": "accept",
          "Description": "This is EgressAclEntries.",
          "Protocol": "all",
          "DestinationCidrIp": "10.0.0.0/24",
          "Port": "-1/-1\t"
        }
      ]
    },
    "Resources": {
      "Resource": [
        {
          "Status": "BINDED",
          "ResourceType": "VSwitch",
          "ResourceId": "vsw-bp1de348lntdwgthy****"
        }
      ]
    }
  }
}

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.VpcId	ParameterMissing.VpcId
400	ParameterLengthIllegal.Name	ParameterLengthIllegal.Name	The length of the rule name is invalid.
400	ParameterIllegal.Name	ParameterIllegal.Name	The name of the entry is invalid.
400	ParameterLengthIllegal.Description	ParameterLengthIllegal.Description
400	ParameterIllegal.Description	ParameterIllegal.Description
400	ParameterEmpty.VpcId	ParameterEmpty.VpcId
400	InvalidVpcId.NotFound	The vpc is not exist.
400	QuotaExceed.NetworkAcl	Network acl is over limit.
400	NotSupport.NetworkAcl	Network acl is not support now.
400	IllegalParamFormat.%s	The param format of %s is illegal.	The parameter mode is invalid.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.