ec2_modify_network_interface_attribute {aws.ecx}

Modify Network Interface Attribute

Description

Modifies the specified network interface attribute. You can specify only one attribute at a time. You can use this action to attach and detach security groups from an existing EC2 instance.

Usage

ec2_modify_network_interface_attribute(
  NetworkInterfaceId,
  Attachment = NULL,
  Description = NULL,
  DryRun = NULL,
  SecurityGroupId = NULL,
  SourceDestCheck = NULL,
  simplify = TRUE,
  others = list(),
  print_on_error = aws_get_print_on_error(),
  retry_time = aws_get_retry_time(),
  network_timeout = aws_get_network_timeout(),
  region = aws_get_region()
)

Arguments

NetworkInterfaceId

Character. The ID of the network interface.

Attachment

Object. Information about the interface attachment.[optional]

Description

Object. A description for the network interface.[optional]

DryRun

Logical. Checks whether you have the required permissions for the action, without actually making the request,...[optional]

SecurityGroupId

List. Changes the security groups for the network interface.[optional]

SourceDestCheck

Object. Indicates whether source/destination checking is enabled.[optional]

simplify

Logical. Whether to simplify the result and handle nextToken in the response[optional]

others

Named list. The parameters that are not included in the function parameters and need to be added into the request[optional]

print_on_error

Logical. Whether to show an error message when a network error occurs.

retry_time

Integer. Number of retries for a REST request when encounter the network issue. If the request has been sent retry_time times but still not be able to get the response, an error will be thrown.

network_timeout

Numeric. Number of seconds to wait for a REST response until giving up. Can not be less than 1 ms.

region

Character. The region of the AWS service.

Value

A list object or a character vector

NetworkInterfaceId

The ID of the network interface.

Attachment

Information about the interface attachment. If modifying the \'delete on termination\' attribute, you must specify the ID of the interface attachment.

Description

A description for the network interface.

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.

SecurityGroupId

Changes the security groups for the network interface. The new set of groups you specify replaces the current set. You must specify at least one group, even if it\'s just the default security group in the VPC. You must specify the ID of the security group, not the name.

SourceDestCheck

Indicates whether source/destination checking is enabled. A value of true means checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.