기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS Snowball Edge Device Management 를 사용하여 Snowball Edge 관리
AWS Snowball Edge Device Management 를 사용하면 Snowball Edge 및 로컬 AWS 서비스를 원격으로 관리할 수 있습니다. 모든 Snowball Edge는 Snowball Edge 디바이스 관리를 지원하며 Snowball Edge를 사용할 수 있는 대부분의 AWS 리전 에서 새 디바이스에 설치됩니다.
Snowball Edge 디바이스 관리를 사용하면 다음 작업을 수행할 수 있습니다.
+ 작업 생성
+ 태스크 상태 확인
+ 태스크 메타데이터 확인
+ 태스크 취소
+ 디바이스 정보 확인
+ Amazon EC2 호환 인스턴스 상태 확인
+ 명령 및 구문 나열
+ 원격 관리 가능 디바이스 나열
+ 디바이스 전반의 태스크 상태 나열
+ 사용 가능한 리소스 나열
+ 상태별로 태스크 나열
+ 디바이스 또는 태스크 태그 나열
+ 태그 적용
+ 태그 제거
**Topics**
+ [Snowball Edge 주문 시 Snowball Edge 디바이스 관리 상태 선택](#order-device-sdm-state)
+ [Snowball Edge에서 Snowball Edge 디바이스 관리 활성화](#enable-sdm)
+ [Snowball Edge의 IAM 역할에 Snowball Edge 디바이스 관리에 대한 권한 추가](#iam-sdm)
+ [Snowball Edge Device Management CLI 명령](#sdm-cli-commands)
## Snowball Edge 주문 시 Snowball Edge 디바이스 관리 상태 선택
Snow 디바이스를 주문하는 작업을 생성할 때 디바이스를 수신할 때 Snowball Edge 디바이스 관리의 상태를 선택할 수 있습니다. 설치되었지만 활성화되지 않았거나 설치 및 활성화되지 않았습니다. 설치되었지만 활성화되지 않은 경우 사용하기 전에 AWS OpsHub 또는 Snowball Edge 클라이언트를 사용하여 활성화해야 합니다. 설치 및 활성화된 경우 디바이스를 수신하고 로컬 네트워크에 연결한 후 Snowball Edge Device Management를 사용할 수 있습니다. 작업을 생성할 때 Snowball Edge 디바이스 관리 상태를 선택하여 AWS Snow 패밀리 관리 콘솔, Snowball Edge 클라이언트 AWS CLI, 또는 Snow 작업 관리 API를 통해 디바이스를 주문할 수 있습니다.
**에서 Snowball Edge 디바이스 관리 상태를 선택하려면 AWS Snow 패밀리 관리 콘솔**
1. Snowball Edge Device Management를 설치하고 활성화하도록 선택하려면 ** AWS OpsHub 또는 Snowball 클라이언트를 사용하여 원격으로 Snow 디바이스 관리를** 선택합니다.
1. Snowball Edge Device Management를 설치하되 활성화하지 않도록 선택하려면 ** AWS OpsHub 또는 Snowball 클라이언트를 사용하여 원격으로 Snow 디바이스 관리를** 선택하지 마십시오.
자세한 내용은 이 안내서의 [3단계: 기능 및 옵션 선택](https://docs.aws.amazon.com/snowball/latest/developer-guide/import-job-details.html) 을 참조하세요.
**AWS CLI, Snowball Edge 클라이언트 또는 Snow 작업 관리 API에서 Snowball Edge 디바이스 관리 상태를 선택하려면**
+ `remote-management` 파라미터를 사용하여 Snowball Edge 디바이스 관리 상태를 지정합니다. 파라미터 `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 디바이스 관리 활성화
다음 절차에 따라 Snowball Edge 클라이언트를 사용하여 Snowball Edge 디바이스 관리를 활성화합니다.
이 절차를 사용하기 전에 다음을 수행하십시오.
+ 최신 버전의 Snowball Edge 클라이언트 CLI를 다운로드 및 설치합니다. 자세한 내용은 [Snowball 클라이언트 다운로드 및 설치](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client.html#download-client)를 참조하십시오.
+ 매니페스트 파일을 다운로드하고 Snowball Edge 디바이스의 잠금 해제 코드를 가져옵니다. 자세한 내용은 [자격 증명 및 도구 가져오기](https://docs.aws.amazon.com/snowball/latest/developer-guide/get-credentials.html)를 참조하세요.
+ Snowball Edge 디바이스를 로컬 네트워크에 연결합니다. 자세한 내용은 [로컬 NetworkDevice 사양에 연결을 참조하세요](https://docs.aws.amazon.com/snowball/latest/developer-guide/getting-started-connect.html).
+ Snowball Edge 디바이스의 잠금을 해제합니다. 자세한 내용은 [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의 IAM 역할에 Snowball Edge 디바이스 관리에 대한 권한 추가
디바이스가 주문된 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)을 참조하세요.
**정책**
------
#### [ 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 명령
이 섹션에서는 Snowball Edge 디바이스 관리를 사용하여 Snowball Edge를 원격으로 관리하는 데 사용할 수 있는 AWS CLI 명령을 설명합니다. 를 사용하여 일부 원격 관리 작업을 수행할 수도 있습니다 AWS OpsHub. 자세한 내용은 [디바이스에서 AWS 서비스 관리를 참조하세요](https://docs.aws.amazon.com/snowball/latest/developer-guide/manage-services.html).
**참고**
디바이스를 관리하기 전에 디바이스가 켜져 있고 네트워크에 연결되어 있으며 프로비저닝된 AWS 리전 에 연결할 수 있는지 확인합니다.
**Topics**
+ [Snowball Edge 디바이스 관리를 사용하여 Snowball Edge를 관리하는 작업 생성](#sdm-cli-create-task)
+ [Snowball Edge를 관리하기 위한 작업 상태 확인](#sdm-cli-describe-execution)
+ [Snowball Edge 디바이스 관리를 사용하여 Snowball Edge에 대한 정보 확인](#sdm-cli-describe-device)
+ [Snowball Edge 디바이스 관리를 사용하여 Snowball Edge에서 Amazon EC2-compatible 인스턴스 상태 확인](#sdm-cli-describe-ec2-instances)
+ [Snowball Edge 디바이스 관리를 사용하여 Snowball Edge에서 태스크 메타데이터 보기](#sdm-cli-describe-task)
+ [Snowball Edge 디바이스 관리를 사용하여 Snowball Edge에서 작업 취소](#sdm-cli-cancel-task)
+ [Snowball Edge 디바이스 관리 명령 및 구문 나열](#sdm-cli-help)
+ [원격 관리에 사용할 수 있는 Snowball Edge 나열](#sdm-cli-list-devices)
+ [Snowball Edge에서 Snowball Edge 디바이스 관리 작업 상태 나열](#sdm-cli-list-executions)
+ [Snowball Edge 디바이스 관리를 사용하여 Snowball Edge에서 사용 가능한 리소스 나열](#sdm-cli-list-device-resources)
+ [Snowball Edge 또는 Snowball Edge 디바이스 관리 태그 나열](#sdm-cli-list-tags-for-resource)
+ [상태별 Snowball Edge 디바이스 관리 작업 나열](#sdm-cli-list-tasks)
+ [Snowball Edge 디바이스 관리 작업 또는 Snowball Edge에 태그 적용](#sdm-cli-tag-resource)
+ [작업 또는 Snowball Edge에서 Snowball Edge 디바이스 관리 태그 제거](#sdm-cli-untag-resources)
### Snowball Edge 디바이스 관리를 사용하여 Snowball Edge를 관리하는 작업 생성
하나 이상의 대상 디바이스에 잠금 해제 또는 재부팅과 같은 작업을 수행하도록 지시하려면 `create-task`를 사용합니다. `--targets` 파라미터와 함께 관리 대상 디바이스 ID 목록을 제공하여 대상 디바이스를 지정하고, `--command` 파라미터로 수행할 작업을 지정합니다. 디바이스에서 한 번에 하나의 명령을 실행할 수 있습니다.
지원되는 명령:
+ `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를 관리하기 위한 작업 상태 확인
하나 이상의 대상 디바이스에서 실행 중인 원격 태스크의 상태를 확인하려면 `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 디바이스 관리를 사용하여 Snowball Edge에 대한 정보 확인
디바이스 유형, 소프트웨어 버전, 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 디바이스 관리를 사용하여 Snowball Edge에서 Amazon EC2-compatible 인스턴스 상태 확인
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 디바이스 관리를 사용하여 Snowball Edge에서 태스크 메타데이터 보기
디바이스에서 특정 태스크의 메타데이터를 확인하려면 `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에서 작업 취소
특정 태스크의 취소 요청을 보내려면 `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 디바이스 관리 명령 및 구문 나열
Snowball Edge Device Management API에 대해 지원되는 모든 명령 목록을 반환하려면 `help` 명령을 사용합니다. 또한 `help` 명령을 사용하여 해당 명령에 대한 세부 정보와 구문을 반환할 수 있습니다.
지원되는 명령을 모두 나열하려면 다음 명령을 사용합니다.
**명령**
```
aws snow-device-management help
```
명령의 구체적인 정보 및 구문을 반환하려면 다음 명령을 사용합니다. `command`을 관심 있는 명령의 이름으로 바꿉니다.
**명령**
```
aws snow-device-management command help
```
### 원격 관리에 사용할 수 있는 Snowball Edge 나열
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 디바이스 관리 작업 상태 나열
하나 이상의 대상 디바이스에 대한 태스크 상태를 반환하려면 `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 디바이스 관리를 사용하여 Snowball Edge에서 사용 가능한 리소스 나열
디바이스에 사용할 수 있는 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 디바이스 관리 태그 나열
관리 대상 디바이스 또는 태스크의 태그 목록을 반환하려면 `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 디바이스 관리 작업 나열
`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에 태그 적용
디바이스 또는 디바이스상의 태스크에 태그를 추가하거나 바꾸려면 `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 디바이스 관리 태그 제거
디바이스 또는 디바이스상의 태스크에서 태그를 제거하려면 `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
```