Getting Information About Your FNIs

You can get information about your flexible network interfaces (FNIs).

If you exceed the number of identical requests allowed for a configured time period, the RequestLimitExceeded error message is returned.

This procedure uses AWS CLI only. Information about your FNIs is also available:

To get information about your FNIs, use the describe-network-interfaces command following this syntax:

Request sample
$ aws ec2 describe-network-interfaces \
  --profile YOUR_PROFILE \
  --network-interface-ids eni-12345678 \
  [--filters NOT_SPECIFIED] \
  --endpoint https://fcu.eu-west-2.outscale.com

This command contains the following attributes that you need to specify:

  • (optional) profile: The named profile you want to use, created when configuring AWS CLI. For more information, see Installing and Configuring AWS CLI.

  • (optional) network-interface-ids: The ID of one or more FNIs.

  • (optional) filters: One or more filters, in the "Name=X,Values=Y" format.

    You can specify several values for a same filter using the "Name=X,Values=Y, Z" format.

    The following filters are available:

    • addresses.association.owner-id: The account ID of the owner of the IPs associated with the FNI.

    • addresses.association.public-ip: The association ID returned when the FNI was associated with an External IP (EIP). addresses.primary: Whether the private IP is the primary IP associated with the FNI.

    • addresses.private-ip-address: The private IPs associated with the FNI.

    • association.allocation-id: The allocation ID returned when you allocated the EIP to your account.

    • association.association-id: The association ID returned when the FNI was associated with an EIP.

    • association.ip-owner-id: The account ID of the owner of the EIP associated with the FNI.

      As you can only associate EIPs belonging to your account to your FNIs, this filter is always your account ID.

    • association.public-dns-name: The public DNS name associated with the EIP.

    • association.public-ip: The EIP associated with the FNI.

    • attachment.attach.time: The time at which the FNI was attached to an instance.

    • attachment.attachment-id: The attachment ID of the FNI.

    • attachment.delete-on-termination: Whether the FNI is deleted when the instance it is attached to is terminated.

    • attachment.device-index: The device index used for the FNI.

    • attachment.instance-id: The ID of the instance the FNI is attached to.

    • attachment.instance-owner-id: The account ID of the owner of the instance the FNI is attached to.

      As you can only attach your FNIs to instances belonging to you, this filter is always your account ID.

  • attachment.status: The state of the attachment. For more information, see About FNIs > FNIs Attachment to Instances.

  • availability-zone: The Availability Zone (AZ) where the FNI is located.

  • description: The description of the FNI.

  • group-id: The ID of a security group associated with the FNI.

  • group-name: The name of a security group associated with the FNI.

  • mac-address: The Media Access Control (MAC) address of the FNI.

  • network-interface-id: The ID of the FNI.

  • owner-id: The account ID of the FNI owner.

As you cannot share FNIs with other users, this filter is always your account ID.

  • private-dns-name: The private DNS name associated with the primary private IP.

  • private-ip-address: The primary private IP of the FNI.

  • source-dest-check: Whether the source/destination checking is enabled (true) or disabled (false).

  • status: The state of the FNI. For more information, see About FNIs > FNIs Attachment to Instances.

  • subnet-id: The ID of the subnet in where the FNI is located.

  • vpc-id: The ID of the VPC in where the FNI is located.

  • endpoint: The endpoint corresponding to the Region you want to send the request to.

The describe-network-interfaces command returns the following elements:

  • NetworkInterfaces: Information about one or more FNIs. This element contains the following information:

    • Association: Information about the association between the FNI and an EIP. This element contains the following information:

      • AllocationId: The allocation ID returned when you allocated the EIP to your account.

      • AssociationId: The association ID returned when the FNI was associated with an EIP.

      • IpOwnerId: The account ID of the owner of the EIP associated with the FNI.

      • PublicDnsName: The public DNS name associated with the EIP.

      • PublicIp: The EIP associated with the FNI.

    • Attachment: Information about the FNI attachment. This element contains the following information:

      • AttachTime: The time at which the FNI was attached to an instance.

      • AttachmentId: The attachment ID of the FNI.

      • DeleteOnTermination: If true, the FNI is deleted when terminating the instance. If false, it is only detached.

      • DeviceIndex: The device index used for the FNI attachment.

      • InstanceId: The ID of the instance the FNI is attached to.

      • InstanceOwnerId: The account ID of the owner of the instance the FNI is attached to.

      • Status: The state of the attachment. For more information, see About FNIs > FNIs Attachment to Instances.

    • AvailabilityZone: The Availability Zone (AZ) where the FNI is located.

    • Description: The description of the FNI.

    • Groups: Information about one or more security groups associated with the FNI. This element contains the following information:

      • GroupName: The name of a security group associated with the FNI.

      • GroupId: The ID of a security group associated with the FNI.

    • MacAddress: The Media Access Control (MAC) address of the FNI.

    • NetworkInterfaceId: The ID of the FNI.

    • OwnerId: The account ID of the FNI owner.

    • PrivateDnsName: The private DNS name associated with the primary private IP of the FNI.

    • PrivateIpAddress: The primary private IP of the FNI.

    • PrivateIpAddresses: Information about the EIP and the private IPs assigned to the FNI. This element contains the following information:

      • Association: Information about the association of the FNI with an EIP. This element contains the following information:

        • PublicIp: The EIP associated with the FNI.

        • AssociationId: The association ID returned when the FNI was associated with an EIP.

        • PublicDnsName: The public DNS name associated with the EIP.

        • AllocationId: The allocation ID returned when you allocated the EIP to your account.

        • IpOwnerId: The account ID of the owner of the EIP associated with the FNI.

      • Primary: If true, the following private IP is the primary one. If false, it is a secondary one.

      • PrivateDnsName: The private DNS name associated with the primary private IP of the FNI.

      • PrivateIpAddress: A private IP assigned to the FNI.

    • SourceDestCheck: If true, the traffic to or from the instance is validated. If false, it is not.

    • Status: The state of the FNI. For more information, see About FNIs > FNIs Attachment to Instances.

    • SubnetId: The ID of the subnet where the FNI is located.

    • TagSet: One or more tags associated with the FNI.

    • VpcId: The ID of the VPC where the FNI is located.

Result sample
{
  "NetworkInterfaces": [
      {
      "Association": {
        "AllocationId": "eipalloc-06e13163",
              "AssociationId": "eipassoc-87654321",
              "IpOwnerId": "123456789000",
              "PublicDnsName": "ows-203-0-113-12.eu-west-2.compute.outscale.com",
              "PublicIp": "203.0.113.12"
          },
          "Attachment": {
              "AttachTime": "2016-08-24T08:27:33.000Z",
              "AttachmentId": "eni-attach-12345678",
              "DeleteOnTermination": false,
              "DeviceIndex": 1,
              "InstanceId": "i-12345678",
              "InstanceOwnerId": "123456789000",
              "Status": "attached"
          },
      "AvailabilityZone": "eu-west-2a",
          "Description": "my-FNI",
          "Groups": [
              {
                  "GroupName": "SG1",
                  "GroupId": "sg-12345678"
              }
          ],
          "MacAddress": "02:2f:8f:b0:cf:75",
          "NetworkInterfaceId": "eni-12345678",
          "OwnerId": "123456789000",
          "PrivateDnsName": "ip-10-0-1-17.eu-west-2.compute.internal",
      "PrivateIpAddress": "10.0.1.17",
          "PrivateIpAddresses": [
              {
                  "Association": {
            "AllocationId": "eipalloc-06e13163",
                      "AssociationId": "eipassoc-87654321",
                      "IpOwnerId": "123456789000",
                      "PublicDnsName": "ows-203-0-113-12.eu-west-2.compute.outscale.com",
                      "PublicIp": "203.0.113.12"
                  },
          "Primary": true,
                  "PrivateDnsName": "ip-10-0-1-17.eu-west-2.compute.internal",
          "PrivateIpAddress": "10.0.1.17"
              }
          ],
          "SourceDestCheck": true,
          "Status": "in-use",
          "SubnetId": "subnet-12345678",
          "TagSet": [],
      "VpcId": "vpc-12345678"
       }
   ]
}

Related Pages

Corresponding API Method

AWS™ and Amazon Web Services™ are trademarks of Amazon Technologies, Inc or its affiliates in the United States and/or other countries.