DescribeNetworkInterfaces#

Description#

Describes one or more of your network interfaces. Interfaces can be filtered by their parameters.

Request Parameters#

  • NetworkInterfaceId.N — IDs of network interfaces.

    • Type: Array of strings

    • Required: No

  • Filter.N — One or more filters.

    • Type: List of Filter objects

    • Required: No

Supported Filters#

  • addresses.private-ip-addresses — The private IP addresses.

  • association.association-id — The ID of the association between the Elastic IP address and a network interface.

  • association.allocation-id — The ID of an allocated external Elastic IP address.

  • association.public-ip — The public Elastic IP address.

  • association.public-dns-name — The public DNS name.

  • attachment.attachment-id — The ID of the attachment.

  • attachment.attach-time — The timestamp when the attachment was initiated.

  • attachment.delete-on-termination — Specifies whether the attachment should be deleted together with the instance.

  • attachment.device-index — The index of the network interface.

  • attachment.instance-id — The ID of the instance.

  • availability-zone — The name of the availability zone.

  • description — The description of the network interface.

  • mac-address — The MAC address of the network interface.

  • network-interface-id — The ID of the network interface.

  • private-ip-address — The private IP address.

  • private-dns-name — The private DNS name.

  • requester-managed — Indicates whether the network interface is used by a cloud service.

  • source-dest-check — Specifies whether source/destination checking is enabled on the instance.

  • status — The status of the network interface.

  • subnetId — The ID of the subnet.

  • switch-id — The ID of the virtual switch.

  • vpc-id — The ID of the VPC.

Response Elements#

  • networkInterfaceSet — List of network interfaces.

  • requestId — The request ID.

    • Type: String

Examples#

c2-ec2 DescribeNetworkInterfaces NetworkInterfaceId.0 eni-12345678

c2-ec2 DescribeNetworkInterfaces Filter.0.Name status Filter.0.Value.0 "available"