Amazon Elastic Compute Cloud
API Reference (API Version 2012-04-01)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

CreatePlacementGroup

Description

Creates a placement group that you launch cluster instances into. You must give the group a name unique within the scope of your account. For more information about placement groups and cluster instances, go to Using Cluster Instances in the Amazon Elastic Compute Cloud User Guide.

Request Parameters

NameDescriptionRequired

GroupName

A name for the placement group.

Type: string

Default: None

Yes

Strategy

The placement group strategy.

Type: string

Valid Values: cluster

Yes

Response Elements

The elements in the following table are wrapped in a CreatePlacementGroupResponse structure.

NameDescription

requestId

The ID of the request.

Type: xsd:string

return

Returns true if the request succeeds. Otherwise, returns an error.

Type: xsd:boolean

Examples

Example Request

This example creates a placement group named XYZ-cluster.

https://ec2.amazonaws.com/?Action=CreatePlacementGroup
&GroupName=XYZ-cluster
&Strategy=cluster
&AUTHPARAMS

Example Response

<CreatePlacementGroupResponse xmlns="http://ec2.amazonaws.com/doc/2012-04-01/">
   <requestId>d4904fd9-82c2-4ea5-adfe-a9cc3EXAMPLE</requestId>
   <return>true</return>
</CreatePlacementGroupResponse>