Pontos de extremidade de usuários
Pontos de extremidade de usuários e parâmetros
Para saber mais sobre as relações de objetos, vá para a seção Relações de objetos.
Para obter mais informações sobre usuários, visite a página de ajuda Gerenciamento de usuários e grupos.
Criar um novo usuário
Para criar um novo registro de usuário, use o ponto de extremidade POST {baseURL}/v3/users
.
Nota
Somente administradores podem usar esse ponto de extremidade de API.
Este ponto de extremidade não pode ser utilizado em instâncias do Server configuradas para autenticação do Windows.
Parâmetros
userContract (corpo): para criar um novo usuário, o parâmetro "userContract" é obrigatório. Especifique os seguintes parâmetros:
firstName (cadeia de caracteres): obrigatório. Insira o primeiro nome de um usuário.
lastName (cadeia de caracteres): obrigatório. Insira o sobrenome de um usuário.
email (cadeia de caracteres): obrigatório. Insira o endereço de e-mail de um usuário.
role (cadeia de caracteres): opcional. Você pode selecionar entre estas opções: "NoAccess" (sem acesso), "Viewer" (visualizador), "Member" (membro), "Artisan" (criador), "Curator" (administrador), e "Evaluated" (avaliado). A função padrão é "Evaluated" no momento da execução. Para obter mais informações sobre funções e permissões, visite a página Funções e permissões de usuário. Quando nenhuma função é selecionada, o padrão é a função "Evaluated" (avaliado).
defaultWorkerTag (cadeia de caracteres): opcional. Especifique a tag do trabalhador definida nos trabalhos para ajudar a atribuir tarefas a determinados nós de trabalho. Quando não especificado, o padrão é "". Para obter mais informações, visite a página de ajuda Trabalhador.
canScheduleJobs (booleano): opcional. Especifique se o usuário pode agendar trabalhos. Quando não especificado, o padrão é "false" (falso). Para obter mais informações, visite a página de ajuda Trabalhos.
canPrioritizeJobs (booleano): opcional. Especifique se um usuário pode priorizar trabalhos. Quando não especificado, o padrão é "false" (falso). Para obter mais informações, visite a página de ajuda Trabalhos.
canAssignJobs (booleano): opcional. Especifique se um usuário pode atribuir trabalhos. Quando não especificado, o padrão é "false" (falso). Para obter mais informações, visite a página de ajuda Trabalhos.
canCreateCollections (booleano): opcional. Especifique se um usuário pode criar novas coleções. Quando não especificado, o padrão é "false" (falso). Para obter mais informações, visite a página de ajuda Coleções.
isApiEnabled (booleano): opcional. Especifique se a API está habilitada para um usuário. Quando não especificado, o padrão é "false" (falso).
defaultCredentialId (cadeia de caracteres): opcional. Este parâmetro refere-se ao ID exclusivo de um fluxo de trabalho, atribuído ao usuário como padrão. Quando não especificado, o padrão é "".
isActive (booleano): opcional. Selecione se um usuário está ativo ou desativado. Quando não especificado, o padrão é "true" (verdadeiro).
timeZone (cadeia de caracteres): opcional. Insira o fuso horário, por exemplo, Europa/Kiev. Quando não especificado, o padrão é "".
canCreateAndUpdateDcm (booleano): se definido como "verdadeiro", permite ao usuário criar ou atualizar ativos do DCM (fontes de dados, credenciais e cofres externos). Sem essa permissão, os usuários não podem criar, editar e sincronizar seus ativos do DCM a partir do Designer.
canShareForExecutionDcm (booleano): se definido como "verdadeiro", permite ao usuário compartilhar as credenciais de conexão do DCM para executar apenas no Server.
canShareForCollaborationDcm (booleano): se definido como "verdadeiro", permite ao usuário compartilhar credenciais de conexão do DCM para colaboração.
canManageGenericVaultsDcm (booleano): se definido como "verdadeiro", permite ao usuário gerenciar cofres genéricos do DCM.
Exemplo de solicitação: 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'
Desabilitar um usuário
Para desativar um usuário no sistema, use o ponto de extremidade POST {baseURL}/v3/users/{userId}/deactivate
.
Nota
Somente administradores podem usar esse ponto de extremidade de API.
Como resposta, você obtém uma matriz de IDs de grupo de usuários dos quais o usuário desativado é removido.
Parâmetros
userId (cadeia de caracteres): obrigatório. Insira o ID do usuário para desativar este usuário.
Exemplo de solicitação: cURL
curl --location --request POST 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b/deactivate' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Enviar um e-mail de redefinição de senha para um usuário
Para enviar um e-mail de redefinição de senha para um usuário existente, use o ponto de extremidade POST {baseURL}/v3/users/{userId}/passwordReset
.
Nota
Somente administradores podem usar esse ponto de extremidade de API.
Este ponto de extremidade não pode ser utilizado em instâncias do Server configuradas para autenticação do Windows e autenticação SAML.
Parâmetros
userId (cadeia de caracteres): obrigatório. Insira o ID do usuário para enviar um e-mail de redefinição ao usuário.
Exemplo de solicitação: cURL
curl --location --request POST 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b/passwordReset' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Recuperar todos os registros de usuário
Para recuperar todos os registros de usuário acessíveis, use o ponto de extremidade GET {baseURL}/v3/users
. Use vários parâmetros como um filtro.
Nota
Somente administradores podem usar esse ponto de extremidade de API.
Se searchContract.Verbose for definido como "false" (falso), um objeto de visualização reduzido será retornado.
Parâmetros
view (cadeia de caracteres): opcional. Pode ser deixado sem um valor. Você pode escolher entre os seguintes valores: "Default" (padrão) e "Full" (completo). Se esse parâmetro for definido como "Default", um objeto de visualização reduzido será retornado. Quando não especificado, o valor "Default" é usado.
active (booleano): opcional. Selecione se um usuário está ativo ou desativado.
email (cadeia de caracteres): opcional. Insira o endereço de e-mail do usuário.
role (cadeia de caracteres): opcional. Selecione a função do usuário para restringir a pesquisa. Selecione uma destas opções: "NoAccess" (sem acesso), "Viewer" (visualizador), "Member" (membro), "Artisan" (criador), "Curator" (administrador), e "Evaluated" (avaliado). A função padrão ("Evaluated" (avaliado)) é avaliada em tempo de execução. Para obter mais informações sobre funções e permissões, visite a página Funções e permissões de usuário.
firstName (cadeia de caracteres): opcional. Insira o primeiro nome do usuário.
lastName (cadeia de caracteres): opcional. Insira o sobrenome do usuário.
createdAfter (data/hora): opcional. Insira a data e a hora após as quais o usuário foi criado. Insira a data e a hora no formato ISO8601.
createdBefore (data/hora): opcional. Insira a data e a hora antes das quais o usuário foi criado. Insira a data e a hora no formato ISO8601.
Exemplo de solicitação: cURL
curl --location --request GET 'http://localhost/webapi/v3/users?view=Full&active=true&lastName=Doe' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Recuperar detalhes sobre um usuário específico
Para recuperar detalhes sobre um usuário existente, use o ponto de extremidade GET {baseURL}/v3/users/{userId}
.
Nota
Somente administradores podem usar esse ponto de extremidade de API.
Parâmetros
userId (cadeia de caracteres): obrigatório. Insira o ID do usuário para recuperar detalhes sobre esse usuário.
Exemplo de solicitação: cURL
curl --location --request GET 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Recuperar todos os ativos que um usuário possui
Para obter uma lista completa de ativos acessíveis que um usuário existente possui, use o ponto de extremidade GET {baseURL}/v3/users/{userId}/assets
.
Nota
Somente administradores podem usar esse ponto de extremidade de API.
Parâmetros
userId (cadeia de caracteres): obrigatório. Insira o ID do usuário para recuperar a lista de ativos para esse usuário.
assetType (cadeia de caracteres): opcional. Selecione os tipos de ativos que deseja retornar. O padrão é definido como "All" (todos).
Exemplo de solicitação: cURL
curl --location --request GET 'http://localhost/webapi/v3/users/61d564361d6d5da7ad461a32/assets?assetType=Workflows' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Transferir todos os ativos que um usuário possui para outro
Para transferir todos os ativos (fluxos de trabalho, agendamentos e coleções) de propriedade de um usuário para outro, use o ponto de extremidade PUT {baseURL}/v3/users/{userId}/assetTransfer
.
Nota
Somente administradores podem usar esse ponto de extremidade de API.
Se qualquer um dos fluxos de trabalho exigir conexões do DCM, conexões do Server ou credenciais run-as específicas para ser executado, esses itens precisam ser atualizados antes que o fluxo de trabalho possa ser executado.
Se os usuários não estiverem no mesmo estúdio e quando um fluxo de trabalho for transferido para o novo estúdio, todos os outros usuários no estúdio do novo proprietário também receberão acesso ao fluxo de trabalho, e todos os usuários do antigo estúdio perderão o acesso.
Os fluxos de trabalho só podem ser transferidos para um usuário com a função de criador ou de administrador.
Se estiver transferindo agendamentos, o novo proprietário deve ter acesso ao fluxo de trabalho agendado, caso contrário, não será possível transferir esse fluxo de trabalho a ele.
Se estiver transferindo agendamentos, o novo proprietário deve ter permissão para agendar fluxos de trabalho.
Se o usuário for excluído, ele retorna uma lista de IDs de agendamento que serão falharão ou serão desabilitados após a transferência.
Parâmetros
userId (cadeia de caracteres): obrigatório. ID do usuário do qual os ativos serão transferidos.
contract (corpo):
ownerId (cadeia de caracteres): especifique o ID do usuário para o qual transferir ativos (novo proprietário).
transferworkflows (booleano): especifique se os fluxos de trabalho devem ser transferidos para o novo proprietário.
transferSchedules (booleano): especifique se os agendamentos devem ser transferidos para o novo proprietário.
transferCollections (booleano): especifique se as coleções devem ser transferidas para o novo proprietário.
Exemplo de solicitação: 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'
Atualizar um usuário existente
Para atualizar os detalhes de um usuário existente, use o ponto de extremidade PUT {baseURL}/v3/users/{userId}
.
Nota
Somente administradores podem usar esse ponto de extremidade de API.
O ID do updateContract será substituído pelo valor do ID no URL.
Parâmetros
userId (cadeia de caracteres): obrigatório. Insira o ID do usuário para que esse usuário seja atualizado.
updateContract (corpo): obrigatório. Para atualizar um usuário, o parâmetro "updateContract" é obrigatório. Especifique o seguinte:
id (cadeia de caracteres): opcional. Insira o ID do usuário para que seja atualizado.
firstName (cadeia de caracteres): obrigatório. Insira o primeiro nome de um usuário.
lastName (cadeia de caracteres): obrigatório. Insira o sobrenome de um usuário.
email (cadeia de caracteres): obrigatório. Insira o endereço de e-mail de um usuário.
role (cadeia de caracteres): obrigatório. Você pode selecionar entre estas opções: "NoAccess" (sem acesso), "Viewer" (visualizador), "Member" (membro), "Artisan" (criador), "Curator" (administrador), e "Evaluated" (avaliado). Para obter mais informações sobre funções e permissões, visite a página Funções e permissões de usuário.
defaultWorkerTag (cadeia de caracteres): obrigatório. Especifique a tag do trabalhador definida nos trabalhos para ajudar a atribuir tarefas a determinados nós de trabalho. Para obter mais informações sobre trabalhadores, visite a página de ajuda Trabalhador.
canScheduleJobs (booleano): obrigatório. Especifique se um usuário pode agendar trabalhos. Para obter mais informações, visite a página de ajuda Trabalhos.
canPrioritizeJobs (booleano): obrigatório. Especifique se um usuário pode priorizar trabalhos. Para obter mais informações, visite a página de ajuda Trabalhos.
canAssignJobs (booleano): obrigatório. Especifique se um usuário pode atribuir trabalhos. Para obter mais informações, visite a página de ajuda Trabalhos.
canCreateCollections (booleano): opcional. Especifique se um usuário pode criar coleções. Quando não especificado, o valor permanece o mesmo de antes. Para obter mais informações, visite a página de ajuda Coleções.
isApiEnabled (booleano): obrigatório. Especifique se a API está habilitada para um usuário.
defaultCredentialId (cadeia de caracteres): obrigatório. Este parâmetro refere-se ao ID exclusivo de um fluxo de trabalho, atribuído ao usuário como padrão.
isAccountLocked (booleano): obrigatório. Selecione se deseja bloquear esta conta de usuário.
isActive (booleano): obrigatório. Selecione se um usuário está ativo ou desativado.
isValidated (booleano): obrigatório. Especifique se o endereço de e-mail de um usuário está validado.
timeZone (cadeia de caracteres): obrigatório. Insira o fuso horário, por exemplo, Europa/Kiev etc.
language (cadeia de caracteres): obrigatório. Os valores de idioma com suporte são "de-de", "en-us", "es-es", "fr-fr", "it-it", "ja-jp", "pt-br" e "zh-cn".
canCreateAndUpdateDcm (booleano): se definido como "verdadeiro", permite ao usuário criar ou atualizar ativos do DCM (fontes de dados, credenciais e cofres externos). Sem essa permissão, os usuários não podem criar, editar e sincronizar seus ativos do DCM a partir do Designer.
canShareForExecutionDcm (booleano): se definido como "verdadeiro", permite ao usuário compartilhar as credenciais de conexão do DCM para executar apenas no Server.
canShareForCollaborationDcm (booleano): se definido como "verdadeiro", permite ao usuário compartilhar credenciais de conexão do DCM para colaboração.
canManageGenericVaultsDcm (booleano): se definido como "verdadeiro", permite ao usuário gerenciar cofres genéricos do DCM.
Exemplo de solicitação: 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'
Excluir um usuário
Para excluir um usuário existente do sistema, use o ponto de extremidade DELETE {baseURL}/v3/users/{userId}
.
Nota
Somente administradores podem usar esse ponto de extremidade de API.
Se o usuário que você deseja excluir tiver algum ativo (fluxos de trabalho, agendamentos, coleções) ou grupos de usuários atribuídos, esse usuário não poderá ser excluído.
Parâmetros
userId (cadeia de caracteres): obrigatório. Insira o ID do usuário que você deseja excluir.
Exemplo de solicitação: cURL
curl --location --request DELETE 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Relações de objetos
Se estiver criando um usuário, você poderá usar objetos criados da seguinte maneira:
Objeto criado: "id" (por exemplo, "id": "619158e57e607d0011ac3009")
Você pode usá-lo como:
userId se você estiver adicionando usuários a um grupo de usuários.
userId se você estiver removendo o usuário de um grupo de usuários.
userId se você estiver procurando um usuário específico.
ownerId se você estiver carregando um fluxo de trabalho.
userId se você estiver adicionando um usuário de uma coleção.
userId se você estiver removendo um usuário de uma coleção.
userId se você estiver atualizando permissões de usuário para uma coleção.
ownerId se você estiver procurando um agendamento.
userId se você desejar compartilhar uma credencial com um usuário.
userId se você desejar remover um usuário de uma credencial.
userId se você desejar adicionar um usuário a uma conexão de dados existente.
userId se você desejar remover um usuário de uma conexão de dados existente.
Exemplos de solicitações Postman
GET /v3/users

GET /v3/users/{id}/assets

Para saber mais sobre solicitações Postman, visite a página de ajuda Como usar Postman.