DeadlineCloud / Client / create_worker

create_worker#

DeadlineCloud.Client.create_worker(**kwargs)#

Creates a worker. A worker tells your instance how much processing power (vCPU), and memory (GiB) you’ll need to assemble the digital assets held within a particular instance. You can specify certain instance types to use, or let the worker know which instances types to exclude.

See also: AWS API Documentation

Request Syntax

response = client.create_worker(
    farmId='string',
    fleetId='string',
    hostProperties={
        'ipAddresses': {
            'ipV4Addresses': [
                'string',
            ],
            'ipV6Addresses': [
                'string',
            ]
        },
        'hostName': 'string'
    },
    clientToken='string'
)
Parameters:
  • farmId (string) –

    [REQUIRED]

    The farm ID of the farm to connect to the worker.

  • fleetId (string) –

    [REQUIRED]

    The fleet ID to connect to the worker.

  • hostProperties (dict) –

    The IP address and host name of 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.

  • clientToken (string) –

    The unique token which the server uses to recognize retries of the same request.

    This field is autopopulated if not provided.

Return type:

dict

Returns:

Response Syntax

{
    'workerId': 'string'
}

Response Structure

  • (dict) –

    • workerId (string) –

      The worker ID.

Exceptions

  • DeadlineCloud.Client.exceptions.AccessDeniedException

  • DeadlineCloud.Client.exceptions.InternalServerErrorException

  • DeadlineCloud.Client.exceptions.ResourceNotFoundException

  • DeadlineCloud.Client.exceptions.ThrottlingException

  • DeadlineCloud.Client.exceptions.ConflictException

  • DeadlineCloud.Client.exceptions.ValidationException