Amazonka.EC2.ModifyIdFormat

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.

Creating a Request

data ModifyIdFormat

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

ToHeaders ModifyIdFormat

Defined in Amazonka.EC2.ModifyIdFormat

Methods

toHeaders :: ModifyIdFormat -> [Header]

ToPath ModifyIdFormat

Defined in Amazonka.EC2.ModifyIdFormat

Methods

toPath :: ModifyIdFormat -> ByteString

ToQuery ModifyIdFormat

Defined in Amazonka.EC2.ModifyIdFormat

Methods

toQuery :: ModifyIdFormat -> QueryString

AWSRequest ModifyIdFormat

Defined in Amazonka.EC2.ModifyIdFormat

Associated Types

type AWSResponse ModifyIdFormat

Methods

request :: (Service -> Service) -> ModifyIdFormat -> Request ModifyIdFormat

response :: MonadResource m => (ByteStringLazy -> IO ByteStringLazy) -> Service -> Proxy ModifyIdFormat -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse ModifyIdFormat)))

Generic ModifyIdFormat

Defined in Amazonka.EC2.ModifyIdFormat

Associated Types

type Rep ModifyIdFormat :: Type -> Type

Methods

from :: ModifyIdFormat -> Rep ModifyIdFormat x

to :: Rep ModifyIdFormat x -> ModifyIdFormat

Read ModifyIdFormat

Defined in Amazonka.EC2.ModifyIdFormat

Methods

readsPrec :: Int -> ReadS ModifyIdFormat

readList :: ReadS [ModifyIdFormat]

readPrec :: ReadPrec ModifyIdFormat

readListPrec :: ReadPrec [ModifyIdFormat]

Show ModifyIdFormat

Defined in Amazonka.EC2.ModifyIdFormat

Methods

showsPrec :: Int -> ModifyIdFormat -> ShowS

show :: ModifyIdFormat -> String

showList :: [ModifyIdFormat] -> ShowS

NFData ModifyIdFormat

Defined in Amazonka.EC2.ModifyIdFormat

Methods

rnf :: ModifyIdFormat -> ()

Eq ModifyIdFormat

Defined in Amazonka.EC2.ModifyIdFormat

Methods

(==) :: ModifyIdFormat -> ModifyIdFormat -> Bool

(/=) :: ModifyIdFormat -> ModifyIdFormat -> Bool

Hashable ModifyIdFormat

Defined in Amazonka.EC2.ModifyIdFormat

Methods

hashWithSalt :: Int -> ModifyIdFormat -> Int

hash :: ModifyIdFormat -> Int

type AWSResponse ModifyIdFormat

Defined in Amazonka.EC2.ModifyIdFormat

type AWSResponse ModifyIdFormat = ModifyIdFormatResponse

type Rep ModifyIdFormat

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

Arguments

:: Text

ModifyIdFormat

-> Bool

ModifyIdFormat

-> ModifyIdFormat

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

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

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

Destructuring the Response

data ModifyIdFormatResponse

See: newModifyIdFormatResponse smart constructor.

Constructors

ModifyIdFormatResponse'

Instances

Generic ModifyIdFormatResponse

Defined in Amazonka.EC2.ModifyIdFormat

Associated Types

type Rep ModifyIdFormatResponse :: Type -> Type

Methods

from :: ModifyIdFormatResponse -> Rep ModifyIdFormatResponse x

to :: Rep ModifyIdFormatResponse x -> ModifyIdFormatResponse

Read ModifyIdFormatResponse

Defined in Amazonka.EC2.ModifyIdFormat

Methods

readsPrec :: Int -> ReadS ModifyIdFormatResponse

readList :: ReadS [ModifyIdFormatResponse]

readPrec :: ReadPrec ModifyIdFormatResponse

readListPrec :: ReadPrec [ModifyIdFormatResponse]

Show ModifyIdFormatResponse

Defined in Amazonka.EC2.ModifyIdFormat

Methods

showsPrec :: Int -> ModifyIdFormatResponse -> ShowS

show :: ModifyIdFormatResponse -> String

showList :: [ModifyIdFormatResponse] -> ShowS

NFData ModifyIdFormatResponse

Defined in Amazonka.EC2.ModifyIdFormat

Methods

rnf :: ModifyIdFormatResponse -> ()

Eq ModifyIdFormatResponse

Defined in Amazonka.EC2.ModifyIdFormat

Methods

(==) :: ModifyIdFormatResponse -> ModifyIdFormatResponse -> Bool

(/=) :: ModifyIdFormatResponse -> ModifyIdFormatResponse -> Bool

type Rep ModifyIdFormatResponse

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

Create a value of ModifyIdFormatResponse with all optional fields omitted.

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