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.
nameThe Pulumi resource name.argsArguments used to configure this InfrastructureConfiguration. The set of arguments for InfrastructureConfiguration.optionsResource 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
securityGroupIdsargument.latefinal -
Key-value map of resource tags to assign to the configuration. .If configured with a provider
defaultTagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level.latefinal -
A map of tags assigned to the resource, including those inherited from the provider
defaultTagsconfiguration 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
nameandid.