Obtenir des informations sur vos instances

Vous pouvez obtenir des informations sur vos instances, leurs états et leurs attributs.

Si vous dépassez le nombre autorisé de requêtes identiques pour une durée configurée, le message d’erreur RequestLimitExceeded est renvoyé.

Ces procédures utilisent uniquement AWS CLI. Des informations sur vos instances sont également disponibles :

Obtenir des informations générales sur vos instances

Pour obtenir des informations générales sur une ou plusieurs instances, utilisez la commande describe-instances suivant cette syntaxe :

Exemple de requête
$ aws ec2 describe-instances \
    --profile YOUR_PROFILE \
    --instance-ids i-12345678 i-87654321 i-12348765 i-56784321 \
    --filters Name=instance-state-name,Values=stopped \
    --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) instance-ids : Un ou plusieurs ID d’instances.

    Si vous ne spécifiez aucun ID d’instance, toutes vos instances ou toutes les instances qui correspondent aux filtres spécifiés sont décrites.

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

    • architecture : L’architecture de l’instance (i386 | x86_64).

    • availability-zone : L’Availability Zone de l’instance. Pour en savoir plus, voir À propos des Régions, endpoints et Availability Zones.

    • block-device-mapping.attach-time : Le moment auquel un volume BSU a été attaché à l’instance (par exemple, 2016-01-23T18:45:30.000Z).

    • block-device-mapping.delete-on-termination : Indique si le volume BSU est supprimé quand l’instance est terminée.

    • block-device-mapping.device-name : Le nom du périphérique pour le volume BSU (par exemple, /dev/sdh or xvdh).

    • block-device-mapping.status : L’état du volume BSU (attaching | attached | detaching | detached).

    • block-device-mapping.volume-id : L’ID du volume BSU.

    • client-token : Le jeton d’idempotence fourni lors du lancement de l’instance.

    • dns-name : Le nom DNS public de l’instance.

    • group-id : L’ID du security group pour l’instance (uniquement dans le Cloud public).

    • group-name : Le nom du security group pour l’instance (uniquement dans le Cloud public).

    • hypervisor : Le type d’hyperviseur de l’instance (toujours xen).

    • image-id : L’ID de l’OMI utilisée pour lancer l’instance.

    • instance-id : L’ID de l’instance.

    • instance-state-code : Le code de l’état de l’instance (un nombre entier non signé 16 bits). Le bit haut est une valeur interne à ignorer. Le bit bas représente l’état de l’instance : -1 (quarantine), 0 (pending), 16 (running), 32 (shutting-down), 48 (terminated), 64 (stopping), ou 80 (stopped).

    • instance-state-name : L’état de l’instance (pending | running | stopping | stopped | shutting-down | terminated | quarantine).

    • instance-type : Le type d’instance (par exemple, t2.micro). Pour en savoir plus, voir Types d’instances.

    • ip-address : Dans le Cloud public, l’IP publique associée à l’instance (remplacée par l’IP externe (EIP), s’il y en a une). Dans un VPC, l’EIP associée à l’instance, s’il y en a une.

    • kernel-id : L’ID du kernel.

    • key-name : Le nom de la keypair utilisée pour l’instance. Pour en savoir plus, voir À propos des keypairs.

    • launch-index : L’index de lancement de l’instance. Pour en savoir plus, voir À propos des instances > Informations générales sur les instances .

    • launch-time : Le moment auquel l’instance a été lancée (par exemple, 2016-04-20T08:26:26.540Z) .

    • monitoring-state : Indique si le monitoring est activé pour l’instance (toujours disabled).

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

    • placement-group-name : Le nom du groupe de placement pour l’instance.

    • platform : La plateforme (windows si vous avez des instances Windows, sinon laissez vide).

    • private-dns-name : Le nom DNS privé de l’instance.

    • private-ip-address : L’IP privée de l’instance.

    • product-code : Le code produit associé à l’OMI utilisée pour lancer l’instance (0001 pour Linux/Unix | 0002 pour Windows | 0004 pour Linux/Oracle | 0005 pour Windows 10).

    • ramdisk-id : L’ID du disque RAM.

    • reason : La raison pour l’état actuel de l’instance (similaire à state-reason-code).

    • requester-id : L’ID de l’entité ayant lancé l’instance (par exemple, Cockpit ou Auto Scaling).

    • reservation-id : L’ID de la réservation de l’instance. Pour en savoir plus, voir À propos des instances > Informations générales sur les instances .

    • root-device-name : Le nom du périphérique associé au volume système (par exemple, /dev/sda1).

    • root-device-type : Le type de volume système (always ebs).

    • state-reason-code : Le code de la raison du changement d’état.

    • state-reason-message : Un message décrivant le changement d’état.subnet-id : L’ID du subnet dans lequel l’instance est.

    • tag-key : La clé d’un tag associé à la ressource.

    • tag-value : La valeur d’un tag associé à la ressource.

    • tag:XXXX : La valeur d’un tag associé à la ressource, où XXXX est la clé du tag.

      Pour filtrer un tag dont la clé est XXXX et la valeur est YYYY, vous pouvez donc utiliser un des deux formats suivants :

      • --filters Name=tag-key,Values=XXXX Name=tag-value,Values=YYYY

      • --filters Name=tag:XXXX,Values=YYYY

    • tenancy : L’allocation de l’instance (dedicated | default). Pour en savoir plus, voir À propos des instances > Allocation des instances et instances dédiées.

    • virtualization-type : Le type de virtualisation de l’instance (toujours hvm).

    • vpc-id : L’ID du VPC dans lequel l’instance est (dans le Cloud public, vpc-00000000).

    • network-interface.description : La description de l’interface réseau.

    • network-interface.subnet-id : L’ID du subnet dans lequel l’instance est.

    • network-interface.vpc-id : L’ID du VPC dans lequel l’instance est (dans le Cloud public, vpc-00000000).

    • network-interface.network-interface-id : L’ID de l’interface réseau de l’instance (eni-XXXXXXXX).

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

    • network-interface.availability-zone : L’Availability Zone pour l’interface réseau.

    • network-interface.requester-id : L’ID du requêteur pour l’interface réseau.

    • network-interface.requester-managed : Indique si l’interface réseau est gérée par 3DS OUTSCALE.

    • network-interface.status : L’état de l’interface réseau (available | in-use).

    • network-interface.mac-address : L’addresse MAC de l’interface réseau.

    • network-interface.private-dns-name : Le nom DNS privé de l’interface réseau.

    • network-interface.source-dest-check : Si true, la vérification source/destination du trafic réseau de l’interface réseau est activé. Si false, elle ne l’est pas.

    • network-interface.group-id : L’ID du security group pour l’interface réseau.

    • network-interface.group-name : Le nom du security group pour l’interface réseau.

    • network-interface.attachment.attachment-id : L’ID de l’attachement de l’interface.

    • network-interface.attachment.instance-id : L’ID de l’instance à laquelle l’interface réseau est attachée.

    • network-interface.attachment.instance-owner-id : L’ID de compte du propriétaire de l’instance à laquelle l’interface réseau est attachée.

    • network-interface.attachment.device-index : L’index du périphérique auquel l’interface réseau est attachée.

    • network-interface.attachment.status : L’état de l’attachement (attaching | attached | detaching | detached ).

    • network-interface.attachment.attach-time : Le moment auquel l’interface réseau a été attachée à l’instance.

    • network-interface.attachment.delete-on-termination : Indique si l’attachement est supprimé quand l’instance est terminée.

    • network-interface.addresses.private-ip-address : L’IP privée associée à l’interface réseau.

    • network-interface.addresses.primary : Indique si l’IP de l’interface réseau est l’IP privée principale.

    • network-interface.addresses.association.public-ip : L’External IP associée à l’interface réseau de l’instance (s’il y en a une).

    • network-interface.addresses.association.ip-owner-id : L’ID de compte du propriétaire de l’External IP associée à l’interface réseau de l’instance.

    • network-interface.association.public-ip : L’IP externe (EIP) associée à l’interface réseau.

    • network-interface.association.ip-owner-id : L’ID du compte du propriétaire de l’IP externe (EIP) associée à l’interface réseau.

    • network-interface.association.allocation-id : L’ID d’allocation. Cette ID est renvoyée quand vous allouez une IP externe (EIP) à votre interface réseau.

    • network-interface.association.association-id : L’ID d’association. Cette ID est renvoyée quand l’interface réseau est associée à une IP externe (EIP).

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.

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

  • Reservations : Informations à propos d’une ou plusieurs réservations. Cet élément contient les informations suivantes :

    • OwnerId : L’ID de compte du propriétaire de l’instance.

    • ReservationId : L’ID de la réservation.

    • Groups : Les security groups pour les instances de la réservation (nom et ID des security groups).

    • Instances : Informations à propos d’une ou plusieurs instances. Cet élément contient les informations suivantes :

      • Monitoring : Informations à propos de l’état du monitoring de l’instance (toujours disabled).

      • PublicDnsName : Le nom DNS public de l’instance.

      • Platform : Pas d’information renvoyée.

      • State : Informations à propos de l’état de l’instance (le code et le nom de l’état).

      • EbsOptimized : Indique si l’instance est optimisée pour BSU ou non. Pour en savoir plus, voir Types d’instances.

      • LaunchTime : Le moment auquel l’instance a été lancée.

      • PublicIpAddress : Dans le Cloud public, l’IP publique associée à l’instance (remplacée par l’IP externe (EIP), s’il y en a une). Dans un VPC, l’EIP associée à l’instance, s’il y en a une.

      • PrivateIpAddress : L’IP privée de l’instance.

      • ProductCodes : Pas d’information renvoyée si vous utilisez une OMI officielle.

      • Tags : Un ou plusieurs tags associés à l’instance, avec leur valeur (Value) et leur clé (Key).

      • InstanceId : L’ID de l’instance.

      • ImageId : L’ID de l’OMI utilisée pour lancer l’instance.

      • VpcId : L’ID du VPC dans lequel l’instance est (dans le Cloud public, vpc-00000000).

      • PrivateDnsNAme : Le nom DNS privé de l’instance.

      • KeyName : Le nom de la keypair utilisée pour l’instance. Pour en savoir plus, voir À propos des keypairs.

      • SecurityGroups : Les security groups pour l’instance (leur nom et ID).

      • ClientToken : Un identifiant unique pour gérer l’idempotence.

      • InstanceType : Le type d’instance. Pour en savoir plus, voir Types d’instances.

      • NetworkInterfaces : Dans un VPC, une ou plusieurs interfaces réseau pour l’instance.

      • Placement : Informations à propos du placement de l’instance.

      • Hypervisor : Le type d’hyperviseur de l’instance (toujours xen).

      • BlockDeviceMappings : Un ou plusieurs block device mappings pour l’instance. Pour en savoir plus, voir Définir des block device mappings.

      • Architecture : L’architecture de l’instance.

      • KernelId : Pas d’information renvoyée.

      • RootDeviceName : Le nom du périphérique pour le volume système de l’instance.

      • VirtualizationType : Le type de virtualisation de l’instance (toujours hvm).

      • RootDeviceType : Le type de volume système pour l’instance (toujours ebs).

      • AmiLaunchIndex : L’index de lancement de l’instance. Pour en savoir plus, voir À propos des instances > Informations générales sur les instances.

        Exemple de résultat
            "Reservations": [
                {
                    "OwnerId": "1234567890000",
                    "ReservationId": "r-12345678",
                    "Groups": [
                        {
                            "GroupName": "Dev_BL",
                            "GroupId": "sg-87654321"
                        }
                    ],
                    "Instances": [
                        {
                            "Monitoring": {
                                "State": "disabled"
                            },
                            "PublicDnsName": "ows-111-1-1-1.eu-west-2.compute.outscale.com",
                            "Platform": "",
                            "State": {
                                "Code": 16,
                                "Name": "running"
                            },
                            "EbsOptimized": false,
                            "LaunchTime": "2016-04-25T13:57:26.393Z",
                            "PublicIpAddress": "111.1.1.1",
                            "PrivateIpAddress": "10.0.1.100",
                            "ProductCodes": [],
                            "Tags": [
                                {
                                    "Value": "Jenkins",
                                    "Key": "Name"
                                }
                            ],
                            "InstanceId": "i-87654321",
                            "ImageId": "ami-12345678",
                            "PrivateDnsName": "ip-10-0-1-100.eu-west-2.compute.internal",
                            "KeyName": "key_name",
                            "SecurityGroups": [
                                {
                                    "GroupName": "group_name",
                                    "GroupId": "sg-87654321"
                                }
                            ],
                            "ClientToken": "",
                            "InstanceType": "m1.large",
                            "NetworkInterfaces": [],
                            "Placement": {
                                "Tenancy": "default",
                                "GroupName": "",
                                "AvailabilityZone": "eu-west-2a"
                            },
                            "Hypervisor": "xen",
                            "BlockDeviceMappings": [
                                {
                                    "DeviceName": "/dev/sda1",
                                    "Ebs": {
                                        "Status": "attached",
                                        "DeleteOnTermination": true,
                                        "VolumeId": "vol-12345678",
                                        "AttachTime": "2016-04-25T13:57:26.393Z"
                                    }
                                }
                            ],
                            "Architecture": "x86_64",
                            "KernelId": "",
                            "RootDeviceName": "/dev/sda1",
                            "VirtualizationType": "hvm",
                            "RootDeviceType": "ebs",
                            "AmiLaunchIndex": 0
                        }
                    ]
                }
            ]
        }

Obtenir des informations sur l’état de vos instances

Pour obtenir des informations sur l’état d’une ou plusieurs instances, utilisez la commande describe-instance-status suivant cette syntaxe :

Exemple de requête
$ aws ec2 describe-instance-status \
    --profile YOUR_PROFILE \
    --instance-ids i-12345678 i-87654321 i-12348765 i-56784321 \
    [--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) instance-ids : Un ou plusieurs ID d’instances.

    Si vous ne spécifiez aucun ID d’instance, toutes vos instances ou toutes les instances qui correspondent aux filtres spécifiés sont décrites. #

  • (optionnel) max-items : Le nombre maximum de résultats renvoyés dans une seule page, entre 5 et 1000.

    Vous ne pouvez pas spécifier les attributs instance-ids et max-items dans la même requête.

  • (optionnel) include-all-instances : Si paramétré sur true, inclus les états de toutes les instances. Par défaut ou si paramétré sur false, inclut uniquement les états des instances à l’état running.

  • (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 : availability-zone : L’Availability Zone de l’instance. Pour en savoir plus, voir À propos des Régions, endpoints et Availability Zones. event.code : Le code de l’événement planifié (system-reboot | system-maintenance). Pour en savoir plus, voir Maintenance de notre infrastructure. event.description : La description de l’évènement planifié. instance-state-code : Le code de l’état de l’instance (un nombre entier non signé 16 bits). Le bit haut est une valeur interne à ignorer. Le bit bas représente l’état de l’instance : -1 (quarantine), 0 (pending), 16 (running), 32 (shutting-down), 48 (terminated), 64 (stopping), ou 80 (stopped). ** instance-state-name : L’état de l’instance (pending | running | stopping | stopped | shutting-down | terminated | quarantine).

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.

La commande describe-instance-status renvoie les éléments suivants :

  • InstanceStatuses : Informations à propos de l’état d’une ou plusieurs instances. Cet élément contient les informations suivantes :

    • AvailabilityZone : L’Availability Zone de l’instance.

    • InstanceId : L’ID de l’instance.

    • InstanceState : Informations à propos de l’état de l’instance. Cet élément contient les informations suivantes :

      • Code : Le code de l’état de l’instance (un nombre entier non signé 16 bits).

      • Name : L’état de l’instance.

    • SystemStatus : L’état du système de l’instance.

    • Events : Informations à propos d’un ou plusieurs événements planifiés associés à l’instance. Cet élément contient les informations suivantes :

      • Code : Le code de l’événement planifié (system-reboot | system-maintenance).

      • Description : Informations à propos de l’événement planifié.

      • NotBefore : L’heure de début de l’événement planifié la plus tôt.

      • NotAfter : L’heure de fin d’un événement planifié la plus tardive.

  • NextToken : Le token pour afficher la prochaine page de résultats. Si null, il n’y a plus de résultats à afficher.

    Exemple de résultat
    {
        "InstanceStatuses": [
            {
                "InstanceStatus": {
                    "Status": "insufficient-data",
                    "Details": []
                },
                "AvailabilityZone": "eu-west-2a",
                "InstanceId": "i-12345678",
                "InstanceState": {
                    "Code": 16,
                    "Name": "running"
                },
                "SystemStatus": {
                    "Status": "insufficient-data",
                    "Details": []
                },
                "Events": []
            }
        ]
    }

Obtenir des informations sur un attribut d’une instance

Pour obtenir des informations sur un attribut d’une instance, utilisez la commande describe-instance-attribute suivant cette syntaxe :

Exemple de requête
$ aws ec2 describe-instance-attribute \
    --profile YOUR_PROFILE \
    --instance-id i-12345678 \
    --attribute disableApiTermination \
    --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.

  • attribute : L’attribut de l’instance (userData | instanceInitiatedShutdownBehavior | rootDeviceName | instanceType | blockDeviceMapping | groupSet | ebsOptimized | sourceDestCheck | disableApiTermination).

    • Vous pouvez spécifier uniquement un attribut à la fois.

    • Vous pouvez décrire l’attribut sourceDestCheck uniquement si l’instance est dans un VPC.

  • instance-id : L’ID de l’instance.

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.

La commande describe-instance-attribute renvoie les éléments suivants :

  • InstanceId : L’ID de l’instance.

  • La valeur de l’attribut (ici, DisableApiTermination est paramétré sur false).

    Exemple de résultat
    {
        "InstanceId": "i-12345678",
        "DisableApiTermination": {
            "Value": false
        }
    }

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.