Skip to content

/AWS1/CL_EC2=>MODIFYINSTANCEMETDEFAULTS()

About ModifyInstanceMetadataDefaults

Modifies the default instance metadata service (IMDS) settings at the account level in the specified Amazon Web Services
 Region.

To remove a parameter's account-level default setting, specify no-preference. If an account-level setting is cleared with no-preference, then the instance launch considers the other instance metadata settings. For more information, see Order of precedence for instance metadata options in the Amazon EC2 User Guide.

Method Signature

IMPORTING

Optional arguments:

IV_HTTPTOKENS TYPE /AWS1/EC2METDEFHTTPTOKENSSTATE /AWS1/EC2METDEFHTTPTOKENSSTATE

Indicates whether IMDSv2 is required.

  • optional – IMDSv2 is optional, which means that you can use either IMDSv2 or IMDSv1.

  • required – IMDSv2 is required, which means that IMDSv1 is disabled, and you must use IMDSv2.

IV_HTTPPUTRESPONSEHOPLIMIT TYPE /AWS1/EC2BOXEDINTEGER /AWS1/EC2BOXEDINTEGER

The maximum number of hops that the metadata token can travel. To indicate no preference, specify -1.

Possible values: Integers from 1 to 64, and -1 to indicate no preference

IV_HTTPENDPOINT TYPE /AWS1/EC2DEFINSTMETENDPTSTATE /AWS1/EC2DEFINSTMETENDPTSTATE

Enables or disables the IMDS endpoint on an instance. When disabled, the instance metadata can't be accessed.

IV_INSTANCEMETADATATAGS TYPE /AWS1/EC2DEFINSTMETTAGSSTATE /AWS1/EC2DEFINSTMETTAGSSTATE

Enables or disables access to an instance's tags from the instance metadata. For more information, see Work with instance tags using the instance metadata in the Amazon EC2 User Guide.

IV_DRYRUN TYPE /AWS1/EC2BOOLEAN /AWS1/EC2BOOLEAN

Checks whether you have the required permissions for the operation, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

RETURNING

OO_OUTPUT TYPE REF TO /AWS1/CL_EC2MODINSTMETDEFSRS /AWS1/CL_EC2MODINSTMETDEFSRS