Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Mengkonfigurasi flywheel menggunakan API
<a name="flywheels-config-api"></a>

Anda dapat menggunakan Amazon Comprehend API untuk membuat, memperbarui, dan menghapus flywheels. 

Saat Anda membuat flywheel, Amazon Comprehend membuat data lake untuk menyimpan semua data yang dibutuhkan flywheel, seperti data pelatihan dan data pengujian untuk setiap versi model.

Saat Anda menghapus flywheel, Amazon Comprehend tidak menghapus data lake atau model yang terkait dengan flywheel. 

Operasi penghapusan flywheel gagal jika flywheel menjalankan iterasi atau membuat dataset.

Tinjau informasi di bagian [Pembuatan roda gila](flywheels-about.md#flywheels-about-create) sebelum Anda membuat flywheel baru.

## Buat flywheel untuk model yang ada
<a name="flywheels-config-api-create-existing"></a>

Gunakan [CreateFlywheel](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_CreateFlywheel.html)operasi untuk membuat flywheel untuk model yang ada. 

**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}}"   \
```
Jika operasi berhasil, responsnya termasuk ARN flywheel.  

```
{
  "FlywheelArn": "arn:aws::comprehend:{{aws-region}}:{{111122223333}}:flywheel/name",
  "ActiveModelArn": "modelArn"
}
```

## Buat flywheel untuk model baru
<a name="flywheels-config-api-create-new"></a>

Gunakan [CreateFlywheel](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_CreateFlywheel.html)operasi untuk membuat flywheel untuk model klasifikasi kustom baru. 

**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
```
Config.json File tugas berisi konten berikut.  

```
{
    "LanguageCode": "en",
    "DocumentClassificationConfig": {
        "Mode": "MULTI_LABEL",
        "Labels": ["optimism", "anger"]
    } 
}
```
Badan respons API menyertakan konten berikut.  

```
{
  "FlywheelArn": "arn:aws::comprehend:{{aws-region}}:{{111122223333}}:flywheel/name",
  "ActiveModelArn": "modelArn"
}
```

## Jelaskan flywheel
<a name="flywheels-config-api-desc"></a>

Gunakan operasi [DescribeFlywheel](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeFlywheel.html)Amazon Comprehend untuk mengambil informasi yang dikonfigurasi tentang flywheel. 

```
aws comprehend describe-flywheel \
    --flywheel-arn  "flywheelArn"
```

Badan respons API menyertakan konten berikut.

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

## Perbarui flywheel
<a name="flywheels-config-api-update"></a>

Gunakan [UpdateFlywheel](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_UpdateFlywheel.html)operasi untuk memperbarui nilai konfigurasi flywheel yang dapat dimodifikasi. 

Beberapa bidang konfigurasi adalah struktur JSON dengan subbidang. Untuk memperbarui satu atau beberapa subbidang, berikan nilai untuk semua subbidang (Amazon Comprehend menyetel nilai ke null untuk setiap subbidang yang hilang dalam permintaan). 

Jika Anda menghilangkan parameter tingkat atas dalam `UpdateFlywheel` permintaan, Amazon Comprehend tidak mengubah nilai parameter atau subbidangnya di flywheel.

Untuk menambah atau menghapus tag pada flywheel, gunakan [TagResource](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_TagResource.html)dan [UntagResource](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_UntagResource.html)operasi.

Anda dapat mempromosikan versi model dengan mengatur `ActiveModelArn` parameter, seperti yang ditunjukkan pada contoh berikut. 

```
aws comprehend update-flywheel \
    --region {{aws-region}} \
    --flywheel-arn  "flywheelArn" \
    --active-model-arn  "modelArn" \
```

Badan respons API menyertakan konten berikut.

```
{
  "FlywheelArn": "arn:aws::comprehend:{{aws-region}}:{{111122223333}}:flywheel/name",
  "ActiveModelArn": "modelArn"
}
```

## Hapus flywheel
<a name="flywheels-config-api-delete"></a>

Gunakan operasi [DeleteFlywheel](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DeleteFlywheel.html)Amazon Comprehend untuk menghapus flywheels. 

```
aws comprehend delete-flywheel \
    --flywheel-arn  "flywheelArn"
```

Respons API yang berhasil berisi badan pesan respons kosong

## Daftar flywheels
<a name="flywheels-config-api-list"></a>

Gunakan operasi [ListFlywheels](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_ListFlywheels.html)Amazon Comprehend untuk mengambil daftar flywheel di wilayah saat ini. 

```
aws comprehend list-flywheel \
    --region {{aws-region}} \
    --endpoint-url  "uri"
```

Badan respons API menyertakan konten berikut.

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