aws ec2 create-ipam-scope

Create an IPAM scope. AWS CLI reference

1 example 6 options Its page in the AWS CLI reference

Examples

from aws-cli, each command read by CmdID

To create an IPAM scope

The following create-ipam-scope example creates an IPAM scope.

For Linux, use the following command.

aws ec2 create-ipam-scope --ipam-id ipam-08440e7a3acde3908 --description "Example description" --tag-specifications 'ResourceType=ipam-scope,Tags=[{Key=Name,Value="Example name value"}]'

Identify

--ipam-idThe ID of the IPAM for which you're creating this scope.

--descriptionA description for the scope you're creating.

--tag-specificationsThe key/value combination of a tag assigned to the resource.

For Windows, use the following command.

aws ec2 create-ipam-scope ^Identify

--ipam-id ipam-08440e7a3acde3908 ^

--description "Example description" ^

--tag-specifications ResourceType=ipam-scope,Tags=[{Key=Name,Value="Example name value"}]

Its output

{
    "IpamScope": {
        "OwnerId": "123456789012",
        "IpamScopeId": "ipam-scope-01c1ebab2b63bd7e4",
        "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-01c1ebab2b63bd7e4",
        "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-08440e7a3acde3908",
        "IpamRegion": "us-west-2",
        "IpamScopeType": "private",
        "IsDefault": false,
        "Description": "Example description",
        "PoolCount": 0,
        "State": "create-in-progress",
        "Tags": [
            {
                "Key": "Name",
                "Value": "Example name value"
            }
        ]
    }
}

For more information, see Create additional scopes in the Amazon VPC IPAM User Guide.

Options

6 in the AWS CLI reference

--client-tokenA unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

--descriptionA description for the scope you're creating.

--dry-runA check for whether you have the required permissions for the action without actually making the request and provides an error response.

--external-authority-configurationThe configuration that links an Amazon VPC IPAM scope to an external authority system.

--ipam-idThe ID of the IPAM for which you're creating this scope.

--tag-specificationsThe key/value combination of a tag assigned to the resource.