Menggunakan AWS Snow Device Management untuk mengelola perangkat Keluarga Salju - AWS Snowball Edge Panduan Pengembang

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menggunakan AWS Snow Device Management untuk mengelola perangkat Keluarga Salju

AWS Snow Device Management memungkinkan Anda mengelola perangkat Keluarga Salju dan AWS layanan lokal dari jarak jauh. Semua perangkat Keluarga Salju mendukung Manajemen Perangkat Salju, dan itu diinstal pada perangkat baru di sebagian besar Wilayah AWS tempat perangkat Keluarga Salju tersedia.

Dengan Manajemen Perangkat Salju, Anda dapat melakukan tugas-tugas berikut:

  • Buat tugas

  • Periksa status tugas

  • Periksa metadata tugas

  • Membatalkan tugas

  • Periksa info perangkat

  • Periksa status instans EC2 yang kompatibel dengan Amazon

  • Daftar perintah dan sintaks

  • Buat daftar perangkat yang dapat dikelola dari jarak jauh

  • Daftar status tugas di seluruh perangkat

  • Daftar sumber daya yang tersedia

  • Daftar tugas berdasarkan status

  • Daftar perangkat atau tag tugas

  • Terapkan tag

  • Hapus tag

Memilih status Manajemen Perangkat Salju saat memesan perangkat Keluarga Salju

Saat Anda membuat pekerjaan untuk memesan perangkat Salju, Anda dapat memilih status Manajemen Perangkat Salju mana yang akan digunakan saat Anda menerima perangkat: diinstal tetapi tidak diaktifkan atau diinstal dan diaktifkan. Jika diinstal tetapi tidak diaktifkan, Anda harus menggunakan AWS OpsHub atau klien Snowball Edge untuk mengaktifkannya sebelum menggunakannya. Jika diinstal dan diaktifkan, Anda dapat menggunakan Manajemen Perangkat Salju setelah menerima perangkat dan menghubungkannya ke jaringan lokal Anda. Anda dapat memilih status Manajemen Perangkat Salju saat membuat pekerjaan untuk memesan perangkat melalui Konsol Manajemen AWS Snow Family, klien Snowball Edge, AWS CLI, atau manajemen pekerjaan Salju. API

Untuk memilih status Manajemen Perangkat Salju dari Konsol Manajemen AWS Snow Family
  1. Untuk memilih Manajemen Perangkat Salju yang akan diinstal dan diaktifkan, pilih Kelola perangkat Salju Anda dari jarak jauh dengan AWS OpsHub atau klien Snowball.

  2. Untuk memilih Manajemen Perangkat Salju yang akan diinstal tetapi tidak diaktifkan, jangan pilih Kelola perangkat Salju Anda dari jarak jauh dengan AWS OpsHub atau klien Snowball.

Untuk informasi selengkapnya, lihat Langkah 3: Pilih fitur dan opsi Anda dalam panduan ini.

Untuk memilih status Manajemen Perangkat Salju dari AWS CLI, klien Snowball Edge, atau manajemen pekerjaan Salju: API
  • Gunakan remote-management parameter untuk menentukan status Manajemen Perangkat Salju. INSTALLED_ONLYNilai parameter berarti Manajemen Perangkat Salju diinstal tetapi tidak diaktifkan. INSTALLED_AUTOSTARTNilai parameter berarti Manajemen Perangkat Salju diinstal dan diaktifkan. Jika Anda tidak menentukan nilai untuk parameter ini, INSTALLED_ONLY adalah nilai default.

contoh dari sintaks remote-management parameter perintah 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 \

Untuk informasi selengkapnya, lihat APIReferensi Manajemen Pekerjaan di AWS Snowball API Referensi.

Mengaktifkan Manajemen Perangkat Salju pada perangkat Keluarga Salju

Ikuti prosedur ini untuk mengaktifkan Manajemen Perangkat Salju menggunakan klien Snowball Edge.

Sebelum menggunakan prosedur ini, lakukan hal berikut:

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

Klien Snowball Edge mengembalikan yang berikut ketika perintah berhasil.

{ "RemoteManagementState" : "INSTALLED_AUTOSTART" }

Menambahkan izin untuk Manajemen Perangkat Salju ke IAM peran di perangkat Keluarga Salju

Saat perangkat dipesan, buat peran AWS Identity and Access Management (IAM), dan tambahkan kebijakan berikut ke peran tersebut. Akun AWS Kemudian, tetapkan peran tersebut kepada IAM pengguna yang akan masuk untuk mengelola perangkat Anda dari jarak jauh dengan Snow Device Management. Untuk informasi selengkapnya, lihat Membuat IAM peran dan Membuat IAM pengguna di situs Anda Akun AWS.

Kebijakan

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

CLIPerintah Manajemen Perangkat Salju

Bagian ini menjelaskan AWS CLI perintah yang dapat Anda gunakan untuk mengelola perangkat Keluarga Salju Anda dari jarak jauh dengan Manajemen Perangkat Salju. Anda juga dapat melakukan beberapa tugas manajemen jarak jauh menggunakan AWS OpsHub for Snow Family. Untuk informasi selengkapnya, lihat Mengelola AWS layanan di perangkat Anda.

catatan

Sebelum mengelola perangkat Anda, pastikan perangkat dinyalakan, terhubung ke jaringan Anda, dan dapat terhubung ke Wilayah AWS tempat penyediaannya.

Membuat tugas untuk mengelola perangkat Keluarga Salju dengan Manajemen Perangkat Salju

Untuk menginstruksikan satu atau beberapa perangkat target untuk melakukan tugas, seperti membuka kunci atau me-reboot, gunakan. create-task Anda menentukan perangkat target dengan menyediakan daftar perangkat terkelola IDs dengan --targets parameter, dan menentukan tugas yang akan dilakukan dengan --command parameter. Hanya satu perintah yang dapat dijalankan pada perangkat pada satu waktu.

Perintah yang didukung:

  • unlock(tidak ada argumen)

  • reboot(tidak ada argumen)

Untuk membuat tugas yang akan dijalankan oleh perangkat target, gunakan perintah berikut. Ganti masing-masing user input placeholder dengan informasi Anda sendiri.

Perintah

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

Pengecualian

ValidationException ResourceNotFoundException InternalServerException ThrottlingException AccessDeniedException ServiceQuotaExceededException

Keluaran

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

Memeriksa status tugas untuk mengelola perangkat Keluarga Salju

Untuk memeriksa status tugas jarak jauh yang berjalan pada satu atau beberapa perangkat target, gunakan describe-execution perintah.

Sebuah tugas dapat memiliki salah satu dari status berikut:

  • QUEUED

  • IN_PROGRESS

  • CANCELED

  • FAILED

  • COMPLETED

  • REJECTED

  • TIMED_OUT

Untuk memeriksa status tugas, gunakan perintah berikut. Ganti masing-masing user input placeholder dengan informasi Anda sendiri.

Perintah

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

Keluaran

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

Memeriksa informasi tentang perangkat Keluarga Salju menggunakan Manajemen Perangkat Salju

Untuk memeriksa informasi khusus perangkat, seperti jenis perangkat, versi perangkat lunak, alamat IP, dan status kunci, gunakan perintah. describe-device Outputnya juga mencakup yang berikut:

  • lastReachedOutAt— Saat perangkat terakhir menghubungi. AWS Cloud Menunjukkan bahwa perangkat sedang online.

  • lastUpdatedAt— Saat data terakhir diperbarui pada perangkat. Menunjukkan kapan cache perangkat disegarkan.

Untuk memeriksa info perangkat, gunakan perintah berikut. Ganti masing-masing user input placeholder dengan informasi Anda sendiri.

Perintah

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

Pengecualian

ValidationException ResourceNotFoundException InternalServerException ThrottlingException AccessDeniedException

Keluaran

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

Memeriksa status instans EC2 yang kompatibel dengan Amazon di perangkat Snow Family dengan Snow Device Management

Untuk memeriksa status EC2 instans Amazon saat ini, gunakan describe-ec2-instances perintah. Outputnya mirip dengan describe-device perintah, tetapi hasilnya bersumber dari cache perangkat di AWS Cloud dan menyertakan subset dari bidang yang tersedia.

Untuk memeriksa status instance yang EC2 kompatibel dengan Amazon, gunakan perintah berikut. Ganti masing-masing user input placeholder dengan informasi Anda sendiri.

Perintah

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

Pengecualian

ValidationException ResourceNotFoundException InternalServerException ThrottlingException AccessDeniedException

Keluaran

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

Melihat metadata tugas pada perangkat Keluarga Salju dengan Manajemen Perangkat Salju

Untuk memeriksa metadata untuk tugas yang diberikan pada perangkat, gunakan perintah. describe-task Metadata untuk tugas mencakup item-item berikut:

  • Perangkat target

  • Status tugas

  • Saat tugas itu dibuat

  • Kapan data terakhir diperbarui pada perangkat

  • Ketika tugas selesai

  • Deskripsi (jika ada) yang diberikan saat tugas dibuat

Untuk memeriksa metadata tugas, gunakan perintah berikut. Ganti masing-masing user input placeholder dengan informasi Anda sendiri.

Perintah

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

Pengecualian

ValidationException ResourceNotFoundException InternalServerException ThrottlingException AccessDeniedException

Keluaran

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

Membatalkan tugas pada perangkat Keluarga Salju dengan Manajemen Perangkat Salju

Untuk mengirim permintaan pembatalan untuk tugas tertentu, gunakan cancel-task perintah. Anda hanya dapat membatalkan tugas di QUEUED negara bagian yang belum berjalan. Tugas yang sudah berjalan tidak dapat dibatalkan.

catatan

Tugas yang Anda coba batalkan mungkin masih berjalan jika diproses dari antrian sebelum cancel-task perintah mengubah status tugas.

Untuk membatalkan tugas, gunakan perintah berikut. Ganti masing-masing user input placeholder dengan informasi Anda sendiri.

Perintah

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

Pengecualian

ValidationException ResourceNotFoundException InternalServerException ThrottlingException AccessDeniedException

Keluaran

{ "taskId": "st-ficthmqoc2pht111" }

Daftar perintah dan sintaks Snow Device Management

Untuk mengembalikan daftar semua perintah yang didukung untuk Manajemen Perangkat SaljuAPI, gunakan help perintah. Anda juga dapat menggunakan help perintah untuk mengembalikan informasi rinci tentang dan sintaks untuk perintah yang diberikan.

Untuk membuat daftar semua perintah yang didukung, gunakan perintah berikut.

Perintah

aws snow-device-management help

Untuk mengembalikan informasi rinci dan sintaks untuk sebuah perintah, gunakan perintah berikut. Ganti command dengan nama perintah yang Anda minati.

Perintah

aws snow-device-management command help

Daftar perangkat Snow Family tersedia untuk manajemen jarak jauh

Untuk mengembalikan daftar semua perangkat di akun Anda yang mengaktifkan Snow Device Management Wilayah AWS di tempat perintah dijalankan, gunakan list-devices perintah. --max-resultsdan --next-token bersifat opsional. Untuk informasi selengkapnya, lihat Menggunakan opsi AWS CLI pagination di "Panduan Pengguna Antarmuka Baris AWS Perintah”.

Untuk membuat daftar perangkat yang dapat dikelola dari jarak jauh, gunakan perintah berikut. Ganti masing-masing user input placeholder dengan informasi Anda sendiri.

Perintah

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

Pengecualian

ValidationException InternalServerException ThrottlingException AccessDeniedException

Keluaran

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

Mencantumkan status tugas Manajemen Perangkat Salju di seluruh perangkat Keluarga Salju

Untuk mengembalikan status tugas untuk satu atau lebih perangkat target, gunakan list-executions perintah. Untuk memfilter daftar pengembalian untuk menampilkan tugas yang saat ini dalam satu keadaan tertentu, gunakan --state parameter. --max-resultsdan --next-token bersifat opsional. Untuk informasi selengkapnya, lihat Menggunakan opsi AWS CLI pagination di "Panduan Pengguna Antarmuka Baris AWS Perintah”.

Sebuah tugas dapat memiliki salah satu dari status berikut:

  • QUEUED

  • IN_PROGRESS

  • CANCELED

  • FAILED

  • COMPLETED

  • REJECTED

  • TIMED_OUT

Untuk mencantumkan status tugas di seluruh perangkat, gunakan perintah berikut. Ganti masing-masing user input placeholder dengan informasi Anda sendiri.

Perintah

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

Pengecualian

ValidationException InternalServerException ThrottlingException AccessDeniedException

Keluaran

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

Daftar sumber daya yang tersedia di perangkat Snow Family dengan Snow Device Management

Untuk mengembalikan daftar sumber AWS daya yang tersedia untuk perangkat, gunakan list-device-resources perintah. Untuk memfilter daftar berdasarkan jenis sumber daya tertentu, gunakan --type parameter. Saat ini, instans EC2 yang kompatibel dengan Amazon adalah satu-satunya jenis sumber daya yang didukung. --max-resultsdan --next-token bersifat opsional. Untuk informasi selengkapnya, lihat Menggunakan opsi AWS CLI pagination di "Panduan Pengguna Antarmuka Baris AWS Perintah”.

Untuk membuat daftar sumber daya yang tersedia untuk perangkat, gunakan perintah berikut. Ganti masing-masing user input placeholder dengan informasi Anda sendiri.

Perintah

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

Pengecualian

ValidationException InternalServerException ThrottlingException AccessDeniedException

Keluaran

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

Tag daftar untuk perangkat Keluarga Salju atau tag Manajemen Perangkat Salju

Untuk mengembalikan daftar tag untuk perangkat atau tugas yang dikelola, gunakan list-tags-for-resource perintah.

Untuk membuat daftar tag untuk perangkat, gunakan perintah berikut. Ganti contoh Amazon Resource Name (ARN) dengan ARN untuk perangkat Anda.

Perintah

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

Pengecualian

AccessDeniedException InternalServerException ResourceNotFoundException ThrottlingException

Keluaran

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

Daftar tugas Manajemen Perangkat Salju berdasarkan status

Gunakan list-tasks perintah untuk mengembalikan daftar tugas dari perangkat di AWS Wilayah tempat perintah dijalankan. Untuk memfilter hasil berdasarkan IN_PROGRESSCOMPLETED,, atau CANCELED status, gunakan --state parameter. --max-resultsdan --next-token bersifat opsional. Untuk informasi selengkapnya, lihat Menggunakan opsi AWS CLI pagination di "Panduan Pengguna Antarmuka Baris AWS Perintah”.

Untuk daftar tugas berdasarkan status, gunakan perintah berikut. Ganti masing-masing user input placeholder dengan informasi Anda sendiri.

Perintah

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

Pengecualian

ValidationException InternalServerException ThrottlingException AccessDeniedException

Keluaran

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

Menerapkan tag ke tugas Manajemen Perangkat Salju atau perangkat Keluarga Salju

Untuk menambah atau mengganti tag untuk perangkat, atau untuk tugas di perangkat, gunakan tag-resource perintah. --tagsParameter menerima daftar pasangan yang dipisahkan koma. Key=Value

Untuk menerapkan tag ke perangkat, gunakan perintah berikut. Ganti masing-masing user input placeholder dengan informasi Anda sendiri.

Perintah

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

Pengecualian

AccessDeniedException InternalServerException ResourceNotFoundException ThrottlingException

Menghapus tag Manajemen Perangkat Salju dari tugas atau perangkat Keluarga Salju

Untuk menghapus tag dari perangkat, atau dari tugas di perangkat, gunakan untag-resources perintah.

Untuk menghapus tag dari perangkat, gunakan perintah berikut. Ganti masing-masing user input placeholder dengan informasi Anda sendiri.

Perintah

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

Pengecualian

AccessDeniedException InternalServerException ResourceNotFoundException ThrottlingException