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.
- Descriptions: (optional) The descriptions of the NICs.
- IsSourceDestCheck: (optional) Whether the source/destination checking is enabled (true) or disabled (false).
- LinkNicDeleteOnVmDeletion: (optional) Whether the NICs are deleted when the VMs they are attached to are terminated.
- LinkNicDeviceNumbers: (optional) The device numbers the NICs are attached to.
- LinkNicLinkNicIds: (optional) The attachment IDs of the NICs.
- LinkNicStates: (optional) The states of the attachments.
- LinkNicVmAccountIds: (optional) The account IDs of the owners of the VMs the NICs are attached to.
- LinkNicVmIds: (optional) The IDs of the VMs the NICs are attached to.
- LinkPublicIpAccountIds: (optional) The account IDs of the owners of the public IPs associated with the NICs.
- LinkPublicIpLinkPublicIpIds: (optional) The association IDs returned when the public IPs were associated with the NICs.
- LinkPublicIpPublicDnsNames: (optional) The public DNS names associated with the public IPs.
- LinkPublicIpPublicIpIds: (optional) The allocation IDs returned when the public IPs were allocated to their accounts.
- LinkPublicIpPublicIps: (optional) The public IPs associated with the NICs.
- MacAddresses: (optional) The Media Access Control (MAC) addresses of the NICs.
- NetIds: (optional) The IDs of the Nets where the NICs are located.
- NicIds: (optional) The IDs of the NICs.
- PrivateDnsNames: (optional) The private DNS names associated with the primary private IPs.
- PrivateIpsLinkPublicIpAccountIds: (optional) The account IDs of the owner of the public IPs associated with the private IPs.
- PrivateIpsLinkPublicIpPublicIps: (optional) The public IPs associated with the private IPs.
- PrivateIpsPrimaryIp: (optional) Whether the private IP is the primary IP associated with the NIC.
- PrivateIpsPrivateIps: (optional) The private IPs of the NICs.
- SecurityGroupIds: (optional) The IDs of the security groups associated with the NICs.
- SecurityGroupNames: (optional) The names of the security groups associated with the NICs.
- States: (optional) The states of the NICs.
- SubnetIds: (optional) The IDs of the Subnets for the NICs.
- SubregionNames: (optional) The Subregions where the NICs are located.
- TagKeys: (optional) The keys of the tags associated with the NICs.
- TagValues: (optional) The values of the tags associated with the NICs.
- Tags: (optional) The key/value combination of the tags associated with the NICs, in the following format: "Filters":{"Tags":["TAGKEY=TAGVALUE"]}.

The ReadNics command returns the following elements:

Nics: Information about one or more NICs.
- AccountId: The account ID of the owner of the NIC.
- Description: The description of the NIC.
- IsSourceDestChecked: (Net only) If true, the source/destination check is enabled. If false, it is disabled.
- LinkNic: Information about the NIC attachment.
  - DeleteOnVmDeletion: If true, the NIC is deleted when the VM is terminated.
  - DeviceNumber: The device index for the NIC attachment (between 1 and 7, both included).
  - LinkNicId: The ID of the NIC to attach.
  - State: The state of the attachment (attaching | attached | detaching | detached).
  - VmAccountId: The account ID of the owner of the VM.
  - VmId: The ID of the VM.
- LinkPublicIp: Information about the public IP association.
  - LinkPublicIpId: (Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
  - PublicDnsName: The name of the public DNS.
  - PublicIp: The public IP associated with the NIC.
  - PublicIpAccountId: The account ID of the owner of the public IP.
  - PublicIpId: The allocation ID of the public IP.
- MacAddress: The Media Access Control (MAC) address of the NIC.
- NetId: The ID of the Net for the NIC.
- NicId: The ID of the NIC.
- PrivateDnsName: The name of the private DNS.
- PrivateIps: The private IPs of the NIC.
  - IsPrimary: If true, the IP is the primary private IP of the NIC.
  - LinkPublicIp: Information about the public IP association.
    
    LinkPublicIpId: (Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
    
    PublicDnsName: The name of the public DNS.
    
    PublicIp: The public IP associated with the NIC.
    
    PublicIpAccountId: The account ID of the owner of the public IP.
    
    PublicIpId: The allocation ID of the public IP.
  - PrivateDnsName: The name of the private DNS.
  - PrivateIp: The private IP of the NIC.
- SecurityGroups: One or more IDs of security groups for the NIC.
  - SecurityGroupId: The ID of the security group.
  - SecurityGroupName: The name of the security group.
- State: The state of the NIC (available | attaching | in-use | detaching).
- SubnetId: The ID of the Subnet.
- SubregionName: The Subregion in which the NIC is located.
- Tags: One or more tags associated with the NIC.
  - Key: The key of the tag, with a minimum of 1 character.
  - Value: The value of the tag, between 0 and 255 characters.
ResponseContext: Information about the context of the response.
- RequestId: The ID of the request.

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 Name=X,Values=Y \
    --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 NIC > Attachement des NIC aux VM.
- 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 NIC > Attachement des NIC aux VM.
- 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 NIC > Attachement des NIC aux VM.
- 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 NIC > Attachement des NIC aux VM.
- 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.