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 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.
$ osc-cli api ReadPublicIps --profile "default" \
--Filters '{
"PublicIps": ["192.0.2.0"]
}'
$ 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 (between1
and1000
, 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.
-
{
"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 :
$ 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
, soitallocation-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 lanetwork-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 |
{
"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.