本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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
索引鍵,說明工作失敗的原因。
請求語法
{
"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+=,.@\-_/]+
必要:是
-
要套用至資料刪除工作的標籤清單。
類型: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 的詳細資訊,請參閱下列內容: