NAME

Paws::EC2::ModifyInstanceMetadataOptions - Arguments for method ModifyInstanceMetadataOptions on Paws::EC2

DESCRIPTION

This class represents the parameters used for calling the method ModifyInstanceMetadataOptions on the Amazon Elastic Compute Cloud service. Use the attributes of this class as arguments to method ModifyInstanceMetadataOptions.

You shouldn't make instances of this class. Each attribute should be used as a named argument in the call to ModifyInstanceMetadataOptions.

SYNOPSIS

    my $ec2 = Paws->service('EC2');
    my $ModifyInstanceMetadataOptionsResult =
      $ec2->ModifyInstanceMetadataOptions(
      InstanceId              => 'MyInstanceId',
      DryRun                  => 1,                # OPTIONAL
      HttpEndpoint            => 'disabled',       # OPTIONAL
      HttpPutResponseHopLimit => 1,                # OPTIONAL
      HttpTokens              => 'optional',       # OPTIONAL
      );
    # Results:
    my $InstanceId = $ModifyInstanceMetadataOptionsResult->InstanceId;
    my $InstanceMetadataOptions =
      $ModifyInstanceMetadataOptionsResult->InstanceMetadataOptions;
    # Returns a L<Paws::EC2::ModifyInstanceMetadataOptionsResult> object.

Values for attributes that are native types (Int, String, Float, etc) can passed as-is (scalar values). Values for complex Types (objects) can be passed as a HashRef. The keys and values of the hashref will be used to instance the underlying object. For the AWS API documentation, see <https://docs.aws.amazon.com/goto/WebAPI/ec2/ModifyInstanceMetadataOptions>

ATTRIBUTES

DryRun => Bool

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is "DryRunOperation". Otherwise, it is "UnauthorizedOperation".

HttpEndpoint => Str

This parameter enables or disables the HTTP metadata endpoint on your instances. If the parameter is not specified, the existing state is maintained.

If you specify a value of "disabled", you will not be able to access your instance metadata.

Valid values are: "disabled", "enabled"

HttpPutResponseHopLimit => Int

The desired HTTP PUT response hop limit for instance metadata requests. The larger the number, the further instance metadata requests can travel. If no parameter is specified, the existing state is maintained.

Possible values: Integers from 1 to 64

HttpTokens => Str

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 credential always returns the version 2.0 credentials; the version 1.0 credentials are not available.

Valid values are: "optional", "required"

REQUIRED InstanceId => Str

The ID of the instance.

BUGS and CONTRIBUTIONS

The source code is located here: <https://github.com/pplu/aws-sdk-perl>

Please report bugs to: <https://github.com/pplu/aws-sdk-perl/issues>