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 el modelado de temas
<a name="get-started-topics"></a>

 Para determinar los temas de un conjunto de documentos, utilice el [StartTopicsDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartTopicsDetectionJob.html)para iniciar un trabajo asíncrono. Puede supervisar los temas de los documentos escritos en inglés o español.

**Topics**
+ [Antes de comenzar](#topics-before)
+ [Usando el AWS Command Line Interface](#topics-cli)
+ [Uso del SDK para Python o SDK para .NET](#topic-java)

## Antes de comenzar
<a name="topics-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 [Role-based permisos necesarios para las operaciones asíncronas](security_iam_id-based-policy-examples.md#auth-role-permissions).

## Usando el AWS Command Line Interface
<a name="topics-cli"></a>

En el siguiente ejemplo se muestra el uso de la `StartTopicsDetectionJob` operación con el AWS CLI

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

```
aws comprehend start-topics-detection-job \
                --number-of-topics {{topics to return}} \
                --job-name "{{job name}}" \
                --region {{region}} \
                --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 de detección de eventos se ha realizado correctamente, recibirá la siguiente respuesta:

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

Utilice la [ListTopicsDetectionJobs](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_ListTopicsDetectionJobs.html)operación para ver una lista de los trabajos de detección de temas que ha enviado. La lista incluye información sobre las ubicaciones de entrada y salida que utilizó y el estado de cada uno de los trabajos de detección. El ejemplo está formateado para Unix, Linux y macOS. Para Windows, sustituya la barra diagonal invertida (\\) utilizada como carácter de continuación de Unix al final de cada línea por el signo de intercalación (^).

```
aws comprehend list-topics-detection-jobs \-- {{region}}
```

Obtendrá una respuesta JSON similar a la siguiente en respuesta a:

```
{
    "TopicsDetectionJobPropertiesList": [
        {
            "InputDataConfig": {
                "S3Uri": "s3://{{input bucket}}/{{input path}}",
                "InputFormat": "ONE_DOC_PER_LINE"
            },
            "NumberOfTopics": {{topics to return}},
            "JobId": "{{job ID}}",
            "JobStatus": "COMPLETED",
            "JobName": "{{job name}}",
            "SubmitTime": {{timestamp}},
            "OutputDataConfig": {
                "S3Uri": "s3://{{output bucket}}/{{output path}}"
            },
            "EndTime": {{timestamp}}
        },
        {
            "InputDataConfig": {
                "S3Uri": "s3://{{input bucket}}/{{input path}}",
                "InputFormat": "ONE_DOC_PER_LINE"
            },
            "NumberOfTopics": {{topics to return}},
            "JobId": "{{job ID}}",
            "JobStatus": "RUNNING",
            "JobName": "{{job name}}",
            "SubmitTime": {{timestamp}},
            "OutputDataConfig": {
                "S3Uri": "s3://{{output bucket}}/{{output path}}"
            }
        }
    ]
}
```

Puede utilizar la [DescribeTopicsDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeTopicsDetectionJob.html)operación para obtener el estado de un trabajo existente. El ejemplo está formateado para Unix, Linux y macOS. Para Windows, sustituya la barra diagonal invertida (\\) utilizada como carácter de continuación de Unix al final de cada línea por el signo de intercalación (^).

```
aws comprehend describe-topics-detection-job --job-id {{job ID}} 
```

Obtendrá el siguiente JSON similar en respuesta a:

```
{
    "TopicsDetectionJobProperties": {
        "InputDataConfig": {
            "S3Uri": "s3://{{input bucket}}/{{input path}}",
            "InputFormat": "ONE_DOC_PER_LINE"
        },
        "NumberOfTopics": {{topics to return}},
        "JobId": "{{job ID}}",
        "JobStatus": "COMPLETED",
        "JobName": "{{job name}}",
        "SubmitTime": {{timestamp}},
        "OutputDataConfig": {
            "S3Uri": "s3://{{output bucket}}/{{ouput path}}"
        },
        "EndTime": {{timestamp}}
    }
}
```

## Uso del SDK para Python o SDK para .NET
<a name="topic-java"></a>

Para ver ejemplos del SDK sobre cómo iniciar un trabajo de modelado de temas, consulte [Úselo `StartTopicsDetectionJob` con un AWS SDK o CLI](example_comprehend_StartTopicsDetectionJob_section.md).