Hämta entitets träd – entitets-APIFetch entity tree - Entities API

Gäller för: Microsoft Cloud App SecurityApplies to: Microsoft Cloud App Security

Viktigt

Hot skydds produkt namn från Microsoft ändras.Threat protection product names from Microsoft are changing. Läs mer om det här och andra uppdateringar här.Read more about this and other updates here. Vi kommer att uppdatera namn i produkter och i dokumenten inom en snar framtid.We'll be updating names in products and in the docs in the near future.

Anteckning

Den här begäran är inte tillgänglig för Office 365 Cloud App Security.This request is not available for Office 365 Cloud App Security.

Kör GET-begäran för att hämta alla entiteter som är relaterade till entiteten som matchar den angivna primära nyckeln.Run the GET request to fetch all entities related to the entity matching the specified primary key. Om entiteten är en användare, hämtar alla konton som är associerade med användaren.If the entity is a user, fetches all accounts associated with the user. Om entiteten är ett konto hämtar den överordnade och på samma nivå som entiteten.If the entity is an account, fetches the entity's parent and siblings.

HTTP-begäranHTTP request

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

URL-parametrar för begäranRequest URL parameters

ParameterParameter BeskrivningDescription
villkorpk ID för entitetenThe ID of the entity

ExempelExample

FörfråganRequest

Här är ett exempel på begäran.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/"

SvarsåtgärderResponse

Returnerar det angivna entitets trädet i JSON-format.Returns the specified entity tree in JSON format.

{
  // entity tree record
}

Om du stöter på problem är vi här för att hjälpa dig.If you run into any problems, we're here to help. Öppna ett support ärendeom du vill ha hjälp eller support för produkt problemet.To get assistance or support for your product issue, please open a support ticket.