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à.
CreateDatasetGroup
Crea un gruppo di set di dati vuoto. Un gruppo di set di dati è un contenitore per le risorse di Amazon Personalize. Un gruppo di set di dati può contenere al massimo tre set di dati, uno per ogni tipo di set di dati:
-
Interazioni tra elementi
-
Item
-
Utenti
-
Azioni
-
Interazioni d'azione
Un gruppo di set di dati può essere un gruppo di set di dati di dominio, in cui si specifica un dominio e si utilizzano risorse preconfigurate come i consigliatori, o un gruppo di set di dati personalizzato, in cui si utilizzano risorse personalizzate, ad esempio una soluzione con una versione della soluzione, da distribuire con una campagna. Se inizi con un gruppo di set di dati Domain, puoi comunque aggiungere risorse personalizzate come soluzioni e versioni di soluzioni addestrate con ricette per casi d'uso personalizzati e distribuite con le campagne.
Un gruppo di set di dati può trovarsi in uno dei seguenti stati:
-
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -oppure- CREATE FAILED
-
ELIMINAZIONE IN SOSPESO
Per ottenere lo stato del gruppo di set di dati, chiama. DescribeDatasetGroup Se lo stato viene visualizzato come CREATE FAILED, la risposta include una failureReason chiave che descrive il motivo per cui la creazione non è riuscita.
Nota
È necessario attendere la fine del gruppo status di set di dati ACTIVE prima di aggiungere un set di dati al gruppo.
È possibile specificare una chiave AWS Key Management Service (KMS) per crittografare i set di dati nel gruppo. Se specifichi una chiave KMS, devi includere anche un ruolo AWS Identity and Access Management (IAM) autorizzato ad accedere alla chiave.
API che richiedono un gruppo di set di dati ARN nella richiesta
API correlate
Sintassi della richiesta
{
"domain": "string",
"kmsKeyArn": "string",
"name": "string",
"roleArn": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}Parametri della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- domain
-
Il dominio del gruppo di set di dati. Specificare un dominio per creare un gruppo di set di dati di dominio. Il dominio specificato determina gli schemi predefiniti per i set di dati e i casi d'uso disponibili per i consiglieri. Se non specifichi un dominio, crei un gruppo di set di dati personalizzato con versioni della soluzione da distribuire con una campagna.
▬Tipo: stringa
Valori validi:
ECOMMERCE | VIDEO_ON_DEMANDCampo obbligatorio: no
- kmsKeyArn
-
L'Amazon Resource Name (ARN) di una chiave AWS Key Management Service (KMS) utilizzata per crittografare i set di dati.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 2048.
Pattern:
arn:aws.*:kms:.*:[0-9]{12}:key/.*Campo obbligatorio: no
- name
-
Il nome del nuovo gruppo di set di 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'ARN del ruolo AWS Identity and Access Management (IAM) che dispone delle autorizzazioni per accedere alla chiave AWS Key Management Service (KMS). La fornitura di un ruolo IAM è valida solo quando si specifica anche una chiave KMS.
▬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: no
-
Un elenco di tag da applicare al gruppo di set di 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
{
"datasetGroupArn": "string",
"domain": "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.
- datasetGroupArn
-
L'Amazon Resource Name (ARN) del nuovo gruppo di set di dati.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+ - domain
-
Il dominio per il nuovo gruppo di set di dati Domain.
▬Tipo: stringa
Valori validi:
ECOMMERCE | VIDEO_ON_DEMAND
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
- 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:
