DeadlineCloud / Client / batch_get_worker

batch_get_worker

DeadlineCloud.Client.batch_get_worker(**kwargs)

Retrieves multiple workers in a single request. This is a batch version of the GetWorker API.

The result of getting each worker is reported individually in the response. Because the batch request can result in a combination of successful and unsuccessful actions, you should check for batch errors even when the call returns an HTTP status code of 200.

See also: AWS API Documentation

Request Syntax

response = client.batch_get_worker(
    identifiers=[
        {
            'farmId': 'string',
            'fleetId': 'string',
            'workerId': 'string'
        },
    ]
)

Parameters:

identifiers (list) –

[REQUIRED]

The list of worker identifiers to retrieve. You can specify up to 100 identifiers per request.

• (dict) –

  The identifiers for a worker.

  • farmId (string) – [REQUIRED]

    The farm ID of the worker.

  • fleetId (string) – [REQUIRED]

    The fleet ID of the worker.

  • workerId (string) – [REQUIRED]

    The worker ID.

Return type:

dict

Returns:

Response Syntax

{
    'workers': [
        {
            'farmId': 'string',
            'fleetId': 'string',
            'workerId': 'string',
            'hostProperties': {
                'ipAddresses': {
                    'ipV4Addresses': [
                        'string',
                    ],
                    'ipV6Addresses': [
                        'string',
                    ]
                },
                'hostName': 'string',
                'ec2InstanceArn': 'string',
                'ec2InstanceType': 'string'
            },
            'status': 'CREATED'|'STARTED'|'STOPPING'|'STOPPED'|'NOT_RESPONDING'|'NOT_COMPATIBLE'|'RUNNING'|'IDLE',
            'log': {
                'logDriver': 'string',
                'options': {
                    'string': 'string'
                },
                'parameters': {
                    'string': 'string'
                },
                'error': 'string'
            },
            'createdAt': datetime(2015, 1, 1),
            'createdBy': 'string',
            'updatedAt': datetime(2015, 1, 1),
            'updatedBy': 'string'
        },
    ],
    'errors': [
        {
            'farmId': 'string',
            'fleetId': 'string',
            'workerId': 'string',
            'code': 'InternalServerErrorException'|'ResourceNotFoundException'|'ValidationException',
            'message': 'string'
        },
    ]
}

Response Structure

• (dict) –

  • workers (list) –

    A list of workers that were successfully retrieved.

    • (dict) –

      The details of a worker returned in a batch get operation.

      • farmId (string) –

        The farm ID of the worker.

      • fleetId (string) –

        The fleet ID of the worker.

      • workerId (string) –

        The worker ID.

      • hostProperties (dict) –

        The host properties for the worker.

        • ipAddresses (dict) –

          The IP address of the host.

          • ipV4Addresses (list) –

            The IpV4 address of the network.

            • (string) –

          • ipV6Addresses (list) –

            The IpV6 address for the network and node component.

            • (string) –

        • hostName (string) –

          The host name.

        • ec2InstanceArn (string) –

          The ARN of the host EC2 instance.

        • ec2InstanceType (string) –

          The instance type of the host EC2 instance.

      • status (string) –

        The status of the worker.

      • log (dict) –

        The log configuration for the worker.

        • logDriver (string) –

          The log drivers for worker related logs.

        • options (dict) –

          The options for a log driver.

          • (string) –

            • (string) –

        • parameters (dict) –

          The parameters for the log configuration.

          • (string) –

            • (string) –

        • error (string) –

          The log configuration error details.

      • createdAt (datetime) –

        The date and time the resource was created.

      • createdBy (string) –

        The user or system that created this resource.

      • updatedAt (datetime) –

        The date and time the resource was updated.

      • updatedBy (string) –

        The user or system that updated this resource.

  • errors (list) –

    A list of errors for workers that could not be retrieved.

    • (dict) –

      The error details for a worker that could not be retrieved in a batch get operation.

      • farmId (string) –

        The farm ID of the worker that could not be retrieved.

      • fleetId (string) –

        The fleet ID of the worker that could not be retrieved.

      • workerId (string) –

        The worker ID of the worker that could not be retrieved.

      • code (string) –

        The error code.

      • message (string) –

        The error message.

Exceptions

• DeadlineCloud.Client.exceptions.AccessDeniedException

• DeadlineCloud.Client.exceptions.InternalServerErrorException

• DeadlineCloud.Client.exceptions.ThrottlingException

• DeadlineCloud.Client.exceptions.ValidationException