# StartSNOMEDCTInferenceJob
<a name="API_StartSNOMEDCTInferenceJob"></a>

 Starts an asynchronous job to detect medical concepts and link them to the SNOMED-CT ontology. Use the DescribeSNOMEDCTInferenceJob operation to track the status of a job. 

## Request Syntax
<a name="API_StartSNOMEDCTInferenceJob_RequestSyntax"></a>

```
{
   "ClientRequestToken": "string",
   "DataAccessRoleArn": "string",
   "InputDataConfig": { 
      "S3Bucket": "string",
      "S3Key": "string"
   },
   "JobName": "string",
   "KMSKey": "string",
   "LanguageCode": "string",
   "OutputDataConfig": { 
      "S3Bucket": "string",
      "S3Key": "string"
   }
}
```

## Request Parameters
<a name="API_StartSNOMEDCTInferenceJob_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [ClientRequestToken](#API_StartSNOMEDCTInferenceJob_RequestSyntax) **   <a name="comprehendmedical-StartSNOMEDCTInferenceJob-request-ClientRequestToken"></a>
 A unique identifier for the request. If you don't set the client request token, Amazon Comprehend Medical generates one.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 64.  
Pattern: `^[a-zA-Z0-9-]+$`   
Required: No

 ** [DataAccessRoleArn](#API_StartSNOMEDCTInferenceJob_RequestSyntax) **   <a name="comprehendmedical-StartSNOMEDCTInferenceJob-request-DataAccessRoleArn"></a>
 The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) role that grants Amazon Comprehend Medical read access to your input data.   
Type: String  
Length Constraints: Minimum length of 20. Maximum length of 2048.  
Pattern: `arn:aws(-[^:]+)?:iam::[0-9]{12}:role/.+`   
Required: Yes

 ** [InputDataConfig](#API_StartSNOMEDCTInferenceJob_RequestSyntax) **   <a name="comprehendmedical-StartSNOMEDCTInferenceJob-request-InputDataConfig"></a>
The input properties for an entities detection job. This includes the name of the S3 bucket and the path to the files to be analyzed.   
Type: [InputDataConfig](API_InputDataConfig.md) object  
Required: Yes

 ** [JobName](#API_StartSNOMEDCTInferenceJob_RequestSyntax) **   <a name="comprehendmedical-StartSNOMEDCTInferenceJob-request-JobName"></a>
 The user generated name the asynchronous InferSNOMEDCT job.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `^([\p{L}\p{Z}\p{N}_.:/=+\-%@]*)$`   
Required: No

 ** [KMSKey](#API_StartSNOMEDCTInferenceJob_RequestSyntax) **   <a name="comprehendmedical-StartSNOMEDCTInferenceJob-request-KMSKey"></a>
 An AWS Key Management Service key used to encrypt your output files. If you do not specify a key, the files are written in plain text.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 2048.  
Pattern: `.*`   
Required: No

 ** [LanguageCode](#API_StartSNOMEDCTInferenceJob_RequestSyntax) **   <a name="comprehendmedical-StartSNOMEDCTInferenceJob-request-LanguageCode"></a>
 The language of the input documents. All documents must be in the same language.   
Type: String  
Valid Values: `en`   
Required: Yes

 ** [OutputDataConfig](#API_StartSNOMEDCTInferenceJob_RequestSyntax) **   <a name="comprehendmedical-StartSNOMEDCTInferenceJob-request-OutputDataConfig"></a>
The output properties for a detection job.  
Type: [OutputDataConfig](API_OutputDataConfig.md) object  
Required: Yes

## Response Syntax
<a name="API_StartSNOMEDCTInferenceJob_ResponseSyntax"></a>

```
{
   "JobId": "string"
}
```

## Response Elements
<a name="API_StartSNOMEDCTInferenceJob_ResponseElements"></a>

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

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

 ** [JobId](#API_StartSNOMEDCTInferenceJob_ResponseSyntax) **   <a name="comprehendmedical-StartSNOMEDCTInferenceJob-response-JobId"></a>
 The identifier generated for the job. To get the status of a job, use this identifier with the StartSNOMEDCTInferenceJob operation.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 32.  
Pattern: `^([\p{L}\p{Z}\p{N}_.:/=+\-%@]*)$` 

## Errors
<a name="API_StartSNOMEDCTInferenceJob_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalServerException **   
 An internal server error occurred. Retry your request.   
HTTP Status Code: 500

 ** InvalidRequestException **   
 The request that you made is invalid. Check your request to determine why it's invalid and then retry the request.  
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource identified by the specified Amazon Resource Name (ARN) was not found. Check the ARN and try your request again.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
 You have made too many requests within a short period of time. Wait for a short time and then try your request again. Contact customer support for more information about a service limit increase.   
HTTP Status Code: 400

## See Also
<a name="API_StartSNOMEDCTInferenceJob_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/comprehendmedical-2018-10-30/StartSNOMEDCTInferenceJob) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/comprehendmedical-2018-10-30/StartSNOMEDCTInferenceJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/comprehendmedical-2018-10-30/StartSNOMEDCTInferenceJob) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/comprehendmedical-2018-10-30/StartSNOMEDCTInferenceJob) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/comprehendmedical-2018-10-30/StartSNOMEDCTInferenceJob) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/comprehendmedical-2018-10-30/StartSNOMEDCTInferenceJob) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/comprehendmedical-2018-10-30/StartSNOMEDCTInferenceJob) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/comprehendmedical-2018-10-30/StartSNOMEDCTInferenceJob) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/comprehendmedical-2018-10-30/StartSNOMEDCTInferenceJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/comprehendmedical-2018-10-30/StartSNOMEDCTInferenceJob)