# InstanceMetadataOptions
<a name="API_InstanceMetadataOptions"></a>

The metadata options for the instances. For more information, see [Configure the instance metadata options](https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-launch-config.html#launch-configurations-imds) in the *Amazon EC2 Auto Scaling User Guide*.

## Contents
<a name="API_InstanceMetadataOptions_Contents"></a>

 ** 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. 
Type: String  
Valid Values: `disabled | enabled`   
Required: No

 ** 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  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 64.  
Required: No

 ** 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.  
Type: String  
Valid Values: `optional | required`   
Required: No

## See Also
<a name="API_InstanceMetadataOptions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/autoscaling-2011-01-01/InstanceMetadataOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/autoscaling-2011-01-01/InstanceMetadataOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/autoscaling-2011-01-01/InstanceMetadataOptions)