list_devices

list_devices(**kwargs)

Returns a list of devices.

See also: AWS API Documentation

Request Syntax

response = client.list_devices(
    DeviceAggregatedStatusFilter='ERROR'|'AWAITING_PROVISIONING'|'PENDING'|'FAILED'|'DELETING'|'ONLINE'|'OFFLINE'|'LEASE_EXPIRED'|'UPDATE_NEEDED'|'REBOOTING',
    MaxResults=123,
    NameFilter='string',
    NextToken='string',
    SortBy='DEVICE_ID'|'CREATED_TIME'|'NAME'|'DEVICE_AGGREGATED_STATUS',
    SortOrder='ASCENDING'|'DESCENDING'
)
Parameters
  • DeviceAggregatedStatusFilter (string) -- Filter based on a device's status.
  • MaxResults (integer) -- The maximum number of devices to return in one page of results.
  • NameFilter (string) -- Filter based on device's name. Prefixes supported.
  • NextToken (string) -- Specify the pagination token from a previous request to retrieve the next page of results.
  • SortBy (string) -- The target column to be sorted on. Default column sort is CREATED_TIME.
  • SortOrder (string) -- The sorting order for the returned list. SortOrder is DESCENDING by default based on CREATED_TIME. Otherwise, SortOrder is ASCENDING.
Return type

dict

Returns

Response Syntax

{
    'Devices': [
        {
            'Brand': 'AWS_PANORAMA'|'LENOVO',
            'CreatedTime': datetime(2015, 1, 1),
            'CurrentSoftware': 'string',
            'Description': 'string',
            'DeviceAggregatedStatus': 'ERROR'|'AWAITING_PROVISIONING'|'PENDING'|'FAILED'|'DELETING'|'ONLINE'|'OFFLINE'|'LEASE_EXPIRED'|'UPDATE_NEEDED'|'REBOOTING',
            'DeviceId': 'string',
            'LastUpdatedTime': datetime(2015, 1, 1),
            'LatestDeviceJob': {
                'ImageVersion': 'string',
                'JobType': 'OTA'|'REBOOT',
                'Status': 'PENDING'|'IN_PROGRESS'|'VERIFYING'|'REBOOTING'|'DOWNLOADING'|'COMPLETED'|'FAILED'
            },
            'LeaseExpirationTime': datetime(2015, 1, 1),
            'Name': 'string',
            'ProvisioningStatus': 'AWAITING_PROVISIONING'|'PENDING'|'SUCCEEDED'|'FAILED'|'ERROR'|'DELETING',
            'Tags': {
                'string': 'string'
            },
            'Type': 'PANORAMA_APPLIANCE_DEVELOPER_KIT'|'PANORAMA_APPLIANCE'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Devices (list) --

      A list of devices.

      • (dict) --

        A device.

        • Brand (string) --

          The device's maker.

        • CreatedTime (datetime) --

          When the device was created.

        • CurrentSoftware (string) --

          A device's current software.

        • Description (string) --

          A description for the device.

        • DeviceAggregatedStatus (string) --

          A device's aggregated status. Including the device's connection status, provisioning status, and lease status.

        • DeviceId (string) --

          The device's ID.

        • LastUpdatedTime (datetime) --

          When the device was updated.

        • LatestDeviceJob (dict) --

          A device's latest job. Includes the target image version, and the update job status.

          • ImageVersion (string) --

            The target version of the device software.

          • JobType (string) --

            The job's type.

          • Status (string) --

            Status of the latest device job.

        • LeaseExpirationTime (datetime) --

          The device's lease expiration time.

        • Name (string) --

          The device's name.

        • ProvisioningStatus (string) --

          The device's provisioning status.

        • Tags (dict) --

          The device's tags.

          • (string) --
            • (string) --
        • Type (string) --

          The device's type.

    • NextToken (string) --

      A pagination token that's included if more results are available.

Exceptions

  • Panorama.Client.exceptions.ConflictException
  • Panorama.Client.exceptions.ValidationException
  • Panorama.Client.exceptions.AccessDeniedException
  • Panorama.Client.exceptions.InternalServerException