Method: customers.devices.list
طلب HTTP
GET https://sasportal.googleapis.com/v1alpha1/{parent=customers/*}/devices
يستخدم عنوان URL بنية gRPC Transcoding.
معلّمات المسار
المَعلمات |
parent |
string
مطلوبة. هو اسم المورد الرئيسي.
|
معامِلات طلب البحث
المَعلمات |
pageSize |
integer
الحد الأقصى لعدد الأجهزة التي يمكن عرضها في الاستجابة. إذا كانت القيمة فارغة أو صفرًا، سيتم عرض جميع الأجهزة. يجب أن تكون ضمن النطاق [0, 1000].
|
pageToken |
string
تم إرجاع رمز مميّز للتقسيم على صفحات من مكالمة سابقة إلى devices.list يشير إلى الموضع الذي يجب أن تستمر منه هذه البيانات.
|
filter |
string
تعبير الفلتر يجب أن يحتوي الفلتر على أحد التنسيقات التالية: "sn=123454" أو "displayName=MyDevice". sn يقابله الرقم التسلسلي للجهاز. الفلتر غير حساس لحالة الأحرف.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال ListDevicesResponse
.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/sasportal
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2022-11-02 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2022-11-02 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Lists devices under a node or customer with customizable filtering, paging, and response size."],["Uses a GET HTTP request with the parent resource specified as a path parameter."],["Requires authorization with the `https://www.googleapis.com/auth/sasportal` scope."],["The request body should be empty, and a successful response contains a ListDevicesResponse object."]]],["This outlines the process of listing devices under a specified parent (customer or node) via an API call. The key actions involve sending a `GET` request to a specific URL, using the `parent` path parameter to identify the customer or node. Optional query parameters include `pageSize`, `pageToken`, and `filter` for controlling the number of devices, pagination, and filtering by serial number or display name respectively. The request body must be empty, and the successful response is a `ListDevicesResponse`. An authorization scope is required.\n"]]