ec2-create-placement-group

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.

The short version of this command is ec2addpgrp.

Syntax

ec2-create-placement-group placement-group -s strategy

Options

Name Description Required

Name	Description	Required
`placement-group`	A name for the placement group. Type: String Default: None Example: XYZ-cluster	Yes
`-s` `strategy`	The placement strategy. Type: String Valid Values: `cluster` Default: cluster Example: -s cluster	No

placement-group

A name for the placement group.

Type: String

Default: None

Example: XYZ-cluster

Yes

-s

strategy

The placement strategy.

Type: String

Valid Values: cluster

Default: cluster

Example: -s cluster

No

Common Options

Option	Description
`--region` `REGION`	Overrides the Region specified in the `EC2_URL` environment variable and the URL specified by the `-U` option. Default: The `EC2_URL` environment variable, or `us-east-1` if the environment variable is not set. Example: `--region eu-west-1`
`-U, --url` `URL`	`URL` is the uniform resource locator of the Amazon EC2 web service entry point. Default: The `EC2_URL` environment variable, or https://ec2.amazonaws.com if the environment variable is not set. Example: `-U https://ec2.amazonaws.com`
`-K, --private-key` `EC2-PRIVATE-KEY`	The private key to use when constructing requests to Amazon EC2. Default: The value of the `EC2_PRIVATE_KEY` environment variable. Example: `-K pk-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem`
`-C, --cert` `EC2-CERT`	The X.509 certificate to use when constructing requests to Amazon EC2. Default: The value of the `EC2_CERT` environment variable. Example: `-C cert-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem`
`--connection-timeout` `TIMEOUT`	Specifies a connection timeout (in seconds). Example: --connection-timeout 30
`--request-timeout` `TIMEOUT`	Specifies a request timeout (in seconds). Example: --request-timeout 45
`-v, --verbose`	Displays verbose output by showing the SOAP request and response on the command line. This is particularly useful if you are building tools to talk directly to our SOAP API.
`-H, --headers`	Displays column headers in the output.
`--show-empty-fields`	Shows empty columns as `(nil)`.
`--hide-tags`	Do not display tags for tagged resources.
`--debug`	Prints internal debugging information. This is useful to assist us when troubleshooting problems.
`-?, --help, -h`	Displays Help.
`-`	If `-` is specified as an argument to one of the parameters, a list of arguments is read from standard input. This is useful for piping the output of one command into the input of another. Example: `ec2-describe-instances \| grep stopped \| cut -f 2 \| ec2-start-instances -`

Output

The command returns a table that contains the following information:

PLACEMENTGROUP identifier
Placement group name
Placement group strategy

Examples

Example Request

This example creates the XYZ-cluster group.

PROMPT> ec2-create-placement-group XYZ-cluster -s cluster
PLACEMENTGROUP  XYZ-cluster  cluster