Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Análisis asíncrono para opiniones dirigidas
<a name="using-api-targeted-sentiment"></a>

Para obtener información sobre el análisis en tiempo real de la opinión dirigida, consulte [Análisis en tiempo real de la opinión específica](using-api-sync.md#get-started-api-targeted-sentiment).

Amazon Comprehend proporciona las siguientes operaciones de API para iniciar y gestionar el análisis asíncrono de opiniones dirigidas:
+  [StartTargetedSentimentDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartTargetedSentimentDetectionJob.html)— Inicia un trabajo asíncrono de detección de opiniones específicas para una colección de documentos.
+  [ListTargetedSentimentDetectionJobs](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_ListTargetedSentimentDetectionJobs.html)— Devuelve la lista de trabajos de detección de opiniones segmentados que ha enviado.
+  [DescribeTargetedSentimentDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeTargetedSentimentDetectionJob.html)— Obtiene las propiedades (incluido el estado) asociadas al trabajo de detección de opiniones objetivo especificado.
+  [StopTargetedSentimentDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StopTargetedSentimentDetectionJob.html)— Detiene el trabajo de opinión objetivo especificado en curso.

**Topics**
+ [Antes de comenzar](#api-targeted-sentiment-before)
+ [Analiza el sentimiento objetivo mediante el AWS CLI](#api-targeted-sentiment-cli)

## Antes de comenzar
<a name="api-targeted-sentiment-before"></a>

Antes de comenzar, asegúrese de que dispone de:
+ **Buckets de entrada y de salida**: identifique los buckets de Amazon S3 que quiere usar para la entrada y la salida. Los buckets deben estar situados en la misma región que la API a la cual está llamando.
+ **Rol de servicio de IAM**: debe tener un rol de servicio de IAM con permiso para acceder a sus buckets de entrada y salida. Para obtener más información, consulte [Se requieren permisos basados en roles para las operaciones asíncronas](security_iam_id-based-policy-examples.md#auth-role-permissions).

## Analiza el sentimiento objetivo mediante el AWS CLI
<a name="api-targeted-sentiment-cli"></a>

El siguiente ejemplo muestra el uso de la operación `StartTargetedSentimentDetectionJob` en la AWS CLI. En este ejemplo se especifica el idioma del texto de entrada.

El ejemplo está formateado para Unix, Linux y macOS. Para Windows, sustituya la barra diagonal invertida (\$1) utilizada como carácter de continuación de Unix al final de cada línea por el signo de intercalación (^).

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

Para el parámetro de `cli-input-json`, debe proporcionar la ruta de un archivo JSON que contiene los datos de solicitud, como se muestra en el siguiente ejemplo.

```
{
    "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"
}
```

Si la solicitud para iniciar el trabajo se ha realizado correctamente, recibirá la siguiente respuesta:

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