Utilisation d’AWS Snow Device Management afin de gérer des appareils - AWS Snowcone Guide de l'utilisateur

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 d’AWS Snow Device Management afin de gérer des appareils

AWS Snow Device Managementvous permet de gérer à distance votre appareil Snow Family et les AWS services locaux. Tous les appareils Snow Family prennent en charge la gestion des appareils Snow, qui est installée sur les nouveaux appareils de Régions AWS la plupart des appareils Snow Family disponibles.

Avec Snow Device Management, vous pouvez effectuer les tâches suivantes :

  • Création d'une tâche

  • Vérifier l'état de la tâche

  • Vérifier les métadonnées des tâches

  • Annuler une tâche

  • Vérifiez les informations de l'appareil

  • Vérifiez l'état de l'instance compatible avec Amazon EC2

  • Commandes de liste et syntaxe

  • Répertorier les appareils administrables à distance

  • Répertorier l'état des tâches sur les appareils

  • Liste des ressources disponibles

  • Répertorier les tâches par statut

  • Répertorier les tags des appareils ou des tâches

  • Appliquer des balises

  • Supprimer les tags

Choix de l'état de gestion des appareils Snow lors de la commande d'un appareil Snow Family

Lorsque vous créez une tâche pour commander un appareil Snow, vous pouvez choisir dans quel état se trouvera Snow Device Management lorsque vous recevrez l'appareil : installé mais non activé ou installé et activé. S'il est installé mais qu'il n'est pas activé, vous devrez utiliser AWS OpsHub le client Snowball Edge pour l'activer avant de l'utiliser. S'il est installé et activé, vous pouvez utiliser Snow Device Management après avoir reçu l'appareil et l'avoir connecté à votre réseau local. Vous pouvez choisir l'état Snow Device Management lors de la création d'une tâche pour commander un appareil via le client Snowball EdgeAWS Snow Family Management Console, l'API de gestion des tâches ou l'AWS CLIAPI de gestion des tâches Snow.

Pour choisir l'état Snow Device Management dans AWS Snow Family Management Console
  1. Pour choisir d'installer et d'activer Snow Device Management, choisissez Gérer votre appareil Snow à distance avec AWS OpsHub ou avec le client Snowball.

  2. Pour choisir d'installer Snow Device Management mais de ne pas l'activer, ne sélectionnez pas Gérer votre appareil Snow à distance avec AWS OpsHub le client Snowball.

Pour plus d'informations, voir Étape 3 : Choisissez vos fonctionnalités et options dans ce guide.

Pour choisir l'état Snow Device Management depuis le AWS CLI client Snowball Edge ou l'API de gestion des tâches Snow, procédez comme suit :
  • Utilisez le remote-management paramètre pour spécifier l'état de Snow Device Management. La INSTALLED_ONLY valeur du paramètre signifie que Snow Device Management est installé mais n'est pas activé. La INSTALLED_AUTOSTART valeur du paramètre signifie que Snow Device Management est installé et activé. Si vous ne spécifiez aucune valeur pour ce paramètre, INSTALLED_ONLY c'est la valeur par défaut.

Exemple de la syntaxe du remote-management paramètre de la create-job commande
aws snowball create-job \ --job-type IMPORT \ --remote-management INSTALLED_AUTOSTART --device-configuration '{"SnowconeDeviceConfiguration": {"WirelessConnection": {"IsWifiEnabled": false} } }' \ --resources '{"S3Resources":[{"BucketArn":"arn:aws:s3:::bucket-name"}]}' \ --description "Description here" \ --address-id ADID00000000-0000-0000-0000-000000000000 \ --kms-key-arn arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab \ --role-arn arn:aws:iam::000000000000:role/SnowconeImportGamma \ --snowball-capacity-preference T8 \ --shipping-option NEXT_DAY \ --snowball-type SNC1_HDD \ --region us-west-2 \

Pour plus d'informations, consultez la section Référence de l'API Job Management dans la Référence des AWS Snowball API.

Activation de la gestion des appareils Snow

Suivez cette procédure pour activer Snow Device Management à l'aide du client Snowball Edge.

Avant d'utiliser cette procédure, procédez comme suit :

snowballEdge set-features / --remote-management-state INSTALLED_AUTOSTART / --manifest-file JID1717d8cc-2dc9-4e68-aa46-63a3ad7927d2_manifest.bin / --unlock-code 7c0e1-bab84-f7675-0a2b6-f8k33 / --endpoint https://192.0.2.0:9091

Le client Snowball Edge renvoie ce qui suit lorsque la commande aboutit.

{ "RemoteManagementState" : "INSTALLED_AUTOSTART" }

Ajouter des autorisations pour Snow Device Management à un rôle IAM

Sur le périphérique Compte AWS à partir duquel l'appareil a été commandé, créez un rôle AWS Identity and Access Management (IAM) et ajoutez-y la politique suivante. Attribuez ensuite le rôle à l'utilisateur IAM qui se connectera pour gérer à distance votre appareil avec Snow Device Management. Pour plus d'informations, consultez les sections Création de rôles IAM et Création d'un utilisateur IAM dans votre. Compte AWS

Stratégie

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "snow-device-management:ListDevices", "snow-device-management:DescribeDevice", "snow-device-management:DescribeDeviceEc2Instances", "snow-device-management:ListDeviceResources", "snow-device-management:CreateTask", "snow-device-management:ListTasks", "snow-device-management:DescribeTask", "snow-device-management:CancelTask", "snow-device-management:DescribeExecution", "snow-device-management:ListExecutions", "snow-device-management:ListTagsForResource", "snow-device-management:TagResource", "snow-device-management:UntagResource" ], "Resource": "*" } ] }

Commandes de la CLI Snow Device Management

Cette section décrit les AWS CLI commandes que vous pouvez utiliser pour gérer vos appareils de la gamme Snow à distance avec Snow Device Management. Vous pouvez également effectuer certaines tâches de gestion à distance à l'aide deAWS OpsHub for Snow Family. Pour plus d'informations, voir Gestion AWS des services sur votre appareil .

Note

Avant de gérer votre appareil, assurez-vous qu'il est allumé, connecté à votre réseau et qu'il peut se connecter à l'Région AWSendroit où il a été configuré.

Création d'une tâche

Pour demander à un ou plusieurs équipements cibles d'effectuer une tâche, telle que le déverrouillage ou le redémarrage, utilisez. create-task Vous spécifiez les équipements cibles en fournissant une liste des identifiants des appareils gérés avec le --targets paramètre et en spécifiant les tâches à effectuer avec le --command paramètre. Une seule commande peut être exécutée sur un appareil à la fois.

Commandes prises en charge :

  • unlock(aucun argument)

  • reboot(aucun argument)

Pour créer une tâche à exécuter par les équipements cibles, utilisez la commande suivante. Remplacez chaque user input placeholder par vos propres informations.

Commande

aws snow-device-management create-task --targets smd-fictbgr3rbcjeqa5 --command reboot={}

Exceptions

ValidationException ResourceNotFoundException InternalServerException ThrottlingException AccessDeniedException ServiceQuotaExceededException

Sortie

{ "taskId": "st-ficthmqoc2pht111", "taskArn": "arn:aws:snow-device-management:us-west-2:000000000000:task/st-cjkwhmqoc2pht111" }

Vérifier l'état de la tâche

Pour vérifier l'état d'une tâche distante exécutée sur une ou plusieurs machines cibles, utilisez la describe-execution commande.

Une tâche peut avoir l'un des états suivants :

  • QUEUED

  • IN_PROGRESS

  • CANCELED

  • FAILED

  • COMPLETED

  • REJECTED

  • TIMED_OUT

Pour vérifier l'état d'une tâche, utilisez la commande suivante. Remplacez chaque user input placeholder par vos propres informations.

Commande

aws snow-device-management describe-execution \ --taskId st-ficthmqoc2phtlef \ --managed-device-id smd-fictqic6gcldf111

Sortie

{ "executionId": "1", "lastUpdatedAt": "2021-07-22T15:29:44.110000+00:00", "managedDeviceId": "smd-fictqic6gcldf111", "startedAt": "2021-07-22T15:28:53.947000+00:00", "state": "SUCCEEDED", "taskId": "st-ficthmqoc2pht111" }

Vérifiez les informations de l'appareil

Pour vérifier les informations spécifiques à l'appareil, telles que le type d'appareil, la version du logiciel, les adresses IP et l'état du verrouillage, utilisez la describe-device commande. La sortie inclut également les éléments suivants :

  • lastReachedOutAt— La dernière fois que l'appareil a contacté leAWS Cloud. Indique que l'appareil est en ligne.

  • lastUpdatedAt— Quand les données ont été mises à jour pour la dernière fois sur l'appareil. Indique à quel moment le cache de l'appareil a été actualisé.

Pour vérifier les informations de l'appareil, utilisez la commande suivante. Remplacez chaque user input placeholder par vos propres informations.

Commande

aws snow-device-management describe-device \ --managed-device-id smd-fictqic6gcldf111

Exceptions

ValidationException ResourceNotFoundException InternalServerException ThrottlingException AccessDeniedException

Sortie

{ "associatedWithJob": "JID2bf11d5a-ea1e-414a-b5b1-3bf7e6a6e111", "deviceCapacities": [ { "available": 158892032000, "name": "HDD Storage", "total": 158892032000, "unit": "Byte", "used": 0 }, { "available": 0, "name": "SSD Storage", "total": 0, "unit": "Byte", "used": 0 }, { "available": 3, "name": "vCPU", "total": 3, "unit": "Number", "used": 0 }, { "available": 5368709120, "name": "Memory", "total": 5368709120, "unit": "Byte", "used": 0 }, { "available": 0, "name": "GPU", "total": 0, "unit": "Number", "used": 0 } ], "deviceState": "UNLOCKED", "deviceType": "SNC1_HDD", "lastReachedOutAt": "2021-07-23T21:21:56.120000+00:00", "lastUpdatedAt": "2021-07-23T21:21:56.120000+00:00", "managedDeviceId": "smd-fictqic6gcldf111", "managedDeviceArn": "arn:aws:snow-device-management:us-west-2:000000000000:managed-device/smd-fictqic6gcldf111" "physicalNetworkInterfaces": [ { "defaultGateway": "10.0.0.1", "ipAddress": "10.0.0.2", "ipAddressAssignment": "DHCP", "macAddress": "ab:cd:ef:12:34:56", "netmask": "255.255.252.0", "physicalConnectorType": "RJ45", "physicalNetworkInterfaceId": "s.ni-530f866d526d4b111" }, { "defaultGateway": "10.0.0.1", "ipAddress": "0.0.0.0", "ipAddressAssignment": "STATIC", "macAddress": "ab:cd:ef:12:34:57", "netmask": "0.0.0.0", "physicalConnectorType": "RJ45", "physicalNetworkInterfaceId": "s.ni-8abc787f0a6750111" } ], "software": { "installState": "NA", "installedVersion": "122", "installingVersion": "NA" }, "tags": { "Project": "PrototypeA" } }

Vérifiez l'état de l'instance compatible avec Amazon EC2

Pour vérifier l'état actuel de l'instance Amazon EC2, utilisez la describe-ec2-instances commande. Le résultat est similaire à celui de la describe-device commande, mais les résultats proviennent du cache du périphérique dans le AWS Cloud et incluent un sous-ensemble des champs disponibles.

Pour vérifier l'état de l'instance compatible Amazon EC2, utilisez la commande suivante. Remplacez chaque user input placeholder par vos propres informations.

Commande

aws snow-device-management describe-device-ec2-instances \ --managed-device-id smd-fictbgr3rbcje111 \ --instance-ids s.i-84fa8a27d3e15e111

Exceptions

ValidationException ResourceNotFoundException InternalServerException ThrottlingException AccessDeniedException

Sortie

{ "instances": [ { "instance": { "amiLaunchIndex": 0, "blockDeviceMappings": [ { "deviceName": "/dev/sda", "ebs": { "attachTime": "2021-07-23T15:25:38.719000-07:00", "deleteOnTermination": true, "status": "ATTACHED", "volumeId": "s.vol-84fa8a27d3e15e111" } } ], "cpuOptions": { "coreCount": 1, "threadsPerCore": 1 }, "createdAt": "2021-07-23T15:23:22.858000-07:00", "imageId": "s.ami-03f976c3cadaa6111", "instanceId": "s.i-84fa8a27d3e15e111", "state": { "name": "RUNNING" }, "instanceType": "snc1.micro", "privateIpAddress": "34.223.14.193", "publicIpAddress": "10.111.60.160", "rootDeviceName": "/dev/sda", "securityGroups": [ { "groupId": "s.sg-890b6b4008bdb3111", "groupName": "default" } ], "updatedAt": "2021-07-23T15:29:42.163000-07:00" }, "lastUpdatedAt": "2021-07-23T15:29:58. 071000-07:00" } ] }

Vérifier les métadonnées des tâches

Pour vérifier les métadonnées d'une tâche donnée sur un appareil, utilisez la describe-task commande. Les métadonnées d'une tâche incluent les éléments suivants :

  • Les appareils cibles

  • État de la tâche

  • Quand la tâche a été créée

  • Quand les données ont été mises à jour pour la dernière fois sur l'appareil

  • Quand la tâche a été terminée

  • Description (le cas échéant) fournie lors de la création de la tâche

Pour vérifier les métadonnées d'une tâche, utilisez la commande suivante. Remplacez chaque user input placeholder par vos propres informations.

Commande

aws snow-device-management describe-task \ --task-id st-ficthmqoc2pht111

Exceptions

ValidationException ResourceNotFoundException InternalServerException ThrottlingException AccessDeniedException

Sortie

{ "completedAt": "2021-07-22T15:29:46.758000+00:00", "createdAt": "2021-07-22T15:28:42.613000+00:00", "lastUpdatedAt": "2021-07-22T15:29:46.758000+00:00", "state": "COMPLETED", "tags": {}, "targets": [ "smd-fictbgr3rbcje111" ], "taskId": "st-ficthmqoc2pht111", "taskArn": "arn:aws:snow-device-management:us-west-2:000000000000:task/st-ficthmqoc2pht111" }

Annuler une tâche

Pour envoyer une demande d'annulation pour une tâche spécifique, utilisez la cancel-task commande. Vous ne pouvez annuler que les tâches dont l'QUEUEDétat n'a pas encore été exécuté. Les tâches déjà en cours ne peuvent pas être annulées.

Note

Une tâche que vous tentez d'annuler peut toujours être exécutée si elle est traitée depuis la file d'attente avant que la cancel-task commande ne modifie l'état de la tâche.

Pour annuler une tâche, utilisez la commande suivante. Remplacez chaque user input placeholder par vos propres informations.

Commande

aws snow-device-management cancel-task \ --task-id st-ficthmqoc2pht111

Exceptions

ValidationException ResourceNotFoundException InternalServerException ThrottlingException AccessDeniedException

Sortie

{ "taskId": "st-ficthmqoc2pht111" }

Commandes de liste et syntaxe

Pour renvoyer une liste de toutes les commandes prises en charge pour l'API Snow Device Management, utilisez la help commande. Vous pouvez également utiliser la help commande pour renvoyer des informations détaillées et la syntaxe d'une commande donnée.

Pour répertorier toutes les commandes prises en charge, utilisez la commande suivante.

Commande

aws snow-device-management help

Pour renvoyer des informations détaillées et la syntaxe d'une commande, utilisez la commande suivante. commandRemplacez-le par le nom de la commande qui vous intéresse.

Commande

aws snow-device-management command help

Répertorier les appareils administrables à distance

Pour afficher la liste de tous les appareils de votre compte sur lesquels la gestion des appareils Snow est activée sur l'Région AWSendroit où la commande est exécutée, utilisez la list-devices commande. --max-resultset --next-token sont facultatifs. Pour plus d'informations, consultez la section Utilisation des options de AWS CLI pagination dans le « Guide de l'utilisateur de l'interface de ligne de AWS commande ».

Pour répertorier les appareils administrables à distance, utilisez la commande suivante. Remplacez chaque user input placeholder par vos propres informations.

Commande

aws snow-device-management list-devices \ --max-results 10

Exceptions

ValidationException InternalServerException ThrottlingException AccessDeniedException

Sortie

{ "devices": [ { "associatedWithJob": "ID2bf11d5a-ea1e-414a-b5b1-3bf7e6a6e111", "managedDeviceId": "smd-fictbgr3rbcjeqa5", "managedDeviceArn": "arn:aws:snow-device-management:us-west-2:000000000000:managed-device/smd-fictbgr3rbcje111" "tags": {} } ] }

Répertorier l'état des tâches sur les appareils

Pour renvoyer l'état des tâches pour une ou plusieurs machines cibles, utilisez la list-executions commande. Pour filtrer la liste des résultats afin d'afficher les tâches qui se trouvent actuellement dans un seul état spécifique, utilisez le --state paramètre. --max-resultset --next-token sont facultatifs. Pour plus d'informations, consultez la section Utilisation des options de AWS CLI pagination dans le « Guide de l'utilisateur de l'interface de ligne de AWS commande ».

Une tâche peut avoir l'un des états suivants :

  • QUEUED

  • IN_PROGRESS

  • CANCELED

  • FAILED

  • COMPLETED

  • REJECTED

  • TIMED_OUT

Pour répertorier l'état des tâches sur tous les appareils, utilisez la commande suivante. Remplacez chaque user input placeholder par vos propres informations.

Commande

aws snow-device-management list-executions \ --taskId st-ficthmqoc2phtlef \ --state SUCCEEDED \ --max-results 10

Exceptions

ValidationException InternalServerException ThrottlingException AccessDeniedException

Sortie

{ "executions": [ { "executionId": "1", "managedDeviceId": "smd-fictbgr3rbcje111", "state": "SUCCEEDED", "taskId": "st-ficthmqoc2pht111" } ] }

Liste des ressources disponibles

Pour renvoyer la liste des AWS ressources disponibles pour un appareil, utilisez la list-device-resources commande. Pour filtrer la liste en fonction d'un type de ressource spécifique, utilisez le --type paramètre. Actuellement, les instances compatibles avec Amazon EC2 sont le seul type de ressource pris en charge. --max-resultset --next-token sont facultatifs. Pour plus d'informations, consultez la section Utilisation des options de AWS CLI pagination dans le « Guide de l'utilisateur de l'interface de ligne de AWS commande ».

Pour répertorier les ressources disponibles pour un appareil, utilisez la commande suivante. Remplacez chaque user input placeholder par vos propres informations.

Commande

aws snow-device-management list-device-resources \ --managed-device-id smd-fictbgr3rbcje111 \ --type AWS::EC2::Instance --next-token YAQGPwAT9l3wVKaGYjt4yS34MiQLWvzcShe9oIeDJr05AT4rXSprqcqQhhBEYRfcerAp0YYbJmRT= --max-results 10

Exceptions

ValidationException InternalServerException ThrottlingException AccessDeniedException

Sortie

{ "resources": [ { "id": "s.i-84fa8a27d3e15e111", "resourceType": "AWS::EC2::Instance" } ] }

Répertorier les tags des appareils ou des tâches

Pour renvoyer une liste de balises pour un appareil géré ou une tâche, utilisez la list-tags-for-resource commande.

Pour répertorier les tags d'un appareil, utilisez la commande suivante. Remplacez l'exemple Amazon Resource Name (ARN) par l'ARN de votre appareil.

Commande

aws snow-device-management list-tags-for-resource --resource-arn arn:aws:snow-device-management:us-west-2:123456789012:managed-device/smd-fictbgr3rbcjeqa5

Exceptions

AccessDeniedException InternalServerException ResourceNotFoundException ThrottlingException

Sortie

{ "tags": { "Project": "PrototypeA" } }

Répertorier les tâches par statut

Utilisez la list-tasks commande pour renvoyer une liste des tâches depuis les appareils de la AWS région où la commande est exécutée. Pour filtrer les résultats par IN_PROGRESSCOMPLETED, ou par CANCELED statut, utilisez le --state paramètre. --max-resultset --next-token sont facultatifs. Pour plus d'informations, consultez la section Utilisation des options de AWS CLI pagination dans le « Guide de l'utilisateur de l'interface de ligne de AWS commande ».

Pour répertorier les tâches par statut, utilisez la commande suivante. Remplacez chaque user input placeholder par vos propres informations.

Commande

aws snow-device-management list-tasks \ --state IN_PROGRESS \ --next-token K8VAMqKiP2Cf4xGkmH8GMyZrgOF8FUb+d1OKTP9+P4pUb+8PhW+6MiXh4= \ --max-results 10

Exceptions

ValidationException InternalServerException ThrottlingException AccessDeniedException

Sortie

{ "tasks": [ { "state": "IN_PROGRESS", "tags": {}, "taskId": "st-ficthmqoc2phtlef", "taskArn": "arn:aws:snow-device-management:us-west-2:000000000000:task/st-ficthmqoc2phtlef" } ] }

Appliquer des balises

Pour ajouter ou remplacer une étiquette pour un appareil ou pour une tâche sur un appareil, utilisez la tag-resource commande. Le --tags paramètre accepte une liste de paires séparées par des virgules. Key=Value

Pour appliquer des balises à un appareil, utilisez la commande suivante. Remplacez chaque user input placeholder par vos propres informations.

Commande

aws snow-device-management tag-resource \ --resource-arn arn:aws:snow-device-management:us-west-2:123456789012:managed-device/smd-fictbgr3rbcjeqa5 \ --tags Project=PrototypeA

Exceptions

AccessDeniedException InternalServerException ResourceNotFoundException ThrottlingException

Supprimer les tags

Pour supprimer une étiquette d'un appareil ou d'une tâche sur un appareil, utilisez la untag-resources commande.

Pour supprimer les tags d'un appareil, utilisez la commande suivante. Remplacez chaque user input placeholder par vos propres informations.

Commande

aws snow-device-management untag-resources \ --resource-arn arn:aws:snow-device-management:us-west-2:123456789012:managed-device/smd-fictbgr3rbcjeqa5 \ --tag-keys Project

Exceptions

AccessDeniedException InternalServerException ResourceNotFoundException ThrottlingException