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

# DescribeDevice
<a name="API_devicemanagement_DescribeDevice"></a>

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

## Minta Sintaks
<a name="API_devicemanagement_DescribeDevice_RequestSyntax"></a>

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

## Parameter Permintaan URI
<a name="API_devicemanagement_DescribeDevice_RequestParameters"></a>

Permintaan menggunakan parameter URI berikut.

 ** [managedDeviceId](#API_devicemanagement_DescribeDevice_RequestSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-request-uri-managedDeviceId"></a>
ID perangkat yang Anda periksa informasinya.  
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.  
Wajib: Ya

## Isi Permintaan
<a name="API_devicemanagement_DescribeDevice_RequestBody"></a>

Permintaan tidak memiliki isi permintaan.

## Sintaks Respons
<a name="API_devicemanagement_DescribeDevice_ResponseSyntax"></a>

```
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
<a name="API_devicemanagement_DescribeDevice_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [associatedWithJob](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-associatedWithJob"></a>
ID pekerjaan yang digunakan saat memesan perangkat.  
Tipe: String

 ** [deviceCapacities](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-deviceCapacities"></a>
Spesifikasi perangkat keras perangkat.   
Tipe: Array objek [Capacity](API_devicemanagement_Capacity.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 100 item.

 ** [deviceState](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-deviceState"></a>
Keadaan perangkat saat ini.  
Tipe: String  
Nilai yang Valid: `UNLOCKED | LOCKED | UNLOCKING` 

 ** [deviceType](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-deviceType"></a>
Jenis perangkat Keluarga AWS Salju.  
Tipe: String

 ** [lastReachedOutAt](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-lastReachedOutAt"></a>
Ketika perangkat terakhir menghubungi. AWS Cloud Menunjukkan bahwa perangkat sedang online.  
Tipe: Timestamp

 ** [lastUpdatedAt](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-lastUpdatedAt"></a>
Saat perangkat terakhir mendorong pembaruan ke file AWS Cloud. Menunjukkan kapan cache perangkat disegarkan.  
Tipe: Timestamp

 ** [managedDeviceArn](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-managedDeviceArn"></a>
Nama Sumber Daya Amazon (ARN) perangkat.  
Tipe: String

 ** [managedDeviceId](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-managedDeviceId"></a>
ID perangkat yang Anda periksa informasinya.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.

 ** [physicalNetworkInterfaces](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-physicalNetworkInterfaces"></a>
Antarmuka jaringan tersedia di perangkat.  
Tipe: Array objek [PhysicalNetworkInterface](API_devicemanagement_PhysicalNetworkInterface.md)

 ** [software](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-software"></a>
Perangkat lunak yang diinstal pada perangkat.  
Tipe: Objek [SoftwareInformation](API_devicemanagement_SoftwareInformation.md)

 ** [tags](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-tags"></a>
Metadata opsional yang Anda tetapkan ke sumber daya. Anda dapat menggunakan tag untuk mengkategorikan sumber daya dengan berbagai cara, seperti berdasarkan tujuan, pemilik, atau lingkungan.   
Tipe: Peta string ke string

## Kesalahan
<a name="API_devicemanagement_DescribeDevice_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Jenis Kesalahan Umum](CommonErrors.md).

 ** 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
<a name="API_devicemanagement_DescribeDevice_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/snow-device-management-2021-08-04/DescribeDevice) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/snow-device-management-2021-08-04/DescribeDevice) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snow-device-management-2021-08-04/DescribeDevice) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/snow-device-management-2021-08-04/DescribeDevice) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snow-device-management-2021-08-04/DescribeDevice) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/snow-device-management-2021-08-04/DescribeDevice) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/snow-device-management-2021-08-04/DescribeDevice) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snow-device-management-2021-08-04/DescribeDevice) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/snow-device-management-2021-08-04/DescribeDevice) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snow-device-management-2021-08-04/DescribeDevice)