Skip to content

Resets an attribute of an instance to its default value

Description

Resets an attribute of an instance to its default value. To reset the kernel or ramdisk, the instance must be in a stopped state. To reset the sourceDestCheck, the instance can be either running or stopped.

The sourceDestCheck attribute controls whether source/destination checking is enabled. The default value is true, which means checking is enabled. This value must be false for a NAT instance to perform NAT. For more information, see NAT instances in the Amazon VPC User Guide.

Usage

ec2_reset_instance_attribute(DryRun, InstanceId, Attribute)

Arguments

  • DryRun

    Checks whether you have the required permissions for the operation, 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.

  • InstanceId

    [required] The ID of the instance.

  • Attribute

    [required] The attribute to reset.

    You can only reset the following attributes: kernel | ramdisk | sourceDestCheck.

Value

An empty list.

Request syntax

svc$reset_instance_attribute(
  DryRun = TRUE|FALSE,
  InstanceId = "string",
  Attribute = "instanceType"|"kernel"|"ramdisk"|"userData"|"disableApiTermination"|"instanceInitiatedShutdownBehavior"|"rootDeviceName"|"blockDeviceMapping"|"productCodes"|"sourceDestCheck"|"groupSet"|"ebsOptimized"|"sriovNetSupport"|"enaSupport"|"enclaveOptions"|"disableApiStop"
)

Examples

# This example resets the sourceDestCheck attribute for the specified
# instance.
svc$reset_instance_attribute(
  Attribute = "sourceDestCheck",
  InstanceId = "i-1234567890abcdef0"
)