addRoute

VPC 환경에서 이용 가능합니다.

라우트 테이블에 라우트를 추가합니다.

구문

addRoute 구문은 다음과 같습니다.

./ncloud vpc addRoute \
    --vpcNo <vpc-no> \
    --routeTableNo <route-table-no> \
    --routeList <route-list> \
    [--regionCode <KR|KRS>] \
    [--output <json|xml>]

옵션

addRoute 실행 시 지정할 수 있는 옵션을 설명합니다.

필수 옵션

addRoute의 필수 옵션입니다.

옵션	타입	필수 여부	설명
`--vpcNo`	String	Required	VPC 번호 getVpcList 참조
`--routeTableNo`	String	Required	라우트 테이블 번호 getRouteTableList 참조
`--routeList`	List	Required	라우트 목록 각 라우트는 따옴표 안에 {필드='값'} 쌍을 콤마로 구분하여 입력 `destinationCidrBlock` (Required): 목적지 IPv4 주소 범위. CIDR 표기법 사용. 예시: `0.0.0.0/0`, `100.10.20.0/24` `targetTypeCode` (Required): 목적지 유형. `NATGW` (NAT Gateway) \| `VPCPEERING` (VPC Peering) \| `VGW` (Virtual Private Gateway) `targetNo` (Required): 목적지 식별 번호. 각 목적지 유형에 해당하는 자원 목록을 조회하는 API를 통해 확인 `targetName` (Required): 목적지 이름. 각 목적지 유형에 해당하는 자원 목록을 조회하는 API를 통해 확인

공통 옵션

vpc 명령에서 공통으로 사용하는 옵션에 대한 정보는 VPC 옵션을 참조해 주십시오.

예시

라우트 추가 요청이 성공하면 각 라우트의 구성 정보가 반환됩니다.

명령

명령 예시는 다음과 같습니다.

./ncloud vpc addRoute \
    --vpcNo 12345678 \
    --routeTableNo 45678901 \
    --routeList "destinationCidrBlock='192.168.4.0/24', targetTypeCode='NATGW', targetNo='56789012', targetName='test-natgw-01'" \
    --regionCode KR \
    --output json

출력

출력 예시는 다음과 같습니다.

{
  "addRouteResponse": {
    "totalRows": 3,
    "routeList": [
      {
        "destinationCidrBlock": "0.0.0.0/0",
        "targetName": "INTERNET GATEWAY",
        "routeTableNo": "45678901",
        "targetType": {
          "code": "IGW",
          "codeName": "Internet Gateway"
        },
        "targetNo": "",
        "isDefault": false
      },
      {
        "destinationCidrBlock": "192.168.0.0/16",
        "targetName": "LOCAL",
        "routeTableNo": "45678901",
        "targetType": {
          "code": "LOCAL",
          "codeName": "Local"
        },
        "targetNo": "",
        "isDefault": true
      },
      {
        "destinationCidrBlock": "192.168.4.0/24",
        "targetName": "test-natgw-01",
        "routeTableNo": "45678901",
        "targetType": {
          "code": "NATGW",
          "codeName": "NAT Gateway"
        },
        "targetNo": "56789012",
        "isDefault": false
      }
    ],
    "requestId": "ac0b93b2-99bd-4b30-a7bc-a6c0f1377e00",
    "returnCode": "0",
    "returnMessage": "success"
  }
}