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
-
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:
