InfrastructureConfiguration class

Manages an Image Builder Infrastructure Configuration.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.imagebuilder.InfrastructureConfiguration("example", {
    logging: {
        s3Logs: {
            s3BucketName: exampleAwsS3Bucket.bucket,
            s3KeyPrefix: "logs",
        },
    },
    description: "example description",
    instanceProfileName: exampleAwsIamInstanceProfile.name,
    instanceTypes: [
        "t2.nano",
        "t3.micro",
    ],
    keyPair: exampleAwsKeyPair.keyName,
    name: "example",
    securityGroupIds: [exampleAwsSecurityGroup.id],
    snsTopicArn: exampleAwsSnsTopic.arn,
    subnetId: main.id,
    terminateInstanceOnFailure: true,
    tags: {
        foo: "bar",
    },
});
import pulumi
import pulumi_aws as aws

example = aws.imagebuilder.InfrastructureConfiguration("example",
    logging={
        "s3_logs": {
            "s3_bucket_name": example_aws_s3_bucket["bucket"],
            "s3_key_prefix": "logs",
        },
    },
    description="example description",
    instance_profile_name=example_aws_iam_instance_profile["name"],
    instance_types=[
        "t2.nano",
        "t3.micro",
    ],
    key_pair=example_aws_key_pair["keyName"],
    name="example",
    security_group_ids=[example_aws_security_group["id"]],
    sns_topic_arn=example_aws_sns_topic["arn"],
    subnet_id=main["id"],
    terminate_instance_on_failure=True,
    tags={
        "foo": "bar",
    })
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() =>
{
    var example = new Aws.ImageBuilder.InfrastructureConfiguration("example", new()
    {
        Logging = new Aws.ImageBuilder.Inputs.InfrastructureConfigurationLoggingArgs
        {
            S3Logs = new Aws.ImageBuilder.Inputs.InfrastructureConfigurationLoggingS3LogsArgs
            {
                S3BucketName = exampleAwsS3Bucket.Bucket,
                S3KeyPrefix = "logs",
            },
        },
        Description = "example description",
        InstanceProfileName = exampleAwsIamInstanceProfile.Name,
        InstanceTypes = new[]
        {
            "t2.nano",
            "t3.micro",
        },
        KeyPair = exampleAwsKeyPair.KeyName,
        Name = "example",
        SecurityGroupIds = new[]
        {
            exampleAwsSecurityGroup.Id,
        },
        SnsTopicArn = exampleAwsSnsTopic.Arn,
        SubnetId = main.Id,
        TerminateInstanceOnFailure = true,
        Tags =
        {
            { "foo", "bar" },
        },
    });

});
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/imagebuilder"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := imagebuilder.NewInfrastructureConfiguration(ctx, "example", &imagebuilder.InfrastructureConfigurationArgs{
			Logging: &imagebuilder.InfrastructureConfigurationLoggingArgs{
				S3Logs: &imagebuilder.InfrastructureConfigurationLoggingS3LogsArgs{
					S3BucketName: pulumi.Any(exampleAwsS3Bucket.Bucket),
					S3KeyPrefix:  pulumi.String("logs"),
				},
			},
			Description:         pulumi.String("example description"),
			InstanceProfileName: pulumi.Any(exampleAwsIamInstanceProfile.Name),
			InstanceTypes: pulumi.StringArray{
				pulumi.String("t2.nano"),
				pulumi.String("t3.micro"),
			},
			KeyPair: pulumi.Any(exampleAwsKeyPair.KeyName),
			Name:    pulumi.String("example"),
			SecurityGroupIds: pulumi.StringArray{
				exampleAwsSecurityGroup.Id,
			},
			SnsTopicArn:                pulumi.Any(exampleAwsSnsTopic.Arn),
			SubnetId:                   pulumi.Any(main.Id),
			TerminateInstanceOnFailure: pulumi.Bool(true),
			Tags: pulumi.StringMap{
				"foo": pulumi.String("bar"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_imagebuilder_infrastructureconfiguration" "example" {
  logging = {
    s3_logs = {
      s3_bucket_name = exampleAwsS3Bucket.bucket
      s3_key_prefix  = "logs"
    }
  }
  description                   = "example description"
  instance_profile_name         = exampleAwsIamInstanceProfile.name
  instance_types                = ["t2.nano", "t3.micro"]
  key_pair                      = exampleAwsKeyPair.keyName
  name                          = "example"
  security_group_ids            = [exampleAwsSecurityGroup.id]
  sns_topic_arn                 = exampleAwsSnsTopic.arn
  subnet_id                     = main.id
  terminate_instance_on_failure = true
  tags = {
    "foo" = "bar"
  }
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.imagebuilder.InfrastructureConfiguration;
import com.pulumi.aws.imagebuilder.InfrastructureConfigurationArgs;
import com.pulumi.aws.imagebuilder.inputs.InfrastructureConfigurationLoggingArgs;
import com.pulumi.aws.imagebuilder.inputs.InfrastructureConfigurationLoggingS3LogsArgs;
import java.util.ArrayList;
import java.util.Arrays;
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 example = new InfrastructureConfiguration("example", InfrastructureConfigurationArgs.builder()
            .logging(InfrastructureConfigurationLoggingArgs.builder()
                .s3Logs(InfrastructureConfigurationLoggingS3LogsArgs.builder()
                    .s3BucketName(exampleAwsS3Bucket.bucket())
                    .s3KeyPrefix("logs")
                    .build())
                .build())
            .description("example description")
            .instanceProfileName(exampleAwsIamInstanceProfile.name())
            .instanceTypes(
                "t2.nano",
                "t3.micro")
            .keyPair(exampleAwsKeyPair.keyName())
            .name("example")
            .securityGroupIds(exampleAwsSecurityGroup.id())
            .snsTopicArn(exampleAwsSnsTopic.arn())
            .subnetId(main.id())
            .terminateInstanceOnFailure(true)
            .tags(Map.of("foo", "bar"))
            .build());

    }
}
resources:
  example:
    type: aws:imagebuilder:InfrastructureConfiguration
    properties:
      logging:
        s3Logs:
          s3BucketName: ${exampleAwsS3Bucket.bucket}
          s3KeyPrefix: logs
      description: example description
      instanceProfileName: ${exampleAwsIamInstanceProfile.name}
      instanceTypes:
        - t2.nano
        - t3.micro
      keyPair: ${exampleAwsKeyPair.keyName}
      name: example
      securityGroupIds:
        - ${exampleAwsSecurityGroup.id}
      snsTopicArn: ${exampleAwsSnsTopic.arn}
      subnetId: ${main.id}
      terminateInstanceOnFailure: true
      tags:
        foo: bar

Import

Identity Schema

Required

  • arn (String) ARN of the Image Builder infrastructure configuration.

Using pulumi import, import aws.imagebuilder.InfrastructureConfiguration using the ARN. For example:

$ pulumi import aws:imagebuilder/infrastructureConfiguration:InfrastructureConfiguration example arn:aws:imagebuilder:us-east-1:123456789012:infrastructure-configuration/example

Constructors

InfrastructureConfiguration(String name, {InfrastructureConfigurationArgs? args, CustomResourceOptions? options})
Creates a new InfrastructureConfiguration. name The Pulumi resource name. args Arguments used to configure this InfrastructureConfiguration. The set of arguments for InfrastructureConfiguration. options Resource options controlling this resource's behavior.
InfrastructureConfiguration.reference(String urn)
Creates a typed reference to an existing InfrastructureConfiguration resource.

Properties

arn ↔ Output<String>
ARN of the configuration.
latefinal
childResources → Set<Resource>
finalinherited
completionSources ↔ Map<String, IOutputCompletionSource>
latefinalinherited
dateCreated ↔ Output<String>
Date when the configuration was created.
latefinal
dateUpdated ↔ Output<String>
Date when the configuration was updated.
latefinal
description ↔ Output<String?>
Description for the configuration.
latefinal
hashCode → int
The hash code for this object.
no setterinherited
id ↔ Output<String>
getter/setter pairinherited
instanceMetadataOptions ↔ Output<InfrastructureConfigurationInstanceMetadataOptions?>
Configuration block with instance metadata options for the HTTP requests that pipeline builds use to launch EC2 build and test instances. Detailed below.
latefinal
instanceProfileName ↔ Output<String>
Name of IAM Instance Profile.
latefinal
instanceTypes ↔ Output<List<String>?>
Set of EC2 Instance Types.
latefinal
isCustom → bool
Returns whether this resource is provider-managed.
no setterinherited
isProtected → bool
Returns whether this resource is protected from deletion.
no setterinherited
isRemote → bool
Whether this resource is registered as remote.
no setterinherited
isResourceReference → bool
Whether this instance represents a resource value returned over RPC.
finalinherited
keyPair ↔ Output<String?>
Name of EC2 Key Pair.
latefinal
logging ↔ Output<InfrastructureConfigurationLogging?>
Configuration block with logging settings. Detailed below.
latefinal
name ↔ Output<String>
Name for the configuration.
latefinal
placement ↔ Output<InfrastructureConfigurationPlacement?>
Configuration block with placement settings that define where the instances that are launched from your image will run. Detailed below.
latefinal
region ↔ Output<String>
Region where this resource will be managed. Defaults to the Region set in the provider configuration.
latefinal
resourceTags ↔ Output<Map<String, String>?>
Key-value map of resource tags to assign to infrastructure created by the configuration.
latefinal
resourceTransforms → List<ResourceTransform>
Inherited/explicit async transforms.
no setterinherited
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
securityGroupIds ↔ Output<List<String>?>
Set of EC2 Security Group identifiers.
latefinal
snsTopicArn ↔ Output<String?>
ARN of SNS Topic.
latefinal
subnetId ↔ Output<String?>
EC2 Subnet identifier. Also requires securityGroupIds argument.
latefinal
tags ↔ Output<Map<String, String>?>
Key-value map of resource tags to assign to the configuration. .If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
latefinal
tagsAll ↔ Output<Map<String, String>>
A map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
latefinal
terminateInstanceOnFailure ↔ Output<bool?>
Enable if the instance should be terminated when the pipeline fails. Defaults to false.
latefinal
transformations → List<ResourceTransformation>
Inherited/explicit legacy transformations.
no setterinherited
urn ↔ Output<String>
latefinalinherited

Methods

failId(Object error) → void
Completes this resource ID with an error when registration fails.
inherited
failOutputs(Object error) → void
Completes all output properties with error.
inherited
failUrn(Object error) → void
Completes this resource URN with an error when registration fails.
inherited
getProvider(String moduleMember) → ProviderResource?
Returns provider for moduleMember's package, if configured.
inherited
getResourceName() → String
Returns this resource's logical name.
inherited
getResourceType() → String
Returns this resource's Pulumi type token.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
registerOutput<T>(String propertyName, {Object? decoder(Object?)?, bool isSecret = false}) → Output<T>
Registers a dynamic output property for this resource.
inherited
resolveId(String? value, {required bool isKnown}) → void
Resolves the provider-assigned ID for this resource.
inherited
resolveOutputs(Struct outputs) → void
Resolves all output properties from a monitor response payload.
inherited
resolveUrn(String value) → void
Resolves this resource's URN once assigned by the engine.
inherited
serializeProperties(Map<String, dynamic> properties) → Future<Struct>
Serializes resource properties for RPC transmission.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited

Static Methods

get(String name, Input<String> id, {InfrastructureConfigurationState? state, CustomResourceOptions? options}) → InfrastructureConfiguration
Gets an existing InfrastructureConfiguration resource's state with the given name and id.