amazonka-ec2-2.0: Amazon Elastic Compute Cloud SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.EC2.CreateIpam

Description

Create an IPAM. Amazon VPC IP Address Manager (IPAM) is a VPC feature that you can use to automate your IP address management workflows including assigning, tracking, troubleshooting, and auditing IP addresses across Amazon Web Services Regions and accounts throughout your Amazon Web Services Organization.

For more information, see Create an IPAM in the Amazon VPC IPAM User Guide.

Synopsis

Creating a Request

data CreateIpam Source #

See: newCreateIpam smart constructor.

Constructors

CreateIpam' 

Fields

  • clientToken :: Maybe Text

    A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency.

  • description :: Maybe Text

    A description for the IPAM.

  • dryRun :: Maybe Bool

    A check for whether you have the required permissions for the action without actually making the request and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

  • operatingRegions :: Maybe [AddIpamOperatingRegion]

    The operating Regions for the IPAM. Operating Regions are Amazon Web Services Regions where the IPAM is allowed to manage IP address CIDRs. IPAM only discovers and monitors resources in the Amazon Web Services Regions you select as operating Regions.

    For more information about operating Regions, see Create an IPAM in the Amazon VPC IPAM User Guide.

  • tagSpecifications :: Maybe [TagSpecification]

    The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

Instances

Instances details
ToHeaders CreateIpam Source # 
Instance details

Defined in Amazonka.EC2.CreateIpam

Methods

toHeaders :: CreateIpam -> [Header] #

ToPath CreateIpam Source # 
Instance details

Defined in Amazonka.EC2.CreateIpam

ToQuery CreateIpam Source # 
Instance details

Defined in Amazonka.EC2.CreateIpam

AWSRequest CreateIpam Source # 
Instance details

Defined in Amazonka.EC2.CreateIpam

Associated Types

type AWSResponse CreateIpam #

Generic CreateIpam Source # 
Instance details

Defined in Amazonka.EC2.CreateIpam

Associated Types

type Rep CreateIpam :: Type -> Type #

Read CreateIpam Source # 
Instance details

Defined in Amazonka.EC2.CreateIpam

Show CreateIpam Source # 
Instance details

Defined in Amazonka.EC2.CreateIpam

NFData CreateIpam Source # 
Instance details

Defined in Amazonka.EC2.CreateIpam

Methods

rnf :: CreateIpam -> () #

Eq CreateIpam Source # 
Instance details

Defined in Amazonka.EC2.CreateIpam

Hashable CreateIpam Source # 
Instance details

Defined in Amazonka.EC2.CreateIpam

type AWSResponse CreateIpam Source # 
Instance details

Defined in Amazonka.EC2.CreateIpam

type Rep CreateIpam Source # 
Instance details

Defined in Amazonka.EC2.CreateIpam

type Rep CreateIpam = D1 ('MetaData "CreateIpam" "Amazonka.EC2.CreateIpam" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "CreateIpam'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "clientToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "description") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "dryRun") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: (S1 ('MetaSel ('Just "operatingRegions") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [AddIpamOperatingRegion])) :*: S1 ('MetaSel ('Just "tagSpecifications") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [TagSpecification]))))))

newCreateIpam :: CreateIpam Source #

Create a value of CreateIpam 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:

CreateIpam, createIpam_clientToken - A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency.

CreateIpam, createIpam_description - A description for the IPAM.

$sel:dryRun:CreateIpam', createIpam_dryRun - A check for whether you have the required permissions for the action without actually making the request and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

CreateIpam, createIpam_operatingRegions - The operating Regions for the IPAM. Operating Regions are Amazon Web Services Regions where the IPAM is allowed to manage IP address CIDRs. IPAM only discovers and monitors resources in the Amazon Web Services Regions you select as operating Regions.

For more information about operating Regions, see Create an IPAM in the Amazon VPC IPAM User Guide.

CreateIpam, createIpam_tagSpecifications - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

Request Lenses

createIpam_clientToken :: Lens' CreateIpam (Maybe Text) Source #

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency.

createIpam_description :: Lens' CreateIpam (Maybe Text) Source #

A description for the IPAM.

createIpam_dryRun :: Lens' CreateIpam (Maybe Bool) Source #

A check for whether you have the required permissions for the action without actually making the request and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

createIpam_operatingRegions :: Lens' CreateIpam (Maybe [AddIpamOperatingRegion]) Source #

The operating Regions for the IPAM. Operating Regions are Amazon Web Services Regions where the IPAM is allowed to manage IP address CIDRs. IPAM only discovers and monitors resources in the Amazon Web Services Regions you select as operating Regions.

For more information about operating Regions, see Create an IPAM in the Amazon VPC IPAM User Guide.

createIpam_tagSpecifications :: Lens' CreateIpam (Maybe [TagSpecification]) Source #

The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

Destructuring the Response

data CreateIpamResponse Source #

See: newCreateIpamResponse smart constructor.

Constructors

CreateIpamResponse' 

Fields

Instances

Instances details
Generic CreateIpamResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateIpam

Associated Types

type Rep CreateIpamResponse :: Type -> Type #

Read CreateIpamResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateIpam

Show CreateIpamResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateIpam

NFData CreateIpamResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateIpam

Methods

rnf :: CreateIpamResponse -> () #

Eq CreateIpamResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateIpam

type Rep CreateIpamResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateIpam

type Rep CreateIpamResponse = D1 ('MetaData "CreateIpamResponse" "Amazonka.EC2.CreateIpam" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "CreateIpamResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "ipam") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Ipam)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newCreateIpamResponse Source #

Create a value of CreateIpamResponse 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:ipam:CreateIpamResponse', createIpamResponse_ipam - Information about the IPAM created.

$sel:httpStatus:CreateIpamResponse', createIpamResponse_httpStatus - The response's http status code.

Response Lenses

createIpamResponse_ipam :: Lens' CreateIpamResponse (Maybe Ipam) Source #

Information about the IPAM created.