Points de terminaison des collections
Points de terminaison et paramètres de collections
Ajouter un utilisateur à une collection
Ajouter une analyse à une collection
Ajouter une planification à une collection
Ajouter un workflow à une collection
Ajouter un groupe d'utilisateurs à une collection
Récupérer un enregistrement de collection
Récupérer les enregistrements de toutes les collections
Mettre à jour une collection existante
Mettre à jour les autorisations utilisateur d'une collection
Mettre à jour les autorisations de groupe d'utilisateurs d'une collection
Retirer un utilisateur d'une collection
Retirer un workflow d'une collection
Retirer une analyse d'une collection
Retirer une planification d'une collection
Retirer un groupe d'utilisateurs d'une collection
Pour en savoir plus sur les relations d'objets et sur leur utilisation dans l'API, consultez la section Relations d'objets.
Pour plus d'informations sur les collections, consultez la page d'aide Collections.
Créer une collection
Pour créer une collection, utilisez le point de terminaison POST {baseURL}/v3/collections
.
Paramètres
contract (corps) : pour créer une collection, le paramètre « contract » est obligatoire. Indiquez les éléments suivants pour créer une collection :
name (chaîne) : obligatoire. Indiquez un nom de collection.
Exemple de demande : 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'
Ajouter un utilisateur à une collection
Pour ajouter un utilisateur à une collection, utilisez le point de terminaison POST {baseURL}/v3/collections/{collectionId}/users
.
![082A8515AB7ADDAAD5B04255CF2AE567.png](../../../../image/uuid-55b303e1-cff5-6062-d8e6-c24f4b9faad9.png)
Paramètres
collectionId (chaîne) : obligatoire. Saisissez un ID de collection pour préciser la collection à laquelle ajouter un utilisateur.
addUsersContract (corps) : obligatoire. Saisissez une information sur les utilisateurs et leurs autorisations. Indiquez les éléments suivants pour ajouter des utilisateurs à une collection :
userId (chaîne) : obligatoire. Indiquez un ID d'utilisateur que vous souhaitez ajouter à une collection.
expirationDate (chaîne) : facultatif. Précisez la date jusqu'à laquelle l'utilisateur peut faire partie de cette collection. Saisissez la date et l'heure au format ISO8601.
collectionsPermissions (corps) :
isAdmin (booléen) : obligatoire. Indiquez si l'utilisateur doit être administrateur pour cette collection.
canAddAssets (booléen) : obligatoire. Indiquez si l'utilisateur peut ajouter des ressources à la collection.
canUpdateAssets (booléen) : obligatoire. Indiquez si l'utilisateur peut mettre à jour les ressources de la collection.
canRemoveAssets (booléen) : obligatoire. Indiquez si l'utilisateur peut retirer des ressources de la collection.
canAddUsers (booléen) : facultatif. Indiquez si l'utilisateur peut ajouter d'autres utilisateurs à la collection.
canRemoveUsers (booléen) : facultatif. Indiquez si l'utilisateur peut retirer des utilisateurs de la collection.
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 par défaut est celui indiqué par un administrateur Server dans l'interface Administrateur.
Exemple de demande : 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'
Revenir à la vue d'ensemble des points de terminaison de la collection.
Ajouter une analyse à une collection
Pour ajouter une analyse à une collection, utilisez le point de terminaison POST {baseURL}/v3/collections/{collectionId}/insights
.
Paramètres
collectionId (chaîne) : obligatoire. Saisissez un ID de collection pour préciser la collection à laquelle ajouter une analyse.
contract (corps) : obligatoire. Saisissez une information sur l'analyse. Indiquez les éléments suivants :
insightId (chaîne) : obligatoire. Indiquez l'ID de l'analyse que vous souhaitez ajouter à la collection.
Exemple de demande : 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'
Revenir à la vue d'ensemble des points de terminaison de la collection.
Ajouter une planification à une collection
Pour ajouter une planification à une collection, utilisez le point de terminaison POST {baseURL}/v3/collections/{collectionId}/schedules
.
Paramètres
collectionId (chaîne) : obligatoire. Saisissez un ID de collection pour préciser la collection à laquelle ajouter une planification.
contract (corps) : obligatoire. Saisissez une information sur la planification. Indiquez les éléments suivants :
scheduleId (chaîne) : obligatoire. Indiquez l'ID de la planification que vous souhaitez ajouter à la collection.
Exemple de demande : 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'
Revenir à la vue d'ensemble des points de terminaison de la collection.
Ajouter un workflow à une collection
Pour ajouter un workflow à une collection, utilisez le point de terminaison POST {baseURL}/v3/collections/{collectionId}/workflows
.
Paramètres
collectionId (chaîne) : obligatoire. Saisissez un ID de collection pour préciser la collection à laquelle ajouter une analyse.
contract (corps) : obligatoire. Saisissez une information sur les utilisateurs et leurs autorisations. Indiquez les éléments suivants :
workflowId (chaîne) : obligatoire. Indiquez l'ID du workflow que vous souhaitez ajouter à la collection.
Exemple de demande : 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'
Revenir à la vue d'ensemble des points de terminaison de la collection.
Ajouter un groupe d'utilisateurs à une collection
Pour ajouter un groupe d'utilisateurs à une collection, utilisez le point de terminaison POST {baseURL}/v3/collections/{collectionId}/userGroups
.
Paramètres
collectionId (chaîne) : obligatoire. Saisissez un ID de collection pour préciser la collection à laquelle ajouter un groupe d'utilisateurs.
addUserGroupsContract (corps) : obligatoire. Saisissez une information sur le groupe d'utilisateurs et ses autorisations. Indiquez les éléments suivants :
userGroupId (chaîne) : obligatoire. Indiquez un ID de groupe d'utilisateurs que vous souhaitez ajouter à une collection.
expirationDate (chaîne) : facultatif. Précisez la date jusqu'à laquelle le groupe d'utilisateurs peut faire partie de cette collection. Saisissez la date et l'heure après lesquelles l'utilisateur a été créé au format ISO8601.
collectionsPermissions (corps) : obligatoire.
isAdmin (booléen) : facultatif. Indiquez si les membres du groupe d'utilisateurs doivent être administrateurs pour cette collection. Valeur par défaut : false.
canAddAssets (booléen) : facultatif. Indiquez si les membres du groupe d'utilisateurs peuvent ajouter des ressources à la collection. Valeur par défaut : false.
canRemoveAssets (booléen) : facultatif. Indiquez si les membres du groupe d'utilisateurs peuvent retirer des ressources de la collection. Valeur par défaut : false.
canUpdateAssets (booléen) : facultatif. Indiquez si les membres du groupe d'utilisateurs peuvent mettre à jour des ressources de la collection. Valeur par défaut : false.
canAddUsers (booléen) : facultatif. Indiquez si les membres du groupe d'utilisateurs peuvent ajouter d'autres utilisateurs à la collection. Valeur par défaut : false.
canRemoveUsers (booléen) : obligatoire. Indiquez si les membres du groupe d'utilisateurs peuvent retirer d'autres utilisateurs de la collection. Valeur par défaut : false.
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 par défaut est celui indiqué par un administrateur Server dans l'interface Administrateur.
Exemple de demande : 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'
Revenir à la vue d'ensemble des points de terminaison de la collection.
Récupérer un enregistrement de collection
Pour récupérer des informations sur une collection, utilisez le point de terminaison GET {baseURL}/v3/collections/{collectionId}
.
Paramètres
collectionId (chaîne) : obligatoire. Saisissez un ID de collection pour obtenir les informations relatives à la collection.
Exemple de demande : cURL
curl --location --request GET 'http://localhost/webapi/v3/collections/a374ce806fd4488a8a5f07da1005334c' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Revenir à la vue d'ensemble des points de terminaison de la collection.
Récupérer les enregistrements de toutes les collections
Pour récupérer tous les enregistrements de collection accessibles, utilisez le point de terminaison GET {baseURL}/v3/collections
.
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.
Exemple de demande : cURL
curl --location --request GET 'http://localhost/webapi/v3/collections?view=Full' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Revenir à la vue d'ensemble des points de terminaison de la collection.
Mettre à jour une collection existante
Pour modifier le nom ou le propriétaire d'une collection, utilisez le point de terminaison PUT {baseURL}/v3/collections/{collectionId}
.
Paramètres
collectionId (chaîne) : obligatoire. Saisissez un ID de collection pour préciser la collection à mettre à jour.
updateCollectionContract (corps) : obligatoire. Saisissez des informations sur le propriétaire de la collection à modifier. Indiquez les éléments suivants :
name (chaîne) : obligatoire. Saisissez le nouveau nom de la collection.
ownerId (chaîne) : obligatoire. Saisissez l'ID du nouveau propriétaire.
Exemple de demande : 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'
Revenir à la vue d'ensemble des points de terminaison de la collection.
Mettre à jour les autorisations utilisateur d'une collection
Pour mettre à jour les autorisations de l'utilisateur pour une collection spécifique, utilisez le point de terminaison PUT {baseURL}/v3/collections/{collectionId}/users/{userId}/permissions
.
Paramètres
collectionId (chaîne) : obligatoire. Saisissez un ID de collection pour préciser la collection à mettre à jour.
userId (chaîne) : obligatoire. Saisissez un ID d'utilisateur dont vous souhaitez modifier les autorisations.
updatePermissionsContract (corps) : obligatoire. Saisissez l'ID d'utilisateur pour lequel vous souhaitez modifier les autorisations. Indiquez les éléments suivants :
expirationDate (date) : obligatoire. Indiquez la date d'expiration d'un utilisateur.
collectionsPermissions (corps) : obligatoire. Saisissez l'ID d'utilisateur du nouveau propriétaire. Indiquez les éléments suivants :
isAdmin (booléen) : obligatoire. Indiquez si l'utilisateur doit être administrateur pour cette collection.
canAddAssets (booléen) : obligatoire. Indiquez si l'utilisateur peut ajouter des ressources à la collection.
canRemoveAssets (booléen) : obligatoire. Indiquez si l'utilisateur peut retirer des ressources de la collection.
canUpdateAssets (booléen) : obligatoire. Indiquez si l'utilisateur peut mettre à jour les ressources de la collection.
canAddUsers (booléen) : obligatoire. Indiquez si l'utilisateur peut ajouter d'autres utilisateurs à la collection.
canRemoveUsers (booléen) : obligatoire. Indiquez si l'utilisateur peut retirer d'autres utilisateurs de la collection.
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 par défaut est celui indiqué par un administrateur Server dans l'interface Administrateur.
Exemple de demande : 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'
Revenir à la vue d'ensemble des points de terminaison de la collection.
Mettre à jour les autorisations de groupe d'utilisateurs d'une collection
Pour mettre à jour les autorisations du groupe d'utilisateurs pour une collection spécifique, utilisez le point de terminaison PUT {baseURL}/v3/collections/{collectionId}/userGroups/{userGroupId}/permissions
.
Paramètres
collectionId (chaîne) : obligatoire. Saisissez un ID de collection pour préciser la collection à mettre à jour.
userGroupId (chaîne) : obligatoire. Saisissez un ID de groupe d'utilisateurs dont vous souhaitez modifier les autorisations.
updatePermissionsContract (corps) : obligatoire. Saisissez l'ID de groupe d'utilisateurs pour lequel vous souhaitez modifier les autorisations. Indiquez les éléments suivants :
expirationDate (date) : facultatif. Indiquez la date d'expiration d'un groupe d'utilisateurs.
collectionsPermissions (corps) : obligatoire. Indiquez les éléments suivants :
isAdmin (booléen) : obligatoire. Indiquez si les membres du groupe d'utilisateurs doivent être administrateurs pour cette collection.
canAddAssets (booléen) : obligatoire. Indiquez si les membres du groupe d'utilisateurs peuvent ajouter des ressources à la collection.
canRemoveAssets (booléen) : obligatoire. Indiquez si les membres du groupe d'utilisateurs peuvent retirer des ressources de la collection.
canUpdateAssets (booléen) : obligatoire. Indiquez si les membres du groupe d'utilisateurs peuvent mettre à jour des ressources de la collection.
canAddUsers (booléen) : obligatoire. Indiquez si les membres du groupe d'utilisateurs peuvent ajouter d'autres utilisateurs à la collection.
canRemoveUsers (booléen) : obligatoire. Indiquez si les membres du groupe d'utilisateurs peuvent retirer des utilisateurs de la collection.
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 par défaut est celui indiqué par un administrateur Server dans l'interface Administrateur.
Exemple de demande : 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'
Revenir à la vue d'ensemble des points de terminaison de la collection.
Retirer un utilisateur d'une collection
Pour retirer un utilisateur d'une collection, utilisez le point de terminaison DELETE {baseURL}/v3/collections/{collectionId}/users/{userId}
.
Paramètres
collectionId (chaîne) : obligatoire. Saisissez un ID de collection pour préciser la collection à mettre à jour.
userId (chaîne) : obligatoire. Saisissez un ID d'utilisateur que vous souhaitez retirer de la collection.
Exemple de demande : cURL
curl --location --request DELETE 'http://localhost/webapi/v3/collections/a374ce806fd4488a8a5f07da1005334c/users/61db388fc565144387d45086' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Revenir à la vue d'ensemble des points de terminaison de la collection.
Retirer un workflow d'une collection
Pour retirer un workflow d'une collection, utilisez le point de terminaison DELETE {baseURL}/v3/collections/{collectionId}/workflows/{appId}
.
Paramètres
collectionId (chaîne) : obligatoire. Saisissez un ID de collection pour préciser la collection à mettre à jour.
appId (chaîne) : obligatoire. Saisissez un ID de workflow que vous souhaitez retirer de la collection.
Exemple de demande : cURL
curl --location --request DELETE 'http://localhost/webapi/v3/collections/a374ce806fd4488a8a5f07da1005334c/workflows/61db388fc565144387d45086' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Revenir à la vue d'ensemble des points de terminaison de la collection.
Retirer une analyse d'une collection
Pour retirer une analyse d'une collection, utilisez le point de terminaison DELETE {baseURL}/v3/collections/{collectionId}/insights/{insightId}
.
Paramètres
collectionId (chaîne) : obligatoire. Saisissez un ID de collection pour préciser la collection à mettre à jour.
insightId (chaîne) : obligatoire. Saisissez un ID d'analyse que vous souhaitez retirer de la collection.
Exemple de demande : cURL
curl --location --request DELETE 'http://localhost/webapi/v3/collections/a374ce806fd4488a8a5f07da1005334c/insights/61db388fc565144387d450867' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Revenir à la vue d'ensemble des points de terminaison de la collection.
Retirer une planification d'une collection
Pour retirer une planification d'une collection, utilisez le point de terminaison DELETE {baseURL}/v3/collections/{collectionId}/schedules/{scheduleId}
.
Paramètres
collectionId (chaîne) : obligatoire. Saisissez un ID de collection pour préciser la collection à mettre à jour.
scheduleId (chaîne) : obligatoire. Saisissez un ID de planification que vous souhaitez retirer de la collection.
Exemple de demande : cURL
curl --location --request DELETE 'http://localhost/webapi/v3/collections/a374ce806fd4488a8a5f07da1005334c/schedules/61db3777c565144387d450867' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Revenir à la vue d'ensemble des points de terminaison de la collection.
Retirer un groupe d'utilisateurs d'une collection
Pour retirer un groupe d'utilisateurs d'une collection, utilisez le point de terminaison DELETE {baseURL}/v3/collections/{collectionId}/userGroups/{userGroupId}
.
Paramètres
collectionId (chaîne) : obligatoire. Saisissez un ID de collection pour préciser la collection à mettre à jour.
userGroupId (chaîne) : obligatoire. Saisissez un ID de groupe d'utilisateurs que vous souhaitez retirer de la collection.
Exemple de demande : cURL
curl --location --request DELETE 'http://localhost/webapi/v3/collections/a374ce806fd4488a8a5f07da1005334c/userGroups/61dc063d9938fe43b5e8fc80' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Revenir à la vue d'ensemble des points de terminaison de la collection.
Supprimer une collection
Pour supprimer une collection, utilisez le point de terminaison DELETE {baseURL}/v3/collections/{collectionId}
.
Paramètres
collectionId (chaîne) : obligatoire. Saisissez un ID de collection pour préciser la collection à mettre à jour.
forceDelete (booléen) : facultatif. Indiquez si vous souhaitez forcer la suppression d'une collection au cas où cette collection contiendrait des liens vers d'autres objets, tels que des utilisateurs, des groupes, des workflows, des analyses et des planifications. Si vous voulez supprimer la collection et nettoyer tous les liens, définissez le paramètre « forceDelete » sur « vrai ». Lorsque cette option n'est pas sélectionnée, la valeur par défaut est « faux ». Ce paramètre vous protège des appels erronés.
Exemple de demande : cURL
curl --location --request DELETE 'http://localhost/webapi/v3/collections/253fcf0b10204dc085f07bdf1b40e759?forceDelete=true' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Revenir à la vue d'ensemble des points de terminaison de la collection.
Relations d'objets
Si vous créez une collection, vous pouvez utiliser les objets créés comme suit :
Objet créé : « id » (par exemple, « id » : « 7917969784f84bd09442f66996ecb8f3 »)
Vous pouvez l'utiliser comme :
collectionId si vous recherchez une collection spécifique.
collectionId si vous ajoutez des utilisateurs, groupes d'utilisateurs, workflows, analyses ou planifications à une collection.
collectionId si vous mettez à jour une collection existante.
collectionId si vous souhaitez supprimer une collection spécifique.
Exemples de demandes Postman
POST /v3/collections
![Use POST /v3/collections endpoint.](../../../../image/uuid-67d6ebf1-8811-729d-e625-40dc5fb8339f.png)
GET /v3/collections/
![Use GET /v3/collections endpoint.](../../../../image/uuid-024f2d77-2817-88df-072a-c52249042113.png)
PUT /v3/collections/{collectionId}
![Use PUT /v3/collections/{collectionId} endpoint.](../../../../image/uuid-84c5000b-785b-43ee-650e-5de6441de9f7.png)
Pour en savoir plus sur les demandes Postman, consultez la page d'aide Comment utiliser Postman.