Documentation Index

Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

addAccessControlGroupOutboundRule

Prev Next

VPC環境で利用できます。

ACGにアウトバウンドルールを追加します。

構文

addAccessControlGroupOutboundRule構文は次の通りです。

./ncloud vserver addAccessControlGroupOutboundRule \
    --vpcNo <vpc-no> \
    --accessControlGroupNo <acg-no> \
    --accessControlGroupRuleList <rule-config> \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

オプション

addAccessControlGroupOutboundRuleの実行時に指定できるオプションについて説明します。

必須オプション

addAccessControlGroupOutboundRuleの必須オプションです。

オプション タイプ 必須の有無 説明
--vpcNo String Required VPC番号
--accessControlGroupNo String Required ACG番号
--accessControlGroupRuleList List Required ACGアウトバウンドルールリスト
  • 各ルールは、二重引用符の中に{フィールド=‘値’}のペアをコンマで区切って入力
    • protocolTypeCode (必須): プロトコルタイプコード。TCP | UDP | ICMP | 1~254 (プロトコル番号を参照)
    • ipBlock (条件付き): 目的地 IPアドレスブロック。accessControlGroupSequenceと同時使用不可。例: 0.0.0.0/0100.10.20.0/24
    • accessControlGroupSequence (条件付き): 目的地 ACG番号。ipBlockと同時使用不可。getAccessControlGroupListを参照
    • portRange (条件付き): 許可ポート。単一のポートまたはポートの範囲を入力。protocolTypeCodeTCP(6)またはUDP(17)の場合、必ず入力。例: 221-65535
    • accessControlGroupRuleDescription (任意): ACGアウトバウンドルールのメモ (0~1,000バイト)

共通オプション

vserverコマンドで共通して使用するオプションについては、Server (VPC)のオプションをご参照ください。

ACGへのアウトバウンドルールの追加リクエストが成功すると、各ルールのプロトコル情報と目的地が返されます。

コマンド

コマンドの例は次の通りです。

./ncloud vserver addAccessControlGroupOutboundRule \
    --vpcNo 12345678 \
    --accessControlGroupNo 67890123 \
    --accessControlGroupRuleList "protocolTypeCode='TCP', ipBlock='0.0.0.0/0', portRange='443', accessControlGroupRuleDescription='HTTPS egress'" \
    --regionCode KR \
    --output json

出力

出力の例は次の通りです。

{
  "addAccessControlGroupOutboundRuleResponse": {
    "totalRows": 1,
    "accessControlGroupRuleList": [
      {
        "accessControlGroupNo": "67890123",
        "protocolType": {
          "code": "TCP",
          "codeName": "tcp",
          "number": 6
        },
        "ipBlock": "0.0.0.0/0",
        "accessControlGroupSequence": "",
        "portRange": "443",
        "accessControlGroupRuleType": {
          "code": "OTBND",
          "codeName": "Outbound"
        },
        "accessControlGroupRuleDescription": "HTTPS egress"
      }
    ],
    "requestId": "d4e5f678-9012-3456-def0-456789012345",
    "returnCode": "0",
    "returnMessage": "success"
  }
}