list_workers

list_workers(**kwargs)

Grants permission to list workers

See also: AWS API Documentation

Request Syntax

response = client.list_workers(
    site='string',
    maxResults=123,
    nextToken='string',
    fleet='string'
)
Parameters
  • site (string) --

    [REQUIRED]

    Site ARN.

  • maxResults (integer) -- Maximum number of results to retrieve in a single ListWorkers call.
  • nextToken (string) -- Pagination token returned when another page of data exists. Provide it in your next call to the API to receive the next page.
  • fleet (string) -- Full ARN of the worker fleet.
Return type

dict

Returns

Response Syntax

{
    'nextToken': 'string',
    'workers': [
        {
            'arn': 'string',
            'id': 'string',
            'fleet': 'string',
            'createdAt': datetime(2015, 1, 1),
            'updatedAt': datetime(2015, 1, 1),
            'name': 'string',
            'site': 'string',
            'additionalTransientProperties': 'string',
            'additionalFixedProperties': 'string',
            'vendorProperties': {
                'vendorWorkerId': 'string',
                'vendorWorkerIpAddress': 'string',
                'vendorAdditionalTransientProperties': 'string',
                'vendorAdditionalFixedProperties': 'string'
            },
            'position': {
                'cartesianCoordinates': {
                    'x': 123.0,
                    'y': 123.0,
                    'z': 123.0
                }
            },
            'orientation': {
                'degrees': 123.0
            }
        },
    ]
}

Response Structure

  • (dict) --

    • nextToken (string) --

      Pagination token returned when another page of data exists. Provide it in your next call to the API to receive the next page.

    • workers (list) --

      List of workers.

      • (dict) --

        A unit capable of performing tasks.

        • arn (string) --

          Full ARN of the worker.

        • id (string) --

          Filters access by the workers identifier

        • fleet (string) --

          Full ARN of the worker fleet.

        • createdAt (datetime) --

          Timestamp at which the resource was created.

        • updatedAt (datetime) --

          Timestamp at which the resource was last updated.

        • name (string) --

          Human friendly name of the resource.

        • site (string) --

          Site ARN.

        • additionalTransientProperties (string) --

          JSON blob containing unstructured worker properties that are transient and may change during regular operation.

        • additionalFixedProperties (string) --

          JSON blob containing unstructured worker properties that are fixed and won't change during regular operation.

        • vendorProperties (dict) --

          Properties of the worker that are provided by the vendor FMS.

          • vendorWorkerId (string) --

            The worker ID defined by the vendor FMS.

          • vendorWorkerIpAddress (string) --

            The worker IP address defined by the vendor FMS.

          • vendorAdditionalTransientProperties (string) --

            JSON blob containing unstructured vendor properties that are transient and may change during regular operation.

          • vendorAdditionalFixedProperties (string) --

            JSON blob containing unstructured vendor properties that are fixed and won't change during regular operation.

        • position (dict) --

          Supported coordinates for worker position.

          Note

          This is a Tagged Union structure. Only one of the following top level keys will be set: cartesianCoordinates. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

          'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
          
          • cartesianCoordinates (dict) --

            Cartesian coordinates.

            • x (float) --

              X coordinate.

            • y (float) --

              Y coordinate.

            • z (float) --

              Z coordinate.

        • orientation (dict) --

          Worker orientation measured in units clockwise from north.

          Note

          This is a Tagged Union structure. Only one of the following top level keys will be set: degrees. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

          'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
          
          • degrees (float) --

            Degrees, limited on [0, 360)

Exceptions

  • IoTRoboRunner.Client.exceptions.AccessDeniedException
  • IoTRoboRunner.Client.exceptions.ValidationException
  • IoTRoboRunner.Client.exceptions.ResourceNotFoundException
  • IoTRoboRunner.Client.exceptions.ThrottlingException
  • IoTRoboRunner.Client.exceptions.InternalServerException