Provided by: ec2-api-tools_1.6.14.1-0ubuntu1_all
NAME
ec2-modify-reserved-instances - Modifies the Availability Zone, instance count, network platform
SYNOPSIS
ec2mri ([ec2-modify-reserved-instances]) ec2mri [GENERAL OPTIONS] RESERVED-INSTANCES-ID [RESERVED-INSTANCES-ID [...]] [--client-token TOKEN] -c TARGET-CONFIGURATION [-c TARGET-CONFIGURATION [...]]
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 the Availability Zone, instance count, network platform (EC2-Classic or EC2-VPC), or instance type of your Reserved Instances. RESERVED-INSTANCES-IDs are the IDs of Reserved Instances to modify. These IDs must refer to Reserved Instances that are identical, except for Availability Zone, network platform, and instance type.
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
--client-token TOKEN The client token for this request to make the call idempotent. A random client token will be generated if this is not provided. -c, --target-configuration TARGET-CONFIGURATION New configuration settings for the Reserved Instances. Each configuration is specified by comma-separated, key-value pairs in double quotes. Key names are zone, count, platform, and instance-type. Zone and count are required. Platform is optional if your account supports EC2-VPC; it must be specified if your account supports EC2-Classic. Instance type must be of the same instance family as the input Reserved Instances and defaults to the instance type of the input Reserved Instances when not specified. Refer to the latest Developer's Guide for valid values. Example 1 (modifying a Reserved Instance to one configuration): ec2mri <RESERVED-INSTANCES-ID> -c "zone=us-east-1a,count=1,platform=EC2-VPC,instance-type=m1.medium" Example 2 (modifying multiple Reserved Instances to multiple configurations): ec2mri <RESERVED-INSTANCES-ID-1> <RESERVED-INSTANCES-ID-2> -c "zone=us-east-1a,count=1,platform=EC2-VPC,instance-type=m1.medium" -c "zone=us-east-1b,count=2,platform=EC2-Classic,instance-type=m1.small"
SEE ALSO
http://docs.amazonwebservices.com/AWSEC2/2014-05-01/CommandLineReference http://docs.amazonwebservices.com/AWSEC2/latest/CommandLineReference