金山云-文档中心-更新网络ACL规则

接口描述

您可以通过该接口向指定网络ACL中添加规则。

请求头

参数名称	类型	是否必须	描述
X-Version	String	是	版本号，取值：2020-08-01
X-Action	String	是	操作接口名，取值：UpdateNetworkAclEntries

请求参数

参数名称	类型	是否必须	示例值	描述
NamespaceId	String	是	default-UID	命名空间ID
VpcId	String	是	458f4e89-6be0-4303-a31c-280895c07658	VPCID
NetworkAclId	String	是	458f4e89-6be0-4303-a31c-280895c07658	网络ACL ID
NetworkAclEntries	Array

NetworkAclEntries

参数名称	类型	是否必须	示例值	描述
NetworkAclEntryId	String	是	10000	网络ACL规则 ID
NetworkAclEntryName	String	是	acl1	ACL规则名称
Action	String	是	ACCEPT	ACL规则动作，允许或禁止
Protocol	String	是	ip	tcp
DestinationPortRangeFrom	Integer	否	1-65535	TCP或者UDP协议的端口规则的起始端口，范围为1-65535，只有协议为TCP/UDP类型时，才必填
DestinationPortRangeTo	Integer	否	1-65535	TCP或者UDP协议的端口规则结束端口，范围为1-65535，只有协议为TCP/UDP类型时，才必填
CidrBlock	String	否	10.0.0.0/8	安全组规则网段

返回参数

参数名称	类型	示例值	描述
RequestId	String	3a87cc31-efe6-487c-b28b-11bec3571e7d	请求ID
Code	String	Success	状态码,有InvalidParameter,Forbidden InternalError,Success四种状态

请求示例

入参示例

curl --location --request POST 'kenc.api.ksyun.com' \
--header 'X-Action: UpdateNetworkAclEntries' \
--header 'X-Version: V1.4' \
--header 'X-Amz-Date: 20210517T025443Z' \
--header 'Authorization: AWS4-HMAC-SHA256 Credential=AKLTTCrDNnS2S2iHLvz_zawSMg/20210517/beijing-6/kenc/aws4_request, SignedHeaders=host;x-amz-date, Signature=xxxxxxxxxx' \
--data '{"NamespaceId": "demo", "VpcId": "4a70ee3b-9a6e-4ae9-a982-1134d6ec1614", "NetworkAclId": "69fa7d2e-ddd6-4800-a898-4736396fb9a3", "NetworkAclEntries": [{"NetworkAclEntryId": "10000", "NetworkAclEntryName": "modify_rule_name"}]}'

成功示例

{
    "Code": "Success",
    "RequestId": "3a87cc31-efe6-487c-b28b-11bec3571e7d"
}

失败示例

{  
    "RequestId": "1312fefe-ca48-4d72-8521-cf5d2cf06b9c",
    "Code": "InvalidParameter",
    "Message": "Invalid param NamespaceId."
}