@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AbstractAmazonComprehend extends Object implements AmazonComprehend
AmazonComprehend
. Convenient method forms pass through to the corresponding
overload that takes a request object, which throws an UnsupportedOperationException
.ENDPOINT_PREFIX
Modifier and Type | Method and Description |
---|---|
BatchDetectDominantLanguageResult |
batchDetectDominantLanguage(BatchDetectDominantLanguageRequest request)
Determines the dominant language of the input text for a batch of documents.
|
BatchDetectEntitiesResult |
batchDetectEntities(BatchDetectEntitiesRequest request)
Inspects the text of a batch of documents for named entities and returns information about them.
|
BatchDetectKeyPhrasesResult |
batchDetectKeyPhrases(BatchDetectKeyPhrasesRequest request)
Detects the key noun phrases found in a batch of documents.
|
BatchDetectSentimentResult |
batchDetectSentiment(BatchDetectSentimentRequest request)
Inspects a batch of documents and returns an inference of the prevailing sentiment,
POSITIVE ,
NEUTRAL , MIXED , or NEGATIVE , in each one. |
BatchDetectSyntaxResult |
batchDetectSyntax(BatchDetectSyntaxRequest request)
Inspects the text of a batch of documents for the syntax and part of speech of the words in the document and
returns information about them.
|
BatchDetectTargetedSentimentResult |
batchDetectTargetedSentiment(BatchDetectTargetedSentimentRequest request)
Inspects a batch of documents and returns a sentiment analysis for each entity identified in the documents.
|
ClassifyDocumentResult |
classifyDocument(ClassifyDocumentRequest request)
Creates a classification request to analyze a single document in real-time.
|
ContainsPiiEntitiesResult |
containsPiiEntities(ContainsPiiEntitiesRequest request)
Analyzes input text for the presence of personally identifiable information (PII) and returns the labels of
identified PII entity types such as name, address, bank account number, or phone number.
|
CreateDatasetResult |
createDataset(CreateDatasetRequest request)
Creates a dataset to upload training or test data for a model associated with a flywheel.
|
CreateDocumentClassifierResult |
createDocumentClassifier(CreateDocumentClassifierRequest request)
Creates a new document classifier that you can use to categorize documents.
|
CreateEndpointResult |
createEndpoint(CreateEndpointRequest request)
Creates a model-specific endpoint for synchronous inference for a previously trained custom model For information
about endpoints, see Managing
endpoints.
|
CreateEntityRecognizerResult |
createEntityRecognizer(CreateEntityRecognizerRequest request)
Creates an entity recognizer using submitted files.
|
CreateFlywheelResult |
createFlywheel(CreateFlywheelRequest request)
A flywheel is an Amazon Web Services resource that orchestrates the ongoing training of a model for custom
classification or custom entity recognition.
|
DeleteDocumentClassifierResult |
deleteDocumentClassifier(DeleteDocumentClassifierRequest request)
Deletes a previously created document classifier
|
DeleteEndpointResult |
deleteEndpoint(DeleteEndpointRequest request)
Deletes a model-specific endpoint for a previously-trained custom model.
|
DeleteEntityRecognizerResult |
deleteEntityRecognizer(DeleteEntityRecognizerRequest request)
Deletes an entity recognizer.
|
DeleteFlywheelResult |
deleteFlywheel(DeleteFlywheelRequest request)
Deletes a flywheel.
|
DeleteResourcePolicyResult |
deleteResourcePolicy(DeleteResourcePolicyRequest request)
Deletes a resource-based policy that is attached to a custom model.
|
DescribeDatasetResult |
describeDataset(DescribeDatasetRequest request)
Returns information about the dataset that you specify.
|
DescribeDocumentClassificationJobResult |
describeDocumentClassificationJob(DescribeDocumentClassificationJobRequest request)
Gets the properties associated with a document classification job.
|
DescribeDocumentClassifierResult |
describeDocumentClassifier(DescribeDocumentClassifierRequest request)
Gets the properties associated with a document classifier.
|
DescribeDominantLanguageDetectionJobResult |
describeDominantLanguageDetectionJob(DescribeDominantLanguageDetectionJobRequest request)
Gets the properties associated with a dominant language detection job.
|
DescribeEndpointResult |
describeEndpoint(DescribeEndpointRequest request)
Gets the properties associated with a specific endpoint.
|
DescribeEntitiesDetectionJobResult |
describeEntitiesDetectionJob(DescribeEntitiesDetectionJobRequest request)
Gets the properties associated with an entities detection job.
|
DescribeEntityRecognizerResult |
describeEntityRecognizer(DescribeEntityRecognizerRequest request)
Provides details about an entity recognizer including status, S3 buckets containing training data, recognizer
metadata, metrics, and so on.
|
DescribeEventsDetectionJobResult |
describeEventsDetectionJob(DescribeEventsDetectionJobRequest request)
Gets the status and details of an events detection job.
|
DescribeFlywheelResult |
describeFlywheel(DescribeFlywheelRequest request)
Provides configuration information about the flywheel.
|
DescribeFlywheelIterationResult |
describeFlywheelIteration(DescribeFlywheelIterationRequest request)
Retrieve the configuration properties of a flywheel iteration.
|
DescribeKeyPhrasesDetectionJobResult |
describeKeyPhrasesDetectionJob(DescribeKeyPhrasesDetectionJobRequest request)
Gets the properties associated with a key phrases detection job.
|
DescribePiiEntitiesDetectionJobResult |
describePiiEntitiesDetectionJob(DescribePiiEntitiesDetectionJobRequest request)
Gets the properties associated with a PII entities detection job.
|
DescribeResourcePolicyResult |
describeResourcePolicy(DescribeResourcePolicyRequest request)
Gets the details of a resource-based policy that is attached to a custom model, including the JSON body of the
policy.
|
DescribeSentimentDetectionJobResult |
describeSentimentDetectionJob(DescribeSentimentDetectionJobRequest request)
Gets the properties associated with a sentiment detection job.
|
DescribeTargetedSentimentDetectionJobResult |
describeTargetedSentimentDetectionJob(DescribeTargetedSentimentDetectionJobRequest request)
Gets the properties associated with a targeted sentiment detection job.
|
DescribeTopicsDetectionJobResult |
describeTopicsDetectionJob(DescribeTopicsDetectionJobRequest request)
Gets the properties associated with a topic detection job.
|
DetectDominantLanguageResult |
detectDominantLanguage(DetectDominantLanguageRequest request)
Determines the dominant language of the input text.
|
DetectEntitiesResult |
detectEntities(DetectEntitiesRequest request)
Detects named entities in input text when you use the pre-trained model.
|
DetectKeyPhrasesResult |
detectKeyPhrases(DetectKeyPhrasesRequest request)
Detects the key noun phrases found in the text.
|
DetectPiiEntitiesResult |
detectPiiEntities(DetectPiiEntitiesRequest request)
Inspects the input text for entities that contain personally identifiable information (PII) and returns
information about them.
|
DetectSentimentResult |
detectSentiment(DetectSentimentRequest request)
Inspects text and returns an inference of the prevailing sentiment (
POSITIVE , NEUTRAL ,
MIXED , or NEGATIVE ). |
DetectSyntaxResult |
detectSyntax(DetectSyntaxRequest request)
Inspects text for syntax and the part of speech of words in the document.
|
DetectTargetedSentimentResult |
detectTargetedSentiment(DetectTargetedSentimentRequest request)
Inspects the input text and returns a sentiment analysis for each entity identified in the text.
|
DetectToxicContentResult |
detectToxicContent(DetectToxicContentRequest request)
Performs toxicity analysis on the list of text strings that you provide as input.
|
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful request, typically used for debugging issues
where a service isn't acting as expected.
|
ImportModelResult |
importModel(ImportModelRequest request)
Creates a new custom model that replicates a source custom model that you import.
|
ListDatasetsResult |
listDatasets(ListDatasetsRequest request)
List the datasets that you have configured in this Region.
|
ListDocumentClassificationJobsResult |
listDocumentClassificationJobs(ListDocumentClassificationJobsRequest request)
Gets a list of the documentation classification jobs that you have submitted.
|
ListDocumentClassifiersResult |
listDocumentClassifiers(ListDocumentClassifiersRequest request)
Gets a list of the document classifiers that you have created.
|
ListDocumentClassifierSummariesResult |
listDocumentClassifierSummaries(ListDocumentClassifierSummariesRequest request)
Gets a list of summaries of the document classifiers that you have created
|
ListDominantLanguageDetectionJobsResult |
listDominantLanguageDetectionJobs(ListDominantLanguageDetectionJobsRequest request)
Gets a list of the dominant language detection jobs that you have submitted.
|
ListEndpointsResult |
listEndpoints(ListEndpointsRequest request)
Gets a list of all existing endpoints that you've created.
|
ListEntitiesDetectionJobsResult |
listEntitiesDetectionJobs(ListEntitiesDetectionJobsRequest request)
Gets a list of the entity detection jobs that you have submitted.
|
ListEntityRecognizersResult |
listEntityRecognizers(ListEntityRecognizersRequest request)
Gets a list of the properties of all entity recognizers that you created, including recognizers currently in
training.
|
ListEntityRecognizerSummariesResult |
listEntityRecognizerSummaries(ListEntityRecognizerSummariesRequest request)
Gets a list of summaries for the entity recognizers that you have created.
|
ListEventsDetectionJobsResult |
listEventsDetectionJobs(ListEventsDetectionJobsRequest request)
Gets a list of the events detection jobs that you have submitted.
|
ListFlywheelIterationHistoryResult |
listFlywheelIterationHistory(ListFlywheelIterationHistoryRequest request)
Information about the history of a flywheel iteration.
|
ListFlywheelsResult |
listFlywheels(ListFlywheelsRequest request)
Gets a list of the flywheels that you have created.
|
ListKeyPhrasesDetectionJobsResult |
listKeyPhrasesDetectionJobs(ListKeyPhrasesDetectionJobsRequest request)
Get a list of key phrase detection jobs that you have submitted.
|
ListPiiEntitiesDetectionJobsResult |
listPiiEntitiesDetectionJobs(ListPiiEntitiesDetectionJobsRequest request)
Gets a list of the PII entity detection jobs that you have submitted.
|
ListSentimentDetectionJobsResult |
listSentimentDetectionJobs(ListSentimentDetectionJobsRequest request)
Gets a list of sentiment detection jobs that you have submitted.
|
ListTagsForResourceResult |
listTagsForResource(ListTagsForResourceRequest request)
Lists all tags associated with a given Amazon Comprehend resource.
|
ListTargetedSentimentDetectionJobsResult |
listTargetedSentimentDetectionJobs(ListTargetedSentimentDetectionJobsRequest request)
Gets a list of targeted sentiment detection jobs that you have submitted.
|
ListTopicsDetectionJobsResult |
listTopicsDetectionJobs(ListTopicsDetectionJobsRequest request)
Gets a list of the topic detection jobs that you have submitted.
|
PutResourcePolicyResult |
putResourcePolicy(PutResourcePolicyRequest request)
Attaches a resource-based policy to a custom model.
|
void |
shutdown()
Shuts down this client object, releasing any resources that might be held open.
|
StartDocumentClassificationJobResult |
startDocumentClassificationJob(StartDocumentClassificationJobRequest request)
Starts an asynchronous document classification job using a custom classification model.
|
StartDominantLanguageDetectionJobResult |
startDominantLanguageDetectionJob(StartDominantLanguageDetectionJobRequest request)
Starts an asynchronous dominant language detection job for a collection of documents.
|
StartEntitiesDetectionJobResult |
startEntitiesDetectionJob(StartEntitiesDetectionJobRequest request)
Starts an asynchronous entity detection job for a collection of documents.
|
StartEventsDetectionJobResult |
startEventsDetectionJob(StartEventsDetectionJobRequest request)
Starts an asynchronous event detection job for a collection of documents.
|
StartFlywheelIterationResult |
startFlywheelIteration(StartFlywheelIterationRequest request)
Start the flywheel iteration.This operation uses any new datasets to train a new model version.
|
StartKeyPhrasesDetectionJobResult |
startKeyPhrasesDetectionJob(StartKeyPhrasesDetectionJobRequest request)
Starts an asynchronous key phrase detection job for a collection of documents.
|
StartPiiEntitiesDetectionJobResult |
startPiiEntitiesDetectionJob(StartPiiEntitiesDetectionJobRequest request)
Starts an asynchronous PII entity detection job for a collection of documents.
|
StartSentimentDetectionJobResult |
startSentimentDetectionJob(StartSentimentDetectionJobRequest request)
Starts an asynchronous sentiment detection job for a collection of documents.
|
StartTargetedSentimentDetectionJobResult |
startTargetedSentimentDetectionJob(StartTargetedSentimentDetectionJobRequest request)
Starts an asynchronous targeted sentiment detection job for a collection of documents.
|
StartTopicsDetectionJobResult |
startTopicsDetectionJob(StartTopicsDetectionJobRequest request)
Starts an asynchronous topic detection job.
|
StopDominantLanguageDetectionJobResult |
stopDominantLanguageDetectionJob(StopDominantLanguageDetectionJobRequest request)
Stops a dominant language detection job in progress.
|
StopEntitiesDetectionJobResult |
stopEntitiesDetectionJob(StopEntitiesDetectionJobRequest request)
Stops an entities detection job in progress.
|
StopEventsDetectionJobResult |
stopEventsDetectionJob(StopEventsDetectionJobRequest request)
Stops an events detection job in progress.
|
StopKeyPhrasesDetectionJobResult |
stopKeyPhrasesDetectionJob(StopKeyPhrasesDetectionJobRequest request)
Stops a key phrases detection job in progress.
|
StopPiiEntitiesDetectionJobResult |
stopPiiEntitiesDetectionJob(StopPiiEntitiesDetectionJobRequest request)
Stops a PII entities detection job in progress.
|
StopSentimentDetectionJobResult |
stopSentimentDetectionJob(StopSentimentDetectionJobRequest request)
Stops a sentiment detection job in progress.
|
StopTargetedSentimentDetectionJobResult |
stopTargetedSentimentDetectionJob(StopTargetedSentimentDetectionJobRequest request)
Stops a targeted sentiment detection job in progress.
|
StopTrainingDocumentClassifierResult |
stopTrainingDocumentClassifier(StopTrainingDocumentClassifierRequest request)
Stops a document classifier training job while in progress.
|
StopTrainingEntityRecognizerResult |
stopTrainingEntityRecognizer(StopTrainingEntityRecognizerRequest request)
Stops an entity recognizer training job while in progress.
|
TagResourceResult |
tagResource(TagResourceRequest request)
Associates a specific tag with an Amazon Comprehend resource.
|
UntagResourceResult |
untagResource(UntagResourceRequest request)
Removes a specific tag associated with an Amazon Comprehend resource.
|
UpdateEndpointResult |
updateEndpoint(UpdateEndpointRequest request)
Updates information about the specified endpoint.
|
UpdateFlywheelResult |
updateFlywheel(UpdateFlywheelRequest request)
Update the configuration information for an existing flywheel.
|
public BatchDetectDominantLanguageResult batchDetectDominantLanguage(BatchDetectDominantLanguageRequest request)
AmazonComprehend
Determines the dominant language of the input text for a batch of documents. For a list of languages that Amazon Comprehend can detect, see Amazon Comprehend Supported Languages.
batchDetectDominantLanguage
in interface AmazonComprehend
public BatchDetectEntitiesResult batchDetectEntities(BatchDetectEntitiesRequest request)
AmazonComprehend
Inspects the text of a batch of documents for named entities and returns information about them. For more information about named entities, see Entities in the Comprehend Developer Guide.
batchDetectEntities
in interface AmazonComprehend
public BatchDetectKeyPhrasesResult batchDetectKeyPhrases(BatchDetectKeyPhrasesRequest request)
AmazonComprehend
Detects the key noun phrases found in a batch of documents.
batchDetectKeyPhrases
in interface AmazonComprehend
public BatchDetectSentimentResult batchDetectSentiment(BatchDetectSentimentRequest request)
AmazonComprehend
Inspects a batch of documents and returns an inference of the prevailing sentiment, POSITIVE
,
NEUTRAL
, MIXED
, or NEGATIVE
, in each one.
batchDetectSentiment
in interface AmazonComprehend
public BatchDetectSyntaxResult batchDetectSyntax(BatchDetectSyntaxRequest request)
AmazonComprehend
Inspects the text of a batch of documents for the syntax and part of speech of the words in the document and returns information about them. For more information, see Syntax in the Comprehend Developer Guide.
batchDetectSyntax
in interface AmazonComprehend
public BatchDetectTargetedSentimentResult batchDetectTargetedSentiment(BatchDetectTargetedSentimentRequest request)
AmazonComprehend
Inspects a batch of documents and returns a sentiment analysis for each entity identified in the documents.
For more information about targeted sentiment, see Targeted sentiment in the Amazon Comprehend Developer Guide.
batchDetectTargetedSentiment
in interface AmazonComprehend
public ClassifyDocumentResult classifyDocument(ClassifyDocumentRequest request)
AmazonComprehend
Creates a classification request to analyze a single document in real-time. ClassifyDocument
supports the following model types:
Custom classifier - a custom model that you have created and trained. For input, you can provide plain text, a single-page document (PDF, Word, or image), or Amazon Textract API output. For more information, see Custom classification in the Amazon Comprehend Developer Guide.
Prompt safety classifier - Amazon Comprehend provides a pre-trained model for classifying input prompts for
generative AI applications. For input, you provide English plain text input. For prompt safety classification,
the response includes only the Classes
field. For more information about prompt safety classifiers,
see Prompt
safety classification in the Amazon Comprehend Developer Guide.
If the system detects errors while processing a page in the input document, the API response includes an
Errors
field that describes the errors.
If the system detects a document-level error in your input document, the API returns an
InvalidRequestException
error response. For details about this exception, see Errors in semi-structured
documents in the Comprehend Developer Guide.
classifyDocument
in interface AmazonComprehend
public ContainsPiiEntitiesResult containsPiiEntities(ContainsPiiEntitiesRequest request)
AmazonComprehend
Analyzes input text for the presence of personally identifiable information (PII) and returns the labels of identified PII entity types such as name, address, bank account number, or phone number.
containsPiiEntities
in interface AmazonComprehend
public CreateDatasetResult createDataset(CreateDatasetRequest request)
AmazonComprehend
Creates a dataset to upload training or test data for a model associated with a flywheel. For more information about datasets, see Flywheel overview in the Amazon Comprehend Developer Guide.
createDataset
in interface AmazonComprehend
public CreateDocumentClassifierResult createDocumentClassifier(CreateDocumentClassifierRequest request)
AmazonComprehend
Creates a new document classifier that you can use to categorize documents. To create a classifier, you provide a set of training documents that are labeled with the categories that you want to use. For more information, see Training classifier models in the Comprehend Developer Guide.
createDocumentClassifier
in interface AmazonComprehend
public CreateEndpointResult createEndpoint(CreateEndpointRequest request)
AmazonComprehend
Creates a model-specific endpoint for synchronous inference for a previously trained custom model For information about endpoints, see Managing endpoints.
createEndpoint
in interface AmazonComprehend
public CreateEntityRecognizerResult createEntityRecognizer(CreateEntityRecognizerRequest request)
AmazonComprehend
Creates an entity recognizer using submitted files. After your CreateEntityRecognizer
request is
submitted, you can check job status using the DescribeEntityRecognizer
API.
createEntityRecognizer
in interface AmazonComprehend
public CreateFlywheelResult createFlywheel(CreateFlywheelRequest request)
AmazonComprehend
A flywheel is an Amazon Web Services resource that orchestrates the ongoing training of a model for custom classification or custom entity recognition. You can create a flywheel to start with an existing trained model, or Comprehend can create and train a new model.
When you create the flywheel, Comprehend creates a data lake in your account. The data lake holds the training data and test data for all versions of the model.
To use a flywheel with an existing trained model, you specify the active model version. Comprehend copies the model's training data and test data into the flywheel's data lake.
To use the flywheel with a new model, you need to provide a dataset for training data (and optional test data) when you create the flywheel.
For more information about flywheels, see Flywheel overview in the Amazon Comprehend Developer Guide.
createFlywheel
in interface AmazonComprehend
public DeleteDocumentClassifierResult deleteDocumentClassifier(DeleteDocumentClassifierRequest request)
AmazonComprehend
Deletes a previously created document classifier
Only those classifiers that are in terminated states (IN_ERROR, TRAINED) will be deleted. If an active inference
job is using the model, a ResourceInUseException
will be returned.
This is an asynchronous action that puts the classifier into a DELETING state, and it is then removed by a background job. Once removed, the classifier disappears from your account and is no longer available for use.
deleteDocumentClassifier
in interface AmazonComprehend
public DeleteEndpointResult deleteEndpoint(DeleteEndpointRequest request)
AmazonComprehend
Deletes a model-specific endpoint for a previously-trained custom model. All endpoints must be deleted in order for the model to be deleted. For information about endpoints, see Managing endpoints.
deleteEndpoint
in interface AmazonComprehend
public DeleteEntityRecognizerResult deleteEntityRecognizer(DeleteEntityRecognizerRequest request)
AmazonComprehend
Deletes an entity recognizer.
Only those recognizers that are in terminated states (IN_ERROR, TRAINED) will be deleted. If an active inference
job is using the model, a ResourceInUseException
will be returned.
This is an asynchronous action that puts the recognizer into a DELETING state, and it is then removed by a background job. Once removed, the recognizer disappears from your account and is no longer available for use.
deleteEntityRecognizer
in interface AmazonComprehend
public DeleteFlywheelResult deleteFlywheel(DeleteFlywheelRequest request)
AmazonComprehend
Deletes a flywheel. When you delete the flywheel, Amazon Comprehend does not delete the data lake or the model associated with the flywheel.
For more information about flywheels, see Flywheel overview in the Amazon Comprehend Developer Guide.
deleteFlywheel
in interface AmazonComprehend
public DeleteResourcePolicyResult deleteResourcePolicy(DeleteResourcePolicyRequest request)
AmazonComprehend
Deletes a resource-based policy that is attached to a custom model.
deleteResourcePolicy
in interface AmazonComprehend
public DescribeDatasetResult describeDataset(DescribeDatasetRequest request)
AmazonComprehend
Returns information about the dataset that you specify. For more information about datasets, see Flywheel overview in the Amazon Comprehend Developer Guide.
describeDataset
in interface AmazonComprehend
public DescribeDocumentClassificationJobResult describeDocumentClassificationJob(DescribeDocumentClassificationJobRequest request)
AmazonComprehend
Gets the properties associated with a document classification job. Use this operation to get the status of a classification job.
describeDocumentClassificationJob
in interface AmazonComprehend
public DescribeDocumentClassifierResult describeDocumentClassifier(DescribeDocumentClassifierRequest request)
AmazonComprehend
Gets the properties associated with a document classifier.
describeDocumentClassifier
in interface AmazonComprehend
public DescribeDominantLanguageDetectionJobResult describeDominantLanguageDetectionJob(DescribeDominantLanguageDetectionJobRequest request)
AmazonComprehend
Gets the properties associated with a dominant language detection job. Use this operation to get the status of a detection job.
describeDominantLanguageDetectionJob
in interface AmazonComprehend
public DescribeEndpointResult describeEndpoint(DescribeEndpointRequest request)
AmazonComprehend
Gets the properties associated with a specific endpoint. Use this operation to get the status of an endpoint. For information about endpoints, see Managing endpoints.
describeEndpoint
in interface AmazonComprehend
public DescribeEntitiesDetectionJobResult describeEntitiesDetectionJob(DescribeEntitiesDetectionJobRequest request)
AmazonComprehend
Gets the properties associated with an entities detection job. Use this operation to get the status of a detection job.
describeEntitiesDetectionJob
in interface AmazonComprehend
public DescribeEntityRecognizerResult describeEntityRecognizer(DescribeEntityRecognizerRequest request)
AmazonComprehend
Provides details about an entity recognizer including status, S3 buckets containing training data, recognizer metadata, metrics, and so on.
describeEntityRecognizer
in interface AmazonComprehend
public DescribeEventsDetectionJobResult describeEventsDetectionJob(DescribeEventsDetectionJobRequest request)
AmazonComprehend
Gets the status and details of an events detection job.
describeEventsDetectionJob
in interface AmazonComprehend
public DescribeFlywheelResult describeFlywheel(DescribeFlywheelRequest request)
AmazonComprehend
Provides configuration information about the flywheel. For more information about flywheels, see Flywheel overview in the Amazon Comprehend Developer Guide.
describeFlywheel
in interface AmazonComprehend
public DescribeFlywheelIterationResult describeFlywheelIteration(DescribeFlywheelIterationRequest request)
AmazonComprehend
Retrieve the configuration properties of a flywheel iteration. For more information about flywheels, see Flywheel overview in the Amazon Comprehend Developer Guide.
describeFlywheelIteration
in interface AmazonComprehend
public DescribeKeyPhrasesDetectionJobResult describeKeyPhrasesDetectionJob(DescribeKeyPhrasesDetectionJobRequest request)
AmazonComprehend
Gets the properties associated with a key phrases detection job. Use this operation to get the status of a detection job.
describeKeyPhrasesDetectionJob
in interface AmazonComprehend
public DescribePiiEntitiesDetectionJobResult describePiiEntitiesDetectionJob(DescribePiiEntitiesDetectionJobRequest request)
AmazonComprehend
Gets the properties associated with a PII entities detection job. For example, you can use this operation to get the job status.
describePiiEntitiesDetectionJob
in interface AmazonComprehend
public DescribeResourcePolicyResult describeResourcePolicy(DescribeResourcePolicyRequest request)
AmazonComprehend
Gets the details of a resource-based policy that is attached to a custom model, including the JSON body of the policy.
describeResourcePolicy
in interface AmazonComprehend
public DescribeSentimentDetectionJobResult describeSentimentDetectionJob(DescribeSentimentDetectionJobRequest request)
AmazonComprehend
Gets the properties associated with a sentiment detection job. Use this operation to get the status of a detection job.
describeSentimentDetectionJob
in interface AmazonComprehend
public DescribeTargetedSentimentDetectionJobResult describeTargetedSentimentDetectionJob(DescribeTargetedSentimentDetectionJobRequest request)
AmazonComprehend
Gets the properties associated with a targeted sentiment detection job. Use this operation to get the status of the job.
describeTargetedSentimentDetectionJob
in interface AmazonComprehend
public DescribeTopicsDetectionJobResult describeTopicsDetectionJob(DescribeTopicsDetectionJobRequest request)
AmazonComprehend
Gets the properties associated with a topic detection job. Use this operation to get the status of a detection job.
describeTopicsDetectionJob
in interface AmazonComprehend
public DetectDominantLanguageResult detectDominantLanguage(DetectDominantLanguageRequest request)
AmazonComprehend
Determines the dominant language of the input text. For a list of languages that Amazon Comprehend can detect, see Amazon Comprehend Supported Languages.
detectDominantLanguage
in interface AmazonComprehend
public DetectEntitiesResult detectEntities(DetectEntitiesRequest request)
AmazonComprehend
Detects named entities in input text when you use the pre-trained model. Detects custom entities if you have a custom entity recognition model.
When detecting named entities using the pre-trained model, use plain text as the input. For more information about named entities, see Entities in the Comprehend Developer Guide.
When you use a custom entity recognition model, you can input plain text or you can upload a single-page input document (text, PDF, Word, or image).
If the system detects errors while processing a page in the input document, the API response includes an entry in
Errors
for each error.
If the system detects a document-level error in your input document, the API returns an
InvalidRequestException
error response. For details about this exception, see Errors in semi-structured
documents in the Comprehend Developer Guide.
detectEntities
in interface AmazonComprehend
public DetectKeyPhrasesResult detectKeyPhrases(DetectKeyPhrasesRequest request)
AmazonComprehend
Detects the key noun phrases found in the text.
detectKeyPhrases
in interface AmazonComprehend
public DetectPiiEntitiesResult detectPiiEntities(DetectPiiEntitiesRequest request)
AmazonComprehend
Inspects the input text for entities that contain personally identifiable information (PII) and returns information about them.
detectPiiEntities
in interface AmazonComprehend
public DetectSentimentResult detectSentiment(DetectSentimentRequest request)
AmazonComprehend
Inspects text and returns an inference of the prevailing sentiment (POSITIVE
, NEUTRAL
,
MIXED
, or NEGATIVE
).
detectSentiment
in interface AmazonComprehend
public DetectSyntaxResult detectSyntax(DetectSyntaxRequest request)
AmazonComprehend
Inspects text for syntax and the part of speech of words in the document. For more information, see Syntax in the Comprehend Developer Guide.
detectSyntax
in interface AmazonComprehend
public DetectTargetedSentimentResult detectTargetedSentiment(DetectTargetedSentimentRequest request)
AmazonComprehend
Inspects the input text and returns a sentiment analysis for each entity identified in the text.
For more information about targeted sentiment, see Targeted sentiment in the Amazon Comprehend Developer Guide.
detectTargetedSentiment
in interface AmazonComprehend
public DetectToxicContentResult detectToxicContent(DetectToxicContentRequest request)
AmazonComprehend
Performs toxicity analysis on the list of text strings that you provide as input. The API response contains a results list that matches the size of the input list. For more information about toxicity detection, see Toxicity detection in the Amazon Comprehend Developer Guide.
detectToxicContent
in interface AmazonComprehend
public ImportModelResult importModel(ImportModelRequest request)
AmazonComprehend
Creates a new custom model that replicates a source custom model that you import. The source model can be in your Amazon Web Services account or another one.
If the source model is in another Amazon Web Services account, then it must have a resource-based policy that authorizes you to import it.
The source model must be in the same Amazon Web Services Region that you're using when you import. You can't import a model that's in a different Region.
importModel
in interface AmazonComprehend
public ListDatasetsResult listDatasets(ListDatasetsRequest request)
AmazonComprehend
List the datasets that you have configured in this Region. For more information about datasets, see Flywheel overview in the Amazon Comprehend Developer Guide.
listDatasets
in interface AmazonComprehend
public ListDocumentClassificationJobsResult listDocumentClassificationJobs(ListDocumentClassificationJobsRequest request)
AmazonComprehend
Gets a list of the documentation classification jobs that you have submitted.
listDocumentClassificationJobs
in interface AmazonComprehend
public ListDocumentClassifierSummariesResult listDocumentClassifierSummaries(ListDocumentClassifierSummariesRequest request)
AmazonComprehend
Gets a list of summaries of the document classifiers that you have created
listDocumentClassifierSummaries
in interface AmazonComprehend
public ListDocumentClassifiersResult listDocumentClassifiers(ListDocumentClassifiersRequest request)
AmazonComprehend
Gets a list of the document classifiers that you have created.
listDocumentClassifiers
in interface AmazonComprehend
public ListDominantLanguageDetectionJobsResult listDominantLanguageDetectionJobs(ListDominantLanguageDetectionJobsRequest request)
AmazonComprehend
Gets a list of the dominant language detection jobs that you have submitted.
listDominantLanguageDetectionJobs
in interface AmazonComprehend
public ListEndpointsResult listEndpoints(ListEndpointsRequest request)
AmazonComprehend
Gets a list of all existing endpoints that you've created. For information about endpoints, see Managing endpoints.
listEndpoints
in interface AmazonComprehend
public ListEntitiesDetectionJobsResult listEntitiesDetectionJobs(ListEntitiesDetectionJobsRequest request)
AmazonComprehend
Gets a list of the entity detection jobs that you have submitted.
listEntitiesDetectionJobs
in interface AmazonComprehend
public ListEntityRecognizerSummariesResult listEntityRecognizerSummaries(ListEntityRecognizerSummariesRequest request)
AmazonComprehend
Gets a list of summaries for the entity recognizers that you have created.
listEntityRecognizerSummaries
in interface AmazonComprehend
public ListEntityRecognizersResult listEntityRecognizers(ListEntityRecognizersRequest request)
AmazonComprehend
Gets a list of the properties of all entity recognizers that you created, including recognizers currently in training. Allows you to filter the list of recognizers based on criteria such as status and submission time. This call returns up to 500 entity recognizers in the list, with a default number of 100 recognizers in the list.
The results of this list are not in any particular order. Please get the list and sort locally if needed.
listEntityRecognizers
in interface AmazonComprehend
public ListEventsDetectionJobsResult listEventsDetectionJobs(ListEventsDetectionJobsRequest request)
AmazonComprehend
Gets a list of the events detection jobs that you have submitted.
listEventsDetectionJobs
in interface AmazonComprehend
public ListFlywheelIterationHistoryResult listFlywheelIterationHistory(ListFlywheelIterationHistoryRequest request)
AmazonComprehend
Information about the history of a flywheel iteration. For more information about flywheels, see Flywheel overview in the Amazon Comprehend Developer Guide.
listFlywheelIterationHistory
in interface AmazonComprehend
public ListFlywheelsResult listFlywheels(ListFlywheelsRequest request)
AmazonComprehend
Gets a list of the flywheels that you have created.
listFlywheels
in interface AmazonComprehend
public ListKeyPhrasesDetectionJobsResult listKeyPhrasesDetectionJobs(ListKeyPhrasesDetectionJobsRequest request)
AmazonComprehend
Get a list of key phrase detection jobs that you have submitted.
listKeyPhrasesDetectionJobs
in interface AmazonComprehend
public ListPiiEntitiesDetectionJobsResult listPiiEntitiesDetectionJobs(ListPiiEntitiesDetectionJobsRequest request)
AmazonComprehend
Gets a list of the PII entity detection jobs that you have submitted.
listPiiEntitiesDetectionJobs
in interface AmazonComprehend
public ListSentimentDetectionJobsResult listSentimentDetectionJobs(ListSentimentDetectionJobsRequest request)
AmazonComprehend
Gets a list of sentiment detection jobs that you have submitted.
listSentimentDetectionJobs
in interface AmazonComprehend
public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)
AmazonComprehend
Lists all tags associated with a given Amazon Comprehend resource.
listTagsForResource
in interface AmazonComprehend
public ListTargetedSentimentDetectionJobsResult listTargetedSentimentDetectionJobs(ListTargetedSentimentDetectionJobsRequest request)
AmazonComprehend
Gets a list of targeted sentiment detection jobs that you have submitted.
listTargetedSentimentDetectionJobs
in interface AmazonComprehend
public ListTopicsDetectionJobsResult listTopicsDetectionJobs(ListTopicsDetectionJobsRequest request)
AmazonComprehend
Gets a list of the topic detection jobs that you have submitted.
listTopicsDetectionJobs
in interface AmazonComprehend
public PutResourcePolicyResult putResourcePolicy(PutResourcePolicyRequest request)
AmazonComprehend
Attaches a resource-based policy to a custom model. You can use this policy to authorize an entity in another Amazon Web Services account to import the custom model, which replicates it in Amazon Comprehend in their account.
putResourcePolicy
in interface AmazonComprehend
public StartDocumentClassificationJobResult startDocumentClassificationJob(StartDocumentClassificationJobRequest request)
AmazonComprehend
Starts an asynchronous document classification job using a custom classification model. Use the
DescribeDocumentClassificationJob
operation to track the progress of the job.
startDocumentClassificationJob
in interface AmazonComprehend
public StartDominantLanguageDetectionJobResult startDominantLanguageDetectionJob(StartDominantLanguageDetectionJobRequest request)
AmazonComprehend
Starts an asynchronous dominant language detection job for a collection of documents. Use the operation to track the status of a job.
startDominantLanguageDetectionJob
in interface AmazonComprehend
public StartEntitiesDetectionJobResult startEntitiesDetectionJob(StartEntitiesDetectionJobRequest request)
AmazonComprehend
Starts an asynchronous entity detection job for a collection of documents. Use the operation to track the status of a job.
This API can be used for either standard entity detection or custom entity recognition. In order to be used for
custom entity recognition, the optional EntityRecognizerArn
must be used in order to provide access
to the recognizer being used to detect the custom entity.
startEntitiesDetectionJob
in interface AmazonComprehend
public StartEventsDetectionJobResult startEventsDetectionJob(StartEventsDetectionJobRequest request)
AmazonComprehend
Starts an asynchronous event detection job for a collection of documents.
startEventsDetectionJob
in interface AmazonComprehend
public StartFlywheelIterationResult startFlywheelIteration(StartFlywheelIterationRequest request)
AmazonComprehend
Start the flywheel iteration.This operation uses any new datasets to train a new model version. For more information about flywheels, see Flywheel overview in the Amazon Comprehend Developer Guide.
startFlywheelIteration
in interface AmazonComprehend
public StartKeyPhrasesDetectionJobResult startKeyPhrasesDetectionJob(StartKeyPhrasesDetectionJobRequest request)
AmazonComprehend
Starts an asynchronous key phrase detection job for a collection of documents. Use the operation to track the status of a job.
startKeyPhrasesDetectionJob
in interface AmazonComprehend
public StartPiiEntitiesDetectionJobResult startPiiEntitiesDetectionJob(StartPiiEntitiesDetectionJobRequest request)
AmazonComprehend
Starts an asynchronous PII entity detection job for a collection of documents.
startPiiEntitiesDetectionJob
in interface AmazonComprehend
public StartSentimentDetectionJobResult startSentimentDetectionJob(StartSentimentDetectionJobRequest request)
AmazonComprehend
Starts an asynchronous sentiment detection job for a collection of documents. Use the operation to track the status of a job.
startSentimentDetectionJob
in interface AmazonComprehend
public StartTargetedSentimentDetectionJobResult startTargetedSentimentDetectionJob(StartTargetedSentimentDetectionJobRequest request)
AmazonComprehend
Starts an asynchronous targeted sentiment detection job for a collection of documents. Use the
DescribeTargetedSentimentDetectionJob
operation to track the status of a job.
startTargetedSentimentDetectionJob
in interface AmazonComprehend
public StartTopicsDetectionJobResult startTopicsDetectionJob(StartTopicsDetectionJobRequest request)
AmazonComprehend
Starts an asynchronous topic detection job. Use the DescribeTopicDetectionJob
operation to track the
status of a job.
startTopicsDetectionJob
in interface AmazonComprehend
public StopDominantLanguageDetectionJobResult stopDominantLanguageDetectionJob(StopDominantLanguageDetectionJobRequest request)
AmazonComprehend
Stops a dominant language detection job in progress.
If the job state is IN_PROGRESS
the job is marked for termination and put into the
STOP_REQUESTED
state. If the job completes before it can be stopped, it is put into the
COMPLETED
state; otherwise the job is stopped and put into the STOPPED
state.
If the job is in the COMPLETED
or FAILED
state when you call the
StopDominantLanguageDetectionJob
operation, the operation returns a 400 Internal Request Exception.
When a job is stopped, any documents already processed are written to the output location.
stopDominantLanguageDetectionJob
in interface AmazonComprehend
public StopEntitiesDetectionJobResult stopEntitiesDetectionJob(StopEntitiesDetectionJobRequest request)
AmazonComprehend
Stops an entities detection job in progress.
If the job state is IN_PROGRESS
the job is marked for termination and put into the
STOP_REQUESTED
state. If the job completes before it can be stopped, it is put into the
COMPLETED
state; otherwise the job is stopped and put into the STOPPED
state.
If the job is in the COMPLETED
or FAILED
state when you call the
StopDominantLanguageDetectionJob
operation, the operation returns a 400 Internal Request Exception.
When a job is stopped, any documents already processed are written to the output location.
stopEntitiesDetectionJob
in interface AmazonComprehend
public StopEventsDetectionJobResult stopEventsDetectionJob(StopEventsDetectionJobRequest request)
AmazonComprehend
Stops an events detection job in progress.
stopEventsDetectionJob
in interface AmazonComprehend
public StopKeyPhrasesDetectionJobResult stopKeyPhrasesDetectionJob(StopKeyPhrasesDetectionJobRequest request)
AmazonComprehend
Stops a key phrases detection job in progress.
If the job state is IN_PROGRESS
the job is marked for termination and put into the
STOP_REQUESTED
state. If the job completes before it can be stopped, it is put into the
COMPLETED
state; otherwise the job is stopped and put into the STOPPED
state.
If the job is in the COMPLETED
or FAILED
state when you call the
StopDominantLanguageDetectionJob
operation, the operation returns a 400 Internal Request Exception.
When a job is stopped, any documents already processed are written to the output location.
stopKeyPhrasesDetectionJob
in interface AmazonComprehend
public StopPiiEntitiesDetectionJobResult stopPiiEntitiesDetectionJob(StopPiiEntitiesDetectionJobRequest request)
AmazonComprehend
Stops a PII entities detection job in progress.
stopPiiEntitiesDetectionJob
in interface AmazonComprehend
public StopSentimentDetectionJobResult stopSentimentDetectionJob(StopSentimentDetectionJobRequest request)
AmazonComprehend
Stops a sentiment detection job in progress.
If the job state is IN_PROGRESS
, the job is marked for termination and put into the
STOP_REQUESTED
state. If the job completes before it can be stopped, it is put into the
COMPLETED
state; otherwise the job is be stopped and put into the STOPPED
state.
If the job is in the COMPLETED
or FAILED
state when you call the
StopDominantLanguageDetectionJob
operation, the operation returns a 400 Internal Request Exception.
When a job is stopped, any documents already processed are written to the output location.
stopSentimentDetectionJob
in interface AmazonComprehend
public StopTargetedSentimentDetectionJobResult stopTargetedSentimentDetectionJob(StopTargetedSentimentDetectionJobRequest request)
AmazonComprehend
Stops a targeted sentiment detection job in progress.
If the job state is IN_PROGRESS
, the job is marked for termination and put into the
STOP_REQUESTED
state. If the job completes before it can be stopped, it is put into the
COMPLETED
state; otherwise the job is be stopped and put into the STOPPED
state.
If the job is in the COMPLETED
or FAILED
state when you call the
StopDominantLanguageDetectionJob
operation, the operation returns a 400 Internal Request Exception.
When a job is stopped, any documents already processed are written to the output location.
stopTargetedSentimentDetectionJob
in interface AmazonComprehend
public StopTrainingDocumentClassifierResult stopTrainingDocumentClassifier(StopTrainingDocumentClassifierRequest request)
AmazonComprehend
Stops a document classifier training job while in progress.
If the training job state is TRAINING
, the job is marked for termination and put into the
STOP_REQUESTED
state. If the training job completes before it can be stopped, it is put into the
TRAINED
; otherwise the training job is stopped and put into the STOPPED
state and the
service sends back an HTTP 200 response with an empty HTTP body.
stopTrainingDocumentClassifier
in interface AmazonComprehend
public StopTrainingEntityRecognizerResult stopTrainingEntityRecognizer(StopTrainingEntityRecognizerRequest request)
AmazonComprehend
Stops an entity recognizer training job while in progress.
If the training job state is TRAINING
, the job is marked for termination and put into the
STOP_REQUESTED
state. If the training job completes before it can be stopped, it is put into the
TRAINED
; otherwise the training job is stopped and putted into the STOPPED
state and
the service sends back an HTTP 200 response with an empty HTTP body.
stopTrainingEntityRecognizer
in interface AmazonComprehend
public TagResourceResult tagResource(TagResourceRequest request)
AmazonComprehend
Associates a specific tag with an Amazon Comprehend resource. A tag is a key-value pair that adds as a metadata to a resource used by Amazon Comprehend. For example, a tag with "Sales" as the key might be added to a resource to indicate its use by the sales department.
tagResource
in interface AmazonComprehend
public UntagResourceResult untagResource(UntagResourceRequest request)
AmazonComprehend
Removes a specific tag associated with an Amazon Comprehend resource.
untagResource
in interface AmazonComprehend
public UpdateEndpointResult updateEndpoint(UpdateEndpointRequest request)
AmazonComprehend
Updates information about the specified endpoint. For information about endpoints, see Managing endpoints.
updateEndpoint
in interface AmazonComprehend
public UpdateFlywheelResult updateFlywheel(UpdateFlywheelRequest request)
AmazonComprehend
Update the configuration information for an existing flywheel.
updateFlywheel
in interface AmazonComprehend
public void shutdown()
AmazonComprehend
shutdown
in interface AmazonComprehend
public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
AmazonComprehend
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.
getCachedResponseMetadata
in interface AmazonComprehend
request
- The originally executed request.