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

Description

Modifies the ID format for the specified resource on a per-Region basis. You can specify that resources should receive longer IDs (17-character IDs) when they are created.

This request can only be used to modify longer ID settings for resource types that are within the opt-in period. Resources currently in their opt-in period include: bundle | conversion-task | customer-gateway | dhcp-options | elastic-ip-allocation | elastic-ip-association | export-task | flow-log | image | import-task | internet-gateway | network-acl | network-acl-association | network-interface | network-interface-attachment | prefix-list | route-table | route-table-association | security-group | subnet | subnet-cidr-block-association | vpc | vpc-cidr-block-association | vpc-endpoint | vpc-peering-connection | vpn-connection | vpn-gateway.

This setting applies to the IAM user who makes the request; it does not apply to the entire Amazon Web Services account. By default, an IAM user defaults to the same settings as the root user. If you're using this action as the root user, then these settings apply to the entire account, unless an IAM user explicitly overrides these settings for themselves. For more information, see Resource IDs in the Amazon Elastic Compute Cloud User Guide.

Resources created with longer IDs are visible to all IAM roles and users, regardless of these settings and provided that they have permission to use the relevant Describe command for the resource type.

Synopsis

Creating a Request

data ModifyIdFormat Source #

See: newModifyIdFormat smart constructor.

Constructors

ModifyIdFormat' 

Fields

  • resource :: Text

    The type of resource: bundle | conversion-task | customer-gateway | dhcp-options | elastic-ip-allocation | elastic-ip-association | export-task | flow-log | image | import-task | internet-gateway | network-acl | network-acl-association | network-interface | network-interface-attachment | prefix-list | route-table | route-table-association | security-group | subnet | subnet-cidr-block-association | vpc | vpc-cidr-block-association | vpc-endpoint | vpc-peering-connection | vpn-connection | vpn-gateway.

    Alternatively, use the all-current option to include all resource types that are currently within their opt-in period for longer IDs.

  • useLongIds :: Bool

    Indicate whether the resource should use longer IDs (17-character IDs).

Instances

Instances details
ToHeaders ModifyIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdFormat

ToPath ModifyIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdFormat

ToQuery ModifyIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdFormat

AWSRequest ModifyIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdFormat

Associated Types

type AWSResponse ModifyIdFormat #

Generic ModifyIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdFormat

Associated Types

type Rep ModifyIdFormat :: Type -> Type #

Read ModifyIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdFormat

Show ModifyIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdFormat

NFData ModifyIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdFormat

Methods

rnf :: ModifyIdFormat -> () #

Eq ModifyIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdFormat

Hashable ModifyIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdFormat

type AWSResponse ModifyIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdFormat

type Rep ModifyIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdFormat

type Rep ModifyIdFormat = D1 ('MetaData "ModifyIdFormat" "Amazonka.EC2.ModifyIdFormat" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "ModifyIdFormat'" 'PrefixI 'True) (S1 ('MetaSel ('Just "resource") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "useLongIds") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Bool)))

newModifyIdFormat Source #

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

ModifyIdFormat, modifyIdFormat_resource - The type of resource: bundle | conversion-task | customer-gateway | dhcp-options | elastic-ip-allocation | elastic-ip-association | export-task | flow-log | image | import-task | internet-gateway | network-acl | network-acl-association | network-interface | network-interface-attachment | prefix-list | route-table | route-table-association | security-group | subnet | subnet-cidr-block-association | vpc | vpc-cidr-block-association | vpc-endpoint | vpc-peering-connection | vpn-connection | vpn-gateway.

Alternatively, use the all-current option to include all resource types that are currently within their opt-in period for longer IDs.

ModifyIdFormat, modifyIdFormat_useLongIds - Indicate whether the resource should use longer IDs (17-character IDs).

Request Lenses

modifyIdFormat_resource :: Lens' ModifyIdFormat Text Source #

The type of resource: bundle | conversion-task | customer-gateway | dhcp-options | elastic-ip-allocation | elastic-ip-association | export-task | flow-log | image | import-task | internet-gateway | network-acl | network-acl-association | network-interface | network-interface-attachment | prefix-list | route-table | route-table-association | security-group | subnet | subnet-cidr-block-association | vpc | vpc-cidr-block-association | vpc-endpoint | vpc-peering-connection | vpn-connection | vpn-gateway.

Alternatively, use the all-current option to include all resource types that are currently within their opt-in period for longer IDs.

modifyIdFormat_useLongIds :: Lens' ModifyIdFormat Bool Source #

Indicate whether the resource should use longer IDs (17-character IDs).

Destructuring the Response

data ModifyIdFormatResponse Source #

See: newModifyIdFormatResponse smart constructor.

Instances

Instances details
Generic ModifyIdFormatResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdFormat

Associated Types

type Rep ModifyIdFormatResponse :: Type -> Type #

Read ModifyIdFormatResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdFormat

Show ModifyIdFormatResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdFormat

NFData ModifyIdFormatResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdFormat

Methods

rnf :: ModifyIdFormatResponse -> () #

Eq ModifyIdFormatResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdFormat

type Rep ModifyIdFormatResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdFormat

type Rep ModifyIdFormatResponse = D1 ('MetaData "ModifyIdFormatResponse" "Amazonka.EC2.ModifyIdFormat" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "ModifyIdFormatResponse'" 'PrefixI 'False) (U1 :: Type -> Type))

newModifyIdFormatResponse :: ModifyIdFormatResponse Source #

Create a value of ModifyIdFormatResponse with all optional fields omitted.

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