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.
# Configuración de volantes de inercia a través de la API
También puede usar la API de Amazon Comprehend para crear, actualizar y eliminar volantes de inercia.
Al crear un volante de inercia, Amazon Comprehend crea un lago de datos para almacenar todos los datos que el volante necesita, como los datos de entrenamiento y los datos de prueba para cada versión del modelo.
Al eliminar un volante de inercia, Amazon Comprehend no eliminará el lago de datos ni el modelo asociado a ese volante.
La operación de eliminación del volante falla si dicho volante está ejecutando una iteración o creando un conjunto de datos.
Revise la información de la sección [Creación del volante de inercia](flywheels-about.md#flywheels-about-create) antes de crear un nuevo volante de inercia.
## Creación de un volante de inercia para un modelo existente
Utilice la [CreateFlywheel](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_CreateFlywheel.html)operación para crear un volante para un modelo existente.
**Example**
```
aws comprehend create-flywheel \
--flywheel-name "myFlywheel2" \
--active-model-arn "modelArn" \
--data-access-role-arn arn:aws::iam::111122223333:role/testFlywheelDataAccess \
--data-lake-s3-uri": "https://{{s3-bucket-endpoint}}" \
```
Si la operación se realiza correctamente, la respuesta incluirá el ARN del volante de inercia.
```
{
"FlywheelArn": "arn:aws::comprehend:{{aws-region}}:{{111122223333}}:flywheel/name",
"ActiveModelArn": "modelArn"
}
```
## Creación de un volante de inercia para un modelo nuevo
Utilice la [CreateFlywheel](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_CreateFlywheel.html)operación para crear un volante para un nuevo modelo de clasificación personalizado.
**Example**
```
aws comprehend create-flywheel \
--flywheel-name "myFlywheel2" \
--data-access-role-arn arn:aws::iam::111122223333:role/testFlywheelDataAccess \
--model-type "DOCUMENT_CLASSIFIER" \
--data-lake-s3-uri "s3Uri" \
--task-config file://taskConfig.json
```
El Config.json archivo de tareas contiene el siguiente contenido.
```
{
"LanguageCode": "en",
"DocumentClassificationConfig": {
"Mode": "MULTI_LABEL",
"Labels": ["optimism", "anger"]
}
}
```
El cuerpo de la respuesta de la API incluye el siguiente contenido.
```
{
"FlywheelArn": "arn:aws::comprehend:{{aws-region}}:{{111122223333}}:flywheel/name",
"ActiveModelArn": "modelArn"
}
```
## Descripción de un volante de inercia
Utilice la [DescribeFlywheel](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeFlywheel.html)operación Amazon Comprehend para recuperar la información configurada sobre un volante.
```
aws comprehend describe-flywheel \
--flywheel-arn "flywheelArn"
```
El cuerpo de la respuesta de la API incluye el siguiente contenido.
```
{
"FlywheelProperties": {
"FlywheelArn": "arn:aws::comprehend:{{aws-region}}:111122223333:flywheel/myTestFlywheel",
"DataAccessRoleArn": "arn:aws::iam::111122223333:role/Admin",
"TaskConfig": {
"LanguageCode": "en",
"DocumentClassificationConfig": {
"Mode": "MULTI_LABEL"
}
},
"DataLakeS3Uri": "s3://my-test-datalake/flywheelbasictest/myTestFlywheel/schemaVersion=1/20220801T014326Z",
"Status": "ACTIVE",
"ModelType": "DOCUMENT_CLASSIFIER",
"CreationTime": 1659318206.102,
"LastModifiedTime": 1659318249.05
}
}
```
## Actualización de un volante de inercia
Utilice la [UpdateFlywheel](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_UpdateFlywheel.html)operación para actualizar los valores de configuración modificables del volante.
Algunos campos de configuración son estructuras JSON con subcampos. Para actualizar uno o más subcampos, proporcione los valores para todos los subcampos (Amazon Comprehend establece el valor en nulo para cualquier subcampo que falte en la solicitud).
Si omite un parámetro de nivel superior en la solicitud `UpdateFlywheel`, Amazon Comprehend no cambiará los valores del parámetro ni ninguno de sus subcampos en el volante de inercia.
Para añadir o eliminar etiquetas en el volante, utilice las [TagResource](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_TagResource.html)operaciones y. [UntagResource](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_UntagResource.html)
También puede promover una versión del modelo a través de la configuración del parámetro `ActiveModelArn`, tal como se muestra en el siguiente ejemplo.
```
aws comprehend update-flywheel \
--region {{aws-region}} \
--flywheel-arn "flywheelArn" \
--active-model-arn "modelArn" \
```
El cuerpo de la respuesta de la API incluye el siguiente contenido.
```
{
"FlywheelArn": "arn:aws::comprehend:{{aws-region}}:{{111122223333}}:flywheel/name",
"ActiveModelArn": "modelArn"
}
```
## Eliminación de un volante de inercia
Usa la [DeleteFlywheel](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DeleteFlywheel.html)operación Amazon Comprehend para eliminar los volantes.
```
aws comprehend delete-flywheel \
--flywheel-arn "flywheelArn"
```
En una respuesta satisfactoria de la API se incluye un cuerpo de mensaje vacío
## Enumeración de los volantes de inercia
Utilice la [ListFlywheels](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_ListFlywheels.html)operación Amazon Comprehend para recuperar una lista de los volantes de inercia de la región actual.
```
aws comprehend list-flywheel \
--region {{aws-region}} \
--endpoint-url "uri"
```
El cuerpo de la respuesta de la API incluye el siguiente contenido.
```
{
"FlywheelSummaryList": [
{
"FlywheelArn": "arn:aws::comprehend:{{aws-region}}:111122223333:flywheel/myTestFlywheel",
"DataLakeS3Uri": "s3://my-test-datalake/flywheelbasictest/myTestFlywheel/schemaVersion=1/20220801T014326Z",
"Status": "ACTIVE",
""ModelType": "DOCUMENT_CLASSIFIER",
"CreationTime": 1659318206.102,
"LastModifiedTime": 1659318249.05
}
]
}
```