As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
CreateDataDeletionJob
Cria um trabalho em lote que exclui todas as referências a usuários específicos de um grupo de conjuntos de dados do Amazon Personalize em lotes. Você especifica os usuários a serem excluídos em um arquivo CSV com os UserIDs em um bucket do Amazon S3. Depois da conclusão de um trabalho, o Amazon Personalize deixa de treinar seus dados e não considera mais os usuários ao gerar os segmentos. Para obter mais informações sobre criar um trabalho de exclusão de dados, consulte Excluir usuários.
-
Seu arquivo de entrada deve ser um arquivo CSV com uma única coluna USER_ID que lista os usuários. IDs Para obter mais informações sobre como preparar o arquivo CSV, consulte Preparar seu arquivo de exclusão de dados e enviá-lo para o Amazon S3.
-
Para permitir o Amazon Personalize para acessar seu arquivo CSV de entrada com UserIDs, você deve especificar um perfil de serviço do IAM que tenha permissão para ler a fonte de dados. Esse perfil precisa de permissões de
GetObjecteListBucketpara o bucket e seu conteúdo. Essas permissões são iguais às da importação de dados. Para obter informações sobre como conceder acesso ao bucket do Amazon S3, consulte Conceder ao Amazon Personalize acesso aos recursos do Amazon S3.
Depois que você criar um trabalho, poderá levar até um dia para excluir todas as referências aos usuários dos conjuntos de dados e modelos. Até que o trabalho seja concluído, o Amazon Personalize continua usando os dados durante o treinamento. E se você usar uma fórmula de segmentação de usuários, eles podem aparecer em segmentos de usuários.
Status
Um trabalho de exclusão de dados pode ter um dos seguintes status:
-
PENDENTE > EM ANDAMENTO > CONCLUÍDO -ou- FALHA
Para obter o status do trabalho de exclusão de dados, chame a operação DescribeDataDeletionJobda API e especifique o Amazon Resource Name (ARN) do trabalho. Se o status for Falha, a resposta incluirá uma chave failureReason que descreve por que o trabalho falhou.
Relacionado APIs
Sintaxe da Solicitação
{
"datasetGroupArn": "string",
"dataSource": {
"dataLocation": "string"
},
"jobName": "string",
"roleArn": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}Parâmetros da solicitação
A solicitação aceita os dados a seguir no formato JSON.
- datasetGroupArn
-
O nome do recurso da Amazon (ARN) do grupo do conjunto de dados que tem os conjuntos contendo os registros que você quer excluir.
Tipo: string
Restrições de tamanho: o tamanho máximo é 256.
Padrão:
arn:([a-z\d-]+):personalize:.*:.*:.+Exigido: Sim
- dataSource
-
O bucket do Amazon S3 que contém a lista de UserIDs a serem excluídos.
Tipo: objeto DataSource
Obrigatório: sim
- jobName
-
O nome do trabalho de exclusão de dados.
Tipo: string
Restrições de tamanho: o tamanho mínimo é 1. O tamanho máximo é 63.
Padrão:
^[a-zA-Z0-9][a-zA-Z0-9\-_]*Exigido: Sim
- roleArn
-
O nome do recurso da Amazon (ARN) do perfil do IAM que tem permissão para ler a fonte de dados do Amazon S3.
Tipo: string
Restrições de tamanho: o tamanho máximo é 256.
Padrão:
arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+Exigido: Sim
-
Uma lista de tags a serem aplicadas ao trabalho de exclusão de dados do conjunto de dados.
Tipo: matriz de objetos Tag
Membros da Matriz: número mínimo de 0 itens. Número máximo de 200 itens.
Obrigatório: não
Sintaxe da Resposta
{
"dataDeletionJobArn": "string"
}Elementos de Resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
- dataDeletionJobArn
-
O nome do recurso da Amazon (ARN) do trabalho de exclusão de dados.
Tipo: string
Restrições de tamanho: o tamanho máximo é 256.
Padrão:
arn:([a-z\d-]+):personalize:.*:.*:.+
Erros
- InvalidInputException
-
Forneça um valor válido para o campo ou parâmetro.
Código de status HTTP: 400
- LimitExceededException
-
O limite de número de solicitações por segundo foi excedido.
Código de status HTTP: 400
- ResourceAlreadyExistsException
-
O recurso especificado já existe.
Código de status HTTP: 400
- ResourceInUseException
-
O recurso especificado está em uso.
Código de status HTTP: 400
- ResourceNotFoundException
-
Não foi possível encontrar o recurso especificado.
Código de status HTTP: 400
- TooManyTagsException
-
Você excedeu o número máximo de tags que pode aplicar a esse recurso.
Código de Status HTTP: 400
Consulte Também
Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
