Batch / Client / submit_service_job

submit_service_job

Batch.Client.submit_service_job(**kwargs)

Submits a service job to a specified job queue to run on SageMaker AI. A service job is a unit of work that you submit to Batch for execution on SageMaker AI.

See also: AWS API Documentation

Request Syntax

response = client.submit_service_job(
    jobName='string',
    jobQueue='string',
    retryStrategy={
        'attempts': 123,
        'evaluateOnExit': [
            {
                'action': 'RETRY'|'EXIT',
                'onStatusReason': 'string'
            },
        ]
    },
    schedulingPriority=123,
    serviceRequestPayload='string',
    serviceJobType='SAGEMAKER_TRAINING',
    shareIdentifier='string',
    timeoutConfig={
        'attemptDurationSeconds': 123
    },
    tags={
        'string': 'string'
    },
    clientToken='string'
)
Parameters:

  • jobName (string) –

    [REQUIRED]

    The name of the service job. It can be up to 128 characters long. It can contain uppercase and lowercase letters, numbers, hyphens (-), and underscores (_).

  • jobQueue (string) –

    [REQUIRED]

    The job queue into which the service job is submitted. You can specify either the name or the ARN of the queue. The job queue must have the type SAGEMAKER_TRAINING.

  • retryStrategy (dict) –

    The retry strategy to use for failed service jobs that are submitted with this service job request.

    • attempts (integer) – [REQUIRED]

      The number of times to move a service job to RUNNABLE status. You can specify between 1 and 10 attempts.

    • evaluateOnExit (list) –

      Array of ServiceJobEvaluateOnExit objects that specify conditions under which the service job should be retried or failed.

      • (dict) –

        Specifies conditions for when to exit or retry a service job based on the exit status or status reason.

        • action (string) –

          The action to take if the service job exits with the specified condition. Valid values are RETRY and EXIT.

        • onStatusReason (string) –

          Contains a glob pattern to match against the StatusReason returned for a job. The pattern can contain up to 512 characters and can contain all printable characters. It can optionally end with an asterisk (*) so that only the start of the string needs to be an exact match.

  • schedulingPriority (integer) – The scheduling priority of the service job. Valid values are integers between 0 and 9999.

  • serviceRequestPayload (string) –

    [REQUIRED]

    The request, in JSON, for the service that the SubmitServiceJob operation is queueing.

  • serviceJobType (string) –

    [REQUIRED]

    The type of service job. For SageMaker Training jobs, specify SAGEMAKER_TRAINING.

  • shareIdentifier (string) – The share identifier for the service job. Don’t specify this parameter if the job queue doesn’t have a fair-share scheduling policy. If the job queue has a fair-share scheduling policy, then this parameter must be specified.

  • timeoutConfig (dict) –

    The timeout configuration for the service job. If none is specified, Batch defers to the default timeout of the underlying service handling the job.

    • attemptDurationSeconds (integer) –

      The maximum duration in seconds that a service job attempt can run. After this time is reached, Batch terminates the service job attempt.

  • tags (dict) –

    The tags that you apply to the service job request. Each tag consists of a key and an optional value. For more information, see Tagging your Batch resources.

    • (string) –

      • (string) –

  • clientToken (string) –

    A unique identifier for the request. This token is used to ensure idempotency of requests. If this parameter is specified and two submit requests with identical payloads and ``clientToken``s are received, these requests are considered the same request and the second request is rejected.

    This field is autopopulated if not provided.

Return type:

dict

Returns:

Response Syntax

{
    'jobArn': 'string',
    'jobName': 'string',
    'jobId': 'string'
}

Response Structure

  • (dict) –

    • jobArn (string) –

      The Amazon Resource Name (ARN) for the service job.

    • jobName (string) –

      The name of the service job.

    • jobId (string) –

      The unique identifier for the service job.

Exceptions