Uso AWS Snow Device Management para administrar los dispositivos de la familia Snow - AWS Snowball Edge Guía para desarrolladores
Elija el estado de administración de dispositivos Snow al solicitar un dispositivo de la familia SnowActivación de la gestión de dispositivos Snow en un dispositivo de la familia SnowAñadir permisos para la administración de dispositivos Snow a un IAM rol en un dispositivo de la familia SnowMostrar CLI comandos de administración de dispositivos

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso AWS Snow Device Management para administrar los dispositivos de la familia Snow

AWS Snow Device Management le permite administrar su dispositivo de la familia Snow y AWS los servicios locales de forma remota. Todos los dispositivos de la familia Snow son compatibles con la gestión de dispositivos Snow y viene instalada en los dispositivos nuevos en la mayoría Regiones de AWS de los dispositivos de la familia Snow disponibles.

Con Snow Device Management, puede realizar las siguientes tareas:

  • Creación de una tarea

  • Comprobación del estado de la tarea

  • Comprobación de los metadatos de una tarea

  • Cancelación de una tarea

  • Comprobación de la información del dispositivo

  • Comprueba el estado EC2 de la instancia compatible con Amazon

  • Obtención de una lista de comandos y sintaxis

  • Obtención de una lista de los dispositivos que se pueden administrar de forma remota

  • Obtención de una lista del estado de las tareas en distintos dispositivos

  • Obtención de una lista de los recursos disponibles

  • Obtención de una lista de tareas por estado

  • Obtención de una lista de las etiquetas de un dispositivo o de una tarea

  • Aplicación de etiquetas

  • Eliminación de etiquetas

Elija el estado de administración de dispositivos Snow al solicitar un dispositivo de la familia Snow

Al crear una tarea para solicitar un dispositivo de nieve, puede elegir en qué estado estará la gestión de dispositivos de nieve cuando reciba el dispositivo: instalado pero no activado o instalado y activado. Si está instalado pero no activado, necesitará usar AWS OpsHub o el cliente Snowball Edge para activarlo antes de usarlo. Si está instalado y activado, podrá utilizar Snow Device Management después de recibir el dispositivo y conectarlo a la red local. Puede elegir el estado de administración de dispositivos de Snowball al crear un trabajo para solicitar un dispositivo a través del Consola de administración de la familia de productos Snow de AWS cliente de Snowball Edge o la AWS CLI administración de trabajos de Snow. API

Para elegir el estado de administración de dispositivos de Snow en Consola de administración de la familia de productos Snow de AWS

  1. Para elegir que se instale y active la administración de dispositivos de nieve, elija Administrar su dispositivo de nieve de forma remota con AWS OpsHub o el cliente Snowball.

  2. Para elegir que la administración de dispositivos Snow esté instalada pero no activada, no seleccione Administrar su dispositivo Snow de forma remota con AWS OpsHub un cliente Snowball.

Para obtener más información, consulte el paso 3: Elija las funciones y opciones en esta guía.

Para elegir el estado de administración de dispositivos de Snow desde el AWS CLI cliente Snowball Edge o la administración de tareas de Snow: API

  • Utilice el remote-management parámetro para especificar el estado de administración de dispositivos de nieve. El INSTALLED_ONLY valor del parámetro significa que Snow Device Management está instalado pero no activado. El INSTALLED_AUTOSTART valor del parámetro significa que Snow Device Management está instalado y activado. Si no especifica ningún valor para este parámetro, INSTALLED_ONLY es el valor por defecto.

ejemplo de la sintaxis del remote-management parámetro del create-job comando

  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 \

Para obtener más información, consulte la APIreferencia de gestión de trabajos en la AWS Snowball API referencia.

Activación de la gestión de dispositivos Snow en un dispositivo de la familia Snow

Siga este procedimiento para activar Snow Device Management mediante el cliente Snowball Edge.

Antes de utilizar este procedimiento, haga lo siguiente:


  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

El cliente Snowball Edge devuelve lo siguiente cuando el comando se ejecuta correctamente.


  {
    "RemoteManagementState" : "INSTALLED_AUTOSTART"
  }

Añadir permisos para la administración de dispositivos Snow a un IAM rol en un dispositivo de la familia Snow

En el dispositivo Cuenta de AWS desde el que se realizó el pedido, cree un rol AWS Identity and Access Management (IAM) y añada la siguiente política al rol. A continuación, asigne la función al IAM usuario que iniciará sesión para gestionar su dispositivo de forma remota con Snow Device Management. Para obtener más información, consulte Creación de IAM roles y Creación de un IAM usuario en su Cuenta de AWS.

Política


{
    "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": "*" 
        }
    ]
}

Mostrar CLI comandos de administración de dispositivos

En esta sección se describen los AWS CLI comandos que puede utilizar para gestionar los dispositivos de la familia Snow de forma remota con Snow Device Management. También puede realizar algunas tareas de administración remota utilizando AWS OpsHub for Snow Family. Para obtener más información, consulte Administrar AWS los servicios del dispositivo.

nota

Antes de administrar el dispositivo, asegúrate de que esté encendido, conectado a la red y de que pueda conectarse al Región de AWS lugar donde se aprovisionó.

Crear una tarea para administrar un dispositivo de la familia Snow con Snow Device Management

Para indicar a uno o más dispositivos de destino que realicen una tarea, como desbloquearse o reiniciarse, utilice create-task. Los dispositivos de destino se especifican proporcionando una lista de los dispositivos gestionados IDs con el --targets parámetro y especificando las tareas que se van a realizar con el --command parámetro. Solo se puede ejecutar un comando en un dispositivo cada vez.

Comandos admitidos:

  • unlock (sin argumentos)

  • reboot (sin argumentos)

Para crear una tarea para que la ejecuten los dispositivos de destino, utilice el siguiente comando. Reemplace cada user input placeholder por su propia información.

Comando


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

Excepciones


ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
ServiceQuotaExceededException

Salida


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

Comprobar el estado de una tarea para administrar un dispositivo de la familia Snow

Para comprobar el estado de una tarea remota que se ejecuta en uno o más dispositivos de destino, utilice el comando describe-execution.

Una tarea puede tener uno de los siguientes estados:

  • QUEUED

  • IN_PROGRESS

  • CANCELED

  • FAILED

  • COMPLETED

  • REJECTED

  • TIMED_OUT

Para comprobar el estado de una tarea, utilice el siguiente comando. Reemplace cada user input placeholder por su propia información.

Comando


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

Salida


{
    "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"
}

Comprobación de la información sobre un dispositivo de la familia Snow mediante la administración de dispositivos Snow

Para comprobar la información específica del dispositivo, como el tipo de dispositivo, la versión del software, las direcciones IP y el estado de bloqueo, utilice el comando describe-device. La salida incluye también lo siguiente:

  • lastReachedOutAt: la última vez que el dispositivo contactó con la Nube de AWS. Indica que el dispositivo está en línea.

  • lastUpdatedAt: cuándo se actualizaron los datos por última vez en el dispositivo. Indica cuándo se actualizó la memoria caché del dispositivo.

Para comprobar la información del dispositivo, utilice el siguiente comando. Reemplace cada user input placeholder por su propia información.

Comando


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

Excepciones



ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException

Salida


{
    "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"
    }
}

Comprobación del estado de las instancias EC2 compatibles con Amazon en los dispositivos de la familia Snow con Snow Device Management

Para comprobar el estado actual de la EC2 instancia de Amazon, usa el describe-ec2-instances comando. El resultado es similar al del describe-device comando, pero los resultados se obtienen de la memoria caché del dispositivo Nube de AWS e incluyen un subconjunto de los campos disponibles.

Para comprobar el estado de la instancia EC2 compatible con Amazon, usa el siguiente comando. Reemplace cada user input placeholder por su propia información.

Comando


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

Excepciones



ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException

Salida


{
    "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"
        }
    ]
}

Visualización de los metadatos de las tareas en los dispositivos de la familia Snow con Snow Device Management

Para comprobar los metadatos de una tarea determinada en un dispositivo, utilice el comando describe-task. Los metadatos de una tarea incluyen los siguientes elementos:

  • Los dispositivos de destino

  • El estado de la tarea

  • Cuándo se creó la tarea

  • Cuándo se actualizaron los datos por última vez en el dispositivo

  • Cuándo se completó la tarea

  • La descripción (si la hay) que se proporcionó cuando se creó la tarea

Para comprobar los metadatos de una tarea, utilice el siguiente comando. Reemplace cada user input placeholder por su propia información.

Comando


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

Excepciones



ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException

Salida


{
    "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"
}

Cancelar una tarea en un dispositivo de la familia Snow con Snow Device Management

Para enviar una solicitud de cancelación para una tarea específica, utilice el comando cancel-task. Solo puede cancelar las tareas que se encuentren en el estado QUEUED y que aún no se hayan ejecutado. Las tareas que ya se están ejecutando no se pueden cancelar.

nota

Es posible que una tarea que está intentando cancelar siga ejecutándose si se procesa desde la cola antes de que el comando cancel-task cambie el estado de la tarea.

Para cancelar una tarea, utilice el siguiente comando. Reemplace cada user input placeholder por su propia información.

Comando


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

Excepciones



ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException

Salida


{
    "taskId": "st-ficthmqoc2pht111"
}

Lista de los comandos y la sintaxis de Snow Device Management

Para obtener una lista de todos los comandos compatibles con Snow Device ManagementAPI, utilice el help comando. También puede usar el comando help para devolver información detallada sobre un comando determinado y su sintaxis.

Para obtener una lista de todos los comandos admitidos, utilice el siguiente comando.

Comando


aws snow-device-management help

Para devolver información detallada y la sintaxis de un comando, utilice el siguiente comando. Sustituya command por el nombre del comando que le interesa.

Comando


aws snow-device-management command help

Lista de los dispositivos de la familia Snow disponibles para la administración remota

Para obtener una lista de todos los dispositivos de su cuenta que tienen habilitada Snow Device Management en la Región de AWS en la que se ejecuta el comando, utilice el comando list-devices. --max-results y --next-token son opcionales. Para obtener más información, consulte Uso de las opciones de AWS CLI paginación en la «Guía del usuario de la interfaz de línea de AWS comandos».

Para obtener una lista de los dispositivos que se pueden administrar de forma remota, utilice el siguiente comando. Reemplace cada user input placeholder por su propia información.

Comando


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

Excepciones



ValidationException
InternalServerException
ThrottlingException
AccessDeniedException

Salida


{
    "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": {}
        }
    ]
}

Listado del estado de las tareas de administración de dispositivos Snow en todos los dispositivos de la familia Snow

Para devolver el estado de las tareas de uno o más dispositivos de destino, utilice el comando list-executions. Para filtrar la lista devuelta y mostrar las tareas que se encuentran actualmente en un único estado específico, utilice el parámetro --state. --max-results y --next-token son opcionales. Para obtener más información, consulte Uso de las opciones de AWS CLI paginación en la «Guía del usuario de la interfaz de línea de AWS comandos».

Una tarea puede tener uno de los siguientes estados:

  • QUEUED

  • IN_PROGRESS

  • CANCELED

  • FAILED

  • COMPLETED

  • REJECTED

  • TIMED_OUT

Para obtener una lista del estado de las tareas en distintos dispositivos, utilice el siguiente comando. Reemplace cada user input placeholder por su propia información.

Comando


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

Excepciones



ValidationException
InternalServerException
ThrottlingException
AccessDeniedException

Salida


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

Lista de los recursos disponibles en los dispositivos de la familia Snow con la administración de dispositivos Snow

Para obtener una lista de los AWS recursos disponibles para un dispositivo, utilice el list-device-resources comando. Para filtrar la lista por un tipo de recurso específico, utilice el parámetro --type. Actualmente, las instancias EC2 compatibles con Amazon son el único tipo de recurso admitido. --max-resultsy --next-token son opcionales. Para obtener más información, consulte Uso de las opciones de AWS CLI paginación en la «Guía del usuario de la interfaz de línea de AWS comandos».

Para obtener una lista de los recursos disponibles para un dispositivo, utilice el siguiente comando. Reemplace cada user input placeholder por su propia información.

Comando


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

Excepciones



ValidationException
InternalServerException
ThrottlingException
AccessDeniedException

Salida


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

Etiquetas de listado para los dispositivos de la familia Snow o etiquetas de administración de dispositivos Snow

Para devolver una lista de etiquetas de una tarea o un dispositivo administrado, utilice el comando list-tags-for-resource.

Para obtener una lista de las etiquetas de un dispositivo, utilice el siguiente comando. Sustituya el nombre de recurso de Amazon (ARN) de ejemplo ARN por el de su dispositivo.

Comando


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

Excepciones


AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException

Salida


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

Listar las tareas de administración de dispositivos Snow por estado

Utilice el list-tasks comando para obtener una lista de tareas de los dispositivos de la AWS región en la que se ejecuta el comando. Para filtrar los resultados por el estado IN_PROGRESS, COMPLETED o CANCELED, utilice el parámetro --state. --max-results y --next-token son opcionales. Para obtener más información, consulte Uso de las opciones de AWS CLI paginación en la «Guía del usuario de la interfaz de línea de AWS comandos».

Para obtener una lista de tareas por estado, utilice el siguiente comando. Reemplace cada user input placeholder por su propia información.

Comando


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

Excepciones


ValidationException
InternalServerException
ThrottlingException
AccessDeniedException

Salida


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

Aplicar etiquetas a las tareas de administración de dispositivos Snow o a los dispositivos de la familia Snow

Para agregar o reemplazar una etiqueta para un dispositivo o para una tarea de un dispositivo, utilice el comando tag-resource. El parámetro --tags acepta una lista separada por comas de pares Key=Value.

Para aplicar etiquetas a un dispositivo, utilice el siguiente comando. Reemplace cada user input placeholder por su propia información.

Comando


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

Excepciones


AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException

Eliminar las etiquetas de administración de dispositivos Snow de las tareas o los dispositivos de la familia Snow

Para eliminar una etiqueta de un dispositivo o de una tarea de un dispositivo, utilice el comando untag-resources.

Para eliminar etiquetas de un dispositivo, utilice el siguiente comando. Reemplace cada user input placeholder por su propia información.

Comando


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

Excepciones


AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException