As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Análise assíncrona para sentimento direcionado
<a name="using-api-targeted-sentiment"></a>

Para obter informações sobre a análise de sentimento direcionado em tempo real, consulte [Análise em tempo real de um sentimento direcionado](using-api-sync.md#get-started-api-targeted-sentiment).

O Amazon Comprehend fornece as seguintes operações de API para iniciar e gerenciar a análise assíncrona de sentimentos direcionados:
+  [StartTargetedSentimentDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartTargetedSentimentDetectionJob.html)— inicia um trabalho assíncrono de detecção de sentimentos direcionados para uma coleção de documentos.
+  [ListTargetedSentimentDetectionJobs](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_ListTargetedSentimentDetectionJobs.html)— Retorna a lista de trabalhos direcionados de detecção de sentimentos que você enviou.
+  [DescribeTargetedSentimentDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeTargetedSentimentDetectionJob.html)— Obtém as propriedades (incluindo status) associadas ao trabalho de detecção de sentimentos direcionado especificado.
+  [StopTargetedSentimentDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StopTargetedSentimentDetectionJob.html)— Interrompe o trabalho de sentimento direcionado especificado em andamento.

**Topics**
+ [Antes de começar](#api-targeted-sentiment-before)
+ [Analisando o sentimento direcionado usando o AWS CLI](#api-targeted-sentiment-cli)

## Antes de começar
<a name="api-targeted-sentiment-before"></a>

Antes de começar, garanta que você tenha:
+ **Buckets de entrada e saída**: identifique os buckets do Amazon S3 que você deseja usar para entrada e saída. O buckets devem estar na mesma região que o API que você está chamando.
+ **Perfil de serviço do IAM**: você deve ter um perfil de serviço do IAM com permissão para acessar seus buckets de entrada e saída. Para obter mais informações, consulte [Permissões baseadas em perfis necessárias para operações assíncronas](security_iam_id-based-policy-examples.md#auth-role-permissions).

## Analisando o sentimento direcionado usando o AWS CLI
<a name="api-targeted-sentiment-cli"></a>

O exemplo a seguir demonstra como usar a operação `StartTargetedSentimentDetectionJob` com o AWS CLI. Este exemplo especifica o idioma do texto de entrada.

O exemplo é formatado para Unix, Linux e macOS. Para Windows, substitua o caractere de continuação Unix de barra invertida (\$1) no final de cada linha por um circunflexo (^).

```
aws comprehend start-targeted-sentiment-detection-job \
       --job-name "job name" \
       --language-code "en" \
       --cli-input-json file://path to JSON input file
```

Para o parâmetro `cli-input-json`, você fornece um caminho para um arquivo JSON que contém os dados da solicitação, conforme exibido no exemplo a seguir.

```
{
    "InputDataConfig": {
        "S3Uri": "s3://input bucket/input path",
        "InputFormat": "ONE_DOC_PER_FILE"
    },
    "OutputDataConfig": {
        "S3Uri": "s3://output bucket/output path"
    },
    "DataAccessRoleArn": "arn:aws:iam::account ID:role/data access role"
}
```

Se a solicitação para iniciar o trabalho for bem-sucedida, você receberá a seguinte resposta:

```
{
    "JobStatus": "SUBMITTED",
    "JobArn": "job ARN"
    "JobId": "job ID"
}
```