AWS::ImageBuilder::InfrastructureConfiguration InstanceMetadataOptions - AWS CloudFormation (original) (raw)

The instance metadata options that apply to the HTTP requests that pipeline builds use to launch EC2 build and test instances. For more information about instance metadata options, see Configure the instance metadata options in the Amazon EC2 User Guide for Linux instances, or Configure the instance metadata options in the Amazon EC2 Windows Guide for Windows instances.

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{
  "HttpPutResponseHopLimit" : Integer,
  "HttpTokens" : String
}

YAML

  HttpPutResponseHopLimit: Integer
  HttpTokens: String

HttpPutResponseHopLimit

Limit the number of hops that an instance metadata request can traverse to reach its destination. The default is one hop. However, if HTTP tokens are required, container image builds need a minimum of two hops.

Required: No

Type: Integer

Minimum: 1

Maximum: 64

Update requires: No interruption

HttpTokens

Indicates whether a signed token header is required for instance metadata retrieval requests. The values affect the response as follows:

• required – When you retrieve the IAM role credentials, version 2.0 credentials are returned in all cases.
• optional – You can include a signed token header in your request to retrieve instance metadata, or you can leave it out. If you include it, version 2.0 credentials are returned for the IAM role. Otherwise, version 1.0 credentials are returned.

The default setting is optional.

Required: No

Type: String

Allowed values: required | optional

Update requires: No interruption

AWS::ImageBuilder::InfrastructureConfiguration

Logging

Did this page help you? - Yes

Thanks for letting us know we're doing a good job!

If you've got a moment, please tell us what we did right so we can do more of it.

Did this page help you? - No

Thanks for letting us know this page needs work. We're sorry we let you down.

If you've got a moment, please tell us how we can make the documentation better.