Class InstanceMetadataOptionsRequest
- java.lang.Object
-
- software.amazon.awssdk.services.ec2.model.InstanceMetadataOptionsRequest
-
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<InstanceMetadataOptionsRequest.Builder,InstanceMetadataOptionsRequest>
@Generated("software.amazon.awssdk:codegen") public final class InstanceMetadataOptionsRequest extends Object implements SdkPojo, Serializable, ToCopyableBuilder<InstanceMetadataOptionsRequest.Builder,InstanceMetadataOptionsRequest>
The metadata options for the instance.
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceInstanceMetadataOptionsRequest.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static InstanceMetadataOptionsRequest.Builderbuilder()booleanequals(Object obj)booleanequalsBySdkFields(Object obj)<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)inthashCode()InstanceMetadataEndpointStatehttpEndpoint()Enables or disables the HTTP metadata endpoint on your instances.StringhttpEndpointAsString()Enables or disables the HTTP metadata endpoint on your instances.InstanceMetadataProtocolStatehttpProtocolIpv6()Enables or disables the IPv6 endpoint for the instance metadata service.StringhttpProtocolIpv6AsString()Enables or disables the IPv6 endpoint for the instance metadata service.IntegerhttpPutResponseHopLimit()The maximum number of hops that the metadata token can travel.HttpTokensStatehttpTokens()Indicates whether IMDSv2 is required.StringhttpTokensAsString()Indicates whether IMDSv2 is required.InstanceMetadataTagsStateinstanceMetadataTags()Set toenabledto allow access to instance tags from the instance metadata.StringinstanceMetadataTagsAsString()Set toenabledto allow access to instance tags from the instance metadata.List<SdkField<?>>sdkFields()static Class<? extends InstanceMetadataOptionsRequest.Builder>serializableBuilderClass()InstanceMetadataOptionsRequest.BuildertoBuilder()StringtoString()Returns a string representation of this object.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
httpTokens
public final HttpTokensState httpTokens()
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.
Default:
-
If the value of
ImdsSupportfor the Amazon Machine Image (AMI) for your instance isv2.0and the account level default is set tono-preference, the default isrequired. -
If the value of
ImdsSupportfor the Amazon Machine Image (AMI) for your instance isv2.0, but the account level default is set toV1 or V2, the default isoptional.
The default value can also be affected by other combinations of parameters. For more information, see Order of precedence for instance metadata options in the Amazon EC2 User Guide.
If the service returns an enum value that is not available in the current SDK version,
httpTokenswill returnHttpTokensState.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromhttpTokensAsString().- Returns:
- 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.
Default:
-
If the value of
ImdsSupportfor the Amazon Machine Image (AMI) for your instance isv2.0and the account level default is set tono-preference, the default isrequired. -
If the value of
ImdsSupportfor the Amazon Machine Image (AMI) for your instance isv2.0, but the account level default is set toV1 or V2, the default isoptional.
The default value can also be affected by other combinations of parameters. For more information, see Order of precedence for instance metadata options in the Amazon EC2 User Guide.
-
- See Also:
HttpTokensState
-
-
httpTokensAsString
public final String httpTokensAsString()
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.
Default:
-
If the value of
ImdsSupportfor the Amazon Machine Image (AMI) for your instance isv2.0and the account level default is set tono-preference, the default isrequired. -
If the value of
ImdsSupportfor the Amazon Machine Image (AMI) for your instance isv2.0, but the account level default is set toV1 or V2, the default isoptional.
The default value can also be affected by other combinations of parameters. For more information, see Order of precedence for instance metadata options in the Amazon EC2 User Guide.
If the service returns an enum value that is not available in the current SDK version,
httpTokenswill returnHttpTokensState.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromhttpTokensAsString().- Returns:
- 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.
Default:
-
If the value of
ImdsSupportfor the Amazon Machine Image (AMI) for your instance isv2.0and the account level default is set tono-preference, the default isrequired. -
If the value of
ImdsSupportfor the Amazon Machine Image (AMI) for your instance isv2.0, but the account level default is set toV1 or V2, the default isoptional.
The default value can also be affected by other combinations of parameters. For more information, see Order of precedence for instance metadata options in the Amazon EC2 User Guide.
-
- See Also:
HttpTokensState
-
-
httpPutResponseHopLimit
public final Integer httpPutResponseHopLimit()
The maximum number of hops that the metadata token can travel.
Possible values: Integers from 1 to 64
- Returns:
- The maximum number of hops that the metadata token can travel.
Possible values: Integers from 1 to 64
-
httpEndpoint
public final InstanceMetadataEndpointState httpEndpoint()
Enables or disables the HTTP metadata endpoint on your instances.
If you specify a value of
disabled, you cannot access your instance metadata.Default:
enabledIf the service returns an enum value that is not available in the current SDK version,
httpEndpointwill returnInstanceMetadataEndpointState.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromhttpEndpointAsString().- Returns:
- Enables or disables the HTTP metadata endpoint on your instances.
If you specify a value of
disabled, you cannot access your instance metadata.Default:
enabled - See Also:
InstanceMetadataEndpointState
-
httpEndpointAsString
public final String httpEndpointAsString()
Enables or disables the HTTP metadata endpoint on your instances.
If you specify a value of
disabled, you cannot access your instance metadata.Default:
enabledIf the service returns an enum value that is not available in the current SDK version,
httpEndpointwill returnInstanceMetadataEndpointState.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromhttpEndpointAsString().- Returns:
- Enables or disables the HTTP metadata endpoint on your instances.
If you specify a value of
disabled, you cannot access your instance metadata.Default:
enabled - See Also:
InstanceMetadataEndpointState
-
httpProtocolIpv6
public final InstanceMetadataProtocolState httpProtocolIpv6()
Enables or disables the IPv6 endpoint for the instance metadata service.
Default:
disabledIf the service returns an enum value that is not available in the current SDK version,
httpProtocolIpv6will returnInstanceMetadataProtocolState.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromhttpProtocolIpv6AsString().- Returns:
- Enables or disables the IPv6 endpoint for the instance metadata service.
Default:
disabled - See Also:
InstanceMetadataProtocolState
-
httpProtocolIpv6AsString
public final String httpProtocolIpv6AsString()
Enables or disables the IPv6 endpoint for the instance metadata service.
Default:
disabledIf the service returns an enum value that is not available in the current SDK version,
httpProtocolIpv6will returnInstanceMetadataProtocolState.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromhttpProtocolIpv6AsString().- Returns:
- Enables or disables the IPv6 endpoint for the instance metadata service.
Default:
disabled - See Also:
InstanceMetadataProtocolState
-
instanceMetadataTags
public final InstanceMetadataTagsState instanceMetadataTags()
Set to
enabledto allow access to instance tags from the instance metadata. Set todisabledto turn off access to instance tags from the instance metadata. For more information, see Work with instance tags using the instance metadata.Default:
disabledIf the service returns an enum value that is not available in the current SDK version,
instanceMetadataTagswill returnInstanceMetadataTagsState.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available frominstanceMetadataTagsAsString().- Returns:
- Set to
enabledto allow access to instance tags from the instance metadata. Set todisabledto turn off access to instance tags from the instance metadata. For more information, see Work with instance tags using the instance metadata.Default:
disabled - See Also:
InstanceMetadataTagsState
-
instanceMetadataTagsAsString
public final String instanceMetadataTagsAsString()
Set to
enabledto allow access to instance tags from the instance metadata. Set todisabledto turn off access to instance tags from the instance metadata. For more information, see Work with instance tags using the instance metadata.Default:
disabledIf the service returns an enum value that is not available in the current SDK version,
instanceMetadataTagswill returnInstanceMetadataTagsState.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available frominstanceMetadataTagsAsString().- Returns:
- Set to
enabledto allow access to instance tags from the instance metadata. Set todisabledto turn off access to instance tags from the instance metadata. For more information, see Work with instance tags using the instance metadata.Default:
disabled - See Also:
InstanceMetadataTagsState
-
toBuilder
public InstanceMetadataOptionsRequest.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<InstanceMetadataOptionsRequest.Builder,InstanceMetadataOptionsRequest>
-
builder
public static InstanceMetadataOptionsRequest.Builder builder()
-
serializableBuilderClass
public static Class<? extends InstanceMetadataOptionsRequest.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
toString
public final String toString()
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
-
-