NAME

ec2-modify-instance-attribute - Modify an instance attribute

SYNOPSIS

ec2minatt ([ec2-modify-instance-attribute, ec2miatt])
ec2minatt [GENERAL OPTIONS] [SPECIFIC OPTIONS] INSTANCE

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

Modifies an instance attribute. Only one attribute can be specified per
call.

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

-b, --block-device-mapping MAPPING
Modifies the block-device-mapping for the instance, in the form
'<device>=<block-device>', where 'block-device' can be one of the
following:

- '[<volume-id>][:<delete-on-termination>]': indicates that an Amazon
EBS volume should be exposed at the specified device. The following
combinations are supported:

- '<volume-id>': the ID of Amazon EBS volume, which must be owned
by the caller.

- '<delete-on-termination>': indicates whether the Amazon EBS
volume should be deleted on instance termination. If not
specified, this will default to 'true' and the volume will be
deleted.

For example: '/dev/sdb=vol-7eb96d16
'/dev/sdc=vol-7eb96d16:false

See the latest Developer's Guide for further information.

-t, --instance-type INSTANCETYPE
Sets the instance-type of the specified instance to
INSTANCETYPE.

--disable-api-termination BOOLEAN
Sets whether to disallow the termination of the instance
using the API. Valid options are 'true' and 'false'.

--instance-initiated-shutdown-behavior BEHAVIOR
Sets the behavior of the instance for an instance initiated
shutdown (i.e. 'shutdown -h now').

- 'stop': indicates that the instance should move into the stopped
state and remain available to be restarted.

- 'terminate': indicates that the instance should move into the
terminated state.

--kernel KERNEL
Sets the ID of the kernel to be used by the instance
to KERNEL.

--ramdisk RAMDISK
Sets the ID of the ramdisk to be used by the instance
to RAMDISK.

--user-data USERDATA
Sets the user data associated with the instance
to USERDATA.

--source-dest-check BOOLEAN
Sets whether to enable the source/dest check on traffic through this instance.
Valid options are 'true' and 'false'.

-g, --group-id GROUP_ID [ --group-id GROUP_ID [...]]
Replace the security groups for a VPC instance.

--ebs-optimized BOOLEAN
Provides dedicated throughput to Amazon EBS and a software
stack optimized for EBS I/O. Additional usage charges apply
when using this option.