

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS Snowball Edge Device Management を使用して Snowball Edge を管理する
<a name="aws-sdm"></a>

AWS Snowball Edge Device Management では、Snowball Edge とローカル AWS サービスをリモートで管理できます。すべての Snowball Edge は Snowball Edge デバイス管理をサポートしており、Snowball Edge が利用可能なほとんどの AWS リージョン の新しいデバイスにインストールされています。

Snowball Edge Device Management では、次のタスクを実行できます。
+ タスクを作成する
+ タスクのステータスを確認する
+ タスクのメタデータを確認する
+ タスクをキャンセルする
+ デバイス情報を確認する
+ Amazon EC2 互換インスタンスのステータスを確認する
+ コマンドと構文を一覧表示する
+ リモート管理可能なデバイスを一覧表示する
+ デバイスを横断してタスクのステータスを一覧表示する
+ 利用可能なリソースを一覧表示する
+ タスクをステータス別に一覧表示する
+ デバイスタグまたはタスクタグを一覧表示する
+ タグを適用する
+ タグを削除する

**Topics**
+ [Snowball Edge を注文する際の Snowball Edge デバイス管理状態の選択](#order-device-sdm-state)
+ [Snowball Edge での Snowball Edge デバイス管理のアクティブ化](#enable-sdm)
+ [Snowball Edge デバイス管理のアクセス許可を Snowball Edge の IAM ロールに追加する](#iam-sdm)
+ [Snowball Edge Device Management CLI コマンド](#sdm-cli-commands)

## Snowball Edge を注文する際の Snowball Edge デバイス管理状態の選択
<a name="order-device-sdm-state"></a>

Snow デバイスを注文するジョブを作成するときは、デバイスを受信したときに Snowball Edge Device Management がどの状態になるかを選択できます。インストールされているが、アクティブ化されていないか、またはインストールおよびアクティブ化されていないかを選択できます。インストールされているがアクティブ化されていない場合は、使用する前に AWS OpsHub または Snowball Edge クライアントを使用してアクティブ化する必要があります。インストールされてアクティブ化されている場合は、デバイスを受信してローカルネットワークに接続した後に Snowball Edge Device Management を使用できます。Snowball Edge デバイス管理状態は、、Snowball Edge クライアント AWS Snow ファミリーマネジメントコンソール、、 AWS CLIまたは Snow ジョブ管理 API を使用してデバイスを注文するジョブを作成するときに選択できます。

**から Snowball Edge Device Management の状態を選択するには AWS Snow ファミリーマネジメントコンソール**

1. Snowball Edge Device Management をインストールしてアクティブ化するには、 ** AWS OpsHub または Snowball クライアントを使用して Snow デバイスをリモートで管理**を選択します。

1. Snowball Edge Device Management をインストールしてもアクティブ化しない場合は、 ** AWS OpsHub または Snowball クライアントを使用して Snow デバイスをリモートで管理**を選択しないでください。

詳細については、このガイドの「[Step 3: Choose your features and options](https://docs.aws.amazon.com/snowball/latest/developer-guide/import-job-details.html)」を参照してください。

**Snowball Edge デバイス管理状態を AWS CLI、、Snowball Edge クライアント、または Snow ジョブ管理 API から選択するには：**
+ `remote-management` パラメータを使用して、Snowball Edge Device Management の状態を指定します。パラメータの`INSTALLED_ONLY`値は、Snowball Edge Device Management がインストールされているがアクティブ化されていないことを意味します。パラメータの`INSTALLED_AUTOSTART`値は、Snowball Edge Device Management がインストールされ、アクティブ化されていることを意味します。このパラメータに値を指定しない場合は、`INSTALLED_ONLY` がデフォルト値です。

**Example `create-job` コマンドの `remote-management` パラメータの構文例**  

```
  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 \
```
詳細については、[「 API リファレンス」の「ジョブ管理](https://docs.aws.amazon.com/snowball/latest/api-reference/api-reference.html) AWS Snowball Edge API リファレンス」を参照してください。

## Snowball Edge での Snowball Edge デバイス管理のアクティブ化
<a name="enable-sdm"></a>

Snowball Edge クライアントを使用して Snowball Edge Device Management をアクティブ化するには、次の手順に従います。

この手順を使用する前に、以下の操作を行ってください。
+ Snowball Edge クライアントの最新バージョンをダウンロードしてインストールします。詳細については、[Downloading and Installing the Snowball Client](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client.html#download-client) を参照してください。
+ マニフェストファイルをダウンロードし、Snowball Edge デバイスのロック解除コードを取得します。詳細については、「[Getting Your Credentials and Tools](https://docs.aws.amazon.com/snowball/latest/developer-guide/get-credentials.html)」を参照してください。
+ Snowball Edge デバイスをローカルネットワークに接続します。詳細については、[「ローカルネットワーク](https://docs.aws.amazon.com/snowball/latest/developer-guide/getting-started-connect.html)への接続」を参照してください。
+ Snowball Edge デバイスのロックを解除します。詳細については、「[Unlocking the Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/unlockdevice.html)」を参照してください。

```
  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
```

コマンドが成功すると、Snowball Edge クライアントは以下を返します。

```
  {
    "RemoteManagementState" : "INSTALLED_AUTOSTART"
  }
```

## Snowball Edge デバイス管理のアクセス許可を Snowball Edge の IAM ロールに追加する
<a name="iam-sdm"></a>

デバイスの注文 AWS アカウント 元の で、 (IAM) ロールを作成し AWS Identity and Access Management 、次のポリシーをロールに追加します。次に、Snowball Edge Device Management を使用してデバイスをリモート管理するためにログインする IAM ユーザーにロールを割り当てます。詳細については、[IAM ロールの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html)および[AWS アカウントでの IAM ユーザーの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html)を参照してください。

**Policy**

------
#### [ JSON ]

****  

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

------

## Snowball Edge Device Management CLI コマンド
<a name="sdm-cli-commands"></a>

このセクションでは、Snowball Edge Device Management を使用して Snowball Edge をリモートで管理するために使用できる AWS CLI コマンドについて説明します。を使用してリモート管理タスクを実行することもできます AWS OpsHub。詳細については、「[」を参照してください AWS](https://docs.aws.amazon.com/snowball/latest/developer-guide/manage-services.html)。

**注記**  
 デバイスを管理する前に、デバイスの電源がオンになっており、ネットワークに接続されており、プロビジョニングされた AWS リージョン に接続できることを確認してください。

**Topics**
+ [Snowball Edge Device Management で Snowball Edge を管理するタスクの作成](#sdm-cli-create-task)
+ [Snowball Edge を管理するタスクのステータスの確認](#sdm-cli-describe-execution)
+ [Snowball Edge Device Management を使用した Snowball Edge に関する情報の確認](#sdm-cli-describe-device)
+ [Snowball Edge Device Management を使用した Snowball Edge での Amazon EC2-compatibleインスタンスの状態の確認](#sdm-cli-describe-ec2-instances)
+ [Snowball Edge Device Management を使用した Snowball Edge でのタスクメタデータの表示](#sdm-cli-describe-task)
+ [Snowball Edge デバイス管理を使用した Snowball Edge でのタスクのキャンセル](#sdm-cli-cancel-task)
+ [Snowball Edge Device Management コマンドと構文の一覧表示](#sdm-cli-help)
+ [リモート管理に使用できる Snowball Edge の一覧表示](#sdm-cli-list-devices)
+ [Snowball Edge 全体の Snowball Edge Device Management タスクのステータスの一覧表示](#sdm-cli-list-executions)
+ [Snowball Edge Device Management を使用した Snowball Edge で利用可能なリソースの一覧表示](#sdm-cli-list-device-resources)
+ [Snowball Edge または Snowball Edge Device Management タグのタグの一覧表示](#sdm-cli-list-tags-for-resource)
+ [ステータス別の Snowball Edge Device Management タスクの一覧表示](#sdm-cli-list-tasks)
+ [Snowball Edge デバイス管理タスクまたは Snowball Edge へのタグの適用](#sdm-cli-tag-resource)
+ [タスクまたは Snowball Edge からの Snowball Edge Device Management タグの削除](#sdm-cli-untag-resources)

### Snowball Edge Device Management で Snowball Edge を管理するタスクの作成
<a name="sdm-cli-create-task"></a>

1 台以上のターゲットデバイスに、ロック解除や再起動などのタスクを実行するよう指示を出すときは、`create-task` を使用します。ターゲットデバイスを指定するときは、`--targets` パラメータを使って管理対象のデバイスの ID の一覧を提供し、`--command` パラメータを使って実行するタスクを指定します。1 台のデバイスで実行できるコマンドは、1 回に 1 つのみです。

サポートされているコマンド
+ `unlock` (引数なし)
+ `reboot` (引数なし)

ターゲットデバイスごとに実行するタスクを作成するには、次のコマンドを使用します。`user input placeholder` を、ユーザー自身の情報に置き換えます。

**コマンド**

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

**例外**

```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
ServiceQuotaExceededException
```

**出力**

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

### Snowball Edge を管理するタスクのステータスの確認
<a name="sdm-cli-describe-execution"></a>

1 台以上のターゲットデバイスで実行されている、リモートタスクのステータスを確認するには、`describe-execution` コマンドを使用します。

タスクは、次のいずれかのステータスになります。
+ `QUEUED`
+ `IN_PROGRESS`
+ `CANCELED`
+ `FAILED`
+ `COMPLETED`
+ `REJECTED`
+ `TIMED_OUT`

タスクのステータスを確認するには、次のコマンドを使用します。`user input placeholder` を、ユーザー自身の情報に置き換えます。

**コマンド**

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

**出力**

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

### Snowball Edge Device Management を使用した Snowball Edge に関する情報の確認
<a name="sdm-cli-describe-device"></a>

デバイスに固有の情報 (デバイスタイプ、ソフトウェアバージョン、IP アドレス、ロック状態など) を確認するには、`describe-device` コマンドを使用します。出力には、以下も含まれています。
+ `lastReachedOutAt` - デバイスが最後に AWS クラウドに連絡した日時。デバイスがオンラインであることを示します。
+ `lastUpdatedAt` — デバイスでデータが最後に更新された日時。デバイスキャッシュがいつ更新されたかを示します。

デバイス情報を確認するには、次のコマンドを使用します。`user input placeholder` を、ユーザー自身の情報に置き換えます。

**コマンド**

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

**例外**

```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```

### Snowball Edge Device Management を使用した Snowball Edge での Amazon EC2-compatibleインスタンスの状態の確認
<a name="sdm-cli-describe-ec2-instances"></a>

Amazon EC2 インスタンスの現在のステータスを確認するには、`describe-ec2-instances` コマンドを使用します。出力は `describe-device` コマンドの出力と似ていますが、結果は のデバイスキャッシュから取得 AWS クラウド され、使用可能なフィールドのサブセットが含まれます。

Amazon EC2 互換インスタンスのステータスを確認するには、次のコマンドを使用します。`user input placeholder` を、ユーザー自身の情報に置き換えます。

**コマンド**

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

**例外**

```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```

**出力**

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

### Snowball Edge Device Management を使用した Snowball Edge でのタスクメタデータの表示
<a name="sdm-cli-describe-task"></a>

デバイスの任意のタスクのメタデータを確認するには、`describe-task` コマンドを使用します。タスクのメタデータには、次の項目が含まれています。
+ ターゲットデバイス
+ タスクのステータス
+ タスクが作成された日時
+ デバイスでデータが最後に更新された日時
+ タスクが完了した日時
+ タスクの作成時に記入された説明 (もしある場合)

タスクのメタデータを確認するには、次のコマンドを使用します。`user input placeholder` を、ユーザー自身の情報に置き換えます。

**コマンド**

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

**例外**

```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```

**出力**

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

### Snowball Edge デバイス管理を使用した Snowball Edge でのタスクのキャンセル
<a name="sdm-cli-cancel-task"></a>

特定のタスクのキャンセルリクエストを送信するには、`cancel-task` コマンドを使用します。キャンセルできるのは、ステータスが `QUEUED` である、まだ実行されていないタスクのみです。既に実行されたタスクはキャンセルできません。

**注記**  
キャンセルしようとしたタスクが、`cancel-task` コマンドでステータスを変更する前にキューから処理されると、その実行が継続される可能性があります。

タスクをキャンセルするには、次のコマンドを使用します。`user input placeholder` を、ユーザー自身の情報に置き換えます。

**コマンド**

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

**例外**

```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```

**出力**

```
{
    "taskId": "st-ficthmqoc2pht111"
}
```

### Snowball Edge Device Management コマンドと構文の一覧表示
<a name="sdm-cli-help"></a>

Snowball Edge Device Management API でサポートされているすべてのコマンドのリストを返すには、 `help` コマンドを使用します。任意のコマンドの詳細情報および構文を返すときは、`help` コマンドも使用できます。

サポートされているすべてのコマンドを一覧表示するには、次のコマンドを使用します。

**コマンド**

```
aws snow-device-management help
```

コマンドの詳細情報および構文を返すときは、次のコマンドを使用します。`command` を、ユーザーが希望するコマンドの名前に置き換えます。

**コマンド**

```
aws snow-device-management command help
```

### リモート管理に使用できる Snowball Edge の一覧表示
<a name="sdm-cli-list-devices"></a>

 AWS リージョン コマンドが実行されている で Snowball Edge Device Management が有効になっているアカウント上のすべてのデバイスのリストを返すには、 `list-devices` コマンドを使用します。 `--max-results`および はオプション`--next-token`です。詳細については、AWS 「 コマンドラインインターフェイスユーザーガイド」の[AWS CLI 「ページ分割オプションの使用](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html)」を参照してください。

リモート管理可能なデバイスを一覧表示するには、次のコマンドを使用します。`user input placeholder` を、ユーザー自身の情報に置き換えます。

**コマンド**

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

**例外**

```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```

**出力**

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

### Snowball Edge 全体の Snowball Edge Device Management タスクのステータスの一覧表示
<a name="sdm-cli-list-executions"></a>

1 台以上のターゲットデバイスの、タスクのステータスを返すには、`list-executions` コマンドを使用します。返されたリストをフィルタリングして、現在、特定の状態にあるタスクを表示するには、`--state` パラメータ使用します。`--max-results` と `--next-token` はオプションです。詳細については、AWS 「 コマンドラインインターフェイスユーザーガイド」の[AWS CLI 「ページ分割オプションの使用](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html)」を参照してください。

タスクは、次のいずれかのステータスになります。
+ `QUEUED`
+ `IN_PROGRESS`
+ `CANCELED`
+ `FAILED`
+ `COMPLETED`
+ `REJECTED`
+ `TIMED_OUT`

デバイスを横断してタスクのステータスを一覧表示するには、次のコマンドを使用します。`user input placeholder` を、ユーザー自身の情報に置き換えます。

**コマンド**

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

**例外**

```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```

**出力**

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

### Snowball Edge Device Management を使用した Snowball Edge で利用可能なリソースの一覧表示
<a name="sdm-cli-list-device-resources"></a>

デバイスで使用できる AWS リソースのリストを返すには、 `list-device-resources` コマンドを使用します。特定のタイプのリソースでリストをフィルタリングするには、`--type` パラメータを使用します。現在、Amazon EC2 互換インスタンスは唯一サポートされているリソースタイプです。`--max-results` と `--next-token` はオプションです。詳細については、AWS 「 コマンドラインインターフェイスユーザーガイド」の[AWS CLI 「ページ分割オプションの使用](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html)」を参照してください。

デバイスで利用可能なリソースを一覧表示するには、次のコマンドを使用します。`user input placeholder` を、ユーザー自身の情報に置き換えます。

**コマンド**

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

**例外**

```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```

**出力**

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

### Snowball Edge または Snowball Edge Device Management タグのタグの一覧表示
<a name="sdm-cli-list-tags-for-resource"></a>

管理対象デバイスまたはタスクの、タグの一覧を返すには、`list-tags-for-resource` コマンドを使用します。

デバイスのタグを一覧表示するには、次のコマンドを使用します。例にある Amazon リソースネーム (ARN) を、お使いのデバイスの ARN に置き換えます。

**コマンド**

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

**例外**

```
AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException
```

**出力**

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

### ステータス別の Snowball Edge Device Management タスクの一覧表示
<a name="sdm-cli-list-tasks"></a>

`list-tasks` コマンドを使用して、コマンドが実行されている AWS リージョンのデバイスからタスクのリストを返します。`IN_PROGRESS`、`COMPLETED`、または `CANCELED` のステータス別に結果をフィルタリングするには、`--state` パラメータを使用します。`--max-results` と `--next-token` はオプションです。詳細については、AWS 「 コマンドラインインターフェイスユーザーガイド」の[AWS CLI 「ページ分割オプションの使用](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html)」を参照してください。

タスクをステータス別に一覧表示するには、次のコマンドを使用します。`user input placeholder` を、ユーザー自身の情報に置き換えます。

**コマンド**

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

**例外**

```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```

**出力**

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

### Snowball Edge デバイス管理タスクまたは Snowball Edge へのタグの適用
<a name="sdm-cli-tag-resource"></a>

デバイスのタグ、またはデバイス上のタスクのタグを、追加または置換するには、`tag-resource` コマンドを使用します。`--tags` パラメータは、`Key=Value` ペアの、コンマ区切りのリストを受け入れます。

デバイスのタグを適用するには、次のコマンドを使用します。`user input placeholder` を、ユーザー自身の情報に置き換えます。

**コマンド**

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

**例外**

```
AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException
```

### タスクまたは Snowball Edge からの Snowball Edge Device Management タグの削除
<a name="sdm-cli-untag-resources"></a>

デバイスのタグ、またはデバイス上のタスクのタグを削除するには、`untag-resources` コマンドを使用します。

デバイスのタグを削除するには、次のコマンドを使用します。`user input placeholder` を、ユーザー自身の情報に置き換えます。

**コマンド**

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

**例外**

```
AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException
```