get_devices_status
List all devices in the Sauce Labs data center with their current states, including availability, usage, and private device information.
Instructions
Returns a list of devices in the data center along with their current states. Each device is represented by a
descriptor, indicating its model, and includes information on availability, usage status, and whether it is
designated as a private device. Note that the inUseBy field is exposed only for private devices
isPrivateDevice: true. Users can view information about who is currently using the device only if they have
the required permissions. Lack of permissions will result in the inUseBy field being omitted from the response
for private devices.
This tool provides a lightweight overview of all devices. For detailed device specifications, use the
get_specific_device tool with the descriptor value as the device_id parameter.
Available States:
AVAILABLE Device is available and ready to be allocated
IN_USE Device is currently in use
CLEANING Device is being cleaned (only available for private devices)
MAINTENANCE Device is in maintenance (only available for private devices)
REBOOTING Device is rebooting (only available for private devices)
OFFLINE Device is offline (only available for private devices)
Note: The 'descriptor' field in each device object is the device identifier that should be used as the
'device_id' parameter in get_specific_device calls.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |