pulumi-aws-kotlin/com.pulumi.aws.ec2.kotlin/PlacementGroupArgs

PlacementGroupArgs

data class PlacementGroupArgs(val name: Output<String>? = null, val partitionCount: Output<Int>? = null, val spreadLevel: Output<String>? = null, val strategy: Output<Either<String, PlacementStrategy>>? = null, val tags: Output<Map<String, String>>? = null) : ConvertibleToJava<PlacementGroupArgs>

Provides an EC2 placement group. Read more about placement groups in AWS Docs.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const web = new aws.ec2.PlacementGroup("web", {
    name: "hunky-dory-pg",
    strategy: aws.ec2.PlacementStrategy.Cluster,
});

import pulumi
import pulumi_aws as aws
web = aws.ec2.PlacementGroup("web",
    name="hunky-dory-pg",
    strategy=aws.ec2.PlacementStrategy.CLUSTER)

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
    var web = new Aws.Ec2.PlacementGroup("web", new()
    {
        Name = "hunky-dory-pg",
        Strategy = Aws.Ec2.PlacementStrategy.Cluster,
    });
});

package main
import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ec2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ec2.NewPlacementGroup(ctx, "web", &ec2.PlacementGroupArgs{
			Name:     pulumi.String("hunky-dory-pg"),
			Strategy: pulumi.String(ec2.PlacementStrategyCluster),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ec2.PlacementGroup;
import com.pulumi.aws.ec2.PlacementGroupArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        var web = new PlacementGroup("web", PlacementGroupArgs.builder()
            .name("hunky-dory-pg")
            .strategy("cluster")
            .build());
    }
}

resources:
  web:
    type: aws:ec2:PlacementGroup
    properties:
      name: hunky-dory-pg
      strategy: cluster

Import

Using pulumi import, import placement groups using the name. For example:

$ pulumi import aws:ec2/placementGroup:PlacementGroup prod_pg production-placement-group

Constructors

PlacementGroupArgs

fun PlacementGroupArgs(name: Output<String>? = null, partitionCount: Output<Int>? = null, spreadLevel: Output<String>? = null, strategy: Output<Either<String, PlacementStrategy>>? = null, tags: Output<Map<String, String>>? = null)

Functions

toJava

open override fun toJava(): PlacementGroupArgs

Properties

name

val name: Output<String>? = null

The name of the placement group.

partitionCount

val partitionCount: Output<Int>? = null

The number of partitions to create in the placement group. Can only be specified when the strategy is set to partition. Valid values are 1 - 7 (default is 2).

spreadLevel

val spreadLevel: Output<String>? = null

Determines how placement groups spread instances. Can only be used when the strategy is set to spread. Can be host or rack. host can only be used for Outpost placement groups. Defaults to rack.

strategy

val strategy: Output<Either<String, PlacementStrategy>>? = null

The placement strategy. Can be cluster, partition or spread.