Class SubmitServiceJobRequest

    • Method Detail

      • jobName

        public final String jobName()

        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 (_).

        Returns:
        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

        public final String jobQueue()

        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.

        Returns:
        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

        public final ServiceJobRetryStrategy retryStrategy()

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

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

        public final Integer schedulingPriority()

        The scheduling priority of the service job. Valid values are integers between 0 and 9999.

        Returns:
        The scheduling priority of the service job. Valid values are integers between 0 and 9999.
      • serviceRequestPayload

        public final String serviceRequestPayload()

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

        Returns:
        The request, in JSON, for the service that the SubmitServiceJob operation is queueing.
      • serviceJobType

        public final ServiceJobType serviceJobType()

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

        If the service returns an enum value that is not available in the current SDK version, serviceJobType will return ServiceJobType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from serviceJobTypeAsString().

        Returns:
        The type of service job. For SageMaker Training jobs, specify SAGEMAKER_TRAINING.
        See Also:
        ServiceJobType
      • serviceJobTypeAsString

        public final String serviceJobTypeAsString()

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

        If the service returns an enum value that is not available in the current SDK version, serviceJobType will return ServiceJobType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from serviceJobTypeAsString().

        Returns:
        The type of service job. For SageMaker Training jobs, specify SAGEMAKER_TRAINING.
        See Also:
        ServiceJobType
      • shareIdentifier

        public final String shareIdentifier()

        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.

        Returns:
        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.
      • quotaShareName

        public final String quotaShareName()

        The quota share for the service job. Don't specify this parameter if the job queue doesn't have a quota share scheduling policy. If the job queue has a quota share scheduling policy, then this parameter must be specified.

        Returns:
        The quota share for the service job. Don't specify this parameter if the job queue doesn't have a quota share scheduling policy. If the job queue has a quota share scheduling policy, then this parameter must be specified.
      • preemptionConfiguration

        public final ServiceJobPreemptionConfiguration preemptionConfiguration()

        Specifies the service job behavior when preempted.

        Returns:
        Specifies the service job behavior when preempted.
      • timeoutConfig

        public final ServiceJobTimeout timeoutConfig()

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

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

        public final boolean hasTags()
        For responses, this returns true if the service returned a value for the Tags property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
      • tags

        public final Map<String,​String> tags()

        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.

        Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

        This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasTags() method.

        Returns:
        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.
      • clientToken

        public final String clientToken()

        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 clientTokens are received, these requests are considered the same request and the second request is rejected.

        Returns:
        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 clientTokens are received, these requests are considered the same request and the second request is rejected.
      • toString

        public final String toString()
        Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
        Overrides:
        toString in class Object