| Service | Microsoft Docs article | Related commit history on GitHub | Change details |
|---|---|---|---|
| v1.0 | Cloudpc Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpc-get.md | Content-Type: application/json The following example shows a request. -# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_cloudpc_selected_properties" The following example shows a request. --> ``` http-GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/40cee9d2-03fb-4066-8d35-dbdf2875c33f?$select=id,displayName,imageDisplayName,lastModifiedDateTime,lastRemoteActionResult,lastLoginResult,connectivityResult,allotmentDisplayName +GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/40cee9d2-03fb-4066-8d35-dbdf2875c33f?$select=id,displayName,imageDisplayName,lastModifiedDateTime,lastRemoteActionResult,lastLoginResult,connectivityResult,allotmentDisplayName,deviceRegionName ``` -# [C#](#tab/csharp) --# [CLI](#tab/cli) --# [Go](#tab/go) --# [Java](#tab/java) --# [JavaScript](#tab/javascript) --# [PHP](#tab/php) --# [PowerShell](#tab/powershell) --# [Python](#tab/python) --- #### Response The following example shows the response. Content-Type: application/json } ] },- "allotmentDisplayName": null + "allotmentDisplayName": null, + "deviceRegionName": "eastus2" } ``` |
| v1.0 | Cloudpc Getprovisionedcloudpcs | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpc-getprovisionedcloudpcs.md | Content-Type: application/json "statusDetails": null, "provisioningType": "dedicated", "allotmentDisplayName": null,+ "deviceRegionName": "eastus2", "connectivityResult": "", "gracePeriodEndDateTime": null, "lastLoginResult": "2020-07-23T10:29:57Z", Content-Type: application/json "statusDetails": null, "provisioningType": "dedicated", "allotmentDisplayName": null,+ "deviceRegionName": "eastus2", "connectivityResult": "", "gracePeriodEndDateTime": null, "lastLoginResult": "2020-07-23T10:29:57Z", |
| v1.0 | Cloudpcauditevent Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcauditevent-get.md | Content-Type: application/json "newValue": "new-adDomainUsername" } ],- "type": "CloudPcOnPremisesConnection", "resourceType": "CloudPcOnPremisesConnection", "resourceId": "a7508af8-d334-41ba-83a7-26cc88959724" } |
| v1.0 | Driveitem Post Permissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/driveitem-post-permissions.md | + + Title: "Create permission on a driveItem" +description: "Create a new permission for a driveItem." ++ms.localizationpriority: medium ++++# Create permission on a driveItem +Namespace: microsoft.graph +++Create a new [permission](../resources/permission.md) object on a [driveItem](../resources/permission.md). ++>**Note:** You can only use this method to create a new application permission. If you want to create a new user permission in a drive item, see [invite](./driveitem-invite.md). +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "driveitem_post_permissions" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /drives/{drive-id}/items/{item-id}/permissions +POST /groups/{group-id}/drive/items/{item-id}/permissions +POST /me/drive/items/{item-id}/permissions +POST /sites/{siteId}/drive/items/{itemId}/permissions +POST /users/{userId}/drive/items/{itemId}/permissions +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [permission](../resources/permission.md) object. ++## Response ++If successful, this method returns a `201 Created` response code and a [permission](../resources/permission.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "create_permission_from_" +} +--> ++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.permission" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "id": "1", + "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2", + "roles": [ + "write" + ], + "grantedToIdentities": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ], + "grantedToIdentitiesV2": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ] +} +``` ++<!-- { + "type": "#page.annotation", + "section": "documentation", + "tocPath": "Items/Permissions/Create driveitem permissions" +} --> |
| v1.0 | List Delete Permissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/list-delete-permissions.md | + + Title: "Delete permission on a list" +description: "Delete a permission object on a list." ++ms.localizationpriority: medium ++++# Delete permission on a list +Namespace: microsoft.graph +++Delete a [permission](../resources/permission.md) object on a [list](../resources/list.md). +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "list_delete_permissions" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /sites/{site-id}/lists/{list-id}/permissions/{permissionId} +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns `204 No Content` response code. It doesn't return anything in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "delete_permission_2" +} +--> ++++### Response +The following example shows the response. +<!-- { + "blockType": "response", + "truncated": true +} --> ++```http +HTTP/1.1 204 No Content +``` ++<!-- { + "type": "#page.annotation", + "section": "documentation", + "tocPath": "Lists/Permissions/Delete list permission" +} --> |
| v1.0 | List Get Permissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/list-get-permissions.md | + + Title: "Get permission on a list" +description: "Retrieve the properties and relationships of a permission object on a list." ++ms.localizationpriority: medium ++++# Get permission on a list +Namespace: microsoft.graph +++Retrieve the properties and relationships of a [permission](../resources/permission.md) object on a [list](../resources/list.md). +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "list_get_permissions" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /sites/{site-id}/lists/{list-id}/permissions/ +``` ++## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [permission](../resources/permission.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "get_permission", + "sampleKeys": ["f2d90359-865b-4b6c-8848-d2722dd630e5", "1"] +} +--> ++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.permission" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "id": "1", + "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2", + "roles": [ + "read" + ], + "grantedToIdentities": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ], + "grantedToIdentitiesV2": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ] +} +``` ++<!-- { + "type": "#page.annotation", + "section": "documentation", + "tocPath": "Lists/Permissions/Get list permission" +} --> |
| v1.0 | List List Permissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/list-list-permissions.md | + + Title: "List permissions on a list" +description: "Get the permission resources from the permissions navigation property on a list." ++ms.localizationpriority: medium ++++# List permissions on a list +Namespace: microsoft.graph +++Get a list of the [permission](../resources/permission.md) objects associated with a [list](../resources/list.md). +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "list_list_permissions" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /sites/{site-id}/lists/{list-id}/permissions +``` ++## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a collection of [permission](../resources/permission.md) objects in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "list_permission_list_nav_property" +} +--> ++++### Response ++The following example shows the response. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.permission)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "id": "1", + "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2", + "roles": [ + "read" + ], + "grantedToIdentities": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ], + "grantedToIdentitiesV2": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ] + }, + { + "id": "2", + "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2", + "roles": [ + "write" + ], + "grantedToIdentities": [ + { + "application": { + "id": "22f09bb7-dd29-403e-bec2-ab5cde52c2b3", + "displayName": "Fabrikam Dashboard App" + } + } + ], + "grantedToIdentitiesV2": [ + { + "application": { + "id": "22f09bb7-dd29-403e-bec2-ab5cde52c2b3", + "displayName": "Fabrikam Dashboard App" + } + } + ] + } + ] +} +``` ++<!-- { + "type": "#page.annotation", + "section": "documentation", + "tocPath": "Lists/Permissions/List list permissions" +} --> |
| v1.0 | List Post Permissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/list-post-permissions.md | + + Title: "Create permission on a list" +description: "Create a new permission object." ++ms.localizationpriority: medium ++++# Create permission on a list +Namespace: microsoft.graph +++Create a new [permission](../resources/permission.md) object on a [list](../resources/list.md). ++>**Note:** You can only use this method to create a new application permission; you can't use it to create a new list permission for a user. +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "list_post_permissions" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /sites/f2d90359-865b-4b6c-8848-d2722dd630e5/lists/1d702d60-503c-4924-abfd-028c65fc89ed/permissions +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [permission](../resources/permission.md) object. ++## Response ++If successful, this method returns a `201 Created` response code and a [permission](../resources/permission.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "create_permission_from_" +} +--> ++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.permission" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "id": "1", + "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2", + "roles": [ + "write" + ], + "grantedToIdentities": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ], + "grantedToIdentitiesV2": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ] +} +``` ++<!-- { + "type": "#page.annotation", + "section": "documentation", + "tocPath": "Lists/Permissions/Create list permissions" +} --> |
| v1.0 | List Update Permissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/list-update-permissions.md | + + Title: "Update permission on a list" +description: "Update the permission object on a list." ++ms.localizationpriority: medium ++++# Update permission on a list +Namespace: microsoft.graph +++Update the [permission](../resources/permission.md) object on a [list](../resources/list.md). ++>**Note:** You can't use this method to update a list permission for a user. +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "list_update_permissions" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /sites/{site-id}/lists/{list-id}/permissions/{permissionId} +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [permission](../resources/permission.md) object. ++## Response ++If successful, this method returns a `200 OK` response code and a [permission](../resources/permission.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "update_permission_from_", + "sampleKeys": ["f2d90359-865b-4b6c-8848-d2722dd630e5", "2"] +} +--> ++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.permission" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "id": "2", + "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2", + "roles": [ + "read" + ], + "grantedToIdentities": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Fabrikam Dashboard App" + } + } + ], + "grantedToIdentitiesV2": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Fabrikam Dashboard App" + } + } + ] +} +``` ++<!-- { + "type": "#page.annotation", + "section": "documentation", + "tocPath": "Lists/Permissions/Update list permission" +} --> |
| v1.0 | Listitem Delete Permissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/listitem-delete-permissions.md | + + Title: "Delete permission on a listItem" +description: "Delete a permission object on a list item." ++ms.localizationpriority: medium ++++# Delete permission on a listItem +Namespace: microsoft.graph +++Delete a [permission](../resources/permission.md) object on a [list item](../resources/listitem.md). +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "listitem_delete_permission" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /sites/{site-id}/lists/{list-id}/items/{item-id}/{permissionId} +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns `204 No Content` response code. It doesn't return anything in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "delete_permission_2" +} +--> ++++### Response +The following example shows the response. +<!-- { + "blockType": "response", + "truncated": true +} --> ++```http +HTTP/1.1 204 No Content +``` ++<!-- { + "type": "#page.annotation", + "section": "documentation", + "tocPath": "ListItems/Permissions/Delete listitem permission" +} --> |
| v1.0 | Listitem Get Permissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/listitem-get-permissions.md | + + Title: "Get permission on a listItem" +description: "Retrieve the properties and relationships of a permission object on a list item." ++ms.localizationpriority: medium ++++# Get permission on a listItem +Namespace: microsoft.graph +++Retrieve the properties and relationships of a [permission](../resources/permission.md) object on a [list item](../resources/listitem.md). +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "listitem_get_permissions" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /sites/{site-id}/lists/{list-id}/items/{item-id}/permissions/{permission-id} +``` ++## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [permission](../resources/permission.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "get_permission", + "sampleKeys": ["f2d90359-865b-4b6c-8848-d2722dd630e5","f2d90359-865b-4b6c-8848-d2722dd630e5", "1", "3"] +} +--> ++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.permission" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "id": "1", + "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2", + "roles": [ + "read" + ], + "grantedToIdentities": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ], + "grantedToIdentitiesV2": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ] +} +``` ++<!-- { + "type": "#page.annotation", + "section": "documentation", + "tocPath": "ListItems/Permissions/Get listitems permission" +} --> |
| v1.0 | Listitem List Permissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/listitem-list-permissions.md | + + Title: "List permissions on a listItem" +description: "Get a list of the permissions objects associated with a list item." ++ms.localizationpriority: medium ++++# List permissions on a listItem +Namespace: microsoft.graph +++Get a list of the [permission](../resources/permission.md) objects associated with a [listItem](../resources/listitem.md). +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "listitem_list_permissions" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /sites/{site-id}/lists/{list-id}/items/{item-id}/permissions +``` ++## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a collection of [permission](../resources/permission.md) objects in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "list_permission_listitem_nav_property" +} +--> ++++### Response ++The following example shows the response. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.permission)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "id": "1", + "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2", + "roles": [ + "read" + ], + "grantedToIdentities": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ], + "grantedToIdentitiesV2": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ] + }, + { + "id": "2", + "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2", + "roles": [ + "write" + ], + "grantedToIdentities": [ + { + "application": { + "id": "22f09bb7-dd29-403e-bec2-ab5cde52c2b3", + "displayName": "Fabrikam Dashboard App" + } + } + ], + "grantedToIdentitiesV2": [ + { + "application": { + "id": "22f09bb7-dd29-403e-bec2-ab5cde52c2b3", + "displayName": "Fabrikam Dashboard App" + } + } + ] + } + ] +} +``` ++<!-- { + "type": "#page.annotation", + "section": "documentation", + "tocPath": "ListItems/Permissions/List listitem permissions" +} --> |
| v1.0 | Listitem Post Permissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/listitem-post-permissions.md | + + Title: "Create permission on a listItem" +description: "Create a new permission object." ++ms.localizationpriority: medium ++++# Create permission on a listItem +Namespace: microsoft.graph +++Create a new [permission](../resources/permission.md) object on a [list item](../resources/listitem.md). ++>**Note:** You can only use this method to create a new application permission; you can't use it to create a new list item permission for a user. +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "listitem_post_permissions" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /sites/{site-id}/lists/{list-id}/items/{item-id}/permissions +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [permission](../resources/permission.md) object. ++## Response ++If successful, this method returns a `201 Created` response code and a [permission](../resources/permission.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "create_permission_from_" +} +--> ++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.permission" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "id": "1", + "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2", + "roles": [ + "write" + ], + "grantedToIdentities": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ], + "grantedToIdentitiesV2": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ] +} +``` ++<!-- { + "type": "#page.annotation", + "section": "documentation", + "tocPath": "ListItems/Permissions/Create listitem permissions" +} --> |
| v1.0 | Listitem Update Permissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/listitem-update-permissions.md | + + Title: "Update permission on a listItem" +description: "Update the permission object on a list item." ++ms.localizationpriority: medium ++++# Update permission on a listItem +Namespace: microsoft.graph +++Update the [permission](../resources/permission.md) object on a [list item](../resources/listitem.md). ++>**Note:** You can't use this method to update a user listitem permission. +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "listitem_update_permissions" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /sites/{site-id}/lists/{list-id}/items/{item-id}/permissions/{permission-id} +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [permission](../resources/permission.md) object. ++## Response ++If successful, this method returns a `200 OK` response code and a [permission](../resources/permission.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "update_permission_from_", + "sampleKeys": ["f2d90359-865b-4b6c-8848-d2722dd630e5", "2"] +} +--> ++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.permission" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "id": "2", + "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2", + "roles": [ + "read" + ], + "grantedToIdentities": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Fabrikam Dashboard App" + } + } + ], + "grantedToIdentitiesV2": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Fabrikam Dashboard App" + } + } + ] +} +``` ++<!-- { + "type": "#page.annotation", + "section": "documentation", + "tocPath": "ListItems/Permissions/Update listitem permission" +} --> |
| v1.0 | Virtualendpoint List Auditevents | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualendpoint-list-auditevents.md | Content-Type: application/json "newValue": "new-adDomainUsername" } ],- "type": "CloudPcOnPremisesConnection", "resourceType": "CloudPcOnPremisesConnection", "resourceId": "a7508af8-d334-41ba-83a7-26cc88959724" } |
| v1.0 | Virtualendpoint List Cloudpcs | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualendpoint-list-cloudpcs.md | Content-Type: application/json "statusDetails": null, "gracePeriodEndDateTime": "2020-11-010T20:00:34Z", "provisioningType": "dedicated",+ "deviceRegionName": "eastus2", "diskEncryptionState": "encryptedUsingPlatformManagedKey" } ] Content-Type: application/json "servicePlanType": "enterprise", "diskEncryptionState": "notAvailable", "provisioningType": "dedicated",+ "deviceRegionName": "eastus2", "statusDetails": { "code": "intuneEnrollFailed", "message": "We can’t complete MEM enrollment of this Cloud PC. Check MEM policy settings and retry. If that doesn’t work, contact Customer support.", Content-Type: application/json "servicePlanType": "enterprise", "diskEncryptionState": "notAvailable", "provisioningType": "dedicated",+ "deviceRegionName": "eastus2", "statusDetails": { "code": "intuneEnrollFailed", "message": "We can’t complete MEM enrollment of this Cloud PC. Check MEM policy settings and retry. If that doesn’t work, contact Customer support.", |
| v1.0 | Cloudpc | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpc.md | Represents a cloud-managed virtual desktop. This Cloud PC is also enrolled in In |[Bulk resize (deprecated)](../api/cloudpc-bulkresize.md) |[cloudPcRemoteActionResult](../resources//cloudpcremoteactionresult.md) collection|Perform a bulk resize action to resize a group of Cloud PCs that have successfully passed validation (cloudPC: validateBulkResize). If any devices can't be resized, they're labeled as "resize failed", while the remaining devices are `provisioned` for the resize process. This API is deprecated and stopped returning data on September 24, 2023. Going forward, use the [cloudPcBulkResize](../resources/cloudpcbulkresize.md) resource.| |[Bulk restore remote action (deprecated)](../api/manageddevice-bulkrestorecloudpc.md) |[cloudPcBulkRemoteActionResult](../resources/cloudpcbulkremoteactionresult.md)|Restore multiple Cloud PC devices with a single request that includes the IDs of Intune managed devices and a restore point date and time. This API is deprecated and stopped returning data on September 24, 2023. Going forward, use the [cloudPcBulkRestore](../resources/cloudpcbulkrestore.md) resource.| |[Get review status (deprecated)](../api/manageddevice-getcloudpcreviewstatus.md) |[cloudPcReviewStatus](../resources/cloudpcreviewstatus.md)|Get the review status of a specific Cloud PC device by managedDeviceId. This API is deprecated and stopped returning data on April 30, 2024. Going forward, use the [cloudPC: retrieveReviewStatus](../api/cloudpc-retrievereviewstatus.md) API.|-|[Get shift work access state (deprecated)](../api/cloudpc-getshiftworkcloudpcaccessstate.md) |[shiftWorkCloudPcAccessState](#shiftworkcloudpcaccessstate-values-deprecated)|Get the access state of the shift work Cloud PC. The possible values are: `unassigned`, `noLicensesAvailable`, `activationFailed`, `active`, `activating`, `waitlisted`, `unknownFutureValue`, `standbyMode`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value in this evolvable enum: `standbyMode`. This API is deprecated and will stop returning data on December 31, 2023. Going forward, use the [getFrontlineCloudPcAccessState](../api/cloudpc-getfrontlinecloudpcaccessstate.md) API.| +|[Get shift work access state (deprecated)](../api/cloudpc-getshiftworkcloudpcaccessstate.md) |[shiftWorkCloudPcAccessState](#shiftworkcloudpcaccessstate-values-deprecated)|Get the access state of the shift work Cloud PC. The possible values are: `unassigned`, `noLicensesAvailable`, `activationFailed`, `active`, `activating`, `waitlisted`, `unknownFutureValue`, `standbyMode`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this evolvable enum: `standbyMode`. This API is deprecated and will stop returning data on December 31, 2023. Going forward, use the [getFrontlineCloudPcAccessState](../api/cloudpc-getfrontlinecloudpcaccessstate.md) API.| |[Reprovision remote action (deprecated)](../api/manageddevice-reprovisioncloudpc.md) |None|Reprovision a Cloud PC with an Intune [managed device](../resources/cloudpc.md) ID. This API is deprecated and will stop returning data on September 30, 2023. Going forward, use the [reprovision](../api/cloudpc-reprovision.md) API.| |[Resize remote action (deprecated)](../api/manageddevice-resizecloudpc.md) |None|Upgrade or downgrade an existing Cloud PC to another configuration with a new vCPU and storage size through Intune managed device ID. This API is deprecated and stopped returning data on October 30, 2023. Going forward, use the [cloudPC: resize](../api/cloudpc-resize.md) API.| |[Restore remote action (deprecated)](../api/manageddevice-restorecloudpc.md) |None|Restore a Cloud PC device to a previous state with an Intune [managed device](../resources/cloudpc.md) ID. This API is deprecated and will stop returning data on September 30, 2023. Going forward, use the [restore](../api/cloudpc-restore.md) API.| Represents a cloud-managed virtual desktop. This Cloud PC is also enrolled in In |aadDeviceId|String|The Microsoft Entra device ID of the Cloud PC.| |allotmentDisplayName|String|The allotment name divides tenant licenses into smaller batches or groups that help restrict the number of licenses available for use in a specific assignment. When the **provisioningType** is `dedicated`, the allotment name is `null`. Read-only.| |connectivityResult|[cloudPcConnectivityResult](../resources/cloudpcconnectivityresult.md)|The connectivity health check result of a Cloud PC, including the updated timestamp and whether the Cloud PC can be connected.|+|deviceRegionName|String|The name of the geographical region where the Cloud PC is currently provisioned. For example, `westus3`, `eastus2`, and `southeastasia`. Read-only.| |diskEncryptionState|[cloudPcDiskEncryptionState](#cloudpcdiskencryptionstate-values)|The disk encryption applied to the Cloud PC. Possible values: `notAvailable`, `notEncrypted`, `encryptedUsingPlatformManagedKey`, `encryptedUsingCustomerManagedKey`, and `unknownFutureValue`.| |displayName|String|The display name of the Cloud PC.| |gracePeriodEndDateTime|DateTimeOffset|The date and time when the grace period ends and reprovisioning or deprovisioning happens. Required only if the status is `inGracePeriod`. The timestamp is shown in ISO 8601 format and Coordinated Universal Time (UTC). For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| Represents a cloud-managed virtual desktop. This Cloud PC is also enrolled in In |unknown|The Cloud PC status is unknown.| ### cloudPcStatus values-The following table lists the members of an [evolvable enumeration](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations). Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following values in this evolvable enum: `movingRegion`, `resizePendingLicense`. +The following table lists the members of an [evolvable enumeration](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations). You must use the `Prefer: include-unknown-enum-members` request header to get the following values in this evolvable enum: `movingRegion`, `resizePendingLicense`. |Member|Description| |:|:| The following JSON representation shows the resource type. "aadDeviceId": "String", "allotmentDisplayName": "String", "connectivityResult": "String",+ "deviceRegionName": "String", "diskEncryptionState": "String", "displayName": "String", "gracePeriodEndDateTime": "String (timestamp)", |
| v1.0 | Cloudpcauditresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcauditresource.md | Represents the audit resource. This shows the target edited resource entity, w |modifiedProperties|[cloudPcAuditProperty](../resources/cloudpcauditproperty.md) collection|A list of modified properties.| |resourceId|String|The ID of the audit resource.| |resourceType|String|The type of the audit resource.|-|type (deprecated)|String|The type of the audit resource. The **type** property is deprecated and will stop returning data on May 8, 2024. Going forward, use the **resourceType** property.| ## Relationships The following JSON representation shows the resource type. "displayName": "String", "modifiedProperties": [{"@odata.type": "microsoft.graph.cloudPcAuditProperty"}], "resourceId": "String",- "resourceType": "String", - "type": "String" + "resourceType": "String" } ``` |
| v1.0 | Driveitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/driveitem.md | Items with the **folder** facet act as containers of items and therefore have a ## Methods -| Method | REST Path | -|:--|:--| -| [Get item](../api/driveitem-get.md) | `GET /drive/items/{item-id}` | -| [List activities](../api/activities-list.md) | `GET /drive/items/{item-id}/activities` | -| [Get analytics][] | `GET /drive/items/{item-id}/analytics` | -| [Get activities by interval][] | `GET /drive/items/{item-id}/getActivitiesByInterval` | -| [List children](../api/driveitem-list-children.md) | `GET /drive/items/{item-id}/children` | -| [List versions](../api/driveitem-list-versions.md) | `GET /drive/items/{item-id}/versions` | -| [Create folder](../api/driveitem-post-children.md) | `POST /drive/items/{item-id}/children` | -| [Update item](../api/driveitem-update.md) | `PATCH /drive/items/{item-id}` | -| [Upload](../api/driveitem-put-content.md) | `PUT /drive/items/{item-id}/content` | -| [Download content](../api/driveitem-get-content.md) (deprecated) | `GET /drive/items/{item-id}/content` | -| [Download file](../api/driveitem-get-contentstream.md) | `GET /drive/items/{item-id}/contentStream` | -| [Download specific file format][download-format] | `GET /drive/items/{item-id}/content?format={format}` | -| [Delete item](../api/driveitem-delete.md) | `DELETE /drive/items/{item-id}` | -| [Permanently delete item](../api/driveitem-permanentdelete.md) | `POST /drives/{driveId}/items/{itemId}/permanentDelete` | -| [Restore item](../api/driveitem-restore.md) | `POST /drive/items/{item-id}/restore` | -| [Move item](../api/driveitem-move.md) | `PATCH /drive/items/{item-id}` | -| [Copy item](../api/driveitem-copy.md) | `POST /drive/items/{item-id}/copy` | -| [Search items](../api/driveitem-search.md) | `GET /drive/items/{item-id}/search(q='text')` | -| [Track changes](../api/driveitem-delta.md) | `GET /drive/root/delta` | -| [Follow item](../api/driveitem-follow.md) | `POST /drives/{drive-id}/items/{item-id}/follow` | -| [Unfollow item](../api/driveitem-unfollow.md) | `POST /drives/{drive-id}/items/{item-id}/unfollow` | -| [Get thumbnails](../api/driveitem-list-thumbnails.md) | `GET /drive/items/{item-id}/thumbnails` | -| [Create sharing link](../api/driveitem-createlink.md) | `POST /drive/items/{item-id}/createLink` | -| [Add permissions](../api/driveitem-invite.md) | `POST /drive/items/{item-id}/invite` | -| [List permissions](../api/driveitem-list-permissions.md) | `GET /drive/items/{item-id}/permissions` | -| [Delete permission](../api/permission-delete.md) | `DELETE /drive/items/{item-id}/permissions/{perm-id}` | -| [Get WebSocket channel][getWebSocket] | `GET /drive/root/subscriptions/socketIo` | -| [Preview item][item-preview] | `POST /drive/items/{item-id}/preview` | -| [Check in files](../api/driveitem-checkin.md) | `POST /drives/{driveId}/items/{itemId}/checkin` | -| [Check out files](../api/driveitem-checkout.md) | `POST /drives/{driveId}/items/{itemId}/checkout` | -| [Revoke grants on sharing link](../api/permission-revokegrants.md) | `PATCH /drive/items/{item-id}/permissions/{perm-id}/revokeGrants` | -| [Extract sensitivity labels](../api/driveitem-extractsensitivitylabels.md) | `POST /drive/items/{item-id}/extractSensitivityLabels` | -| [Assign sensitivity label](../api/driveitem-assignsensitivitylabel.md) | `POST /drive/items/{item-id}/assignSensitivityLabel` | -| [Get retention label](../api/driveitem-getretentionlabel.md) | `GET /drives/{drive-id}/items/{id}/retentionLabel` | -| [Set retention label](../api/driveitem-setretentionlabel.md) | `PATCH /drives/{drive-id}/items/{id}/retentionLabel` | -| [Remove retention label](../api/driveitem-removeretentionlabel.md) | `DELETE /drives/{drive-id}/items/{id}/retentionLabel` | -| [Lock or unlock record](../api/driveitem-lockorunlockrecord.md) | `PATCH /drives/{drive-id}/items/{id}/retentionLabel` | +| Method | Return Type | Description | +|:--|:|:-| +| [Get item](../api/driveitem-get.md) | [driveItem](../resources/driveitem.md) |Retrieve the metadata for a **driveItem** in a drive.| +| [Get analytics][] | [itemAnalytics][] | Get analytics for this resource.| +| [Get activities by interval][] | [itemActivityStat](../resources/itemactivitystat.md) | Get a collection of **itemActivityStats** within the specified time interval.| +| [List children](../api/driveitem-list-children.md) | [driveItem](../resources/driveitem.md) collection | Return a collection of **driveItems** in the children relationship of a **driveItem**.| +| [List versions](../api/driveitem-list-versions.md) | [driveItemVersion][] collection | Retrieve the versions of a file in the current user's drive.| +| [Create folder](../api/driveitem-post-children.md) | [driveItem](../resources/driveitem.md) | Create a **driveItem** in the specified drive.| +| [Update item](../api/driveitem-update.md) | [driveItem](../resources/driveitem.md) | Update a **driveItem** in the drive.| +| [Upload](../api/driveitem-put-content.md) | [driveItem](../resources/driveitem.md) | Upload content to the **driveItem**.| +| [Download file content](../api/driveitem-get-contentstream.md) | Stream |Download the contents of the primary stream (file) of a **driveItem**. | +| [Download specific file format][download-format] | download URL | Download content of a **driveItem** with a specific format.| +| [Delete item](../api/driveitem-delete.md) | None | Delete a **driveItem**.| +| [Permanently delete item](../api/driveitem-permanentdelete.md) | None | Permanently delete a **driveItem** by using its ID. | +| [Move item](../api/driveitem-move.md) | [driveItem](../resources/driveitem.md) | Move a **driveItem** to a new parent item.| +| [Copy item](../api/driveitem-copy.md) | details about how to [monitor the progress](/graph/long-running-actions-overview) of the copy | Create a copy of a **driveItem** (including any children).| +| [Search items](../api/driveitem-search.md) | [driveItem](../resources/driveitem.md) collection | Search the hierarchy of items for items matching a query.| +| [Track changes](../api/driveitem-delta.md) | delta link | List any changes in the drive.| +| [Follow item](../api/driveitem-follow.md) | [driveItem](../resources/driveitem.md) | Follow a **driveItem**.| +| [Unfollow item](../api/driveitem-unfollow.md) | None | Unfollow a **driveItem**.| +| [Get thumbnails](../api/driveitem-list-thumbnails.md) | [driveItem](../resources/driveitem.md) collection | List **driveItems** with their thumbnails.| +| [Create sharing link](../api/driveitem-createlink.md) | sharing link | Create a link to share the **driveItem**.| +| [Add permissions](../api/driveitem-invite.md) | [permission][] collection | Send a sharing invite to a user.| +| [List permissions](../api/driveitem-list-permissions.md) | [permission][] collection | Retrieve the collection of permissions on a **driveItem**.| +| [Create permission](../api/driveitem-post-permissions.md) | [permission][] | Create a permission on a **driveItem**.| +| [Delete permission](../api/permission-delete.md) | None | Remove the permission from the **driveItem**.| +| [Revoke grants on sharing link](../api/permission-revokegrants.md)| [permission][] | Revoke access to a **listItem** or **driveItem** granted via a sharing link by removing the specified recipient from the link.| +| [Get WebSocket channel][getWebSocket] | [subscription][] | Receive near-real-time change notifications for a drive using socket.io.| +| [Preview item][item-preview] | json object | Obtain short-lived embeddable URLs for an item in order to render a temporary preview.| +| [Check in files](../api/driveitem-checkin.md) | None| Check in a checked out **driveItem** resource, which makes the version of the document available to others. | +| [Check out files](../api/driveitem-checkout.md) | None| Check out a **driveItem** resource to prevent others from editing the document, and prevent your changes from being visible until the documented is [checked in](../api/driveitem-checkin.md). | +| [Extract sensitivity labels](../api/driveitem-extractsensitivitylabels.md) | [extractSensitivityLabelsResult](../resources/extractsensitivitylabelsresult.md) | Extract one or more sensitivity labels assigned to a drive item and update the metadata of a drive item with the latest details of the assigned label. | +| [Assign sensitivity label](../api/driveitem-assignsensitivitylabel.md) | String | Asynchronously assign a sensitivity label to a **driveItem**.| +| [Get retention label](../api/driveitem-getretentionlabel.md) | [itemRetentionLabel](../resources/itemretentionlabel.md) | Get metadata information for a retention label applied on a **driveItem**. | +| [Set retention label](../api/driveitem-setretentionlabel.md) | [itemRetentionLabel](../resources/itemretentionlabel.md) | Apply (set) a retention label on a **driveItem** (files and folders). | +| [Remove retention label](../api/driveitem-removeretentionlabel.md) | None | Remove a retention label from a **driveItem**. | +| [Lock or unlock record](../api/driveitem-lockorunlockrecord.md) | [itemRetentionLabel](../resources/itemretentionlabel.md) | Lock or unlock a retention label on a **driveItem** that classifies content as records. | +| [Download file (deprecated)](../api/driveitem-get-content.md) | download URL | Download content of a **driveItem**.| ## Properties |
| v1.0 | List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/list.md | Represents a list in a [site](site.md). This resource contains the top level pro | Method | Return Type | Description | |:--|:--|:|+| [Create](../api/list-create.md) | [list](../resources/list.md) | Create a new **list** in a **site**. | +| [Get](../api/list-get.md) | [list](../resources/list.md) | Get the metadata for a **list**. | +| [Get items](../api/listitem-list.md) | [listItem](../resources/listitem.md) collection | Get the collection of [listItems]( ../resources/listitem.md) in a **list**. | | [Get lists in a site](../api/list-list.md) | [list](../resources/list.md) collection | Get the collection of **lists** in a [site](site.md). |-| [Create list](../api/list-create.md) | [list](../resources/list.md) | Create a new **list** in a **site**. | -| [Get list](../api/list-get.md) | [list](../resources/list.md) | Get the metadata for a **list**. | | [Get recent activities](../api/activities-list.md) | [itemActivity](../resources/itemactivity.md) collection | List the recent [activities](../resources/itemactivity.md) that took place on an item or under a hierarchy. |-| [Get items](../api/listitem-list.md) | [listItem](../resources/listitem.md) collection | Get the collection of [listItems]( ../resources/listitem.md) in a **list**. | +| [Create item](../api/listitem-create.md) | [listItem](../resources/listitem.md) | Create a new [listItem]( ../resources/listitem.md) in a **list**. | | [Update item](../api/listitem-update.md) | [listItem](../resources/listitem.md) | Update the properties on a [listItem]( ../resources/listitem.md). | | [Delete item](../api/listitem-delete.md) | None | Delete a [listItem]( ../resources/listitem.md) from a **list**. |-| [Create item](../api/listitem-create.md) | [listItem](../resources/listitem.md) | Create a new [listItem]( ../resources/listitem.md) in a **list**. | | [Get websocket endpoint](../api/subscriptions-socketio.md) | [subscription](../resources/subscription.md) | Get near-real-time change notifications for a [drive](../resources/drive.md) and **list** using [socket.io](https://socket.io/). | | [List operations in a list](../api/list-list-operations.md) | [richLongRunningOperation](../resources/richlongrunningoperation.md) collection | Get a list of [rich long-running operations](../resources/richlongrunningoperation.md) associated with a **list**. | | [List content types](../api/list-list-contenttypes.md) | [contentType](../resources/contenttype.md) collection | Get the collection of [contentType](../resources/contenttype.md) resources in a **list**. | | [Add copy to list](../api/contenttype-addcopy.md) | [contentType](../resources/contenttype.md) | Add a copy of a [contentType](../resources/contenttype.md) from a [site](site.md) to a **list**. | | [List columns](../api/list-list-columns.md) | [columnDefinition](../resources/columndefinition.md) collection | Get the collection of columns, represented as [columnDefinition](../resources/columndefinition.md) objects, in a **list**. | | [Create column](../api/list-post-columns.md) | [columnDefinition](../resources/columndefinition.md) | Create a column for a **list** with a request that specifies a [columnDefinition](../resources/columndefinition.md). |+| [List permissions](../api/list-list-permissions.md)| [permission](../resources/permission.md) |Get a list of the [permission](../resources/permission.md) objects associated with a [list](../resources/list.md).| +| [Create permission](../api/list-list-permissions.md)| [permission](../resources/permission.md) |Get a list of the [permission](../resources/permission.md) objects associated with a [list](../resources/list.md).| +| [Get permission](../api/list-post-permissions.md)| [permission](../resources/permission.md) |Create a new [permission](../resources/permission.md) object on a [list](../resources/list.md).| +| [Update permission](../api/list-update-permissions.md)| [permission](../resources/permission.md) |Update a [permission](../resources/permission.md) object on a [list](../resources/list.md).| +| [Delete permission](../api/list-delete-permissions.md)| None |Delete a [permission](../resources/permission.md) object on a [list](../resources/list.md).| ## Properties Represents a list in a [site](site.md). This resource contains the top level pro | drive | [drive](drive.md) | Allows access to the list as a **drive** resource with [driveItems](driveitem.md). Only present on document libraries. | | items | [listItem](listitem.md) collection | All items contained in the list. | | operations | [richLongRunningOperation](../resources/richlongrunningoperation.md) collection | The collection of long-running operations on the list. |+| permissions | [permission](permission.md) collection | The set of permissions for the item. Read-only. Nullable. | | subscriptions | [subscription](subscription.md) collection | The set of subscriptions on the list. | ## JSON representation |
| v1.0 | Listitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/listitem.md | Column values in the list are available through the `fieldValueSet` dictionary. ## Methods The following tasks are available for **listItem** resources.-All examples below are relative to a **[list][]**, eg: `https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id}`. --| Common task | HTTP method | -| :-- | :- | -| [Get][] | GET /items/{item-id} | -| [Get column values][Get] | GET /items/{item-id}?expand=fields | -| [Get analytics][] | GET /items/{item-id}/analytics | -| [Get activities by interval][] | GET /items/{item-id}/getActivitiesByInterval | -| [Create][] | POST /items | -| [Delete][] | DELETE /items/{item-id} | -| [Update][] | PATCH /items/{item-id} | -| [Update column values][Update] | PATCH /items/{item-id}/fields | -| [createLink][CreateLink] | POST /items/{itemId}/createLink | -| [List](../api/listitem-list-documentsetversions.md)| GET /items/{item-id}/documentSetVersions | -| [Create](../api/listitem-post-documentsetversions.md)| POST /items/{item-id}/documentSetVersions | -| [Restore](../api/documentsetversion-restore.md)| POST /items/{item-id}/documentSetVersions/{documentSetVersion-id}/restore | -| [Get delta][item-changes] | GET /items/{item-id}/delta +All examples are relative to a **[list][]**; for example, `https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id}`. ++| Method | Return Type | Description | +|:-|:--|:--| +| [Create][] | listItem | Create a new listItem in a list. | +| [Get][] | listItem | Get an item in a list. | +| [Update][] | [fieldValueSet][] | Update the properties on a listItem. | +| [Delete][] | No Content | Removes an item from a list. | +| [Get analytics][] | [itemAnalytics][] | Get analytics for this resource. | +| [Get column values][Get] | listItem | Get column values from listItem. | +| [Update column values][Update] | [fieldValueSet][] | Update column values on a listItem. | +| [List document set version](../api/listitem-list-documentsetversions.md) | [documentSetVersion][] collection | Get a list of the versions of a document set item in a list. | +| [Create document set version](../api/listitem-post-documentsetversions.md) | [documentSetVersion][] | Create a new version of a document set item in a list. | +| [Restore document set version](../api/documentsetversion-restore.md) | No Content | Restore the document set item to a specific version. | +| [Get delta](../api/listitem-delta.md) | [listItem](../resources/listitem.md) collection | Get newly created, updated, or deleted [list items](../resources/listitem.md) without having to perform a full read of the entire items collection. | +| [List permissions](../api/listitem-list-permissions.md)| [permission](../resources/permission.md) |Get a list of the [permission](../resources/permission.md) objects associated with a [listItem](../resources/listitem.md).| +| [Create permission](../api/listitem-list-permissions.md)| [permission](../resources/permission.md) |Get a list of the [permission](../resources/permission.md) objects associated with a [listItem](../resources/listitem.md).| +| [Get permission](../api/listitem-post-permissions.md)| [permission](../resources/permission.md) |Create a new [permission](../resources/permission.md) object on a [listItem](../resources/listitem.md).| +| [Update permission](../api/listitem-update-permissions.md)| [permission](../resources/permission.md) |Update a [permission](../resources/permission.md) object on a [listItem](../resources/listitem.md).| +| [Delete permission](../api/listitem-delete-permissions.md)| None |Delete a [permission](../resources/permission.md) object on a [listItem](../resources/listitem.md).| [Get]: ../api/listitem-get.md [Get analytics]: ../api/itemanalytics-get.md-[Get activities by interval]: ../api/itemactivity-getbyinterval.md [Create]: ../api/listitem-create.md [Delete]: ../api/listitem-delete.md [Update]: ../api/listitem-update.md-[CreateLink]: ../api/listitem-createlink.md -[item-changes]: ../api/listitem-delta.md +[itemActivityStat]: itemactivitystat.md +[fieldValueSet]: fieldvalueset.md +[documentSetVersion]: documentsetversion.md ## Properties The following properties are inherited from **[baseItem][]**. |documentSetVersions|[documentSetVersion](../resources/documentsetversion.md) collection| Version information for a document set version created by a user.| | driveItem | [driveItem][] | For document libraries, the **driveItem** relationship exposes the listItem as a **[driveItem][]** | | fields | [fieldValueSet][] | The values of the columns set on this list item. |+| permissions | [permission](permission.md) collection | The set of permissions for the item. Read-only. Nullable. | | versions | [listItemVersion][] collection | The list of previous versions of the list item. | ## JSON representation |
| v1.0 | Onlinemeeting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/onlinemeeting.md | Inherits from [onlineMeetingBase](../resources/onlineMeetingBase.md). | allowTranscription | Boolean | Indicates whether transcription is enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | allowRecording | Boolean | Indicates whether recording is enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | allowedPresenters | [onlineMeetingPresenters](#onlinemeetingpresenters-values)| Specifies who can be a presenter in a meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |-| alternativeRecording (deprecated) | Stream | The content stream of the alternative recording of a [Microsoft Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). Read-only. | | anonymizeIdentityForRoles | onlineMeetingRole collection | Specifies whose identity is anonymized in the meeting. Possible values are: `attendee`. The `attendee` value can't be removed through a PATCH operation once added. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |-| attendeeReport (deprecated) | Stream | The content stream of the attendee report of a [Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). Read-only. | | audioConferencing | [audioConferencing](audioconferencing.md) | The phone access (dial-in) information for an online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md).|-| broadcastSettings (deprecated) | [broadcastMeetingSettings](broadcastMeetingSettings.md) | Settings related to a live event. | | chatInfo | [chatInfo](chatinfo.md) | The chat information associated with this online meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | creationDateTime | DateTime | The meeting creation time in UTC. Read-only. | | endDateTime | DateTime | The meeting end time in UTC. Required when you create an online meeting. | Inherits from [onlineMeetingBase](../resources/onlineMeetingBase.md). | joinInformation | [itemBody](itembody.md) | The join information in the language and locale variant specified in 'Accept-Language' request HTTP header. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | joinMeetingIdSettings | [joinMeetingIdSettings](joinmeetingidsettings.md) | Specifies the **joinMeetingId**, the meeting passcode, and the requirement for the passcode. Once an **onlineMeeting** is created, the **joinMeetingIdSettings** can't be modified. To make any changes to this property, the meeting needs to be canceled and a new one needs to be created. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | joinWebUrl | String | The join URL of the online meeting. The format of the URL may change; therefore, users shouldn't rely on any information extracted from parsing the URL. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |-| lobbyBypassSettings | [lobbyBypassSettings](lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | +| lobbyBypassSettings | [lobbyBypassSettings](lobbybypasssettings.md) | Specifies which participants can bypass the meeting lobby. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | meetingTemplateId | String | The ID of the [meeting template](/microsoftteams/create-custom-meeting-template). | | participants | [meetingParticipants](meetingparticipants.md) | The participants associated with the online meeting, including the organizer and the attendees. | | recordAutomatically | Boolean | Indicates whether to record the meeting automatically. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |-| recording (deprecated) | Stream | The content stream of the recording of a [Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). Read-only. | -| shareMeetingChatHistoryDefault | [meetingChatHistoryDefaultMode](#meetingchathistorydefaultmode-values) | Specifies whether meeting chat history is shared with participants. Possible values are: `all`, `none`, `unknownFutureValue`. | | startDateTime | DateTime | The meeting start time in UTC. Required when you create an online meeting. |-| subject | String | The subject of the online meeting. Required when you create an online meeting. | -| videoTeleconferenceId | String | The video teleconferencing ID. Read-only. | -| watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether the client application should apply a watermark. | | shareMeetingChatHistoryDefault | [meetingChatHistoryDefaultMode](#meetingchathistorydefaultmode-values) | Specifies whether meeting chat history is shared with participants. Possible values are: `all`, `none`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |-| startDateTime | DateTime | The meeting start time in UTC. | | subject | String | The subject of the online meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | videoTeleconferenceId | String | The video teleconferencing ID. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether the client application should apply a watermark to a content type. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |+| alternativeRecording (deprecated) | Stream | The content stream of the alternative recording of a [Microsoft Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). Read-only. | +| attendeeReport (deprecated) | Stream | The content stream of the attendee report of a [Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). Read-only. | | autoAdmittedUsers (deprecated) | String | The setting that specifies the type of participants that are automatically allowed into the online meeting. Possible values are: `everyone`, `everyoneInSameAndFederatedCompany`, `everyoneInCompany`, `invitedUsersInCompany`, `organizer`. Read-only. |-| isBroadcast (deprecated) | Boolean | Indicates whether this event is a [Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). | +| broadcastSettings (deprecated) | [broadcastMeetingSettings](broadcastMeetingSettings.md) | Settings related to a live event. | | capabilities (deprecated) | meetingCapabilities collection | The list of meeting capabilities. Possible values are: `questionAndAnswer`,`unknownFutureValue`. |+| isBroadcast (deprecated) | Boolean | Indicates whether this event is a [Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). | +| recording (deprecated) | Stream | The content stream of the recording of a [Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). Read-only. | > [!CAUTION] >->- The **autoAdmittedUsers** property is deprecated. Use the **scope** property of [lobbyBypassSettings](lobbyBypassSettings.md) instead. +>- The **autoAdmittedUsers** property is deprecated. Use the **scope** property of [lobbyBypassSettings](lobbybypasssettings.md) instead. >- The **capabilities** property is deprecated. Use the **isQuestionAndAnswerEnabled** property of [broadcastMeetingSettings](broadcastMeetingSettings.md) instead. ### onlineMeetingPresenters values |
| v1.0 | Shared | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/shared.md | Title: Shared + Title: shared resource type -description: The Shared resource indicates a DriveItem has been shared with others. Previously updated : 09/10/2017+description: Indicates that a drive item has been shared with others. ms.localizationpriority: medium doc_type: resourcePageType -# Shared resource type +# shared resource type Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -The **Shared** resource indicates a DriveItem has been shared with others. -The resource includes information about how the item is shared. +Indicates that a [drive item](driveitem.md) was shared with others and includes information about how the item is shared. -If a [**Driveitem**](driveitem.md) has a non-null **shared** facet, the item has been shared. +If a [driveItem](driveitem.md) has a non-null **shared** facet, the item was shared. ++## Properties ++| Property | Type | Description +| :- |:|:- +| owner | [IdentitySet](identityset.md) | The identity of the owner of the shared item. Read-only.| +| sharedBy | [identitySet](identityset.md) | The identity of the user who shared the item. Read-only.| +| sharedDateTime | DateTimeOffset | The UTC date and time when the item was shared. Read-only.| +| scope (deprecated)| String | Indicates the scope of how the item is shared. The possible values are: `anonymous`, `organization`, or `users`. Read-only.| +++### scope property values ++| Value | Description | +|:|:--| +| `anonymous` | The item is shared by using a link that works for anyone with the link. | +| `organization` | The item is shared by using a link that works for anyone in the owner's organization. | +| `users` | The item is shared with specific users only. | ## JSON representation If a [**Driveitem**](driveitem.md) has a non-null **shared** facet, the item has } ``` -## Properties --| Property | Type | Description -| :- |:|:- -| owner | [IdentitySet](identityset.md) | The identity of the owner of the shared item. Read-only. -| scope | String | Indicates the scope of how the item is shared: `anonymous`, `organization`, or `users`. Read-only. -| sharedBy | [identitySet](identityset.md) | The identity of the user who shared the item. Read-only. -| sharedDateTime | DateTimeOffset | The UTC date and time when the item was shared. Read-only. --## Scope values --| Value | Description | -|:|:--| -| `anonymous` | The item is shared by using a link that works for anyone with the link. | -| `organization` | The item is shared by using a link that works for anyone in the owner's organization. | -| `users` | The item is shared with specific users only. | --## Remarks --For more information about the facets on a **driveItem**, see [**driveItem**](driveitem.md). - <!-- { "type": "#page.annotation", |
| v1.0 | Authenticationcombinationconfiguration Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationcombinationconfiguration-update.md | doc_type: apiPageType # Update authenticationCombinationConfiguration Namespace: microsoft.graph -Update the properties of an [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) object. In use, only [fido2combinationConfigurations](../resources/fido2combinationconfiguration.md) may be updated as they're the only type of [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) that may be created. +Update the properties of an [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) object. +The properties can be for one of the following derived types: +* [fido2combinationConfigurations](../resources/fido2combinationconfiguration.md) +* [x509certificatecombinationconfiguration](../resources/x509certificatecombinationconfiguration.md) + [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /identity/conditionalAccess/authenticationStrength/policies/{authenticatio |Property|Type|Description| |:|:|:|-|appliesToCombinations|authenticationMethodModes collection|The combinations to which this configuration applies. The only possible value for fido2combinationConfigurations is `fido2`. Required.| --+|appliesToCombinations|authenticationMethodModes collection|The combinations where this configuration applies. For **fido2combinationConfigurations** use `"fido2"`, for **x509certificatecombinationconfiguration** use `"x509CertificateSingleFactor"` or `"x509CertificateMultiFactor"`. Required.| ## Response |
| v1.0 | Authenticationstrengthpolicy List Combinationconfigurations | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationstrengthpolicy-list-combinationconfigurations.md | doc_type: apiPageType # List combinationConfigurations Namespace: microsoft.graph -Get the [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) objects for an [authentication strength policy](../resources/authenticationstrengthpolicy.md). authenticationCombinationConfiguration represents requirements placed on specific authentication method combinations that require specified variants of those authentication methods to be used when authenticating. Currently, only [fido2combinationConfigurations](../resources/fido2combinationconfiguration.md) objects are supported. +Get the [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) objects for an [authentication strength policy](../resources/authenticationstrengthpolicy.md). The objects can be of one or more of the following derived types: +* [fido2combinationConfigurations](../resources/fido2combinationconfiguration.md) +* [x509certificatecombinationconfiguration](../resources/x509certificatecombinationconfiguration.md) -authenticationCombinationConfiguration objects are supported only for custom authentication strengths. +**authenticationCombinationConfiguration** objects are supported only for custom authentication strengths. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] |
| v1.0 | Authenticationstrengthpolicy Post Combinationconfigurations | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationstrengthpolicy-post-combinationconfigurations.md | Title: "Create authenticationCombinationConfiguration" -description: "Create a new authenticationCombinationConfiguration object. In use, only fido2combinationConfigurations may be created, and these may only be created for custom authentication strength policies." +description: "Create a new authenticationCombinationConfiguration object." ms.localizationpriority: medium-# Create combinationConfiguration +# Create authenticationCombinationConfiguration Namespace: microsoft.graph -Create a new authenticationCombinationConfiguration object. In use, only [fido2combinationConfigurations](../resources/fido2combinationconfiguration.md) may be created, and these may only be created for custom authentication strength policies. +Create a new authenticationCombinationConfiguration object which can be of one of the following derived types: +* [fido2combinationConfiguration](../resources/fido2combinationconfiguration.md) +* [x509certificatecombinationconfiguration](../resources/x509certificatecombinationconfiguration.md) [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] You can specify the following properties when creating an **authenticationCombin |Property|Type|Description| |:|:|:|-|appliesToCombinations|authenticationMethodModes collection|The combinations to which this configuration applies. The only possible value for fido2combinationConfigurations is `fido2`. Required.| -+|appliesToCombinations|authenticationMethodModes collection|The combinations where this configuration applies. For **fido2combinationConfigurations** use `"fido2"`, for **x509certificatecombinationconfiguration** use `"x509CertificateSingleFactor"` or `"x509CertificateMultiFactor"`. Required.| ## Response -If successful, this method returns a `201 Created` response code and a [fido2CombinationConfiguration](../resources/fido2CombinationConfiguration.md) object in the response body. +If successful, this method returns a `201 Created` response code and an [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) object which can be a [fido2combinationConfigurations](../resources/fido2combinationconfiguration.md) or an [x509certificatecombinationconfiguration](../resources/x509certificatecombinationconfiguration.md) object in the response body. ## Examples -### Request +### Example 1: Create a fido2combinationConfiguration object ++#### Request The following example shows a request. # [HTTP](#tab/http) <!-- { "blockType": "request",- "name": "create_authenticationcombinationconfiguration_from_" + "name": "create_authenticationcombinationconfiguration_fido2CombinationConfiguration" } --> ``` http-POST https://graph.microsoft.com/v1.0/identity/conditionalAccess/authenticationStrength/policies/8313edec-d6af-483f-87b8-ec7cccfd2ab4/combinationConfigurations +POST https://graph.microsoft.com/v1.0/identity/conditionalAccess/authenticationStrength/policies/{authenticationStrengthPolicyId}//combinationConfigurations Content-Type: application/json Content-length: 130 Content-length: 130 -### Response +#### Response The following example shows the response. >**Note:** The response object shown here might be shortened for readability. <!-- { Content-Type: application/json } ``` +### Example 2: Create a x509CertificateCombinationConfiguration object ++#### Request +The following example shows a request. ++<!-- { + "blockType": "request", + "name": "create_authenticationcombinationconfiguration_x509CertificateCombinationConfiguration" +} +--> +``` http +POST https://graph.microsoft.com/v1.0/identity/conditionalAccess/authenticationStrength/policies/{authenticationStrengthPolicyId}/combinationConfigurations + +{ + "@odata.type": "#microsoft.graph.x509CertificateCombinationConfiguration", + "allowedIssuerSkis": [ + "9A4248C6AC8C2931AB2A86537818E92E7B6C97B6" + ], + "allowedPolicyOIDs": [], + "appliesToCombinations": [ + "x509CertificateSingleFactor " + ] +} +``` ++#### Response +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.authenticationCombinationConfiguration" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.x509CertificateCombinationConfiguration", + "id" : "96cb1a17-e45e-4b4f-8b4b-4a9490d63d66", + "allowedIssuerSkis": [ + "9A4248C6AC8C2931AB2A86537818E92E7B6C97B6" + ], + "allowedPolicyOIDs": [], + "appliesToCombinations": [ + "x509CertificateSingleFactor " + ] +} +``` + |
| v1.0 | Accessreviewsv2 Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accessreviewsv2-overview.md | Title: "MOverview of access reviews APIs" + Title: "Overview of access reviews APIs" description: "Use Microsoft Entra access reviews to configure one-time or recurring access reviews for attestation of a principal's access rights to Microsoft Entra resources." ms.localizationpriority: medium |
| v1.0 | Authenticationcombinationconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/authenticationcombinationconfiguration.md | doc_type: resourcePageType Namespace: microsoft.graph -An authentication combination configuration sets restrictions on specific types, modes, and versions of an authentication method that is tied to specific auth method combinations used in an [authentication strength](authenticationstrengths-overview.md). -This is an abstract type. In use, [fido2combinationConfigurations](fido2combinationconfiguration.md) may be created and managed as described below. +Sets restrictions on specific types, modes, or versions of an authentication method that is tied to specific auth method combinations used in an [authentication strength](authenticationstrengths-overview.md). ++The following resources inherit from this abstract type and define the various types of combination configurations: +* [fido2combinationConfigurations](fido2combinationconfiguration.md) +* [x509certificatecombinationconfiguration](x509certificatecombinationconfiguration.md) ## Methods |Method|Return type|Description| |:|:|:| |[List](../api/authenticationstrengthpolicy-list-combinationconfigurations.md)|[authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) collection|Get a list of the [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) objects and their properties.|-|[Create](../api/authenticationstrengthpolicy-post-combinationconfigurations.md)|[fido2combinationconfiguration](../resources/fido2combinationconfiguration.md)|Create a new [fido2combinationconfiguration](../resources/fido2combinationconfiguration.md) object.| -|[Get](../api/authenticationcombinationconfiguration-get.md)|[fido2combinationconfiguration](../resources/fido2combinationconfiguration.md)|Read the properties and relationships of a [fido2combinationconfiguration](../resources/fido2combinationconfiguration.md) object.| -|[Update](../api/authenticationcombinationconfiguration-update.md)|[fido2combinationconfiguration](../resources/fido2combinationconfiguration.md)|Update the properties of a [fido2combinationconfiguration](../resources/fido2combinationconfiguration.md) object.| -|[Delete](../api/authenticationstrengthpolicy-delete-combinationconfigurations.md)|None|Deletes an [fido2combinationconfiguration](../resources/fido2combinationconfiguration.md) object.| +|[Create](../api/authenticationstrengthpolicy-post-combinationconfigurations.md)|[authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md)| Create a new [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) | +|[Get](../api/authenticationcombinationconfiguration-get.md)|[authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md)|Read the properties and relationships of a [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) object.| +|[Update](../api/authenticationcombinationconfiguration-update.md)|[authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md)|Update the properties of an [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) object.| +|[Delete](../api/authenticationstrengthpolicy-delete-combinationconfigurations.md)|None|Delete an [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) object.| ## Properties |Property|Type|Description| |:|:|:|-|appliesToCombinations|authenticationMethodModes collection|Which authentication method combinations this configuration applies to. Must be an **allowedCombinations** object that's defined for the [authenticationStrengthPolicy](../resources/authenticationstrengthpolicy.md). The only possible value for `fido2combinationConfigurations` is `"fido2"`.| +|appliesToCombinations|authenticationMethodModes collection|Which authentication method combinations this configuration applies to. Must be an **allowedCombinations** object, part of the [authenticationStrengthPolicy](../resources/authenticationstrengthpolicy.md). The only possible value for `fido2combinationConfigurations` is `"fido2"`.| |id|String|A unique system-generated identifier.| ## Relationships-|id|String|A unique system-generated identifier.| +None. + ## JSON representation The following JSON representation shows the resource type. <!-- { The following JSON representation shows the resource type. ] } ```- |
| v1.0 | Fido2combinationconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/fido2combinationconfiguration.md | Title: "fido2CombinationConfiguration resource type" -description: "Configuration to require specific FIDO2 key types in an authentication strength" +description: "Configuration to require specific FIDO2 keys in an authentication strength" ms.localizationpriority: medium doc_type: resourcePageType Namespace: microsoft.graph -Configuration to require specific FIDO2 key types in an authentication strength. An administrator may use this entity to specify which Authenticator Attestation GUIDs (AAGUIDs) are allowed, as part of certain authentication method combinations, in an [authentication strength](authenticationstrengthpolicy.md). -+Configuration to require specific FIDO2 keys in an authentication strength. Use this entity to specify which Authenticator Attestation GUIDs (AAGUIDs) are allowed, as part of certain authentication method combinations, in an [authentication strength](authenticationstrengthpolicy.md). Inherits and derived from [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md). None. |Property|Type|Description| |:|:|:| |allowedAAGUIDs|String collection|A list of AAGUIDs allowed to be used as part of the specified authentication method combinations.|-|appliesToCombinations|authenticationMethodModes collection|Which authentication method combinations this configuration applies to. The only possible value for fido2combinationConfigurations is `"fido2"`. Inherited from [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md).| +|appliesToCombinations|authenticationMethodModes collection|Which authentication method combinations this configuration applies to. The only possible value is `"fido2"`. Inherited from [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md).| |id|String|A system-generated identifier. Inherited from [entity](../resources/entity.md).| ## Relationships |
| v1.0 | Onlinemeeting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/onlinemeeting.md | Contains information about a meeting, including the URL used to join a meeting, | allowMeetingChat | [meetingChatMode](#meetingchatmode-values) | Specifies the mode of meeting chat. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | allowParticipantsToChangeName | Boolean | Specifies if participants are allowed to rename themselves in an instance of the meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | allowTeamworkReactions | Boolean | Indicates whether Teams reactions are enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |-| attendeeReport (deprecated) | Stream | The content stream of the attendee report of a [Microsoft Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). Read-only. | | audioConferencing | [audioConferencing](audioconferencing.md) | The phone access (dial-in) information for an online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |-| broadcastSettings (deprecated) | [broadcastMeetingSettings](broadcastMeetingSettings.md) | Settings related to a live event. | | chatInfo | [chatInfo](chatinfo.md) | The chat information associated with this online meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | creationDateTime | DateTime | The meeting creation time in UTC. Read-only. |-| endDateTime | DateTime | The meeting end time in UTC. Required when you create an online meeting. | -| id | String | The default ID associated with the online meeting. Read-only. | -| isBroadcast (deprecated) | Boolean | Indicates whether this meeting is a [Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). | -| isEntryExitAnnounced | Boolean | Indicates whether to announce when callers join or leave. | -| joinInformation | [itemBody](itembody.md) | The join information in the language and locale variant specified in the `Accept-Language` request HTTP header. Read-only. | -| joinMeetingIdSettings | [joinMeetingIdSettings](joinmeetingidsettings.md) | Specifies the **joinMeetingId**, the meeting passcode, and the requirement for the passcode. Once an **onlineMeeting** is created, the **joinMeetingIdSettings** can't be modified. To make any changes to this property, the meeting needs to be canceled and a new one needs to be created. | +| endDateTime | DateTime | The meeting end time in UTC. Required when you create an online meeting. | joinWebUrl | String | The join URL of the online meeting. The format of the URL may change; therefore, users shouldn't rely on any information extracted from parsing the URL. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |-| lobbyBypassSettings | [lobbyBypassSettings](lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. | | participants | [meetingParticipants](meetingparticipants.md) | The participants associated with the online meeting, including the organizer and the attendees. |-| recordAutomatically | Boolean | Indicates whether to record the meeting automatically. | -| shareMeetingChatHistoryDefault | [meetingChatHistoryDefaultMode](#meetingchathistorydefaultmode-values) | Specifies whether meeting chat history is shared with participants. Possible values are: `all`, `none`, `unknownFutureValue`. | -| startDateTime | DateTime | The meeting start time in UTC. Required when you create an online meeting. | | subject | String | The subject of the online meeting. Required when you create an online meeting. |-| videoTeleconferenceId | String | The video teleconferencing ID. Read-only. | -| endDateTime | DateTime | The meeting end time in UTC. | | id | String | The default ID associated with the online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |-| isBroadcast (deprecated) | Boolean | Indicates whether this event is a [Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). | | isEntryExitAnnounced | Boolean | Indicates whether to announce when callers join or leave. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | joinInformation | [itemBody](itembody.md) | The join information in the language and locale variant specified in the `Accept-Language` request HTTP header. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | joinMeetingIdSettings | [joinMeetingIdSettings](joinmeetingidsettings.md) | Specifies the **joinMeetingId**, the meeting passcode, and the requirement for the passcode. Once an **onlineMeeting** is created, the **joinMeetingIdSettings** can't be modified. To make any changes to this property, the meeting needs to be canceled and a new one needs to be created. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |-| joinWebUrl | String | The join URL of the online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| lobbyBypassSettings | [lobbyBypassSettings](lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| participants | [meetingParticipants](meetingparticipants.md) | The participants associated with the online meeting, including the organizer and the attendees. | +| lobbyBypassSettings | [lobbyBypassSettings](lobbybypasssettings.md) | Specifies which participants can bypass the meeting lobby. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | recordAutomatically | Boolean | Indicates whether to record the meeting automatically. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | shareMeetingChatHistoryDefault | [meetingChatHistoryDefaultMode](#meetingchathistorydefaultmode-values) | Specifies whether meeting chat history is shared with participants. Possible values are: `all`, `none`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | startDateTime | DateTime | The meeting start time in UTC. |-| subject | String | The subject of the online meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | videoTeleconferenceId | String | The video teleconferencing ID. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |-| watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether the client application should apply a watermark a content type. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | +| watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether the client application should apply a watermark a content type. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| attendeeReport (deprecated) | Stream | The content stream of the attendee report of a [Microsoft Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). Read-only. | +| broadcastSettings (deprecated) | [broadcastMeetingSettings](broadcastMeetingSettings.md) | Settings related to a live event. | +| isBroadcast (deprecated) | Boolean | Indicates whether this meeting is a [Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). | ### onlineMeetingPresenters values |
| v1.0 | Shared | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/shared.md | Title: shared resource type ms.localizationpriority: medium -description: "The shared resource indicates a driveItem has been shared with others." +description: "Indicates that a drive item has been shared with others." doc_type: resourcePageType doc_type: resourcePageType Namespace: microsoft.graph -The **shared** resource indicates a **driveItem** has been shared with others. -The resource includes information about how the item is shared. +Indicates that a [drive item](driveitem.md) was shared with others and includes information about how the item was shared. -If a [**driveitem**](driveitem.md) has a non-null **shared** facet, the item has been shared. +If a [driveItem](driveitem.md) has a non-null **shared** facet, the item was shared. ++## Properties ++| Property | Type | Description +| :- |:|:- +| owner | [IdentitySet](identityset.md) | The identity of the owner of the shared item. Read-only.| +| sharedBy | [identitySet](identityset.md) | The identity of the user who shared the item. Read-only.| +| sharedDateTime | DateTimeOffset | The UTC date and time when the item was shared. Read-only.| +| scope (deprecated)| String | Indicates the scope of how the item is shared. The possible values are: `anonymous`, `organization`, or `users`. Read-only.| +++### scope property values ++| Value | Description | +|:|:--| +| `anonymous` | The item is shared by using a link that works for anyone with the link. | +| `organization` | The item is shared by using a link that works for anyone in the owner's organization. | +| `users` | The item is shared with specific users only. | ## JSON representation If a [**driveitem**](driveitem.md) has a non-null **shared** facet, the item has } ``` -## Properties --| Property | Type | Description -| :- |:|:- -| owner | [IdentitySet](identityset.md) | The identity of the owner of the shared item. Read-only. -| scope | String | Indicates the scope of how the item is shared: `anonymous`, `organization`, or `users`. Read-only. -| sharedBy | [identitySet](identityset.md) | The identity of the user who shared the item. Read-only. -| sharedDateTime | DateTimeOffset | The UTC date and time when the item was shared. Read-only. --## Scope options --| Value | Description | -|:|:--| -| `anonymous` | The item is shared by using a link that works for anyone with the link. | -| `organization` | The item is shared by using a link that works for anyone in the owner's organization. | -| `users` | The item is shared with specific users only. | --## Remarks --For more information about the facets on a **driveItem**, see [**driveItem**](driveitem.md). <!-- { "type": "#page.annotation", |
| v1.0 | X509certificatecombinationconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/x509certificatecombinationconfiguration.md | + + Title: "x509CertificateCombinationConfiguration resource type" +description: "Configuration to require a specific certificate in an authentication strength policy." +++ms.localizationpriority: medium +++++# x509CertificateCombinationConfiguration resource type ++Namespace: microsoft.graph ++Configuration to require specific certificate properties. You can use this entity to specify the certificate issuer or policy OID that are allowed, as part of certificate-based authentication, in an [authentication strength policy](authenticationstrengthpolicy.md). ++Inherits from [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md). ++## Methods +None. ++## Properties +|Property|Type|Description| +|:|:|:| +|allowedIssuerSkis|String collection|A list of allowed subject key identifier values.| +|allowedPolicyOIDs|String collection|A list of allowed policy OIDs.| +|appliesToCombinations|authenticationMethodModes collection| Which authentication method combinations this configuration applies to. The possible values for x509certificatecombinationconfiguration are `"x509CertificateSingleFactor"` or `"x509CertificateMultiFactor"`. Inherited from [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md).| +|id|String|A system-generated identifier. Inherited from [entity](../resources/entity.md).| ++## Relationships +None. ++## JSON representation +The following is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.x509CertificateCombinationConfiguration", + "baseType": "microsoft.graph.authenticationCombinationConfiguration", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.x509CertificateCombinationConfiguration", + "id": "String (identifier)", + "appliesToCombinations": [ + "String" + ], + "allowedIssuerSkis": [ + "String" + ], + "allowedPolicyOIDs": [ + "String" + ] +} +``` |
| v1.0 | Toc.Mapping.Json | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/toc/toc.mapping.json | a/api-reference/v1.0/toc/toc.mapping.json "resources": [ "authenticationStrengthPolicy", "authenticationCombinationConfiguration", + "fido2CombinationConfiguration", + "x509CertificateCombinationConfiguration", "authenticationMethodModeDetail" ] }, |