API d’extraction d’arborescence d’entitésFetch entity tree - Entities API

S’applique à : Microsoft Cloud App SecurityApplies to: Microsoft Cloud App Security

Important

Les noms des produits Microsoft de protection contre les menaces changent.Threat protection product names from Microsoft are changing. Vous trouverez ici plus d’informations sur ce sujet et sur les autres mises à jour.Read more about this and other updates here. Nous allons très prochainement mettre à jour les noms des produits et des documents.We'll be updating names in products and in the docs in the near future.

Notes

Cette demande n’est pas disponible pour Office 365 Cloud App Security.This request is not available for Office 365 Cloud App Security.

Exécutez la requête d’obtention pour extraire toutes les entités associées à l’entité correspondant à la clé primaire spécifiée.Run the GET request to fetch all entities related to the entity matching the specified primary key. Si l’entité est un utilisateur, extrait tous les comptes associés à l’utilisateur.If the entity is a user, fetches all accounts associated with the user. Si l’entité est un compte, extrait le parent et les frères de l’entité.If the entity is an account, fetches the entity's parent and siblings.

Demande HTTPHTTP request

GET /api/v1/entities/<pk>/retrieve_tree/

Paramètres d’URL de la requêteRequest URL parameters

ParamètreParameter DescriptionDescription
pkpk ID de l’entitéThe ID of the entity

 ExempleExample

RequêteRequest

Voici un exemple de la requête.Here is an example of the request.

curl -XPOST -H "Authorization:Token <your_token_key>" "https://<tenant_id>.<tenant_region>.contoso.com/api/v1/entities/<pk>/retrieve_tree/"

responseResponse

Retourne l’arborescence d’entités spécifiée au format JSON.Returns the specified entity tree in JSON format.

{
  // entity tree record
}

Si vous rencontrez des problèmes, nous sommes là pour vous aider.If you run into any problems, we're here to help. Pour obtenir de l’aide ou une assistance concernant votre produit, veuillez ouvrir un ticket de support.To get assistance or support for your product issue, please open a support ticket.