用户端点
用户端点和参数
要详细了解对象关系，请参阅 对象关系 部分。
如需详细了解用户，请访问 用户和组管理 帮助页面。
创建新用户
要创建新的用户记录，请使用
POST {baseURL}/v3/users
端点。
注意
只有管理员可以使用此 API 端点。
此端点不能用于配置了 Windows 身份验证的 Server 实例。
参数
userContract (body)：要创建新用户，必须指定 userContract 参数。请指定以下参数：
firstName (string)：必填。输入用户的名字。
lastName (string)：必填。输入用户的姓氏。
email (string)：必填。输入用户的电子邮件地址。
role (string)：可选。您可以从以下选项中进行选择：无访问权限、查看者、成员、创建者、管理员和已评估（在运行时已评估的默认角色）。如需详细了解角色和权限，请访问 用户角色和权限 页面。如果未选择角色，则默认角色为“已评估”。
defaultWorkerTag (string)：可选。指定在工作程序中定义的工作程序标签，以帮助将作业分配给某些工作程序节点。如果未指定，则默认值为 ""。如需了解详情，请访问 工作程序 帮助页面。
canScheduleJobs (boolean)：可选。指定用户是否可以计划作业。如果未指定，则默认值为 false。如需了解详情，请访问 作业 帮助页面。
canPrioritizeJobs (boolean)：可选。指定用户是否可以设置作业的优先级。如果未指定，则默认值为 false。如需了解详情，请访问 作业 帮助页面。
canAssignJobs (boolean)：可选。指定用户是否可以分配作业。如果未指定，则默认值为 false。如需了解详情，请访问 作业 帮助页面。
canCreateCollections (boolean)：可选。指定用户是否可以创建新集合。如果未指定，则默认值为 false。如需了解详情，请访问 集合 帮助页面。
isApiEnabled (boolean)：可选。指定是否为用户启用 API。如果未指定，则默认值为 false。
defaultCredentialId (string)：可选。此参数是指工作流的唯一 ID，默认分配给用户。如果未指定，则默认值为 ""。
isActive (boolean)：可选。选择用户是处于激活状态还是处于停用状态。如果未指定，则默认值为 true。
timeZone (string)：可选。输入时区，例如欧洲/基辅。如果未指定，则默认值为 ""。
请求示例：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'
停用用户
要停用系统中的用户，请使用
POST {baseURL}/v3/users/{userId}/deactivate
端点。
注意
只有管理员可以使用此 API 端点。
作为响应，您将获得一个包含用户组 ID 的数组，而已停用的用户已从该数组中移除。
参数
userId (string)：必填。输入用户 ID 以停用此用户。
请求示例：cURL
curl --location --request POST 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b/deactivate' \ --header 'Authorization: Bearer BearerTokenGoesHere'
向用户发送密码重置电子邮件
要将密码重置电子邮件发送给现有用户，请使用
POST {baseURL}/v3/users/{userId}/passwordReset
端点。
注意
只有管理员可以使用此 API 端点。
此端点不能用于配置了 Windows 身份验证和 SAML 身份验证的 Server 实例。
参数
userId (string)：必填。输入用户 ID 以向用户发送重置电子邮件。
请求示例：cURL
curl --location --request POST 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b/passwordReset' \ --header 'Authorization: Bearer BearerTokenGoesHere'
检索所有用户记录
要检索所有可访问的用户记录，请使用
GET {baseURL}/v3/users
端点。使用各种参数作为筛选条件。
注意
只有管理员可以使用此 API 端点。
如果 searchContract.Verbose 设置为 false，则将返回一个减小的视图对象。
参数
view (string)：可选。可以保留此参数但不为其提供值。您可以从以下值中选择：“默认值”和“全部”。如果此参数设置为“Default”，则将返回一个减小的视图对象。未指定时，将使用“默认值（Default）”。
active (boolean)：可选。选择用户是处于激活状态还是处于停用状态。
email (string)：可选。输入用户的电子邮件地址。
role (string)：可选。选择用户角色以缩小搜索范围。从以下选项中进行选择：无访问权限、查看者、成员、创建者、管理员和已评估。默认（已评估）角色在运行时已评估。如需详细了解角色和权限，请访问 用户角色和权限 页面。
firstName (string)：可选。输入用户的名字。
lastName (string)：可选。输入用户的姓氏。
createdAfter (date-time)：可选。输入日期和时间，用户是在此之后创建的。以 ISO8601 格式 输入日期和时间。
createdBefore (date-time)：可选。输入日期和时间，用户是在此之前创建的。以 ISO8601 格式 输入日期和时间。
请求示例：cURL
curl --location --request GET 'http://localhost/webapi/v3/users?view=Full&active=true&lastName=Doe' \ --header 'Authorization: Bearer BearerTokenGoesHere'
检索有关特定用户的详细信息
要检索有关现有用户的详细信息，请使用
GET {baseURL}/v3/users/{userId}
端点。
注意
只有管理员可以使用此 API 端点。
参数
userId (string)：必填。输入用户 ID 以检索有关此用户的详细信息。
请求示例：cURL
curl --location --request GET 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b' \ --header 'Authorization: Bearer BearerTokenGoesHere'
检索用户拥有的所有资产
要获取现有用户拥有的可访问资产的完整列表，请使用
GET {baseURL}/v3/users/{userId}/assets
端点。
注意
只有管理员可以使用此 API 端点。
参数
userId (string)：必填。输入用户 ID 以检索此用户的资产列表。
assetType (string)：可选。选择要返回的资产类型。默认值设置为“全部”。
请求示例：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.
注意
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'
更新现有用户
要更新现有用户的详细信息，请使用
PUT {baseURL}/v3/users/{userId}
端点。
注意
只有管理员可以使用此 API 端点。
updateContract 的 ID 将被 URL 中的 ID 值覆盖。
参数
userId (string)：必填。输入用户 ID 以更新此用户。
updateContract (body)：必填。要更新用户，必须指定 updateContract 参数。请指定以下参数：
id (string)：可选。输入用户 ID 以便更新。
firstName (string)：必填。输入用户的名字。
lastName (string)：必填。输入用户的姓氏。
email (string)：必填。输入用户的电子邮件地址。
role (string)：必填。您可以从以下选项中进行选择：无访问权限、查看者、成员、创建者、管理员和已评估。如需详细了解角色和权限，请访问 用户角色和权限 页面。
defaultWorkerTag (string)：必填。指定在工作程序中定义的工作程序标签，以帮助将作业分配给某些工作程序节点。如需详细了解工作程序，请访问 工作程序 帮助页面。
canScheduleJobs (boolean)：必填。指定用户是否可以计划作业。如需了解详情，请访问 作业 帮助页面。
canPrioritizeJobs (boolean)：必填。指定用户是否可以设置作业的优先级。如需了解详情，请访问 作业 帮助页面。
canAssignJobs (boolean)：必填。指定用户是否可以分配作业。如需了解详情，请访问 作业 帮助页面。
canCreateCollections (boolean)：可选。指定用户是否可以创建集合。未指定时，保持之前的值不变。如需了解详情，请访问 集合 帮助页面。
isApiEnabled (boolean)：必填。指定是否为用户启用 API。
defaultCredentialId (string)：必填。此参数是指工作流的唯一 ID，默认分配给用户。
isAccountLocked (boolean)：必填。选择是否要锁定此用户账户。
isActive (boolean)：必填。选择用户是处于激活状态还是处于停用状态。
isValidated (boolean)：必填。指定用户的电子邮件地址是否已经过验证。
timeZone (string)：必填。输入时区，例如欧洲/基辅等。
language (string)：必填。支持的语言值包括“de-de”、“en-us”、“es-es”、“fr-fr”、“it-it”、“ja-jp”、“pt-br”、“zh-cn”。
请求示例：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'
删除用户
要从系统中删除现有用户，请使用
DELETE {baseURL}/v3/users/{userId}
端点。
注意
只有管理员可以使用此 API 端点。
如果您想要删除的用户已经分配了任何资产（工作流、计划、集合、洞察）或用户组，则不能删除此用户。
参数
userId (string)：必填。输入要删除的用户 ID。
请求示例：cURL
curl --location --request DELETE 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b' \ --header 'Authorization: Bearer BearerTokenGoesHere'
对象关系
如果您要 创建用户 ，则可以按如下方式使用创建的对象：
创建的对象：“ id ”（例如，“id”: “619158e57e607d0011ac3009”）
您可以将其用作：
Postman 请求示例
GET /v3/users
GET /v3/users/{id}/assets
如需详细了解有关 Postman 请求的更多信息，请访问 如何使用 Postman 帮助页面。