addAccessControlGroupInboundRule

Prev Next

al

Available in VPC

Overview

Adding inbound rules to an ACG

Requests

Request parameters

Parameter name Requirement status Type Restrictions Description
regionCode No String - Region code
Sets the region of the ACG to which inbound rules will be added
regionCode can be obtained via the getRegionList action
Default: Selects the first region of the getRegionList query results
vpcNo Yes String - VPC number
Sets the VPC of the ACG to which inbound rules will be added
vpcNo can be obtained via getVpcList action
accessControlGroupNo Yes String - ACG number
accessControlGroupNo can be obtained via the getAccessControlGroupList action
accessControlGroupRuleList.N.protocolTypeCode Yes String - Protocol type code of the ACG rule
Protocol numbers 1–254 allowed
Options : TCP
accessControlGroupRuleList.N.ipBlock Conditional String - Access source IP address block of the ACG rule
Access source can be registered as either an IP address block or an ACG number
.e.g. 0.0.0.0/0, 100.10.20.0/24, 192.168.0.10/32
accessControlGroupRuleList.N.accessControlGroupSequence Conditional String - Access source ACG number of the ACG rule
Access source can be registered as either an IP address block or an ACG number
accessControlGroupNo can be obtained via the getAccessControlGroupList action
accessControlGroupRuleList.N.portRange Conditional String - Port range of the ACG rule
Example 1: 22 for single port
Example 2: Specify a range from 1 to 65535
- Do not enter a port range except when protocolTypeCode TCP is 6 and UDP is 17.
accessControlGroupRuleList.N.accessControlGroupRuleDescription No String Min : 0, Max : 1000 Bytes ACG rule description
responseFormatType No String - Format type of the response result
Options : xml

Responses

Response bodies

Examples

Request examples

GET {API_URL}/addAccessControlGroupInboundRule
?regionCode=KR
&vpcNo=***04
&accessControlGroupNo=***63
&accessControlGroupRuleList.1.protocolTypeCode=TCP
&accessControlGroupRuleList.1.ipBlock=***.***.0.0/0
&accessControlGroupRuleList.1.portRange=80

Response examples

Inbound rule list of the ACG after request execution

<addAccessControlGroupInboundRuleResponse>
  <requestId>eb6a1733-f4a1-4e04-8c99-cf2d8081a9fb</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>2</totalRows>
  <accessControlGroupRuleList>
    <accessControlGroupRule>
      <accessControlGroupNo>***63</accessControlGroupNo>
      <protocolType>
        <code>TCP</code>
        <codeName>tcp</codeName>
        <number>6</number>
      </protocolType>
      <ipBlock>***.***.0.0/0</ipBlock>
      <accessControlGroupSequence></accessControlGroupSequence>
      <portRange>80</portRange>
      <accessControlGroupRuleType>
        <code>INBND</code>
        <codeName>Inbound</codeName>
      </accessControlGroupRuleType>
      <accessControlGroupRuleDescription></accessControlGroupRuleDescription>
    </accessControlGroupRule>
    <accessControlGroupRule>
      <accessControlGroupNo>***63</accessControlGroupNo>
      <protocolType>
        <code>TCP</code>
        <codeName>tcp</codeName>
        <number>6</number>
      </protocolType>
      <ipBlock>***.***.0.0/0</ipBlock>
      <accessControlGroupSequence></accessControlGroupSequence>
      <portRange>22</portRange>
      <accessControlGroupRuleType>
        <code>INBND</code>
        <codeName>Inbound</codeName>
      </accessControlGroupRuleType>
      <accessControlGroupRuleDescription></accessControlGroupRuleDescription>
    </accessControlGroupRule>
  </accessControlGroupRuleList>
</addAccessControlGroupInboundRuleResponse>