Utilizzo AWS Snow Device Management per gestire i dispositivi Snow Family - AWS Snowcone Guida per l'utente
Scelta dello stato Snow Device Management al momento dell'ordine di un dispositivo Snow FamilyAttivazione di Snow Device Management su un dispositivo Snow FamilyAggiungere le autorizzazioni per Snow Device Management a un IAM ruolo su un dispositivo Snow FamilyCLIComandi Snow Device Management

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizzo AWS Snow Device Management per gestire i dispositivi Snow Family

AWS Snow Device Management ti consente di gestire da remoto il tuo dispositivo Snow Family e AWS i servizi locali. Tutti i dispositivi Snow Family supportano Snow Device Management, che viene installato su nuovi dispositivi nella maggior parte dei paesi in Regioni AWS cui sono disponibili dispositivi Snow Family.

Con Snow Device Management, puoi eseguire le seguenti attività:

  • Creare un'attività

  • Controlla lo stato dell'attività

  • Controlla i metadati delle attività

  • Annullare un'attività

  • Controlla le informazioni sul dispositivo

  • Verifica lo stato dell'istanza EC2 compatibile con Amazon

  • Elenca i comandi e la sintassi

  • Elenca i dispositivi gestibili in remoto

  • Elenca lo stato delle attività su tutti i dispositivi

  • Elenca le risorse disponibili

  • Elenca le attività per stato

  • Elenca i tag dei dispositivi o delle attività

  • Applica tag

  • Rimuovere i tag

Scelta dello stato Snow Device Management al momento dell'ordine di un dispositivo Snow Family

Quando crei un lavoro per ordinare un dispositivo Snow, puoi scegliere in che stato si troverà Snow Device Management quando riceverai il dispositivo: installato ma non attivato oppure installato e attivato. Se è installato ma non attivato, dovrai utilizzare AWS OpsHub o il client Snowball Edge per attivarlo prima di utilizzarlo. Se è installato e attivato, puoi utilizzare Snow Device Management dopo aver ricevuto il dispositivo e averlo collegato alla rete locale. Puoi scegliere lo stato di Snow Device Management quando crei un lavoro per ordinare un dispositivo tramite il Console di gestione della famiglia di servizi AWS Snow client Snowball Edge o la AWS CLI gestione dei lavori Snow. API

Per scegliere lo stato di Snow Device Management tra Console di gestione della famiglia di servizi AWS Snow

  1. Per scegliere di installare e attivare Snow Device Management, scegli Gestisci il tuo dispositivo Snow da remoto con AWS OpsHub il nostro client Snowball.

  2. Per scegliere che Snow Device Management sia installato ma non attivato, non selezionare Gestisci il tuo dispositivo Snow da remoto con AWS OpsHub o il client Snowball.

Per ulteriori informazioni, consulta Passaggio 3: scelta delle funzionalità e delle opzioni in questa guida.

Per scegliere lo stato di Snow Device Management dal AWS CLI client Snowball Edge o da Snow job management: API

  • Utilizzate il remote-management parametro per specificare lo stato di Snow Device Management. Il INSTALLED_ONLY valore del parametro indica che Snow Device Management è installato ma non attivato. Il INSTALLED_AUTOSTART valore del parametro indica che Snow Device Management è installato e attivato. Se non si specifica un valore per questo parametro, INSTALLED_ONLY è il valore predefinito.

Esempio della sintassi del remote-management parametro del comando create-job

  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 \

Per ulteriori informazioni, vedere Job Management API Reference nel AWS Snowball API Reference.

Attivazione di Snow Device Management su un dispositivo Snow Family

Segui questa procedura per attivare Snow Device Management utilizzando il client Snowball Edge.

Prima di utilizzare questa procedura, effettuate le seguenti operazioni:

  • Scarica e installa la versione più recente del client Snowball Edge. Per ulteriori informazioni, consulta Scaricamento e installazione del client Snowball.

  • Scarica il file manifest e ottieni il codice di sblocco per il dispositivo Snow Family. Per ulteriori informazioni, consulta Ottenere le credenziali e gli strumenti.

  • Connect il dispositivo Snow Family alla rete locale. Per ulteriori informazioni, vedere .

  • Sblocca il dispositivo Snow Family. Per ulteriori informazioni, consulta di un dispositivo localmente.


  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

Il client Snowball Edge restituisce quanto segue quando il comando ha esito positivo.


  {
    "RemoteManagementState" : "INSTALLED_AUTOSTART"
  }

Aggiungere le autorizzazioni per Snow Device Management a un IAM ruolo su un dispositivo Snow Family

Sul dispositivo Account AWS da cui è stato ordinato il dispositivo, crea un ruolo AWS Identity and Access Management (IAM) e aggiungi la seguente politica al ruolo. Quindi, assegna il ruolo all'IAMutente che effettuerà l'accesso per gestire in remoto il tuo dispositivo con Snow Device Management. Per ulteriori informazioni, consulta Creazione di IAM ruoli e Creazione di un IAM utente nel tuo. Account AWS

Policy


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

CLIComandi Snow Device Management

Questa sezione descrive i AWS CLI comandi che puoi usare per gestire i tuoi dispositivi Snow Family da remoto con Snow Device Management. È inoltre possibile eseguire alcune attività di gestione remota utilizzando AWS OpsHub for Snow Family. Per ulteriori informazioni, consulta Gestione AWS dei servizi sul dispositivo .

Nota

Prima di gestire il dispositivo, assicurati che sia acceso, connesso alla rete e che possa connettersi al Regione AWS punto in cui è stato fornito.

Creazione di un'attività per gestire un dispositivo Snow Family con Snow Device Management

Per indicare a uno o più dispositivi di destinazione di eseguire un'operazione, come lo sblocco o il riavvio, usa. create-task È possibile specificare i dispositivi di destinazione fornendo un elenco di dispositivi gestiti IDs con il --targets parametro e specificando le attività da eseguire con il parametro. --command È possibile eseguire un solo comando alla volta su un dispositivo.

Comandi supportati:

  • unlock(senza argomenti)

  • reboot(nessun argomento)

Per creare un'attività che deve essere eseguita dai dispositivi di destinazione, utilizzare il seguente comando. Sostituisci ogni user input placeholder con le tue informazioni.

Comando


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

Eccezioni


ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
ServiceQuotaExceededException

Output


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

Verifica dello stato di un'attività per la gestione di un dispositivo Snow Family

Per verificare lo stato di un'attività remota in esecuzione su uno o più dispositivi di destinazione, usa il describe-execution comando.

Un'attività può avere uno dei seguenti stati:

  • QUEUED

  • IN_PROGRESS

  • CANCELED

  • FAILED

  • COMPLETED

  • REJECTED

  • TIMED_OUT

Per verificare lo stato di un'attività, utilizzare il comando seguente. Sostituisci ogni user input placeholder con le tue informazioni.

Comando


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

Output


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

Verifica delle informazioni su un dispositivo Snow Family utilizzando Snow Device Management

Per controllare le informazioni specifiche del dispositivo, come il tipo di dispositivo, la versione del software, gli indirizzi IP e lo stato del blocco, usa il comando. describe-device L'output include anche quanto segue:

  • lastReachedOutAt— L'ultima volta che il dispositivo ha contattato il Cloud AWS. Indica che il dispositivo è online.

  • lastUpdatedAt— Quando i dati sono stati aggiornati l'ultima volta sul dispositivo. Indica quando la cache del dispositivo è stata aggiornata.

Per controllare le informazioni sul dispositivo, usa il seguente comando. Sostituisci ogni user input placeholder con le tue informazioni.

Comando


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

Eccezioni



ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException

Output


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

Verifica dello stato delle istanze EC2 compatibili con Amazon sui dispositivi Snow Family con Snow Device Management

Per verificare lo stato corrente dell'EC2istanza Amazon, usa il describe-ec2-instances comando. L'output è simile a quello del describe-device comando, ma i risultati provengono dalla cache del dispositivo Cloud AWS e includono un sottoinsieme dei campi disponibili.

Per verificare lo stato dell'istanza EC2 compatibile con Amazon, usa il seguente comando. Sostituisci ogni user input placeholder con le tue informazioni.

Comando


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

Eccezioni



ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException

Output


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

Visualizzazione dei metadati delle attività sui dispositivi Snow Family con Snow Device Management

Per controllare i metadati di una determinata attività su un dispositivo, usa il describe-task comando. I metadati di un'attività includono i seguenti elementi:

  • I dispositivi di destinazione

  • Lo stato dell'attività

  • Quando è stata creata l'attività

  • Quando i dati sono stati aggiornati l'ultima volta sul dispositivo

  • Quando l'attività è stata completata

  • L'eventuale descrizione fornita al momento della creazione dell'attività

Per controllare i metadati di un'attività, usa il comando seguente. Sostituisci ogni user input placeholder con le tue informazioni.

Comando


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

Eccezioni



ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException

Output


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

Annullamento di un'attività su un dispositivo Snow Family con Snow Device Management

Per inviare una richiesta di annullamento per un'attività specifica, usa il cancel-task comando. È possibile annullare solo le attività nello QUEUED stato che non sono ancora state eseguite. Le attività già in esecuzione non possono essere annullate.

Nota

Un'attività che si sta tentando di annullare potrebbe continuare a essere eseguita se viene elaborata dalla coda prima che il cancel-task comando modifichi lo stato dell'attività.

Per annullare un'operazione, utilizzare il comando seguente. Sostituisci ogni user input placeholder con le tue informazioni.

Comando


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

Eccezioni



ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException

Output


{
    "taskId": "st-ficthmqoc2pht111"
}

Elenco dei comandi e della sintassi di Snow Device Management

Per restituire un elenco di tutti i comandi supportati per Snow Device ManagementAPI, usa il help comando. È inoltre possibile utilizzare il help comando per restituire informazioni dettagliate e sulla sintassi di un determinato comando.

Per elencare tutti i comandi supportati, utilizzare il comando seguente.

Comando


aws snow-device-management help

Per restituire informazioni dettagliate e sintassi per un comando, utilizzare il comando seguente. Sostituiscilo command con il nome del comando che ti interessa.

Comando


aws snow-device-management command help

Elenco dei dispositivi Snow Family disponibili per la gestione remota

Per restituire un elenco di tutti i dispositivi del tuo account su cui è abilitato Snow Device Management nel Regione AWS punto in cui viene eseguito il comando, usa il list-devices comando. --max-resultse --next-token sono opzionali. Per ulteriori informazioni, vedere Uso delle opzioni di AWS CLI impaginazione nella "Guida per l'utente dell'interfaccia a riga di AWS comando».

Per elencare i dispositivi gestibili in remoto, utilizzare il comando seguente. Sostituisci ogni user input placeholder con le tue informazioni.

Comando


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

Eccezioni



ValidationException
InternalServerException
ThrottlingException
AccessDeniedException

Output


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

Elenco dello stato delle attività di Snow Device Management sui dispositivi Snow Family

Per restituire lo stato delle attività per uno o più dispositivi di destinazione, usa il list-executions comando. Per filtrare l'elenco restituito in modo da mostrare le attività che si trovano attualmente in un unico stato specifico, utilizzate il --state parametro. --max-resultse --next-token sono opzionali. Per ulteriori informazioni, vedere Uso delle opzioni di AWS CLI impaginazione nella "Guida per l'utente dell'interfaccia a riga di AWS comando».

Un'attività può avere uno dei seguenti stati:

  • QUEUED

  • IN_PROGRESS

  • CANCELED

  • FAILED

  • COMPLETED

  • REJECTED

  • TIMED_OUT

Per elencare lo stato delle attività su tutti i dispositivi, utilizzare il comando seguente. Sostituisci ogni user input placeholder con le tue informazioni.

Comando


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

Eccezioni



ValidationException
InternalServerException
ThrottlingException
AccessDeniedException

Output


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

Elenco delle risorse disponibili sui dispositivi Snow Family con Snow Device Management

Per restituire un elenco delle AWS risorse disponibili per un dispositivo, usa il list-device-resources comando. Per filtrare l'elenco in base a un tipo specifico di risorsa, utilizzate il --type parametro. Attualmente, le istanze EC2 compatibili con Amazon sono l'unico tipo di risorsa supportato. --max-resultse --next-token sono opzionali. Per ulteriori informazioni, vedere Uso delle opzioni di AWS CLI impaginazione nella "Guida per l'utente dell'interfaccia a riga di AWS comando».

Per elencare le risorse disponibili per un dispositivo, utilizzare il comando seguente. Sostituisci ogni user input placeholder con le tue informazioni.

Comando


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

Eccezioni



ValidationException
InternalServerException
ThrottlingException
AccessDeniedException

Output


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

Tag di elenco per i dispositivi Snow Family o i tag Snow Device Management

Per restituire un elenco di tag per un dispositivo o un'attività gestita, usa il list-tags-for-resource comando.

Per elencare i tag di un dispositivo, usa il comando seguente. Sostituisci l'esempio Amazon Resource Name (ARN) con quello ARN per il tuo 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

Eccezioni


AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException

Output


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

Elenco delle attività di Snow Device Management per stato

Usa il list-tasks comando per restituire un elenco di attività dai dispositivi nella AWS regione in cui viene eseguito il comando. Per filtrare i risultati in base IN_PROGRESS CANCELED allo stato, utilizzate il --state parametro. COMPLETED --max-resultse --next-token sono opzionali. Per ulteriori informazioni, vedere Uso delle opzioni di AWS CLI impaginazione nella "Guida per l'utente dell'interfaccia a riga di AWS comando».

Per elencare le attività in base allo stato, utilizzare il comando seguente. Sostituisci ogni user input placeholder con le tue informazioni.

Comando


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

Eccezioni


ValidationException
InternalServerException
ThrottlingException
AccessDeniedException

Output


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

Applicazione di tag alle attività di Snow Device Management o ai dispositivi Snow Family

Per aggiungere o sostituire un tag per un dispositivo o per un'attività su un dispositivo, usa il tag-resource comando. Il --tags parametro accetta un elenco di coppie separate da virgole. Key=Value

Per applicare i tag a un dispositivo, utilizzate il seguente comando. Sostituisci ogni user input placeholder con le tue informazioni.

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

Eccezioni


AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException

Rimozione dei tag Snow Device Management dalle attività o dai dispositivi Snow Family

Per rimuovere un tag da un dispositivo o da un'attività su un dispositivo, usa il untag-resources comando.

Per rimuovere i tag da un dispositivo, usa il seguente comando. Sostituisci ogni user input placeholder con le tue informazioni.

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

Eccezioni


AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException