addNetworkAclInboundRule

Prev Next

Available in VPC

Add a list of inbound rules for a network ACL.

Request

This section describes the request format. The method and URI are as follows:

Method URI
GET, POST /addNetworkAclInboundRule

Request headers

For information about the headers common to all VPC APIs, see VPC common headers.

Request query parameters

The following describes the parameters.

Field Type Required Description
regionCode String Optional Region code of the network ACL to which you want to add the inbound rule
  • First Region of the query result (default)
  • Check through getRegionList.
    		•
    networkAclNo String Required Network ACL number
  • Check through getNetworkAclList.
    		•
    networkAclRuleList.N.priority Integer Required Priority of the network ACL rule
  • 0-100
  • It can't be duplicated with the priority of another inbound rule.
    		•
    networkAclRuleList.N.protocolTypeCode String Required Network ACL rule's protocol type code
  • TCP | UDP | ICMP
    		•
    networkAclRuleList.N.ipBlock String Conditional IP address range to be allowed in the network ACL rule
  • Example: 0.0.0.0/0, 100.10.20.0/24, 192.168.0.10/32
    		•
    networkAclRuleList.N.denyAllowGroupNo String Conditional Deny-Allow group number for the network ACL
  • It can be specified instead of the IP address range to be allowed by the network ACL rule.
  • denyAllowGroupNo can be obtained through getNetworkAclDenyAllowGroupList.
    		•
    networkAclRuleList.N.portRange String Conditional Network ACL rule's port range
  • e.g., Single port: 22, Range specification: 1-65535
  • No entry if protocolTypeCode is ICMP
    		•
    networkAclRuleList.N.ruleActionCode String Required Whether to allow traffic
  • ALLOW | DROP
    		•
    networkAclRuleList.N.networkAclRuleDescription String Optional Network ACL rule description (byte)
  • 0-1000
    		•
    responseFormatType String Optional Format of the response result
    • xml (default) | json

    Request example

    The request example is as follows:

    curl --location 'https://ncloud.apigw.ntruss.com/vpc/v2/addNetworkAclInboundRule
?regionCode=KR   
&networkAclNo=***31
&networkAclRuleList.1.priority=0
&networkAclRuleList.1.protocolTypeCode=TCP
&networkAclRuleList.1.ipBlock=***.***.0.0/0
&networkAclRuleList.1.portRange=22-23
&networkAclRuleList.1.ruleActionCode=ALLOW'
--header 'x-ncp-apigw-timestamp: {Timestamp}'     
--header 'x-ncp-iam-access-key: {Access Key}' 
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

    Response

    This section describes the response format.

    Response body

    See NetworkAclRuleList for the response body.

    Response status codes

    For response status codes common to NAVER Cloud Platform, see Ncloud API response status codes.

    Response example

    The response example is as follows:

    <addNetworkAclInboundRuleResponse>
  <requestId>189b16ac-26a0-472e-b3a9-47b80cdf7dfe</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <networkAclRuleList>
    <networkAclRule>
      <networkAclNo>***31</networkAclNo>
      <priority>0</priority>
      <protocolType>
        <code>TCP</code>
        <codeName>tcp</codeName>
      </protocolType>
      <portRange>22-23</portRange>
      <ruleAction>
        <code>ALLOW</code>
        <codeName>Allow</codeName>
      </ruleAction>
      <createDate>2020-08-05T19:56:35+0900</createDate>
      <ipBlock>***.***.0.0/0</ipBlock>
      <denyAllowGroupNo/>
      <networkAclRuleType>
        <code>INBND</code>
        <codeName>Inbound</codeName>
      </networkAclRuleType>
      <networkAclRuleDescription></networkAclRuleDescription>
    </networkAclRule>
  </networkAclRuleList>
</addNetworkAclInboundRuleResponse>