Note
We’ve renamed Microsoft Cloud App Security. It’s now called Microsoft Defender for Cloud Apps. In the coming weeks, we’ll update the screenshots and instructions here and in related pages. For more information about the change, see this announcement. To learn more about the recent renaming of Microsoft security services, see the Microsoft Ignite Security blog.
Note
This request is not available for Office 365 Cloud App Security.
Run the GET request to fetch all entities related to the entity matching the specified primary key. If the entity is a user, fetches all accounts associated with the user. If the entity is an account, fetches the entity’s parent and siblings.
HTTP request
GET /api/v1/entities/<pk>/retrieve_tree/
Request URL parameters
| Parameter | Description |
|---|---|
| pk | The ID of the entity |
Example
Request
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/"
Response
Returns the specified entity tree in JSON format.
{
// entity tree record
}
If you run into any problems, we’re here to help. To get assistance or support for your product issue, please open a support ticket.