Creates a Spot Instance request. Spot Instances are instances that
Amazon EC2 starts on your behalf when the maximum price that you
specify exceeds the current Spot Price. Amazon EC2 periodically sets
the Spot Price based on available Spot Instance capacity and current
Spot Instance requests. For more information about Spot Instances, see
Spot Instances
in the Amazon Elastic Compute Cloud User Guide .

The start date of the request. If this is a one-time request, the
request becomes active at this date and time and remains active until
all instances launch, the request expires, or the request is canceled.
If the request is persistent, the request becomes active at this date
and time and remains active until it expires or is canceled.

The end date of the request. If this is a one-time request, the
request remains active until all instances launch, the request is
canceled, or this date is reached. If the request is persistent, it
remains active until it is canceled or this date and time is reached.

When you
specify an Availability Zone group in a Spot Instance request, all
Spot Instances in the request are launched in the same Availability
Zone. Instance proximity is maintained with this parameter, but the
choice of Availability Zone is not. The group applies only to bids for
Spot Instances of the same instance type. Any additional Spot Instance
requests that are specified with the same Availability Zone group name
are launched in that same Availability Zone, as long as at least one
instance from the group is still active.

If there is no active
instance running in the Availability Zone group that you specify for a
new Spot Instance request (all instances are terminated, the bid is
expired, or the bid falls below current market), then Amazon EC2
launches the instance in any Availability Zone where the constraint
can be met. Consequently, the subsequent set of Spot Instances could
be placed in a different zone from the original request, even if you
specified the same Availability Zone group.

The start date of the request. If this is a one-time request, the
request becomes active at this date and time and remains active until
all instances launch, the request expires, or the request is canceled.
If the request is persistent, the request becomes active at this date
and time and remains active until it expires or is canceled.

Default: The request is effective indefinitely.

Returns:

The start date of the request. If this is a one-time request, the
request becomes active at this date and time and remains active until
all instances launch, the request expires, or the request is canceled.
If the request is persistent, the request becomes active at this date
and time and remains active until it expires or is canceled.

The start date of the request. If this is a one-time request, the
request becomes active at this date and time and remains active until
all instances launch, the request expires, or the request is canceled.
If the request is persistent, the request becomes active at this date
and time and remains active until it expires or is canceled.

Default: The request is effective indefinitely.

Parameters:

validFrom The start date of the request. If this is a one-time request, the
request becomes active at this date and time and remains active until
all instances launch, the request expires, or the request is canceled.
If the request is persistent, the request becomes active at this date
and time and remains active until it expires or is canceled.

The start date of the request. If this is a one-time request, the
request becomes active at this date and time and remains active until
all instances launch, the request expires, or the request is canceled.
If the request is persistent, the request becomes active at this date
and time and remains active until it expires or is canceled.

Default: The request is effective indefinitely.

Returns a reference to this object so that method calls can be chained together.

Parameters:

validFrom The start date of the request. If this is a one-time request, the
request becomes active at this date and time and remains active until
all instances launch, the request expires, or the request is canceled.
If the request is persistent, the request becomes active at this date
and time and remains active until it expires or is canceled.

Default: The request is effective indefinitely.

Returns:

A reference to this updated object so that method calls can be chained
together.

The end date of the request. If this is a one-time request, the
request remains active until all instances launch, the request is
canceled, or this date is reached. If the request is persistent, it
remains active until it is canceled or this date and time is reached.

Default: The request is effective indefinitely.

Returns:

The end date of the request. If this is a one-time request, the
request remains active until all instances launch, the request is
canceled, or this date is reached. If the request is persistent, it
remains active until it is canceled or this date and time is reached.

The end date of the request. If this is a one-time request, the
request remains active until all instances launch, the request is
canceled, or this date is reached. If the request is persistent, it
remains active until it is canceled or this date and time is reached.

Default: The request is effective indefinitely.

Parameters:

validUntil The end date of the request. If this is a one-time request, the
request remains active until all instances launch, the request is
canceled, or this date is reached. If the request is persistent, it
remains active until it is canceled or this date and time is reached.

The end date of the request. If this is a one-time request, the
request remains active until all instances launch, the request is
canceled, or this date is reached. If the request is persistent, it
remains active until it is canceled or this date and time is reached.

Default: The request is effective indefinitely.

Returns a reference to this object so that method calls can be chained together.

Parameters:

validUntil The end date of the request. If this is a one-time request, the
request remains active until all instances launch, the request is
canceled, or this date is reached. If the request is persistent, it
remains active until it is canceled or this date and time is reached.

Default: The request is effective indefinitely.

Returns:

A reference to this updated object so that method calls can be chained
together.

When you
specify an Availability Zone group in a Spot Instance request, all
Spot Instances in the request are launched in the same Availability
Zone. Instance proximity is maintained with this parameter, but the
choice of Availability Zone is not. The group applies only to bids for
Spot Instances of the same instance type. Any additional Spot Instance
requests that are specified with the same Availability Zone group name
are launched in that same Availability Zone, as long as at least one
instance from the group is still active.

If there is no active
instance running in the Availability Zone group that you specify for a
new Spot Instance request (all instances are terminated, the bid is
expired, or the bid falls below current market), then Amazon EC2
launches the instance in any Availability Zone where the constraint
can be met. Consequently, the subsequent set of Spot Instances could
be placed in a different zone from the original request, even if you
specified the same Availability Zone group.

Default: Instances are
launched in any available Availability Zone.

Returns:

The user-specified name for a logical grouping of bids.

When you
specify an Availability Zone group in a Spot Instance request, all
Spot Instances in the request are launched in the same Availability
Zone. Instance proximity is maintained with this parameter, but the
choice of Availability Zone is not. The group applies only to bids for
Spot Instances of the same instance type. Any additional Spot Instance
requests that are specified with the same Availability Zone group name
are launched in that same Availability Zone, as long as at least one
instance from the group is still active.

If there is no active
instance running in the Availability Zone group that you specify for a
new Spot Instance request (all instances are terminated, the bid is
expired, or the bid falls below current market), then Amazon EC2
launches the instance in any Availability Zone where the constraint
can be met. Consequently, the subsequent set of Spot Instances could
be placed in a different zone from the original request, even if you
specified the same Availability Zone group.

When you
specify an Availability Zone group in a Spot Instance request, all
Spot Instances in the request are launched in the same Availability
Zone. Instance proximity is maintained with this parameter, but the
choice of Availability Zone is not. The group applies only to bids for
Spot Instances of the same instance type. Any additional Spot Instance
requests that are specified with the same Availability Zone group name
are launched in that same Availability Zone, as long as at least one
instance from the group is still active.

If there is no active
instance running in the Availability Zone group that you specify for a
new Spot Instance request (all instances are terminated, the bid is
expired, or the bid falls below current market), then Amazon EC2
launches the instance in any Availability Zone where the constraint
can be met. Consequently, the subsequent set of Spot Instances could
be placed in a different zone from the original request, even if you
specified the same Availability Zone group.

Default: Instances are
launched in any available Availability Zone.

Parameters:

availabilityZoneGroup The user-specified name for a logical grouping of bids.

When you
specify an Availability Zone group in a Spot Instance request, all
Spot Instances in the request are launched in the same Availability
Zone. Instance proximity is maintained with this parameter, but the
choice of Availability Zone is not. The group applies only to bids for
Spot Instances of the same instance type. Any additional Spot Instance
requests that are specified with the same Availability Zone group name
are launched in that same Availability Zone, as long as at least one
instance from the group is still active.

If there is no active
instance running in the Availability Zone group that you specify for a
new Spot Instance request (all instances are terminated, the bid is
expired, or the bid falls below current market), then Amazon EC2
launches the instance in any Availability Zone where the constraint
can be met. Consequently, the subsequent set of Spot Instances could
be placed in a different zone from the original request, even if you
specified the same Availability Zone group.

When you
specify an Availability Zone group in a Spot Instance request, all
Spot Instances in the request are launched in the same Availability
Zone. Instance proximity is maintained with this parameter, but the
choice of Availability Zone is not. The group applies only to bids for
Spot Instances of the same instance type. Any additional Spot Instance
requests that are specified with the same Availability Zone group name
are launched in that same Availability Zone, as long as at least one
instance from the group is still active.

If there is no active
instance running in the Availability Zone group that you specify for a
new Spot Instance request (all instances are terminated, the bid is
expired, or the bid falls below current market), then Amazon EC2
launches the instance in any Availability Zone where the constraint
can be met. Consequently, the subsequent set of Spot Instances could
be placed in a different zone from the original request, even if you
specified the same Availability Zone group.

Default: Instances are
launched in any available Availability Zone.

Returns a reference to this object so that method calls can be chained together.

Parameters:

availabilityZoneGroup The user-specified name for a logical grouping of bids.

When you
specify an Availability Zone group in a Spot Instance request, all
Spot Instances in the request are launched in the same Availability
Zone. Instance proximity is maintained with this parameter, but the
choice of Availability Zone is not. The group applies only to bids for
Spot Instances of the same instance type. Any additional Spot Instance
requests that are specified with the same Availability Zone group name
are launched in that same Availability Zone, as long as at least one
instance from the group is still active.

If there is no active
instance running in the Availability Zone group that you specify for a
new Spot Instance request (all instances are terminated, the bid is
expired, or the bid falls below current market), then Amazon EC2
launches the instance in any Availability Zone where the constraint
can be met. Consequently, the subsequent set of Spot Instances could
be placed in a different zone from the original request, even if you
specified the same Availability Zone group.

Default: Instances are
launched in any available Availability Zone.

Returns:

A reference to this updated object so that method calls can be chained
together.