AWS Snow Device Management 를 사용하여 Snow Family 디바이스 관리 - AWS Snowball Edge 개발자 안내서

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS Snow Device Management 를 사용하여 Snow Family 디바이스 관리

AWS Snow Device Management 를 사용하면 Snow Family 디바이스와 로컬 AWS 서비스를 원격으로 관리할 수 있습니다. 모든 Snow Family 디바이스는 Snow Device Management를 지원하며 Snow Family 디바이스를 사용할 수 있는 대부분의 AWS 리전 에서 새 디바이스에 설치됩니다.

Snow Device Management를 사용하여 다음 작업을 수행할 수 있습니다.

  • 작업 생성

  • 태스크 상태 확인

  • 태스크 메타데이터 확인

  • 태스크 취소

  • 디바이스 정보 확인

  • Amazon EC2호환 인스턴스 상태 확인

  • 명령 및 구문 나열

  • 원격 관리 가능 디바이스 나열

  • 디바이스 전반의 태스크 상태 나열

  • 사용 가능한 리소스 나열

  • 상태별로 태스크 나열

  • 디바이스 또는 태스크 태그 나열

  • 태그 적용

  • 태그 제거

Snow Family 디바이스 주문 시 Snow Device Management 상태 선택

Snow 디바이스를 주문하는 작업을 생성할 때 디바이스를 수신할 때 Snow Device Management의 상태를 선택할 수 있습니다. 설치되었지만 활성화되지 않았거나 설치 및 활성화되지 않았습니다. 설치되었지만 활성화되지 않은 경우 사용하기 전에 AWS OpsHub 또는 Snowball Edge 클라이언트를 사용하여 활성화해야 합니다. 설치 및 활성화된 경우 디바이스를 수신하고 로컬 네트워크에 연결한 후 Snow Device Management를 사용할 수 있습니다. 작업을 생성할 때 Snow Device Management 상태를 선택하여 AWS Snow 패밀리 관리 콘솔, Snowball Edge 클라이언트, AWS CLI또는 Snow 작업 관리 를 통해 디바이스를 주문할 수 있습니다API.

에서 Snow Device Management 상태를 선택하려면 AWS Snow 패밀리 관리 콘솔
  1. Snow Device Management를 설치하고 활성화하도록 선택하려면 AWS OpsHub 또는 Snowball 클라이언트 를 사용하여 Snow 디바이스를 원격으로 관리를 선택합니다.

  2. Snow Device Management를 설치했지만 활성화하지 않도록 선택하려면 AWS OpsHub 또는 Snowball 클라이언트 를 사용하여 Snow 디바이스 원격 관리를 선택하지 마세요.

자세한 내용은 이 안내서의 3단계: 기능 및 옵션 선택 .

AWS CLI, Snowball Edge 클라이언트 또는 Snow 작업 관리에서 Snow Device Management 상태를 선택하려면API:
  • remote-management 파라미터를 사용하여 Snow Device Management 상태를 지정합니다. 파라미터 INSTALLED_ONLY 값은 Snow Device Management가 설치되었지만 활성화되지 않았음을 의미합니다. 파라미터 INSTALLED_AUTOSTART 값은 Snow Device Management가 설치 및 활성화되었음을 의미합니다. 이 파라미터의 값을 지정하지 않으면 INSTALLED_ONLY가 기본값입니다.

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 참조의 작업 관리 참조를 AWS Snowball API 참조하세요.

Snow Family 디바이스에서 Snow 디바이스 관리 활성화

다음 절차에 따라 Snowball Edge 클라이언트를 사용하여 Snow Device Management를 활성화합니다.

이 절차를 사용하기 전에 다음을 수행합니다.

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

Snow Family 디바이스의 IAM 역할에 Snow Device Management에 대한 권한 추가

디바이스가 주문된 AWS 계정 에서 (IAM) 역할을 생성하고 AWS Identity and Access Management 역할에 다음 정책을 추가합니다. 그런 다음 Snow Device Management로 디바이스를 원격으로 관리하기 위해 로그인할 IAM 사용자에게 역할을 할당합니다. 자세한 내용은 에서 IAM 역할 생성 및 사용자 생성을 참조하세요. IAM AWS 계정

정책

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

Snow Device Management CLI 명령

이 섹션에서는 Snow Device Management를 사용하여 Snow Family 디바이스를 원격으로 관리하는 데 사용할 수 있는 AWS CLI 명령을 설명합니다. 를 사용하여 일부 원격 관리 작업을 수행할 수도 있습니다 AWS OpsHub for Snow Family. 자세한 내용은 . 디바이스에서 AWS 서비스 관리를 참조하세요.

참고

디바이스를 관리하기 전에 디바이스의 전원이 켜져 있고 네트워크에 연결되어 있으며 프로비저닝된 AWS 리전 에 연결할 수 있는지 확인하세요.

Snow Device Management를 사용하여 Snow Family 디바이스를 관리하는 작업 생성

하나 이상의 대상 디바이스에 잠금 해제 또는 재부팅과 같은 작업을 수행하도록 지시하려면 create-task를 사용합니다. --targets 파라미터가 IDs 포함된 관리형 디바이스 목록을 제공하여 대상 디바이스를 지정하고 --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" }

Snow Family 디바이스를 관리하기 위한 작업 상태 확인

하나 이상의 대상 디바이스에서 실행 중인 원격 태스크의 상태를 확인하려면 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" }

Snow Device Management를 사용하여 Snow Family 디바이스에 대한 정보 확인

디바이스 유형, 소프트웨어 버전, 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

출력

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

Snow Device Management를 사용하여 Snow Family 디바이스에서 Amazon EC2호환 인스턴스의 상태 확인

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

Snow Device Management를 사용하여 Snow Family 디바이스에서 태스크 메타데이터 보기

디바이스에서 특정 태스크의 메타데이터를 확인하려면 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" }

Snow Device Management를 사용하여 Snow Family 디바이스에서 작업 취소

특정 태스크의 취소 요청을 보내려면 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" }

Snow Device Management 명령 및 구문 나열

Snow Device Management 에 대해 지원되는 모든 명령 목록을 반환하려면 help 명령을 API사용합니다. 또한 help 명령을 사용하여 해당 명령에 대한 세부 정보와 구문을 반환할 수 있습니다.

지원되는 명령을 모두 나열하려면 다음 명령을 사용합니다.

명령

aws snow-device-management help

명령의 구체적인 정보 및 구문을 반환하려면 다음 명령을 사용합니다. command을 관심 있는 명령의 이름으로 바꿉니다.

명령

aws snow-device-management command help

원격 관리에 사용할 수 있는 Snow Family 디바이스 나열

명령이 실행된 AWS 리전 에서 Snow Device Management가 활성화된 계정의 모든 디바이스 목록을 반환하려면 list-devices 명령을 사용합니다. --max-results--next-token은 선택 사항입니다. 자세한 내용은 “AWS 명령줄 인터페이스 사용 설명서”의 AWS CLI 페이지 매김 옵션 사용을 참조하세요.

원격 관리 가능 디바이스의 목록을 보려면 다음 명령을 사용합니다. 각 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": {} } ] }

Snow Family 디바이스에서 Snow 디바이스 관리 작업 상태 나열

하나 이상의 대상 디바이스에 대한 태스크 상태를 반환하려면 list-executions 명령을 사용합니다. 반환 목록을 필터링하여 현재 하나의 특정 상태에 있는 작업을 표시하려면 --state 파라미터를 사용합니다. --max-results--next-token은 선택 사항입니다. 자세한 내용은 “AWS 명령줄 인터페이스 사용 설명서”의 AWS CLI 페이지 매김 옵션 사용을 참조하세요.

태스크는 다음 중 하나의 상태를 가질 수 있습니다.

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

Snow Device Management를 사용하여 Snow Family 디바이스에서 사용 가능한 리소스 나열

디바이스에 사용할 수 있는 AWS 리소스 목록을 반환하려면 list-device-resources 명령을 사용합니다. 특정 유형의 리소스별로 목록을 필터링하려면 --type 파라미터를 사용합니다. 현재 Amazon EC2호환 인스턴스는 지원되는 유일한 리소스 유형입니다. --max-results--next-token는 선택 사항입니다. 자세한 내용은 “AWS 명령줄 인터페이스 사용 설명서”의 AWS CLI 페이지 매김 옵션 사용을 참조하세요.

디바이스의 사용 가능한 리소스를 나열하려면 다음 명령을 사용합니다. 각 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" } ] }

Snow Family 디바이스 또는 Snow Device Management 태그 나열

관리 대상 디바이스 또는 태스크의 태그 목록을 반환하려면 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" } }

상태별 Snow Device Management 작업 나열

list-tasks 명령을 사용하여 명령이 실행되는 AWS 리전의 디바이스에서 작업 목록을 반환합니다. IN_PROGRESS, COMPLETED 또는 CANCELED 상태별로 결과를 필터링하려면 --state 파라미터를 사용합니다. --max-results--next-token은 선택 사항입니다. 자세한 내용은 “AWS 명령줄 인터페이스 사용 설명서”의 AWS CLI 페이지 매김 옵션 사용을 참조하세요.

상태별로 태스크를 나열하려면 다음 명령을 사용합니다. 각 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" } ] }

Snow Device Management 작업 또는 Snow Family 디바이스에 태그 적용

디바이스 또는 디바이스상의 태스크에 태그를 추가하거나 바꾸려면 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

작업 또는 Snow Family 디바이스에서 Snow Device Management 태그 제거

디바이스 또는 디바이스상의 태스크에서 태그를 제거하려면 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