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.
Minta Sintaks
POST /managed-device/managedDeviceId/describe HTTP/1.1
Parameter Permintaan URI
Permintaan menggunakan parameter URI 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.
Layanan mengembalikan data berikut dalam format JSON.
- associatedWithJob
-
ID pekerjaan yang digunakan saat memesan perangkat.
Jenis: 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.
Jenis: String
Nilai yang Valid:
UNLOCKED | LOCKED | UNLOCKING - deviceType
-
Jenis perangkat Keluarga AWS Salju.
Jenis: 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.
Jenis: String
- managedDeviceId
-
ID perangkat yang Anda periksa informasinya.
Jenis: 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.
Kode Status HTTP: 403
- InternalServerException
-
Terjadi kesalahan tak terduga saat memproses permintaan.
Kode Status HTTP: 500
- ResourceNotFoundException
-
Permintaan mereferensikan sumber daya yang tidak ada.
Kode Status HTTP: 404
- ThrottlingException
-
Permintaan ditolak karena throttling permintaan.
Kode Status HTTP: 429
- ValidationException
-
Input gagal memenuhi kendala yang ditentukan oleh layanan. AWS
Kode Status HTTP: 400
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini:
