Class CfnInfrastructureConfiguration.PlacementProperty

By default, EC2 instances run on shared tenancy hardware.

Inheritance

System.Object

CfnInfrastructureConfiguration.PlacementProperty

Implements

CfnInfrastructureConfiguration.IPlacementProperty

Namespace: Amazon.CDK.AWS.ImageBuilder

Assembly: Amazon.CDK.Lib.dll

Syntax (csharp)

public class PlacementProperty : Object, CfnInfrastructureConfiguration.IPlacementProperty

Syntax (vb)

Public Class PlacementProperty
    Inherits Object
    Implements CfnInfrastructureConfiguration.IPlacementProperty

Remarks

This means that multiple AWS accounts might share the same physical hardware. When you use dedicated hardware, the physical server that hosts your instances is dedicated to your AWS account . Instance placement settings contain the details for the physical hardware where instances that Image Builder launches during image creation will run.

See: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-imagebuilder-infrastructureconfiguration-placement.html

ExampleMetadata: fixture=_generated

Examples

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.ImageBuilder;

var placementProperty = new PlacementProperty {
    AvailabilityZone = "availabilityZone",
    HostId = "hostId",
    HostResourceGroupArn = "hostResourceGroupArn",
    Tenancy = "tenancy"
};

Synopsis

Constructors

PlacementProperty()

Properties

AvailabilityZone	The Availability Zone where your build and test instances will launch.
HostId	The ID of the Dedicated Host on which build and test instances run.
HostResourceGroupArn	The Amazon Resource Name (ARN) of the host resource group in which to launch build and test instances.
Tenancy	The tenancy of the instance.

Constructors

PlacementProperty()

public PlacementProperty()

Properties

AvailabilityZone

The Availability Zone where your build and test instances will launch.

public string AvailabilityZone { get; set; }

Property Value

System.String

Remarks

See: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-imagebuilder-infrastructureconfiguration-placement.html#cfn-imagebuilder-infrastructureconfiguration-placement-availabilityzone

HostId

The ID of the Dedicated Host on which build and test instances run.

public string HostId { get; set; }

Property Value

System.String

Remarks

This only applies if tenancy is host . If you specify the host ID, you must not specify the resource group ARN. If you specify both, Image Builder returns an error.

HostResourceGroupArn

The Amazon Resource Name (ARN) of the host resource group in which to launch build and test instances.

public string HostResourceGroupArn { get; set; }

Property Value

System.String

Remarks

This only applies if tenancy is host . If you specify the resource group ARN, you must not specify the host ID. If you specify both, Image Builder returns an error.

Tenancy

The tenancy of the instance.

public string Tenancy { get; set; }

Property Value

System.String

Remarks

An instance with a tenancy of dedicated runs on single-tenant hardware. An instance with a tenancy of host runs on a Dedicated Host.

If tenancy is set to host , then you can optionally specify one target for placement – either host ID or host resource group ARN. If automatic placement is enabled for your host, and you don't specify any placement target, Amazon EC2 will try to find an available host for your build and test instances.

Implements

CfnInfrastructureConfiguration.IPlacementProperty