Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
CreateDataDeletionJob
Crea un processo batch che elimina in batch tutti i riferimenti a utenti specifici da un gruppo di set di dati Amazon Personalize. Specifichi gli utenti da eliminare in un file CSV di ID utente in un bucket Amazon S3. Una volta completato un processo, Amazon Personalize non si basa più sui dati degli utenti e non li considera più durante la generazione dei segmenti di utenti. Per ulteriori informazioni sulla creazione di un processo di eliminazione dei dati, consulta Eliminazione degli utenti.
-
Il file di input deve essere un file CSV con un'unica colonna USER_ID che elenca gli ID degli utenti. Per ulteriori informazioni sulla preparazione del file CSV, consulta Preparazione del file di eliminazione dei dati e caricamento su Amazon S3.
-
Per consentire ad Amazon Personalize di accedere al file CSV di input degli UserID, devi specificare un ruolo del servizio IAM che disponga dell'autorizzazione alla lettura dall'origine dati. Questo ruolo richiede
GetObjecteListBucketautorizzazioni per il bucket e il suo contenuto. Queste autorizzazioni sono le stesse dell'importazione dei dati. Per informazioni su come concedere l'accesso al tuo bucket Amazon S3, consulta Giving Amazon Personalize Access to Amazon S3 Resources.
Dopo aver creato un lavoro, può essere necessario fino a un giorno per eliminare tutti i riferimenti agli utenti da set di dati e modelli. Fino al completamento del processo, Amazon Personalize continua a utilizzare i dati durante la formazione. E se utilizzi una ricetta di segmentazione degli utenti, gli utenti potrebbero apparire in segmenti di utenti.
Stato
Un processo di eliminazione dei dati può avere uno dei seguenti stati:
-
IN SOSPESO > IN_PROGRESS > COMPLETATO -o- NON RIUSCITO
Per conoscere lo stato del processo di eliminazione dei dati, chiama l'operazione DescribeDataDeletionJobAPI e specifica l'Amazon Resource Name (ARN) del processo. Se lo stato è FAILED, la risposta include una failureReason chiave che descrive il motivo per cui il processo non è riuscito.
API correlate
Sintassi della richiesta
{
"datasetGroupArn": "string",
"dataSource": {
"dataLocation": "string"
},
"jobName": "string",
"roleArn": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}Parametri della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- datasetGroupArn
-
L'Amazon Resource Name (ARN) del gruppo di set di dati che contiene i set di dati da cui desideri eliminare i record.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+Campo obbligatorio: sì
- dataSource
-
Il bucket Amazon S3 che contiene l'elenco degli ID utente degli utenti da eliminare.
Tipo: oggetto DataSource
Campo obbligatorio: sì
- jobName
-
Il nome del processo di eliminazione dei dati.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri.
Modello:
^[a-zA-Z0-9][a-zA-Z0-9\-_]*Campo obbligatorio: sì
- roleArn
-
L'Amazon Resource Name (ARN) del ruolo IAM che dispone delle autorizzazioni per la lettura dall'origine dati Amazon S3.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+Campo obbligatorio: sì
-
Un elenco di tag da applicare al processo di eliminazione dei dati.
Tipo: matrice di oggetti Tag
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.
Campo obbligatorio: no
Sintassi della risposta
{
"dataDeletionJobArn": "string"
}Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- dataDeletionJobArn
-
L'Amazon Resource Name (ARN) del processo di eliminazione dei dati.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+
Errori
- InvalidInputException
-
Fornisci un valore valido per il campo o il parametro.
Codice di stato HTTP: 400
- LimitExceededException
-
Il limite del numero di richieste al secondo è stato superato.
Codice di stato HTTP: 400
- ResourceAlreadyExistsException
-
La risorsa specificata esiste già.
Codice di stato HTTP: 400
- ResourceInUseException
-
La risorsa specificata è in uso.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
Impossibile trovare la risorsa specificata.
Codice di stato HTTP: 400
- TooManyTagsException
-
Hai superato il numero massimo di tag che puoi applicare a questa risorsa.
Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue:
