DescribeDevice - AWS Snowball

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

DescribeDevice

Memeriksa informasi khusus perangkat, seperti jenis perangkat, versi perangkat lunak, alamat IP, dan status kunci.

Sintaks Permintaan

POST /managed-device/managedDeviceId/describe HTTP/1.1

URIParameter Permintaan

Permintaan menggunakan URI parameter berikut.

managedDeviceId

ID perangkat yang Anda periksa informasinya.

Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.

Wajib: Ya

Isi Permintaan

Permintaan tidak memiliki isi permintaan.

Sintaks Respons

HTTP/1.1 200 Content-type: application/json { "associatedWithJob": "string", "deviceCapacities": [ { "available": number, "name": "string", "total": number, "unit": "string", "used": number } ], "deviceState": "string", "deviceType": "string", "lastReachedOutAt": number, "lastUpdatedAt": number, "managedDeviceArn": "string", "managedDeviceId": "string", "physicalNetworkInterfaces": [ { "defaultGateway": "string", "ipAddress": "string", "ipAddressAssignment": "string", "macAddress": "string", "netmask": "string", "physicalConnectorType": "string", "physicalNetworkInterfaceId": "string" } ], "software": { "installedVersion": "string", "installingVersion": "string", "installState": "string" }, "tags": { "string" : "string" } }

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Data berikut dikembalikan dalam JSON format oleh layanan.

associatedWithJob

ID pekerjaan yang digunakan saat memesan perangkat.

Tipe: String

deviceCapacities

Spesifikasi perangkat keras perangkat.

Tipe: Array objek Capacity

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 100 item.

deviceState

Keadaan perangkat saat ini.

Tipe: String

Nilai yang Valid: UNLOCKED | LOCKED | UNLOCKING

deviceType

Jenis perangkat Keluarga AWS Salju.

Tipe: String

lastReachedOutAt

Ketika perangkat terakhir menghubungi. AWS Cloud Menunjukkan bahwa perangkat sedang online.

Tipe: Timestamp

lastUpdatedAt

Saat perangkat terakhir mendorong pembaruan ke file AWS Cloud. Menunjukkan kapan cache perangkat disegarkan.

Tipe: Timestamp

managedDeviceArn

Nama Sumber Daya Amazon (ARN) perangkat.

Tipe: String

managedDeviceId

ID perangkat yang Anda periksa informasinya.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.

physicalNetworkInterfaces

Antarmuka jaringan tersedia di perangkat.

Tipe: Array objek PhysicalNetworkInterface

software

Perangkat lunak yang diinstal pada perangkat.

Tipe: Objek SoftwareInformation

tags

Metadata opsional yang Anda tetapkan ke sumber daya. Anda dapat menggunakan tag untuk mengkategorikan sumber daya dengan cara yang berbeda, seperti berdasarkan tujuan, pemilik, atau lingkungan.

Tipe: Peta string ke string

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

AccessDeniedException

Anda tidak memiliki akses yang cukup untuk melakukan tindakan ini.

HTTPKode Status: 403

InternalServerException

Terjadi kesalahan tak terduga saat memproses permintaan.

HTTPKode Status: 500

ResourceNotFoundException

Permintaan mereferensikan sumber daya yang tidak ada.

HTTPKode Status: 404

ThrottlingException

Permintaan ditolak karena throttling permintaan.

HTTPKode Status: 429

ValidationException

Input gagal memenuhi kendala yang ditentukan oleh layanan. AWS

HTTPKode Status: 400

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini: