Points de terminaison de l'utilisateur
Points de terminaison et paramètres d'utilisateurs
Pour en savoir plus sur les relations d'objets, consultez la section Relations d'objets .
Pour plus d'informations sur les utilisateurs, consultez la page d'aide Gestion des utilisateurs et des groupes .
Créer un utilisateur
Pour créer un nouvel enregistrement d'utilisateur, utilisez le point de terminaison
POST {baseURL}/v3/users
.
Note
Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.
Ce point de terminaison ne peut pas être utilisé pour les instances de Server configurées pour l'authentification Windows.
Paramètres
userContract (corps) : pour créer un nouvel utilisateur, le paramètre « userContract » est obligatoire. Indiquez les paramètres suivants :
firstName (chaîne) : obligatoire. Saisissez le prénom d'un utilisateur.
lastName (chaîne) : obligatoire. Saisissez le nom de famille d'un utilisateur.
email (chaîne) : obligatoire. Saisissez l'adresse e-mail d'un utilisateur.
role (chaîne) : facultatif. Vous pouvez choisir parmi ces options : NoAccess, Viewer, Member, Artisan, Curator et Evaluated (rôle par défaut évalué à l'exécution). Pour plus d'informations sur les rôles et les autorisations, consultez la page Rôles et autorisations des utilisateurs . Lorsqu'aucun rôle n'est sélectionné, le rôle Evaluated est utilisé par défaut.
defaultWorkerTag (chaîne) : facultatif. Indiquez la balise worker définie dans les workers pour attribuer des tâches à certains nœuds worker. Si elle n'est pas précisée, la valeur par défaut est définie sur "". Pour plus d'informations, consultez la page d'aide Worker.
canScheduleJobs (booléen) : facultatif. Indiquez si l'utilisateur peut planifier des tâches. Lorsque cela n'est pas précisé, la valeur par défaut est définie sur « faux ». Pour plus d'informations, consultez la page d'aide Tâches .
canPrioritizeJobs (booléen) : facultatif. Indiquez si un utilisateur peut hiérarchiser des tâches. Lorsque cela n'est pas précisé, la valeur par défaut est définie sur « faux ». Pour plus d'informations, consultez la page d'aide Tâches .
canAssignJobs (booléen) : facultatif. Indiquez si un utilisateur peut affecter des tâches. Lorsque cela n'est pas précisé, la valeur par défaut est définie sur « faux ». Pour plus d'informations, consultez la page d'aide Tâches .
canCreateCollections (booléen) : facultatif. Indiquez si un utilisateur peut créer de nouvelles collections. Lorsque cela n'est pas précisé, la valeur par défaut est définie sur « faux ». Pour plus d'informations, consultez la page d'aide Collections .
isApiEnabled (booléen) : facultatif. Indiquez si l'API est activée pour un utilisateur. Lorsque cela n'est pas précisé, la valeur par défaut est définie sur « faux ».
defaultCredentialId (chaîne) : facultatif. Ce paramètre fait référence à l'ID unique d'un workflow, attribué par défaut à l'utilisateur. Si elle n'est pas précisée, la valeur par défaut est définie sur "".
isActive (booléen) : facultatif. Choisissez d'activer ou non un utilisateur. Lorsqu'elle n'est pas précisée, la valeur par défaut est définie sur « vrai ».
timeZone (chaîne) : facultatif. Saisissez le fuseau horaire, par exemple Europe/Kiev. Si elle n'est pas précisée, la valeur par défaut est définie sur "".
Exemple de demande : 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'
Désactiver un utilisateur
Pour désactiver un utilisateur dans le système, utilisez le point de terminaison
POST {baseURL}/v3/users/{userId}/deactivate
.
Note
Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.
En réponse, vous obtenez un tableau d'ID de groupe d'utilisateurs desquels l'utilisateur désactivé est retiré.
Paramètres
userId (chaîne) : obligatoire. Saisissez un ID d'utilisateur pour désactiver cet utilisateur.
Exemple de demande : cURL
curl --location --request POST 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b/deactivate' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Envoyer un e-mail de réinitialisation du mot de passe à un utilisateur
Pour envoyer un e-mail de réinitialisation du mot de passe à un utilisateur existant, utilisez le point de terminaison
POST {baseURL}/v3/users/{userId}/passwordReset
.
Note
Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.
Ce point de terminaison ne peut pas être utilisé pour les instances de Server configurées pour les authentifications Windows et SAML.
Paramètres
userId (chaîne) : obligatoire. Saisissez un ID d'utilisateur pour envoyer un e-mail de réinitialisation à l'utilisateur.
Exemple de demande : cURL
curl --location --request POST 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b/passwordReset' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Récupérer tous les enregistrements d'utilisateurs
Pour récupérer tous les enregistrements d'utilisateurs accessibles, utilisez le point de terminaison
GET {baseURL}/v3/users
. Filtrez avec plusieurs paramètres.
Note
Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.
Si le paramètre « searchContract.Verbose » est défini sur « faux », un objet de vue réduite est renvoyé.
Paramètres
view (chaîne) : facultatif. Peut être laissé sans valeur. Vous pouvez choisir parmi les valeurs suivantes : « Default » et « Full ». Si ce paramètre est défini sur « Default », un objet de vue réduite est renvoyé. Lorsqu'elle n'est pas spécifiée, la valeur « Default » est utilisée.
active (booléen) : facultatif. Choisissez d'activer ou non un utilisateur.
email (chaîne) : facultatif. Saisissez l'adresse e-mail de l'utilisateur.
role (chaîne) : facultatif. Sélectionnez le rôle d'utilisateur pour affiner la recherche. Choisissez parmi ces options : NoAccess, Viewer, Member, Artisan, Curator et Evaluated. Le rôle par défaut (Evaluated) est évalué lors de l'exécution. Pour plus d'informations sur les rôles et les autorisations, consultez la page Rôles et autorisations des utilisateurs .
firstName (chaîne) : facultatif. Saisissez le prénom de l'utilisateur.
lastName (chaîne) : facultatif. Saisissez le nom de famille de l'utilisateur.
createdAfter (date-heure) : facultatif. Saisissez la date et l'heure après lesquelles l'utilisateur a été créé. Saisissez la date et l'heure au format ISO8601.
createdBefore (date-heure) : facultatif. Saisissez la date et l'heure avant lesquelles l'utilisateur a été créé. Saisissez la date et l'heure au format ISO8601.
Exemple de demande : cURL
curl --location --request GET 'http://localhost/webapi/v3/users?view=Full&active=true&lastName=Doe' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Récupérer les détails d'un utilisateur spécifique
Pour récupérer des détails sur un utilisateur existant, utilisez le point de terminaison
GET {baseURL}/v3/users/{userId}
.
Note
Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.
Paramètres
userId (chaîne) : obligatoire. Saisissez un ID d'utilisateur pour récupérer les détails de cet utilisateur.
Exemple de demande : cURL
curl --location --request GET 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Récupérer toutes les ressources dont un utilisateur est propriétaire
Pour obtenir une liste complète des ressources accessibles dont un utilisateur existant est propriétaire, utilisez le point de terminaison
GET {baseURL}/v3/users/{userId}/assets
.
Note
Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.
Paramètres
userId (chaîne) : obligatoire. Saisissez un ID d'utilisateur pour récupérer la liste des ressources de cet utilisateur.
assetType (chaîne) : facultatif. Sélectionnez les types de ressources que vous souhaitez renvoyer. La valeur par défaut est définie sur « Toutes ».
Exemple de demande : cURL
curl --location --request GET 'http://localhost/webapi/v3/users/61d564361d6d5da7ad461a32/assets?assetType=Workflows' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Transfer All Assets a User Owns to Another
To transfer all assets (workflows, schedules, and collections) owned by one user to another, use the PUT {baseURL}/v3/users/{userId}/assetTransfer
endpoint.
Note
Only Curators can use this API endpoint.
If any of the workflows require DCM connections, Server connections, or specific run as credentials to run, these items need to be updated before the workflow can run.
If users are not in the same studio and when a workflow is transferred to the new studio, all other users in the new owner's studio will also receive access to the workflow, and all users from the old studio will lose access.
Workflows can only be transferred to a user with the Artisan or Curator role.
If transferring schedules, the new owner must have access to the scheduled workflow, otherwise you won’t be able to transfer that workflow to the new owner.
If transferring schedules, the new owner must have permission to schedule workflows.
If the user is deleted, it returns a list of schedule Ids that will be broken or disabled after transfer.
Parameters
userId (string): Required. Id of the user to transfer assets from.
contract (body):
ownerId (string): Specify the Id of the user to transfer assets to (new owner).
transferWorkflows (Boolean): Specify whether the workflows should be transferred to the new owner.
transferSchedules (Boolean): Specify whether the schedules should be transferred to the new owner.
transferCollections (Boolean): Specify whether the collections should be transferred to the new owner.
Request Example: cURL
curl -X PUT --header 'Content-Type: application/json' --header 'Accept: application/json' -d '{ \ "ownerId": "63d17f6cb049da66d0afd4e2", \ "transferWorkflows": true, \ "transferSchedules": true, \ "transferCollections": true \ }' 'http://localhost/webapi/v3/users/613a523df9199abfc446d19d/assetTransfer'
Mettre à jour un utilisateur existant
Pour mettre à jour les détails d'un utilisateur existant, utilisez le point de terminaison
PUT {baseURL}/v3/users/{userId}
.
Note
Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.
L'ID du paramètre « updateContract » sera remplacé par la valeur d'ID dans l'URL.
Paramètres
userId (chaîne) : obligatoire. Saisissez un ID d'utilisateur pour mettre cet utilisateur à jour.
updateContract (corps) : obligatoire. Pour mettre à jour un utilisateur, le paramètre « updateContract » est obligatoire. Indiquez les éléments suivants :
id (chaîne) : facultatif. Saisissez un ID d'utilisateur pour le mettre à jour.
firstName (chaîne) : obligatoire. Saisissez le prénom d'un utilisateur.
lastName (chaîne) : obligatoire. Saisissez le nom de famille d'un utilisateur.
email (chaîne) : obligatoire. Saisissez l'adresse e-mail d'un utilisateur.
role (chaîne) : obligatoire. Vous pouvez choisir parmi ces options : NoAccess, Viewer, Member, Artisan, Curator et Evaluated. Pour plus d'informations sur les rôles et les autorisations, consultez la page Rôles et autorisations des utilisateurs .
defaultWorkerTag (chaîne) : obligatoire. Indiquez la balise worker définie dans les workers pour attribuer des tâches à certains nœuds worker. Pour plus d'informations à propos des workers, consultez la page d'aide Worker .
canScheduleJobs (booléen) : obligatoire. Indiquez si un utilisateur peut planifier des tâches. Pour plus d'informations, consultez la page d'aide Tâches .
canPrioritizeJobs (booléen) : obligatoire. Indiquez si un utilisateur peut hiérarchiser des tâches. Pour plus d'informations, consultez la page d'aide Tâches .
canAssignJobs (booléen) : obligatoire. Indiquez si un utilisateur peut affecter des tâches. Pour plus d'informations, consultez la page d'aide Tâches .
canCreateCollections (booléen) : facultatif. Indiquez si un utilisateur peut créer des collections. Lorsqu'elle n'est pas spécifiée, la valeur reste la même qu'avant. Pour plus d'informations, consultez la page d'aide Collections .
isApiEnabled (booléen) : obligatoire. Indiquez si l'API est activée pour un utilisateur.
defaultCredentialId (chaîne) : obligatoire. Ce paramètre fait référence à l'ID unique d'un workflow, attribué par défaut à l'utilisateur.
isAccountLocked (booléen) : obligatoire. Indiquez si vous souhaitez verrouiller ce compte utilisateur.
isActive (booléen) : obligatoire. Choisissez d'activer ou non un utilisateur.
isValidated (booléen) : obligatoire. Indiquez si l'adresse e-mail d'un utilisateur est validée.
timeZone (chaîne) : obligatoire. Indiquez le fuseau horaire, par exemple Europe/Kiev, etc.
language (chaîne) : obligatoire. Les valeurs de langue prises en charge sont les suivantes : « de-de », « en-us », « es-es », « fr-fr », « it-it », « ja-jp », « pt-br » et « zh-cn ».
Exemple de demande : 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'
Supprimer un utilisateur
Pour supprimer un utilisateur existant du système, utilisez le point de terminaison
DELETE {baseURL}/v3/users/{userId}
.
Note
Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.
Si l'utilisateur à supprimer possède des ressources (workflows, planifications, collections ou analyses) ou des groupes d'utilisateurs y sont affectés, vous ne pouvez pas supprimer cet utilisateur.
Paramètres
userId (chaîne) : obligatoire. Saisissez l'ID d'utilisateur à supprimer.
Exemple de demande : cURL
curl --location --request DELETE 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Relations d'objets
Si vous créez un utilisateur , vous pouvez utiliser les objets créés comme suit :
Objet créé : « id » (par exemple, « id » : « 619158e57e607d0011ac3009 »)
Vous pouvez l'utiliser comme :
userId si vous ajoutez des utilisateurs à un groupe d'utilisateurs .
userId si vous retirez un utilisateur d'un groupe d'utilisateurs .
userId si vous recherchez un utilisateur spécifique .
ownerId si vous chargez un workflow .
userId si vous ajoutez un utilisateur à partir d'une collection .
userId si vous retirez un utilisateur d'une collection .
userId si vous mettez à jour les autorisations utilisateur pour une collection .
ownerId si vous recherchez une planification .
userId si vous souhaitez partager des informations d'identification avec un utilisateur .
userId si vous souhaitez retirer un utilisateur d'informations d'identification .
userId si vous souhaitez ajouter un utilisateur à une connexion aux données existante .
userId si vous souhaitez retirer un utilisateur d'une connexion aux données existante .
Exemples de demandes Postman
GET /v3/users
GET /v3/users/{id}/assets
Pour en savoir plus sur les demandes Postman, consultez la page d'aide Comment utiliser Postman .