DescribeCompilationJob

Returns information about a model compilation job.

To create a model compilation job, use CreateCompilationJob. To get information about multiple model compilation jobs, use ListCompilationJobs.

{
   "[CompilationJobName](#SageMaker-DescribeCompilationJob-request-CompilationJobName)": "string"
}

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

The request accepts the following data in JSON format.

** CompilationJobName ** The name of the model compilation job that you want information about.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 63.
Pattern: ^[a-zA-Z0-9](-*[a-zA-Z0-9])*$
Required: Yes

{
   "[CompilationEndTime](#SageMaker-DescribeCompilationJob-response-CompilationEndTime)": number,
   "[CompilationJobArn](#SageMaker-DescribeCompilationJob-response-CompilationJobArn)": "string",
   "[CompilationJobName](#SageMaker-DescribeCompilationJob-response-CompilationJobName)": "string",
   "[CompilationJobStatus](#SageMaker-DescribeCompilationJob-response-CompilationJobStatus)": "string",
   "[CompilationStartTime](#SageMaker-DescribeCompilationJob-response-CompilationStartTime)": number,
   "[CreationTime](#SageMaker-DescribeCompilationJob-response-CreationTime)": number,
   "[FailureReason](#SageMaker-DescribeCompilationJob-response-FailureReason)": "string",
   "[InputConfig](#SageMaker-DescribeCompilationJob-response-InputConfig)": { 
      "[DataInputConfig](API_InputConfig.md#SageMaker-Type-InputConfig-DataInputConfig)": "string",
      "[Framework](API_InputConfig.md#SageMaker-Type-InputConfig-Framework)": "string",
      "[S3Uri](API_InputConfig.md#SageMaker-Type-InputConfig-S3Uri)": "string"
   },
   "[LastModifiedTime](#SageMaker-DescribeCompilationJob-response-LastModifiedTime)": number,
   "[ModelArtifacts](#SageMaker-DescribeCompilationJob-response-ModelArtifacts)": { 
      "[S3ModelArtifacts](API_ModelArtifacts.md#SageMaker-Type-ModelArtifacts-S3ModelArtifacts)": "string"
   },
   "[OutputConfig](#SageMaker-DescribeCompilationJob-response-OutputConfig)": { 
      "[S3OutputLocation](API_OutputConfig.md#SageMaker-Type-OutputConfig-S3OutputLocation)": "string",
      "[TargetDevice](API_OutputConfig.md#SageMaker-Type-OutputConfig-TargetDevice)": "string"
   },
   "[RoleArn](#SageMaker-DescribeCompilationJob-response-RoleArn)": "string",
   "[StoppingCondition](#SageMaker-DescribeCompilationJob-response-StoppingCondition)": { 
      "[MaxRuntimeInSeconds](API_StoppingCondition.md#SageMaker-Type-StoppingCondition-MaxRuntimeInSeconds)": number
   }
}

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

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

** CompilationEndTime ** The time when the model compilation job on a compilation job instance ended. For a successful or stopped job, this is when the job’s model artifacts have finished uploading. For a failed job, this is when Amazon SageMaker detected that the job failed.
Type: Timestamp

** CompilationJobArn ** The Amazon Resource Name (ARN) of an IAM role that Amazon SageMaker assumes to perform the model compilation job.
Type: String
Length Constraints: Maximum length of 256.
Pattern: arn:aws[a-z\-]*:sagemaker:[a-z0-9\-]*:[0-9]{12}:compilation-job/.*

** CompilationJobName ** The name of the model compilation job.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 63.
Pattern: ^[a-zA-Z0-9](-*[a-zA-Z0-9])*$

** CompilationStartTime ** The time when the model compilation job started the CompilationJob instances.
You are billed for the time between this timestamp and the timestamp in the DescribeCompilationJob:CompilationEndTime field. In Amazon CloudWatch Logs, the start time might be later than this time. That’s because it takes time to download the compilation job, which depends on the size of the compilation job container.
Type: Timestamp

** CreationTime ** The time that the model compilation job was created.
Type: Timestamp

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

** InputConfig ** Information about the location in Amazon S3 of the input model artifacts, the name and shape of the expected data inputs, and the framework in which the model was trained.
Type: InputConfig object

** LastModifiedTime ** The time that the status of the model compilation job was last modified.
Type: Timestamp

** ModelArtifacts ** Information about the location in Amazon S3 that has been configured for storing the model artifacts used in the compilation job.
Type: ModelArtifacts object

** OutputConfig ** Information about the output location for the compiled model and the target device that the model runs on.
Type: OutputConfig object

** RoleArn ** The Amazon Resource Name (ARN) of the model compilation job.
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+=,.@\-_/]+$

** StoppingCondition ** Specifies a limit to how long a model compilation job can run. When the job reaches the time limit, Amazon SageMaker ends the compilation job. Use this API to cap model training costs.
Type: StoppingCondition object

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