

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

# API pembelajaran mesin
<a name="aws-glue-api-machine-learning-api"></a>

Machine learning API menjelaskan tipe data machine learning, dan menyertakan API untuk membuat, menghapus, atau memperbarui transformasi, atau memulai tugas pembelajaran mesin.

## Jenis Data
<a name="aws-glue-api-machine-learning-api-objects"></a>
+ [TransformParameters struktur](#aws-glue-api-machine-learning-api-TransformParameters)
+ [EvaluationMetrics struktur](#aws-glue-api-machine-learning-api-EvaluationMetrics)
+ [MLTransform struktur](#aws-glue-api-machine-learning-api-MLTransform)
+ [FindMatchesParameters struktur](#aws-glue-api-machine-learning-api-FindMatchesParameters)
+ [FindMatchesMetrics struktur](#aws-glue-api-machine-learning-api-FindMatchesMetrics)
+ [ConfusionMatrix struktur](#aws-glue-api-machine-learning-api-ConfusionMatrix)
+ [GlueTable struktur](#aws-glue-api-machine-learning-api-GlueTable)
+ [TaskRun struktur](#aws-glue-api-machine-learning-api-TaskRun)
+ [TransformFilterCriteria struktur](#aws-glue-api-machine-learning-api-TransformFilterCriteria)
+ [TransformSortCriteria struktur](#aws-glue-api-machine-learning-api-TransformSortCriteria)
+ [TaskRunFilterCriteria struktur](#aws-glue-api-machine-learning-api-TaskRunFilterCriteria)
+ [TaskRunSortCriteria struktur](#aws-glue-api-machine-learning-api-TaskRunSortCriteria)
+ [TaskRunProperties struktur](#aws-glue-api-machine-learning-api-TaskRunProperties)
+ [FindMatchesTaskRunProperties struktur](#aws-glue-api-machine-learning-api-FindMatchesTaskRunProperties)
+ [ImportLabelsTaskRunProperties struktur](#aws-glue-api-machine-learning-api-ImportLabelsTaskRunProperties)
+ [ExportLabelsTaskRunProperties struktur](#aws-glue-api-machine-learning-api-ExportLabelsTaskRunProperties)
+ [LabelingSetGenerationTaskRunProperties struktur](#aws-glue-api-machine-learning-api-LabelingSetGenerationTaskRunProperties)
+ [SchemaColumn struktur](#aws-glue-api-machine-learning-api-SchemaColumn)
+ [TransformEncryption struktur](#aws-glue-api-machine-learning-api-TransformEncryption)
+ [MLUserDataEncryption struktur](#aws-glue-api-machine-learning-api-MLUserDataEncryption)
+ [ColumnImportance struktur](#aws-glue-api-machine-learning-api-ColumnImportance)

## TransformParameters struktur
<a name="aws-glue-api-machine-learning-api-TransformParameters"></a>

Parameter spesifik algoritme yang dikaitkan dengan transformasi machine learning.

**Bidang**
+ `TransformType` – *Wajib:* String UTF-8 (nilai yang valid: `FIND_MATCHES`).

  Jenis transformasi machine learning.

  Untuk informasi tentang jenis transformasi machine learning, lihat [Membuat Machine Learning](https://docs.aws.amazon.com/glue/latest/dg/add-job-machine-learning-transform.html).
+ `FindMatchesParameters` — Sebuah objek [FindMatchesParameters](#aws-glue-api-machine-learning-api-FindMatchesParameters).

  Parameter untuk menemukan kecocokan algoritme.

## EvaluationMetrics struktur
<a name="aws-glue-api-machine-learning-api-EvaluationMetrics"></a>

Metrik evaluasi memberikan perkiraan kualitas dari transformasi machine learning Anda.

**Bidang**
+ `TransformType` – *Wajib:* String UTF-8 (nilai yang valid: `FIND_MATCHES`).

  Jenis transformasi machine learning.
+ `FindMatchesMetrics` — Sebuah objek [FindMatchesMetrics](#aws-glue-api-machine-learning-api-FindMatchesMetrics).

  Metrik evaluasi untuk algoritme temukan kecocokan.

## MLTransform struktur
<a name="aws-glue-api-machine-learning-api-MLTransform"></a>

Struktur untuk sebuah transformasi machine learning.

**Bidang**
+ `TransformId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID transformasi unik yang dihasilkan untuk transformasi machine learning. ID tersebut dijamin unik dan tidak berubah.
+ `Name` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama yang ditetapkan pengguna untuk transformasi machine learning. Nama tersebut tidak dijamin unik dan dapat diubah setiap saat.
+ `Description` — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Sebuah teks deskripsi dalam bentuk panjang yang ditetapkan pengguna untuk transformasi machine learning. Deskripsi tersebut tidak dijamin unik dan dapat diubah kapan saja.
+ `Status` – String UTF-8 (nilai yang valid: `NOT_READY` \| `READY` \| `DELETING`).

  Status transformasi machine learning saat ini.
+ `CreatedOn` — Stempel waktu.

  Sebuah stempel waktu. Waktu dan tanggal saat transformasi machine learning ini diciptakan.
+ `LastModifiedOn` — Stempel waktu.

  Sebuah stempel waktu. Titik dalam waktu terakhir ketika transformasi machine learning ini dimodifikasi.
+ `InputRecordTables` — Susunan objek [GlueTable](#aws-glue-api-machine-learning-api-GlueTable), tidak lebih dari 10 struktur.

  Daftar definisi AWS Glue tabel yang digunakan oleh transformasi.
+ `Parameters` — Sebuah objek [TransformParameters](#aws-glue-api-machine-learning-api-TransformParameters).

  Sebuah objek `TransformParameters`. Anda dapat menggunakan parameter untuk menyetel (menyesuaikan) perilaku transformasi machine learning dengan menentukan data apa yang dipelajari dan preferensi Anda pada berbagai tradeoff (seperti precious vs recall, atau akurasi vs biaya).
+ `EvaluationMetrics` — Sebuah objek [EvaluationMetrics](#aws-glue-api-machine-learning-api-EvaluationMetrics).

  Sebuah objek `EvaluationMetrics`. Metrik evaluasi memberikan perkiraan kualitas dari transformasi machine learning Anda.
+ `LabelCount` — Nomor (bilangan bulat).

  Pengidentifikasi hitungan untuk file pelabelan yang dihasilkan oleh AWS Glue untuk transformasi ini. Karena Anda membuat transformasi yang lebih baik, maka Anda dapat secara berulang mengunduh, label, dan mengunggah file pelabelan.
+ `Schema` — Susunan objek [SchemaColumn](#aws-glue-api-machine-learning-api-SchemaColumn), tidak lebih dari 100 struktur.

  Sebuah peta pasangan nilai-kunci yang mewakili kolom dan tipe data yang dapat dijalankan oleh transformasi ini terhadapnya. Memiliki batas atas 100 kolom.
+ `Role` – String UTF-8.

  Nama atau Amazon Resource Name (ARN) dari IAM role dengan izin yang diperlukan. Izin yang diperlukan mencakup izin peran AWS Glue layanan ke AWS Glue sumber daya, dan izin Amazon S3 yang diperlukan oleh transformasi. 
  + Peran ini membutuhkan izin peran AWS Glue layanan untuk memungkinkan akses ke sumber daya. AWS Glue Lihat [Melampirkan Kebijakan untuk pengguna IAM yang Mengakses AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/attach-policy-iam-user.html).
  + Peran ini memerlukan izin ke sumber Amazon Simple Storage Service (Amazon S3), target, direktori sementara, skrip, dan perpustakaan yang digunakan oleh tugas yang dijalankan untuk transformasi ini.
+ `GlueVersion` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  Nilai ini menentukan versi transformasi pembelajaran mesin AWS Glue ini yang kompatibel. Glue 1.0 direkomendasikan untuk sebagian besar pelanggan. Jika nilai tidak diatur, maka kompatibilitas Glue secara default diatur ke Glue 0.9. Untuk informasi selengkapnya, lihat [Versi AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/release-notes.html#release-notes-versions) dalam panduan developer.
+ `MaxCapacity` — Nomor (ganda).

  Jumlah unit pemrosesan AWS Glue data (DPUs) yang dialokasikan ke tugas berjalan untuk transformasi ini. Anda dapat mengalokasikan dari 2 hingga 100 DPUs; defaultnya adalah 10. DPU adalah ukuran relatif daya pemrosesan yang terdiri dari 4 v CPUs kapasitas komputasi dan memori 16 GB. Untuk informasi lebih lanjut, lihat [halaman harga AWS Glue](https://aws.amazon.com/glue/pricing/). 

  `MaxCapacity` adalah pilihan yang eksklusif satu sama lain dengan `NumberOfWorkers` dan `WorkerType`.
  + Jika `NumberOfWorkers` atau `WorkerType` diatur, maka `MaxCapacity` tidak dapat diatur.
  + Jika `MaxCapacity` diatur, maka `NumberOfWorkers` atau `WorkerType` tidak dapat diatur.
  + Jika `WorkerType` diatur, maka `NumberOfWorkers` wajib (dan sebaliknya).
  + `MaxCapacity` dan `NumberOfWorkers`, keduanya minimal harus 1.

  Saat bidang `WorkerType` diatur ke nilai selain `Standard`, maka bidang `MaxCapacity` diatur secara otomatis dan menjadi baca-saja.
+ `WorkerType` – String UTF-8 (nilai yang valid: `Standard=""` \| `G.1X=""` \| `G.2X=""` \| `G.025X=""` \| `G.4X=""` \| `G.8X=""` \| `Z.2X=""`).

  Jenis pekerja yang telah ditetapkan sebelumnya yang dialokasikan ketika sebuah tugas dari transformasi ini dieksekusi. Menerima nilai Standard, G.1X, atau G.2X.
  + Untuk jenis pekerja `Standard`, setiap pekerja menyediakan 4 vCPU, memori 16 GB dan disk 50GB, dan 2 pelaksana per pekerja.
  + Untuk jenis pekerja `G.1X`, setiap pekerja menyediakan 4 vCPU, memori 16 GB dan disk 64GB, dan 1 pelaksana per pekerja.
  + Untuk jenis pekerja `G.2X`, setiap pekerja menyediakan 8 vCPU, memori 32 GB dan disk 128GB, dan 1 pelaksana per pekerja.

  `MaxCapacity` adalah pilihan yang eksklusif satu sama lain dengan `NumberOfWorkers` dan `WorkerType`.
  + Jika `NumberOfWorkers` atau `WorkerType` diatur, maka `MaxCapacity` tidak dapat diatur.
  + Jika `MaxCapacity` diatur, maka `NumberOfWorkers` atau `WorkerType` tidak dapat diatur.
  + Jika `WorkerType` diatur, maka `NumberOfWorkers` wajib (dan sebaliknya).
  + `MaxCapacity` dan `NumberOfWorkers`, keduanya minimal harus 1.
+ `NumberOfWorkers` — Nomor (bilangan bulat).

  Jumlah pekerja dari `workerType` yang ditentukan yang dialokasikan ketika sebuah tugas dari transformasi berjalan.

  Jika `WorkerType` diatur, maka `NumberOfWorkers` wajib (dan sebaliknya).
+ `Timeout` — Nomor (bilangan bulat), minimal 1.

  Waktu habis dalam hitungan menit dari transformasi machine learning.
+ `MaxRetries` — Nomor (bilangan bulat).

  Jumlah percobaan maksimum untuk mencoba kembali setelah sebuah `MLTaskRun` dari transformasi machine learning gagal.
+ `TransformEncryption` — Sebuah objek [TransformEncryption](#aws-glue-api-machine-learning-api-TransformEncryption).

   encryption-at-restPengaturan transformasi yang berlaku untuk mengakses data pengguna. Transformasi machine learning dapat mengakses data pengguna yang dienkripsi di Amazon S3 menggunakan KMS.

## FindMatchesParameters struktur
<a name="aws-glue-api-machine-learning-api-FindMatchesParameters"></a>

Parameter untuk mengonfigurasi perubahan kecocokan penemuan.

**Bidang**
+ `PrimaryKeyColumnName` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 1024 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama kolom yang secara unik mengidentifikasi baris di tabel sumber. Digunakan untuk membantu mengidentifikasi catatan yang cocok.
+ `PrecisionRecallTradeoff` — Nomor (ganda), tidak lebih dari 1.0.

  Nilai yang dipilih saat menyetel transformasi Anda untuk keseimbangan antara presisi dan pemanggilan ulang. Nilai 0,5 artinya tidak ada preferensi; nilai 1,0 artinya bias murni untuk presisi, dan nilai 0,0 artinya bias untuk pemanggilan ulang. Karena ini adalah tradeoff, pemilihan nilai yang mendekati 1,0 artinya pemanggilan ulang yang sangat rendah, dan pemilihan nilai yang mendekati 0,0 menghasilkan presisi yang sangat rendah.

  Metrik presisi menunjukkan seberapa sering model Anda benar saat memprediksi kecocokan. 

  Metrik pemanggilan ulang menunjukkan bahwa untuk kecocokan aktual, seberapa sering model Anda memprediksi kecocokan.
+ `AccuracyCostTradeoff` — Nomor (ganda), tidak lebih dari 1.0.

  Nilai yang dipilih saat menyetel perubahan Anda untuk keseimbangan antara akurasi dan biaya. Nilai 0,5 artinya sistem menyeimbangkan masalah akurasi dan biaya. Nilai 1,0 artinya bias murni untuk akurasi, yang biasanya menghasilkan biaya yang lebih tinggi, terkadang sangat tinggi. Nilai 0,0 berarti bias murni untuk biaya, yang menghasilkan perubahan `FindMatches` yang kurang akurat, terkadang dengan akurasi yang tidak dapat diterima.

  Akurasi mengukur seberapa baik perubahan menemukan positif sejati dan negatif sejati. Peningkatan akurasi memerlukan lebih banyak sumber daya dan biaya mesin. Tetapi, itu juga menghasilkan peningkatan pemanggilan ulang. 

  Biaya mengukur berapa banyak sumber daya komputasi, sehingga uang, dikonsumsi untuk menjalankan perubahan.
+ `EnforceProvidedLabels` – Boolean.

  Nilai yang diaktifkan atau dinonaktifkan untuk memaksa output agar cocok dengan label yang disediakan dari pengguna. Jika nilainya adalah `True`, perubahan `find matches` memaksa output agar cocok dengan label yang disediakan. Hasilnya menimpa hasil penggabungan normal. Jika nilainya adalah `False`, perubahan `find matches` tidak memastikan semua label yang disediakan diperhatikan, dan hasilnya bergantung pada model terlatih.

  Perhatikan bahwa pengaturan nilai ini ke betul dapat meningkatkan waktu eksekusi penggabungan.

## FindMatchesMetrics struktur
<a name="aws-glue-api-machine-learning-api-FindMatchesMetrics"></a>

Metrik evaluasi untuk algoritme temukan kecocokan. Kualitas transformasi machine learning Anda diukur dengan membuat transformasi Anda memprediksi beberapa kecocokan dan membandingkan hasilnya dengan kecocokan yang diketahui dari set data yang sama. Metrik kualitas didasarkan pada subset data Anda, sehingga mereka tidak tepat.

**Bidang**
+ `AreaUnderPRCurve` — Nomor (ganda), tidak lebih dari 1.0.

  Area di bawah precision/recall kurva (AUPRC) adalah angka tunggal yang mengukur kualitas keseluruhan transformasi, yang tidak tergantung pada pilihan yang dibuat untuk presisi vs. ingatan. Nilai yang lebih tinggi menunjukkan bahwa Anda memiliki precision vs. recall tradeoff yang lebih menarik.

  Untuk informasi selengkapnya, lihat [Precision dan recall](https://en.wikipedia.org/wiki/Precision_and_recall) di Wikipedia.
+ `Precision` — Nomor (ganda), tidak lebih dari 1.0.

  Metrik presisi menunjukkan seberapa sering transformasi Anda benar saat memprediksi kecocokan. Secara khusus, ia mengukur seberapa baik transformasi menemukan kemungkinan positif sejati dari total positif sejati.

  Untuk informasi selengkapnya, lihat [Precision dan recall](https://en.wikipedia.org/wiki/Precision_and_recall) di Wikipedia.
+ `Recall` — Nomor (ganda), tidak lebih dari 1.0.

  Metrik pemanggilan ulang menunjukkan bahwa untuk kecocokan aktual, seberapa sering transformasi Anda memprediksi kecocokan. Secara khusus, ia mengukur seberapa baik transformasi menemukan benar positif dari total catatan dalam data sumber.

  Untuk informasi selengkapnya, lihat [Precision dan recall](https://en.wikipedia.org/wiki/Precision_and_recall) di Wikipedia.
+ `F1` — Nomor (ganda), tidak lebih dari 1.0.

  Metrik F1 maksimal menunjukkan akurasi transformasi antara 0 dan 1, di mana 1 adalah akurasi terbaik.

  Untuk informasi selengkapnya, lihat [Skor F1](https://en.wikipedia.org/wiki/F1_score) di Wikipedia.
+ `ConfusionMatrix` — Sebuah objek [ConfusionMatrix](#aws-glue-api-machine-learning-api-ConfusionMatrix).

  Matriks kebingungan menunjukkan kepada Anda apa yang transformasi Anda prediksi secara akurat dan jenis kesalahan apa yang dibuat.

  Untuk informasi selengkapnya, lihat [Matriks kebingungan](https://en.wikipedia.org/wiki/Confusion_matrix) di Wikipedia.
+ `ColumnImportances` — Susunan objek [ColumnImportance](#aws-glue-api-machine-learning-api-ColumnImportance), tidak lebih dari 100 struktur.

  Daftar struktur `ColumnImportance` yang berisi metrik nilai penting kolom, yang diurutkan dalam urutan nilai penting yang semakin menurun.

## ConfusionMatrix struktur
<a name="aws-glue-api-machine-learning-api-ConfusionMatrix"></a>

Matriks kebingungan menunjukkan kepada Anda apa yang transformasi Anda prediksi secara akurat dan jenis kesalahan apa yang dibuat.

Untuk informasi selengkapnya, lihat [Matriks kebingungan](https://en.wikipedia.org/wiki/Confusion_matrix) di Wikipedia.

**Bidang**
+ `NumTruePositives` — Nomor (panjang).

  Jumlah kecocokan dalam data yang dengan benar ditemukan oleh transformasi, dalam matriks kebingungan untuk transformasi Anda.
+ `NumFalsePositives` — Nomor (panjang).

  Jumlah ketidakcocokan dalam data yang keliru diklasifikasikan oleh transformasi sebagai sebuah kecocokan, dalam matriks kebingungan untuk transformasi Anda.
+ `NumTrueNegatives` — Nomor (panjang).

  Jumlah ketidakcocokan dalam data yang dengan benar ditolak oleh transformasi, dalam matriks kebingungan untuk transformasi Anda.
+ `NumFalseNegatives` — Nomor (panjang).

  Jumlah kecocokan dalam data yang tidak ditemukan oleh transformasi, dalam matriks kebingungan untuk transformasi Anda.

## GlueTable struktur
<a name="aws-glue-api-machine-learning-api-GlueTable"></a>

Database dan tabel dalam AWS Glue Data Catalog yang digunakan untuk input atau output data.

**Bidang**
+ `DatabaseName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Sebuah nama basis data di AWS Glue Data Catalog.
+ `TableName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Sebuah nama tabel di AWS Glue Data Catalog.
+ `CatalogId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik untuk AWS Glue Data Catalog.
+ `ConnectionName` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama koneksi ke AWS Glue Data Catalog.
+ `AdditionalOptions`— Sebuah array peta pasangan kunci-nilai, tidak kurang dari 1 atau lebih dari 10 pasang.

  Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Setiap nilai adalah string Deskripsi, panjangnya tidak lebih dari 2048 byte, cocok dengan. [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)

  Opsi tambahan untuk tabel. Saat ini ada dua kunci yang didukung:
  + `pushDownPredicate`: untuk memfilter pada partisi tanpa harus daftar dan membaca semua file dalam dataset Anda.
  + `catalogPartitionPredicate`: untuk menggunakan pemangkasan partisi sisi server menggunakan indeks partisi di. AWS Glue Data Catalog

## TaskRun struktur
<a name="aws-glue-api-machine-learning-api-TaskRun"></a>

Parameter pengambilan sampel yang dikaitkan dengan transformasi machine learning.

**Bidang**
+ `TransformId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik untuk transformasi.
+ `TaskRunId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik untuk eksekusi tugas ini.
+ `Status` – String UTF-8 (nilai yang valid: `RUNNING` \| `FINISHED` \| `FAILED` \| `PENDING_EXECUTION` \| `TIMED_OUT` \| `CANCELING` \| `CANCELED` \| `RECEIVED_BY_TASKRUNNER`).

  Status eksekusi tugas yang diminta saat ini.
+ `LogGroupName` – String UTF-8.

  Nama grup log untuk pencatatan log yang aman, yang dikaitkan dengan eksekusi tugas ini.
+ `Properties` — Sebuah objek [TaskRunProperties](#aws-glue-api-machine-learning-api-TaskRunProperties).

  Menentukan properti konfigurasi yang dikaitkan dengan eksekusi tugas ini.
+ `ErrorString` – String UTF-8.

  Daftar string kesalahan yang dikaitkan dengan eksekusi tugas ini.
+ `StartedOn` — Stempel waktu.

  Tanggal dan waktu saat eksekusi tugas ini dimulai.
+ `LastModifiedOn` — Stempel waktu.

  Titik dalam waktu terakhir saat eksekusi tugas yang diminta diperbarui.
+ `CompletedOn` — Stempel waktu.

  Titik dalam waktu terakhir saat eksekusi tugas yang diminta selesai.
+ `ExecutionTime` — Nomor (bilangan bulat).

  Jumlah waktu (dalam satuan detik) di mana eksekusi tugas ini menggunakan sumber daya.

## TransformFilterCriteria struktur
<a name="aws-glue-api-machine-learning-api-TransformFilterCriteria"></a>

Kriteria yang digunakan untuk mem-filter transformasi machine learning.

**Bidang**
+ `Name` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Sebuah nama transformasi unik yang digunakan untuk mem-filter transformasi machine learning.
+ `TransformType` – String UTF-8 (nilai yang valid: `FIND_MATCHES`).

  Jenis transformasi machine learning yang digunakan untuk mem-filter transformasi machine learning.
+ `Status` – String UTF-8 (nilai yang valid: `NOT_READY` \| `READY` \| `DELETING`).

  Memfilter daftar transformasi machine learning berdasarkan status transformasi terakhir yang diketahui (untuk menunjukkan apakah transformasi dapat digunakan atau tidak). Salah satu "NOT\_READY", "READY", atau "DELETING".
+ `GlueVersion` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  Nilai ini menentukan versi transformasi pembelajaran mesin AWS Glue ini yang kompatibel. Glue 1.0 direkomendasikan untuk sebagian besar pelanggan. Jika nilai tidak diatur, maka kompatibilitas Glue secara default diatur ke Glue 0.9. Untuk informasi selengkapnya, lihat [Versi AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/release-notes.html#release-notes-versions) dalam panduan developer.
+ `CreatedBefore` — Stempel waktu.

  Waktu dan tanggal sebelum transformasi dibuat.
+ `CreatedAfter` — Stempel waktu.

  Waktu dan tanggal setelah transformasi dibuat.
+ `LastModifiedBefore` — Stempel waktu.

  Filter berdasarkan modifikasi terakhir transformasi sebelum tanggal ini.
+ `LastModifiedAfter` — Stempel waktu.

  Filter berdasarkan modifikasi terakhir transformasi setelah tanggal ini.
+ `Schema` — Susunan objek [SchemaColumn](#aws-glue-api-machine-learning-api-SchemaColumn), tidak lebih dari 100 struktur.

  Filter berdasarkan set data dengan skema tertentu. Objek `Map<Column, Type>` adalah sebuah rangkaian dari pasangan nilai kunci yang mewakili skema yang diterima transformasi ini, di mana `Column` adalah nama kolom, dan `Type` adalah jenis data seperti integer atau string. Memiliki batas atas 100 kolom.

## TransformSortCriteria struktur
<a name="aws-glue-api-machine-learning-api-TransformSortCriteria"></a>

Kriteria pengurutan yang terkait dengan transformasi machine learning.

**Bidang**
+ `Column` – *Wajib:* String UTF-8 (nilai yang valid: `NAME` \| `TRANSFORM_TYPE` \| `STATUS` \| `CREATED` \| `LAST_MODIFIED`).

  Kolom yang akan digunakan dalam kriteria pengurutan yang terkait dengan transformasi machine learning.
+ `SortDirection` – *Wajib:* String UTF-8 (nilai yang valid: `DESCENDING` \| `ASCENDING`).

  Arah pengurutan yang akan digunakan dalam kriteria pengurutan yang terkait dengan transformasi machine learning.

## TaskRunFilterCriteria struktur
<a name="aws-glue-api-machine-learning-api-TaskRunFilterCriteria"></a>

Kriteria yang digunakan untuk mem-filter eksekusi tugas untuk transformasi machine learning.

**Bidang**
+ `TaskRunType` – String UTF-8 (nilai yang valid: `EVALUATION` \| `LABELING_SET_GENERATION` \| `IMPORT_LABELS` \| `EXPORT_LABELS` \| `FIND_MATCHES`).

  Jenis eksekusi tugas.
+ `Status` – String UTF-8 (nilai yang valid: `RUNNING` \| `FINISHED` \| `FAILED` \| `PENDING_EXECUTION` \| `TIMED_OUT` \| `CANCELING` \| `CANCELED` \| `RECEIVED_BY_TASKRUNNER`).

  Status eksekusi tugas saat ini.
+ `StartedBefore` — Stempel waktu.

  Filter berdasarkan eksekusi tugas yang dimulai sebelum tanggal ini.
+ `StartedAfter` — Stempel waktu.

  Filter berdasarkan eksekusi tugas yang dimulai setelah tanggal ini.

## TaskRunSortCriteria struktur
<a name="aws-glue-api-machine-learning-api-TaskRunSortCriteria"></a>

Kriteria pemilahan yang digunakan untuk mengurutkan daftar eksekusi tugas untuk transformasi machine learning.

**Bidang**
+ `Column` – *Wajib:* String UTF-8 (nilai yang valid: `TASK_RUN_TYPE` \| `STATUS` \| `STARTED`).

  Kolom yang akan digunakan untuk mengurutkan daftar eksekusi tugas untuk transformasi machine learning.
+ `SortDirection` – *Wajib:* String UTF-8 (nilai yang valid: `DESCENDING` \| `ASCENDING`).

  Arah pengurutan yang akan digunakan untuk mengurutkan daftar eksekusi tugas untuk transformasi machine learning.

## TaskRunProperties struktur
<a name="aws-glue-api-machine-learning-api-TaskRunProperties"></a>

Properti konfigurasi untuk eksekusi tugas.

**Bidang**
+ `TaskType` – String UTF-8 (nilai yang valid: `EVALUATION` \| `LABELING_SET_GENERATION` \| `IMPORT_LABELS` \| `EXPORT_LABELS` \| `FIND_MATCHES`).

  Jenis eksekusi tugas.
+ `ImportLabelsTaskRunProperties` — Sebuah objek [ImportLabelsTaskRunProperties](#aws-glue-api-machine-learning-api-ImportLabelsTaskRunProperties).

  Properti konfigurasi untuk eksekusi tugas label impor.
+ `ExportLabelsTaskRunProperties` — Sebuah objek [ExportLabelsTaskRunProperties](#aws-glue-api-machine-learning-api-ExportLabelsTaskRunProperties).

  Properti konfigurasi untuk eksekusi tugas label ekspor.
+ `LabelingSetGenerationTaskRunProperties` — Sebuah objek [LabelingSetGenerationTaskRunProperties](#aws-glue-api-machine-learning-api-LabelingSetGenerationTaskRunProperties).

  Properti konfigurasi untuk eksekusi tugas pembuatan label set.
+ `FindMatchesTaskRunProperties` — Sebuah objek [FindMatchesTaskRunProperties](#aws-glue-api-machine-learning-api-FindMatchesTaskRunProperties).

  Properti konfigurasi untuk eksekusi tugas temukan kecocokan.

## FindMatchesTaskRunProperties struktur
<a name="aws-glue-api-machine-learning-api-FindMatchesTaskRunProperties"></a>

Menentukan properti konfigurasi untuk eksekusi tugas Temukan Kecocokan.

**Bidang**
+ `JobId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID tugas untuk eksekusi tugas Temukan Kecocokan.
+ `JobName` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama yang ditetapkan untuk tugas untuk eksekusi tugas Temukan Kecocokan.
+ `JobRunId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID eksekusi tugas untuk eksekusi tugas Temukan Kecocokan.

## ImportLabelsTaskRunProperties struktur
<a name="aws-glue-api-machine-learning-api-ImportLabelsTaskRunProperties"></a>

Menentukan properti konfigurasi untuk eksekusi tugas label impor.

**Bidang**
+ `InputS3Path` – String UTF-8.

  Path Amazon Simple Storage Service (Amazon S3) tempat Anda akan mengimpor label.
+ `Replace` – Boolean.

  Menunjukkan apakah akan menimpa label yang ada.

## ExportLabelsTaskRunProperties struktur
<a name="aws-glue-api-machine-learning-api-ExportLabelsTaskRunProperties"></a>

Menentukan properti konfigurasi untuk eksekusi tugas label ekspor.

**Bidang**
+ `OutputS3Path` – String UTF-8.

  Path Amazon Simple Storage Service (Amazon S3) tempat Anda akan mengekspor label.

## LabelingSetGenerationTaskRunProperties struktur
<a name="aws-glue-api-machine-learning-api-LabelingSetGenerationTaskRunProperties"></a>

Menentukan properti konfigurasi untuk eksekusi tugas pembuatan label set.

**Bidang**
+ `OutputS3Path` – String UTF-8.

  Path Amazon Simple Storage Service (Amazon S3) tempat Anda akan membuat set pelabelan.

## SchemaColumn struktur
<a name="aws-glue-api-machine-learning-api-SchemaColumn"></a>

Sebuah pasangan nilai-kunci yang mewakili kolom dan tipe data yang dapat dijalankan oleh transformasi ini terhadapnya. Parameter `Schema` dari `MLTransform` yang mungkin terdiri hingga 100 struktur ini.

**Bidang**
+ `Name` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 1024 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama kolom.
+ `DataType` — String UTF-8, sepanjang tidak lebih dari 131072, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Jenis data dalam kolom.

## TransformEncryption struktur
<a name="aws-glue-api-machine-learning-api-TransformEncryption"></a>

 encryption-at-restPengaturan transformasi yang berlaku untuk mengakses data pengguna. Transformasi machine learning dapat mengakses data pengguna yang dienkripsi di Amazon S3 menggunakan KMS.

Selain itu, label yang diimpor dan transformasi yang dilatih sekarang dapat dienkripsi menggunakan kunci KMS yang disediakan pelanggan.

**Bidang**
+ `MlUserDataEncryption` — Sebuah objek [MLUserDataEncryption](#aws-glue-api-machine-learning-api-MLUserDataEncryption).

  Sebuah objek `MLUserDataEncryption` yang berisi mode enkripsi dan ID kunci KMS yang disediakan pelanggan.
+ `TaskRunSecurityConfigurationName` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama konfigurasi keamanan.

## MLUserDataEncryption struktur
<a name="aws-glue-api-machine-learning-api-MLUserDataEncryption"></a>

 encryption-at-restPengaturan transformasi yang berlaku untuk mengakses data pengguna.

**Bidang**
+ `MlUserDataEncryptionMode` – *Wajib:* String UTF-8 (nilai yang valid: `DISABLED` \| `SSE-KMS="SSEKMS"`).

  Mode enkripsi yang diterapkan untuk data pengguna. Nilai yang valid adalah:
  + DISABLED: enkripsi dinonaktifkan
  + SSEKMS: penggunaan enkripsi sisi server dengan AWS Key Management Service (SSE-KMS) untuk data pengguna yang disimpan di Amazon S3.
+ `KmsKeyId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID untuk kunci KMS yang disediakan oleh pelanggan.

## ColumnImportance struktur
<a name="aws-glue-api-machine-learning-api-ColumnImportance"></a>

Sebuah struktur yang berisi nama kolom dan skor nilai penting kolom untuk sebuah kolom. 

Nilai penting kolom membantu Anda memahami bagaimana kolom berkontribusi pada model Anda, dengan mengidentifikasi kolom mana dalam catatan Anda yang lebih penting daripada kolom yang lain.

**Bidang**
+ `ColumnName` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama sebuah kolom.
+ `Importance` — Nomor (ganda), tidak lebih dari 1.0.

  Skor nilai penting kolom untuk kolom, dalam desimal.

## Operasi
<a name="aws-glue-api-machine-learning-api-actions"></a>
+ [Buat MLTransform tindakan (Python: create\_ml\_transform)](#aws-glue-api-machine-learning-api-CreateMLTransform)
+ [Perbarui MLTransform tindakan (Python: update\_ml\_transform)](#aws-glue-api-machine-learning-api-UpdateMLTransform)
+ [Hapus MLTransform tindakan (Python: delete\_ml\_transform)](#aws-glue-api-machine-learning-api-DeleteMLTransform)
+ [Dapatkan MLTransform tindakan (Python: get\_ml\_transform)](#aws-glue-api-machine-learning-api-GetMLTransform)
+ [Dapatkan MLTransforms tindakan (Python: get\_ml\_transforms)](#aws-glue-api-machine-learning-api-GetMLTransforms)
+ [Daftar MLTransforms tindakan (Python: list\_ml\_transforms)](#aws-glue-api-machine-learning-api-ListMLTransforms)
+ [Mulai MLEvaluation TaskRun tindakan (Python: start\_ml\_evaluation\_task\_run)](#aws-glue-api-machine-learning-api-StartMLEvaluationTaskRun)
+ [Mulai MLLabeling SetGenerationTaskRun tindakan (Python: start\_ml\_labeling\_set\_generation\_task\_run)](#aws-glue-api-machine-learning-api-StartMLLabelingSetGenerationTaskRun)
+ [Dapatkan tindakan MLTask Jalankan (Python: get\_ml\_task\_run)](#aws-glue-api-machine-learning-api-GetMLTaskRun)
+ [Dapatkan tindakan MLTask Runs (Python: get\_ml\_task\_runs)](#aws-glue-api-machine-learning-api-GetMLTaskRuns)
+ [Batalkan tindakan MLTask Jalankan (Python: cancel\_ml\_task\_run)](#aws-glue-api-machine-learning-api-CancelMLTaskRun)
+ [StartExportLabelsTaskRun tindakan (Python: start\_export\_labels\_task\_run)](#aws-glue-api-machine-learning-api-StartExportLabelsTaskRun)
+ [StartImportLabelsTaskRun tindakan (Python: start\_import\_labels\_task\_run)](#aws-glue-api-machine-learning-api-StartImportLabelsTaskRun)

## Buat MLTransform tindakan (Python: create\_ml\_transform)
<a name="aws-glue-api-machine-learning-api-CreateMLTransform"></a>

Menciptakan transformasi pembelajaran AWS Glue mesin. Operasi ini menciptakan transformasi dan semua parameter yang diperlukan untuk melatih transformasi tersebut.

Panggil operasi ini sebagai langkah pertama dalam proses menggunakan sebuah transformasi machine learning (seperti transformasi `FindMatches`) untuk deduplikasi data. Anda dapat memberikan opsi `Description`, selain parameter yang ingin Anda gunakan untuk algoritme Anda.

Anda juga harus menentukan parameter tertentu untuk tugas yang AWS Glue berjalan atas nama Anda sebagai bagian dari pembelajaran dari data Anda dan membuat transformasi pembelajaran mesin berkualitas tinggi. Parameter ini mencakup `Role`, dan opsional, `AllocatedCapacity`, `Timeout`, dan `MaxRetries`. Untuk informasi lebih lanjut, lihat [Tugas](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-job.html).

**Permintaan**
+ `Name` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama unik yang Anda berikan untuk transformasi pada saat Anda membuatnya.
+ `Description` — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Sebuah deskripsi dari transformasi machine learning yang sedang didefinisikan. Default-nya adalah string kosong.
+ `InputRecordTables` — *Wajib:* Susunan objek [GlueTable](#aws-glue-api-machine-learning-api-GlueTable), tidak lebih dari 10 struktur.

  Daftar definisi AWS Glue tabel yang digunakan oleh transformasi.
+ `Parameters` — *Wajib:* Sebuah objek [TransformParameters](#aws-glue-api-machine-learning-api-TransformParameters).

  Parameter algoritmik yang spesifik untuk jenis transformasi yang digunakan. Secara kondisional tergantung pada jenis transformasi.
+ `Role` – *Wajib:* String UTF-8.

  Nama atau Amazon Resource Name (ARN) dari IAM role dengan izin yang diperlukan. Izin yang diperlukan mencakup izin peran AWS Glue layanan ke AWS Glue sumber daya, dan izin Amazon S3 yang diperlukan oleh transformasi. 
  + Peran ini membutuhkan izin peran AWS Glue layanan untuk memungkinkan akses ke sumber daya. AWS Glue Lihat [Melampirkan Kebijakan untuk pengguna IAM yang Mengakses AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/attach-policy-iam-user.html).
  + Peran ini memerlukan izin ke sumber Amazon Simple Storage Service (Amazon S3), target, direktori sementara, skrip, dan perpustakaan yang digunakan oleh tugas yang dijalankan untuk transformasi ini.
+ `GlueVersion` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  Nilai ini menentukan versi transformasi pembelajaran mesin AWS Glue ini yang kompatibel. Glue 1.0 direkomendasikan untuk sebagian besar pelanggan. Jika nilai tidak diatur, maka kompatibilitas Glue secara default diatur ke Glue 0.9. Untuk informasi selengkapnya, lihat [Versi AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/release-notes.html#release-notes-versions) dalam panduan developer.
+ `MaxCapacity` — Nomor (ganda).

  Jumlah unit pemrosesan AWS Glue data (DPUs) yang dialokasikan ke tugas berjalan untuk transformasi ini. Anda dapat mengalokasikan dari 2 hingga 100 DPUs; defaultnya adalah 10. DPU adalah ukuran relatif daya pemrosesan yang terdiri dari 4 v CPUs kapasitas komputasi dan memori 16 GB. Untuk informasi lebih lanjut, lihat [halaman harga AWS Glue](https://aws.amazon.com/glue/pricing/). 

  `MaxCapacity` adalah pilihan yang eksklusif satu sama lain dengan `NumberOfWorkers` dan `WorkerType`.
  + Jika `NumberOfWorkers` atau `WorkerType` diatur, maka `MaxCapacity` tidak dapat diatur.
  + Jika `MaxCapacity` diatur, maka `NumberOfWorkers` atau `WorkerType` tidak dapat diatur.
  + Jika `WorkerType` diatur, maka `NumberOfWorkers` wajib (dan sebaliknya).
  + `MaxCapacity` dan `NumberOfWorkers`, keduanya minimal harus 1.

  Saat bidang `WorkerType` diatur ke nilai selain `Standard`, maka bidang `MaxCapacity` diatur secara otomatis dan menjadi baca-saja.

  Saat bidang `WorkerType` diatur ke nilai selain `Standard`, maka bidang `MaxCapacity` diatur secara otomatis dan menjadi baca-saja.
+ `WorkerType` – String UTF-8 (nilai yang valid: `Standard=""` \| `G.1X=""` \| `G.2X=""` \| `G.025X=""` \| `G.4X=""` \| `G.8X=""` \| `Z.2X=""`).

  Jenis pekerja yang telah ditetapkan sebelumnya yang dialokasikan ketika tugas ini dieksekusi. Menerima nilai Standard, G.1X, atau G.2X.
  + Untuk jenis pekerja `Standard`, setiap pekerja menyediakan 4 vCPU, memori 16 GB dan disk 50GB, dan 2 pelaksana per pekerja.
  + Untuk jenis pekerja `G.1X`, setiap pekerja menyediakan 4 vCPU, memori 16 GB dan disk 64GB, dan 1 pelaksana per pekerja.
  + Untuk jenis pekerja `G.2X`, setiap pekerja menyediakan 8 vCPU, memori 32 GB dan disk 128GB, dan 1 pelaksana per pekerja.

  `MaxCapacity` adalah pilihan yang eksklusif satu sama lain dengan `NumberOfWorkers` dan `WorkerType`.
  + Jika `NumberOfWorkers` atau `WorkerType` diatur, maka `MaxCapacity` tidak dapat diatur.
  + Jika `MaxCapacity` diatur, maka `NumberOfWorkers` atau `WorkerType` tidak dapat diatur.
  + Jika `WorkerType` diatur, maka `NumberOfWorkers` wajib (dan sebaliknya).
  + `MaxCapacity` dan `NumberOfWorkers`, keduanya minimal harus 1.
+ `NumberOfWorkers` — Nomor (bilangan bulat).

  Jumlah pekerja dari `workerType` ditentukan yang dialokasikan ketika tugas ini dieksekusi.

  Jika `WorkerType` diatur, maka `NumberOfWorkers` wajib (dan sebaliknya).
+ `Timeout` — Nomor (bilangan bulat), minimal 1.

  Waktu habis untuk eksekusi tugas untuk transformasi ini, dalam satuan menit. Ini adalah waktu maksimum yang bisa digunakan oleh eksekusi tugas untuk transformasi ini untuk menggunakan sumber daya sebelum eksekusi dihentikan dan memasuki status `TIMEOUT`. Nilai default-nya adalah 2.880 menit (48 jam).
+ `MaxRetries` — Nomor (bilangan bulat).

  Jumlah percobaan maksimum untuk mencoba kembali tugas untuk transformasi ini setelah eksekusi tugas gagal.
+ `Tags` — Sebuah rangkaian peta pasangan nilai kunci, tidak lebih dari 50 pasang.

  Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.

  Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak lebih dari 256 byte.

  Tag yang akan digunakan dengan transformasi machine learning ini. Anda dapat menggunakan tag untuk membatasi akses ke transformasi machine learning tersebut. Untuk informasi selengkapnya tentang [AWS tag AWS Glue, lihat Tag AWS Glue di](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html) panduan pengembang.
+ `TransformEncryption` — Sebuah objek [TransformEncryption](#aws-glue-api-machine-learning-api-TransformEncryption).

   encryption-at-restPengaturan transformasi yang berlaku untuk mengakses data pengguna. Transformasi machine learning dapat mengakses data pengguna yang dienkripsi di Amazon S3 menggunakan KMS.

**Respons**
+ `TransformId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Sebuah pengenal unik yang dihasilkan untuk transformasi.

**Kesalahan**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `AccessDeniedException`
+ `ResourceNumberLimitExceededException`
+ `IdempotentParameterMismatchException`

## Perbarui MLTransform tindakan (Python: update\_ml\_transform)
<a name="aws-glue-api-machine-learning-api-UpdateMLTransform"></a>

Memperbarui transformasi machine learning yang ada. Panggil operasi ini untuk menyetel parameter algoritme untuk mencapai hasil yang lebih baik.

Setelah memanggil operasi ini, Anda dapat memanggil operasi `StartMLEvaluationTaskRun` untuk menilai seberapa baik parameter baru Anda mencapai tujuan Anda (seperti meningkatkan kualitas transformasi machine learning Anda, atau membuatnya menjadi lebih hemat biaya).

**Permintaan**
+ `TransformId` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengenal unik yang dihasilkan saat transformasi dibuat.
+ `Name` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama unik yang Anda berikan pada transformasi saat Anda membuatnya.
+ `Description` — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Sebuah deskripsi transformasi. Default-nya adalah string kosong.
+ `Parameters` — Sebuah objek [TransformParameters](#aws-glue-api-machine-learning-api-TransformParameters).

  Parameter konfigurasi yang spesifik untuk jenis transformasi (algoritme) yang digunakan. Secara kondisional tergantung pada jenis transformasi.
+ `Role` – String UTF-8.

  Nama atau Amazon Resource Name (ARN) dari IAM role dengan izin yang diperlukan.
+ `GlueVersion` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  Nilai ini menentukan versi transformasi pembelajaran mesin AWS Glue ini yang kompatibel. Glue 1.0 direkomendasikan untuk sebagian besar pelanggan. Jika nilai tidak diatur, maka kompatibilitas Glue secara default diatur ke Glue 0.9. Untuk informasi selengkapnya, lihat [Versi AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/release-notes.html#release-notes-versions) dalam panduan developer.
+ `MaxCapacity` — Nomor (ganda).

  Jumlah unit pemrosesan AWS Glue data (DPUs) yang dialokasikan ke tugas berjalan untuk transformasi ini. Anda dapat mengalokasikan dari 2 hingga 100 DPUs; defaultnya adalah 10. DPU adalah ukuran relatif daya pemrosesan yang terdiri dari 4 v CPUs kapasitas komputasi dan memori 16 GB. Untuk informasi lebih lanjut, lihat [halaman harga AWS Glue](https://aws.amazon.com/glue/pricing/). 

  Saat bidang `WorkerType` diatur ke nilai selain `Standard`, maka bidang `MaxCapacity` diatur secara otomatis dan menjadi baca-saja.
+ `WorkerType` – String UTF-8 (nilai yang valid: `Standard=""` \| `G.1X=""` \| `G.2X=""` \| `G.025X=""` \| `G.4X=""` \| `G.8X=""` \| `Z.2X=""`).

  Jenis pekerja yang telah ditetapkan sebelumnya yang dialokasikan ketika tugas ini dieksekusi. Menerima nilai Standard, G.1X, atau G.2X.
  + Untuk jenis pekerja `Standard`, setiap pekerja menyediakan 4 vCPU, memori 16 GB dan disk 50GB, dan 2 pelaksana per pekerja.
  + Untuk jenis pekerja `G.1X`, setiap pekerja menyediakan 4 vCPU, memori 16 GB dan disk 64GB, dan 1 pelaksana per pekerja.
  + Untuk jenis pekerja `G.2X`, setiap pekerja menyediakan 8 vCPU, memori 32 GB dan disk 128GB, dan 1 pelaksana per pekerja.
+ `NumberOfWorkers` — Nomor (bilangan bulat).

  Jumlah pekerja dari `workerType` ditentukan yang dialokasikan ketika tugas ini dieksekusi.
+ `Timeout` — Nomor (bilangan bulat), minimal 1.

  Waktu habis untuk sebuah eksekusi tugas untuk transformasi ini, dalam satuan menit. Ini adalah waktu maksimum yang bisa digunakan oleh eksekusi tugas untuk transformasi ini untuk menggunakan sumber daya sebelum eksekusi dihentikan dan memasuki status `TIMEOUT`. Nilai default-nya adalah 2.880 menit (48 jam).
+ `MaxRetries` — Nomor (bilangan bulat).

  Jumlah percobaan maksimum untuk mencoba kembali tugas untuk transformasi ini setelah eksekusi tugas gagal.

**Respons**
+ `TransformId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik untuk transformasi yang sudah diperbarui.

**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `AccessDeniedException`

## Hapus MLTransform tindakan (Python: delete\_ml\_transform)
<a name="aws-glue-api-machine-learning-api-DeleteMLTransform"></a>

Menghapus transformasi pembelajaran AWS Glue mesin. Transformasi machine learning adalah jenis transformasi khusus yang menggunakan machine learning untuk mempelajari detail transformasi yang akan dilakukan dengan belajar dari contoh yang diberikan oleh manusia. Transformasi ini kemudian diselamatkan oleh AWS Glue. Jika Anda tidak lagi memerlukan sebuah transformasi, maka Anda dapat menghapusnya dengan memanggil `DeleteMLTransforms`. Namun, AWS Glue pekerjaan apa pun yang masih mereferensikan transformasi yang dihapus tidak akan berhasil lagi.

**Permintaan**
+ `TransformId` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik dari transformasi yang akan dihapus.

**Respons**
+ `TransformId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik dari transformasi yang sudah dihapus.

**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## Dapatkan MLTransform tindakan (Python: get\_ml\_transform)
<a name="aws-glue-api-machine-learning-api-GetMLTransform"></a>

Mendapat artefak transformasi pembelajaran AWS Glue mesin dan semua metadata yang sesuai. Transformasi machine learning adalah jenis transformasi khusus yang menggunakan machine learning untuk mempelajari detail transformasi yang akan dilakukan dengan belajar dari contoh yang diberikan oleh manusia. Transformasi ini kemudian diselamatkan oleh AWS Glue. Anda dapat mengambil metadata mereka dengan memanggil `GetMLTransform`.

**Permintaan**
+ `TransformId` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik transformasi, yang dihasilkan pada saat transformasi dibuat.

**Respons**
+ `TransformId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik transformasi, yang dihasilkan pada saat transformasi dibuat.
+ `Name` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama unik yang diberikan pada transformasi saat transformasi tersebut dibuat.
+ `Description` — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Sebuah deskripsi transformasi.
+ `Status` – String UTF-8 (nilai yang valid: `NOT_READY` \| `READY` \| `DELETING`).

  Status terakhir yang diketahui dari transformasi (untuk menunjukkan apakah transformasi dapat digunakan atau tidak). Salah satu "NOT\_READY", "READY", atau "DELETING".
+ `CreatedOn` — Stempel waktu.

  Tanggal dan waktu saat transformasi dibuat.
+ `LastModifiedOn` — Stempel waktu.

  Tanggal dan waktu saat transformasi terakhir diubah.
+ `InputRecordTables` — Susunan objek [GlueTable](#aws-glue-api-machine-learning-api-GlueTable), tidak lebih dari 10 struktur.

  Daftar definisi AWS Glue tabel yang digunakan oleh transformasi.
+ `Parameters` — Sebuah objek [TransformParameters](#aws-glue-api-machine-learning-api-TransformParameters).

  Parameter konfigurasi khusus untuk algoritme yang digunakan.
+ `EvaluationMetrics` — Sebuah objek [EvaluationMetrics](#aws-glue-api-machine-learning-api-EvaluationMetrics).

  Metrik evaluasi terbaru.
+ `LabelCount` — Nomor (bilangan bulat).

  Jumlah label yang tersedia untuk transformasi ini.
+ `Schema` — Susunan objek [SchemaColumn](#aws-glue-api-machine-learning-api-SchemaColumn), tidak lebih dari 100 struktur.

  Objek `Map<Column, Type>` yang mewakili skema yang diterima transformasi ini. Memiliki batas atas 100 kolom.
+ `Role` – String UTF-8.

  Nama atau Amazon Resource Name (ARN) dari IAM role dengan izin yang diperlukan.
+ `GlueVersion` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  Nilai ini menentukan versi transformasi pembelajaran mesin AWS Glue ini yang kompatibel. Glue 1.0 direkomendasikan untuk sebagian besar pelanggan. Jika nilai tidak diatur, maka kompatibilitas Glue secara default diatur ke Glue 0.9. Untuk informasi selengkapnya, lihat [Versi AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/release-notes.html#release-notes-versions) dalam panduan developer.
+ `MaxCapacity` — Nomor (ganda).

  Jumlah unit pemrosesan AWS Glue data (DPUs) yang dialokasikan ke tugas berjalan untuk transformasi ini. Anda dapat mengalokasikan dari 2 hingga 100 DPUs; defaultnya adalah 10. DPU adalah ukuran relatif daya pemrosesan yang terdiri dari 4 v CPUs kapasitas komputasi dan memori 16 GB. Untuk informasi lebih lanjut, lihat [halaman harga AWS Glue](https://aws.amazon.com/glue/pricing/). 

  Saat bidang `WorkerType` diatur ke nilai selain `Standard`, maka bidang `MaxCapacity` diatur secara otomatis dan menjadi baca-saja.
+ `WorkerType` – String UTF-8 (nilai yang valid: `Standard=""` \| `G.1X=""` \| `G.2X=""` \| `G.025X=""` \| `G.4X=""` \| `G.8X=""` \| `Z.2X=""`).

  Jenis pekerja yang telah ditetapkan sebelumnya yang dialokasikan ketika tugas ini dieksekusi. Menerima nilai Standard, G.1X, atau G.2X.
  + Untuk jenis pekerja `Standard`, setiap pekerja menyediakan 4 vCPU, memori 16 GB dan disk 50GB, dan 2 pelaksana per pekerja.
  + Untuk jenis pekerja `G.1X`, setiap pekerja menyediakan 4 vCPU, memori 16 GB dan disk 64GB, dan 1 pelaksana per pekerja.
  + Untuk jenis pekerja `G.2X`, setiap pekerja menyediakan 8 vCPU, memori 32 GB dan disk 128GB, dan 1 pelaksana per pekerja.
+ `NumberOfWorkers` — Nomor (bilangan bulat).

  Jumlah pekerja dari `workerType` ditentukan yang dialokasikan ketika tugas ini dieksekusi.
+ `Timeout` — Nomor (bilangan bulat), minimal 1.

  Waktu habis untuk sebuah eksekusi tugas untuk transformasi ini, dalam satuan menit. Ini adalah waktu maksimum yang bisa digunakan oleh eksekusi tugas untuk transformasi ini untuk menggunakan sumber daya sebelum eksekusi dihentikan dan memasuki status `TIMEOUT`. Nilai default-nya adalah 2.880 menit (48 jam).
+ `MaxRetries` — Nomor (bilangan bulat).

  Jumlah percobaan maksimum untuk mencoba kembali tugas untuk transformasi ini setelah eksekusi tugas gagal.
+ `TransformEncryption` — Sebuah objek [TransformEncryption](#aws-glue-api-machine-learning-api-TransformEncryption).

   encryption-at-restPengaturan transformasi yang berlaku untuk mengakses data pengguna. Transformasi machine learning dapat mengakses data pengguna yang dienkripsi di Amazon S3 menggunakan KMS.

**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## Dapatkan MLTransforms tindakan (Python: get\_ml\_transforms)
<a name="aws-glue-api-machine-learning-api-GetMLTransforms"></a>

Mendapat daftar transformasi pembelajaran AWS Glue mesin yang dapat diurutkan dan dapat disaring. Transformasi machine learning adalah jenis transformasi khusus yang menggunakan machine learning untuk mempelajari detail transformasi yang akan dilakukan dengan belajar dari contoh yang diberikan oleh manusia. Transformasi ini kemudian disimpan oleh AWS Glue, dan Anda dapat mengambil metadata mereka dengan menelepon. `GetMLTransforms`

**Permintaan**
+ `NextToken` – String UTF-8.

  Sebuah token pemberian nomor halaman untuk mengimbangi hasil.
+ `MaxResults` — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 1000.

  Jumlah hasil maksimum yang akan dikembalikan.
+ `Filter` — Sebuah objek [TransformFilterCriteria](#aws-glue-api-machine-learning-api-TransformFilterCriteria).

  Kriteria transformasi filter.
+ `Sort` — Sebuah objek [TransformSortCriteria](#aws-glue-api-machine-learning-api-TransformSortCriteria).

  Kriteria pengurutan.

**Respons**
+ `Transforms` – *Wajib:* Susunan objek [MLTransform](#aws-glue-api-machine-learning-api-MLTransform).

  Sebuah daftar transformasi machine learning.
+ `NextToken` – String UTF-8.

  Sebuah token pemberian nomor halaman, jika ada lebih banyak hasil yang tersedia.

**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## Daftar MLTransforms tindakan (Python: list\_ml\_transforms)
<a name="aws-glue-api-machine-learning-api-ListMLTransforms"></a>

 Mengambil daftar yang dapat diurutkan dan disaring dari transformasi pembelajaran AWS Glue mesin yang ada di AWS akun ini, atau sumber daya dengan tag yang ditentukan. Operasi ini mengambil kolom `Tags` opsional, yang dapat Anda gunakan sebagai sebuah filter respon sehingga tag sumber daya dapat diambil sebagai sebuah grup. Jika Anda memilih untuk menggunakan pem-filter-an tag, maka hanya sumber daya dengan tag saja yang diambil. 

**Permintaan**
+ `NextToken` – String UTF-8.

  Sebuah token kelanjutan, jika ini adalah permintaan kelanjutan.
+ `MaxResults` — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 1000.

  Ukuran maksimum daftar yang akan dikembalikan.
+ `Filter` — Sebuah objek [TransformFilterCriteria](#aws-glue-api-machine-learning-api-TransformFilterCriteria).

  Sebuah `TransformFilterCriteria` yang digunakan untuk mem-filter transformasi machine learning.
+ `Sort` — Sebuah objek [TransformSortCriteria](#aws-glue-api-machine-learning-api-TransformSortCriteria).

  Sebuah `TransformSortCriteria` yang digunakan untuk mengurutkan transformasi machine learning.
+ `Tags` — Sebuah rangkaian peta pasangan nilai kunci, tidak lebih dari 50 pasang.

  Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.

  Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak lebih dari 256 byte.

  Menentukan untuk mengembalikan hanya sumber daya ditandai saja.

**Respons**
+ `TransformIds` – *Wajib:* Susunan string UTF-8.

  Pengidentifikasi semua transformasi machine learning dalam akun, atau transformasi machine learning dengan tag yang ditentukan.
+ `NextToken` – String UTF-8.

  Sebuah token kelanjutan, jika daftar yang dikembalikan tidak berisi metrik terakhir yang tersedia.

**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## Mulai MLEvaluation TaskRun tindakan (Python: start\_ml\_evaluation\_task\_run)
<a name="aws-glue-api-machine-learning-api-StartMLEvaluationTaskRun"></a>

Memulai tugas untuk memperkirakan kualitas transformasi. 

Ketika Anda memberikan set label sebagai contoh kebenaran, pembelajaran AWS Glue mesin menggunakan beberapa contoh tersebut untuk belajar darinya. Selebihnya label digunakan sebagai pengujian untuk memperkirakan kualitas.

Mengembalikan sebuah pengidentifikasi unik untuk eksekusi. Anda dapat memanggil `GetMLTaskRun` untuk mendapatkan informasi lebih lanjut tentang statistik `EvaluationTaskRun`.

**Permintaan**
+ `TransformId` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik dari transformasi machine learning.

**Respons**
+ `TaskRunId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik yang terkait dengan eksekusi ini.

**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `ConcurrentRunsExceededException`
+ `MLTransformNotReadyException`

## Mulai MLLabeling SetGenerationTaskRun tindakan (Python: start\_ml\_labeling\_set\_generation\_task\_run)
<a name="aws-glue-api-machine-learning-api-StartMLLabelingSetGenerationTaskRun"></a>

Memulai alur kerja pembelajaran aktif untuk transformasi machine learning Anda untuk meningkatkan kualitas transformasi dengan menghasilkan set label dan menambahkan label.

Saat `StartMLLabelingSetGenerationTaskRun` selesai, AWS Glue akan menghasilkan "set pelabelan" atau serangkaian pertanyaan yang harus dijawab oleh manusia.

Dalam kasus transformasi `FindMatches`, pertanyaan-pertanyaan ini berbentuk, "Apa cara yang benar untuk mengelompokkan baris ini bersama-sama ke dalam grup yang seluruhnya terdiri dari catatan yang cocok?" 

Setelah proses pelabelan selesai, Anda dapat mengunggah label Anda dengan memanggil `StartImportLabelsTaskRun`. Setelah `StartImportLabelsTaskRun` selesai, semua eksekusi transformasi machine learning di masa depan akan menggunakan label baru dan yang telah ditingkatkan dan melakukan transformasi kualitas yang lebih tinggi.

Catatan: Peran yang digunakan untuk menulis set pelabelan yang dihasilkan `OutputS3Path` adalah peran yang terkait dengan Transformasi Machine Learning, yang ditentukan dalam `CreateMLTransform` API.

**Permintaan**
+ `TransformId` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik dari transformasi machine learning.
+ `OutputS3Path` – *Wajib:* String UTF-8.

  Path Amazon Simple Storage Service (Amazon S3) tempat Anda membuat set pelabelan.

**Respons**
+ `TaskRunId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi eksekusi unik yang dikaitkan dengan eksekusi tugas ini.

**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `ConcurrentRunsExceededException`

## Dapatkan tindakan MLTask Jalankan (Python: get\_ml\_task\_run)
<a name="aws-glue-api-machine-learning-api-GetMLTaskRun"></a>

Mendapatkan detail untuk eksekusi tugas tertentu pada sebuah transformasi machine learning. Proses tugas pembelajaran mesin adalah tugas asinkron yang AWS Glue berjalan atas nama Anda sebagai bagian dari berbagai alur kerja pembelajaran mesin. Anda dapat memeriksa statistik dari setiap tugas yang dijalankan dengan memanggil `GetMLTaskRun` dengan `TaskRunID` dan `TransformID` dari transformasi induknya.

**Permintaan**
+ `TransformId` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik dari transformasi machine learning.
+ `TaskRunId` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik eksekusi tugas.

**Respons**
+ `TransformId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik eksekusi tugas.
+ `TaskRunId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi eksekusi unik yang dikaitkan dengan eksekusi ini.
+ `Status` – String UTF-8 (nilai yang valid: `RUNNING` \| `FINISHED` \| `FAILED` \| `PENDING_EXECUTION` \| `TIMED_OUT` \| `CANCELING` \| `CANCELED` \| `RECEIVED_BY_TASKRUNNER`).

  Status untuk eksekusi tugas ini.
+ `LogGroupName` – String UTF-8.

  Nama-nama grup log yang dikaitkan dengan eksekusi tugas.
+ `Properties` — Sebuah objek [TaskRunProperties](#aws-glue-api-machine-learning-api-TaskRunProperties).

  Daftar properti yang dikaitkan dengan eksekusi tugas.
+ `ErrorString` – String UTF-8.

  String kesalahan yang dikaitkan dengan eksekusi tugas.
+ `StartedOn` — Stempel waktu.

  Tanggal dan waktu ketika eksekusi tugas ini dimulai.
+ `LastModifiedOn` — Stempel waktu.

  Tanggal dan waktu ketika eksekusi tugas ini terakhir diubah.
+ `CompletedOn` — Stempel waktu.

  Tanggal dan waktu ketika eksekusi tugas ini selesai.
+ `ExecutionTime` — Nomor (bilangan bulat).

  Jumlah waktu (dalam satuan detik) di mana eksekusi tugas ini menggunakan sumber daya.

**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## Dapatkan tindakan MLTask Runs (Python: get\_ml\_task\_runs)
<a name="aws-glue-api-machine-learning-api-GetMLTaskRuns"></a>

Mendapatkan sebuah daftar eksekusi untuk transformasi machine learning. Proses tugas pembelajaran mesin adalah tugas asinkron yang AWS Glue berjalan atas nama Anda sebagai bagian dari berbagai alur kerja pembelajaran mesin. Anda bisa mendapatkan daftar tugas machine learning yang dapat diurutkan dan disaring dengan memanggil `GetMLTaskRuns` dengan `TransformID` dari transformasi induknya dan parameter opsional lainnya seperti yang didokumentasikan di bagian ini.

Operasi ini mengembalikan daftar eksekusi historis dan harus diberi nomor halaman.

**Permintaan**
+ `TransformId` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik dari transformasi machine learning.
+ `NextToken` – String UTF-8.

  Sebuah token untuk pemberian nomor halaman hasil. Nilai default adalah (kosong).
+ `MaxResults` — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 1000.

  Jumlah hasil maksimum yang akan dikembalikan. 
+ `Filter` — Sebuah objek [TaskRunFilterCriteria](#aws-glue-api-machine-learning-api-TaskRunFilterCriteria).

  Kriteria filter, dalam struktur `TaskRunFilterCriteria`, untuk eksekusi tugas.
+ `Sort` — Sebuah objek [TaskRunSortCriteria](#aws-glue-api-machine-learning-api-TaskRunSortCriteria).

  Kriteria pengurutan, dalam struktur `TaskRunSortCriteria`, untuk eksekusi tugas.

**Respons**
+ `TaskRuns` – Susunan objek [TaskRun](#aws-glue-api-machine-learning-api-TaskRun).

  Daftar eksekusi tugas yang dikaitkan dengan transformasi.
+ `NextToken` – String UTF-8.

  Sebuah token pemberian nomor halaman, jika ada lebih banyak hasil yang tersedia.

**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## Batalkan tindakan MLTask Jalankan (Python: cancel\_ml\_task\_run)
<a name="aws-glue-api-machine-learning-api-CancelMLTaskRun"></a>

Membatalkan (menghentikan) sebuah eksekusi tugas. Proses tugas pembelajaran mesin adalah tugas asinkron yang AWS Glue berjalan atas nama Anda sebagai bagian dari berbagai alur kerja pembelajaran mesin. Anda dapat membatalkan sebuah eksekusi tugas machine learning kapan saja dengan memanggil `CancelMLTaskRun` dengan `TransformID` transformasi induk dari sebuah eksekusi tugas dan `TaskRunId` dari eksekusi tugas. 

**Permintaan**
+ `TransformId` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik dari transformasi machine learning.
+ `TaskRunId` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Sebuah pengidentifikasi unik untuk eksekusi tugas.

**Respons**
+ `TransformId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik dari transformasi machine learning.
+ `TaskRunId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik untuk eksekusi tugas.
+ `Status` – String UTF-8 (nilai yang valid: `RUNNING` \| `FINISHED` \| `FAILED` \| `PENDING_EXECUTION` \| `TIMED_OUT` \| `CANCELING` \| `CANCELED` \| `RECEIVED_BY_TASKRUNNER`).

  Status untuk eksekusi ini.

**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## StartExportLabelsTaskRun tindakan (Python: start\_export\_labels\_task\_run)
<a name="aws-glue-api-machine-learning-api-StartExportLabelsTaskRun"></a>

Memulai tugas asinkron untuk mengekspor semua data berlabel untuk sebuah transformasi tertentu. Tugas ini adalah satu-satunya panggilan API terkait label yang bukan merupakan bagian dari alur kerja pembelajaran yang tipikal. Anda biasanya menggunakan `StartExportLabelsTaskRun` saat Anda ingin bekerja dengan semua label yang ada pada saat yang sama, seperti saat Anda ingin menghapus atau mengubah label yang sebelumnya dikirimkan sebagai kebenaran. Operasi API ini menerima `TransformId` yang labelnya ingin Anda ekspor dan path Amazon Simple Storage Service (Amazon S3) yang akan digunakan untuk mengekspor label. Operasi tersebut mengembalikan `TaskRunId`. Anda dapat memeriksa status dari eksekusi tugas Anda dengan memanggil API `GetMLTaskRun`.

**Permintaan**
+ `TransformId` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik dari transformasi machine learning.
+ `OutputS3Path` – *Wajib:* String UTF-8.

  Path Amazon S3 di mana Anda mengekspor label.

**Respons**
+ `TaskRunId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik untuk eksekusi tugas.

**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## StartImportLabelsTaskRun tindakan (Python: start\_import\_labels\_task\_run)
<a name="aws-glue-api-machine-learning-api-StartImportLabelsTaskRun"></a>

Memungkinkan Anda untuk memberikan label tambahan (contoh kebenaran) yang akan digunakan untuk mengajarkan transformasi machine learning dan meningkatkan kualitasnya. Operasi API ini pada umumnya digunakan sebagai bagian dari alur kerja pembelajaran aktif yang dimulai dengan panggilan `StartMLLabelingSetGenerationTaskRun` dan yang akhirnya menghasilkan peningkatan kualitas pada transformasi machine learning Anda. 

Setelah `StartMLLabelingSetGenerationTaskRun` selesai, machine learning AWS Glue akan menghasilkan serangkaian pertanyaan yang akan dijawab oleh manusia. (Menjawab pertanyaan-pertanyaan ini sering disebut 'pelabelan' dalam alur kerja machine learning). Dalam kasus transformasi `FindMatches`, pertanyaan-pertanyaan ini berbentuk, "Apa cara yang benar untuk mengelompokkan baris ini bersama-sama ke dalam grup yang seluruhnya terdiri dari catatan yang cocok?" Setelah proses pelabelan selesai, pengguna mengunggahnya answers/labels dengan panggilan ke`StartImportLabelsTaskRun`. Setelah `StartImportLabelsTaskRun` selesai, semua eksekusi transformasi machine learning di masa depan menggunakan label baru dan yang telah ditingkatkan dan melakukan transformasi kualitas yang lebih tinggi.

Secara default, `StartMLLabelingSetGenerationTaskRun` terus belajar dari dan menggabungkan semua label yang Anda unggah kecuali Anda mengatur `Replace` ke BETUL. Jika Anda mengatur `Replace` ke BETUL, `StartImportLabelsTaskRun` akan menghapus dan melupakan semua label yang diunggah sebelumnya dan hanya belajar hanya dari set yang Anda unggah. Mengganti label dapat membantu jika Anda menyadari bahwa Anda sebelumnya mengunggah label yang salah, dan Anda meyakini bahwa label tersebut memiliki efek negatif pada kualitas transformasi Anda.

Anda dapat memeriksa status dari eksekusi tugas Anda dengan memanggil operasi `GetMLTaskRun`. 

**Permintaan**
+ `TransformId` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik dari transformasi machine learning.
+ `InputS3Path` – *Wajib:* String UTF-8.

  Path Amazon Simple Storage Service (Amazon S3) tempat Anda mengimpor label.
+ `ReplaceAllLabels` – Boolean.

  Menunjukkan apakah akan menimpa label yang ada.

**Respons**
+ `TaskRunId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik untuk eksekusi tugas.

**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`