Obtenir des informations sur vos OMI

Avec AWS CLI, vous pouvez obtenir des informations sur les OMI que vous pouvez utiliser pour lancer des instances :

  • Les OMI que vous avez créées.

  • Les OMI que les autres utilisateurs ont partagées avec vous.

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 uniquement AWS CLI. Des informations sur ces ressources sont également disponibles dans Cockpit. Pour en savoir plus, voir Interface utilisateur des OMI.

Obtenir des informations générales sur vos OMI

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

Exemple de requête
$ aws ec2 describe-images \
    --profile YOUR_PROFILE \
    --image-ids ami-12345678 ami-87654321 ami-56781234 \
    --owners 1234567890000 \
    --executable-users 0000987654321 \
    [--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.

  • image-ids : Un ou plusieurs ID d’OMI.

    Si vous ne spécifiez aucun ID d’OMI, toutes vos OMI ou toutes vos OMI en accord avec les filtres spécifiés (s’il y en a) sont décrites.

  • (optionnel) owners : L’ID de compte d’un ou plusieurs propriétaires d’OMI. Par défaut, toutes les OMI pour lesquelles vous avez une autorisation d’utilisation sont décrites.

  • (optionnel) executable-users : L’ID de compte d’un ou plusieurs utilisateurs autorisés à utiliser les OMI.

  • (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’OMI (i386 ou x86_64).

    • 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.snapshot-id : L’ID du snapshot utilisé pour créer le volume.

    • block-device-mapping.volume-size : La taille du volume, en gibioctets (Gio).

    • block-device-mapping.volume-type : Le type de volume (standard | gp2 | io1).

    • description : La description de l’OMI, fournie lors de sa création.

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

    • image-id : L’ID de l’OMI.

    • image-type : Le type d’OMI (toujours machine pour les OMI officielles).

    • is-public : Indique si l’OMI est publique.

    • manifest-location : L’emplacement du manifeste OMI.

    • name : Le nom de l’OMI, fourni lors de sa création.

    • owner-alias : L’alias du compte du propriétaire de l’OMI.

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

    • platform : La plateforme.

    • product-code.type : Le type de code produit associé à l’OMI ( Linux/Unix | Windows | Linux/Oracle | Windows 10).

      Une fois associé à une OMI, un code produit ne peut pas être enlevé.

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

    • root-device-type : Le type de volume système utilisé par l’OMI (toujours ebs).

    • state : L’état actuel de l’OMI (pending | available | failed).

    • tag:key=value : La combinaison clé/valeur d’un tag associé à la ressource, au format suivant : Filter=[{'Name':'tag:tag_key','Value':'tag_value'}].

    • tag-key : La clé d’un tag associé à la ressource. Vous pouvez utiliser ce filtre avec le filtre tag-value. Dans ce cas, vous filtrez les ressources correspondant à chaque tag, indépendamment de l’autre filtre.

    • tag-value : La valeur d’un tag associé à la ressource. Vous pouvez utiliser ce filtre avec le filtre tag-key. Dans ce cas, vous filtrez les ressources correspondant à chaque tag, indépendamment de l’autre filtre.

    • 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

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

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

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

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

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

    • Name : Le nom de l’OMI.

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

    • ImageId : L’ID de l’OMI.

    • Platform : Pas d’information renvoyée.

    • State : L’état actuel de l’OMI.

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

    • Architecture : L’architecture de l’OMI.

    • ImageLocation : Le chemin de l’OMI.

    • RootDeviceType : Le type de volume système (toujours ebs).

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

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

    • Public : Indique si l’OMI est publique.

    • ImageType : Le type d’OMI (toujours machine pour les OMI officielles).

    • Description : La description de l’OMI, s’il y en a une.

Exemple de résultat
{
    "Images": [
        {
            "VirtualizationType": "hvm",
            "Name": "Image_name",
            "Hypervisor": "xen",
            "ImageId": "ami-12345678",
            "Platform": "",
            "State": "available",
            "BlockDeviceMappings": [
                {
                    "DeviceName": "/dev/sda1",
                    "Ebs": {
                        "DeleteOnTermination": true,
                        "SnapshotId": "snap-87654321",
                        "VolumeSize": 8,
                        "VolumeType": "standard"
                    }
                }
            ],
            "Architecture": "x86_64",
            "ImageLocation": "1234567890000/Image_name",
            "RootDeviceType": "ebs",
            "OwnerId": "1234567890000",
            "RootDeviceName": "/dev/sda1",
            "Public": false,
            "ImageType": "machine",
            "Description": "CentOS 7 with HAProxy installed and NAT configured"
        }]
}

Obtenir des informations sur un attribut d’une OMI

Vous pouvez obtenir des informations sur la liste des utilisateurs qui ont les permissions pour créer une instance à partir de l’OMI spécifiée. Vous pouvez modifier ces permissions à tout moment. Pour en savoir plus, voir Modifier les attributs d’une OMI.

Pour obtenir des informations sur les utilisateurs qui ont les permissions d’utiliser une OMI depuis Cockpit, vous devez utiliser la commande Autorisations. Pour en savoir plus, voir Modifier les attributs d’une OMI.

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

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

  • image-id : L’ID de l’OMI.

  • attribute: L’attribut de l’OMI (description | kernel | launchPermission | productCodes).

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

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

  • La valeur de l’attribut (ici, LaunchPermission).

  • ImageId : L’ID de l’OMI.

Exemple de résultat
{
    "LaunchPermissions": [
        {
            "UserId": "12345679890000"
        },
        {
            "UserId": "0000987654321"
        }
    ],
    "ImageId": "ami-123456789"
}

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.