DescribeLabelingJob

Gets information about a labeling job.

{
   "[LabelingJobName](#SageMaker-DescribeLabelingJob-request-LabelingJobName)": "string"
}

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

** LabelingJobName ** The name of the labeling job to return information for.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 63.
Pattern: ^[a-zA-Z0-9](-*[a-zA-Z0-9])*
Required: Yes

{
   "[CreationTime](#SageMaker-DescribeLabelingJob-response-CreationTime)": number,
   "[FailureReason](#SageMaker-DescribeLabelingJob-response-FailureReason)": "string",
   "[HumanTaskConfig](#SageMaker-DescribeLabelingJob-response-HumanTaskConfig)": { 
      "[AnnotationConsolidationConfig](API_HumanTaskConfig.md#SageMaker-Type-HumanTaskConfig-AnnotationConsolidationConfig)": { 
         "[AnnotationConsolidationLambdaArn](API_AnnotationConsolidationConfig.md#SageMaker-Type-AnnotationConsolidationConfig-AnnotationConsolidationLambdaArn)": "string"
      },
      "[MaxConcurrentTaskCount](API_HumanTaskConfig.md#SageMaker-Type-HumanTaskConfig-MaxConcurrentTaskCount)": number,
      "[NumberOfHumanWorkersPerDataObject](API_HumanTaskConfig.md#SageMaker-Type-HumanTaskConfig-NumberOfHumanWorkersPerDataObject)": number,
      "[PreHumanTaskLambdaArn](API_HumanTaskConfig.md#SageMaker-Type-HumanTaskConfig-PreHumanTaskLambdaArn)": "string",
      "[PublicWorkforceTaskPrice](API_HumanTaskConfig.md#SageMaker-Type-HumanTaskConfig-PublicWorkforceTaskPrice)": { 
         "[AmountInUsd](API_PublicWorkforceTaskPrice.md#SageMaker-Type-PublicWorkforceTaskPrice-AmountInUsd)": { 
            "[Cents](API_USD.md#SageMaker-Type-USD-Cents)": number,
            "[Dollars](API_USD.md#SageMaker-Type-USD-Dollars)": number,
            "[TenthFractionsOfACent](API_USD.md#SageMaker-Type-USD-TenthFractionsOfACent)": number
         }
      },
      "[TaskAvailabilityLifetimeInSeconds](API_HumanTaskConfig.md#SageMaker-Type-HumanTaskConfig-TaskAvailabilityLifetimeInSeconds)": number,
      "[TaskDescription](API_HumanTaskConfig.md#SageMaker-Type-HumanTaskConfig-TaskDescription)": "string",
      "[TaskKeywords](API_HumanTaskConfig.md#SageMaker-Type-HumanTaskConfig-TaskKeywords)": [ "string" ],
      "[TaskTimeLimitInSeconds](API_HumanTaskConfig.md#SageMaker-Type-HumanTaskConfig-TaskTimeLimitInSeconds)": number,
      "[TaskTitle](API_HumanTaskConfig.md#SageMaker-Type-HumanTaskConfig-TaskTitle)": "string",
      "[UiConfig](API_HumanTaskConfig.md#SageMaker-Type-HumanTaskConfig-UiConfig)": { 
         "[UiTemplateS3Uri](API_UiConfig.md#SageMaker-Type-UiConfig-UiTemplateS3Uri)": "string"
      },
      "[WorkteamArn](API_HumanTaskConfig.md#SageMaker-Type-HumanTaskConfig-WorkteamArn)": "string"
   },
   "[InputConfig](#SageMaker-DescribeLabelingJob-response-InputConfig)": { 
      "[DataAttributes](API_LabelingJobInputConfig.md#SageMaker-Type-LabelingJobInputConfig-DataAttributes)": { 
         "[ContentClassifiers](API_LabelingJobDataAttributes.md#SageMaker-Type-LabelingJobDataAttributes-ContentClassifiers)": [ "string" ]
      },
      "[DataSource](API_LabelingJobInputConfig.md#SageMaker-Type-LabelingJobInputConfig-DataSource)": { 
         "[S3DataSource](API_LabelingJobDataSource.md#SageMaker-Type-LabelingJobDataSource-S3DataSource)": { 
            "[ManifestS3Uri](API_LabelingJobS3DataSource.md#SageMaker-Type-LabelingJobS3DataSource-ManifestS3Uri)": "string"
         }
      }
   },
   "[JobReferenceCode](#SageMaker-DescribeLabelingJob-response-JobReferenceCode)": "string",
   "[LabelAttributeName](#SageMaker-DescribeLabelingJob-response-LabelAttributeName)": "string",
   "[LabelCategoryConfigS3Uri](#SageMaker-DescribeLabelingJob-response-LabelCategoryConfigS3Uri)": "string",
   "[LabelCounters](#SageMaker-DescribeLabelingJob-response-LabelCounters)": { 
      "[FailedNonRetryableError](API_LabelCounters.md#SageMaker-Type-LabelCounters-FailedNonRetryableError)": number,
      "[HumanLabeled](API_LabelCounters.md#SageMaker-Type-LabelCounters-HumanLabeled)": number,
      "[MachineLabeled](API_LabelCounters.md#SageMaker-Type-LabelCounters-MachineLabeled)": number,
      "[TotalLabeled](API_LabelCounters.md#SageMaker-Type-LabelCounters-TotalLabeled)": number,
      "[Unlabeled](API_LabelCounters.md#SageMaker-Type-LabelCounters-Unlabeled)": number
   },
   "[LabelingJobAlgorithmsConfig](#SageMaker-DescribeLabelingJob-response-LabelingJobAlgorithmsConfig)": { 
      "[InitialActiveLearningModelArn](API_LabelingJobAlgorithmsConfig.md#SageMaker-Type-LabelingJobAlgorithmsConfig-InitialActiveLearningModelArn)": "string",
      "[LabelingJobAlgorithmSpecificationArn](API_LabelingJobAlgorithmsConfig.md#SageMaker-Type-LabelingJobAlgorithmsConfig-LabelingJobAlgorithmSpecificationArn)": "string",
      "[LabelingJobResourceConfig](API_LabelingJobAlgorithmsConfig.md#SageMaker-Type-LabelingJobAlgorithmsConfig-LabelingJobResourceConfig)": { 
         "[VolumeKmsKeyId](API_LabelingJobResourceConfig.md#SageMaker-Type-LabelingJobResourceConfig-VolumeKmsKeyId)": "string"
      }
   },
   "[LabelingJobArn](#SageMaker-DescribeLabelingJob-response-LabelingJobArn)": "string",
   "[LabelingJobName](#SageMaker-DescribeLabelingJob-response-LabelingJobName)": "string",
   "[LabelingJobOutput](#SageMaker-DescribeLabelingJob-response-LabelingJobOutput)": { 
      "[FinalActiveLearningModelArn](API_LabelingJobOutput.md#SageMaker-Type-LabelingJobOutput-FinalActiveLearningModelArn)": "string",
      "[OutputDatasetS3Uri](API_LabelingJobOutput.md#SageMaker-Type-LabelingJobOutput-OutputDatasetS3Uri)": "string"
   },
   "[LabelingJobStatus](#SageMaker-DescribeLabelingJob-response-LabelingJobStatus)": "string",
   "[LastModifiedTime](#SageMaker-DescribeLabelingJob-response-LastModifiedTime)": number,
   "[OutputConfig](#SageMaker-DescribeLabelingJob-response-OutputConfig)": { 
      "[KmsKeyId](API_LabelingJobOutputConfig.md#SageMaker-Type-LabelingJobOutputConfig-KmsKeyId)": "string",
      "[S3OutputPath](API_LabelingJobOutputConfig.md#SageMaker-Type-LabelingJobOutputConfig-S3OutputPath)": "string"
   },
   "[RoleArn](#SageMaker-DescribeLabelingJob-response-RoleArn)": "string",
   "[StoppingConditions](#SageMaker-DescribeLabelingJob-response-StoppingConditions)": { 
      "[MaxHumanLabeledObjectCount](API_LabelingJobStoppingConditions.md#SageMaker-Type-LabelingJobStoppingConditions-MaxHumanLabeledObjectCount)": number,
      "[MaxPercentageOfInputDatasetLabeled](API_LabelingJobStoppingConditions.md#SageMaker-Type-LabelingJobStoppingConditions-MaxPercentageOfInputDatasetLabeled)": number
   },
   "[Tags](#SageMaker-DescribeLabelingJob-response-Tags)": [ 
      { 
         "[Key](API_Tag.md#SageMaker-Type-Tag-Key)": "string",
         "[Value](API_Tag.md#SageMaker-Type-Tag-Value)": "string"
      }
   ]
}

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

** CreationTime ** The date and time that the labeling job was created.
Type: Timestamp

** FailureReason ** If the job failed, the reason that it failed.
Type: String
Length Constraints: Maximum length of 1024.

** HumanTaskConfig ** Configuration information required for human workers to complete a labeling task.
Type: HumanTaskConfig object

** InputConfig ** Input configuration information for the labeling job, such as the Amazon S3 location of the data objects and the location of the manifest file that describes the data objects.
Type: LabelingJobInputConfig object

** JobReferenceCode ** A unique identifier for work done as part of a labeling job.
Type: String
Length Constraints: Minimum length of 1.
Pattern: .+

** LabelAttributeName ** The attribute used as the label in the output manifest file.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 127.
Pattern: ^[a-zA-Z0-9](-*[a-zA-Z0-9])*

** LabelCategoryConfigS3Uri ** The S3 location of the JSON file that defines the categories used to label data objects.
The file is a JSON structure in the following format:
{
"document-version": "2018-11-28"
"labels": [
{
"label": "label 1"
},
{
"label": "label 2"
},
...
{
"label": "label n"
}
]
}
Type: String
Length Constraints: Maximum length of 1024.
Pattern: ^(https|s3)://([^/]+)/?(.*)$

** LabelCounters ** Provides a breakdown of the number of data objects labeled by humans, the number of objects labeled by machine, the number of objects than couldn’t be labeled, and the total number of objects labeled.
Type: LabelCounters object

** LabelingJobAlgorithmsConfig ** Configuration information for automated data labeling.
Type: LabelingJobAlgorithmsConfig object

** LabelingJobArn ** The Amazon Resource Name (ARN) of the labeling job.
Type: String
Length Constraints: Maximum length of 2048.
Pattern: arn:aws[a-z\-]*:sagemaker:[a-z0-9\-]*:[0-9]{12}:labeling-job/.*

** LabelingJobName ** The name assigned to the labeling job when it was created.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 63.
Pattern: ^[a-zA-Z0-9](-*[a-zA-Z0-9])*

** LabelingJobOutput ** The location of the output produced by the labeling job.
Type: LabelingJobOutput object

** LabelingJobStatus ** The processing status of the labeling job.
Type: String
Valid Values:InProgress | Completed | Failed | Stopping | Stopped

** LastModifiedTime ** The date and time that the labeling job was last updated.
Type: Timestamp

** OutputConfig ** The location of the job’s output data and the AWS Key Management Service key ID for the key used to encrypt the output data, if any.
Type: LabelingJobOutputConfig object

** RoleArn ** The Amazon Resource Name (ARN) that Amazon SageMaker assumes to perform tasks on your behalf during data labeling.
Type: String
Length Constraints: Minimum length of 20. Maximum length of 2048.
Pattern: ^arn:aws[a-z\-]*:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+$

** StoppingConditions ** A set of conditions for stopping a labeling job. If any of the conditions are met, the job is automatically stopped.
Type: LabelingJobStoppingConditions object

** Tags ** An array of key/value pairs. For more information, see Using Cost Allocation Tags in the AWS Billing and Cost Management User Guide.
Type: Array of Tag objects
Array Members: Minimum number of 0 items. Maximum number of 50 items.

For information about the errors that are common to all actions, see Common Errors.

ResourceNotFound
Resource being access is not found.
HTTP Status Code: 400

For more information about using this API in one of the language-specific AWS SDKs, see the following: + AWS Command Line Interface + AWS SDK for .NET + AWS SDK for C++ + AWS SDK for Go + AWS SDK for Go - Pilot + AWS SDK for Java + AWS SDK for JavaScript + AWS SDK for PHP V3 + AWS SDK for Python + AWS SDK for Ruby V2