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.CreateIpamScope

Description

Create an IPAM scope. In IPAM, a scope is the highest-level container within IPAM. An IPAM contains two default scopes. Each scope represents the IP space for a single network. The private scope is intended for all private IP address space. The public scope is intended for all public IP address space. Scopes enable you to reuse IP addresses across multiple unconnected networks without causing IP address overlap or conflict.

For more information, see Add a scope in the Amazon VPC IPAM User Guide.

Synopsis

Creating a Request

data CreateIpamScope Source #

See: newCreateIpamScope smart constructor.

Constructors

CreateIpamScope' 

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 scope you're creating.

  • 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.

  • 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.

  • ipamId :: Text

    The ID of the IPAM for which you're creating this scope.

Instances

Instances details
ToHeaders CreateIpamScope Source # 
Instance details

Defined in Amazonka.EC2.CreateIpamScope

ToPath CreateIpamScope Source # 
Instance details

Defined in Amazonka.EC2.CreateIpamScope

ToQuery CreateIpamScope Source # 
Instance details

Defined in Amazonka.EC2.CreateIpamScope

AWSRequest CreateIpamScope Source # 
Instance details

Defined in Amazonka.EC2.CreateIpamScope

Associated Types

type AWSResponse CreateIpamScope #

Generic CreateIpamScope Source # 
Instance details

Defined in Amazonka.EC2.CreateIpamScope

Associated Types

type Rep CreateIpamScope :: Type -> Type #

Read CreateIpamScope Source # 
Instance details

Defined in Amazonka.EC2.CreateIpamScope

Show CreateIpamScope Source # 
Instance details

Defined in Amazonka.EC2.CreateIpamScope

NFData CreateIpamScope Source # 
Instance details

Defined in Amazonka.EC2.CreateIpamScope

Methods

rnf :: CreateIpamScope -> () #

Eq CreateIpamScope Source # 
Instance details

Defined in Amazonka.EC2.CreateIpamScope

Hashable CreateIpamScope Source # 
Instance details

Defined in Amazonka.EC2.CreateIpamScope

type AWSResponse CreateIpamScope Source # 
Instance details

Defined in Amazonka.EC2.CreateIpamScope

type Rep CreateIpamScope Source # 
Instance details

Defined in Amazonka.EC2.CreateIpamScope

type Rep CreateIpamScope = D1 ('MetaData "CreateIpamScope" "Amazonka.EC2.CreateIpamScope" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "CreateIpamScope'" '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 "tagSpecifications") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [TagSpecification])) :*: S1 ('MetaSel ('Just "ipamId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))))

newCreateIpamScope Source #

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

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

CreateIpamScope, createIpamScope_description - A description for the scope you're creating.

$sel:dryRun:CreateIpamScope', createIpamScope_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.

CreateIpamScope, createIpamScope_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.

CreateIpamScope, createIpamScope_ipamId - The ID of the IPAM for which you're creating this scope.

Request Lenses

createIpamScope_clientToken :: Lens' CreateIpamScope (Maybe Text) Source #

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

createIpamScope_description :: Lens' CreateIpamScope (Maybe Text) Source #

A description for the scope you're creating.

createIpamScope_dryRun :: Lens' CreateIpamScope (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.

createIpamScope_tagSpecifications :: Lens' CreateIpamScope (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.

createIpamScope_ipamId :: Lens' CreateIpamScope Text Source #

The ID of the IPAM for which you're creating this scope.

Destructuring the Response

data CreateIpamScopeResponse Source #

See: newCreateIpamScopeResponse smart constructor.

Constructors

CreateIpamScopeResponse' 

Fields

Instances

Instances details
Generic CreateIpamScopeResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateIpamScope

Associated Types

type Rep CreateIpamScopeResponse :: Type -> Type #

Read CreateIpamScopeResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateIpamScope

Show CreateIpamScopeResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateIpamScope

NFData CreateIpamScopeResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateIpamScope

Methods

rnf :: CreateIpamScopeResponse -> () #

Eq CreateIpamScopeResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateIpamScope

type Rep CreateIpamScopeResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateIpamScope

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

newCreateIpamScopeResponse Source #

Create a value of CreateIpamScopeResponse 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:ipamScope:CreateIpamScopeResponse', createIpamScopeResponse_ipamScope - Information about the created scope.

$sel:httpStatus:CreateIpamScopeResponse', createIpamScopeResponse_httpStatus - The response's http status code.

Response Lenses