Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can click “Customize cookies” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To continue without accepting these cookies, click “Continue without accepting.” To make more detailed choices or learn more, click “Customize cookies.”

Skip to content

/AWS1/CL_ASCINSTANCEMETOPTIONS

The metadata options for the instances. For more information, see Configure the instance metadata options in the Amazon EC2 Auto Scaling User Guide.

CONSTRUCTOR

IMPORTING

Optional arguments:

IV_HTTPTOKENS TYPE /AWS1/ASCINSTMETHTTPTOKSSTATE /AWS1/ASCINSTMETHTTPTOKSSTATE

The state of token usage for your instance metadata requests. If the parameter is not specified in the request, the default state is optional.

If the state is optional, you can choose to retrieve instance metadata with or without a signed token header on your request. If you retrieve the IAM role credentials without a token, the version 1.0 role credentials are returned. If you retrieve the IAM role credentials using a valid signed token, the version 2.0 role credentials are returned.

If the state is required, you must send a signed token header with any instance metadata retrieval requests. In this state, retrieving the IAM role credentials always returns the version 2.0 credentials; the version 1.0 credentials are not available.

IV_HTTPPUTRESPONSEHOPLIMIT TYPE /AWS1/ASCINSTMETHTTPPUTRSPHO00 /AWS1/ASCINSTMETHTTPPUTRSPHO00

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

Default: 1

IV_HTTPENDPOINT TYPE /AWS1/ASCINSTANCEMETENDPTSTATE /AWS1/ASCINSTANCEMETENDPTSTATE

This parameter 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.

Queryable Attributes

HttpTokens

The state of token usage for your instance metadata requests. If the parameter is not specified in the request, the default state is optional.

If the state is optional, you can choose to retrieve instance metadata with or without a signed token header on your request. If you retrieve the IAM role credentials without a token, the version 1.0 role credentials are returned. If you retrieve the IAM role credentials using a valid signed token, the version 2.0 role credentials are returned.

If the state is required, you must send a signed token header with any instance metadata retrieval requests. In this state, retrieving the IAM role credentials always returns the version 2.0 credentials; the version 1.0 credentials are not available.

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

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

This parameter 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