AWS Snow Device Management Zur Verwaltung von Snow Family-Geräten verwenden

AWS Snow Device Management ermöglicht es Ihnen, Ihr Snow Family-Gerät und lokale AWS Dienste aus der Ferne zu verwalten. Alle Snow Family-Geräte unterstützen Snow Device Management und es ist auf den meisten Geräten, auf AWS-Regionen denen Snow Family-Geräte verfügbar sind, auf neuen Geräten installiert.

Mit Snow Device Management können Sie die folgenden Aufgaben ausführen:

• Erstellen Sie eine Aufgabe

• Überprüfen Sie den Aufgabenstatus

• Überprüfen Sie die Metadaten der Aufgabe

• Stornieren Sie eine Aufgabe

• Überprüfen Sie die Geräteinformationen

• Überprüfen Sie den EC2 Amazon-kompatiblen Instanzstatus

• Befehle und Syntax auflisten

• Listet Geräte auf, die per Fernzugriff verwaltet werden können

• Listet den Aufgabenstatus geräteübergreifend auf

• Verfügbare Ressourcen auflisten

• Aufgaben nach Status auflisten

• Geräte- oder Aufgaben-Tags auflisten

• Schlagworte anwenden

• Tags entfernen

Auswahl des Status „Snow Device Management“ bei der Bestellung eines Snow Family-Geräts

Wenn Sie einen Auftrag zur Bestellung eines Snow-Geräts erstellen, können Sie wählen, in welchem Status sich Snow Device Management befinden soll, wenn Sie das Gerät erhalten: installiert, aber nicht aktiviert oder installiert und aktiviert. Wenn es installiert, aber nicht aktiviert ist, müssen Sie den Snowball Edge-Client verwenden AWS OpsHub , um es zu aktivieren, bevor Sie es verwenden können. Wenn es installiert und aktiviert ist, können Sie Snow Device Management verwenden, nachdem Sie das Gerät erhalten und es mit Ihrem lokalen Netzwerk verbunden haben. Sie können den Status „Snow Device Management“ wählen, wenn Sie einen Auftrag erstellen Managementkonsole für die AWS Snow-Familie, um ein Gerät über den Snowball Edge-Client AWS CLI, die oder die Snow-Auftragsverwaltung API zu bestellen.

Um den Status „Snow Device Management“ aus dem Managementkonsole für die AWS Snow-Familie

1. Um festzulegen, dass Snow Device Management installiert und aktiviert werden soll, wählen Sie Ihr Snow-Gerät remote mit AWS OpsHub oder Snowball-Client verwalten.

2. Wenn Sie festlegen möchten, dass Snow Device Management installiert, aber nicht aktiviert wird, wählen Sie Ihr Snow-Gerät nicht remote mit AWS OpsHub oder dem Snowball-Client verwalten aus.

Weitere Informationen finden Sie unter Schritt 3: Wählen Sie Ihre Funktionen und Optionen in diesem Handbuch.

So wählen Sie den Status „Snow Device Management“ im AWS CLI Snowball Edge-Client oder in der Snow-Auftragsverwaltung API aus:

• Verwenden Sie den remote-management Parameter, um den Status „Snow Device Management“ anzugeben. Der INSTALLED_ONLY Wert des Parameters bedeutet, dass Snow Device Management installiert, aber nicht aktiviert ist. Der INSTALLED_AUTOSTART Wert des Parameters bedeutet, dass Snow Device Management installiert und aktiviert ist. Wenn Sie keinen Wert für diesen Parameter angeben, INSTALLED_ONLY ist dies der Standardwert.

Beispiel der Syntax des remote-management Parameters des create-job Befehls

  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 \

Weitere Informationen finden Sie unter Job Management API Reference in der AWS Snowball API Referenz.

Snow Device Management auf einem Snow Family-Gerät aktivieren

Gehen Sie wie folgt vor, um Snow Device Management mit dem Snowball Edge-Client zu aktivieren.

Bevor Sie dieses Verfahren verwenden, gehen Sie wie folgt vor:

• Laden Sie die neueste Version des Snowball Edge-Clients herunter und installieren Sie sie. Weitere Informationen finden Sie unter Snowball-Client herunterladen und installieren.

• Laden Sie die Manifestdatei herunter und holen Sie sich den Entsperrcode für das Snow Family-Gerät. Weitere Informationen finden Sie unter Zugangsdaten und Tools abrufen.

• Connect das Snow Family-Gerät mit Ihrem lokalen Netzwerk. Weitere Informationen finden Sie unter für die Verbindung mit Ihrem lokalen Netzwerk.

• Entsperren Sie das Snow Family-Gerät. Weitere Informationen finden Sie unter Snowball Edge entsperren Lokales .

  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
                

Der Snowball Edge-Client gibt Folgendes zurück, wenn der Befehl erfolgreich ist.

  {
    "RemoteManagementState" : "INSTALLED_AUTOSTART"
  }
                

Hinzufügen von Berechtigungen für Snow Device Management zu einer IAM Rolle auf einem Snow Family-Gerät

Erstellen Sie auf dem Gerät, von dem AWS-Konto aus das Gerät bestellt wurde, eine Rolle AWS Identity and Access Management (IAM) und fügen Sie der Rolle die folgende Richtlinie hinzu. Weisen Sie die Rolle dann dem IAM Benutzer zu, der sich anmeldet, um Ihr Gerät mit Snow Device Management fernzuverwalten. Weitere Informationen finden Sie unter IAMRollen erstellen und IAM Benutzer erstellen in Ihrem AWS-Konto.

Richtlinie

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

CLIBefehle zur Geräteverwaltung in Snow

In diesem Abschnitt AWS CLI werden die Befehle beschrieben, mit denen Sie Ihre Snow Family-Geräte mit Snow Device Management remote verwalten können. Sie können einige Fernverwaltungsaufgaben auch mit ausführen AWS OpsHub for Snow Family. Weitere Informationen finden Sie unter verwalten AWS Dienste auf Ihrem Gerät verwalten.

Anmerkung

Stellen Sie vor der Verwaltung Ihres Geräts sicher, dass es eingeschaltet und mit Ihrem Netzwerk verbunden ist und eine Verbindung zu dem Gerät herstellen kann, auf AWS-Region dem es bereitgestellt wurde.

Themen

• Eine Aufgabe zur Verwaltung eines Snow Family-Geräts mit Snow Device Management erstellen
• Überprüfen des Status einer Aufgabe zur Verwaltung eines Snow Family-Geräts
• Informationen zu einem Snow Family-Gerät mithilfe von Snow Device Management überprüfen
• Überprüfen des Status von EC2 Amazon-kompatiblen Instances auf Geräten der Snow Family mit Snow Device Management
• Aufgaben-Metadaten auf Geräten der Snow Family mit Snow Device Management anzeigen
• Abbrechen einer Aufgabe auf einem Snow Family-Gerät mit Snow Device Management
• Befehle und Syntax von Snow Device Management auflisten
• Liste der Snow Family-Geräte, die für die Fernverwaltung verfügbar sind
• Auflisten des Status der Snow Device Management-Aufgaben auf allen Geräten der Snow Family
• Auflisten verfügbarer Ressourcen auf Snow Family-Geräten mit Snow Device Management
• Auflisten von Tags für Snow Family-Geräte oder Snow Device Management-Tags
• Auflisten der Aufgaben von Snow Device Management nach Status
• Anwenden von Tags auf Snow Device Management-Aufgaben oder Snow Family-Geräte
• Entfernen von Snow Device Management-Tags von Aufgaben oder Snow Family-Geräten

Eine Aufgabe zur Verwaltung eines Snow Family-Geräts mit Snow Device Management erstellen

Um ein oder mehrere Zielgeräte anzuweisen, eine Aufgabe auszuführen, z. B. das Entsperren oder Neustarten, verwenden Sie. create-task Sie geben Zielgeräte an, indem Sie eine Liste der verwalteten Geräte IDs mit dem --targets Parameter angeben und die Aufgaben angeben, die mit dem Parameter ausgeführt werden sollen. --command Auf einem Gerät kann jeweils nur ein einziger Befehl ausgeführt werden.

Unterstützte Befehle:

• unlock(keine Argumente)

• reboot(keine Argumente)

Verwenden Sie den folgenden Befehl, um eine Aufgabe zu erstellen, die von den Zielgeräten ausgeführt werden soll. Ersetzen Sie jeden user input placeholder durch Ihre Informationen.

Befehl

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

Ausnahmen

ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
ServiceQuotaExceededException

Ausgabe

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

Überprüfen des Status einer Aufgabe zur Verwaltung eines Snow Family-Geräts

Verwenden Sie den describe-execution Befehl, um den Status einer Remote-Aufgabe zu überprüfen, die auf einem oder mehreren Zielgeräten ausgeführt wird.

Eine Aufgabe kann einen der folgenden Status haben:

• QUEUED

• IN_PROGRESS

• CANCELED

• FAILED

• COMPLETED

• REJECTED

• TIMED_OUT

Verwenden Sie den folgenden Befehl, um den Status einer Aufgabe zu überprüfen. Ersetzen Sie jeden user input placeholder durch Ihre Informationen.

Befehl

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

Ausgabe

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

Informationen zu einem Snow Family-Gerät mithilfe von Snow Device Management überprüfen

Verwenden Sie den Befehl, um gerätespezifische Informationen wie Gerätetyp, Softwareversion, IP-Adressen und Sperrstatus zu überprüfen. describe-device Die Ausgabe umfasst außerdem Folgendes:

• lastReachedOutAt— Wann das Gerät das letzte Mal Kontakt mit dem aufgenommen hat AWS Cloud. Zeigt an, dass das Gerät online ist.

• lastUpdatedAt— Wann die Daten auf dem Gerät zuletzt aktualisiert wurden. Zeigt an, wann der Geräte-Cache aktualisiert wurde.

Verwenden Sie den folgenden Befehl, um die Geräteinformationen zu überprüfen. Ersetzen Sie jeden user input placeholder durch Ihre Informationen.

Befehl

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

Ausnahmen

ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
            

Ausgabe

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

Überprüfen des Status von EC2 Amazon-kompatiblen Instances auf Geräten der Snow Family mit Snow Device Management

Verwenden Sie den describe-ec2-instances Befehl, um den aktuellen Status der EC2 Amazon-Instance zu überprüfen. Die Ausgabe ähnelt der des describe-device Befehls, die Ergebnisse stammen jedoch aus dem Geräte-Cache im AWS Cloud und enthalten eine Teilmenge der verfügbaren Felder.

Verwenden Sie den folgenden Befehl, um den Status der Amazon EC2 -kompatiblen Instance zu überprüfen. Ersetzen Sie jeden user input placeholder durch Ihre Informationen.

Befehl

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

Ausnahmen

ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
            

Ausgabe

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

Aufgaben-Metadaten auf Geräten der Snow Family mit Snow Device Management anzeigen

Verwenden Sie den describe-task Befehl, um die Metadaten für eine bestimmte Aufgabe auf einem Gerät zu überprüfen. Die Metadaten für eine Aufgabe umfassen die folgenden Elemente:

• Die Zielgeräte

• Der Status der Aufgabe

• Wann die Aufgabe erstellt wurde

• Wann wurden die Daten auf dem Gerät zuletzt aktualisiert

• Wann wurde die Aufgabe abgeschlossen

• Die Beschreibung (falls vorhanden), die bei der Erstellung der Aufgabe angegeben wurde

Verwenden Sie den folgenden Befehl, um die Metadaten einer Aufgabe zu überprüfen. Ersetzen Sie jeden user input placeholder durch Ihre Informationen.

Befehl

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

Ausnahmen

ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
            

Ausgabe

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

Abbrechen einer Aufgabe auf einem Snow Family-Gerät mit Snow Device Management

Verwenden Sie den cancel-task Befehl, um eine Stornierungsanfrage für eine bestimmte Aufgabe zu senden. Sie können nur Aufgaben stornieren, die sich in dem QUEUED Status befinden, die noch nicht ausgeführt wurden. Aufgaben, die bereits ausgeführt werden, können nicht storniert werden.

Anmerkung

Eine Aufgabe, die Sie abbrechen möchten, wird möglicherweise trotzdem ausgeführt, wenn sie aus der Warteschlange bearbeitet wird, bevor der cancel-task Befehl den Status der Aufgabe ändert.

Verwenden Sie den folgenden Befehl, um eine Aufgabe abzubrechen. Ersetzen Sie jeden user input placeholder durch Ihre Informationen.

Befehl

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

Ausnahmen

ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
            

Ausgabe

{
    "taskId": "st-ficthmqoc2pht111"
}
            

Befehle und Syntax von Snow Device Management auflisten

Verwenden Sie den help Befehl, um eine Liste aller unterstützten Befehle für Snow Device Management API zurückzugeben. Sie können den help Befehl auch verwenden, um detaillierte Informationen zu und die Syntax für einen bestimmten Befehl zurückzugeben.

Verwenden Sie den folgenden Befehl, um alle unterstützten Befehle aufzulisten.

Befehl

aws snow-device-management help

Verwenden Sie den folgenden Befehl, um detaillierte Informationen und die Syntax für einen Befehl zurückzugeben. commandErsetzen Sie ihn durch den Namen des Befehls, an dem Sie interessiert sind.

Befehl

aws snow-device-management command help

Liste der Snow Family-Geräte, die für die Fernverwaltung verfügbar sind

Verwenden Sie den Befehl, um eine Liste aller Geräte in Ihrem Konto anzuzeigen, auf AWS-Region denen Snow Device Management aktiviert ist, auf denen der list-devices Befehl ausgeführt wird. --max-resultsund --next-token sind optional. Weitere Informationen finden Sie unter Verwenden von AWS CLI Paginierungsoptionen im "Benutzerhandbuch für die AWS Befehlszeilenschnittstelle“.

Verwenden Sie den folgenden Befehl, um Geräte aufzulisten, die per Fernzugriff verwaltet werden können. Ersetzen Sie jeden user input placeholder durch Ihre Informationen.

Befehl

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

Ausnahmen

ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
            

Ausgabe

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

Auflisten des Status der Snow Device Management-Aufgaben auf allen Geräten der Snow Family

Verwenden Sie den list-executions Befehl, um den Status von Aufgaben für ein oder mehrere Zielgeräte zurückzugeben. Verwenden Sie den --state Parameter, um die Rückgabeliste so zu filtern, dass Aufgaben angezeigt werden, die sich derzeit in einem bestimmten Status befinden. --max-resultsund --next-token sind optional. Weitere Informationen finden Sie unter Verwenden von AWS CLI Paginierungsoptionen im "Benutzerhandbuch für die AWS Befehlszeilenschnittstelle“.

Eine Aufgabe kann einen der folgenden Status haben:

• QUEUED

• IN_PROGRESS

• CANCELED

• FAILED

• COMPLETED

• REJECTED

• TIMED_OUT

Verwenden Sie den folgenden Befehl, um den Aufgabenstatus geräteübergreifend aufzulisten. Ersetzen Sie jeden user input placeholder durch Ihre Informationen.

Befehl

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

Ausnahmen

ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
            

Ausgabe

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

Auflisten verfügbarer Ressourcen auf Snow Family-Geräten mit Snow Device Management

Verwenden Sie den list-device-resources Befehl, um eine Liste der für ein Gerät verfügbaren AWS Ressourcen zurückzugeben. Verwenden Sie den --type Parameter, um die Liste nach einem bestimmten Ressourcentyp zu filtern. Derzeit sind EC2 Amazon-kompatible Instances der einzige unterstützte Ressourcentyp. --max-resultsund --next-token sind optional. Weitere Informationen finden Sie unter Verwenden von AWS CLI Paginierungsoptionen im "Benutzerhandbuch für die AWS Befehlszeilenschnittstelle“.

Verwenden Sie den folgenden Befehl, um die verfügbaren Ressourcen für ein Gerät aufzulisten. Ersetzen Sie jeden user input placeholder durch Ihre Informationen.

Befehl

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

Ausnahmen

ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
            

Ausgabe

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

Auflisten von Tags für Snow Family-Geräte oder Snow Device Management-Tags

Verwenden Sie den list-tags-for-resource Befehl, um eine Liste von Tags für ein verwaltetes Gerät oder eine verwaltete Aufgabe zurückzugeben.

Verwenden Sie den folgenden Befehl, um die Tags für ein Gerät aufzulisten. Ersetzen Sie das Beispiel Amazon Resource Name (ARN) durch das ARN für Ihr Gerät.

Befehl

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

Ausnahmen

AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException

Ausgabe

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

Auflisten der Aufgaben von Snow Device Management nach Status

Verwenden Sie den list-tasks Befehl, um eine Liste der Aufgaben von den Geräten in der AWS Region zurückzugeben, in der der Befehl ausgeführt wird. Verwenden Sie den --state ParameterIN_PROGRESS, um die Ergebnisse nachCOMPLETED, oder CANCELED Status zu filtern. --max-resultsund --next-token sind optional. Weitere Informationen finden Sie unter Verwenden von AWS CLI Paginierungsoptionen im "Benutzerhandbuch für die AWS Befehlszeilenschnittstelle“.

Verwenden Sie den folgenden Befehl, um Aufgaben nach Status aufzulisten. Ersetzen Sie jeden user input placeholder durch Ihre Informationen.

Befehl

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

Ausnahmen

ValidationException
InternalServerException
ThrottlingException
AccessDeniedException

Ausgabe

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

Anwenden von Tags auf Snow Device Management-Aufgaben oder Snow Family-Geräte

Verwenden Sie den tag-resource Befehl, um ein Tag für ein Gerät oder für eine Aufgabe auf einem Gerät hinzuzufügen oder zu ersetzen. Der --tags Parameter akzeptiert eine durch Kommas getrennte Liste von Key=Value Paaren.

Verwenden Sie den folgenden Befehl, um Tags auf ein Gerät anzuwenden. Ersetzen Sie jeden user input placeholder durch Ihre Informationen.

Befehl

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

Ausnahmen

AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException

Entfernen von Snow Device Management-Tags von Aufgaben oder Snow Family-Geräten

Verwenden Sie den untag-resources Befehl, um ein Tag von einem Gerät oder von einer Aufgabe auf einem Gerät zu entfernen.

Verwenden Sie den folgenden Befehl, um Tags von einem Gerät zu entfernen. Ersetzen Sie jeden user input placeholder durch Ihre Informationen.

Befehl

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

Ausnahmen

AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException