Skip to content

Reset Instance Attribute

ec2_reset_instance_attribute R Documentation

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(Attribute, DryRun, InstanceId)

Arguments

Attribute

[required] The attribute to reset.

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

DryRun

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.

InstanceId

[required] The ID of the instance.

Value

An empty list.

Request syntax

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

Examples

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

## End(Not run)