Pontos de extremidade de coleções

Pontos de extremidade de coleções e parâmetros

Para saber mais sobre as relações de objetos e como usá-las na API, vá para a seção Relações de objetos.

Para obter mais informações sobre coleções, visite a página de ajuda Coleções.Coleções: interface de administrador

Criar uma coleção

Para criar uma coleção, use o ponto de extremidade POST {baseURL}/v3/collections.

Parâmetros

contract (corpo): para criar uma nova coleção, o parâmetro "contract" é obrigatório. Especifique o seguinte para criar uma coleção:
- name (cadeia de caracteres): obrigatório. Especifique um nome de coleção.

Exemplo de solicitação: cURL

curl --location --request POST 'http://localhost/webapi//v3/collections' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Authorization: Bearer BearerTokenGoesHere' \ --data-urlencode 'name=Accounting'

Adicionar um usuário a uma coleção

Para adicionar um usuário a uma coleção, use o ponto de extremidade POST {baseURL}/v3/collections/{collectionId}/users.

Parâmetros

collectionId (cadeia de caracteres): obrigatório. Insira um ID de coleção para especificar a coleção à qual pretende adicionar um usuário.
addUsersContract (corpo): obrigatório. Insira uma informação sobre os usuários e suas permissões. Especifique o seguinte para adicionar usuários a uma coleção:
- userId (cadeia de caracteres): obrigatório. Especifique o ID de um usuário que você deseja adicionar a uma coleção.
- expirationDate (cadeia de caracteres): opcional. Especifique a data de vencimento para que o usuário faça parte desta coleção. Insira a data e a hora no formato ISO8601.
- collectionsPermissions (corpo):
  - isAdmin (booleano): obrigatório. Especifique se o usuário deve ser administrador desta coleção.
  - canAddAssets (booleano): obrigatório. Especifique se o usuário pode adicionar ativos à coleção.
  - canUpdateAssets (booleano): obrigatório. Especifique se o usuário pode atualizar ativos na coleção.
  - canRemoveAssets (booleano): obrigatório. Especifique se o usuário pode remover ativos da coleção.
  - canAddUsers (booleano): opcional. Especifique se o usuário pode adicionar outros usuários à coleção.
  - canRemoveUsers (booleano): opcional. Especifique se o usuário pode remover usuários da coleçã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 padrão conforme especificado por um administrador nainterface de administrador.Funções e permissões de usuário

Exemplo de solicitação: cURL

curl --location --request POST 'http://localhost/webapi//v3/collections/7917969784f84bd09442f66996ecb8f3/users' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Authorization: Bearer BearerTokenGoesHere' \ --data-urlencode 'userId=61d80f862835728c94328082' \ --data-urlencode 'isAdmin=true' \ --data-urlencode 'canAddAssets=true' \ --data-urlencode 'canRemoveAssets=true' \ --data-urlencode 'canUpdateAssets=true' \ --data-urlencode 'canAddUsers=true' \ --data-urlencode 'canRemoveUsers=true' \ --data-urlencode 'expirationDate=2007-08-17T19:18:11.924Z'

Voltar para Visão geral dos pontos de extremidade da coleção.

Adicionar um insight a uma coleção

Para adicionar um insight a uma coleção, use o ponto de extremidade POST {baseURL}/v3/collections/{collectionId}/insights.

Parâmetros

collectionId (cadeia de caracteres): obrigatório. Insira um ID de coleção para especificar a coleção à qual adicionar um insight.
contract (corpo): obrigatório. Insira uma informação sobre o insight. Especifique o seguinte:
- insightId (cadeia de caracteres): obrigatório. Especifique o ID do insight que você deseja adicionar à coleção.

Exemplo de solicitação: cUrl

curl --location --request POST 'http://localhost/webapi//v3/collections/472dfff22086458d935d4edf348a1e2b/insights' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Authorization: Bearer BearerTokenGoesHere' \ --data-urlencode 'insightId=61d80f33452835728c94328082'

Voltar para Visão geral dos pontos de extremidade da coleção.

Adicionar um agendamento a uma coleção

Para adicionar um agendamento a uma coleção, use o ponto de extremidade POST {baseURL}/v3/collections/{collectionId}/schedules.

Parâmetros

collectionId (cadeia de caracteres): obrigatório. Insira um ID de coleção para especificar a coleção à qual adicionar um agendamento.
contract (corpo): obrigatório. Insira uma informação sobre o agendamento. Especifique o seguinte:
- scheduleId (cadeia de caracteres): obrigatório. Especifique o ID do agendamento que deseja adicionar à coleção.

Exemplo de solicitação: cURL

curl --location --request POST 'http://localhost/webapi//v3/collections/7917969784f84bd09442f66996ecb8f3/schedules' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Authorization: Bearer BearerTokenGoesHere' \ --data-urlencode 'scheduleId=61d80f334528377728c94328082'

Voltar para Visão geral dos pontos de extremidade da coleção.

Adicionar um fluxo de trabalho a uma coleção

Para adicionar um fluxo de trabalho a uma coleção, use o ponto de extremidade POST {baseURL}/v3/collections/{collectionId}/workflows.

Parâmetros

collectionId (cadeia de caracteres): obrigatório. Insira um ID de coleção para especificar a coleção à qual adicionar um insight.
contract (corpo): obrigatório. Insira uma informação sobre os usuários e suas permissões. Especifique o seguinte:
- workflowId (cadeia de caracteres): obrigatório. Especifique o ID do fluxo de trabalho que deseja adicionar à coleção.

Exemplo de solicitação: cURL

curl --location --request POST 'http://localhost/webapi//v3/collections/7917969784f84bd09442f66996ecb8f3/workflows' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Authorization: Bearer BearerTokenGoesHere' \ --data-urlencode 'workflowId=61d80f334223377728c9432'

Voltar para Visão geral dos pontos de extremidade da coleção.

Adicionar um grupo de usuários a uma coleção

Para adicionar um grupo de usuários a uma coleção, use o ponto de extremidade POST {baseURL}/v3/collections/{collectionId}/userGroups.

Parâmetros

collectionId (cadeia de caracteres): obrigatório. Insira um ID de coleção para especificar a coleção à qual deseja adicionar um grupo de usuários.
addUserGroupsContract (corpo): obrigatório. Insira uma informação sobre o grupo de usuários e suas permissões. Especifique o seguinte:
- userGroupId (cadeia de caracteres): obrigatório. Especifique o ID de um grupo de usuários que você deseja adicionar a uma coleção.
- expirationDate (cadeia de caracteres): opcional. Especifique a data de vencimento para que o grupo de usuários faça parte desta coleção. Insira a data e a hora após as quais o usuário foi criado no formato ISO8601.
- collectionsPermissions (corpo): obrigatório.
  - isAdmin (booleano): opcional. Especifique se os membros do grupo de usuários devem ser administradores desta coleção. O padrão é "false" (falso).
  - canAddAssets (booleano): opcional. Especifique se os membros do grupo de usuários podem adicionar ativos à coleção. O padrão é "false" (falso).
  - canRemoveAssets (booleano): opcional. Especifique se os membros do grupo de usuários podem remover ativos da coleção. O padrão é "false" (falso).
  - canUpdateAssets (booleano): opcional. Especifique se os membros do grupo de usuários podem atualizar ativos na coleção. O padrão é "false" (falso).
  - canAddUsers (booleano): opcional. Especifique se os membros do grupo de usuários podem adicionar outros usuários à coleção. O padrão é "false" (falso).
  - canRemoveUsers (booleano): obrigatório. Especifique se os membros do grupo de usuários podem remover outros usuários da coleção. O padrão é "false" (falso).

Exemplo de solicitação: cURL

curl --location --request POST 'http://localhost/webapi//v3/collections/7917969784f84bd09442f66996ecb8f3/userGroups?addUserGroupsContract' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Authorization: Bearer BearerTokenGoesHere' \ --data-urlencode 'userGroupId=61d83e2ef778247f14e8e6b6' \ --data-urlencode 'isAdmin=true' \ --data-urlencode 'canAddAssets=false' \ --data-urlencode 'canRemoveAssets=true' \ --data-urlencode 'canUpdateAssets=false' \ --data-urlencode 'canAddUsers=true' \ --data-urlencode 'canRemoveUsers=true'

Voltar para Visão geral dos pontos de extremidade da coleção.

Recuperar um registro de coleção

Para recuperar informações sobre uma coleção, use o ponto de extremidade GET {baseURL}/v3/collections/{collectionId}.

Parâmetros

collectionId (cadeia de caracteres): obrigatório. Insira um ID de coleção para obter as informações sobre a coleção.

Exemplo de solicitação: cURL

curl --location --request GET 'http://localhost/webapi/v3/collections/a374ce806fd4488a8a5f07da1005334c' \ --header 'Authorization: Bearer BearerTokenGoesHere'

Voltar para Visão geral dos pontos de extremidade da coleção.

Recuperar registros de todas as coleções

Para recuperar todos os registros de coleção acessíveis, use o ponto de extremidade GET {baseURL}/v3/collections.

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.

Exemplo de solicitação: cURL

curl --location --request GET 'http://localhost/webapi/v3/collections?view=Full' \ --header 'Authorization: Bearer BearerTokenGoesHere'

Voltar para Visão geral dos pontos de extremidade da coleção.

Atualizar uma coleção existente

Para alterar o nome ou o proprietário de uma coleção, use o ponto de extremidade PUT {baseURL}/v3/collections/{collectionId}.

Parâmetros

collectionId (cadeia de caracteres): obrigatório. Insira o ID da coleção para especificar a coleção que deseja atualizar.
updateCollectionContract (corpo): obrigatório. Insira informações sobre o proprietário da coleção que você deseja alterar. Especifique o seguinte:
- name (cadeia de caracteres): obrigatório. Insira o novo nome da coleção.
- ownerId (cadeia de caracteres): obrigatório. Insira o ID do novo proprietário.

Exemplo de solicitação: cURL

curl --location --request PUT 'http://localhost/webapi/v3/collections/a374ce806fd4488a8a5f07da1005334c' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Authorization: Bearer BearerTokenGoesHere' \ --data-urlencode 'name=Accounting' \ --data-urlencode 'ownerId=61db388fc565144387d45086'

Voltar para Visão geral dos pontos de extremidade da coleção.

Atualizar permissões de usuário de uma coleção

Para atualizar as permissões de usuário para uma determinada coleção, use o ponto de extremidade PUT {baseURL}/v3/collections/{collectionId}/users/{userId}/permissions.

Parâmetros

collectionId (cadeia de caracteres): obrigatório. Insira o ID da coleção para especificar a coleção que deseja atualizar.
userId (cadeia de caracteres): obrigatório. Insira o ID do usuário para o qual deseja alterar as permissões.
updatePermissionsContract (corpo): obrigatório. Insira o ID do usuário para o qual deseja alterar permissões. Especifique o seguinte:
- expirationDate (data): obrigatório. Especifique a data de vencimento de um usuário.
- collectionsPermissions (corpo): obrigatório. Insira o ID do usuário do novo proprietário. Especifique o seguinte:
  - isAdmin (booleano): obrigatório. Especifique se o usuário deve ser administrador desta coleção.
  - canAddAssets (booleano): obrigatório. Especifique se o usuário pode adicionar ativos à coleção.
  - canRemoveAssets (booleano): obrigatório. Especifique se o usuário pode remover ativos da coleção.
  - canUpdateAssets (booleano): obrigatório. Especifique se o usuário pode atualizar ativos na coleção.
  - canAddUsers (booleano): obrigatório. Especifique se o usuário pode adicionar outros usuários à coleção.
  - canRemoveUsers (booleano): obrigatório. Especifique se o usuário pode remover outros usuários da coleção.

Exemplo de solicitação: cURL

curl --location --request PUT 'http://localhost/webapi/v3/collections/a374ce806fd4488a8a5f07da1005334c/users/61db388fc565144387d45086/permissions' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Authorization: Bearer BearerTokenGoesHere' \ --data-urlencode 'isAdmin=true' \ --data-urlencode 'canAddAssets=true' \ --data-urlencode 'canRemoveAssets=true' \ --data-urlencode 'canUpdateAssets=true' \ --data-urlencode 'canAddUsers=true' \ --data-urlencode 'canRemoveUsers=true'

Voltar para Visão geral dos pontos de extremidade da coleção.

Atualizar permissões do grupo de usuários de uma coleção

Para atualizar permissões de um grupo de usuários para uma determinada coleção, use o ponto de extremidade PUT {baseURL}/v3/collections/{collectionId}/userGroups/{userGroupId}/permissions.

Parâmetros

collectionId (cadeia de caracteres): obrigatório. Insira o ID da coleção para especificar a coleção que deseja atualizar.
userGroupId (cadeia de caracteres): obrigatório. Insira o ID do grupo de usuários para o qual deseja alterar as permissões.
updatePermissionsContract (corpo): obrigatório. Insira o ID do grupo de usuários para o qual deseja alterar permissões. Especifique o seguinte:
- expirationDate (data): opcional. Especifique a data de vencimento para um grupo de usuários.
- collectionsPermissions (corpo): obrigatório. Especifique o seguinte:
  - isAdmin (booleano): obrigatório. Especifique se os membros do grupo de usuários devem ser administradores desta coleção.
  - canAddAssets (booleano): obrigatório. Especifique se os membros do grupo de usuários podem adicionar ativos à coleção.
  - canRemoveAssets (booleano): obrigatório. Especifique se os membros do grupo de usuários podem remover ativos da coleção.
  - canUpdateAssets (booleano): obrigatório. Especifique se os membros do grupo de usuários podem atualizar ativos na coleção.
  - canAddUsers (booleano): obrigatório. Especifique se os membros do grupo de usuários podem adicionar outros usuários à coleção.
  - canRemoveUsers (booleano): obrigatório. Especifique se os membros do grupo de usuários podem remover usuários da coleção.

Exemplo de solicitação: cURL

curl --location --request PUT 'http://localhost/webapi/v3/collections/a374ce806fd4488a8a5f07da1005334c/userGroups/61db38834tssrdrs4cc65144387d4508/permissions' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Authorization: Bearer BearerTokenGoesHere' \ --data-urlencode 'isAdmin=true' \ --data-urlencode 'canAddAssets=true' \ --data-urlencode 'canRemoveAssets=false' \ --data-urlencode 'canUpdateAssets=true' \ --data-urlencode 'canAddUsers=true' \ --data-urlencode 'canRemoveUsers=true'

Voltar para Visão geral dos pontos de extremidade da coleção.

Remover um usuário de uma coleção

Para remover um usuário de uma coleção, use o ponto de extremidade DELETE {baseURL}/v3/collections/{collectionId}/users/{userId}.

Parâmetros

collectionId (cadeia de caracteres): obrigatório. Insira o ID da coleção para especificar a coleção que deseja atualizar.
userId (cadeia de caracteres): obrigatório. Insira o ID do usuário que deseja remover da coleção.

Exemplo de solicitação: cURL

curl --location --request DELETE 'http://localhost/webapi/v3/collections/a374ce806fd4488a8a5f07da1005334c/users/61db388fc565144387d45086' \ --header 'Authorization: Bearer BearerTokenGoesHere'

Voltar para Visão geral dos pontos de extremidade da coleção.

Remover um fluxo de trabalho de uma coleção

Para remover um fluxo de trabalho de uma coleção, use o ponto de extremidade DELETE {baseURL}/v3/collections/{collectionId}/workflows/{appId}.

Parâmetros

collectionId (cadeia de caracteres): obrigatório. Insira o ID da coleção para especificar a coleção que deseja atualizar.
appId (cadeia de caracteres): obrigatório. Insira o ID do fluxo de trabalho que deseja remover da coleção.

Exemplo de solicitação: cURL

curl --location --request DELETE 'http://localhost/webapi/v3/collections/a374ce806fd4488a8a5f07da1005334c/workflows/61db388fc565144387d45086' \ --header 'Authorization: Bearer BearerTokenGoesHere'

Voltar para Visão geral dos pontos de extremidade da coleção.

Remover um insight de uma coleção

Para remover um insight de uma coleção, use o ponto de extremidade DELETE {baseURL}/v3/collections/{collectionId}/insights/{insightId}.

Parâmetros

collectionId (cadeia de caracteres): obrigatório. Insira o ID da coleção para especificar a coleção que deseja atualizar.
insightId (cadeia de caracteres): obrigatório. Insira o ID do Insight que deseja remover da coleção.

Exemplo de solicitação: cURL

curl --location --request DELETE 'http://localhost/webapi/v3/collections/a374ce806fd4488a8a5f07da1005334c/insights/61db388fc565144387d450867' \ --header 'Authorization: Bearer BearerTokenGoesHere'

Voltar para Visão geral dos pontos de extremidade da coleção.

Remover um agendamento de uma coleção

Para remover um agendamento de uma coleção, use o ponto de extremidade DELETE {baseURL}/v3/collections/{collectionId}/schedules/{scheduleId}.

Parâmetros

collectionId (cadeia de caracteres): obrigatório. Insira o ID da coleção para especificar a coleção que deseja atualizar.
scheduleId (cadeia de caracteres): obrigatório. Insira o ID do agendamento que deseja remover da coleção.

Exemplo de solicitação: cURL

curl --location --request DELETE 'http://localhost/webapi/v3/collections/a374ce806fd4488a8a5f07da1005334c/schedules/61db3777c565144387d450867' \ --header 'Authorization: Bearer BearerTokenGoesHere'

Voltar para Visão geral dos pontos de extremidade da coleção.

Remover um grupo de usuários de uma coleção

Para remover um grupo de usuários de uma coleção, use o ponto de extremidade DELETE {baseURL}/v3/collections/{collectionId}/userGroups/{userGroupId}.

Parâmetros

collectionId (cadeia de caracteres): obrigatório. Insira o ID da coleção para especificar a coleção que deseja atualizar.
userGroupId (cadeia de caracteres): obrigatório. Insira o ID do grupo de usuários que você deseja remover da coleção.

Exemplo de solicitação: cURL

curl --location --request DELETE 'http://localhost/webapi/v3/collections/a374ce806fd4488a8a5f07da1005334c/userGroups/61dc063d9938fe43b5e8fc80' \ --header 'Authorization: Bearer BearerTokenGoesHere'

Voltar para Visão geral dos pontos de extremidade da coleção.

Excluir uma coleção

Para excluir uma coleção, use o ponto de extremidade DELETE {baseURL}/v3/collections/{collectionId}.

Parâmetros

collectionId (cadeia de caracteres): obrigatório. Insira o ID da coleção para especificar a coleção que deseja atualizar.
forceDelete (booleano): opcional. Selecione se deseja forçar a exclusão de uma coleção caso essa coleção tenha links para outros objetos, como usuários, grupos, fluxos de trabalho, insights e agendamentos. Se desejar que a coleção seja excluída e todos os links sejam apagados, defina o parâmetro forceDelete como "true" (verdadeiro). Quando não selecionado, o valor padrão é "false" (falso). Esse parâmetro é usado para proteger contra uma chamada errada.

Exemplo de solicitação: cURL

curl --location --request DELETE 'http://localhost/webapi/v3/collections/253fcf0b10204dc085f07bdf1b40e759?forceDelete=true' \ --header 'Authorization: Bearer BearerTokenGoesHere'

Voltar para Visão geral dos pontos de extremidade da coleção.

Relações de objetos

Se estiver criando uma coleção, você poderá usar objetos criados da seguinte maneira:

Objeto criado: "id" (por exemplo, "id": "7917969784f84bd09442f66996ecb8f3")

Você pode usá-lo como:

collectionId se estiver procurando uma coleção específica.
collectionId se estiver adicionando usuários, grupos de usuários, fluxos de trabalho, insights ou agendamentos a uma coleção.
collectionId se estiver atualizando uma coleção existente.
collectionId se quiser excluir uma coleção específica.

Exemplos de solicitações Postman

POST /v3/collections

GET /v3/collections/

PUT /v3/collections/{collectionId}

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

Nesta secção:

Pontos de extremidade de coleções