libZSservicesZSamazonka-imagebuilderZSamazonka-imagebuilder
Copyright(c) 2013-2021 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone

Amazonka.ImageBuilder.CreateInfrastructureConfiguration

Description

Creates a new infrastructure configuration. An infrastructure configuration defines the environment in which your image will be built and tested.

Synopsis

Creating a Request

data CreateInfrastructureConfiguration Source #

See: newCreateInfrastructureConfiguration smart constructor.

Constructors

CreateInfrastructureConfiguration' 

Fields

  • securityGroupIds :: Maybe [Text]

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

  • snsTopicArn :: Maybe Text

    The SNS topic on which to send image build events.

  • instanceTypes :: Maybe [Text]

    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 :: Maybe Text

    The key pair of the infrastructure configuration. You can use this to log on to and debug the instance used to create your image.

  • resourceTags :: Maybe (HashMap Text Text)

    The tags attached to the resource created by Image Builder.

  • subnetId :: Maybe Text

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

  • instanceMetadataOptions :: Maybe InstanceMetadataOptions

    The instance metadata options that you can set for the HTTP requests that pipeline builds use to launch EC2 build and test instances.

  • logging :: Maybe Logging

    The logging configuration of the infrastructure configuration.

  • description :: Maybe Text

    The description of the infrastructure configuration.

  • tags :: Maybe (HashMap Text Text)

    The tags of the infrastructure configuration.

  • terminateInstanceOnFailure :: Maybe 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.

  • name :: Text

    The name of the infrastructure configuration.

  • instanceProfileName :: Text

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

  • clientToken :: Text

    The idempotency token used to make this request idempotent.

Instances

Instances details
Eq CreateInfrastructureConfiguration Source # 
Instance details

Defined in Amazonka.ImageBuilder.CreateInfrastructureConfiguration

Read CreateInfrastructureConfiguration Source # 
Instance details

Defined in Amazonka.ImageBuilder.CreateInfrastructureConfiguration

Show CreateInfrastructureConfiguration Source # 
Instance details

Defined in Amazonka.ImageBuilder.CreateInfrastructureConfiguration

Generic CreateInfrastructureConfiguration Source # 
Instance details

Defined in Amazonka.ImageBuilder.CreateInfrastructureConfiguration

Associated Types

type Rep CreateInfrastructureConfiguration :: Type -> Type #

NFData CreateInfrastructureConfiguration Source # 
Instance details

Defined in Amazonka.ImageBuilder.CreateInfrastructureConfiguration

Hashable CreateInfrastructureConfiguration Source # 
Instance details

Defined in Amazonka.ImageBuilder.CreateInfrastructureConfiguration

ToJSON CreateInfrastructureConfiguration Source # 
Instance details

Defined in Amazonka.ImageBuilder.CreateInfrastructureConfiguration

AWSRequest CreateInfrastructureConfiguration Source # 
Instance details

Defined in Amazonka.ImageBuilder.CreateInfrastructureConfiguration

ToHeaders CreateInfrastructureConfiguration Source # 
Instance details

Defined in Amazonka.ImageBuilder.CreateInfrastructureConfiguration

ToPath CreateInfrastructureConfiguration Source # 
Instance details

Defined in Amazonka.ImageBuilder.CreateInfrastructureConfiguration

ToQuery CreateInfrastructureConfiguration Source # 
Instance details

Defined in Amazonka.ImageBuilder.CreateInfrastructureConfiguration

type Rep CreateInfrastructureConfiguration Source # 
Instance details

Defined in Amazonka.ImageBuilder.CreateInfrastructureConfiguration

type Rep CreateInfrastructureConfiguration = D1 ('MetaData "CreateInfrastructureConfiguration" "Amazonka.ImageBuilder.CreateInfrastructureConfiguration" "libZSservicesZSamazonka-imagebuilderZSamazonka-imagebuilder" 'False) (C1 ('MetaCons "CreateInfrastructureConfiguration'" 'PrefixI 'True) (((S1 ('MetaSel ('Just "securityGroupIds") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Text])) :*: (S1 ('MetaSel ('Just "snsTopicArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "instanceTypes") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Text])))) :*: ((S1 ('MetaSel ('Just "keyPair") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "resourceTags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (HashMap Text Text)))) :*: (S1 ('MetaSel ('Just "subnetId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "instanceMetadataOptions") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe InstanceMetadataOptions))))) :*: ((S1 ('MetaSel ('Just "logging") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Logging)) :*: (S1 ('MetaSel ('Just "description") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "tags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (HashMap Text Text))))) :*: ((S1 ('MetaSel ('Just "terminateInstanceOnFailure") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 ('MetaSel ('Just "name") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)) :*: (S1 ('MetaSel ('Just "instanceProfileName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "clientToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text))))))
type AWSResponse CreateInfrastructureConfiguration Source # 
Instance details

Defined in Amazonka.ImageBuilder.CreateInfrastructureConfiguration

newCreateInfrastructureConfiguration Source #

Create a value of CreateInfrastructureConfiguration with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:securityGroupIds:CreateInfrastructureConfiguration', createInfrastructureConfiguration_securityGroupIds - The security group IDs to associate with the instance used to customize your Amazon EC2 AMI.

$sel:snsTopicArn:CreateInfrastructureConfiguration', createInfrastructureConfiguration_snsTopicArn - The SNS topic on which to send image build events.

$sel:instanceTypes:CreateInfrastructureConfiguration', createInfrastructureConfiguration_instanceTypes - 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.

$sel:keyPair:CreateInfrastructureConfiguration', createInfrastructureConfiguration_keyPair - The key pair of the infrastructure configuration. You can use this to log on to and debug the instance used to create your image.

$sel:resourceTags:CreateInfrastructureConfiguration', createInfrastructureConfiguration_resourceTags - The tags attached to the resource created by Image Builder.

$sel:subnetId:CreateInfrastructureConfiguration', createInfrastructureConfiguration_subnetId - The subnet ID in which to place the instance used to customize your Amazon EC2 AMI.

$sel:instanceMetadataOptions:CreateInfrastructureConfiguration', createInfrastructureConfiguration_instanceMetadataOptions - The instance metadata options that you can set for the HTTP requests that pipeline builds use to launch EC2 build and test instances.

$sel:logging:CreateInfrastructureConfiguration', createInfrastructureConfiguration_logging - The logging configuration of the infrastructure configuration.

$sel:description:CreateInfrastructureConfiguration', createInfrastructureConfiguration_description - The description of the infrastructure configuration.

$sel:tags:CreateInfrastructureConfiguration', createInfrastructureConfiguration_tags - The tags of the infrastructure configuration.

$sel:terminateInstanceOnFailure:CreateInfrastructureConfiguration', createInfrastructureConfiguration_terminateInstanceOnFailure - 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.

$sel:name:CreateInfrastructureConfiguration', createInfrastructureConfiguration_name - The name of the infrastructure configuration.

$sel:instanceProfileName:CreateInfrastructureConfiguration', createInfrastructureConfiguration_instanceProfileName - The instance profile to associate with the instance used to customize your Amazon EC2 AMI.

$sel:clientToken:CreateInfrastructureConfiguration', createInfrastructureConfiguration_clientToken - The idempotency token used to make this request idempotent.

Request Lenses

createInfrastructureConfiguration_securityGroupIds :: Lens' CreateInfrastructureConfiguration (Maybe [Text]) Source #

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

createInfrastructureConfiguration_instanceTypes :: Lens' CreateInfrastructureConfiguration (Maybe [Text]) Source #

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.

createInfrastructureConfiguration_keyPair :: Lens' CreateInfrastructureConfiguration (Maybe Text) Source #

The key pair of the infrastructure configuration. You can use this to log on to and debug the instance used to create your image.

createInfrastructureConfiguration_resourceTags :: Lens' CreateInfrastructureConfiguration (Maybe (HashMap Text Text)) Source #

The tags attached to the resource created by Image Builder.

createInfrastructureConfiguration_subnetId :: Lens' CreateInfrastructureConfiguration (Maybe Text) Source #

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

createInfrastructureConfiguration_instanceMetadataOptions :: Lens' CreateInfrastructureConfiguration (Maybe InstanceMetadataOptions) Source #

The instance metadata options that you can set for the HTTP requests that pipeline builds use to launch EC2 build and test instances.

createInfrastructureConfiguration_logging :: Lens' CreateInfrastructureConfiguration (Maybe Logging) Source #

The logging configuration of the infrastructure configuration.

createInfrastructureConfiguration_terminateInstanceOnFailure :: Lens' CreateInfrastructureConfiguration (Maybe Bool) Source #

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.

createInfrastructureConfiguration_instanceProfileName :: Lens' CreateInfrastructureConfiguration Text Source #

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

createInfrastructureConfiguration_clientToken :: Lens' CreateInfrastructureConfiguration Text Source #

The idempotency token used to make this request idempotent.

Destructuring the Response

data CreateInfrastructureConfigurationResponse Source #

Constructors

CreateInfrastructureConfigurationResponse' 

Fields

Instances

Instances details
Eq CreateInfrastructureConfigurationResponse Source # 
Instance details

Defined in Amazonka.ImageBuilder.CreateInfrastructureConfiguration

Read CreateInfrastructureConfigurationResponse Source # 
Instance details

Defined in Amazonka.ImageBuilder.CreateInfrastructureConfiguration

Show CreateInfrastructureConfigurationResponse Source # 
Instance details

Defined in Amazonka.ImageBuilder.CreateInfrastructureConfiguration

Generic CreateInfrastructureConfigurationResponse Source # 
Instance details

Defined in Amazonka.ImageBuilder.CreateInfrastructureConfiguration

NFData CreateInfrastructureConfigurationResponse Source # 
Instance details

Defined in Amazonka.ImageBuilder.CreateInfrastructureConfiguration

type Rep CreateInfrastructureConfigurationResponse Source # 
Instance details

Defined in Amazonka.ImageBuilder.CreateInfrastructureConfiguration

type Rep CreateInfrastructureConfigurationResponse = D1 ('MetaData "CreateInfrastructureConfigurationResponse" "Amazonka.ImageBuilder.CreateInfrastructureConfiguration" "libZSservicesZSamazonka-imagebuilderZSamazonka-imagebuilder" 'False) (C1 ('MetaCons "CreateInfrastructureConfigurationResponse'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "requestId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "infrastructureConfigurationArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "clientToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newCreateInfrastructureConfigurationResponse Source #

Create a value of CreateInfrastructureConfigurationResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:requestId:CreateInfrastructureConfigurationResponse', createInfrastructureConfigurationResponse_requestId - The request ID that uniquely identifies this request.

$sel:infrastructureConfigurationArn:CreateInfrastructureConfigurationResponse', createInfrastructureConfigurationResponse_infrastructureConfigurationArn - The Amazon Resource Name (ARN) of the infrastructure configuration that was created by this request.

$sel:clientToken:CreateInfrastructureConfiguration', createInfrastructureConfigurationResponse_clientToken - The idempotency token used to make this request idempotent.

$sel:httpStatus:CreateInfrastructureConfigurationResponse', createInfrastructureConfigurationResponse_httpStatus - The response's http status code.

Response Lenses

createInfrastructureConfigurationResponse_infrastructureConfigurationArn :: Lens' CreateInfrastructureConfigurationResponse (Maybe Text) Source #

The Amazon Resource Name (ARN) of the infrastructure configuration that was created by this request.