aws-native.imagebuilder.InfrastructureConfiguration

Explore with Pulumi AI

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.26.0 published on Wednesday, Mar 12, 2025 by Pulumi

pulumi/pulumi-aws-native

Create InfrastructureConfiguration Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new InfrastructureConfiguration(name: string, args: InfrastructureConfigurationArgs, opts?: CustomResourceOptions);

@overload
def InfrastructureConfiguration(resource_name: str,
                                args: InfrastructureConfigurationArgs,
                                opts: Optional[ResourceOptions] = None)

@overload
def InfrastructureConfiguration(resource_name: str,
                                opts: Optional[ResourceOptions] = None,
                                instance_profile_name: Optional[str] = None,
                                name: Optional[str] = None,
                                instance_metadata_options: Optional[InfrastructureConfigurationInstanceMetadataOptionsArgs] = None,
                                instance_types: Optional[Sequence[str]] = None,
                                key_pair: Optional[str] = None,
                                logging: Optional[InfrastructureConfigurationLoggingArgs] = None,
                                description: Optional[str] = None,
                                placement: Optional[InfrastructureConfigurationPlacementArgs] = None,
                                resource_tags: Optional[Mapping[str, str]] = None,
                                security_group_ids: Optional[Sequence[str]] = None,
                                sns_topic_arn: Optional[str] = None,
                                subnet_id: Optional[str] = None,
                                tags: Optional[Mapping[str, str]] = None,
                                terminate_instance_on_failure: Optional[bool] = None)

func NewInfrastructureConfiguration(ctx *Context, name string, args InfrastructureConfigurationArgs, opts ...ResourceOption) (*InfrastructureConfiguration, error)

public InfrastructureConfiguration(string name, InfrastructureConfigurationArgs args, CustomResourceOptions? opts = null)

public InfrastructureConfiguration(String name, InfrastructureConfigurationArgs args)
public InfrastructureConfiguration(String name, InfrastructureConfigurationArgs args, CustomResourceOptions options)

type: aws-native:imagebuilder:InfrastructureConfiguration
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name string: The unique name of the resource.
args InfrastructureConfigurationArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

resource_name str: The unique name of the resource.
args InfrastructureConfigurationArgs: The arguments to resource properties.
opts ResourceOptions: Bag of options to control resource's behavior.

ctx Context: Context object for the current deployment.
name string: The unique name of the resource.
args InfrastructureConfigurationArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args InfrastructureConfigurationArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args InfrastructureConfigurationArgs: The arguments to resource properties.
options CustomResourceOptions: Bag of options to control resource's behavior.

InfrastructureConfiguration Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

The InfrastructureConfiguration resource accepts the following input properties:

InstanceProfileName string: The instance profile of the infrastructure configuration.
Description string: The description of the infrastructure configuration.
InstanceMetadataOptions Pulumi.AwsNative.ImageBuilder.Inputs.InfrastructureConfigurationInstanceMetadataOptions: The instance metadata option settings for the infrastructure configuration.
InstanceTypes List<string>: The instance types of the infrastructure configuration.
KeyPair string: The EC2 key pair of the infrastructure configuration..
Logging Pulumi.AwsNative.ImageBuilder.Inputs.InfrastructureConfigurationLogging: The logging configuration of the infrastructure configuration.
Name string: The name of the infrastructure configuration.
Placement Pulumi.AwsNative.ImageBuilder.Inputs.InfrastructureConfigurationPlacement: The placement option settings for the infrastructure configuration.
ResourceTags Dictionary<string, string>: The tags attached to the resource created by Image Builder.
SecurityGroupIds List<string>: The security group IDs of the infrastructure configuration.
SnsTopicArn string: The SNS Topic Amazon Resource Name (ARN) of the infrastructure configuration.
SubnetId string: The subnet ID of the infrastructure configuration.
Tags Dictionary<string, string>: The tags associated with the component.
TerminateInstanceOnFailure bool: The terminate instance on failure configuration of the infrastructure configuration.

InstanceProfileName string: The instance profile of the infrastructure configuration.
Description string: The description of the infrastructure configuration.
InstanceMetadataOptions InfrastructureConfigurationInstanceMetadataOptionsArgs: The instance metadata option settings for the infrastructure configuration.
InstanceTypes []string: The instance types of the infrastructure configuration.
KeyPair string: The EC2 key pair of the infrastructure configuration..
Logging InfrastructureConfigurationLoggingArgs: The logging configuration of the infrastructure configuration.
Name string: The name of the infrastructure configuration.
Placement InfrastructureConfigurationPlacementArgs: The placement option settings for the infrastructure configuration.
ResourceTags map[string]string: The tags attached to the resource created by Image Builder.
SecurityGroupIds []string: The security group IDs of the infrastructure configuration.
SnsTopicArn string: The SNS Topic Amazon Resource Name (ARN) of the infrastructure configuration.
SubnetId string: The subnet ID of the infrastructure configuration.
Tags map[string]string: The tags associated with the component.
TerminateInstanceOnFailure bool: The terminate instance on failure configuration of the infrastructure configuration.

instanceProfileName String: The instance profile of the infrastructure configuration.
description String: The description of the infrastructure configuration.
instanceMetadataOptions InfrastructureConfigurationInstanceMetadataOptions: The instance metadata option settings for the infrastructure configuration.
instanceTypes List<String>: The instance types of the infrastructure configuration.
keyPair String: The EC2 key pair of the infrastructure configuration..
logging InfrastructureConfigurationLogging: The logging configuration of the infrastructure configuration.
name String: The name of the infrastructure configuration.
placement InfrastructureConfigurationPlacement: The placement option settings for the infrastructure configuration.
resourceTags Map<String,String>: The tags attached to the resource created by Image Builder.
securityGroupIds List<String>: The security group IDs of the infrastructure configuration.
snsTopicArn String: The SNS Topic Amazon Resource Name (ARN) of the infrastructure configuration.
subnetId String: The subnet ID of the infrastructure configuration.
tags Map<String,String>: The tags associated with the component.
terminateInstanceOnFailure Boolean: The terminate instance on failure configuration of the infrastructure configuration.

instanceProfileName string: The instance profile of the infrastructure configuration.
description string: The description of the infrastructure configuration.
instanceMetadataOptions InfrastructureConfigurationInstanceMetadataOptions: The instance metadata option settings for the infrastructure configuration.
instanceTypes string[]: The instance types of the infrastructure configuration.
keyPair string: The EC2 key pair of the infrastructure configuration..
logging InfrastructureConfigurationLogging: The logging configuration of the infrastructure configuration.
name string: The name of the infrastructure configuration.
placement InfrastructureConfigurationPlacement: The placement option settings for the infrastructure configuration.
resourceTags {[key: string]: string}: The tags attached to the resource created by Image Builder.
securityGroupIds string[]: The security group IDs of the infrastructure configuration.
snsTopicArn string: The SNS Topic Amazon Resource Name (ARN) of the infrastructure configuration.
subnetId string: The subnet ID of the infrastructure configuration.
tags {[key: string]: string}: The tags associated with the component.
terminateInstanceOnFailure boolean: The terminate instance on failure configuration of the infrastructure configuration.

instance_profile_name str: The instance profile of the infrastructure configuration.
description str: The description of the infrastructure configuration.
instance_metadata_options InfrastructureConfigurationInstanceMetadataOptionsArgs: The instance metadata option settings for the infrastructure configuration.
instance_types Sequence[str]: The instance types of the infrastructure configuration.
key_pair str: The EC2 key pair of the infrastructure configuration..
logging InfrastructureConfigurationLoggingArgs: The logging configuration of the infrastructure configuration.
name str: The name of the infrastructure configuration.
placement InfrastructureConfigurationPlacementArgs: The placement option settings for the infrastructure configuration.
resource_tags Mapping[str, str]: The tags attached to the resource created by Image Builder.
security_group_ids Sequence[str]: The security group IDs of the infrastructure configuration.
sns_topic_arn str: The SNS Topic Amazon Resource Name (ARN) of the infrastructure configuration.
subnet_id str: The subnet ID of the infrastructure configuration.
tags Mapping[str, str]: The tags associated with the component.
terminate_instance_on_failure bool: The terminate instance on failure configuration of the infrastructure configuration.

instanceProfileName String: The instance profile of the infrastructure configuration.
description String: The description of the infrastructure configuration.
instanceMetadataOptions Property Map: The instance metadata option settings for the infrastructure configuration.
instanceTypes List<String>: The instance types of the infrastructure configuration.
keyPair String: The EC2 key pair of the infrastructure configuration..
logging Property Map: The logging configuration of the infrastructure configuration.
name String: The name of the infrastructure configuration.
placement Property Map: The placement option settings for the infrastructure configuration.
resourceTags Map<String>: The tags attached to the resource created by Image Builder.
securityGroupIds List<String>: The security group IDs of the infrastructure configuration.
snsTopicArn String: The SNS Topic Amazon Resource Name (ARN) of the infrastructure configuration.
subnetId String: The subnet ID of the infrastructure configuration.
tags Map<String>: The tags associated with the component.
terminateInstanceOnFailure Boolean: The terminate instance on failure configuration of the infrastructure configuration.

Outputs

All input properties are implicitly available as output properties. Additionally, the InfrastructureConfiguration resource produces the following output properties:

Arn string: The Amazon Resource Name (ARN) of the infrastructure configuration.
Id string: The provider-assigned unique ID for this managed resource.

Arn string: The Amazon Resource Name (ARN) of the infrastructure configuration.
Id string: The provider-assigned unique ID for this managed resource.

arn String: The Amazon Resource Name (ARN) of the infrastructure configuration.
id String: The provider-assigned unique ID for this managed resource.

arn string: The Amazon Resource Name (ARN) of the infrastructure configuration.
id string: The provider-assigned unique ID for this managed resource.

arn str: The Amazon Resource Name (ARN) of the infrastructure configuration.
id str: The provider-assigned unique ID for this managed resource.

arn String: The Amazon Resource Name (ARN) of the infrastructure configuration.
id String: The provider-assigned unique ID for this managed resource.

Supporting Types

InfrastructureConfigurationInstanceMetadataOptions, InfrastructureConfigurationInstanceMetadataOptionsArgs

HttpPutResponseHopLimit int: Limit the number of hops that an instance metadata request can traverse to reach its destination.
HttpTokens Pulumi.AwsNative.ImageBuilder.InfrastructureConfigurationInstanceMetadataOptionsHttpTokens: Indicates whether a signed token header is required for instance metadata retrieval requests. The values affect the response as follows:

HttpPutResponseHopLimit int: Limit the number of hops that an instance metadata request can traverse to reach its destination.
HttpTokens InfrastructureConfigurationInstanceMetadataOptionsHttpTokens: Indicates whether a signed token header is required for instance metadata retrieval requests. The values affect the response as follows:

httpPutResponseHopLimit Integer: Limit the number of hops that an instance metadata request can traverse to reach its destination.
httpTokens InfrastructureConfigurationInstanceMetadataOptionsHttpTokens: Indicates whether a signed token header is required for instance metadata retrieval requests. The values affect the response as follows:

httpPutResponseHopLimit number: Limit the number of hops that an instance metadata request can traverse to reach its destination.
httpTokens InfrastructureConfigurationInstanceMetadataOptionsHttpTokens: Indicates whether a signed token header is required for instance metadata retrieval requests. The values affect the response as follows:

http_put_response_hop_limit int: Limit the number of hops that an instance metadata request can traverse to reach its destination.
http_tokens InfrastructureConfigurationInstanceMetadataOptionsHttpTokens: Indicates whether a signed token header is required for instance metadata retrieval requests. The values affect the response as follows:

httpPutResponseHopLimit Number: Limit the number of hops that an instance metadata request can traverse to reach its destination.
httpTokens "required" | "optional": Indicates whether a signed token header is required for instance metadata retrieval requests. The values affect the response as follows:

InfrastructureConfigurationInstanceMetadataOptionsHttpTokens, InfrastructureConfigurationInstanceMetadataOptionsHttpTokensArgs

Required: required
Optional: optional

InfrastructureConfigurationInstanceMetadataOptionsHttpTokensRequired: required
InfrastructureConfigurationInstanceMetadataOptionsHttpTokensOptional: optional

Required: required
Optional: optional