Obtenir des informations sur vos EIP

Vous pouvez obtenir des informations sur les adresses IP externes (EIP) allouées à votre compte.

Par défaut, cette action décrit toutes vos EIP, qu’elles soient disponibles, associées à une instance ou à une interface réseau, ou utilisées pour une NAT gateway. Pour en savoir plus, voir À propos des EIP, Associer une EIP à une instance ou une interface réseau ou Créer une NAT gateway.

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 OSC CLI et AWS CLI. Des informations sur vos EIP sont également disponibles :

Obtenir des informations sur vos EIP avec AWS CLI

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

Exemple de requête
$ aws ec2 describe-addresses \
    --profile YOUR_PROFILE \
    --public-ips 111.11.111.1 \
    [--allocation-ids NOT_SPECIFIED] \
    [--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) 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: Une 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’adresse IP privée de l’instance ou l’adresse IP principale de la network interface principale associée avec l’EIP (si une network interface a plusieurs addresses IP privées, l’EIP est associée soit avec l’adresse IP privée principale soit avec l’une des secondaires).

      Vous pouvez associer votre EIP à une adresse 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.

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’adresse IP privée de l’instance ou de la network interface associée avec l’EIP (si une network interface a plusieurs adresses 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": "111.11.111.2",
            "Domain": "standard",
            "AllocationId": "eipalloc-12345679"
        },
        {
            "Domain": "vpc",
            "InstanceId": "i-1234567890abcdef0",
            "NetworkInterfaceId": "eni-12345678",
            "AssociationId": "eipassoc-12345678",
            "NetworkInterfaceOwnerId": "123456789012",
            "PublicIp": "111.1.111.1",
            "AllocationId": "eipalloc-12345678",
            "PrivateIpAddress": "11.1.1.111"
        }
    ]
}

Obtenir des informations sur vos EIP avec OSC CLI

Voir l’exemple de commande ReadPublicIps dans la documentation de l’API OUTSCALE.

Cette méthode renvoie des informations sur les EIP associées avec différentes ressources, y compris des load balancers reliés à internet.

Associer une EIP avec un load balancer relié à internet est uniquement possible via les méthodes de l’API OUTSCALE CreateLoadBalancer et UpdateLoadBalancer.

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.