v8

latestSwagger 2.0raw.githubusercontent.com2019-11-28133651.7 KB
Entities

List all entities (Management Groups, Subscriptions, etc.) for the authenticated user.

post/providers/Microsoft.Management/getEntities

Query parameters

api-versionstring required

Version of the API to be used with the client request. The current version is 2018-01-01-preview.

$skiptokenstring

Page continuation token is only used if a previous operation returned a partial result. If a previous response contains a nextLink element, the value of the nextLink element will include a token parameter that specifies a starting point to use for subsequent calls.

$skipinteger

Number of entities to skip over when retrieving results. Passing this in will override $skipToken.

$topinteger

Number of elements to return when retrieving results. Passing this in will override $skipToken.

$selectstring

This parameter specifies the fields to include in the response. Can include any combination of Name,DisplayName,Type,ParentDisplayNameChain,ParentChain, e.g. '$select=Name,DisplayName,Type,ParentDisplayNameChain,ParentNameChain'. When specified the $select parameter can override select in $skipToken.

$search'AllowedParents' | 'AllowedChildren' | 'ParentAndFirstLevelChildren' | 'ParentOnly' | 'ChildrenOnly'

The $search parameter is used in conjunction with the $filter parameter to return three different outputs depending on the parameter passed in. With $search=AllowedParents the API will return the entity info of all groups that the requested entity will be able to reparent to as determined by the user's permissions. With $search=AllowedChildren the API will return the entity info of all entities that can be added as children of the requested entity. With $search=ParentAndFirstLevelChildren the API will return the parent and first level of children that the user has either direct access to or indirect access via one of their descendants.

$filterstring

The filter parameter allows you to filter on the name or display name fields. You can check for equality on the name field (e.g. name eq '{entityName}') and you can check for substrings on either the name or display name fields(e.g. contains(name, '{substringToSearch}'), contains(displayName, '{substringToSearch')). Note that the '{entityName}' and '{substringToSearch}' fields are checked case insensitively.

$view'FullHierarchy' | 'GroupsOnly' | 'SubscriptionsOnly' | 'Audit'

The view parameter allows clients to filter the type of data that is returned by the getEntities call.

groupNamestring

A filter which allows the get entities call to focus on a particular group (i.e. "$filter=name eq 'groupName'")

Headers

Cache-Controlstring

Indicates that the request shouldn't utilize any caches.

Response

OK

countinteger

Total count of records that match the filter

nextLinkstring

The URL to use for getting the next set of results.