Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
CreateDataDeletionJob
Crea un trabajo por lotes que elimina todas las referencias a usuarios específicos de un grupo de conjuntos de datos de Amazon Personalize en lotes. Los usuarios que se van a eliminar se especifican en un archivo CSV de ID de usuario en un bucket de Amazon S3. Una vez finalizado un trabajo, Amazon Personalize ya no utiliza los datos de los usuarios y deja de tener en cuenta a los usuarios a la hora de generar segmentos de usuarios. Para obtener más información sobre cómo crear un trabajo de eliminación de datos, consulte Eliminar usuarios.
-
El archivo de entrada debe ser un archivo CSV con una sola columna USER_ID que muestre los ID de los usuarios. Para obtener más información sobre cómo preparar el archivo CSV, consulte Preparar el archivo de eliminación de datos y cargarlo en Amazon S3.
-
Para conceder permiso a Amazon Personalize para acceder a su archivo CSV de entrada de ID de usuario, debe especificar un rol de servicio de IAM que tenga permiso para leer la fuente de datos. Este rol necesita
GetObjectListBucketpermisos para el bucket y su contenido. Estos permisos son los mismos que los de importación de datos. Para obtener información sobre cómo conceder acceso a su bucket de Amazon S3, consulte Concesión de acceso a los recursos de Amazon S3 para Amazon Personalize.
Tras crear un trabajo, se puede tardar hasta un día en eliminar todas las referencias a los usuarios de los conjuntos de datos y modelos. Hasta que finalice el trabajo, Amazon Personalize seguirá utilizando los datos durante el entrenamiento. Y si utiliza una receta de segmentación de usuarios, es posible que los usuarios aparezcan en segmentos de usuarios.
Status
Un trabajo de eliminación de datos puede tener uno de los siguientes estados:
-
PENDIENTE > EN CURSO > COMPLETADO O FALLIDO
Para obtener el estado del trabajo de eliminación de datos, llame a DescribeDataDeletionJobAPI operation y especifique el nombre de recurso de Amazon (ARN) del trabajo. Si el estado es FALLIDO, la respuesta incluye una failureReason clave que describe el motivo del error en el trabajo.
API relacionadas
Sintaxis de la solicitud
{
"datasetGroupArn": "string",
"dataSource": {
"dataLocation": "string"
},
"jobName": "string",
"roleArn": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}Parámetros de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- datasetGroupArn
-
El nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos que contiene los conjuntos de datos de los que desea eliminar registros.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
Patrón:
arn:([a-z\d-]+):personalize:.*:.*:.+Obligatorio: sí
- dataSource
-
El bucket de Amazon S3 que contiene la lista de ID de usuario de los usuarios que se van a eliminar.
Tipo: objeto DataSource
Obligatorio: sí
- jobName
-
El nombre del trabajo de eliminación de datos.
Tipo: string
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.
Patrón:
^[a-zA-Z0-9][a-zA-Z0-9\-_]*Obligatorio: sí
- roleArn
-
El nombre del recurso de Amazon (ARN) del rol de IAM que tiene permisos para leer desde la fuente de datos de Amazon S3.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
Patrón:
arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+Obligatorio: sí
-
Una lista de etiquetas para aplicar al trabajo de eliminación de datos.
Tipo: matriz de objetos Tag
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.
Obligatorio: no
Sintaxis de la respuesta
{
"dataDeletionJobArn": "string"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- dataDeletionJobArn
-
El nombre del recurso de Amazon (ARN) del trabajo de eliminación de datos.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
Patrón:
arn:([a-z\d-]+):personalize:.*:.*:.+
Errores
- InvalidInputException
-
Proporcione un valor válido para el campo o el parámetro.
Código de estado HTTP: 400
- LimitExceededException
-
Se ha excedido el límite en el número de solicitudes por segundo.
Código de estado HTTP: 400
- ResourceAlreadyExistsException
-
El recurso especificado ya existe.
Código de estado HTTP: 400
- ResourceInUseException
-
El recurso especificado está en uso.
Código de estado HTTP: 400
- ResourceNotFoundException
-
No se ha encontrado el recurso especificado.
Código de estado HTTP: 400
- TooManyTagsException
-
Ha superado el número máximo de etiquetas que puede aplicar a este recurso.
Código de estado HTTP: 400
Véase también
Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulte lo siguiente:
