Utilisation du point de EC2 terminaison compatible Amazon sur un appareil Snow Family - AWS Snowball Edge Guide du développeur

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation du point de EC2 terminaison compatible Amazon sur un appareil Snow Family

Vous trouverez ci-dessous un aperçu du point de terminaison EC2 compatible avec Amazon. À l'aide de ce point de terminaison, vous pouvez gérer vos Amazon Machine Images (AMIs) et calculer des instances par programmation à l'aide d'opérations EC2 compatibles API avec Amazon.

EC2Spécification du point de terminaison compatible comme point de AWS CLI terminaison sur un appareil Snow Family

Lorsque vous utilisez le AWS CLI pour envoyer une commande à l' AWS Snowball Edge appareil, vous pouvez spécifier que le point de terminaison est le point de terminaison EC2 compatible avec Amazon. Vous pouvez choisir d'utiliser le HTTPS point de terminaison ou un point de HTTP terminaison non sécurisé, comme indiqué ci-dessous.

HTTPSpoint de terminaison sécurisé

aws ec2 describe-instances --endpoint https://192.0.2.0:8243 --ca-bundle path/to/certificate

HTTPpoint de terminaison non sécurisé

aws ec2 describe-instances --endpoint http://192.0.2.0:8008

Si vous utilisez le HTTPS point de terminaison de8243, vos données en transit sont cryptées. Ce cryptage est assuré par un certificat généré par le Snowball Edge lorsqu'il est déverrouillé. Une fois que vous avez votre certificat, vous pouvez l'enregistrer dans un fichier ca-bundle.pem local. Vous pouvez ensuite configurer votre profil d' AWS CLI pour inclure le chemin d'accès à votre certificat, comme décrit ci-après.

Pour associer votre certificat au point de terminaison EC2 compatible avec Amazon
  1. Connectez le Snowball Edge à l'alimentation et au réseau, puis allumez-le.

  2. Une fois que le déverrouillage de l'appareil est terminé, notez l'adresse IP de celui-ci sur votre réseau local.

  3. À partir d'un terminal de votre réseau, assurez-vous de pouvoir envoyer un ping au Snowball Edge.

  4. Exécutez la commande snowballEdge get-certificate dans votre terminal. Pour plus d'informations sur cette commande, consultez Gestion des certificats de clé publique sur les appareils de la gamme Snow.

  5. Enregistrez la sortie de la commande snowballEdge get-certificate dans un fichier, par exemple ca-bundle.pem.

  6. Exécutez la commande suivante à partir de votre terminal.

    aws configure set profile.snowballEdge.ca_bundle /path/to/ca-bundle.pem

Une fois la procédure terminée, vous pouvez exécuter des CLI commandes avec ces informations d'identification locales, votre certificat et le point de terminaison que vous avez spécifié.

AWS CLI Commandes EC2 compatibles avec Amazon prises en charge sur un appareil Snow Family

Vous pouvez gérer vos instances de calcul sur un appareil de la famille Snow via un point de terminaison EC2 compatible avec Amazon. Ce type de point de terminaison prend en charge de nombreuses EC2 CLI commandes et actions Amazon du AWS SDKs. Pour plus d'informations sur l'installation et la configuration du AWS CLI, notamment pour spécifier les personnes contre lesquelles Régions AWS vous souhaitez passer des AWS CLI appels, consultez le guide de AWS Command Line Interface l'utilisateur.

Liste des AWS CLI commandes EC2 compatibles prises en charge sur un appareil de la gamme Snow

Vous trouverez ci-dessous une description du sous-ensemble de AWS CLI commandes et d'options pour Amazon prises en charge sur EC2 les appareils Snowball Edge. Si une commande ou une option n'est pas répertoriée ci-dessous, elle n'est pas prise en charge. En utilisant une commande, vous pouvez déclarer des options non prises en charge. Cependant, ces options sont ignorées.

  • associate-address – Associe une adresse IP virtuelle à une instance pour utiliser l'une des trois interfaces réseau physiques sur l'appareil:

    • --instance-id – ID d'une instance sbe unique.

    • --public-ip – Adresse IP virtuelle que vous souhaitez utiliser pour accéder à votre instance.

  • attach-volume — Attache un EBS volume Amazon à une instance arrêtée ou en cours d'exécution sur votre appareil et l'expose à l'instance portant le nom d'appareil spécifié.

    • --device value — Le nom de l'appareil.

    • --instance-id — L'ID d'une instance cible compatible avec AmazonEC2.

    • --volume-id value — L'ID du volume. EBS

  • authorize-security-group-egress— Ajoute une ou plusieurs règles de sortie à un groupe de sécurité à utiliser avec un appareil Snowball Edge. Plus précisément, cette action permet aux instances d'envoyer du trafic vers une ou plusieurs plages d'IPv4CIDRadresses de destination. Pour de plus amples informations, veuillez consulter Contrôle du trafic réseau à l'aide de groupes de sécurité sur les appareils de la gamme Snow.

    • --group-id value — L'ID du groupe de sécurité

    • [--ip-permissionsvalue] — Un ou plusieurs ensembles d'autorisations IP.

  • authorize-security-group-ingress— Ajoute une ou plusieurs règles d'entrée à un groupe de sécurité. En appelant authorize-security-group-ingress, vous devez spécifier une valeur pour group-name ou group-id.

    • [--group-namevalue] — Le nom du groupe de sécurité.

    • [--group-idvalue] — L'ID du groupe de sécurité

    • [--ip-permissionsvalue] — Un ou plusieurs ensembles d'autorisations IP.

    • [--protocol value] Protocole IP. Les valeurs possibles sont tcp, udp et icmp. L'argument --port est obligatoire, sauf si la valeur « tous les protocoles » est spécifiée (-1).

    • [--portvalue] — Pour TCP ouUDP, la plage de ports à autoriser. Cette valeur peut être un entier unique ou une plage (minimum—maximum).

      PourICMP, un entier unique ou une plage (type-code) dans laquelle type représente le numéro ICMP de type et code représente le numéro de ICMP code. La valeur -1 indique tous les ICMP codes pour tous les ICMP types. Une valeur de -1 juste pour type indique tous les ICMP codes du ICMP type spécifié.

    • [--cidrvalue] — La plage d'CIDRadresses IP.

  • create-launch-template— Crée un modèle de lancement. Un modèle de lancement contient les paramètres permettant de lancer une instance. Lorsque vous lancez une instance à l'aide de RunInstances, vous pouvez spécifier un modèle de lancement au lieu de fournir des paramètres de lancement dans la demande. Vous pouvez créer jusqu'à 100 modèles par appareil.

    • -- launch-template-name string — Nom du modèle de lancement.

    • -- launch-template-data structure — Les informations relatives au modèle de lancement. Les attributs suivants sont pris en charge :

      • ImageId

      • InstanceType

      • SecurityGroupIds

      • TagSpecifications

      • UserData

      JSONsyntaxe :

      { "ImageId":"string", "InstanceType":"sbe-c.large", "SecurityGroupIds":["string", ...], "TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"Name","Value":"Test"}, {"Key":"Stack","Value":"Gamma"}]}], "UserData":"this is my user data" }
    • [--version-descriptionstring] — Description de la première version du modèle de lancement.

    • --endpoint snowballEndpoint — Valeur qui vous permet de gérer vos instances de calcul par programmation à l'aide d'opérations compatibles avec AmazonEC2. API Pour de plus amples informations, veuillez consulter EC2Spécification du point de terminaison compatible comme point de AWS CLI terminaison sur un appareil Snow Family.

  • create-launch-template-version— Crée une nouvelle version pour un modèle de lancement. Vous pouvez spécifier une version existante d'un modèle de lancement sur laquelle baser la nouvelle version. Les versions de modèle de lancement sont numérotées dans l'ordre de leur création. Vous ne pouvez pas spécifier, modifier ou remplacer la numérotation des versions d'un modèle de lancement. Vous pouvez créer jusqu'à 100 versions de chaque modèle de lancement.

    Spécifiez l'ID ou le nom du modèle de lancement dans la demande.

    • -- launch-template-id string — L'ID du modèle de lancement.

    • -- launch-template-name string — Nom du modèle de lancement.

    • -- launch-template-data structure — Les informations relatives au modèle de lancement. Les attributs suivants sont pris en charge :

      • ImageId

      • InstanceType

      • SecurityGroupIds

      • TagSpecifications

      • UserData

      JSONsyntaxe :

      { "ImageId":"string", "InstanceType":"sbe-c.large", "SecurityGroupIds":["string", ...], "TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"Name","Value":"Test"}, {"Key":"Stack","Value":"Gamma"}]}], "UserData":"this is my user data" }
    • [--source-versionstring] — Numéro de version du modèle de lancement sur lequel baser la nouvelle version. La nouvelle version hérite des mêmes paramètres de lancement que la version source, exception faite des paramètres que vous indiquez dans launch-template-data.

    • [--version-descriptionstring] — Description de la première version du modèle de lancement.

    • --endpoint snowballEndpoint — Valeur qui vous permet de gérer vos instances de calcul par programmation à l'aide d'opérations compatibles avec AmazonEC2. API Pour de plus amples informations, veuillez consulter EC2Spécification du point de terminaison compatible comme point de AWS CLI terminaison sur un appareil Snow Family.

  • create-tags — Ajoute ou remplace une ou plusieurs balises pour la ressource spécifiée. Chaque ressource peut avoir un maximum de 50 balises. Chaque balise est constituée d'une clé et d'une valeur facultative. Les clés de balise doivent être uniques pour une ressource. Les ressources suivantes sont prises en charge :

    • AMI

    • Instance

    • Modèle de lancement

    • Groupe de sécurité

    • Paire de clés

  • create-security-group— Crée un groupe de sécurité sur votre Snowball Edge. Vous pouvez créer jusqu'à 50 groupes de sécurité. Lorsque vous créez un groupe de sécurité, vous spécifiez un nom convivial de votre choix :

    • --group-name value — Le nom du groupe de sécurité.

    • --description value — Description du groupe de sécurité. Cette description est purement informative. La valeur peut contenir jusqu'à 255 caractères.

  • create-volume — Crée un EBS volume Amazon qui peut être attaché à une instance sur votre appareil.

    • [--sizevalue] — La taille du volume en entrée GiBs, qui peut être comprise entre 1 GiB et 1 To ( GiBs1000).

    • [--snapshot-idvalue] — L'instantané à partir duquel créer le volume.

    • [--volume-typevalue] — Type de volume. Si aucune valeur n'est spécifiée, la valeur par défaut est sbg1. Les valeurs possibles sont notamment les suivantes :

      • sbg1 pour les volumes magnétiques

      • sbp1pour les SSD volumes

    • [--tag-specificationvalue] — Liste de balises à appliquer au volume lors de sa création.

  • delete-launch-template— Supprime un modèle de lancement. La suppression d’un modèle de lancement entraîne celle de toutes ses versions.

    Spécifiez l'ID ou le nom du modèle de lancement dans la demande.

  • delete-launch-template-version— Supprime une ou plusieurs versions d'un modèle de lancement. Vous ne pouvez pas supprimer la version par défaut d'un modèle de lancement. Vous devez d'abord attribuer une autre version comme version par défaut. Si la version par défaut est la seule version du modèle de lancement, supprimez la totalité du modèle de lancement à l'aide de la commande delete-launch-template.

    Spécifiez l'ID ou le nom du modèle de lancement dans la demande.

    • -- launch-template-id string — L'ID du modèle de lancement.

    • -- launch-template-name string — Nom du modèle de lancement.

    • --versions (list) "string" "string" — Les numéros de version d'une ou de plusieurs versions du modèle de lancement à supprimer.

    • --endpoint snowballEndpoint — Valeur qui vous permet de gérer vos instances de calcul par programmation à l'aide d'opérations compatibles avec AmazonEC2. API Pour de plus amples informations, veuillez consulter EC2Spécification du point de terminaison compatible comme point de AWS CLI terminaison sur un appareil Snow Family.

  • delete-security-group— Supprime un groupe de sécurité.

    Si vous essayez de supprimer un groupe de sécurité associé à une instance, ou référencé par un autre groupe de sécurité, l'opération échoue avec le message DependencyViolation.

    • --group-name value — Le nom du groupe de sécurité.

    • --description value — Description du groupe de sécurité. Cette description est purement informative. La valeur peut contenir jusqu'à 255 caractères.

  • delete-tags — Supprime l'ensemble de balises spécifié de la ressource spécifiée (instance de calculAMI, modèle de lancement ou groupe de sécurité).

  • delete-volume — Supprime le volume Amazon spécifié. EBS Le volume doit être à l'état available (non attaché à une instance).

    • --volume-id value — L'ID du volume.

  • describe-addresses — Décrit une ou plusieurs de vos adresses IP virtuelles associées au même nombre d'sbeinstances sur votre appareil.

    • --public-ips – Une ou plusieurs des adresses IP virtuelles associées à vos instances.

  • describe-images — Décrit une ou plusieurs des images (AMIs) mises à votre disposition. Les images mises à votre disposition sont ajoutées à l'appareil Snowball Edge lors de la création de la tâche.

    • --image-id — L'identifiant AMI Snowball du. AMI

  • describe-instance-attribute— Décrit l'attribut spécifié de l'instance spécifiée. Vous pouvez spécifier uniquement un attribut à la fois. Les attributs suivants sont pris en charge :

    • instanceInitiatedShutdownBehavior

    • instanceType

    • userData

  • describe-instances – Décrire une ou plusieurs de vos instances. La réponse retourne tous les groupes de sécurité qui sont attribués aux instances.

    • --instance-ids — Le nom IDs d'une ou de plusieurs sbe instances qui ont été arrêtées sur le périphérique.

    • --page-size — La taille de chaque page à inclure dans l'appel. Cette valeur n'affecte pas le nombre d'éléments renvoyés dans la sortie de la commande. La définition d'une taille de page plus petite entraîne davantage d'appels à l'appareil, et la récupération de moins d'éléments dans chaque appel. Cette opération peut empêcher l'expiration des appels.

    • --max-items — Le nombre total d'éléments à renvoyer dans la sortie de la commande. Si le nombre total d'éléments disponibles est supérieur à la valeur spécifiée, le jeton NextToken est fourni dans la sortie de la commande. Pour reprendre la pagination, fournissez la valeur de NextToken dans l'argument starting-token d'une commande suivante.

    • --starting-token — Un jeton pour spécifier où commencer la pagination. Il s'agit de la valeur NextToken provenant d'une réponse tronquée précédemment.

  • describe-instance-status— Décrit le statut des instances spécifiées ou de toutes vos instances. Par défaut, seules les instances en cours d'exécution sont décrites, sauf si vous indiquez spécifiquement de renvoyer le statut de toutes les instances. Le statut de l'instance inclut les éléments suivants :

    • Contrôles d'état — L'appareil Snow vérifie l'état des instances EC2 compatibles Amazon en cours d'exécution afin d'identifier les problèmes matériels et logiciels.

    • État de l'instance : vous pouvez gérer vos instances à partir du moment où vous les lancez et jusqu'à leur résiliation.

    Avec cette commande, les filtres suivants sont pris en charge.

    • [--filters](liste)

      Les filtres.

      • instance-state-code— Le code de l'état de l'instance, sous la forme d'un entier non signé de 16 bits. L'octet haut est utilisé à des fins de reporting des services internes et doit être ignoré. L'octet faible est défini en fonction de l'état représenté. Les valeurs valides sont 0 (en attente), 16 (en cours), 32 (arrêt), 48 (arrêt), 64 (arrêt) et 80 (arrêt).

      • instance-state-name— État de l'instance (pending| running | shutting-down | terminated | stopping |stopped).

      • instance-status.reachability— Filtre le statut de l'instance dont le nom est reachability (passed| failed | initializing |insufficient-data).

      • instance-status.status— Le statut de l'instance (ok| impaired | initializing | insufficient-data |not-applicable).

      • system-status.reachability— Filtre l'état du système lorsque le nom est joignable (passed| | failed initializing |insufficient-data).

      • system-status.status— État du système de l'instance (ok| impaired | initializing | insufficient-data |not-applicable).

    • JSONSyntaxe :

      [ { "Name": "string", "Values": ["string", ...] } ... ]
    • [--instance-ids](liste)

      L'instanceIDs.

      Par défaut : décrit toutes vos instances.

    • [--dry-run|--no-dry-run](booléen)

      Vérifie si vous disposez des autorisations requises pour l'action, sans réellement faire la demande, et fournit une réponse d'erreur. Si vous disposez des autorisations requises, la réponse d'erreur estDryRunOperation.

      Sinon, la valeur est UnauthorizedOperation.

    • [--include-all-instances | --no-include-all-instances](booléen)

      Quandtrue, inclut l'état de santé de toutes les instances. Quandfalse, inclut l'état de santé des instances en cours d'exécution uniquement.

      Par défaut : false

    • [--page-size](entier) — La taille de chaque page à inclure dans l'appel. Cette valeur n'affecte pas le nombre d'éléments renvoyés dans la sortie de la commande. La définition d'une taille de page plus petite entraîne davantage d'appels à l'appareil, et la récupération de moins d'éléments dans chaque appel. Cette opération peut empêcher l'expiration des appels.

    • [--max-items](entier) — Le nombre total d'éléments à renvoyer dans la sortie de la commande. Si le nombre total d'éléments disponibles est supérieur à la valeur spécifiée, le jeton NextToken est fourni dans la sortie de la commande. Pour reprendre la pagination, fournissez la valeur de NextToken dans l'argument starting-token d'une commande suivante.

    • [--starting-token](string) — Un jeton pour spécifier où commencer la pagination. Il s'agit de la valeur NextToken provenant d'une réponse tronquée précédemment.

  • describe-launch-templates— Décrit un ou plusieurs modèles de lancement. La commande describe-launch-templates est une opération paginée. Vous pouvez effectuer plusieurs appels d'API pour récupérer l'ensemble de données complet des résultats.

    Spécifiez le modèle de lancement IDs ou les noms des modèles de lancement dans la demande.

    • -- launch-template-ids (list) "string" "string" — Liste IDs des modèles de lancement.

    • -- launch-template-names (list) "string" "string" — Liste des noms des modèles de lancement.

    • --page-size — La taille de chaque page à inclure dans l'appel. Cette valeur n'affecte pas le nombre d'éléments renvoyés dans la sortie de la commande. La définition d'une taille de page plus petite entraîne davantage d'appels à l'appareil, et la récupération de moins d'éléments dans chaque appel. Cette opération peut empêcher l'expiration des appels.

    • --max-items — Le nombre total d'éléments à renvoyer dans la sortie de la commande. Si le nombre total d'éléments disponibles est supérieur à la valeur spécifiée, le jeton NextToken est fourni dans la sortie de la commande. Pour reprendre la pagination, fournissez la valeur de NextToken dans l'argument starting-token d'une commande suivante.

    • --starting-token — Un jeton pour spécifier où commencer la pagination. Il s'agit de la valeur NextToken provenant d'une réponse tronquée précédemment.

    • --endpoint snowballEndpoint — Valeur qui vous permet de gérer vos instances de calcul par programmation à l'aide d'opérations compatibles avec AmazonEC2. API Pour de plus amples informations, veuillez consulter EC2Spécification du point de terminaison compatible comme point de AWS CLI terminaison sur un appareil Snow Family.

  • describe-launch-template-versions— Décrit une ou plusieurs versions d'un modèle de lancement spécifié. Vous pouvez décrire toutes les versions, des versions individuelles ou une plage de versions. La commande describe-launch-template-versions est une opération paginée. Vous pouvez effectuer plusieurs appels d'API pour récupérer l'ensemble de données complet des résultats.

    Spécifiez le modèle de lancement IDs ou les noms des modèles de lancement dans la demande.

    • -- launch-template-id string — L'ID du modèle de lancement.

    • -- launch-template-name string — Nom du modèle de lancement.

    • [--versions (list)"string" "string"] — Les numéros de version d'une ou de plusieurs versions du modèle de lancement à supprimer.

    • [--min-versionstring] — Numéro de version après lequel décrire les versions des modèles de lancement.

    • [--max-versionstring] — Numéro de version jusqu'auquel décrire les versions des modèles de lancement.

    • --page-size — La taille de chaque page à inclure dans l'appel. Cette valeur n'affecte pas le nombre d'éléments renvoyés dans la sortie de la commande. La définition d'une taille de page plus petite entraîne davantage d'appels à l'appareil, et la récupération de moins d'éléments dans chaque appel. Cette opération peut empêcher l'expiration des appels.

    • --max-items — Le nombre total d'éléments à renvoyer dans la sortie de la commande. Si le nombre total d'éléments disponibles est supérieur à la valeur spécifiée, le jeton NextToken est fourni dans la sortie de la commande. Pour reprendre la pagination, fournissez la valeur de NextToken dans l'argument starting-token d'une commande suivante.

    • --starting-token — Un jeton pour spécifier où commencer la pagination. Il s'agit de la valeur NextToken provenant d'une réponse tronquée précédemment.

    • --endpoint snowballEndpoint — Valeur qui vous permet de gérer vos instances de calcul par programmation à l'aide d'opérations compatibles avec AmazonEC2. API Pour de plus amples informations, veuillez consulter EC2Spécification du point de terminaison compatible comme point de AWS CLI terminaison sur un appareil Snow Family.

  • describe-security-groups— Décrit un ou plusieurs de vos groupes de sécurité.

    La commande describe-security-groups est une opération paginée. Vous pouvez émettre plusieurs API appels pour récupérer l'ensemble de données de résultats.

    • [--group-namevalue] — Le nom du groupe de sécurité.

    • [--group-idvalue] — L'ID du groupe de sécurité.

    • [--page-sizevalue] — Taille de chaque page à inclure dans l' AWS appel de service. Cette taille n'affecte pas le nombre d'éléments renvoyés dans la sortie de la commande. La définition d'une taille de page plus petite entraîne un plus grand nombre d'appels vers le AWS service, ce qui permet de récupérer moins d'éléments à chaque appel. Cette approche peut aider à éviter que les appels de AWS service ne soient dépassés. Pour des exemples d'utilisation, voir Pagination dans le guide de l'AWS Command Line Interface utilisateur.

    • [--max-itemsvalue] — Le nombre total d'éléments à renvoyer dans la sortie de la commande. Si le nombre total d'éléments disponibles est supérieur à la valeur spécifiée, le jeton NextToken est fourni dans la sortie de la commande. Pour reprendre la pagination, fournissez la valeur de NextToken dans l'argument starting-token d'une commande suivante. N'utilisez pas l'élément de NextToken réponse directement en dehors du AWS CLI. Pour des exemples d'utilisation, voir Pagination dans le guide de l'AWS Command Line Interface utilisateur.

    • [--starting-tokenvalue] — Un jeton pour spécifier où commencer la pagination. Il s'agit de la valeur NextToken provenant d'une réponse tronquée précédemment. Pour des exemples d'utilisation, voir Pagination dans le guide de l'AWS Command Line Interface utilisateur.

  • describe-tags — Décrit une ou plusieurs balises pour une ressource spécifiée (image,instance, ou un groupe de sécurité). Avec cette commande, les filtres suivants sont pris en charge :

    • launch-template

    • resource-id

    • resource-type – image ou instance

    • clé

    • value

  • describe-volumes — Décrit les volumes Amazon EBS spécifiés.

    • [--max-itemsvalue] — Le nombre total d'éléments à renvoyer dans la sortie de la commande. Si le nombre total d'éléments disponibles est supérieur à la valeur spécifiée, le jeton NextToken est fourni dans la sortie de la commande. Pour reprendre la pagination, fournissez la valeur de NextToken dans l'argument starting-token d'une commande suivante.

    • [--starting-tokenvalue] — Un jeton pour spécifier où commencer la pagination. Il s'agit de la valeur NextToken provenant d'une réponse tronquée précédemment.

    • [--volume-idsvalue] — Un ou plusieurs volumes. IDs

  • detach-volume — Détache un volume EBS Amazon d'une instance arrêtée ou en cours d'exécution.

    • [--devicevalue] — Nom de l'appareil.

    • [--instance-id] — L'ID d'une instance Amazon cible. EC2

    • --volume-id value — L'ID du volume.

  • disassociate-address – Dissocie une adresse IP virtuelle de l'instance à laquelle elle est associée.

    • --public-ip — L'adresse IP virtuelle que vous souhaitez dissocier de votre instance.

  • get-launch-template-data— Récupère les données de configuration de l'instance spécifiée. Vous pouvez utiliser ces données pour créer un modèle de lancement.

  • modify-launch-template— Modifie un modèle de lancement. Vous pouvez spécifier la version du modèle de lancement à définir comme version par défaut. Lorsque vous lancez une instance sans spécifier une version de modèle de lancement, la version par défaut du modèle de lancement s'applique.

    Spécifiez l'ID ou le nom du modèle de lancement dans la demande.

    • -- launch-template-id string — L'ID du modèle de lancement.

    • -- launch-template-name string — Nom du modèle de lancement.

    • --default-version string — Le numéro de version du modèle de lancement à définir comme version par défaut.

    • --endpoint snowballEndpoint — Valeur qui vous permet de gérer vos instances de calcul par programmation à l'aide d'opérations compatibles avec AmazonEC2. API Pour de plus amples informations, veuillez consulter EC2Spécification du point de terminaison compatible comme point de AWS CLI terminaison sur un appareil Snow Family.

  • modify-instance-attribute— Modifie un attribut de l'instance spécifiée. Les attributs suivants sont pris en charge :

    • instanceInitiatedShutdownBehavior

    • userData

  • revoke-security-group-egress— Supprime une ou plusieurs règles de sortie d'un groupe de sécurité :

    • [--group-idvalue] — L'ID du groupe de sécurité

    • [--ip-permissionsvalue] — Un ou plusieurs ensembles d'autorisations IP.

  • revoke-security-group-ingress— Révoque une ou plusieurs règles d'entrée d'un groupe de sécurité. En appelant revoke-security-group-ingress, vous devez spécifier une valeur pour group-name ou group-id.

    • [--group-namevalue] — Le nom du groupe de sécurité.

    • [--group-idvalue] — L'ID du groupe de sécurité.

    • [--ip-permissionsvalue] — Un ou plusieurs ensembles d'autorisations IP.

    • [--protocol value] Protocole IP. Les valeurs possibles sont tcp, udp et icmp. L'argument --port est obligatoire, sauf si la valeur « tous les protocoles » est spécifiée (-1).

    • [--portvalue] — Pour TCP ouUDP, la plage de ports à autoriser. Un entier unique ou une plage (minimum—maximum).

      PourICMP, un entier unique ou une plage (type-code) dans laquelle type représente le numéro ICMP de type et code représente le numéro de ICMP code. La valeur -1 indique tous les ICMP codes pour tous les ICMP types. Une valeur de -1 juste pour type indique tous les ICMP codes du ICMP type spécifié.

    • [--cidrvalue] — La plage d'CIDRadresses IP.

  • run-instances — Lance un certain nombre d'instances de calcul en utilisant un identifiant Snowball AMI pour un. AMI

    Note

    Le lancement d'une instance de calcul sur un Snowball Edge peut prendre jusqu'à une heure et demie, selon la taille et le type de l'instance.

    • [-- block-device-mappings (list)] — Bloquer les entrées de mappage des périphériques. Les paramètres DeleteOnTermination, VolumeSize et VolumeType sont pris en charge. Les volumes de démarrage doivent être de type sbg1.

      La JSON syntaxe de cette commande est la suivante.

      { "DeviceName": "/dev/sdh", "Ebs": { "DeleteOnTermination": true|false, "VolumeSize": 100, "VolumeType": "sbp1"|"sbg1" } }
    • --count — Nombre d'instances à lancer. Si un nombre unique est fourni, il est supposé correspondre au nombre minimum d'instances à lancer (1 par défaut). Si une plage est fournie sous la forme min:max, le premier nombre est interprété comme le nombre minimal d'instances à lancer et le deuxième, comme le nombre maximal d'instances à lancer.

    • --image-id — L'identifiant Snowball AMI duAMI, que vous pouvez obtenir en appelant. describe-images Un AMI est requis pour lancer une instance.

    • -- InstanceInitiatedShutdownBehavior — Par défaut, lorsque vous initiez un arrêt depuis votre instance (à l'aide d'une commande telle que shutdown ou poweroff), l'instance s'arrête. Vous pouvez modifier ce comportement pour que l’instance prenne fin. Les paramètres stop et terminate sont pris en charge. L’argument par défaut est stop. Pour plus d'informations, consultez la section Modification du comportement d'arrêt initié par une instance dans le Guide de EC2 l'utilisateur Amazon pour les instances Linux.

    • --instance-type – Le type d'instance sbe.

    • --launch-template structure — Le modèle de lancement à utiliser pour lancer les instances. Les paramètres que vous spécifiez dans la commande run-instances remplacent les paramètres correspondants dans le modèle de lancement. Vous pouvez spécifier le nom ou l'ID d'un modèle de lancement, mais pas les deux.

      { "LaunchTemplateId": "string", "LaunchTemplateName": "string", "Version": "string" }
    • -- security-group-ids — Un ou plusieurs groupes de sécuritéIDs. Vous pouvez créer un groupe de sécurité à l'aide de CreateSecurityGroup. Si aucune valeur n'est fournie, l'ID du groupe de sécurité par défaut est assigné aux instances créées.

    • --tag-specifications — Les balises à appliquer aux ressources lors du lancement. Vous pouvez baliser les instances uniquement au lancement. Les balises spécifiées sont appliquées à toutes les instances qui sont créés lors du lancement. Pour baliser une ressource après sa création, utilisez create-tags.

    • --user-data — Les données utilisateur à mettre à la disposition de l'instance. Si vous utilisez le AWS CLI, le codage en base64 est effectué pour vous et vous pouvez charger le texte à partir d'un fichier. Dans le cas contraire, vous devez fournir un texte codé en base64.

    • --key-name (string) — Le nom de la paire de clés. Vous pouvez créer une paire de clés à l'aide de CreateKeyPair ouImportKeyPair.

      Avertissement

      Si vous ne spécifiez pas de paire de clés, vous ne pouvez pas vous connecter à l'instance, sauf si vous en choisissez une AMI configurée pour permettre aux utilisateurs de se connecter d'une autre manière.

  • start-instances — Démarre une sbe instance que vous avez précédemment arrêtée. Toutes les ressources attachées à l'instance sont conservées lors des démarrages et des arrêts, mais elles sont effacées si l'instance est résiliée.

    • --instance-ids — Le nom IDs d'une ou de plusieurs sbe instances qui ont été arrêtées sur le périphérique.

  • stop-instances — Arrête une sbe instance en cours d'exécution. Toutes les ressources attachées à l'instance sont conservées lors des démarrages et des arrêts, mais elles sont effacées si l'instance est résiliée.

    • --instance-ids — Le nom IDs d'une ou de plusieurs sbe instances à arrêter sur le périphérique.

  • terminate-instances : arrête une ou plusieurs instances. Cette opération est idempotente ; si vous résiliez une instance plusieurs fois, chaque appel réussit. Toutes les ressources attachées à l'instance sont conservées lors des démarrages et des arrêts, mais les données sont effacées si l'instance est résiliée.

    Note

    Par défaut, lorsque vous utilisez une commande comme shutdown ou poweroff pour lancer un arrêt à partir de votre instance, l'instance s'arrête. Toutefois, vous pouvez utiliser l'InstanceInitiatedShutdownBehaviorattribut pour modifier ce comportement afin que ces commandes mettent fin à votre instance. Pour plus d'informations, consultez la section Modification du comportement d'arrêt initié par une instance dans le Guide de EC2 l'utilisateur Amazon pour les instances Linux.

    • --instance-ids — Le nom IDs d'une ou de plusieurs sbe instances à arrêter sur le périphérique. Toutes les données associées stockées pour ces instances seront perdues.

  • create-key-pair— Crée une paire de RSA clés de 2 048 bits portant le nom spécifié. Amazon EC2 stocke la clé publique et affiche la clé privée pour que vous puissiez l'enregistrer dans un fichier. La clé privée est renvoyée sous la forme d'une clé privée PKCS #1 non cryptée et PEM codée. Si une clé portant le nom spécifié existe déjà, Amazon EC2 renvoie un message d'erreur.

    • --key-name (string) — Nom unique pour la paire de clés.

      Contraintes : 255 ASCII caractères maximum.

    • [--tag-specifications] (list) — Les balises à appliquer à la nouvelle paire de clés.

    { "ResourceType": "image"|"instance"|"key-pair"|"launch-template"|"security-group", "Tags": [ { "Key": "string", "Value": "string" } ... ] } ...
  • import-key-pair

    • --key-name (string) — Nom unique pour la paire de clés.

      Contraintes : 255 ASCII caractères maximum.

    • -- public-key-material (blob) — La clé publique. Pour les API appels, le texte doit être codé en base64. Pour les outils de ligne de commande, le codage en base64 est effectué pour vous.

    • [--tag-specifications] (list) — Les balises à appliquer à la nouvelle paire de clés.

    { "ResourceType": "image"|"instance"|"key-pair"|"launch-template"|"security-group", "Tags": [ { "Key": "string", "Value": "string" } ... ] }
  • describe-key-pairs

    [--filters] (list) — Les filtres.

    • key-pair-id — L'ID de la paire de clés.

    • key-name — Le nom de la paire de clés.

    • tag-key — La clé d'un tag attribué à la ressource. Utilisez ce filtre pour rechercher toutes les ressources associées à une balise avec une clé spécifique, quelle que soit la valeur de la balise.

    • [--tag-specifications] (list) — Les balises à appliquer à la nouvelle paire de clés.

    • tag:key — Combinaison clé/valeur d'une balise attribuée à la ressource. Utilisez la clé de balise dans le nom du filtre et la valeur de la balise comme valeur de filtre. Par exemple, pour rechercher toutes les ressources qui ont une balise avec la clé Owner et la valeur Team A, spécifiez tag:Owner pour le nom du filtre et Team A pour la valeur du filtre.

    { "Name": "string", "Values": ["string", ...] } ...
  • [--key-names] (list) — Les noms des paires de clés.

    Par défaut : décrit toutes vos paires de clés.

  • [--key-pair-ids] (list) — La paire IDs de clés.

  • delete-key-pair

    • [--key-name] (string) — Le nom de la paire de clés.

    • [--key-pair-id] (string) — L'ID de la paire de clés.

APIOpérations EC2 compatibles avec Amazon prises en charge sur un appareil Snow Family

Vous trouverez ci-dessous des API opérations EC2 compatibles avec Amazon que vous pouvez utiliser avec un Snowball Edge, avec des liens vers leurs descriptions dans la référence Amazon EC2 API.Les API appels EC2 compatibles avec Amazon nécessitent une signature Signature Version 4 (SigV4). Si vous utilisez le AWS CLI ou an AWS SDK pour passer ces API appels, la signature SigV4 est gérée pour vous. Sinon, vous devez implémenter votre propre solution de signature SigV4. Pour de plus amples informations, veuillez consulter Obtenir et utiliser les informations d'identification Amazon S3 locales sur les appareils Snow Family.

  • AssociateAddress— Associe une adresse IP élastique à une instance ou à une interface réseau.

  • AttachVolume— Les paramètres de demande suivants sont pris en charge :

    • Device

    • InstanceId

    • VolumeId

  • AuthorizeSecurityGroupEgress— Ajoute une ou plusieurs règles de sortie à un groupe de sécurité à utiliser avec un appareil Snowball Edge. Plus précisément, cette action permet aux instances d'envoyer du trafic vers une ou plusieurs plages d'IPv4CIDRadresses de destination.

  • AuthorizeSecurityGroupIngress— Ajoute une ou plusieurs règles d'entrée à un groupe de sécurité. Lorsque vous appelez AuthorizeSecurityGroupIngress, vous devez spécifier une valeur pour GroupName ouGroupId.

  • CreateVolume— Les paramètres de demande suivants sont pris en charge :

    • SnapshotId

    • Size

    • VolumeType

    • TagSpecification.N

  • CreateLaunchTemplate— Les paramètres de demande suivants sont pris en charge :

    • ImageId

    • InstanceType

    • SecurityGroupIds

    • TagSpecifications

    • UserData

  • CreateLaunchTemplateVersion

  • CreateTags— Les paramètres de demande suivants sont pris en charge :

    • AMI

    • Instance

    • Launch template

    • Security group

  • CreateSecurityGroup— Crée un groupe de sécurité sur votre Snowball Edge. Vous pouvez créer jusqu'à 50 groupes de sécurité. Lorsque vous créez un groupe de sécurité, vous spécifiez un nom convivial de votre choix.

  • DeleteLaunchTemplate

  • DeleteLaunchTemplateVersions

  • DeleteSecurityGroup— Supprime un groupe de sécurité. Si vous essayez de supprimer un groupe de sécurité associé à une instance, ou référencé par un autre groupe de sécurité, l'opération échoue avec le message DependencyViolation.

  • DeleteTags— Supprime le jeu de balises spécifié de l'ensemble de ressources spécifié.

  • DeleteVolume— Les paramètres de demande suivants sont pris en charge :

    • VolumeId

  • DescribeAddresses

  • DescribeImages

  • DescribeInstanceAttribute— Les attributs suivants sont pris en charge :

    • instanceType

    • userData

  • DescribeInstanceStatus

  • DescribeLaunchTemplates

  • DescribeLaunchTemplateVersions

  • DescribeInstances

  • DescribeSecurityGroups— Décrit un ou plusieurs de vos groupes de sécurité. DescribeSecurityGroupsest une opération paginée. Vous pouvez émettre plusieurs API appels pour récupérer l'ensemble de données de résultats.

  • DescribeTags— Avec cette commande, les filtres suivants sont pris en charge :

    • resource-id

    • resource-type— AMI ou instance de calcul uniquement

    • key

    • value

  • DescribeVolume— Les paramètres de demande suivants sont pris en charge :

    • MaxResults

    • NextToken

    • VolumeId.N

  • DetachVolume— Les paramètres de demande suivants sont pris en charge :

    • Device

    • InstanceId

    • VolumeId

  • DisassociateAddress

  • GetLaunchTemplateData

  • ModifyLaunchTemplate

  • ModifyInstanceAttribute— Seul l'userDataattribut est pris en charge.

  • RevokeSecurityGroupEgress— Supprime une ou plusieurs règles de sortie d'un groupe de sécurité.

  • RevokeSecurityGroupIngress— Révoque une ou plusieurs règles d'entrée d'un groupe de sécurité. Lorsque vous appelez RevokeSecurityGroupIngress, vous devez spécifier une valeur pour group-name ougroup-id.

  • RunInstances

    Note

    Le lancement d'une instance de calcul sur un Snowball Edge peut prendre jusqu'à une heure et demie, selon la taille et le type de l'instance.

  • StartInstances

  • StopInstances— Les ressources associées à une instance arrêtée persistent. Vous pouvez résilier l'instance afin de libérer ces ressources. Toutefois, toutes les données associées sont supprimées.

  • TerminateInstances