Docs Packages
  1. Packages
  2. AWS Native
  3. API Docs
  4. imagebuilder
  5. InfrastructureConfiguration

AWS Native is in preview. AWS Classic is fully supported.

AWS Native v0.103.0 published on Monday, Apr 22, 2024 by Pulumi
pulumi/pulumi-aws-native

aws-native.imagebuilder.InfrastructureConfiguration

Explore with Pulumi AI

aws-native logo

AWS Native is in preview. AWS Classic is fully supported.

AWS Native v0.103.0 published on Monday, Apr 22, 2024 by Pulumi
pulumi/pulumi-aws-native

    Resource schema for AWS::ImageBuilder::InfrastructureConfiguration

    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,
                                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.

    Example

    The following reference example uses placeholder values for all input properties.

    Coming soon!

    Coming soon!

    Coming soon!

    Coming soon!

    const infrastructureConfigurationResource = new aws_native.imagebuilder.InfrastructureConfiguration("infrastructureConfigurationResource", {
    instanceProfileName: "string",
    name: "string",
    instanceMetadataOptions: {
        httpPutResponseHopLimit: 0,
        httpTokens: aws_native.imagebuilder.InfrastructureConfigurationInstanceMetadataOptionsHttpTokens.Required,
    },
    instanceTypes: ["string"],
    keyPair: "string",
    logging: {
        s3Logs: {
            s3BucketName: "string",
            s3KeyPrefix: "string",
        },
    },
    description: "string",
    resourceTags: {
        string: "string",
    },
    securityGroupIds: ["string"],
    snsTopicArn: "string",
    subnetId: "string",
    tags: {
        string: "string",
    },
    terminateInstanceOnFailure: false,
});

    Coming soon!

    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

    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.
    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.
    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.
    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.
    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.
    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.
    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
    Required
    required
    Optional
    optional
    REQUIRED
    required
    OPTIONAL
    optional
    "required"
    required
    "optional"
    optional

    InfrastructureConfigurationLogging, InfrastructureConfigurationLoggingArgs

    InfrastructureConfigurationS3Logs, InfrastructureConfigurationS3LogsArgs

    S3BucketName string
    S3BucketName
    S3KeyPrefix string
    S3KeyPrefix
    S3BucketName string
    S3BucketName
    S3KeyPrefix string
    S3KeyPrefix
    s3BucketName String
    S3BucketName
    s3KeyPrefix String
    S3KeyPrefix
    s3BucketName string
    S3BucketName
    s3KeyPrefix string
    S3KeyPrefix
    s3_bucket_name str
    S3BucketName
    s3_key_prefix str
    S3KeyPrefix
    s3BucketName String
    S3BucketName
    s3KeyPrefix String
    S3KeyPrefix

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo

    AWS Native is in preview. AWS Classic is fully supported.

    AWS Native v0.103.0 published on Monday, Apr 22, 2024 by Pulumi
    pulumi/pulumi-aws-native