Skip to content

Detach Network Interface

ec2_detach_network_interface R Documentation

Detaches a network interface from an instance

Description

Detaches a network interface from an instance.

Usage

ec2_detach_network_interface(AttachmentId, DryRun, Force)

Arguments

AttachmentId

[required] The ID of the attachment.

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.

Force

Specifies whether to force a detachment.

  • Use the Force parameter only as a last resort to detach a network interface from a failed instance.

  • If you use the Force parameter to detach a network interface, you might not be able to attach a different network interface to the same index on the instance without first stopping and starting the instance.

  • If you force the detachment of a network interface, the instance metadata might not get updated. This means that the attributes associated with the detached network interface might still be visible. The instance metadata will get updated when you stop and start the instance.

Value

An empty list.

Request syntax

svc$detach_network_interface(
  AttachmentId = "string",
  DryRun = TRUE|FALSE,
  Force = TRUE|FALSE
)

Examples

## Not run: 
# This example detaches the specified network interface from its attached
# instance.
svc$detach_network_interface(
  AttachmentId = "eni-attach-66c4350a"
)

## End(Not run)