Updates from: 07/13/2021 03:06:34
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Accesspackage Post Accesspackageresourcerolescopes https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-post-accesspackageresourcerolescopes.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Create a new [accessPackageResourceRoleScope](../resources/accesspackageresourcerolescope.md) for adding a resource role to an access package. The access package resource must already exist in the access package catalog. Any subsequent access package assignment requests to this access package will include this resource role.
+Create a new [accessPackageResourceRoleScope](../resources/accesspackageresourcerolescope.md) for adding a resource role to an access package. The access package resource, for a group, an app, or a SharePoint Online site, must already exist in the access package catalog, and the **originId** for the resource role retrieved from the [list of the resource roles](accesspackagecatalog-list-accesspackageresourceroles.md). Once you add the resource role scope to the access package, the user will receive this resource role through any current and future access package assignments.
## Permissions
POST /identityGovernance/entitlementManagement/accessPackages/{id}/accessPackage
## Request body
-In the request body, supply a JSON representation of an [accessPackageResourceRoleScope](../resources/accesspackageresourcerolescope.md) object. Include in the object the relationships to an [accessPackageResourceRole](../resources/accesspackageresourcerole.md) and [accessPackageResourceScope](../resources/accesspackageresourcescope.md).
+In the request body, supply a JSON representation of an [accessPackageResourceRoleScope](../resources/accesspackageresourcerolescope.md) object. Include in the object the relationships to an [accessPackageResourceRole](../resources/accesspackageresourcerole.md) and [accessPackageResourceScope](../resources/accesspackageresourcescope.md).
## Response
If successful, this method returns a 200-series response code and a new [accessP
## Examples
-### Request
+### Example 1: Add group membership as a resource role to an access package
-The following is an example of the request.
+#### Request
+
+The following is an example of the request. The access package resource for the group must already have been added to the access package catalog containing this access package.
# [HTTP](#tab/http) <!-- {
Content-type: application/json
-### Response
+#### Response
The following is an example of the response.
Content-type: application/json
} ```
+### Example 2: Add a SharePoint Online site role to an access package
+
+#### Request
+
+The following is an example of the request. The access package resource for the site must already have been added to the access package catalog containing this access package.
+
+<!-- {
+ "blockType": "request",
+ "name": "create_accesspackageresourcerolescope_from_accesspackage2"
+}-->
+
+```http
+POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackages/{id}/accessPackageResourceRoleScopes
+Content-type: application/json
+
+{
+ "accessPackageResourceRole": {
+ "originId": "4",
+ "originSystem": "SharePointOnline",
+ "accessPackageResource": {
+ "id": "53c71803-a0a8-4777-aecc-075de8ee3991"
+ }
+ },
+ "accessPackageResourceScope": {
+ "id": "5ae0ae7c-d0a5-42aa-ab37-1f15e9a61d33",
+ "originId": "https://microsoft.sharepoint.com/portals/Community",
+ "originSystem": "SharePointOnline"
+ }
+}
+```
+
+#### Response
+
+The following is an example of the response.
+
+> **Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.accessPackageResourceRoleScope"
+} -->
+
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "id": "6646a29e-da03-49f6-bcd9-dec124492de3_5ae0ae7c-d0a5-42aa-ab37-1f15e9a61d33"
+}
+```
+ <!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98 2019-02-04 14:57:30 UTC --> <!-- {
Content-type: application/json
"section": "documentation", "tocPath": "" }-->--
v1.0 Accesspackageassignmentrequest List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentrequest-list.md
GET /identityGovernance/entitlementManagement/accessPackageAssignmentRequests
## Optional query parameters
-This method supports some of the OData query parameters to help customize the response. For example, to retrieve the access package of each request, include `$expand=accessPackage` in the query. To retrieve only requests for a specific access package, include in the query a filter such as `$expand=accessPackage&$filter=accessPackage/id eq '9bbe5f7d-f1e7-4eb1-a586-38cdf6f8b1ea'`. To retrieve the resulting assignment, include `$expand=accessPackageAssignment` in the query.
+This method supports the `$expand` and `$filter` OData query parameters to help customize the response. For example, to retrieve the access package of each request, include `$expand=accessPackage` in the query. To retrieve only requests for a specific access package, include in the query a filter such as `$expand=accessPackage&$filter=accessPackage/id eq '9bbe5f7d-f1e7-4eb1-a586-38cdf6f8b1ea'`. To retrieve the resulting assignment, include `$expand=accessPackageAssignment` in the query. To obtain more details on the requestor, include `$expand=requestor` in the query.
For general information, see [OData query parameters](/graph/query-parameters). ## Request headers
Content-type: application/json
"tocPath": "" }--> -
v1.0 Accesspackagecatalog List Accesspackageresourceroles https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackagecatalog-list-accesspackageresourceroles.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve a list of [accessPackageResourceRole](../resources/accesspackageresourcerole.md) objects of an [accessPackageResource](../resources/accesspackageresource.md) in an [accessPackageCatalog](../resources/accesspackagecatalog.md). This list of roles can then be used by the caller to select a role, which is needed when subsequently [creating an accessPackageResourceRoleScope](accesspackage-post-accesspackageresourcerolescopes.md).
+Retrieve a list of [accessPackageResourceRole](../resources/accesspackageresourcerole.md) objects of an [accessPackageResource](../resources/accesspackageresource.md) in an [accessPackageCatalog](../resources/accesspackagecatalog.md). The resource should have been added to the catalog by [creating an accessPackageResourceRequest](accesspackageresourcerequest-post.md). This list of roles can then be used by the caller to select a role, which is needed when subsequently [creating an accessPackageResourceRoleScope](accesspackage-post-accesspackageresourcerolescopes.md).
## Permissions
If successful, this method returns a `200 OK` response code and a collection of
## Examples
-### Request
+### Example 1: Retrieving the roles of a resource for a group
+
+#### Request
The following is an example of the request.
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
-### Response
+#### Response
The following is an example of the response.
Content-type: application/json
} ```
+### Example 2: Retrieve the roles of a resource for a SharePoint Online site
+
+This is an example of retrieving the roles of a resource, to obtain the **originId** of each role. This would be used after a SharePoint Online site has been added as a resource to the catalog, as the **originId** of a role is needed to add the role to an access package.
+
+#### Request
+
+The following is an example of the request, to retrieve the roles of a particular resource **53c71803-a0a8-4777-aecc-075de8ee3991** which has an **originSystem** of **SharePointOnline** and is located in catalog **beedadfe-01d5-4025-910b-84abb9369997**.
++
+<!-- {
+ "blockType": "request",
+ "name": "get_accesspackageresourceroles2"
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageCatalogs/beedadfe-01d5-4025-910b-84abb9369997/accessPackageResourceRoles?$filter=(originSystem+eq+%27SharePointOnline%27+and+accessPackageResource/id+eq+%2753c71803-a0a8-4777-aecc-075de8ee3991%27)&$select=displayName,originId
+```
+++
+#### Response
+
+The following is an example of the response. The **displayName** is the same as shown in the SharePoint Online view of a site, and the **originId** is the underlying identifier established by SharePoint Online for the role.
+
+> **Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.accessPackageResourceRole",
+ "isCollection": true
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "value": [
+ {
+ "displayName": "Contributors",
+ "originId": "4"
+ },
+ {
+ "displayName": "Creators",
+ "originId": "3"
+ },
+ {
+ "displayName": "Viewers",
+ "originId": "5"
+ }
+ ]
+}
+```
+++ <!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98 2019-02-04 14:57:30 UTC --> <!-- {
Content-type: application/json
"section": "documentation", "tocPath": "" }-->--
v1.0 Accesspackageresourcerequest Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageresourcerequest-post.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Create a new [accessPackageResourceRequest](../resources/accesspackageresourcerequest.md) object to request the addition of a resource to an access package catalog, or the removal of a resource from a catalog.
+Create a new [accessPackageResourceRequest](../resources/accesspackageresourcerequest.md) object to request the addition of a resource to an access package catalog, or the removal of a resource from a catalog. A resource must be included in an access package catalog before the role of that resource can be added to an access package.
## Permissions
If successful, this method returns a `201 Created` response code and a new [acce
## Examples
-### Example 1: Create an accessPackageResourceRequest
+### Example 1: Create an accessPackageResourceRequest for adding a site as a resource
#### Request
Content-type: application/json
} ```
-### Example 2: Create an accessPackageResourceRequest for a resource and assign an accessPackageResourceEnvironment using @odata.bind
+### Example 2: Create an accessPackageResourceRequest for adding a site as a resource and assign an accessPackageResourceEnvironment using @odata.bind
#### Request
Content-type: application/json
} ```
-### Example 3: Create an accessPackageResourceRequest for a resource and assign an accessPackageResourceEnvironment using originId
+### Example 3: Create an accessPackageResourceRequest for adding a site as a resource and assign an accessPackageResourceEnvironment using originId
#### Request
Content-type: application/json
} ```
+### Example 4: Create an accessPackageResourceRequest for adding a group as a resource
+
+#### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "create_accesspackageresourcerequest_from_accesspackageresourcerequests4"
+}-->
+
+```http
+POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageResourceRequests
+Content-type: application/json
+
+{
+
+ "catalogId":"beedadfe-01d5-4025-910b-84abb9369997",
+ "requestType": "AdminAdd",
+ "accessPackageResource": {
+ "originId": "c6294667-7348-4f5a-be73-9d2c65f574f3",
+ "originSystem": "AadGroup"
+ }
+}
+```
+
+#### Response
+
+The following is an example of the response.
+
+> **Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.accessPackageResourceRequest"
+} -->
+
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "catalogId": "beedadfe-01d5-4025-910b-84abb9369997",
+ "id": "acc2294e-f37f-42d3-981d-4e83847ed0ce",
+ "requestType": "AdminAdd",
+ "requestState": "Delivered",
+ "requestStatus": "Fulfilled"
+}
+```
+
+### Example 5: Create an accessPackageResourceRequest for removing a resource
+
+#### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "create_accesspackageresourcerequest_from_accesspackageresourcerequests5"
+}-->
+
+```http
+POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageResourceRequests
+Content-type: application/json
+
+{
+ "catalogId": "beedadfe-01d5-4025-910b-84abb9369997",
+ "requestType": "AdminRemove",
+ "accessPackageResource": {
+ "id": "354078e5-dbce-4894-8af4-0ab274d41662"
+ }
+}
+
+```
+
+#### Response
+
+The following is an example of the response.
+
+> **Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.accessPackageResourceRequest"
+} -->
+
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "catalogId": "beedadfe-01d5-4025-910b-84abb9369997",
+ "id": "65c3340d-defb-49a9-8930-63841fda0e68",
+ "requestType": "AdminRemove",
+ "requestState": "Delivered",
+ "requestStatus": "Fulfilled"
+}
+```
<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98 2019-02-04 14:57:30 UTC -->
v1.0 Columndefinition Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/columndefinition-get.md
GET /sites/{site-id}/contentTypes/{contentType-id}/columns/{column-id}
-#### Response
+### Response
v1.0 Projectrome Delete Activity https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/projectrome-delete-activity.md
If successful, this method returns the `204 No Content` response code if the act
## Example
-##### Request
+### Request
-Here is an example of the request.
+The following is an example of the request.
# [HTTP](#tab/http)
DELETE https://graph.microsoft.com/beta/me/activities/13881113971988980728/
-##### Response
+### Response
-Here is an example of the response.
+The following is an example of the response.
<!-- { "blockType": "response",
v1.0 Projectrome Get Recent Activities https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/projectrome-get-recent-activities.md
This method supports some [OData Query Parameters](/graph/query-parameters) to h
The following are some examples of supported queries with URL encoding.
-```
+```http
/me/activities/recent?$expand=historyItems($filter=lastModifiedDateTime%20gt%202018-01-22T21:45:00.347Z%20and%20lastModifiedDateTime%20lt%202018-01-22T22:00:00.347Z) /me/activities/recent?$filter=lastModifiedDateTime%20lt%202018-01-16T01:03:21.347Z%20and%20lastModifiedDateTime%20gt%202018-01-03T01:03:21.347Z
If successful, this method returns the `200 OK` response code with the user's re
## Example
-##### Request
+### Request
The following is an example of the request.
The following is an example of the request.
GET https://graph.microsoft.com/beta/me/activities/recent ```
-##### Response
+### Response
The following is an example of the response.
HTTP/1.1 200 OK
Content-Type: application/json {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(userActivity)",
- "@odata.nextLink": "https://graph.microsoft.com/beta/me/activities/recent?$skiptoken=%24filter%3dlastModifiedDateTime+lt+2018-02-26T18%3a06%3a19.365Z",
- "value": [{
- "@odata.type": "#microsoft.graph.activity",
- "activitySourceHost": "https://www.contoso.com",
- "createdDateTime": "2018-02-26T18:34:29.592Z",
- "lastModifiedDateTime": "2018-02-26T18:34:29.607Z",
- "id": "5347642601316252694",
- "appActivityId": "/article?12345",
- "visualElements": {
- "attribution": {
- "iconUrl": "https://www.contoso.com/icon",
- "alternateText": "Contoso, Ltd.",
- "addImageQuery": "false",
- },
- "displayText": "Contoso How-To: How to Tie a Reef Knot",
- "description": "How to Tie a Reef Knot. A step-by-step visual guide to the art of nautical knot-tying.",
- "backgroundColor": "#ff0000",
- "content": {
- "$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
- "type": "AdaptiveCard",
- "body":
- [{
- "type": "TextBlock",
- "text": "Contoso MainPage"
- }]
+ "@odata.context":"https://graph.microsoft.com/beta/$metadata#Collection(userActivity)",
+ "@odata.nextLink":"https://graph.microsoft.com/beta/me/activities/recent?$skiptoken=%24filter%3dlastModifiedDateTime+lt+2018-02-26T18%3a06%3a19.365Z",
+ "value":[
+ {
+ "@odata.type":"#microsoft.graph.activity",
+ "activitySourceHost":"https://www.contoso.com",
+ "createdDateTime":"2018-02-26T18:34:29.592Z",
+ "lastModifiedDateTime":"2018-02-26T18:34:29.607Z",
+ "id":"5347642601316252694",
+ "appActivityId":"/article?12345",
+ "visualElements":{
+ "attribution":{
+ "iconUrl":"https://www.contoso.com/icon",
+ "alternateText":"Contoso, Ltd.",
+ "addImageQuery":"false"
+ },
+ "displayText":"Contoso How-To: How to Tie a Reef Knot",
+ "description":"How to Tie a Reef Knot. A step-by-step visual guide to the art of nautical knot-tying.",
+ "backgroundColor":"#ff0000",
+ "content":{
+ "$schema":"https://adaptivecards.io/schemas/adaptive-card.json",
+ "type":"AdaptiveCard",
+ "body":[
+ {
+ "type":"TextBlock",
+ "text":"Contoso MainPage"
+ }
+ ]
}
- },
- "activationUrl": "https://www.contoso.com/article?id=12345",
- "appDisplayName": "Contoso, Ltd.",
- "userTimezone": "Africa/Casablanca",
- "fallbackUrl": "https://www.contoso.com/article?id=12345",
- "contentUrl": "https://www.contoso.com/article?id=12345",
- "contentInfo": {
- "@context": "https://schema.org",
- "@type": "Article",
- "author": "John Doe",
- "name": "How to Tie a Reef Knot"
- },
- "expirationDateTime": "2018-03-28T18:34:29.607Z",
- "status": "updated"
- }]
+ },
+ "activationUrl":"https://www.contoso.com/article?id=12345",
+ "appDisplayName":"Contoso, Ltd.",
+ "userTimezone":"Africa/Casablanca",
+ "fallbackUrl":"https://www.contoso.com/article?id=12345",
+ "contentUrl":"https://www.contoso.com/article?id=12345",
+ "contentInfo":{
+ "@context":"https://schema.org",
+ "@type":"Article",
+ "author":"John Doe",
+ "name":"How to Tie a Reef Knot"
+ },
+ "expirationDateTime":"2018-03-28T18:34:29.607Z",
+ "status":"updated"
+ }
+ ]
} ```
Content-Type: application/json
"tocPath": "", "suppressions": [] }>
+-->
v1.0 User List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-list.md
GET /users
## Optional query parameters
-This method supports the [OData query parameters](/graph/query-parameters) to help customize the response, including `$search`, `$count`, and `$filter`. You can use `$search` on the **displayName** property. When items are added or updated for this resource, they are specially indexed for use with the `$count` and `$search` query parameters. There can be a slight delay between when an item is added or updated and when it is available in the index. The `$count` and `$search` parameters are currently not available in Azure AD B2C tenants.
+This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). The `$count` and `$search` parameters are currently not available in Azure AD B2C tenants.
Certain properties cannot be returned within a user collection. The following properties are only supported when [retrieving a single user](./user-get.md): **aboutMe**, **birthday**, **hireDate**, **interests**, **mySite**, **pastProjects**, **preferredName**, **responsibilities**, **schools**, **skills**, **mailboxSettings**.
The following properties are not supported in personal Microsoft accounts and wi
| Header | Value | |: |:-- | | Authorization | Bearer {token} (required) |
-| ConsistencyLevel | eventual. This header and `$count` are required when using `$search`, or when using `$filter` with the `$orderby` query parameter, or `$filter` with the `endsWith` logical operator. It uses an index that may not be up-to-date with recent changes to the object. |
+| ConsistencyLevel | eventual. This header and `$count` are required when using `$search`, or in specific usage of `$filter`. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). |
## Request body
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$count` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- { "blockType": "ignored",
Content-type: text/plain
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string because the request has both the `$orderBy` and `$filter` query parameters. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- { "blockType": "ignored",
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string because the request has both the `$orderBy` and `$filter` query parameters, and also uses the `endsWith` operator. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
# [HTTP](#tab/http)
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- { "blockType": "ignored",
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- { "blockType": "ignored",
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- { "blockType": "ignored",
v1.0 Accesspackageresourcerole https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accesspackageresourcerole.md
In [Azure AD entitlement management](entitlementmanagement-root.md), an access p
|description|String|A description for the resource role.| |displayName|String|The display name of the resource role such as the role defined by the application.| |id|String| Read-only.|
-|originId|String|The unique identifier of the resource role in the origin system. |
+|originId|String|The unique identifier of the resource role in the origin system. For a SharePoint Online site, the originId will be the sequence number of the role in the site. |
|originSystem|String|The type of the resource in the origin system, such as `SharePointOnline`, `AadApplication` or `AadGroup`.| ## Relationships
v1.0 Cloudpconpremisesconnectionhealthcheck https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/cloudpconpremisesconnectionhealthcheck.md
The result of a cloud PC on-premises connection health check.
|permissionCheckNoSubscriptionReaderRole|The cloud PC service principal doesn't have sufficient permissions on the Azure subscription. Please make sure that the cloud PC service principal has the *Reader* permissions on the subscription.| |permissionCheckNoResourceGroupOwnerRole|The cloud PC service principal doesn't have sufficient permissions on the Azure resource group. Please make sure that the cloud PC service principal has the *Owner* permissions on the resource group. | |permissionCheckNoVNetContributorRole|The cloud PC service principal doesn't have sufficient permissions on the Azure vNet. Please make sure that the cloud PC service has the *Network contributor* permissions on the vNet.|
+|permissionCheckNoResourceGroupNetworkContributorRole|Cloud PC service principal doesn't have sufficient permissions on the Azure resource group. Please make sure that the application has Network contributor permissions on the resource group.|
|permissionCheckUnknownError|The cloud PC service principal doesn't have sufficient permissions. Please make sure that the cloud PC service principal is granted sufficient Azure permissions.| |internalServerErrorDeploymentCanceled|The deployment was canceled. Please try again later. If the problem persists, please contact support.| |internalServerErrorAllocateResourceFailed|The allocation of resources failed. Please try again later. If the problem persists, please contact support.|
v1.0 Search Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/search-api-overview.md
When searching an entity type, such as **message**, **event**, **drive**, **driv
For all these entity types, specifying the **fields** property reduces the number of properties returned in the response, optimizing the payload over the wire.
-The **listItem** and **externalItem** entities are the only supported entities that allow getting extended fields configured in the schema. You cannot retrieve extended properties from all the other entities. For example, if you created a field for **externalItem** in the search schema, or if you have a custom column on a **listItem**, you can retrieve these properties from search. To retrieve an extended property on a file, specify the **listItem** type in the request.
+The **listItem** and **externalItem** entities are the only supported entities that allow getting extended retrievable fields configured in the schema. You cannot retrieve extended properties from all the other entities by using the search API. For example, if you created a retrievable field for **externalItem** in the search schema, or if you have a retrievable custom column on a **listItem**, you can retrieve these properties from search. To retrieve an extended property on a file, specify the **listItem** type in the request.
-If the **fields** specified in the request are not present in the schema, they will not be returned in the response. Invalid fields in the request are silently ignored.
+If the **fields** specified in the request are either not present in the schema, or not marked as retrievable, they will not be returned in the response. Invalid fields in the request are silently ignored.
If you do not specify any **fields** in the request, you will get the default set of properties for all types. For extended properties, **listItem** and **externalItem** behave differently when no **fields** are passed in the request:
v1.0 User https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/user.md
This resource supports:
## Properties
+> [!IMPORTANT]
+> Specific usage of `$filter` and the `$search` query parameter is supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+ | Property | Type | Description | |:|:--|:| | aboutMe | String | A freeform text entry field for the user to describe themselves. <br><br>Returned only on `$select`. |
v1.0 Projectrome Delete Activity https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/projectrome-delete-activity.md
If successful, this method returns the `204 No Content` response code if the act
## Example
-##### Request
+### Request
-Here is an example of the request.
+The following is an example of the request.
# [HTTP](#tab/http)
DELETE https://graph.microsoft.com/v1.0/me/activities/{activity-id}/
-##### Response
+### Response
-Here is an example of the response.
+The following is an example of the response.
<!-- { "blockType": "response",
v1.0 Projectrome Get Recent Activities https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/projectrome-get-recent-activities.md
This method supports some [OData Query Parameters](/graph/query-parameters) to h
The following are some examples of supported queries with URL encoding.
-```
+```http
/me/activities/recent?$expand=historyItems($filter=lastModifiedDateTime%20gt%202018-01-22T21:45:00.347Z%20and%20lastModifiedDateTime%20lt%202018-01-22T22:00:00.347Z) /me/activities/recent?$filter=lastModifiedDateTime%20lt%202018-01-16T01:03:21.347Z%20and%20lastModifiedDateTime%20gt%202018-01-03T01:03:21.347Z
HTTP/1.1 200 OK
Content-Type: application/json {
- "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(userActivity)",
- "@odata.nextLink": "https://graph.microsoft.com/v1.0/me/activities/recent?$skiptoken=%24filter%3dlastModifiedDateTime+lt+2018-02-26T18%3a06%3a19.365Z",
- "value": [{
- "@odata.type": "#microsoft.graph.userActivity",
- "activitySourceHost": "https://www.contoso.com",
- "createdDateTime": "2018-02-26T18:34:29.592Z",
- "lastModifiedDateTime": "2018-02-26T18:34:29.607Z",
- "id": "5347642601316252694",
- "appActivityId": "/article?12345",
- "visualElements": {
- "attribution": {
- "iconUrl": "https://www.contoso.com/icon",
- "alternateText": "Contoso, Ltd.",
- "addImageQuery": false,
- },
- "displayText": "Contoso How-To: How to Tie a Reef Knot",
- "description": "How to Tie a Reef Knot. A step-by-step visual guide to the art of nautical knot-tying.",
- "backgroundColor": "#ff0000",
- "content": {
- "$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
- "type": "AdaptiveCard",
- "body":
- [{
- "type": "TextBlock",
- "text": "Contoso MainPage"
- }]
+ "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#Collection(userActivity)",
+ "@odata.nextLink":"https://graph.microsoft.com/v1.0/me/activities/recent?$skiptoken=%24filter%3dlastModifiedDateTime+lt+2018-02-26T18%3a06%3a19.365Z",
+ "value":[
+ {
+ "@odata.type":"#microsoft.graph.userActivity",
+ "activitySourceHost":"https://www.contoso.com",
+ "createdDateTime":"2018-02-26T18:34:29.592Z",
+ "lastModifiedDateTime":"2018-02-26T18:34:29.607Z",
+ "id":"5347642601316252694",
+ "appActivityId":"/article?12345",
+ "visualElements":{
+ "attribution":{
+ "iconUrl":"https://www.contoso.com/icon",
+ "alternateText":"Contoso, Ltd.",
+ "addImageQuery":false
+ },
+ "displayText":"Contoso How-To: How to Tie a Reef Knot",
+ "description":"How to Tie a Reef Knot. A step-by-step visual guide to the art of nautical knot-tying.",
+ "backgroundColor":"#ff0000",
+ "content":{
+ "$schema":"https://adaptivecards.io/schemas/adaptive-card.json",
+ "type":"AdaptiveCard",
+ "body":[
+ {
+ "type":"TextBlock",
+ "text":"Contoso MainPage"
+ }
+ ]
}
- },
- "activationUrl": "https://www.contoso.com/article?id=12345",
- "appDisplayName": "Contoso, Ltd.",
- "userTimezone": "Africa/Casablanca",
- "fallbackUrl": "https://www.contoso.com/article?id=12345",
- "contentUrl": "https://www.contoso.com/article?id=12345",
- "contentInfo": {
- "@context": "https://schema.org",
- "@type": "Article",
- "author": "John Doe",
- "name": "How to Tie a Reef Knot"
- },
- "expirationDateTime": "2018-03-28T18:34:29.607Z",
- "status": "updated"
- }]
+ },
+ "activationUrl":"https://www.contoso.com/article?id=12345",
+ "appDisplayName":"Contoso, Ltd.",
+ "userTimezone":"Africa/Casablanca",
+ "fallbackUrl":"https://www.contoso.com/article?id=12345",
+ "contentUrl":"https://www.contoso.com/article?id=12345",
+ "contentInfo":{
+ "@context":"https://schema.org",
+ "@type":"Article",
+ "author":"John Doe",
+ "name":"How to Tie a Reef Knot"
+ },
+ "expirationDateTime":"2018-03-28T18:34:29.607Z",
+ "status":"updated"
+ }
+ ]
} ```
v1.0 User List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/user-list.md
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$count` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- { "blockType": "ignored",
Content-type: text/plain
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string because the request has both the `$orderBy` and `$filter` query parameters. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- { "blockType": "ignored",
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string because the request has both the `$orderBy` and `$filter` query parameters, and also uses the `endsWith` operator. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
# [HTTP](#tab/http)
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- { "blockType": "ignored",
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- { "blockType": "ignored",
v1.0 Search Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/search-api-overview.md
When searching an entity type, such as **message**, **event**, **drive**, **driv
For all these entity types, specifying the **fields** property reduces the number of properties returned in the response, optimizing the payload over the wire.
-The **listItem** and **externalItem** entities are the only supported entities that allow getting extended fields configured in the schema. You cannot retrieve extended properties from all the other entities. For example, if you created a field for **externalItem** in the search schema, or if you have a custom column on a **listItem**, you can retrieve these properties from search. To retrieve an extended property on a file, specify the **listItem** type in the request.
+The **listItem** and **externalItem** entities are the only supported entities that allow getting extended retrievable fields configured in the schema. You cannot retrieve extended properties from all the other entities by using the search API. For example, if you created a retrievable field for **externalItem** in the search schema, or if you have a retrievable custom column on a **listItem**, you can retrieve these properties from search. To retrieve an extended property on a file, specify the **listItem** type in the request.
-If the **fields** specified in the request are not present in the schema, they will not be returned in the response. Invalid fields in the request are silently ignored.
+If the **fields** specified in the request are either not present in the schema, or not marked as retrievable, they will not be returned in the response. Invalid fields in the request are silently ignored.
If you do not specify any **fields** in the request, you will get the default set of properties for all types. For extended properties, **listItem** and **externalItem** behave differently when no **fields** are passed in the request:
v1.0 User https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/user.md
This resource supports:
## Properties
+> [!IMPORTANT]
+> Specific usage of `$filter` and the `$search` query parameter is supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+ | Property | Type |Description| |:|:--|:-| |aboutMe|String|A freeform text entry field for the user to describe themselves. Returned only on `$select`.|