---
title: "addAccessControlGroupOutboundRule"
slug: "cli-vserver-acg-addaccesscontrolgroupoutboundrule"
tags: ["ACG", "Outbound Rule", "Server"]
updated: 2026-04-23T09:04:53Z
published: 2026-04-23T09:07:31Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli-fin.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# addAccessControlGroupOutboundRule

## 개요

ACG의 Outbound Rule 리스트를 추가합니다.

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| regionCode | No | String |  | - 리전 코드 Outbound Rule이 추가될 ACG의 리전(Region) 결정 가능 regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득 가능 Default: getRegionList 조회 결과의 첫 번째 리전을 선택 |
| vpcNo | Yes | String |  | - VPC 번호 Outbound Rule이 추가될 ACG의 VPC를 결정함 vpcNo는 [getVpcList](/docs/cli-vpc-vpcmanagement-getvpclist) 액션을 통해 획득 가능 |
| accessControlGroupNo | Yes | String |  | - ACG 번호 accessControlGroupNo는 [getAccessControlGroupList](/docs/cli-vserver-acg-getaccesscontrolgrouplist) 액션을 통해 획득 가능 |
| accessControlGroupRuleList.N.protocolTypeCode | Yes | String |  | - ACG Rule의 프로토콜 유형 코드 [프로토콜 번호](https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml)는 1-254까지 허용 Options: TCP \| UDP \| ICMP \| 1-254 |
| accessControlGroupRuleList.N.ipBlock | Conditional | String |  | - ACG Rule의 접근 소스 IP 주소 블록 접근 소스를 IP 주소 블록과 ACG 번호중 한 가지로 등록 가능 <예시> 0.0.0.0/0, 100.10.20.0/24, 192.168.0.10/32 |
| accessControlGroupRuleList.N.accessControlGroupSequence | Conditional | String |  | - ACG Rule의 접근 소스 ACG 번호 접근 소스를 IP 주소 블록과 ACG 번호중 한 가지로 등록 가능 accessControlGroupNo는 [getAccessControlGroupList](/docs/cli-vserver-acg-getaccesscontrolgrouplist) 액션을 통해 획득 가능 |
| accessControlGroupRuleList.N.portRange | Conditional | String |  | - ACG Rule의 포트 범위 <예시 2> 단일 포트: 22 <예시 2> 범위 지정: 1-65535 protocolTypeCode가 TCP(6),UDP(17) 인 경우를 제외하고는 포트 범위를 입력하지 않음 |
| accessControlGroupRuleList.N.accessControlGroupRuleDescription | No | String | Min : 0, Max : 1000 Bytes | ACG Rule의 설명 |
| responseFormatType | No | String |  | - 응답 결과의 포맷 타입 Options: xml \| json Default: xml |

## 응답

### 응답 데이터 타입

- AccessControlGroupRuleList 타입

| AccessControlGroupRuleList extends CommonResponse |
| --- |
| private Integer totalRows; |
| private List<accesscontrolgrouprule data-tomark-pass=""> accessControlGroupRuleList = new ArrayList&lt;&gt;();</accesscontrolgrouprule> |

| AccessControlGroupRule |
| --- |
| private String accessControlGroupNo; |
| private ProtocolType protocolType; |
| private String ipBlock; |
| private String accessControlGroupSequence; |
| private String portRange; |
| private CommonCode accessControlGroupRuleType; |
| private String accessControlGroupRuleDescription; |

## 예시

### 요청 예시

```
ncloud vserver addAccessControlGroupOutboundRule --regionCode FKR --vpcNo ***04 --accessControlGroupNo ***63 --accessControlGroupRuleList "protocolTypeCode='TCP', ipBlock='***.***.0.0/0', portRange='81'" "protocolTypeCode='TCP', ipBlock='***.***.0.0/0', portRange='82'"
```

### 응답 예시

요청 수행 후 해당 ACG의 Outbound Rule 리스트

```
<addAccessControlGroupOutboundRuleResponse>
  <requestId>2dc83aed-e495-4cc2-a695-e6e253200f42</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>OTBND</code>
        <codeName>Outbound</codeName>
      </accessControlGroupRuleType>
      <accessControlGroupDescription></accessControlGroupDescription>
    </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>OTBND</code>
        <codeName>Outbound</codeName>
      </accessControlGroupRuleType>
      <accessControlGroupDescription></accessControlGroupDescription>
    </accessControlGroupRule>
  </accessControlGroupRuleList>
</addAccessControlGroupOutboundRuleResponse>
```
