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 tutti i riferimenti a utenti specifici da un gruppo di set di dati Amazon Personalize in batch. 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ù nella generazione dei segmenti di utenti. Per ulteriori informazioni sulla creazione di un processo di eliminazione dei dati, consulta Eliminazione degli utenti. https://docs.aws.amazon.com/personalize/latest/dg/delete-records.html
-
Il file di input deve essere un file CSV con una singola colonna USER_ID che elenca gli ID degli utenti. Per ulteriori informazioni sulla preparazione del file CSV, consulta Preparare il file di cancellazione dei dati e caricarlo su Amazon S3.
-
Per concedere ad Amazon Personalize l'autorizzazione ad accedere al file CSV di input con ID utente, devi specificare un ruolo del servizio IAM che disponga dell'autorizzazione per la lettura dall'origine dati. Questo ruolo richiede
ListBucketautorizzazioni per il bucketGetObjecte il relativo contenuto. Queste autorizzazioni sono le stesse dell'importazione dei dati. Per informazioni sulla concessione dell'accesso al tuo bucket Amazon S3, consulta Giving Amazon Personalize Access to Amazon S3 Resources.
Dopo aver creato un job, può essere necessario fino a un giorno per eliminare tutti i riferimenti agli utenti dai set di dati e dai modelli. Fino al completamento del lavoro, 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 DescribeDataDeletionJob API e specifica l'Amazon Resource Name (ARN) del processo. Se lo stato è FALLITO, 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:.*:.*:.+Obbligatorio: sì
- dataSource
-
Il bucket Amazon S3 che contiene l'elenco degli ID utente degli utenti da eliminare.
Tipo: oggetto DataSource
Obbligatorio: sì
- jobName
-
Il nome del processo di cancellazione 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\-_]*Obbligatorio: sì
- roleArn
-
L'Amazon Resource Name (ARN) del ruolo IAM che dispone delle autorizzazioni per la lettura dall'origine dati di 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+=,.@\-_/]+Obbligatorio: sì
-
Un elenco di tag da applicare al processo di cancellazione dei dati.
Tipo: matrice di oggetti Tag
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.
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
-
È stato superato il numero massimo di tag che è possibile 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:
