The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Paws::ImageBuilder::CreateInfrastructureConfiguration - Arguments for method CreateInfrastructureConfiguration on Paws::ImageBuilder

DESCRIPTION

This class represents the parameters used for calling the method CreateInfrastructureConfiguration on the EC2 Image Builder service. Use the attributes of this class as arguments to method CreateInfrastructureConfiguration.

You shouldn't make instances of this class. Each attribute should be used as a named argument in the call to CreateInfrastructureConfiguration.

SYNOPSIS

    my $imagebuilder = Paws->service('ImageBuilder');
    my $CreateInfrastructureConfigurationResponse =
      $imagebuilder->CreateInfrastructureConfiguration(
      ClientToken         => 'MyClientToken',
      InstanceProfileName => 'MyInstanceProfileNameType',
      Name                => 'MyResourceName',
      Description         => 'MyNonEmptyString',            # OPTIONAL
      InstanceTypes       => [ 'MyInstanceType', ... ],     # OPTIONAL
      KeyPair             => 'MyNonEmptyString',            # OPTIONAL
      Logging             => {
        S3Logs => {
          S3BucketName => 'MyNonEmptyString',    # min: 1, max: 1024
          S3KeyPrefix  => 'MyNonEmptyString',    # min: 1, max: 1024
        },    # OPTIONAL
      },    # OPTIONAL
      ResourceTags => {
        'MyTagKey' => 'MyTagValue',    # key: min: 1, max: 128, value: max: 256
      },    # OPTIONAL
      SecurityGroupIds => [
        'MyNonEmptyString', ...    # min: 1, max: 1024
      ],    # OPTIONAL
      SnsTopicArn => 'MySnsTopicArn',       # OPTIONAL
      SubnetId    => 'MyNonEmptyString',    # OPTIONAL
      Tags        => {
        'MyTagKey' => 'MyTagValue',    # key: min: 1, max: 128, value: max: 256
      },    # OPTIONAL
      TerminateInstanceOnFailure => 1,    # OPTIONAL
      );

    # Results:
    my $ClientToken = $CreateInfrastructureConfigurationResponse->ClientToken;
    my $InfrastructureConfigurationArn =
      $CreateInfrastructureConfigurationResponse
      ->InfrastructureConfigurationArn;
    my $RequestId = $CreateInfrastructureConfigurationResponse->RequestId;

# Returns a Paws::ImageBuilder::CreateInfrastructureConfigurationResponse object.

Values for attributes that are native types (Int, String, Float, etc) can passed as-is (scalar values). Values for complex Types (objects) can be passed as a HashRef. The keys and values of the hashref will be used to instance the underlying object. For the AWS API documentation, see https://docs.aws.amazon.com/goto/WebAPI/imagebuilder/CreateInfrastructureConfiguration

ATTRIBUTES

REQUIRED ClientToken => Str

The idempotency token used to make this request idempotent.

Description => Str

The description of the infrastructure configuration.

REQUIRED InstanceProfileName => Str

The instance profile to associate with the instance used to customize your Amazon EC2 AMI.

InstanceTypes => ArrayRef[Str|Undef]

The instance types of the infrastructure configuration. You can specify one or more instance types to use for this build. The service will pick one of these instance types based on availability.

KeyPair => Str

The key pair of the infrastructure configuration. This can be used to log on to and debug the instance used to create your image.

Logging => Paws::ImageBuilder::Logging

The logging configuration of the infrastructure configuration.

REQUIRED Name => Str

The name of the infrastructure configuration.

ResourceTags => Paws::ImageBuilder::ResourceTagMap

The tags attached to the resource created by Image Builder.

SecurityGroupIds => ArrayRef[Str|Undef]

The security group IDs to associate with the instance used to customize your Amazon EC2 AMI.

SnsTopicArn => Str

The SNS topic on which to send image build events.

SubnetId => Str

The subnet ID in which to place the instance used to customize your Amazon EC2 AMI.

Tags => Paws::ImageBuilder::TagMap

The tags of the infrastructure configuration.

TerminateInstanceOnFailure => Bool

The terminate instance on failure setting of the infrastructure configuration. Set to false if you want Image Builder to retain the instance used to configure your AMI if the build or test phase of your workflow fails.

SEE ALSO

This class forms part of Paws, documenting arguments for method CreateInfrastructureConfiguration in Paws::ImageBuilder

BUGS and CONTRIBUTIONS

The source code is located here: https://github.com/pplu/aws-sdk-perl

Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues