DeadlineCloud / Client / get_fleet

get_fleet#

DeadlineCloud.Client.get_fleet(**kwargs)#

Get a fleet.

See also: AWS API Documentation

Request Syntax

response = client.get_fleet(
    farmId='string',
    fleetId='string'
)
Parameters:
  • farmId (string) –

    [REQUIRED]

    The farm ID of the farm in the fleet.

  • fleetId (string) –

    [REQUIRED]

    The fleet ID of the fleet to get.

Return type:

dict

Returns:

Response Syntax

{
    'fleetId': 'string',
    'farmId': 'string',
    'displayName': 'string',
    'description': 'string',
    'status': 'ACTIVE'|'CREATE_IN_PROGRESS'|'UPDATE_IN_PROGRESS'|'CREATE_FAILED'|'UPDATE_FAILED',
    'autoScalingStatus': 'GROWING'|'STEADY'|'SHRINKING',
    'targetWorkerCount': 123,
    'workerCount': 123,
    'minWorkerCount': 123,
    'maxWorkerCount': 123,
    'configuration': {
        'customerManaged': {
            'mode': 'NO_SCALING'|'EVENT_BASED_AUTO_SCALING',
            'workerCapabilities': {
                'vCpuCount': {
                    'min': 123,
                    'max': 123
                },
                'memoryMiB': {
                    'min': 123,
                    'max': 123
                },
                'acceleratorTypes': [
                    'gpu',
                ],
                'acceleratorCount': {
                    'min': 123,
                    'max': 123
                },
                'acceleratorTotalMemoryMiB': {
                    'min': 123,
                    'max': 123
                },
                'osFamily': 'WINDOWS'|'LINUX'|'MACOS',
                'cpuArchitectureType': 'x86_64'|'arm64',
                'customAmounts': [
                    {
                        'name': 'string',
                        'min': ...,
                        'max': ...
                    },
                ],
                'customAttributes': [
                    {
                        'name': 'string',
                        'values': [
                            'string',
                        ]
                    },
                ]
            },
            'storageProfileId': 'string'
        },
        'serviceManagedEc2': {
            'instanceCapabilities': {
                'vCpuCount': {
                    'min': 123,
                    'max': 123
                },
                'memoryMiB': {
                    'min': 123,
                    'max': 123
                },
                'osFamily': 'WINDOWS'|'LINUX',
                'cpuArchitectureType': 'x86_64'|'arm64',
                'rootEbsVolume': {
                    'sizeGiB': 123,
                    'iops': 123,
                    'throughputMiB': 123
                },
                'allowedInstanceTypes': [
                    'string',
                ],
                'excludedInstanceTypes': [
                    'string',
                ],
                'customAmounts': [
                    {
                        'name': 'string',
                        'min': ...,
                        'max': ...
                    },
                ],
                'customAttributes': [
                    {
                        'name': 'string',
                        'values': [
                            'string',
                        ]
                    },
                ]
            },
            'instanceMarketOptions': {
                'type': 'on-demand'|'spot'
            }
        }
    },
    'capabilities': {
        'amounts': [
            {
                'name': 'string',
                'min': ...,
                'max': ...
            },
        ],
        'attributes': [
            {
                'name': 'string',
                'values': [
                    'string',
                ]
            },
        ]
    },
    'roleArn': 'string',
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'updatedAt': datetime(2015, 1, 1),
    'updatedBy': 'string'
}

Response Structure

  • (dict) –

    • fleetId (string) –

      The fleet ID.

    • farmId (string) –

      The farm ID of the farm in the fleet.

    • displayName (string) –

      The display name of the fleet.

      Warning

      This field can store any content. Escape or encode this content before displaying it on a webpage or any other system that might interpret the content of this field.

    • description (string) –

      The description of the fleet.

      Warning

      This field can store any content. Escape or encode this content before displaying it on a webpage or any other system that might interpret the content of this field.

    • status (string) –

      The Auto Scaling status of the fleet.

    • autoScalingStatus (string) –

      The Auto Scaling status of the fleet. Either GROWING, STEADY, or SHRINKING.

    • targetWorkerCount (integer) –

      The number of target workers in the fleet.

    • workerCount (integer) –

      The number of workers in the fleet.

    • minWorkerCount (integer) –

      The minimum number of workers specified in the fleet.

    • maxWorkerCount (integer) –

      The maximum number of workers specified in the fleet.

    • configuration (dict) –

      The configuration setting for the fleet.

      Note

      This is a Tagged Union structure. Only one of the following top level keys will be set: customerManaged, serviceManagedEc2. 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'}
      
      • customerManaged (dict) –

        The customer managed fleets within a fleet configuration.

        • mode (string) –

          The Auto Scaling mode for the customer managed fleet configuration.

        • workerCapabilities (dict) –

          The worker capabilities for a customer managed fleet configuration.

          • vCpuCount (dict) –

            The vCPU count for the customer manged worker capabilities.

            • min (integer) –

              The minimum amount of vCPU.

            • max (integer) –

              The maximum amount of vCPU.

          • memoryMiB (dict) –

            The memory (MiB).

            • min (integer) –

              The minimum amount of memory (in MiB).

            • max (integer) –

              The maximum amount of memory (in MiB).

          • acceleratorTypes (list) –

            The accelerator types for the customer managed worker capabilities.

            • (string) –

          • acceleratorCount (dict) –

            The range of the accelerator.

            • min (integer) –

              The minimum GPU for the accelerator.

            • max (integer) –

              The maximum GPU for the accelerator.

          • acceleratorTotalMemoryMiB (dict) –

            The total memory (MiB) for the customer managed worker capabilities.

            • min (integer) –

              The minimum amount of memory to use for the accelerator, measured in MiB.

            • max (integer) –

              The maximum amount of memory to use for the accelerator, measured in MiB.

          • osFamily (string) –

            The operating system (OS) family.

          • cpuArchitectureType (string) –

            The CPU architecture type for the customer managed worker capabilities.

          • customAmounts (list) –

            Custom requirement ranges for customer managed worker capabilities.

            • (dict) –

              The fleet amount and attribute capabilities.

              • name (string) –

                The name of the fleet capability.

              • min (float) –

                The minimum amount of fleet worker capability.

              • max (float) –

                The maximum amount of the fleet worker capability.

          • customAttributes (list) –

            Custom attributes for the customer manged worker capabilities.

            • (dict) –

              Defines the fleet’s capability name, minimum, and maximum.

              • name (string) –

                The name of the fleet attribute capability for the worker.

              • values (list) –

                The number of fleet attribute capabilities.

                • (string) –

        • storageProfileId (string) –

          The storage profile ID.

      • serviceManagedEc2 (dict) –

        The service managed Amazon EC2 instances for a fleet configuration.

        • instanceCapabilities (dict) –

          The Amazon EC2 instance capabilities.

          • vCpuCount (dict) –

            The amount of vCPU to require for instances in this fleet.

            • min (integer) –

              The minimum amount of vCPU.

            • max (integer) –

              The maximum amount of vCPU.

          • memoryMiB (dict) –

            The memory, as MiB, for the Amazon EC2 instance type.

            • min (integer) –

              The minimum amount of memory (in MiB).

            • max (integer) –

              The maximum amount of memory (in MiB).

          • osFamily (string) –

            The operating system (OS) family.

          • cpuArchitectureType (string) –

            The CPU architecture type.

          • rootEbsVolume (dict) –

            The root EBS volume.

            • sizeGiB (integer) –

              The EBS volume size in GiB.

            • iops (integer) –

              The IOPS per volume.

            • throughputMiB (integer) –

              The throughput per volume in MiB.

          • allowedInstanceTypes (list) –

            The allowable Amazon EC2 instance types.

            • (string) –

          • excludedInstanceTypes (list) –

            The instance types to exclude from the fleet.

            • (string) –

          • customAmounts (list) –

            The custom capability amounts to require for instances in this fleet.

            • (dict) –

              The fleet amount and attribute capabilities.

              • name (string) –

                The name of the fleet capability.

              • min (float) –

                The minimum amount of fleet worker capability.

              • max (float) –

                The maximum amount of the fleet worker capability.

          • customAttributes (list) –

            The custom capability attributes to require for instances in this fleet.

            • (dict) –

              Defines the fleet’s capability name, minimum, and maximum.

              • name (string) –

                The name of the fleet attribute capability for the worker.

              • values (list) –

                The number of fleet attribute capabilities.

                • (string) –

        • instanceMarketOptions (dict) –

          The Amazon EC2 market type.

          • type (string) –

            The Amazon EC2 instance type.

    • capabilities (dict) –

      Outlines what the fleet is capable of for minimums, maximums, and naming, in addition to attribute names and values.

      • amounts (list) –

        Amount capabilities of the fleet.

        • (dict) –

          The fleet amount and attribute capabilities.

          • name (string) –

            The name of the fleet capability.

          • min (float) –

            The minimum amount of fleet worker capability.

          • max (float) –

            The maximum amount of the fleet worker capability.

      • attributes (list) –

        Attribute capabilities of the fleet.

        • (dict) –

          Defines the fleet’s capability name, minimum, and maximum.

          • name (string) –

            The name of the fleet attribute capability for the worker.

          • values (list) –

            The number of fleet attribute capabilities.

            • (string) –

    • roleArn (string) –

      The IAM role ARN.

    • 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.

Exceptions

  • DeadlineCloud.Client.exceptions.AccessDeniedException

  • DeadlineCloud.Client.exceptions.InternalServerErrorException

  • DeadlineCloud.Client.exceptions.ResourceNotFoundException

  • DeadlineCloud.Client.exceptions.ThrottlingException

  • DeadlineCloud.Client.exceptions.ValidationException