:doc:`Instance <index>` / Attribute / metadata_options

****************
metadata_options
****************



.. py:attribute:: EC2.Instance.metadata_options

  

  - *(dict) --* 

    The metadata options for the instance.

    
    

    - **State** *(string) --* 

      The state of the metadata option changes.

       

      ``pending`` - The metadata options are being updated and the instance is not ready to process metadata traffic with the new selection.

       

      ``applied`` - The metadata options have been successfully applied on the instance.

      
    

    - **HttpTokens** *(string) --* 

      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.
      

      
    

    - **HttpPutResponseHopLimit** *(integer) --* 

      The maximum number of hops that the metadata token can travel.

       

      Possible values: Integers from ``1`` to ``64``

      
    

    - **HttpEndpoint** *(string) --* 

      Indicates whether the HTTP metadata endpoint on your instances is enabled or disabled.

       

      If the value is ``disabled``, you cannot access your instance metadata.

      
    

    - **HttpProtocolIpv6** *(string) --* 

      Indicates whether the IPv6 endpoint for the instance metadata service is enabled or disabled.

       

      Default: ``disabled``

      
    

    - **InstanceMetadataTags** *(string) --* 

      Indicates whether access to instance tags from the instance metadata is enabled or disabled. For more information, see `View tags for your EC2 instances using instance metadata <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/work-with-tags-in-IMDS.html>`__.

      
