Provided by: ec2-api-tools_1.6.12.0-0ubuntu1_all bug

NAME

       ec2-associate-address - Associate a public address with an instance

SYNOPSIS

        ec2assocaddr ([ec2-associate-address])
        ec2assocaddr   [GENERAL  OPTIONS]  {  IP  |  -a  ALLOCATION_ID  }  {  -i  INSTANCE  |  -n
       NETWORK_INTERFACE }

GENERAL NOTES

        Any command option/parameter may be passed a value of '-' to indicate
        that values for that option should be read from stdin.

DESCRIPTION

        Associate a public address with an instance or a network interface.
        The IP parameter is the address to associate for non-VPC instances.
        VPC instances must specify an allocation ID, or private IP address
        instead.

GENERAL OPTIONS

        -O, --aws-access-key KEY
            AWS Access Key ID. Defaults to the value of the AWS_ACCESS_KEY
            environment variable (if set).

        -W, --aws-secret-key KEY
            AWS Secret Access Key. Defaults to the value of the AWS_SECRET_KEY
            environment variable (if set).

        -T, --security-token TOKEN
            AWS delegation token. Defaults to the value of the AWS_DELEGATION_TOKEN
            environment variable (if set).

        -K, --private-key KEY
            [DEPRECATED] Specify KEY as the private key to use. Defaults to the value of the
            EC2_PRIVATE_KEY environment variable (if set). Overrides the default.

        -C, --cert CERT
            [DEPRECATED] Specify CERT as the X509 certificate to use. Defaults to the value
            of the EC2_CERT environment variable (if set). Overrides the default.

        -U, --url URL
            Specify URL as the web service URL to use. Defaults to the value of
            'https://ec2.amazonaws.com' (us-east-1) or to that of the
            EC2_URL environment variable (if set). Overrides the default.

        --region REGION
            Specify REGION as the web service region to use.
            This option will override the URL specified by the "-U URL" option
            and EC2_URL environment variable.
            This option defaults to the region specified by the EC2_URL environment variable
            or us-east-1 if this environment variable is not set.

        -D, --auth-dry-run
            Check if you can perform the requested action rather than actually performing it.

        -v, --verbose
            Verbose output.

        -?, --help
            Display this help.

        -H, --headers
            Display column headers.

        --debug
            Display additional debugging information.

        --show-empty-fields
            Indicate empty fields.

        --hide-tags
            Do not display tags for tagged resources.

        --connection-timeout TIMEOUT
            Specify a connection timeout TIMEOUT (in seconds).

        --request-timeout TIMEOUT
            Specify a request timeout TIMEOUT (in seconds).

SPECIFIC OPTIONS

        -a, --allocation-id
            The ALLOCATION_ID to use for the operation.
            Used for VPC elastic IP addresses.

        -i, --instance
            Instance with which to associate an EIP.

        -n, --network-interface
            Network interface with which to associate an EIP.

        -p, --private-ip-address
            Private IP address with which to associate an EIP.

        --allow-reassociation
            Allows an Elastic IP address that is already associated with an
            instance or a network interface to be re-associated with the
            specified instance or network interface. Otherwise, the operation
            fails.

SEE ALSO

         http://docs.amazonwebservices.com/AWSEC2/2013-10-15/CommandLineReference
         http://docs.amazonwebservices.com/AWSEC2/latest/CommandLineReference