createAccessControlGroup

Available in VPC

Create a ACG. ACG is applied to network interfaces to control traffic access.

Syntax

The createAccessControlGroup syntax is as follows:

./ncloud vserver createAccessControlGroup \
    --vpcNo <vpc-no> \
    [--accessControlGroupName <acg-name>] \
    [--accessControlGroupDescription <acg-description>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

Options

This section describes the options available when running createAccessControlGroup.

Required options

The following options are required for createAccessControlGroup.

Options	Type	Required	Description
`--vpcNo`	String	Required	VPC number See getVpcList.

Optional options

These are the optional options for createAccessControlGroup. Options that are not specified will use their default values.

Options	Type	Required	Description
`--accessControlGroupName`	String	Optional	ACG name Automatically generated if not entered. Enter 3-30 characters using a combination of lowercase English letters, numbers, and special character `-`. The string must start with a lowercase English letter and end with a lowercase English letter or a number.
`--accessControlGroupDescription`	String	Optional	ACG description (byte) 0-1000

Common options

For information about the options common to all vserver subcommands, see Server (VPC) options.

Examples

If the ACG creation request is successful, the identification information and operational status of the created ACG are returned.

Command

The command example is as follows:

./ncloud vserver createAccessControlGroup \
    --vpcNo 12345678 \
    --accessControlGroupName test-acg-01 \
    --accessControlGroupDescription "ACG for web tier" \
    --regionCode KR \
    --output json

Output

The output example is as follows:

{
  "createAccessControlGroupResponse": {
    "totalRows": 1,
    "accessControlGroupList": [
      {
        "accessControlGroupNo": "67890123",
        "accessControlGroupName": "test-acg-01",
        "isDefault": false,
        "vpcNo": "12345678",
        "accessControlGroupStatus": {
          "code": "RUN",
          "codeName": "In operation"
        },
        "accessControlGroupDescription": "ACG for web tier"
      }
    ],
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "returnCode": "0",
    "returnMessage": "success"
  }
}

Documentation Index