Obtenir des informations sur vos IP publiques

Vous pouvez obtenir des informations sur les IP publiques allouées à votre compte.

Par défaut, cette action décrit toutes vos IP publiques, qu’elles soient disponibles, associées à une machine virtuelle (VM) ou à une interface réseau, ou utilisées pour un NAT service. Pour en savoir plus, voir À propos des IP publiques, Associer une IP publique à une VM ou une interface réseau ou Créer un NAT service.

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

Obtenir des informations sur vos IP publiques avec Cockpit v2

Voir le dashboard Public IPs.

Obtenir des informations sur vos IP publiques avec OSC CLI

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

The ReadPublicIps command lists one or more public IPs allocated to your account.
By default, this action returns information about all your public IPs: available or associated with a virtual machine (VM), a network interface card (NIC) or a NAT service.

Request sample
$ osc-cli api ReadPublicIps --profile "default" \
    --Filters '{
        "PublicIps": ["192.0.2.0"]
      }'
Request sample
$ osc-cli api ReadPublicIps --profile "default" \
    --Filters '{
        "VmIds": ["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.

    • LinkPublicIpIds: (optional) The IDs representing the associations of public IPs with VMs or NICs.

    • NicAccountIds: (optional) The account IDs of the owners of the NICs.

    • NicIds: (optional) The IDs of the NICs.

    • Placements: (optional) Whether the public IPs are for use in the public Cloud or in a Net.

    • PrivateIps: (optional) The private IPs associated with the public IPs.

    • PublicIpIds: (optional) The IDs of the public IPs.

    • PublicIps: (optional) The public IPs.

    • TagKeys: (optional) The keys of the tags associated with the public IPs.

    • TagValues: (optional) The values of the tags associated with the public IPs.

    • Tags: (optional) The key/value combination of the tags associated with the public IPs, in the following format: "Filters":{"Tags":["TAGKEY=TAGVALUE"]}.

    • VmIds: (optional) The IDs of the VMs.

  • NextPageToken: (optional) The token to request the next page of results. Each token refers to a specific page.

  • ResultsPerPage: (optional) The maximum number of logs returned in a single response (between 1 and 1000, both included). By default, 100.

The ReadPublicIps command returns the following elements:

  • NextPageToken: The token to request the next page of results. Each token refers to a specific page.

  • PublicIps: Information about one or more public IPs.

    • LinkPublicIpId: (Required in a Net) The ID representing the association of the public IP with the VM or the NIC.

    • NicAccountId: The account ID of the owner of the NIC.

    • NicId: The ID of the NIC the public IP is associated with (if any).

    • PrivateIp: The private IP associated with the public IP.

    • PublicIp: The public IP.

    • PublicIpId: The allocation ID of the public IP.

    • Tags: One or more tags associated with the public IP.

      • Key: The key of the tag, with a minimum of 1 character.

      • Value: The value of the tag, between 0 and 255 characters.

    • VmId: The ID of the VM the public IP is associated with (if any).

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the request.

Result sample
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "PublicIps": [
    {
      "VmId": "i-12345678",
      "Tags": [],
      "PublicIpId": "eipalloc-12345678",
      "PublicIp": "192.0.2.0",
      "LinkPublicIpId": "eipassoc-12345678",
      "NicAccountId": "123456789012",
      "NicId": "eni-12345678",
      "PrivateIp": "10.0.0.4"
    }
  ]
}

Obtenir des informations sur vos EIP avec AWS CLI

Avant de commencer : Installez et configurez AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

Pour obtenir des informations sur vos EIP, utilisez la commande describe-addresses en suivant cette syntaxe :

Exemple de requête
$ aws ec2 describe-addresses \
    --profile YOUR_PROFILE \
    --public-ips 111.1.1.1 \
    --allocation-ids NOT_SPECIFIED \
    --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) public-ips : Une ou plusieurs EIP sur lesquelles vous voulez des informations.

    Vous devez spécifier soit public-ips , soit allocation-ids .

  • (optionnel) allocation-ids : Un ou plusieurs ID d’allocation.

  • (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 :

    • instance-id : L’ID de l’instance à laquelle l’EIP est associée.

      Vous devez spécifier soit l'instance-id soit la network-interface-id.

    • public-ip : L’EIP.

    • network-interface-id : L’ID de la network interface à laquelle l’EIP est associée.

    • network-interface-owner-id : L’ID de compte du propriétaire de l’EIP.

    • private-ip-address : L’IP privée de l’instance ou l’IP principale de la network interface principale associée avec l’EIP (si une network interface a plusieurs IP privées, l’EIP est associée soit avec l’IP privée principale soit avec l’une des secondaires).

      Vous pouvez associer votre EIP à une IP privée secondaire d’une network interface. Si vous ne spécifiez pas d’IP privée secondaire, l’EIP est associée à l’IP privée principale.

    • allocation-id : L’ID de l’allocation de l’EIP.

    • association-id : L’ID de l’association de l’EIP avec une instance ou une network interface.

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête. Pour en savoir plus, voir Installer et configurer AWS CLI.

La commande describe-addresses renvoie les éléments suivants :

  • Addresses : Les informations à propos d’une ou plusieurs EIP. Cet élément contient les informations suivantes :

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

    • PublicIp : L’EIP.

    • Domain : Si l’EIP est dans un VPC ou dans le Cloud public. Cet élément est seulement fournit à titre d’information.

    • NetworkInterfaceId : L’ID de la network interface à laquelle l’EIP est associée.

    • AssociationId : L’ID de l’association de l’EIP avec une instance ou une network interface.

    • NetworkInterfaceOwnerId : L’ID de compte du propriétaire de l’EIP.

    • AllocationId : L’ID de l’allocation.

    • PrivateIpAddress : L’IP privée de l’instance ou de la network interface associée avec l’EIP (si une network interface a plusieurs IP privées, c’est soit la principale soit l’une des secondaires).

Même si l’EIP n’est associée à aucune ressource, les éléments InstanceId, PublicIp, Domain et AllocationId sont affichés.

Exemple de résultat
{
    "Addresses": [
        {
            "InstanceId": "",
            "PublicIp": "222.2.2.2",
            "Domain": "standard",
            "AllocationId": "eipalloc-12345679"
        },
        {
            "Domain": "vpc",
            "InstanceId": "i-1234567890abcdef0",
            "NetworkInterfaceId": "eni-12345678",
            "AssociationId": "eipassoc-12345678",
            "NetworkInterfaceOwnerId": "123456789012",
            "PublicIp": "111.1.1.1",
            "AllocationId": "eipalloc-12345678",
            "PrivateIpAddress": "10.0.0.0"
        }
    ]
}

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.