Menggunakan AWS Snowball Edge Device Management untuk mengelola Snowball Edge

AWS Snowball Edge Device Management memungkinkan Anda mengelola Snowball Edge dan AWS layanan lokal dari jarak jauh. Semua Snowball Edge mendukung Snowball Edge Device Management, dan itu diinstal pada perangkat baru di sebagian besar tempat Wilayah AWS Snowball Edge tersedia.

Dengan Snowball Edge Device Management, Anda dapat melakukan tugas-tugas berikut:

Memilih status Manajemen Perangkat Snowball Edge saat memesan Snowball Edge

Saat Anda membuat pekerjaan untuk memesan perangkat Salju, Anda dapat memilih status Snowball Edge Device Management yang akan masuk 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 Snowball Edge Device Management setelah menerima perangkat dan menghubungkannya ke jaringan lokal Anda. Anda dapat memilih status Snowball Edge Device Management saat membuat pekerjaan untuk memesan perangkat melalui Konsol Manajemen AWS Snow Family, klien Snowball Edge, AWS CLI, atau Snow job management API.

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

  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 \

Mengaktifkan Manajemen Perangkat Snowball Edge di Tepi Snowball

Ikuti prosedur ini untuk mengaktifkan Snowball Edge Device Management 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 Snowball Edge Device Management ke peran IAM di Snowball Edge

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

Kebijakan

Perintah CLI Manajemen Perangkat Snowball Edge

Bagian ini menjelaskan AWS CLI perintah yang dapat Anda gunakan untuk mengelola Snowball Edge Anda dari jarak jauh dengan Snowball Edge Device Management. Anda juga dapat melakukan beberapa tugas manajemen jarak jauh menggunakan AWS OpsHub. Untuk informasi selengkapnya, lihat Mengelola AWS layanan di perangkat Anda.

Membuat tugas untuk mengelola Snowball Edge dengan Snowball Edge Device Management

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:

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 Snowball Edge

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:

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 Snowball Edge menggunakan Snowball Edge Device Management

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:

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
            

Memeriksa status instans yang EC2 kompatibel dengan Amazon di Snowball Edge dengan Snowball Edge 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 instans 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 di Snowball Edge dengan Snowball Edge Device Management

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

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 di Snowball Edge dengan Snowball Edge Device Management

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.

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 Snowball Edge Device Management

Untuk mengembalikan daftar semua perintah yang didukung untuk Snowball Edge Device Management API, gunakan perintah tersebuthelp. 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 Snowball Edge tersedia untuk manajemen jarak jauh

Untuk mengembalikan daftar semua perangkat di akun Anda yang mengaktifkan Snowball Edge Device Management di Wilayah AWS tempat perintah dijalankan, gunakan perintah. list-devices --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 Snowball Edge di Snowball Edge

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:

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 Snowball Edge dengan Snowball Edge 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 tag Snowball Edge atau Snowball Edge Device Management

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 Snowball Edge Device Management 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 Snowball Edge atau Snowball Edge

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 Snowball Edge dari tugas atau Snowball Edge

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