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