Instance / Attribute / metadata_options

metadata_options#

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

    • HttpPutResponseHopLimit (integer) –

      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

    • 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 Work with instance tags using the instance metadata.