DeadlineCloud / Client / get_limit

get_limit#

DeadlineCloud.Client.get_limit(**kwargs)#

Gets information about a specific limit.

See also: AWS API Documentation

Request Syntax

response = client.get_limit(
    farmId='string',
    limitId='string'
)
Parameters:

  • farmId (string) –

    [REQUIRED]

    The unique identifier of the farm that contains the limit.

  • limitId (string) –

    [REQUIRED]

    The unique identifier of the limit to return.

Return type:

dict

Returns:

Response Syntax

{
    'displayName': 'string',
    'amountRequirementName': 'string',
    'maxCount': 123,
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'updatedAt': datetime(2015, 1, 1),
    'updatedBy': 'string',
    'farmId': 'string',
    'limitId': 'string',
    'currentCount': 123,
    'description': 'string'
}

Response Structure

  • (dict) –

    • displayName (string) –

      The display name of the limit.

      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.

    • amountRequirementName (string) –

      The value that you specify as the name in the amounts field of the hostRequirements in a step of a job template to declare the limit requirement.

    • maxCount (integer) –

      The maximum number of resources constrained by this limit. When all of the resources are in use, steps that require the limit won’t be scheduled until the resource is available.

      The maxValue must not be 0. If the value is -1, there is no restriction on the number of resources that can be acquired for this limit.

    • createdAt (datetime) –

      The Unix timestamp of the date and time that the limit was created.

    • createdBy (string) –

      The user identifier of the person that created the limit.

    • updatedAt (datetime) –

      The Unix timestamp of the date and time that the limit was last updated.

    • updatedBy (string) –

      The user identifier of the person that last updated the limit.

    • farmId (string) –

      The unique identifier of the farm that contains the limit.

    • limitId (string) –

      The unique identifier of the limit.

    • currentCount (integer) –

      The number of resources from the limit that are being used by jobs. The result is delayed and may not be the count at the time that you called the operation.

    • description (string) –

      The description of the limit that helps identify what the limit is used for.

      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.

Exceptions