Endpoint utente
Endpoint e parametri degli utenti
Per ulteriori informazioni sulle relazioni tra oggetti, consulta la sezione Relazioni tra oggetti.
Per ulteriori informazioni sugli utenti, consulta la pagina di assistenza Gestione di utenti e gruppi.
Creazione di un nuovo utente
Per creare un nuovo record utente, utilizza l'endpoint POST {baseURL}/v3/users
.
Nota
Questo endpoint non può essere utilizzato per le istanze di Server configurate con l'autenticazione di Windows.
Parametri
userContract (corpo): il parametro userContract è obbligatorio per creare un nuovo utente. Specifica i seguenti parametri:
firstName (stringa): obbligatorio. Immetti il nome di un utente.
lastName (stringa): obbligatorio. Immetti il cognome di un utente.
email (stringa): obbligatorio. Immetti l'indirizzo e-mail di un utente.
role (stringa): opzionale. È possibile selezionare le seguenti opzioni: NoAccess (Nessun accesso), Viewer (Visualizzatore), Member (Membro), Artisan (Creatore), Curator (Amministratore) e Evaluated (Valutato). Quest'ultimo è il ruolo predefinito valutato in fase di runtime. Per ulteriori informazioni sui ruoli e sulle autorizzazioni, consulta la pagina Ruoli utente e autorizzazioni. Quando non è selezionato alcun ruolo, il valore predefinito è Evaluated (Valutato).
defaultWorkerTag (stringa): opzionale. Specifica il tag worker definito nei worker per facilitare l'assegnazione dei processi a determinati nodi worker. In assenza di una specifica, il valore predefinito è "". Per ulteriori informazioni, consulta la pagina di assistenza Worker.
canScheduleJobs (booleano): opzionale. Specifica se l'utente può pianificare i processi. In assenza di una specifica, il valore predefinito è false. Per ulteriori informazioni, consulta la pagina di assistenza Processi.
canPrioritizeJobs (booleano): opzionale. Specifica se un utente può assegnare priorità ai processi. In assenza di una specifica, il valore predefinito è false. Per ulteriori informazioni, consulta la pagina di assistenza Processi.
canAssignJobs (booleano): opzionale. Specifica se un utente può assegnare i processi. In assenza di una specifica, il valore predefinito è false. Per ulteriori informazioni, consulta la pagina di assistenza Processi.
canCreateCollections (booleano): opzionale. Specifica se un utente può creare nuove raccolte. In assenza di una specifica, il valore predefinito è false. Per ulteriori informazioni, consulta la pagina di assistenza Raccolte.
isApiEnabled (booleano): opzionale. Specifica se l'API è attivata per un utente. In assenza di una specifica, il valore predefinito è false.
defaultCredentialId (stringa): opzionale. Questo parametro si riferisce all'ID univoco di un flusso di lavoro assegnato all'utente per impostazione predefinita. In assenza di una specifica, il valore predefinito è "".
isActive (booleano): opzionale. Seleziona se un utente è attivo o inattivo. In assenza di una specifica, il valore predefinito è true.
timeZone (stringa): opzionale. Immetti il fuso orario, ad esempio Europe/Kiev. In assenza di una specifica, il valore predefinito è "".
Esempio di richiesta: cURL
curl --location --request POST 'http://localhost/webapi/v3/users' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Authorization: Bearer BearerTokenGoesHere' \ --data-urlencode 'firstName=John' \ --data-urlencode 'lastName=Doe' \ --data-urlencode 'email=John.Doe@emailexample.com'
Disattivazione di un utente
Per disattivare un utente nel sistema, utilizza l'endpoint POST {baseURL}/v3/users/{id}/deactivate
.
Parametri
id (stringa): obbligatorio. Immetti l'ID di un utente da disattivare.
Esempio di richiesta: cURL
curl --location --request POST 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b/deactivate' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Reimpostazione di una password per un utente
Per reimpostare la password di un utente specifico e inviare la relativa e-mail, utilizza l'endpoint POST {baseURL}/v3/users/{id}/passwordReset
.
Nota
Questo endpoint non può essere utilizzato per le istanze di Server configurate con l'autenticazione di Windows e l'autenticazione SAML.
Parametri
id (stringa): obbligatorio. Immetti l'ID di un utente per reimpostarne la password.
Esempio di richiesta: cURL
curl --location --request POST 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b/passwordReset' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Ricerca di utenti
Per cercare gli utenti, utilizza l'endpoint GET {baseURL}/v3/users
. Utilizza vari parametri come filtro per la ricerca degli utenti.
Parametri
view (stringa): opzionale. È possibile non specificare alcun valore o selezionare "Default" e "Full". Se il parametro è impostato su "Default", viene restituito un oggetto vista ridotto. Se non è specificato alcun valore, viene utilizzato "Default".
active (booleano): opzionale. Seleziona se un utente è attivo o inattivo.
email (stringa): opzionale. Inserisci l'indirizzo e-mail dell'utente.
role (stringa): opzionale. Seleziona il ruolo dell'utente per circoscrivere la ricerca. Seleziona una delle seguenti opzioni: NoAccess (Nessun accesso), Viewer (Visualizzatore), Member (Membro), Artisan (Creatore), Curator (Amministratore) e Evaluated (Valutato). Il ruolo predefinito, Evaluated (Valutato), viene valutato in fase di runtime. Per ulteriori informazioni sui ruoli e sulle autorizzazioni, consulta la pagina Ruoli utente e autorizzazioni.
firstName (stringa): opzionale. Immetti il nome dell'utente.
lastName (stringa): opzionale. Immetti il cognome dell'utente.
createdAfter (data-ora): opzionale. Immetti la data e l'ora dopo le quali è stato creato l'utente. Immetti la data e l'ora in formato ISO8601.
createdBefore (data-ora): opzionale. Immetti la data e l'ora prima delle quali è stato creato l'utente. Immetti la data e l'ora in formato ISO8601.
Esempio di richiesta: cURL
curl --location --request GET 'http://localhost/webapi/v3/users?view=Full&active=true&lastName=Doe' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Ricerca di un utente specifico
Per cercare un utente specifico, utilizza l'endpoint GET {baseURL}/v3/users/{id}
.
Parametri
id (stringa): obbligatorio. Immetti l'ID di un utente di cui desideri recuperare le informazioni.
Esempio di richiesta: cURL
curl --location --request GET 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Recupero di tutte le risorse di proprietà di un utente
Per ottenere un elenco completo delle risorse di proprietà di un utente, utilizza l'endpoint GET {baseURL}/v3/users/{id}/assets
.
Parametri
id (stringa): obbligatorio. Immetti l'ID di un utente per recuperare il relativo elenco delle risorse.
assetType (stringa): opzionale. Seleziona i tipi di risorsa che desideri restituire. L'impostazione predefinita è "Tutte".
Esempio di richiesta: cURL
curl --location --request GET 'http://localhost/webapi/v3/users/61d564361d6d5da7ad461a32/assets?assetType=Workflows' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Aggiornamento di un utente esistente
Per aggiornare un utente esistente, utilizza l'endpoint PUT {baseURL}/v3/users/{id}
.
Nota
L'ID di updateContract verrà sovrascritto dal valore ID nell'URL.
Parametri
id (stringa): obbligatorio. Immetti l'ID di un utente da aggiornare.
updateContract (corpo): obbligatorio. Il parametro updateContract è obbligatorio per aggiornare un utente. Specifica quanto segue:
id (stringa): opzionale. Immetti l'ID di un utente per aggiornarlo.
firstName (stringa): obbligatorio. Immetti il nome di un utente.
lastName (stringa): obbligatorio. Immetti il cognome di un utente.
email (stringa): obbligatorio. Immetti l'indirizzo e-mail di un utente.
role (stringa): obbligatorio. È possibile selezionare le seguenti opzioni: NoAccess (Nessun accesso), Viewer (Visualizzatore), Member (Membro), Artisan (Creatore), Curator (Amministratore) e Evaluated (Valutato). Per ulteriori informazioni sui ruoli e sulle autorizzazioni, consulta la pagina Ruoli utente e autorizzazioni.
defaultWorkerTag (stringa): obbligatorio. Specifica il tag worker definito nei worker per facilitare l'assegnazione dei processi a determinati nodi worker. Per ulteriori informazioni sui worker, consulta la pagina di assistenza Worker.
canScheduleJobs (booleano): obbligatorio. Specifica se un utente può pianificare i processi. Per ulteriori informazioni, consulta la pagina di assistenza Processi.
canPrioritizeJobs (booleano): obbligatorio. Specifica se un utente può assegnare priorità ai processi. Per ulteriori informazioni, consulta la pagina di assistenza Processi.
canAssignJobs (booleano): obbligatorio. Specifica se un utente può assegnare i processi. Per ulteriori informazioni, consulta la pagina di assistenza Processi.
canCreateCollections (booleano): opzionale. Specifica se un utente può creare raccolte. Se non è specificato, il valore rimane invariato. Per ulteriori informazioni, consulta la pagina di assistenza Raccolte.
isApiEnabled (booleano): obbligatorio. Specifica se l'API è attivata per un utente.
defaultCredentialId (stringa): obbligatorio. Questo parametro si riferisce all'ID univoco di un flusso di lavoro assegnato all'utente per impostazione predefinita.
isAccountLocked (booleano): obbligatorio. Seleziona se bloccare l'account dell'utente.
isActive (booleano): obbligatorio. Seleziona se un utente è attivo o inattivo.
isValidated (booleano): obbligatorio. Specifica se l'indirizzo e-mail di un utente è convalidato.
timeZone (stringa): obbligatorio. Immetti il fuso orario, ad esempio Europe/Kiev, ecc.
language (stringa): obbligatorio. I valori della lingua supportati sono "de-de", "en-us", "es-es", "fr-fr", "it-it", "ja-jp", "pt-br", "zh-cn".
Esempio di richiesta: cURL
curl --location --request PUT 'http://localhost/webapi/v3/users/61d564361d6d5da7ad461a32' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Authorization: Bearer BearerTokenGoesHere' \ --data-urlencode 'firstName=Doe' \ --data-urlencode 'lastName=Jane' \ --data-urlencode 'email=jdoe@alteryx.com' \ --data-urlencode 'role=Artisan' \ --data-urlencode 'defaultWorkerTag=worker' \ --data-urlencode 'canScheduleJobs=true' \ --data-urlencode 'canPrioritizeJobs=true' \ --data-urlencode 'canAssignJobs=true' \ --data-urlencode 'canCreateCollections=true' \ --data-urlencode 'isApiEnabled=true' \ --data-urlencode 'defaultCredentialId=jdoe' \ --data-urlencode 'isAccountLocked=true' \ --data-urlencode 'isActive=true' \ --data-urlencode 'isValidated=true' \ --data-urlencode 'timeZone=Europe/Prague' \ --data-urlencode 'language=en-us' \ --data-urlencode 'id=61d564361d6d5da7ad461a32'
Eliminazione di un utente
Per eliminare un utente specifico dal sistema, utilizza l'endpoint DELETE {baseURL}/v3/users/{id}
.
Nota
Se l'utente che desideri eliminare dispone di risorse (flussi di lavoro, pianificazioni, raccolte, insight) o gruppi di utenti assegnati, non può essere eliminato.
Parametri
id (stringa): obbligatorio. Immetti l'ID dell'utente che desideri eliminare.
Esempio di richiesta: cURL
curl --location --request DELETE 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Relazioni tra oggetti
Se stai creando un utente, puoi utilizzare gli oggetti creati nel modo seguente:
Oggetto creato: "id" (ad esempio, "id": "619158e57e607d0011ac3009")
Puoi utilizzarlo come:
userId se stai aggiungendo utenti a un gruppo di utenti.
userId se stai rimuovendo l'utente da un gruppo di utenti.
id se stai cercando un utente specifico.
ownerId se stai caricando un flusso di lavoro.
userId se stai aggiungendo un utente da una raccolta.
userId se stai rimuovendo un utente da una raccolta.
userId se stai aggiornando le autorizzazioni utente per una raccolta.
ownerId se stai cercando una pianificazione.
userId se desideri condividere una credenziale con un utente.
userId se desideri rimuovere un utente da una credenziale.
userId se desideri aggiungere un utente a una connessione dati esistente.
userId se desideri rimuovere un utente da una connessione dati esistente.
Esempi di richiesta Postman
GET /v3/users
GET /v3/users/{id}/assets
Per ulteriori informazioni sulle richieste Postman, consulta la pagina di assistenza Come utilizzare Postman.