機器學習 API

• TransformParameters 結構

• EvaluationMetrics 結構

• MLTransform 結構

• FindMatchesParameters 結構

• FindMatchesMetrics 結構

• ConfusionMatrix 結構

• GlueTable 結構

• TaskRun 結構

• TransformFilterCriteria 結構

• TransformSortCriteria 結構

• TaskRunFilterCriteria 結構

• TaskRunSortCriteria 結構

• TaskRunProperties 結構

• FindMatchesTaskRunProperties 結構

• ImportLabelsTaskRunProperties 結構

• ExportLabelsTaskRunProperties 結構

• LabelingSetGenerationTaskRunProperties 結構

• SchemaColumn 結構

• TransformEncryption 結構

• 毫升UserDataEncryption 結構

• ColumnImportance 結構

欄位

• TransformType – 必要：UTF-8 字串 (有效值：FIND_MATCHES)。

  機器學習轉換的類型。

  如需機器學習轉換類型的資訊，請參閱建立機器學習轉換。

• FindMatchesParameters – FindMatches參數 物件。

  find matches 演算法的參數。

欄位

• TransformType – 必要：UTF-8 字串 (有效值：FIND_MATCHES)。

  機器學習轉換的類型。

• FindMatchesMetrics – FindMatches度量 物件。

  find matches 演算法的評估指標。

欄位

• TransformId – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  針對機器學習轉換產生的唯一轉換 ID。此 ID 保證是唯一的，且不會變更。

• Name – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  機器學習轉換的使用者定義名稱。名稱不保證唯一，且可隨時變更。

• Description – 描述字串，長度不可超過 2048 個位元組，需符合URI address multi-line string pattern。

  機器學習轉換的使用者定義描述長文。描述不保證唯一，且可隨時變更。

• Status – UTF-8 字串 (有效值：NOT_READY | READY | DELETING)。

  機器學習轉換目前的狀態。

• CreatedOn – 時間戳記。

  時間戳記。此機器學習轉換建立的時間和日期。

• LastModifiedOn – 時間戳記。

  時間戳記。此機器學習轉換最後一次修改的時間點。

• InputRecordTables – 一個 GlueTable 物件陣列，不可超過 10 個結構。

  轉換所使用的 AWS Glue 資料表定義清單。

• Parameters – TransformParameters 物件。

  TransformParameters 物件。您可以透過指定學習資料和各種權衡的偏好設定 (如精確率與回收率，或準確性與成本)，使用參數來調整 (自訂) 機器學習轉換的行為。

• EvaluationMetrics – EvaluationMetrics 物件。

  EvaluationMetrics 物件。評估指標會提供機器學習轉換品質的預估值。

• LabelCount – 數字 (整數)。

  針對此轉換產生的標籤檔案的 AWS Glue 計數識別碼。當您建立更佳的轉換時，您就可以反覆下載、標記和上傳標記檔案。

• Schema – 一個 SchemaColumn 物件陣列，不可超過 100 個結構。

  表示欄和資料類型的鍵/值對映射，可以執行此轉換。已有 100 個欄的上限。

• Role – UTF-8 字串。

  IAM 角色的名稱或 Amazon Resource Name (ARN) 與所需的許可。所需許可包括 AWS Glue 資源的 AWS Glue 服務角色許可，以及轉換所需的 Amazon S3 許可。

  • 此角色需要 AWS Glue 服務角色權限才能允許存取中的資源 AWS Glue。請參閱連接政策到存取 AWS Glue的 IAM 使用者。

  • 此角色需要此轉換任務回合所用的 Amazon Simple Storage Service (Amazon S3) 來源、目標、暫時目錄、指令碼和任何程式庫的許可。

• GlueVersion – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Custom string pattern #20。

  此值決定 AWS Glue 此機器學習轉換與哪個版本相容。Glue 1.0 是建議大多數客戶使用的版本。如果未設定此值，Glue 相容性預設為 Glue 0.9。如需詳細資訊，請參閱開發人員指南中的 AWS Glue 版本。

• MaxCapacity – 數字 (雙位數)。

  為此轉換配置給工作執行的 AWS Glue 資料處理單元 (DPU) 數目。您可以分配從 2 到 100 個 DPU，預設值為 10。DPU 是相對的處理能力，包含 4 個 vCPU 的運算容量和 16 GB 的記憶體。如需詳細資訊，請參閱 AWS Glue 定價頁面。

  MaxCapacity 是 NumberOfWorkers 和 WorkerType 的互斥選項。

  • 如果設定 NumberOfWorkers 或 WorkerType，則無法設定 MaxCapacity。

  • 如果設定 MaxCapacity，則無法設定 NumberOfWorkers 或 WorkerType。

  • 如果設定 WorkerType，則 NumberOfWorkers 為必要 (反之亦然)。

  • MaxCapacity 和 NumberOfWorkers 都必須至少為 1。

  如果 WorkerType 欄位設成 Standard 以外的值，就會自動設定 MaxCapacity 欄位並且變成唯讀。

• WorkerType – UTF-8 字串 (有效值：Standard="" | G.1X="" | G.2X="" | G.025X="" | G.4X="" | G.8X="" | Z.2X="")。

  此轉換執行任務時所配置的預先定義工作者類型。可接受值為標準、G.1X 或 G.2X

  • 用於 Standard 工作者類型時，每個工作者提供 4 個 vCPU、16 GB 的記憶體和 50 GB 磁碟，以及每個工作者 2 個執行器。

  • 用於 G.1X 工作者類型時，每個工作者提供 4 個 vCPU、16 GB 的記憶體和 64 GB 磁碟，以及每個工作者 1 個執行器。

  • 用於 G.2X 工作者類型時，每個工作者提供 8 個 vCPU、32 GB 的記憶體和 128 GB 磁碟，以及每個工作者 1 個執行器。

  MaxCapacity 是 NumberOfWorkers 和 WorkerType 的互斥選項。

  • 如果設定 NumberOfWorkers 或 WorkerType，則無法設定 MaxCapacity。

  • 如果設定 MaxCapacity，則無法設定 NumberOfWorkers 或 WorkerType。

  • 如果設定 WorkerType，則 NumberOfWorkers 為必要 (反之亦然)。

  • MaxCapacity 和 NumberOfWorkers 都必須至少為 1。

• NumberOfWorkers – 數字 (整數)。

  轉換執行任務時所配置的已定義 workerType 工作者數量。

  如果設定 WorkerType，則 NumberOfWorkers 為必要 (反之亦然)。

• Timeout – 數字 (整數)，至少為 1。

  機器學習轉換的逾時，以分鐘計。

• MaxRetries – 數字 (整數)。

  機器學習轉換 MLTaskRun 失敗後的重試次數上限。

• TransformEncryption – TransformEncryption 物件。

  適用於存取使用者資料的轉換 encryption-at-rest 設定。機器學習轉換可以使用 KMS 存取 Amazon S3 中加密的使用者資料。

欄位

• PrimaryKeyColumnName – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 1024 個位元組，需符合 Single-line string pattern。

  唯一識別來源資料表中資料列的欄名。用於協助識別相符的記錄。

• PrecisionRecallTradeoff – 數字 (double)，不可大於 1.0。

  調校轉換以取得精確率與回收率平衡時所選取的值。值為 0.5 表示無偏好；值為 1.0 表示專門針對精確率的偏差；值為 0.0 表示針對回收率的偏差。因為這是一種權衡，選擇接近 1.0 的值表示非常低的回收率，選擇接近 0.0 的值則會得到非常低的精確率。

  精確率指標指出模型預測相符項目時的正確頻率。

  回收率指標表示針對實際比對，模型預測相符項目的頻率。

• AccuracyCostTradeoff – 數字 (double)，不可大於 1.0。

  調校轉換以取得準確性與成本平衡時所選取的值。值為 0.5 表示系統持平考量準確性與成本。值為 1.0 表示專門針對準確性的偏差，這通常會導致較高的成本，有時會非常高。值為 0.0 表示專門針對成本的偏差，這會導致低準確性的 FindMatches 轉換，有時是無法接受的準確性。

  Accuracy (準確性) 會測量轉換找到真肯定和真否定的效果有多好。提高正確性需要更多的機器資源和成本。但也會增加回收率。

  成本會測量執行轉換要消耗多少運算資源上，以此計算出金額。

• EnforceProvidedLabels – 布林值。

  值，開啟或關閉以強制輸出符合使用者提供的標籤。如果此值為 True，則 find matches 轉換會強制輸出符合提供的標籤。結果會覆寫正常的合併結果。如果此值為 False，則 find matches 轉換不確保遵守所有提供的標籤，結果會倚賴訓練過的模型。

  請注意，將此值設定為 true 可能會增加合併執行的時間。

欄位

• AreaUnderPRCurve – 數字 (double)，不可大於 1.0。

  在精確率/回收率曲線 (AUPRC) 下的區域是測量轉換整體品質的單一數字，與精確率與回收率的選擇無關。較高的值表示您有較具吸引力的精確率與回收率權衡。

  如需詳細資訊，請參閱 Wikipedia 中的 Precision and recall。

• Precision – 數字 (double)，不可大於 1.0。

  精確率指標指出轉換預測相符項目的正確頻率。尤其，它會測量轉換從真陽性總可能性中找出真陽性的效果有多好。

  如需詳細資訊，請參閱 Wikipedia 中的 Precision and recall。

• Recall – 數字 (double)，不可大於 1.0。

  回收率指標表示針對實際比對，轉換預測相符項目的頻率。尤其，它會測量轉換從來源資料總記錄中找出真陽性的效果有多好。

  如需詳細資訊，請參閱 Wikipedia 中的 Precision and recall。

• F1 – 數字 (double)，不可大於 1.0。

  F1 指標上限指出轉換的準確性介於 0 和 1 之間，其中 1 為最佳準確性。

  如需詳細資訊，請參閱 Wikipedia 中的 F1 score。

• ConfusionMatrix – ConfusionMatrix 物件。

  混淆矩陣會顯示轉換準確預測的內容及其產生的錯誤類型。

  如需詳細資訊，請參閱 Wikipedia 的 Confusion matrix。

• ColumnImportances – 一個 ColumnImportance 物件陣列，不可超過 100 個結構。

  ColumnImportance 結構的清單，包含欄重要性指標，依重要性遞減順序排序。

欄位

• NumTruePositives – 數字 (long)。

  在您轉換的混淆矩陣中，轉換在資料中正確找到的相符項目數量。

• NumFalsePositives – 數字 (long)。

  在您轉換的混淆矩陣中，轉換在資料中誤分類為相符項目的非相符項目數量。

• NumTrueNegatives – 數字 (long)。

  在您轉換的混淆矩陣中，轉換在資料中正確拒絕的非相符項目數量。

• NumFalseNegatives – 數字 (long)。

  在您轉換的混淆矩陣中，轉換在資料中沒找到的相符項目數量。

欄位

• DatabaseName – 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。

  AWS Glue Data Catalog中的資料庫名稱。

• TableName – 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。

  AWS Glue Data Catalog中的資料表名稱。

• CatalogId – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  AWS Glue Data Catalog的唯一識別符。

• ConnectionName – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  連至 AWS Glue Data Catalog的連線名稱。

• AdditionalOptions – 金鑰值對的映射陣列，不少於 1 對，也不可大於 10 對。

  每個金鑰都是 UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  每個值都是描述字串，長度不可超過 2048 個位元組，且需符合 URI address multi-line string pattern。

  資料表的其他選項。目前支援兩個金鑰：

  • pushDownPredicate：篩選分割區，而無需列出和讀取資料集中的所有檔案。

  • catalogPartitionPredicate：使用 AWS Glue Data Catalog中的分割區索引以進行伺服器端分割區清理。

欄位

• TransformId – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  轉換的唯一識別符。

• TaskRunId – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  此任務回合的唯一識別符。

• Status – UTF-8 字串 (有效值：STARTING | RUNNING | STOPPING | STOPPED | SUCCEEDED | FAILED | TIMEOUT)。

  請求任務回合目前的狀態。

• LogGroupName – UTF-8 字串。

  與此任務回合相關聯的安全記錄日誌群組名稱。

• Properties – TaskRun性質 物件。

  指定與此任務回合相關聯的組態屬性。

• ErrorString – UTF-8 字串。

  與此任務回合相關聯的錯誤字串清單。

• StartedOn – 時間戳記。

  此任務回合開始的日期和時間。

• LastModifiedOn – 時間戳記。

  請求任務回合上次更新的時間點。

• CompletedOn – 時間戳記。

  請求任務回合上次完成的時間點。

• ExecutionTime – 數字 (整數)。

  任務執行消耗資源所需的時間 (以秒為單位)。

欄位

• Name – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  用來篩選機器學習轉換的唯一轉換名稱。

• TransformType – UTF-8 字串 (有效值：FIND_MATCHES)。

  用來篩選機器學習轉換的機器學習轉換類型。

• Status – UTF-8 字串 (有效值：NOT_READY | READY | DELETING)。

  依轉換的上次已知狀態篩選機器學習轉換清單 (以指出轉換是否可用)。"NOT_READY (未就緒)"、"READY (就緒)" 或 "DELETING (正在刪除)" 其中之一。

• GlueVersion – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Custom string pattern #20。

  此值決定 AWS Glue 此機器學習轉換與哪個版本相容。Glue 1.0 是建議大多數客戶使用的版本。如果未設定此值，Glue 相容性預設為 Glue 0.9。如需詳細資訊，請參閱開發人員指南中的 AWS Glue 版本。

• CreatedBefore – 時間戳記。

  轉換建立前的時間和日期。

• CreatedAfter – 時間戳記。

  轉換建立後的時間和日期。

• LastModifiedBefore – 時間戳記。

  篩選出上次修改在此日期前的轉換。

• LastModifiedAfter – 時間戳記。

  篩選出上次修改在此日期後的轉換。

• Schema – 一個 SchemaColumn 物件陣列，不可超過 100 個結構。

  篩選出具有特定結構描述的資料集。Map<Column, Type> 物件是一個鍵/值對陣列，代表此轉換接受的結構描述，其中 Column 是欄的名稱，Type 是資料類型，例如整數或字串。已有 100 個欄的上限。

欄位

• Column – 必要：UTF-8 字串 (有效值：NAME | TRANSFORM_TYPE | STATUS | CREATED | LAST_MODIFIED)。

  要用在與機器學習轉換相關聯之排序條件中的欄。

• SortDirection – 必要：UTF-8 字串 (有效值：DESCENDING | ASCENDING)。

  要用在與機器學習轉換相關聯之排序條件中的排序方向。

欄位

• TaskRunType – UTF-8 字串 (有效值：EVALUATION | LABELING_SET_GENERATION | IMPORT_LABELS | EXPORT_LABELS | FIND_MATCHES)。

  執行的任務類型。

• Status – UTF-8 字串 (有效值：STARTING | RUNNING | STOPPING | STOPPED | SUCCEEDED | FAILED | TIMEOUT)。

  所執行任務目前的狀態。

• StartedBefore – 時間戳記。

  篩選出在此日期前開始的任務回合。

• StartedAfter – 時間戳記。

  篩選出在此日期後開始的任務回合。

欄位

• Column – 必要：UTF-8 字串 (有效值：TASK_RUN_TYPE | STATUS | STARTED)。

  用來排序機器學習轉換任務回合清單的欄。

• SortDirection – 必要：UTF-8 字串 (有效值：DESCENDING | ASCENDING)。

  用來排序機器學習轉換任務回合清單的排序方向。

欄位

• TaskType – UTF-8 字串 (有效值：EVALUATION | LABELING_SET_GENERATION | IMPORT_LABELS | EXPORT_LABELS | FIND_MATCHES)。

  執行的任務類型。

• ImportLabelsTaskRunProperties – ImportLabelsTaskRun性質 物件。

  匯入標籤任務回合的組態屬性。

• ExportLabelsTaskRunProperties – ExportLabelsTaskRun性質 物件。

  匯出標籤任務回合的組態屬性。

• LabelingSetGenerationTaskRunProperties – LabelingSetGenerationTaskRunProperties 物件。

  標籤集產生任務回合的組態屬性。

• FindMatchesTaskRunProperties – FindMatchesTaskRun性質 物件。

  Find Matches 任務回合的組態屬性。

欄位

• JobId – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  Find Matches 任務回合的任務 ID。

• JobName – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  指派給 Find Matches 任務回合任務的名稱。

• JobRunId – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  Find Matches 任務回合的任務回合 ID。

欄位

• InputS3Path – UTF-8 字串。

  Amazon Simple Storage Service (Amazon S3) 路徑，您會由此匯入標籤。

• Replace – 布林值。

  指出是否覆寫現有的標籤。

欄位

• OutputS3Path – UTF-8 字串。

  Amazon Simple Storage Service (Amazon S3) 路徑，您會由此匯出標籤。

欄位

• OutputS3Path – UTF-8 字串。

  Amazon Simple Storage Service (Amazon S3) 路徑，您會在此產生標籤集。

欄位

• Name – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 1024 個位元組，需符合 Single-line string pattern。

  欄位的名稱。

• DataType – UTF-8 字串，長度不可超過 131072 個位元組，需符合Single-line string pattern。

  欄中的資料類型。

欄位

• MlUserDataEncryption – ML UserData 加密 物件。

  包含加密模式和客戶提供的 KMS 金鑰 ID 的 MLUserDataEncryption 物件。

• TaskRunSecurityConfigurationName – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  安全組態的名稱。

欄位

• MlUserDataEncryptionMode – 必要：UTF-8 字串 (有效值：DISABLED | SSE-KMS="SSEKMS")。

  套用至使用者資料的加密模式。有效的 值如下：

  • DISABLED：已停用加密

  • SSEKMS：針對存放在 Amazon S3 中的使用者資料，使用伺服器端加密搭配 AWS Key Management Service (SSE-KMS)。

• KmsKeyId – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  客戶提供的 KMS 金鑰的 ID。

欄位

• ColumnName – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  欄的名稱。

• Importance – 數字 (double)，不可大於 1.0。

  欄的欄重要性分數 (以十進位形式)。

• CreateMLTransform 動作 (Python: create_ml_transform)

• UpdateMLTransform 動作 (Python: update_ml_transform)

• DeleteMLTransform 動作 (Python: delete_ml_transform)

• GetMLTransform 動作 (Python: get_ml_transform)

• GetMLTransforms 動作 (Python: get_ml_transforms)

• ListMLTransforms 動作 (Python: list_ml_transforms)

• 啟EvaluationTaskRun 動 ML 操作（Python：開始計算任務運行）

• 啟LabelingSetGenerationTaskRun 動 ML 動作 (Python: 啟動 _ 標籤化 _ 設定產生 _ 任務執行)

• 獲取 ML TaskRun 操作（Python：運行）

• 獲取 ML TaskRuns 操作（Python：運行）

• 取消毫升TaskRun 操作（Python：取消任務運行）

• StartExportLabelsTaskRun 操作（Python：開始 _ 導出 _ 標籤 _ 任務 _ 運行）

• StartImportLabelsTaskRun 操作（Python：開始導入標籤任務運行）

請求

• Name – 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。

  建立轉換時給予它的唯一名稱。

• Description – 描述字串，長度不可超過 2048 個位元組，需符合URI address multi-line string pattern。

  正在定義的機器學習轉換描述。預設為空字串。

• InputRecordTables – 必要：一個 GlueTable 物件陣列，不可超過 10 個結構。

  轉換所使用的 AWS Glue 資料表定義清單。

• Parameters – 必要：TransformParameters 物件。

  所用轉換類型的專屬演算法參數。條件性相依於轉換類型。

• Role – 必要：UTF-8 字串。

  IAM 角色的名稱或 Amazon Resource Name (ARN) 與所需的許可。所需許可包括 AWS Glue 資源的 AWS Glue 服務角色許可，以及轉換所需的 Amazon S3 許可。

  • 此角色需要 AWS Glue 服務角色權限才能允許存取中的資源 AWS Glue。請參閱連接政策到存取 AWS Glue的 IAM 使用者。

  • 此角色需要此轉換任務回合所用的 Amazon Simple Storage Service (Amazon S3) 來源、目標、暫時目錄、指令碼和任何程式庫的許可。

• GlueVersion – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Custom string pattern #20。

  此值決定 AWS Glue 此機器學習轉換與哪個版本相容。Glue 1.0 是建議大多數客戶使用的版本。如果未設定此值，Glue 相容性預設為 Glue 0.9。如需詳細資訊，請參閱開發人員指南中的 AWS Glue 版本。

• MaxCapacity – 數字 (雙位數)。

  為此轉換配置給工作執行的 AWS Glue 資料處理單元 (DPU) 數目。您可以分配從 2 到 100 個 DPU，預設值為 10。DPU 是相對的處理能力，包含 4 個 vCPU 的運算容量和 16 GB 的記憶體。如需詳細資訊，請參閱 AWS Glue 定價頁面。

  MaxCapacity 是 NumberOfWorkers 和 WorkerType 的互斥選項。

  • 如果設定 NumberOfWorkers 或 WorkerType，則無法設定 MaxCapacity。

  • 如果設定 MaxCapacity，則無法設定 NumberOfWorkers 或 WorkerType。

  • 如果設定 WorkerType，則 NumberOfWorkers 為必要 (反之亦然)。

  • MaxCapacity 和 NumberOfWorkers 都必須至少為 1。

  如果 WorkerType 欄位設成 Standard 以外的值，就會自動設定 MaxCapacity 欄位並且變成唯讀。

  如果 WorkerType 欄位設成 Standard 以外的值，就會自動設定 MaxCapacity 欄位並且變成唯讀。

• WorkerType – UTF-8 字串 (有效值：Standard="" | G.1X="" | G.2X="" | G.025X="" | G.4X="" | G.8X="" | Z.2X="")。

  執行此任務時所配置的預先定義工作者類型。可接受值為標準、G.1X 或 G.2X

  • 用於 Standard 工作者類型時，每個工作者提供 4 個 vCPU、16 GB 的記憶體和 50 GB 磁碟，以及每個工作者 2 個執行器。

  • 用於 G.1X 工作者類型時，每個工作者提供 4 個 vCPU、16 GB 的記憶體和 64 GB 磁碟，以及每個工作者 1 個執行器。

  • 用於 G.2X 工作者類型時，每個工作者提供 8 個 vCPU、32 GB 的記憶體和 128 GB 磁碟，以及每個工作者 1 個執行器。

  MaxCapacity 是 NumberOfWorkers 和 WorkerType 的互斥選項。

  • 如果設定 NumberOfWorkers 或 WorkerType，則無法設定 MaxCapacity。

  • 如果設定 MaxCapacity，則無法設定 NumberOfWorkers 或 WorkerType。

  • 如果設定 WorkerType，則 NumberOfWorkers 為必要 (反之亦然)。

  • MaxCapacity 和 NumberOfWorkers 都必須至少為 1。

• NumberOfWorkers – 數字 (整數)。

  執行此任務時所配置的已定義 workerType 工作者數目。

  如果設定 WorkerType，則 NumberOfWorkers 為必要 (反之亦然)。

• Timeout – 數字 (整數)，至少為 1。

  此轉換任務回合的逾時，以分鐘計。這是此轉換任務回合在終止並進入 TIMEOUT 狀態前，可取用資源的最長時間。預設值為 2,880 分鐘 (48 小時)。

• MaxRetries – 數字 (整數)。

  任務回合失敗後，此轉換任務可重試的次數上限。

• Tags – 金鑰值對的對應陣列，不超過 50 對。

  每個金鑰均為 UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。

  每個值都是 UTF-8 字串，長度不可超過 256 個位元組。

  與此機器學習轉換搭配使用的標籤。您可以使用標籤來限制對機器學習轉換的存取情況。如需中標籤的詳細資訊 AWS Glue，請參閱開發人員指南AWS Glue中的「AWS 標籤」。

• TransformEncryption – TransformEncryption 物件。

  適用於存取使用者資料的轉換 encryption-at-rest 設定。機器學習轉換可以使用 KMS 存取 Amazon S3 中加密的使用者資料。

回應

• TransformId – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  針對轉換產生的唯一識別符。

錯誤

• AlreadyExistsException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

• AccessDeniedException

• ResourceNumberLimitExceededException

• IdempotentParameterMismatchException

請求

• TransformId – 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。

  建立轉換時所產生的唯一識別符。

• Name – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  建立轉換時授予它的唯一名稱。

• Description – 描述字串，長度不可超過 2048 個位元組，需符合URI address multi-line string pattern。

  轉換的描述。預設為空字串。

• Parameters – TransformParameters 物件。

  所用轉換類型 (演算法) 的專屬組態參數。條件性相依於轉換類型。

• Role – UTF-8 字串。

  IAM 角色的名稱或 Amazon Resource Name (ARN) 與所需的許可。

• GlueVersion – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Custom string pattern #20。

  此值決定 AWS Glue 此機器學習轉換與哪個版本相容。Glue 1.0 是建議大多數客戶使用的版本。如果未設定此值，Glue 相容性預設為 Glue 0.9。如需詳細資訊，請參閱開發人員指南中的 AWS Glue 版本。

• MaxCapacity – 數字 (雙位數)。

  為此轉換配置給工作執行的 AWS Glue 資料處理單元 (DPU) 數目。您可以分配從 2 到 100 個 DPU，預設值為 10。DPU 是相對的處理能力，包含 4 個 vCPU 的運算容量和 16 GB 的記憶體。如需詳細資訊，請參閱 AWS Glue 定價頁面。

  如果 WorkerType 欄位設成 Standard 以外的值，就會自動設定 MaxCapacity 欄位並且變成唯讀。

• WorkerType – UTF-8 字串 (有效值：Standard="" | G.1X="" | G.2X="" | G.025X="" | G.4X="" | G.8X="" | Z.2X="")。

  執行此任務時所配置的預先定義工作者類型。可接受值為標準、G.1X 或 G.2X

  • 用於 Standard 工作者類型時，每個工作者提供 4 個 vCPU、16 GB 的記憶體和 50 GB 磁碟，以及每個工作者 2 個執行器。

  • 用於 G.1X 工作者類型時，每個工作者提供 4 個 vCPU、16 GB 的記憶體和 64 GB 磁碟，以及每個工作者 1 個執行器。

  • 用於 G.2X 工作者類型時，每個工作者提供 8 個 vCPU、32 GB 的記憶體和 128 GB 磁碟，以及每個工作者 1 個執行器。

• NumberOfWorkers – 數字 (整數)。

  執行此任務時所配置的已定義 workerType 工作者數目。

• Timeout – 數字 (整數)，至少為 1。

  此轉換任務回合的逾時，以分鐘計。這是此轉換任務回合在終止並進入 TIMEOUT 狀態前，可取用資源的最長時間。預設值為 2,880 分鐘 (48 小時)。

• MaxRetries – 數字 (整數)。

  任務回合失敗後，此轉換任務可重試的次數上限。

回應

• TransformId – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  已更新的轉換唯一識別符。

錯誤

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

• AccessDeniedException

請求

• TransformId – 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。

  要刪除轉換的唯一識別符。

回應

• TransformId – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  已刪除轉換的唯一識別符。

錯誤

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

請求

• TransformId – 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。

  轉換的唯一識別符，於建立轉換時產生。

回應

• TransformId – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  轉換的唯一識別符，於建立轉換時產生。

• Name – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  建立轉換時授予它的唯一名稱。

• Description – 描述字串，長度不可超過 2048 個位元組，需符合URI address multi-line string pattern。

  轉換的描述。

• Status – UTF-8 字串 (有效值：NOT_READY | READY | DELETING)。

  轉換的上次已知狀態 (指出其是否可用)。"NOT_READY (未就緒)"、"READY (就緒)" 或 "DELETING (正在刪除)" 其中之一。

• CreatedOn – 時間戳記。

  建立轉換的日期和時間。

• LastModifiedOn – 時間戳記。

  轉換上次修改的日期和時間。

• InputRecordTables – 一個 GlueTable 物件陣列，不可超過 10 個結構。

  轉換所使用的 AWS Glue 資料表定義清單。

• Parameters – TransformParameters 物件。

  所用演算法的專屬組態參數。

• EvaluationMetrics – EvaluationMetrics 物件。

  最新的評估指標。

• LabelCount – 數字 (整數)。

  此轉換可用的標籤數量。

• Schema – 一個 SchemaColumn 物件陣列，不可超過 100 個結構。

  Map<Column, Type> 物件，代表此轉換接受的結構描述。已有 100 個欄的上限。

• Role – UTF-8 字串。

  IAM 角色的名稱或 Amazon Resource Name (ARN) 與所需的許可。

• GlueVersion – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Custom string pattern #20。

  此值決定 AWS Glue 此機器學習轉換與哪個版本相容。Glue 1.0 是建議大多數客戶使用的版本。如果未設定此值，Glue 相容性預設為 Glue 0.9。如需詳細資訊，請參閱開發人員指南中的 AWS Glue 版本。

• MaxCapacity – 數字 (雙位數)。

  為此轉換配置給工作執行的 AWS Glue 資料處理單元 (DPU) 數目。您可以分配從 2 到 100 個 DPU，預設值為 10。DPU 是相對的處理能力，包含 4 個 vCPU 的運算容量和 16 GB 的記憶體。如需詳細資訊，請參閱 AWS Glue 定價頁面。

  如果 WorkerType 欄位設成 Standard 以外的值，就會自動設定 MaxCapacity 欄位並且變成唯讀。

• WorkerType – UTF-8 字串 (有效值：Standard="" | G.1X="" | G.2X="" | G.025X="" | G.4X="" | G.8X="" | Z.2X="")。

  執行此任務時所配置的預先定義工作者類型。可接受值為標準、G.1X 或 G.2X

  • 用於 Standard 工作者類型時，每個工作者提供 4 個 vCPU、16 GB 的記憶體和 50 GB 磁碟，以及每個工作者 2 個執行器。

  • 用於 G.1X 工作者類型時，每個工作者提供 4 個 vCPU、16 GB 的記憶體和 64 GB 磁碟，以及每個工作者 1 個執行器。

  • 用於 G.2X 工作者類型時，每個工作者提供 8 個 vCPU、32 GB 的記憶體和 128 GB 磁碟，以及每個工作者 1 個執行器。

• NumberOfWorkers – 數字 (整數)。

  執行此任務時所配置的已定義 workerType 工作者數目。

• Timeout – 數字 (整數)，至少為 1。

  此轉換任務回合的逾時，以分鐘計。這是此轉換任務回合在終止並進入 TIMEOUT 狀態前，可取用資源的最長時間。預設值為 2,880 分鐘 (48 小時)。

• MaxRetries – 數字 (整數)。

  任務回合失敗後，此轉換任務可重試的次數上限。

• TransformEncryption – TransformEncryption 物件。

  適用於存取使用者資料的轉換 encryption-at-rest 設定。機器學習轉換可以使用 KMS 存取 Amazon S3 中加密的使用者資料。

錯誤

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

請求

• NextToken – UTF-8 字串。

  位移結果的分頁字符。

• MaxResults – 數字 (整數)，不可小於 1，也不可以大於 1000。

  回傳結果的數量上限。

• Filter – TransformFilter标准 物件。

  篩選轉換條件。

• Sort – TransformSort标准 物件。

  排序條件。

回應

• Transforms – 必要：一個 MLTransform 物件。

  機器學習轉換清單。

• NextToken – UTF-8 字串。

  如有多個結果可用，即為分頁字符。

錯誤

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

請求

• NextToken – UTF-8 字串。

  接續符記，如果這是接續要求。

• MaxResults – 數字 (整數)，不可小於 1，也不可以大於 1000。

  所要回傳清單的大小上限。

• Filter – TransformFilter标准 物件。

  TransformFilterCriteria 會用來篩選機器學習轉換。

• Sort – TransformSort标准 物件。

  TransformSortCriteria 會用來排序機器學習轉換。

• Tags – 金鑰值對的對應陣列，不超過 50 對。

  每個金鑰均為 UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。

  每個值都是 UTF-8 字串，長度不可超過 256 個位元組。

  指定只傳回包含這些標籤的資源。

回應

• TransformIds – 必要：UTF-8 字串陣列。

  帳戶中所有機器學習轉換的識別符，或包含指定標籤的機器學習轉換。

• NextToken – UTF-8 字串。

  接續字元，如果傳回的清單未包含最後一個可用指標。

錯誤

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

請求

• TransformId – 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。

  機器學習轉換的唯一識別符。

回應

• TaskRunId – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  與此回合相關聯的唯一識別符。

錯誤

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

• ConcurrentRunsExceededException

• MLTransformNotReadyException

請求

• TransformId – 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。

  機器學習轉換的唯一識別符。

• OutputS3Path – 必要：UTF-8 字串。

  Amazon Simple Storage Service (Amazon S3) 路徑，您會在此產生標籤集。

回應

• TaskRunId – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  與此任務回合相關聯的唯一回合識別符。

錯誤

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

• ConcurrentRunsExceededException

請求

• TransformId – 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。

  機器學習轉換的唯一識別符。

• TaskRunId – 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。

  任務回合的唯一識別符。

回應

• TransformId – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  任務回合的唯一識別符。

• TaskRunId – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  與此回合相關聯的唯一回合識別符。

• Status – UTF-8 字串 (有效值：STARTING | RUNNING | STOPPING | STOPPED | SUCCEEDED | FAILED | TIMEOUT)。

  此任務回合的狀態。

• LogGroupName – UTF-8 字串。

  與此任務回合相關聯的日誌群組名稱。

• Properties – TaskRun性質 物件。

  與任務回合相關聯的屬性清單。

• ErrorString – UTF-8 字串。

  與任務回合相關聯的錯誤字串。

• StartedOn – 時間戳記。

  此任務回合開始的日期和時間。

• LastModifiedOn – 時間戳記。

  此任務回合上次修改的日期和時間。

• CompletedOn – 時間戳記。

  此任務回合完成的日期和時間。

• ExecutionTime – 數字 (整數)。

  任務執行消耗資源所需的時間 (以秒為單位)。

錯誤

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

請求

• TransformId – 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。

  機器學習轉換的唯一識別符。

• NextToken – UTF-8 字串。

  結果的分頁字符。預設值為空白。

• MaxResults – 數字 (整數)，不可小於 1，也不可以大於 1000。

  回傳結果的數量上限。

• Filter – TaskRunFilterCriteria 物件。

  任務回合的篩選條件，結構為 TaskRunFilterCriteria。

• Sort – TaskRunSortCriteria 物件。

  任務回合的排序條件，結構為 TaskRunSortCriteria。

回應

• TaskRuns – 一個 TaskRun 物件陣列。

  與轉換相關聯的任務回合清單。

• NextToken – UTF-8 字串。

  如有多個結果可用，即為分頁字符。

錯誤

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

請求

• TransformId – 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。

  機器學習轉換的唯一識別符。

• TaskRunId – 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。

  所執行任務的唯一識別符。

回應

• TransformId – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  機器學習轉換的唯一識別符。

• TaskRunId – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  所執行任務的唯一識別符。

• Status – UTF-8 字串 (有效值：STARTING | RUNNING | STOPPING | STOPPED | SUCCEEDED | FAILED | TIMEOUT)。

  此回合的狀態。

錯誤

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

請求

• TransformId – 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。

  機器學習轉換的唯一識別符。

• OutputS3Path – 必要：UTF-8 字串。

  標籤匯出的目標 Amazon S3 路徑。

回應

• TaskRunId – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  所執行任務的唯一識別符。

錯誤

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

請求

• TransformId – 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。

  機器學習轉換的唯一識別符。

• InputS3Path – 必要：UTF-8 字串。

  Amazon Simple Storage Service (Amazon S3) 路徑，您會由此匯入標籤。

• ReplaceAllLabels – 布林值。

  指出是否覆寫現有的標籤。

回應

• TaskRunId – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。

  所執行任務的唯一識別符。

錯誤

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• ResourceNumberLimitExceededException

• InternalServiceException