Obtenir des informations sur vos FNI

Vous pouvez obtenir des informations sur vos flexible network interfaces (FNI).

Si vous dépassez le nombre autorisé de requêtes identiques pour une durée configurée, le message d’erreur RequestLimitExceeded est renvoyé.

Cette procédure utilise uniquement AWS CLI. Des informations sur vos FNIs sont également disponibles :

Pour obtenir des informations sur FNI, utilisez la commande describe-network-interfaces en suivant cette syntaxe :

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

Cette commande contient les attributs suivants que vous devez spécifier :

  • (optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Utiliser et configurer AWS CLI.

  • (optionnel) network-interface-ids : L’ID d’une ou plusieurs FNI.

  • (optionnel) filters : Un ou plusieurs filtres, au format "Name=X,Values=Y".

    Vous pouvez spécifier plusieurs valeurs pour un même filtre en utilisant le format "Name=X,Values=Y, Z".

    Les filtres suivants sont disponibles :

    • addresses.association.owner-id : L’account ID du propriétaire des IP associées à la FNI.

    • addresses.association.public-ip : L’association ID renvoyé lorsque la FNI a été associée à une IP externe (EIP).

    • addresses.primary : Si l’IP privée est l’IP principale associée à la FNI.

    • addresses.private-ip-address : Les IP privées associées à la FNI.

    • association.allocation-id : L’allocation ID renvoyée lorsque vous avez alloué l’EIP à votre compte.

    • association.association-id : L’association ID renvoyé lorsque la FNI a été associée à une EIP.

    • association.ip-owner-id : L’account ID du propriétaire de l’EIP associée à la FNI.

      Comme vous pouvez associer à vos FNI uniquement des EIP qui appartiennent à votre compte, ce filtre est toujours votre account ID.

    • association.public-dns-name : Le nom DNS public associé à l’EIP.

    • association.public-ip : L’EIP associée à la FNI.

    • attachment.attach.time : L’heure à laquelle la FNI a été attachée à l’instance.

    • attachment.attachment-id : L’attachment ID de la FNI.

    • attachment.delete-on-termination : Si la FNI est supprimée lorsque l’instance à laquelle elle est attachée est terminée.

    • attachment.device-index : L’index de périphérique utilisé pour la FNI.

    • attachment.instance-id : L’ID de l’instance à laquelle la FNI est attachée.

    • attachment.instance-owner-id : L’account ID du propriétaire de l’instance à laquelle la FNI est attachée.

      Comme vous pouvez attacher à vos FNI uniquement des instances qui appartiennent à votre compte, ce filtre est toujours votre account ID.

    • attachment.status : L’état de l’attachement. Pour en savoir plus, voir À propos des FNI > Attachement des FNI aux instances.

    • availability-zone : L’Availability Zone (AZ) dans laquelle se trouve la FNI.

    • description : La description de la FNI.

    • group-id : L’ID du security group associé à la FNI.

    • group-name : Le nom du security group associé à la FNI.

    • mac-address : L’adresse MAC (Media Access Control) de la FNI.

    • network-interface-id : L’ID de la FNI.

    • owner-id : L’account ID du propriétaire de la FNI.

      Comme vous ne pouvez pas partager vos FNI avec d’autres utilisateurs, ce filtre est toujours votre account ID.

    • private-dns-name : Le nom DNS privé associé à l’IP privée principale.

    • private-ip-address : L’IP privée principale de la FNI.

    • source-dest-check : Si la vérification source/destination est activée (true) ou désactivée (false).

    • status : L’état de la FNI. Pour en savoir plus, voir À propos des FNI > Attachement des FNI aux instances.

    • subnet-id : L’ID du subnet dans lequel se trouve la FNI.

    • vpc-id : L’ID du VPC dans lequel se trouve la FNI.

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.

La commande describe-network-interfaces renvoie les éléments suivants :

  • NetworkInterfaces : Informations sur une ou plusieurs FNI. Cet élément contient les informations suivantes :

    • Association : Informations sur l’association entre la FNI et une EIP. Cet élément contient les informations suivantes :

      • AllocationId : L’allocation ID renvoyé lorsque l’EIP a été allouée à votre compte.

      • AssociationId : L’association ID renvoyé lorsque la FNI a été associée à une EIP.

      • IpOwnerId : L’account ID du propriétaire de l’EIP associée à la FNI.

      • PublicDnsName : Le nom DNS public associé à l’EIP.

      • PublicIp : L’EIP associée à la FNI.

    • Attachment : Informations sur les attachements de la FNI. Cet élément contient les informations suivantes :

      • AttachTime : L’heure de l’attachement de la FNI à une instance.

      • AttachmentId : L’ID d’attachement de la FNI.

      • DeleteOnTermination : Si true, la FNI est supprimée quand l’instance est terminée. Si false, elle est seulement détachée.

      • DeviceIndex : L’index de périphérique utilisé pour l’attachement de la FNI.

      • InstanceId : L’ID de l’instance à laquelle votre FNI est attachée.

      • InstanceOwnerId : L’account ID du propriétaire de l’instance à laquelle la FNI est attachée.

      • Status : L’état de la FNI. Pour en savoir plus, voir À propos des FNI > Attachement des FNI aux instances.

    • AvailablityZone : L’AZ dans laquelle se trouve la FNI.

    • Description : La description de la FNI.

    • Groups : Informations sur un ou plusieurs security groups associés à votre FNI. Cet élément contient les informations suivantes :

      • GroupName : Le nom d’un security group associé à la FNI.

      • GroupId : L’ID d’un security group associé à la FNI.

    • MacAddress : L’adresse MAC (Media Access Control) de la FNI.

    • NetworkInterfaceId : L’ID de la FNI.

    • OwnerId : L’account ID du propriétaire de la FNI.

    • PrivateDnsName : Le nom DNS privé associé à l’IP privée principale de la FNI.

    • PrivateIpAddress : L’IP privée principale attribuée à la FNI.

    • PrivateIpAddresses : Informations sur les EIP et les IP privées attribuées à la FNI. Cet élément contient les informations suivantes :

      • Association : Informations sur l’association de la FNI à l’EIP. Cet élément contient les informations suivantes :

        • PublicIp : L’EIP associée à la FNI.

        • AssociationId : L’association ID renvoyé lorsque la FNI a été associée à une EIP.

        • PublicDnsName : Le nom DNS public associé à l’EIP.

        • AllocationId : L’allocation ID renvoyé lorsque vous avez alloué l’EIP à votre compte.

        • IpOwnerId : L’account ID du propriétaire de l’EIP associé à la FNI.

      • Primary : Si true, l’IP privée qui suit est la principale. Si false, il s’agit d’une IP secondaire.

      • PrivateDnsName : Le nom DNS privé associé à l’IP privée principale de la FNI.

      • PrivateIpAddress : Une IP privée attribuée à la FNI.

    • SourceDestCheck : Si true, le trafic vers et depuis l’instance est validé. Si false, il ne l’est pas.

    • Status : L’état de l’attachement de la FNI. Pour en savoir plus, voir À propos des FNI > Attachement des FNI aux instances.

    • SubnetId : L’ID du subnet dans lequel se trouve la FNI.

    • TagSet : Un ou plusieurs tags associés à la FNI.

    • VpcId : L’ID du VPC dans lequel se trouve la FNI.

Exemple de résultat
{
  "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"
       }
   ]
}

Pages connexes

Méthode API correspondante

AWS™ et Amazon Web Services™ sont des marques de commerce d'Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.