findDevicesByIdentifier

يعرض الأجهزة التي تحمل معرّف جهاز معيّنًا.

توقيع الطريقة

public FindDevicesResponse findDevicesByDeviceIdentifier(FindDevicesByDeviceIdentifierRequest request)  throws CommonException;

FindDevicesByDeviceIdentifierRequest

اسم الموقع القيمة مطلوب الوصف
deviceIdentifier object(DeviceIdentifier) نعم معرّف الجهاز المطلوب استرداده يمكن تعبئة العنصر جزئيًا.
pageSize int لا حجم الصفحة، بحد أقصى 100 إذا كانت القيمة أكبر من 100 أو null، يتم استخدام 100.
pageToken string لا الرمز المميّز للصفحة إذا كانت فارغة، يتم عرض الصفحة الأولى.
vendorParams map لا حقول إضافية، يحدد المورّد زوج المفتاح/القيمة.

FindDevicesResponse

اسم الموقع القيمة الوصف
devices object(Device) قائمة الأجهزة التي حمّلها المورّد يكون الحقل فارغًا في حال عدم وجود مطابقة.
totalCount int إجمالي عدد الأجهزة التي تتطابق مع الطلب
nextPageToken strong الرمز المميّز للصفحة التالية. فارغ للصفحة الأخيرة.
vendorParams map اختياريّ. الحقول الإضافية، زوج المفتاح/القيمة المحدّد من المورّد

سلوك الخطأ

في حال حدوث خطأ، تُرسِل المكتبة CommonException يحتوي على أحد رمزَي الخطأ التاليَين:

رمز الخطأ
INTERNAL_SERVER_ERROR
INVALID_PAGE_TOKEN