Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Analisi asincrona per un sentiment mirato
<a name="using-api-targeted-sentiment"></a>

Per informazioni sull'analisi in tempo reale di Targeted Sentiment, consulta. [Analisi in tempo reale per un sentiment mirato](using-api-sync.md#get-started-api-targeted-sentiment)

Amazon Comprehend fornisce le seguenti operazioni API per avviare e gestire un'analisi asincrona mirata del sentiment:
+  [StartTargetedSentimentDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartTargetedSentimentDetectionJob.html)— Avvia un processo asincrono mirato di rilevamento del sentiment per una raccolta di documenti.
+  [ListTargetedSentimentDetectionJobs](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_ListTargetedSentimentDetectionJobs.html)— Restituisce l'elenco dei lavori mirati di rilevamento dei sentimenti che hai inviato.
+  [DescribeTargetedSentimentDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeTargetedSentimentDetectionJob.html)— Ottiene le proprietà (incluso lo stato) associate al lavoro di rilevamento del sentiment mirato specificato.
+  [StopTargetedSentimentDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StopTargetedSentimentDetectionJob.html)— Interrompe il lavoro mirato sul sentiment specifico in corso.

**Topics**
+ [Prima di iniziare](#api-targeted-sentiment-before)
+ [Analisi del sentiment mirato utilizzando AWS CLI](#api-targeted-sentiment-cli)

## Prima di iniziare
<a name="api-targeted-sentiment-before"></a>

Prima di iniziare, assicurati di avere:
+ **Bucket di input e output**: identifica i bucket Amazon S3 che desideri utilizzare per input e output. I bucket devono trovarsi nella stessa regione dell'API che stai chiamando.
+ **Ruolo di servizio IAM**: è necessario disporre di un ruolo di servizio IAM con l'autorizzazione ad accedere ai bucket di input e output. Per ulteriori informazioni, consulta [Autorizzazioni basate sui ruoli necessarie per le operazioni asincrone](security_iam_id-based-policy-examples.md#auth-role-permissions).

## Analisi del sentiment mirato utilizzando AWS CLI
<a name="api-targeted-sentiment-cli"></a>

L'esempio seguente dimostra l'utilizzo dell'`StartTargetedSentimentDetectionJob`operazione con. AWS CLI Questo esempio specifica la lingua del testo di input.

L'esempio è formattato per Unix, Linux e macOS. Per Windows, sostituisci il carattere di continuazione UNIX barra rovesciata (\$1) al termine di ogni riga con un accento circonflesso (^).

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

Per il `cli-input-json` parametro fornite il percorso di un file JSON che contiene i dati della richiesta, come illustrato nell'esempio seguente.

```
{
    "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 la richiesta di avvio del processo ha avuto esito positivo, riceverai la seguente risposta:

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