Copyright	(c) 2013-2023 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	Safe-Inferred
Language	Haskell2010

Amazonka.AutoScaling.Types.InstanceMetadataOptions

Description

Documentation

data InstanceMetadataOptions Source #

The metadata options for the instances. For more information, see Configuring the Instance Metadata Options in the Amazon EC2 Auto Scaling User Guide.

See: newInstanceMetadataOptions smart constructor.

Constructors

InstanceMetadataOptions'

Fields

httpEndpoint :: Maybe InstanceMetadataEndpointState
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.
httpPutResponseHopLimit :: Maybe Natural
The desired HTTP PUT response hop limit for instance metadata requests. The larger the number, the further instance metadata requests can travel.
Default: 1
httpTokens :: Maybe InstanceMetadataHttpTokensState
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.

Instances

Instances details

ToQuery InstanceMetadataOptions Source #
Instance details Defined in Amazonka.AutoScaling.Types.InstanceMetadataOptions Methods toQuery :: InstanceMetadataOptions -> QueryString #
FromXML InstanceMetadataOptions Source #
Instance details Defined in Amazonka.AutoScaling.Types.InstanceMetadataOptions Methods parseXML :: [Node] -> Either String InstanceMetadataOptions #
Generic InstanceMetadataOptions Source #
Instance details Defined in Amazonka.AutoScaling.Types.InstanceMetadataOptions Associated Types type Rep InstanceMetadataOptions :: Type -> Type # Methods from :: InstanceMetadataOptions -> Rep InstanceMetadataOptions x # to :: Rep InstanceMetadataOptions x -> InstanceMetadataOptions #
Read InstanceMetadataOptions Source #
Instance details Defined in Amazonka.AutoScaling.Types.InstanceMetadataOptions Methods readsPrec :: Int -> ReadS InstanceMetadataOptions # readList :: ReadS [InstanceMetadataOptions] # readPrec :: ReadPrec InstanceMetadataOptions # readListPrec :: ReadPrec [InstanceMetadataOptions] #
Show InstanceMetadataOptions Source #
Instance details Defined in Amazonka.AutoScaling.Types.InstanceMetadataOptions Methods showsPrec :: Int -> InstanceMetadataOptions -> ShowS # show :: InstanceMetadataOptions -> String # showList :: [InstanceMetadataOptions] -> ShowS #
NFData InstanceMetadataOptions Source #
Instance details Defined in Amazonka.AutoScaling.Types.InstanceMetadataOptions Methods rnf :: InstanceMetadataOptions -> () #
Eq InstanceMetadataOptions Source #
Instance details Defined in Amazonka.AutoScaling.Types.InstanceMetadataOptions Methods (==) :: InstanceMetadataOptions -> InstanceMetadataOptions -> Bool # (/=) :: InstanceMetadataOptions -> InstanceMetadataOptions -> Bool #
Hashable InstanceMetadataOptions Source #
Instance details Defined in Amazonka.AutoScaling.Types.InstanceMetadataOptions Methods hashWithSalt :: Int -> InstanceMetadataOptions -> Int # hash :: InstanceMetadataOptions -> Int #
type Rep InstanceMetadataOptions Source #
Instance details Defined in Amazonka.AutoScaling.Types.InstanceMetadataOptions type Rep InstanceMetadataOptions = D1 ('MetaData "InstanceMetadataOptions" "Amazonka.AutoScaling.Types.InstanceMetadataOptions" "amazonka-autoscaling-2.0-IerpHfP4BA3Ir4ZL2IR1De" 'False) (C1 ('MetaCons "InstanceMetadataOptions'" 'PrefixI 'True) (S1 ('MetaSel ('Just "httpEndpoint") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe InstanceMetadataEndpointState)) :: (S1 ('MetaSel ('Just "httpPutResponseHopLimit") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :: S1 ('MetaSel ('Just "httpTokens") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe InstanceMetadataHttpTokensState)))))

newInstanceMetadataOptions :: InstanceMetadataOptions Source #

Create a value of InstanceMetadataOptions with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:httpEndpoint:InstanceMetadataOptions', instanceMetadataOptions_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.

$sel:httpPutResponseHopLimit:InstanceMetadataOptions', instanceMetadataOptions_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

$sel:httpTokens:InstanceMetadataOptions', instanceMetadataOptions_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.

instanceMetadataOptions_httpEndpoint :: Lens' InstanceMetadataOptions (Maybe InstanceMetadataEndpointState) Source #

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.

instanceMetadataOptions_httpPutResponseHopLimit :: Lens' InstanceMetadataOptions (Maybe Natural) Source #

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

Default: 1

instanceMetadataOptions_httpTokens :: Lens' InstanceMetadataOptions (Maybe InstanceMetadataHttpTokensState) Source #

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.