CreateDataDeletionJob - Amazon Personalize
請求語法請求參數回應語法回應元素錯誤另請參閱

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

CreateDataDeletionJob

建立批次任務，以批次刪除 Amazon Personalize 資料集群組中特定使用者的所有參考。您可以在 Amazon S3 儲存貯體中的使用者 ID 的 CSV 檔案中指定要刪除的使用者。任務完成後，Amazon Personalize 不再對使用者的資料進行訓練，而且在產生使用者區段時也不會再考慮使用者。如需有關建立資料刪除工作的詳細資訊，請參閱刪除使用者。

  • 您的輸入檔案必須是含有單一 USER_ID 欄的 CSV 檔案，其中會列出使用者識別碼。如需有關準備 CSV 檔案的詳細資訊，請參閱準備資料刪除檔案並將其上傳到 Amazon S3。

  • 若要授與 Amazon Personalize 存取使用者 ID 輸入 CSV 檔案的權限，您必須指定具有從資料來源讀取權限的 IAM 服務角色。此角色需要值區GetObject及其內容的ListBucket權限。這些權限與匯入資料相同。如需授與 Amazon S3 儲存貯體存取權的相關資訊，請參閱授予 Amazon Personalize 存取 Amazon S3 資源。

建立工作後，最多可能需要一天的時間才能從資料集和模型中刪除對使用者的所有參照。在任務完成之前，Amazon Personalize 會在訓練時繼續使用這些資料。如果您使用「使用者細分」方案，則使用者可能會出現在使用者區段中。

狀態

資料刪除工作可能具有下列其中一種狀態：

  • 「擱置中」>「進行中」>「已完成」或「失敗」

若要取得資料刪除任務的狀態，請呼叫 DescribeDataDeletionJobAPI 操作並指定任務的 Amazon 資源名稱 (ARN)。如果狀態為「失敗」，則回應會包含failureReason索引鍵，說明工作失敗的原因。

相關 API

請求語法

{
   "datasetGroupArn": "string",
   "dataSource": { 
      "dataLocation": "string"
   },
   "jobName": "string",
   "roleArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}

請求參數

請求接受採用 JSON 格式的下列資料。

datasetGroupArn

具有要從中刪除記錄的資料集之資料集群組的 Amazon 資源名稱 (ARN)。

類型：字串

長度限制：長度上限為 256。

模式：arn:([a-z\d-]+):personalize:.*:.*:.+

必要：是

dataSource

包含要刪除之使用者的使用者 ID 清單的 Amazon S3 儲存貯體。

類型：DataSource 物件

必要：是

jobName

資料刪除工作的名稱。

類型：字串

長度限制：長度下限為 1。長度上限為 63。

模式：^[a-zA-Z0-9][a-zA-Z0-9\-_]*

必要：是

roleArn

IAM 角色的亞馬遜資源名稱 (ARN)，該角色具有從 Amazon S3 資料來源讀取的許可。

類型：字串

長度限制：長度上限為 256。

模式：arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+

必要：是

tags

要套用至資料刪除工作的標籤清單。

類型：Tag 物件陣列

陣列成員：項目數下限為 0。項目數上限為 200。

必要：否

回應語法

{
   "dataDeletionJobArn": "string"
}

回應元素

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

dataDeletionJobArn

資料刪除任務的 Amazon 資源名稱 (ARN)。

類型：字串

長度限制：長度上限為 256。

模式：arn:([a-z\d-]+):personalize:.*:.*:.+

錯誤

InvalidInputException

提供欄位或參數的有效值。

HTTP 狀態碼：400

LimitExceededException

已超過每秒要求數目的限制。

HTTP 狀態碼：400

ResourceAlreadyExistsException

指定的資源已存在。

HTTP 狀態碼：400

ResourceInUseException

指定的資源正在使用中。

HTTP 狀態碼：400

ResourceNotFoundException

找不到指定的資源。

HTTP 狀態碼：400

TooManyTagsException

您已超過可套用至此資源的標籤數目上限。

HTTP 狀態碼：400

另請參閱

如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊，請參閱下列內容：