DescribeSentimentDetectionJobCommand

Suggest an Edit

Gets the properties associated with a sentiment detection job. Use this operation to get the status of a detection job.

Example Syntax

Use a bare-bones client and the command you need to make an API call.

import { ComprehendClient, DescribeSentimentDetectionJobCommand } from "@aws-sdk/client-comprehend"; // ES Modules import
// const { ComprehendClient, DescribeSentimentDetectionJobCommand } = require("@aws-sdk/client-comprehend"); // CommonJS import
const client = new ComprehendClient(config);
const input = { // DescribeSentimentDetectionJobRequest
  JobId: "STRING_VALUE", // required
};
const command = new DescribeSentimentDetectionJobCommand(input);
const response = await client.send(command);
// { // DescribeSentimentDetectionJobResponse
//   SentimentDetectionJobProperties: { // SentimentDetectionJobProperties
//     JobId: "STRING_VALUE",
//     JobArn: "STRING_VALUE",
//     JobName: "STRING_VALUE",
//     JobStatus: "SUBMITTED" || "IN_PROGRESS" || "COMPLETED" || "FAILED" || "STOP_REQUESTED" || "STOPPED",
//     Message: "STRING_VALUE",
//     SubmitTime: new Date("TIMESTAMP"),
//     EndTime: new Date("TIMESTAMP"),
//     InputDataConfig: { // InputDataConfig
//       S3Uri: "STRING_VALUE", // required
//       InputFormat: "ONE_DOC_PER_FILE" || "ONE_DOC_PER_LINE",
//       DocumentReaderConfig: { // DocumentReaderConfig
//         DocumentReadAction: "TEXTRACT_DETECT_DOCUMENT_TEXT" || "TEXTRACT_ANALYZE_DOCUMENT", // required
//         DocumentReadMode: "SERVICE_DEFAULT" || "FORCE_DOCUMENT_READ_ACTION",
//         FeatureTypes: [ // ListOfDocumentReadFeatureTypes
//           "TABLES" || "FORMS",
//         ],
//       },
//     },
//     OutputDataConfig: { // OutputDataConfig
//       S3Uri: "STRING_VALUE", // required
//       KmsKeyId: "STRING_VALUE",
//     },
//     LanguageCode: "en" || "es" || "fr" || "de" || "it" || "pt" || "ar" || "hi" || "ja" || "ko" || "zh" || "zh-TW",
//     DataAccessRoleArn: "STRING_VALUE",
//     VolumeKmsKeyId: "STRING_VALUE",
//     VpcConfig: { // VpcConfig
//       SecurityGroupIds: [ // SecurityGroupIds // required
//         "STRING_VALUE",
//       ],
//       Subnets: [ // Subnets // required
//         "STRING_VALUE",
//       ],
//     },
//   },
// };

DescribeSentimentDetectionJobCommand Input

See DescribeSentimentDetectionJobCommandInput for more details

Parameter
Type
Description
JobId
Required
string | undefined

The identifier that Amazon Comprehend generated for the job. The operation returns this identifier in its response.

DescribeSentimentDetectionJobCommand Output

See DescribeSentimentDetectionJobCommandOutput for details

Parameter
Type
Description
$metadata
Required
ResponseMetadata
Metadata pertaining to this request.
SentimentDetectionJobProperties
SentimentDetectionJobProperties | undefined

An object that contains the properties associated with a sentiment detection job.

Throws

Name
Fault
Details
InternalServerException
server

An internal server error occurred. Retry your request.

InvalidRequestException
client

The request is invalid.

JobNotFoundException
client

The specified job was not found. Check the job ID and try again.

TooManyRequestsException
client

The number of requests exceeds the limit. Resubmit your request later.

ComprehendServiceException
Base exception class for all service exceptions from Comprehend service.