Obtenir des informations sur vos NIC

Vous pouvez obtenir des informations sur vos network interface cards (NIC).

Des informations sur vos NIC sont également disponibles depuis les machines virtuelles (VM) elles-mêmes. Pour en savoir plus, voir Accéder aux metadata et user data d’une VM.

Obtenir des informations sur vos NIC avec Cockpit v2

Voir le dashboard NICs.

Obtenir des informations sur vos NIC avec OSC CLI

À ce jour, cette section est disponible en anglais uniquement.

The ReadNics command lists one or more network interface cards (NICs).
A NIC is a virtual network interface that you can attach to a virtual machine (VM) in a Net.

Request sample

$ osc-cli api ReadNics --profile "default" \
    --Filters '{
        "NicIds": ["eni-12345678"],
      }'

Request sample

$ osc-cli api ReadNics --profile "default" \
    --Filters '{
        "LinkNicVmIds": ["i-12345678"],
      }'

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

DryRun: (optional) If true, checks whether you have the required permissions to perform the action.
Filters: (optional) One or more filters.

The ReadNics command returns the following elements:

Nics: Information about one or more NICs.
ResponseContext: Information about the context of the response.

Result sample

{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "Nics": [
    {
      "SubregionName": "eu-west-2a",
      "SubnetId": "subnet-12345678",
      "State": "in-use",
      "LinkNic": {
        "VmId": "i-12345678",
        "LinkNicId": "eni-attach-12345678",
        "VmAccountId": "123456789012",
        "DeleteOnVmDeletion": false,
        "DeviceNumber": 0,
        "State": "attached"
      },
      "IsSourceDestChecked": true,
      "PrivateDnsName": "ip-10-0-0-4.eu-west-2.compute.internal",
      "Tags": [],
      "Description": "Primary network interface",
      "AccountId": "123456789012",
      "SecurityGroups": [
        {
          "SecurityGroupName": "security-group-example",
          "SecurityGroupId": "sg-12345678"
        }
      ],
      "MacAddress": "A1:B2:C3:D4:E5:F6",
      "NetId": "vpc-12345678",
      "NicId": "eni-12345678",
      "PrivateIps": [
        {
          "PrivateDnsName": "ip-10-0-0-4.eu-west-2.compute.internal",
          "PrivateIp": "10.0.0.4",
          "IsPrimary": true
        }
      ]
    }
  ]
}

Obtenir des informations sur vos FNI avec AWS CLI

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 Installer 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é 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 uniquement associer à vos FNI 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 (true) ou détachée (false) 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 uniquement attacher à vos FNI 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 comptes, 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, la FNI 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ée à 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-111-1-1-1.eu-west-2.compute.outscale.com",
              "PublicIp": "111.1.1.1"
          },
          "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-111-1-1-1.eu-west-2.compute.outscale.com",
                      "PublicIp": "111.1.1.1"
                  },
                  "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éthodes API correspondantes

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.