Skip to content

/AWS1/CL_EC2LAUNCHTMPLINSTME00

The metadata options for the instance. For more information, see Instance metadata and user data in the Amazon EC2 User Guide.

CONSTRUCTOR

IMPORTING

Optional arguments:

IV_HTTPTOKENS TYPE /AWS1/EC2LAUNCHTMPLHTTPTOKSS00 /AWS1/EC2LAUNCHTMPLHTTPTOKSS00

Indicates whether IMDSv2 is required.

  • optional - IMDSv2 is optional. You can choose whether to send a session token in your instance metadata retrieval requests. If you retrieve IAM role credentials without a session token, you receive the IMDSv1 role credentials. If you retrieve IAM role credentials using a valid session token, you receive the IMDSv2 role credentials.

  • required - IMDSv2 is required. You must send a session token in your instance metadata retrieval requests. With this option, retrieving the IAM role credentials always returns IMDSv2 credentials; IMDSv1 credentials are not available.

Default: If the value of ImdsSupport for the Amazon Machine Image (AMI) for your instance is v2.0, the default is required.

IV_HTTPPUTRESPONSEHOPLIMIT TYPE /AWS1/EC2INTEGER /AWS1/EC2INTEGER

The desired HTTP PUT response hop limit for instance metadata requests. The larger the number, the further instance metadata requests can travel.

Default: 1

Possible values: Integers from 1 to 64

IV_HTTPENDPOINT TYPE /AWS1/EC2LAUNCHTMPLINSTMETEN00 /AWS1/EC2LAUNCHTMPLINSTMETEN00

Enables or disables the HTTP metadata endpoint on your instances. If the parameter is not specified, the default state is enabled.

If you specify a value of disabled, you will not be able to access your instance metadata.

IV_HTTPPROTOCOLIPV6 TYPE /AWS1/EC2LAUNCHTMPLINSTMETPR00 /AWS1/EC2LAUNCHTMPLINSTMETPR00

Enables or disables the IPv6 endpoint for the instance metadata service.

Default: disabled

IV_INSTANCEMETADATATAGS TYPE /AWS1/EC2LAUNCHTMPLINSTMETTG00 /AWS1/EC2LAUNCHTMPLINSTMETTG00

Set to enabled to allow access to instance tags from the instance metadata. Set to disabled to turn off access to instance tags from the instance metadata. For more information, see Work with instance tags using the instance metadata.

Default: disabled


Queryable Attributes

HttpTokens

Indicates whether IMDSv2 is required.

  • optional - IMDSv2 is optional. You can choose whether to send a session token in your instance metadata retrieval requests. If you retrieve IAM role credentials without a session token, you receive the IMDSv1 role credentials. If you retrieve IAM role credentials using a valid session token, you receive the IMDSv2 role credentials.

  • required - IMDSv2 is required. You must send a session token in your instance metadata retrieval requests. With this option, retrieving the IAM role credentials always returns IMDSv2 credentials; IMDSv1 credentials are not available.

Default: If the value of ImdsSupport for the Amazon Machine Image (AMI) for your instance is v2.0, the default is required.

Accessible with the following methods

Method Description
GET_HTTPTOKENS() Getter for HTTPTOKENS, with configurable default
ASK_HTTPTOKENS() Getter for HTTPTOKENS w/ exceptions if field has no value
HAS_HTTPTOKENS() Determine if HTTPTOKENS has a value

HttpPutResponseHopLimit

The desired HTTP PUT response hop limit for instance metadata requests. The larger the number, the further instance metadata requests can travel.

Default: 1

Possible values: Integers from 1 to 64

Accessible with the following methods

Method Description
GET_HTTPPUTRESPONSEHOPLIMIT() Getter for HTTPPUTRESPONSEHOPLIMIT, with configurable defaul
ASK_HTTPPUTRESPONSEHOPLIMIT() Getter for HTTPPUTRESPONSEHOPLIMIT w/ exceptions if field ha
HAS_HTTPPUTRESPONSEHOPLIMIT() Determine if HTTPPUTRESPONSEHOPLIMIT has a value

HttpEndpoint

Enables or disables the HTTP metadata endpoint on your instances. If the parameter is not specified, the default state is enabled.

If you specify a value of disabled, you will not be able to access your instance metadata.

Accessible with the following methods

Method Description
GET_HTTPENDPOINT() Getter for HTTPENDPOINT, with configurable default
ASK_HTTPENDPOINT() Getter for HTTPENDPOINT w/ exceptions if field has no value
HAS_HTTPENDPOINT() Determine if HTTPENDPOINT has a value

HttpProtocolIpv6

Enables or disables the IPv6 endpoint for the instance metadata service.

Default: disabled

Accessible with the following methods

Method Description
GET_HTTPPROTOCOLIPV6() Getter for HTTPPROTOCOLIPV6, with configurable default
ASK_HTTPPROTOCOLIPV6() Getter for HTTPPROTOCOLIPV6 w/ exceptions if field has no va
HAS_HTTPPROTOCOLIPV6() Determine if HTTPPROTOCOLIPV6 has a value

InstanceMetadataTags

Set to enabled to allow access to instance tags from the instance metadata. Set to disabled to turn off access to instance tags from the instance metadata. For more information, see Work with instance tags using the instance metadata.

Default: disabled

Accessible with the following methods

Method Description
GET_INSTANCEMETADATATAGS() Getter for INSTANCEMETADATATAGS, with configurable default
ASK_INSTANCEMETADATATAGS() Getter for INSTANCEMETADATATAGS w/ exceptions if field has n
HAS_INSTANCEMETADATATAGS() Determine if INSTANCEMETADATATAGS has a value