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

Description

Modifies the ID format of a resource for a specified IAM user, IAM role, or the root user for an account; or all IAM users, IAM roles, and the root user for an account. 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.

For more information, see Resource IDs in the Amazon Elastic Compute Cloud User Guide.

This setting applies to the principal specified in the request; it does not apply to the principal that makes the request.

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 ModifyIdentityIdFormat Source #

See: newModifyIdentityIdFormat smart constructor.

Constructors

ModifyIdentityIdFormat' 

Fields

  • principalArn :: Text

    The ARN of the principal, which can be an IAM user, IAM role, or the root user. Specify all to modify the ID format for all IAM users, IAM roles, and the root user of the account.

  • 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

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

Instances

Instances details
ToHeaders ModifyIdentityIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdentityIdFormat

ToPath ModifyIdentityIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdentityIdFormat

ToQuery ModifyIdentityIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdentityIdFormat

AWSRequest ModifyIdentityIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdentityIdFormat

Associated Types

type AWSResponse ModifyIdentityIdFormat #

Generic ModifyIdentityIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdentityIdFormat

Associated Types

type Rep ModifyIdentityIdFormat :: Type -> Type #

Read ModifyIdentityIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdentityIdFormat

Show ModifyIdentityIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdentityIdFormat

NFData ModifyIdentityIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdentityIdFormat

Methods

rnf :: ModifyIdentityIdFormat -> () #

Eq ModifyIdentityIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdentityIdFormat

Hashable ModifyIdentityIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdentityIdFormat

type AWSResponse ModifyIdentityIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdentityIdFormat

type Rep ModifyIdentityIdFormat Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdentityIdFormat

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

newModifyIdentityIdFormat Source #

Create a value of ModifyIdentityIdFormat 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:principalArn:ModifyIdentityIdFormat', modifyIdentityIdFormat_principalArn - The ARN of the principal, which can be an IAM user, IAM role, or the root user. Specify all to modify the ID format for all IAM users, IAM roles, and the root user of the account.

ModifyIdentityIdFormat, modifyIdentityIdFormat_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.

ModifyIdentityIdFormat, modifyIdentityIdFormat_useLongIds - Indicates whether the resource should use longer IDs (17-character IDs)

Request Lenses

modifyIdentityIdFormat_principalArn :: Lens' ModifyIdentityIdFormat Text Source #

The ARN of the principal, which can be an IAM user, IAM role, or the root user. Specify all to modify the ID format for all IAM users, IAM roles, and the root user of the account.

modifyIdentityIdFormat_resource :: Lens' ModifyIdentityIdFormat 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.

modifyIdentityIdFormat_useLongIds :: Lens' ModifyIdentityIdFormat Bool Source #

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

Destructuring the Response

data ModifyIdentityIdFormatResponse Source #

See: newModifyIdentityIdFormatResponse smart constructor.

Instances

Instances details
Generic ModifyIdentityIdFormatResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdentityIdFormat

Associated Types

type Rep ModifyIdentityIdFormatResponse :: Type -> Type #

Read ModifyIdentityIdFormatResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdentityIdFormat

Show ModifyIdentityIdFormatResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdentityIdFormat

NFData ModifyIdentityIdFormatResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdentityIdFormat

Eq ModifyIdentityIdFormatResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdentityIdFormat

type Rep ModifyIdentityIdFormatResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifyIdentityIdFormat

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

newModifyIdentityIdFormatResponse :: ModifyIdentityIdFormatResponse Source #

Create a value of ModifyIdentityIdFormatResponse with all optional fields omitted.

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