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à.
# Configurazione dei volani tramite l'API
Puoi utilizzare l'API Amazon Comprehend per creare, aggiornare ed eliminare i volani.
Quando crei un volano, Amazon Comprehend crea un data lake per contenere tutti i dati necessari al volano, come i dati di addestramento e i dati di test per ogni versione del modello.
Quando elimini un volano, Amazon Comprehend non elimina il data lake o il modello associato al volano.
L'operazione di eliminazione del flywheel ha esito negativo se il flywheel sta eseguendo un'iterazione o sta creando un set di dati.
Esamina le informazioni nella sezione [Creazione del volano](flywheels-about.md#flywheels-about-create) prima di creare un nuovo volano.
## Create un volano per un modello esistente
Utilizzate l'[CreateFlywheel](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_CreateFlywheel.html)operazione per creare un volano per un modello esistente.
**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" \
```
Se l'operazione ha esito positivo, la risposta include l'ARN del volano.
```
{
"FlywheelArn": "arn:aws::comprehend:aws-region:111122223333:flywheel/name",
"ActiveModelArn": "modelArn"
}
```
## Crea un volano per un nuovo modello
Utilizzate l'[CreateFlywheel](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_CreateFlywheel.html)operazione per creare un volano per un nuovo modello di classificazione personalizzato.
**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
```
Il file TaskConfig.json contiene il seguente contenuto.
```
{
"LanguageCode": "en",
"DocumentClassificationConfig": {
"Mode": "MULTI_LABEL",
"Labels": ["optimism", "anger"]
}
}
```
Il corpo della risposta dell'API include il seguente contenuto.
```
{
"FlywheelArn": "arn:aws::comprehend:aws-region:111122223333:flywheel/name",
"ActiveModelArn": "modelArn"
}
```
## Descrivi un volano
Usa l'[DescribeFlywheel](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeFlywheel.html)operazione Amazon Comprehend per recuperare informazioni configurate su un volano.
```
aws comprehend describe-flywheel \
--flywheel-arn "flywheelArn"
```
Il corpo della risposta dell'API include il seguente contenuto.
```
{
"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
}
}
```
## Aggiorna un volano
Utilizzate l'[UpdateFlywheel](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_UpdateFlywheel.html)operazione per aggiornare i valori di configurazione modificabili del volano.
Alcuni campi di configurazione sono strutture JSON con sottocampi. Per aggiornare uno o più sottocampi, fornisci i valori per tutti i sottocampi (Amazon Comprehend imposta il valore su null per ogni sottocampo mancante nella richiesta).
Se ometti un parametro di primo livello nella `UpdateFlywheel` richiesta, Amazon Comprehend non modifica i valori del parametro o dei relativi sottocampi nel volano.
Per aggiungere o rimuovere tag sul volano, usa le operazioni and. [TagResource[UntagResource](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_UntagResource.html)](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_TagResource.html)
È possibile promuovere una versione del modello impostando il `ActiveModelArn` parametro, come illustrato nell'esempio seguente.
```
aws comprehend update-flywheel \
--region aws-region \
--flywheel-arn "flywheelArn" \
--active-model-arn "modelArn" \
```
Il corpo della risposta dell'API include il seguente contenuto.
```
{
"FlywheelArn": "arn:aws::comprehend:aws-region:111122223333:flywheel/name",
"ActiveModelArn": "modelArn"
}
```
## Eliminare un volano
Usa l'[DeleteFlywheel](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DeleteFlywheel.html)operazione Amazon Comprehend per eliminare i volani.
```
aws comprehend delete-flywheel \
--flywheel-arn "flywheelArn"
```
Una risposta API riuscita contiene un corpo del messaggio di risposta vuoto
## Elenca i volani
Usa l'[ListFlywheels](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_ListFlywheels.html)operazione Amazon Comprehend per recuperare un elenco di volani nella regione corrente.
```
aws comprehend list-flywheel \
--region aws-region \
--endpoint-url "uri"
```
Il corpo della risposta dell'API include il seguente contenuto.
```
{
"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
}
]
}
```