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 lotes 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 de UserIDs em um bucket do Amazon S3. Depois que um trabalho é concluído, o Amazon Personalize não treina mais nos dados dos usuários e não considera mais os usuários ao gerar segmentos de usuários. Para obter mais informações sobre a criação de um trabalho de exclusão de dados, consulte Excluindo usuários.
-
Seu arquivo de entrada deve ser um arquivo CSV com uma única coluna USER_ID que lista os IDs dos usuários. Para obter mais informações sobre como preparar o arquivo CSV, consulte Como preparar seu arquivo de exclusão de dados e enviá-lo para o Amazon S3.
-
Para dar permissão ao Amazon Personalize para acessar seu arquivo CSV de entrada de UserIDs, você deve especificar uma função de serviço do IAM que tenha permissão para ler a partir da fonte de dados. Essa função precisa
GetObject
e temListBucket
permissões para 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 de criar um trabalho, pode 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 receita de segmentação de usuários, os usuários podem aparecer em segmentos de usuários.
Status
Um trabalho de exclusão de dados pode ter um dos seguintes status:
-
PENDENTE > IN_PROGRESS > CONCLUÍDO -ou- FALHOU
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 failureReason
chave que descreve por que o trabalho falhou.
APIs relacionadas
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 Amazon Resource Name (ARN) do grupo de conjuntos de dados que tem os conjuntos de dados dos quais você deseja excluir registros.
Tipo: sequência
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 IDs de usuário dos usuários a serem excluídos.
Tipo: objeto DataSource
Obrigatório: Sim
- jobName
-
O nome do trabalho de exclusão de dados.
Tipo: sequência
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 Amazon Resource Name (ARN) da função do IAM que tem permissões para ler a partir da fonte de dados do Amazon S3.
Tipo: sequência
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.
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 Amazon Resource Name (ARN) do trabalho de exclusão de dados.
Tipo: sequência
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 um dos AWS SDKs específicos da linguagem, consulte o seguinte: