Amazon Elastic Compute Cloud
API Reference (API Version 2013-02-01)
AWS Documentation » Amazon EC2 » API Reference » Actions » CreatePlacementGroup
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did 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, see Using Cluster Instances in the Amazon Elastic Compute Cloud User Guide.

Request Parameters

GroupName

A name for the placement group.

Type: String

Default: None

Required: Yes

Strategy

The placement group strategy.

Type: String

Valid values: cluster

Required: Yes

Response Elements

The following elements are returned in a CreatePlacementGroupResponse element.

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/2013-02-01/">
   <requestId>d4904fd9-82c2-4ea5-adfe-a9cc3EXAMPLE</requestId>
   <return>true</return>
</CreatePlacementGroupResponse>
Document Conventions« PreviousNext »
Terms of UseDid this page help you?  Yes | No |  Tell us about it...