Service | Microsoft Docs article | Related commit history on GitHub | Change details |
---|---|---|---|
v1.0 | Accesspackage Delete Incompatibleaccesspackage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/accesspackage-delete-incompatibleaccesspackage.md | DELETE https://graph.microsoft.com/beta/identityGovernance/entitlementManagement [!INCLUDE [sample-code](../includes/snippets/php/remove-incompatibleaccesspackage-from-accesspackage-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -# [PowerShell](#tab/powershell) - # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/remove-incompatibleaccesspackage-from-accesspackage-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Accesspackage Delete Incompatiblegroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/accesspackage-delete-incompatiblegroup.md | DELETE https://graph.microsoft.com/beta/identityGovernance/entitlementManagement [!INCLUDE [sample-code](../includes/snippets/php/remove-incompatiblegroup-from-accesspackage-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -# [PowerShell](#tab/powershell) - # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/remove-incompatiblegroup-from-accesspackage-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Accesspackage Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/accesspackage-delete.md | Namespace: microsoft.graph Delete an [accessPackage](../resources/accesspackage.md) object. -You can't delete an access package if it has any **accessPackageAssignment**. To delete the access package, first [query if there are any assignments](entitlementmanagement-list-accesspackageassignments.md) with a filter to indicate the specific access package, such as: `$filter=accessPackage/id eq 'a914b616-e04e-476b-aa37-91038f0b165b'`. For more information on how to remove assignments that are still in the delivered state, see [Remove an assignment](entitlementmanagement-post-accesspackageassignmentrequests.md#example-4-remove-an-assignment). +You can't delete an access package if it has any **accessPackageAssignment**. To delete the access package, first [query if there are any assignments](entitlementmanagement-list-accesspackageassignments.md) with a filter to indicate the specific access package, such as: `$filter=accessPackage/id eq 'a914b616-e04e-476b-aa37-91038f0b165b'`. For more information on how to remove assignments that are still in the delivered state, see [Remove an assignment](entitlementmanagement-post-accesspackageassignmentrequests.md#example-2-remove-an-assignment). [!INCLUDE [national-cloud-support](../../includes/global-us.md)] |
v1.0 | Accesspackage Post Accesspackageresourcerolescopes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/accesspackage-post-accesspackageresourcerolescopes.md | Content-type: application/json "section": "documentation", "tocPath": "" }-->+++### Example 3: Add a Microsoft Entra role as a resource in an access package ++#### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_accesspackageresourcerolescope_role_accesspackage" +}--> ++```http +POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackages/{id}/accessPackageResourceRoleScopes +Content-type: application/json ++{ + "role": { + "originId": "Eligible", + "displayName": "Eligible Member", + "originSystem": "DirectoryRole", + "resource": { + "id": "ea036095-57a6-4c90-a640-013edf151eb1" + } + }, + "scope": { + "description": "Root Scope", + "displayName": "Root", + "isRootScope": true, + "originSystem": "DirectoryRole", + "originId": "c4e39bd9-1100-46d3-8c65-fb160da0071f" + } +} +``` ++# [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. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.accessPackageResourceRoleScope" +} --> ++```http +HTTP/1.1 201 Created +Content-type: application/json ++{ + "id": "ea036095-57a6-4c90-a640-013edf151eb1_c4e39bd9-1100-46d3-8c65-fb160da0071f", + "createdDateTime": "2023-06-28T01:19:48.4216782Z" +} +``` |
v1.0 | Adminconsentrequestpolicy Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/adminconsentrequestpolicy-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "adminconsentrequestpolicy_get" } --> [!INCLUDE [permissions-table](../includes/permissions/adminconsentrequestpolicy-get-permissions.md)] -When calling on behalf of a user, the user needs to belong to one of the following directory roles. To learn more about directory roles, see [Microsoft Entra built-in roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): -+ Global Administrator +When calling on behalf of a user, the user needs to belong to at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): + Global Reader + Cloud Application Administrator + Application Administrator |
v1.0 | Adminconsentrequestpolicy Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/adminconsentrequestpolicy-update.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "adminconsentrequestpolicy_update" } --> [!INCLUDE [permissions-table](../includes/permissions/adminconsentrequestpolicy-update-permissions.md)] -When calling on behalf of a user, the user needs to belong to the [Global Administrator](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) directory role. +For delegated scenarios, the calling user needs to belong to at least the *Application Administrator* or *Cloud Application Administrator* [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request |
v1.0 | Administrativeunit Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/administrativeunit-update.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "administrativeunit_update" } --> [!INCLUDE [permissions-table](../includes/permissions/administrativeunit-update-permissions.md)] -To update an administrative unit, the calling principal must be assigned one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): --* Privileged Role Administrator -* Global Administrator +To update an administrative unit, the calling principal must be assigned at least the *Privileged Role Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Appcatalogs List Teamsapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/appcatalogs-list-teamsapps.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] List [apps](../resources/teamsapp.md) from the Microsoft Teams app catalog.-It includes apps from the Microsoft Teams store, and apps from your organization's app catalog (the tenant app catalog). To get apps from your organization's app catalog only, specify `organization` as the **distributionMethod** in the request. ++This includes apps from the Microsoft Teams store and apps from your organization's app catalog (the tenant app catalog). To get apps from your organization's app catalog only, specify `organization` as the **distributionMethod** in the request. > [!NOTE] > In general, the **id** of a **teamsApp** resource is generated by the server. It is not the same as the **id** specified in a Teams app manifest, unless its **distributionMethod** is `store`. For other cases, the **id** provided by the developer as part of the Teams app manifest is stamped as the **externalId** in the **teamsApp** resource. Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "appcatalogs_list_teamsapps" } --> [!INCLUDE [permissions-table](../includes/permissions/appcatalogs-list-teamsapps-permissions.md)] -> **Note**: -The Directory.Read.All and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission and avoid using these permissions going forward. +> [!NOTE] +> The Directory.Read.All and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission and avoid using these permissions going forward. ## HTTP request Content-Type: application/json ### Example 4: List applications with a given ID, and return the submission review state -The following example lists applications with a given ID, and expands **appDefinitions** to return the **publishingState**, which reflects the submission review state of the app. `Submitted` means the review is pending, `published` means the admin approved the app, and `rejected` means the the admin rejected the app. +The following example lists applications with a given ID, and expands **appDefinitions** to return the **publishingState**, which reflects the submission review state of the app. `Submitted` means the review is pending, `published` means the admin approved the app, and `rejected` means the admin rejected app. #### Request |
v1.0 | Application Addpassword | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/application-addpassword.md | Title: "application: addPassword" description: "Add a strong password to an application." ms.localizationpriority: medium-+ doc_type: "apiPageType" Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Adds a strong password to an [application](../resources/application.md). +Adds a strong password to an [application](../resources/application.md). You can also [add passwords while creating the application](../api/application-post-applications.md#example-2-create-a-new-application-and-add-a-password-secret). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] POST /applications(appId='{appId}')/addPassword In the request body, provide an optional `passwordCredential` object with the following properties. -| Property | Type |Description| +| Property | Type |Description| |:|:--|:-| | displayName | String | Friendly name for the password. Optional. | | endDateTime | DateTimeOffset | The date and time at which the password expires represented using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Optional. The default value is "startDateTime + 2 years". | |
v1.0 | Application List Extensionproperty | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/application-list-extensionproperty.md | Title: "List extensionProperties (directory extensions)" description: "Retrieve a list of directory extension definitions." ms.localizationpriority: medium + doc_type: "apiPageType" |
v1.0 | Application Post Applications | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/application-post-applications.md | Namespace: microsoft.graph Create a new [application](../resources/application.md) object. > [!IMPORTANT]-> Adding [**passwordCredential**](../resources/passwordcredential.md) when creating applications is not supported. Use the [addPassword](application-addpassword.md) method to add passwords or secrets for an application. > > Do not share application client IDs (**appId**) in API documentation or code samples. In the request body, supply a JSON representation of [application](../resources/ If successful, this method returns `201 Created` response code and an [application](../resources/application.md) object in the response body. ## Examples-### Request ++### Example 1: Create an application with the default settings ++#### Request The following example shows a request. # [HTTP](#tab/http) Content-type: application/json -### 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 new application and add a password secret ++#### Request ++```http +POST https://graph.microsoft.com/beta/applications +Content-type: application/json ++{ + "displayName": "MyAppName" + "passwordCredential": [ + { + "displayName": "Password name" + } + ] +} +``` ++#### Response ++The following example shows the response. The **secretText** property in the response object contains the strong passwords or secret generated by Microsoft Entra ID and is 16-64 characters in length. There is no way to retrieve this password in the future. ++> **Note**: The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.passwordCredential" +} --> ++```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#applications/$entity", + "id": "83ab4737-da9d-4084-86f2-f8fbec220647", + "deletedDateTime": null, + "appId": "9519e58c-bd06-4120-a7fd-2220d4de8409", + "applicationTemplateId": null, + "disabledByMicrosoftStatus": null, + "createdDateTime": "2024-04-01T19:10:02.6626202Z", + "displayName": "MyAppName", + "description": null, + "keyCredentials": [], + "parentalControlSettings": { + "countriesBlockedForMinors": [], + "legalAgeGroupRule": "Allow" + }, + "passwordCredentials": [ + { + "customKeyIdentifier": null, + "displayName": "Password name", + "endDateTime": "2026-04-01T19:10:02.6576213Z", + "hint": "puE", + "keyId": "09a0c91a-1bc3-4eaf-a945-c88c041fad6c", + "secretText": "1234567890abcdefghijklmnopqrstuvwxyzabcd", + "startDateTime": "2024-04-01T19:10:02.6576213Z" + } + ], + "publicClient": { + "redirectUris": [] + } +} +``` + <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!-- |
v1.0 | Application Post Calls | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/application-post-calls.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "application_post_calls" } --> [!INCLUDE [permissions-table](../includes/permissions/application-post-calls-permissions.md)] -> **Notes:** -> - For a call with app-hosted media, you need the Calls.AccessMedia.All permission in addition to one of the permissions listed in the previous table. -> - Cloud Video Interop solutions that are [Certified for Microsoft Teams](/MicrosoftTeams/cloud-video-interop) have permission to call this API to join meetings for which they have meeting join links, similar to external users joining through a browser. +> [!NOTE] > - The Calls.JoinGroupCalls.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent).+> - For a call with app-hosted media, you need the Calls.AccessMedia.All permission in addition to one of the permissions listed in the previous table. ++Cloud Video Interop solutions that are [Certified for Microsoft Teams](/MicrosoftTeams/cloud-video-interop) have permission to call this API to join meetings for which they have meeting join links, similar to external users joining through a browser. ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Application Post Extensionproperty | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/application-post-extensionproperty.md | Title: "Create extensionProperty (directory extension)" description: "Create a new directory extension." ms.localizationpriority: medium + doc_type: "apiPageType" |
v1.0 | Application Post Onlinemeetings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/application-post-onlinemeetings.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "application_post_onlinemeetings" } --> [!INCLUDE [permissions-table](../includes/permissions/application-post-onlinemeetings-permissions.md)] -To use the OnlineMeetings.ReadWrite.All application permission for this API, tenant administrators must create an [application access policy](/graph/cloud-communication-online-meeting-application-access-policy) and grant it to a user to authorize the app configured in the policy to create online meetings on behalf of that user (with user ID specified in the request path). +> [!NOTE] +> To use the OnlineMeetings.ReadWrite.All application permission for this API, tenant administrators must create an [application access policy](/graph/cloud-communication-online-meeting-application-access-policy) and grant it to a user to authorize the app configured in the policy to create online meetings on behalf of that user (with user ID specified in the request path). ## HTTP request POST /users/{userId}/onlineMeetings ``` > [!NOTE]->- **userId** is the object ID of a user in [Microsoft Entra admin center > user management page](https://entra.microsoft.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more details, see [Allow applications to access online meetings on behalf of a user](/graph/cloud-communication-online-meeting-application-access-policy). +>- **userId** is the object ID of a user in [Microsoft Entra admin center > user management page](https://entra.microsoft.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more information, see [Allow applications to access online meetings on behalf of a user](/graph/cloud-communication-online-meeting-application-access-policy). ## Request headers |
v1.0 | Application Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/application-update.md | In the request body, supply the values for relevant fields that should be update | spa | [spaApplication](../resources/spaapplication.md) | Specifies settings for a single-page application, including sign out URLs and redirect URIs for authorization codes and access tokens. | | tags | String collection | Custom strings that can be used to categorize and identify the application. Not nullable. | | tokenEncryptionKeyId | String | Specifies the keyId of a public key from the keyCredentials collection. When configured, Microsoft Entra ID encrypts all the tokens it emits by using the key this property points to. The application code that receives the encrypted token must use the matching private key to decrypt the token before it can be used for the signed-in user. |+| uniqueName | String | The unique identifier that can be assigned to an application and used as an alternate key. Can updated only if `null` and is immutable once set. | | uniqueName | String | The unique identifier that can be assigned to an application as an alternative identifier. Immutable. Read-only. | | web | [webApplication](../resources/webapplication.md) | Specifies settings for a web application. | | spa | [spaApplication](../resources/spaapplication.md) | Specifies settings for a single-page application, including sign out URLs and redirect URIs for authorization codes and access tokens. | |
v1.0 | Application Upsert | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/application-upsert.md | Create a new [application](../resources/application.md) object if it doesn't exi > [!IMPORTANT] > Using PATCH to set [**passwordCredential**](../resources/passwordcredential.md) is not supported. Use the [addPassword](./application-addpassword.md) and [removePassword](./application-removepassword.md) methods to update the password or secret for an application. + ## 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). |
v1.0 | Applicationtemplate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/applicationtemplate-get.md | Namespace: microsoft.graph Retrieve the properties of an [applicationTemplate](../resources/applicationtemplate.md) object. ## Permissions |
v1.0 | Applicationtemplate Instantiate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/applicationtemplate-instantiate.md | Add an instance of an application from the [Microsoft Entra application gallery] The application template with ID `8adf8e6e-67b2-4cf2-a259-e3dc5476c621` can be used to add a [non-gallery app](/azure/active-directory/manage-apps/add-non-gallery-app) that you can configure different single-sign on (SSO) modes like SAML SSO and password-based SSO. ## Permissions |
v1.0 | Applicationtemplate List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/applicationtemplate-list.md | Namespace: microsoft.graph Retrieve a list of [applicationTemplate](../resources/applicationtemplate.md) objects from the Microsoft Entra application gallery. ## Permissions |
v1.0 | Assignedcomputeinstancedetails Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/assignedcomputeinstancedetails-get.md | description: "Read the properties and relationships of an assignedComputeInstanc ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Attacksimulationroot Delete Trainingcampaigns | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/attacksimulationroot-delete-trainingcampaigns.md | + + Title: "Delete trainingCampaign" +description: "Delete a trainingCampaign object." ++ms.localizationpriority: medium +++# Delete trainingCampaign ++Namespace: microsoft.graph +++Delete a [trainingCampaign](../resources/trainingcampaign.md) object. ++## 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": "attacksimulationroot_delete_trainingcampaigns" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /security/attackSimulation/trainingCampaigns/{trainingCampaignId}/$ref +``` ++## 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 `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_trainingcampaign" +} +--> +``` http +DELETE https://graph.microsoft.com/beta/security/attackSimulation/trainingCampaigns/{trainingCampaignId} +``` ++# [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. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Attacksimulationroot List Trainingcampaigns | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/attacksimulationroot-list-trainingcampaigns.md | + + Title: "List trainingCampaign objects" +description: "Get a list of trainingCampaign objects and their properties." ++ms.localizationpriority: medium +++# List trainingCampaign objects ++Namespace: microsoft.graph +++Get a list of [trainingCampaign](../resources/trainingcampaign.md) objects and their properties. +++## 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": "attacksimulationroot_list_trainingcampaigns" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/attackSimulation/trainingCampaigns +``` ++## Optional query parameters ++This method supports the `$count`, `$filter`, `$orderby`, `$skipToken`, `$top`, and `$select` [OData query parameters](/graph/query-parameters) to help customize the response. You can use the `$filter` and `$orderby` query parameters on the **campaignSchedule/completionDateTime**, **displayName**, **campaignSchedule/launchDateTime**, and **campaignSchedule/status** properties. ++If the result set spans multiple pages, the response body contains an `@odata.nextLink` that you can use to page through the result set. ++The following list shows some examples of requests that use the supported OData query parameters: ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/attackSimulation/trainingCampaigns?$count=true +GET /security/attackSimulation/trainingCampaigns?$filter={property} eq '{property-value}' +GET /security/attackSimulation/trainingCampaigns?$filter={property} eq '{property-value}'&$top=5 +GET /security/attackSimulation/trainingCampaigns?$orderby={property} +GET /security/attackSimulation/trainingCampaigns?$skipToken={skipToken} +GET /security/attackSimulation/trainingCampaigns?$top=1 +GET /security/attackSimulation/trainingCampaigns?$select={property} +``` ++## 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 [trainingCampaign](../resources/trainingcampaign.md) objects in the response body. ++## Examples ++### Request ++The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "list_trainingcampaign" +} +--> +``` http +GET https://graph.microsoft.com/beta/security/attackSimulation/trainingCampaigns +``` ++# [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. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.trainingCampaign)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "@odata.etag": "W/\"dub9zfj4Rk68MmY/KYwXKgADRgyGsw==\"", + "id": "81c59451-2929-5b39-86f0-5a2b15f1314f", + "displayName": "Sample Training Campaign", + "description": "Sample Training Campaign Description", + "createdDateTime": "2024-02-18T08:36:07.6534871Z", + "lastModifiedDateTime": "2024-02-19T08:00:01.9417887Z", + "endUserNotificationSetting": null, + "includedAccountTarget": null, + "excludedAccountTarget": null, + "trainingSetting": null, + "campaignSchedule": { + "launchDateTime": "2024-02-18T08:37:44Z", + "completionDateTime": "2024-02-19T07:59:44Z", + "status": "completed" + }, + "createdBy": { + "id": "99af58b9-ef1a-412b-a581-cb42fe8c8e21", + "displayName": "Reed Flores", + "email": "reed@contoso.com" + }, + "lastModifiedBy": { + "id": "99af58b9-ef1a-412b-a581-cb42fe8c8e21", + "displayName": "Reed Flores", + "email": "reed@contoso.com" + }, + } + ] +} +``` + |
v1.0 | Attacksimulationroot Post Trainingcampaigns | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/attacksimulationroot-post-trainingcampaigns.md | + + Title: "Create trainingCampaign" +description: "Create a new trainingCampaign object." ++ms.localizationpriority: medium +++# Create trainingCampaign ++Namespace: microsoft.graph +++Create a new [trainingCampaign](../resources/trainingcampaign.md) object. +++## 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": "attacksimulationroot_post_trainingcampaigns" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /security/attackSimulation/trainingCampaigns +``` ++## 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 [trainingCampaign](../resources/trainingcampaign.md) object. ++You can specify the following properties when creating a **trainingCampaign**. ++|Property|Type|Description| +|:|:|:| +|createdBy|[emailIdentity](../resources/emailidentity.md)|The identity of the user who created the training campaign. Optional.| +|createdDateTime|DateTimeOffset|The date and time when the training campaign was created. Optional.| +|description|String|The description of the training campaign. Optional.| +|displayName|String|The display name of the training campaign. Required.| +|endUserNotificationSetting|[endUserNotificationSetting](../resources/endusernotificationsetting.md)|Details about the end user notification setting. Required.| +|excludedAccountTarget|[accountTargetContent](../resources/accounttargetcontent.md)|The users who are excluded from the training campaign. Optional.| +|includedAccountTarget|[accountTargetContent](../resources/accounttargetcontent.md)|The users who are targeted in the training campaign. Required.| +|lastModifiedDateTime|DateTimeOffset|The identity of the user who most recently modified the training campaign. Optional.| +|trainingSetting|[trainingSetting](../resources/trainingsetting.md)|Details about the training settings for a training campaign. Required.| +|campaignSchedule|[campaignSchedule](../resources/campaignschedule.md)|Details about the schedule and current status for a training campaign. Required.| ++## Response ++If successful, this method returns a `202 Accepted` response code and a tracking header named `location` in the response. ++## Examples ++### Request ++The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_trainingcampaign_from_" +} +--> +``` http +POST https://graph.microsoft.com/beta/security/attackSimulation/trainingCampaigns +Content-Type: application/json ++{ + "displayName": "Graph Training Campaign", + "description": "Graph Training Campaign Description", + "createdBy": { + "email": "john@contoso.com" + }, + "lastModifiedBy": { + "email": "john@contoso.com" + }, + "includedAccountTarget": { + "type": "addressBook", + "accountTargetEmails": [ + "john@contoso.com" + ] + }, + "endUserNotificationSetting": { + "notificationPreference": "microsoft", + "settingType": "trainingSelected", + "trainingReminder": { + "deliveryFrequency": "weekly", + "endUserNotification@odata.bind": "https://graph.microsoft.com/beta/security/attackSimulation/endUserNotifications('fe521249-9901-4584-a987-026a9980c58e')", + "defaultLanguage": "en" + }, + "trainingAssignment": { + "endUserNotification@odata.bind": "https://graph.microsoft.com/beta/security/attackSimulation/endUserNotifications('36fb4dc1-7c37-4b96-9096-12e6d6014fae')", + "defaultLanguage": "en" + } + }, + "trainingSetting": { + "settingType": "microsoftCustom", + "trainingAssignmentMappings": [ + { + "assignedTo": [ + "allUsers" + ], + "training@odata.bind": "https://graph.microsoft.com/beta/security/attackSimulation/trainings('40454905-dc26-4f36-b854-3042a5362cb3')" + }, + { + "assignedTo": [ + "allUsers" + ], + "training@odata.bind": "https://graph.microsoft.com/beta/security/attackSimulation/trainings('ea70ae06-3859-4818-be9d-270ee81d80a4')" + }, + { + "assignedTo": [ + "allUsers" + ], + "training@odata.bind": "https://graph.microsoft.com/beta/security/attackSimulation/trainings('d733d88c-1b5a-48e3-a588-9910e41ac21d')" + } + ] + }, + "campaignSchedule": { + "launchDateTime": "2024-02-15T07:59:44Z", + "completionDateTime": "2024-02-18T07:59:44Z", + "status": "Scheduled" + } +} +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) ++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true +} +--> ++```http +HTTP/1.1 202 Accepted +``` |
v1.0 | Authenticationmethodsroot Usersregisteredbyfeature | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/authenticationmethodsroot-usersregisteredbyfeature.md | The following table shows the parameters that can be used with this function. |includedUserRoles|includedUserRoles|The role type for the user. Possible values are: `all`, `privilegedAdmin`, `admin`, `user`.| |includedUserTypes|includedUserTypes|User type. Possible values are: `all`, `member`, `guest`.| -The value `privilegedAdmin` consists of the following privileged admin roles: +The value `privilegedAdmin` consists of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): * Global Administrator * Security Administrator The value `privilegedAdmin` consists of the following privileged admin roles: * User Administrator * Authentication Administrator -The value `admin` includes all Azure Active Director admin roles. +The value `admin` includes all Microsoft Entra admin roles. ## Request headers |
v1.0 | Authenticationmethodsroot Usersregisteredbymethod | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/authenticationmethodsroot-usersregisteredbymethod.md | The following table shows the parameters that can be used with this function. |includedUserRoles|includedUserRoles|The role type for the user. Possible values are: `all`, `privilegedAdmin`, `admin`, `user`.| |includedUserTypes|includedUserTypes|User type. Possible values are: `all`, `member`, `guest`.| -The value `privilegedAdmin` consists of the following privileged admin roles: +The value `privilegedAdmin` consists of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): * Global Administrator * Security Administrator |
v1.0 | Authorizationsystem Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/authorizationsystem-get.md | description: "Read the properties and relationships of an authorizationSystem ob ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Authorizationsystemtypeservice Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/authorizationsystemtypeservice-get.md | description: "Read the properties and relationships of an authorizationSystemTyp ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsassociatedidentities List All | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsassociatedidentities-list-all.md | description: "Get a list of the awsIdentity objects and their properties." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsassociatedidentities List Roles | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsassociatedidentities-list-roles.md | description: "Get the awsRole resources from the awsRoles navigation property." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsassociatedidentities List Users | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsassociatedidentities-list-users.md | description: "Get a list of the awsUser objects and their properties." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsauthorizationsystem List Actions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsauthorizationsystem-list-actions.md | description: "List the awsAuthorizationSystemAction objects and their properties ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsauthorizationsystem List Policies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsauthorizationsystem-list-policies.md | description: "List all awsPolicy objects and their properties for a specific AWS ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsauthorizationsystem List Resources | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsauthorizationsystem-list-resources.md | description: "List the awsAuthorizationSystemResource objects and their properti ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsauthorizationsystem List Services | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsauthorizationsystem-list-services.md | description: "Get all services in an AWS authorization system." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsauthorizationsystem List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsauthorizationsystem-list.md | description: "Get a list of the awsAuthorizationSystem objects and their propert ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsauthorizationsystemresource Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsauthorizationsystemresource-get.md | description: "Read the properties and relationships of an awsAuthorizationSystem ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsauthorizationsystemtypeaction Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsauthorizationsystemtypeaction-get.md | description: "Read the properties and relationships of an awsAuthorizationSystem ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsexternalsystemaccessfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsexternalsystemaccessfinding-get.md | description: "Read the properties and relationships of an awsExternalSystemAcces ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsexternalsystemaccessfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsexternalsystemaccessfinding-list.md | description: "Get a list of the awsExternalSystemAccessFinding objects and their ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsexternalsystemaccessrolefinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsexternalsystemaccessrolefinding-get.md | description: "Read the properties and relationships of an awsExternalSystemAcces ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsexternalsystemaccessrolefinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsexternalsystemaccessrolefinding-list.md | description: "Get a list of the awsExternalSystemAccessRoleFinding objects and t ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsidentity Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsidentity-get.md | description: "Read the properties and relationships of an awsIdentity object." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsidentityaccessmanagementkeyagefinding Aggregatedsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsidentityaccessmanagementkeyagefinding-aggregatedsummary.md | description: "Get a raw count of AWS IAM Access Keys and their ages" ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsidentityaccessmanagementkeyagefinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsidentityaccessmanagementkeyagefinding-get.md | description: "Read the properties and relationships of an awsIdentityAccessManag ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsidentityaccessmanagementkeyagefinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsidentityaccessmanagementkeyagefinding-list.md | description: "Get a list of the awsIdentityAccessManagementKeyAgeFinding objects ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsidentityaccessmanagementkeyusagefinding Aggregatedsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsidentityaccessmanagementkeyusagefinding-aggregatedsummary.md | description: "Get a count of the AWS IAM Access Keys that have not been used in ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsidentityaccessmanagementkeyusagefinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsidentityaccessmanagementkeyusagefinding-get.md | description: "Read the properties and relationships of an awsIdentityAccessManag ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsidentityaccessmanagementkeyusagefinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsidentityaccessmanagementkeyusagefinding-list.md | description: "Get a list of the awsIdentityAccessManagementKeyUsageFinding objec ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awspolicy Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awspolicy-get.md | description: "Read the properties and relationships of an awsPolicy object." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsrole Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsrole-get.md | description: "Read the properties and relationships of an awsRole object." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsuser Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsuser-get.md | description: "Read the properties and relationships of an awsUser object." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Awsuser List Assumableroles | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsuser-list-assumableroles.md | description: "Get the assumableRole objects for an awsUser." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Azureadauthentication Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/azureadauthentication-get.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Read the properties and relationships of an [azureADAuthentication](../resources/azureadauthentication.md) object to find the level of Microsoft Entra authentication availability for your tenant. The Microsoft Entra service Level Agreement (SLA) commits to at least 99.99% authentication availability, as described in [Microsoft Entra SLA performance](/azure/active-directory/reports-monitoring/reference-azure-ad-sla-performance). This object provides you with your tenantΓÇÖs actual performance against this commitment. +Read the properties and relationships of an [azureADAuthentication](../resources/azureadauthentication.md) object to find the level of Microsoft Entra authentication availability for your tenant. The Microsoft Entra service Level Agreement (SLA) commits to at least 99.99% authentication availability, as described in [Microsoft Entra SLA performance](/azure/active-directory/reports-monitoring/reference-azure-ad-sla-performance). This object provides you with your tenant's actual performance against this commitment. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "azureadauthentication_get" } --> [!INCLUDE [permissions-table](../includes/permissions/azureadauthentication-get-permissions.md)] -In addition to the delegated permissions, the signed-in user needs to belong to one of the following directory roles that allow them to read sign-in reports. To learn more about directory roles, see [Microsoft Entra built-in roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): -+ Global Administrator +For delegated scenarios, the calling user needs to belong to at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): + Global Reader + Reports Reader + Security Administrator Don't supply a request body for this method. ## Response -If successful, this method returns a `200 OK` response code and an [azureADAuthentication](../resources/azureadauthentication.md) object in the response body. Each returned value includes a score indicating the availability percentage of the tenantΓÇÖs authentications for the month, along with a startDate and endDate indicating the month that the availability percentage is assigned to. +If successful, this method returns a `200 OK` response code and an [azureADAuthentication](../resources/azureadauthentication.md) object in the response body. Each returned value includes a score indicating the availability percentage of the tenant's authentications for the month, along with a startDate and endDate indicating the month that the availability percentage is assigned to. ## Examples |
v1.0 | Azureassociatedidentities List All | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/azureassociatedidentities-list-all.md | description: "Get a list of the azureIdentity objects and their properties." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Azureassociatedidentities List Managedidentities | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/azureassociatedidentities-list-managedidentities.md | description: "Get a list of the azureManagedIdentity objects and their propertie ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Azureassociatedidentities List Serviceprincipals | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/azureassociatedidentities-list-serviceprincipals.md | description: "Get a list of the azureServicePrincipal objects and their properti ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Azureassociatedidentities List Users | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/azureassociatedidentities-list-users.md | description: "Get a list of the azureUser objects and their properties." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Azureauthorizationsystem List Actions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/azureauthorizationsystem-list-actions.md | description: "List the azureAuthorizationSystemTypeAction objects and their prop ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Azureauthorizationsystem List Resources | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/azureauthorizationsystem-list-resources.md | description: "List the azureAuthorizationSystemResource objects and their proper ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Azureauthorizationsystem List Roledefinitions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/azureauthorizationsystem-list-roledefinitions.md | description: "Lists all Azure roles in an Azure authorization system." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Azureauthorizationsystem List Services | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/azureauthorizationsystem-list-services.md | description: "Get all services in an Azure authorization system onboarded to Per ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Azureauthorizationsystem List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/azureauthorizationsystem-list.md | description: "Get a list of the azureAuthorizationSystem objects and their prope ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Azureauthorizationsystemresource Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/azureauthorizationsystemresource-get.md | description: "Read the properties and relationships of an azureAuthorizationSyst ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Azureauthorizationsystemtypeaction Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/azureauthorizationsystemtypeaction-get.md | description: "Read the properties and relationships of an azureAuthorizationSyst ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Azureidentity Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/azureidentity-get.md | description: "Read the properties and relationships of an azureIdentity object." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Azuremanagedidentity Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/azuremanagedidentity-get.md | description: "Read the properties and relationships of an azureManagedIdentity o ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Azureroledefinition Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/azureroledefinition-get.md | description: "Gets an Azure role in an Azure authorization system." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Azureserviceprincipal Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/azureserviceprincipal-get.md | description: "Read the properties and relationships of an azureServicePrincipal ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Azureuser Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/azureuser-get.md | description: "Read the properties and relationships of an azureUser object." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | B2cidentityuserflow Delete Identityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2cidentityuserflow-delete-identityproviders.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2cidentityuserflow_delete_identityproviders" } --> [!INCLUDE [permissions-table](../includes/permissions/b2cidentityuserflow-delete-identityproviders-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request DELETE https://graph.microsoft.com/beta/identity/b2cUserFlows/B2C_1_CustomerSign [!INCLUDE [sample-code](../includes/snippets/php/delete-b2xuserflows-identityproviders-1-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -# [PowerShell](#tab/powershell) - # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-b2xuserflows-identityproviders-1-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | B2cidentityuserflow Delete Userflowidentityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2cidentityuserflow-delete-userflowidentityproviders.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2cidentityuserflow_delete_userflowidentityproviders" } --> [!INCLUDE [permissions-table](../includes/permissions/b2cidentityuserflow-delete-userflowidentityproviders-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External ID user flow administrator ## HTTP request |
v1.0 | B2cidentityuserflow Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2cidentityuserflow-delete.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2cidentityuserflow_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/b2cidentityuserflow-delete-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2cidentityuserflow Get Apiconnectorconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2cidentityuserflow-get-apiconnectorconfiguration.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2cidentityuserflow_get_apiconnectorconfiguration" } --> [!INCLUDE [permissions-table](../includes/permissions/b2cidentityuserflow-get-apiconnectorconfiguration-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2cidentityuserflow Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2cidentityuserflow-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2cidentityuserflow_get" } --> [!INCLUDE [permissions-table](../includes/permissions/b2cidentityuserflow-get-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2cidentityuserflow List Identityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2cidentityuserflow-list-identityproviders.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2cidentityuserflow_list_identityproviders" } --> [!INCLUDE [permissions-table](../includes/permissions/b2cidentityuserflow-list-identityproviders-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2cidentityuserflow List Languages | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2cidentityuserflow-list-languages.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2cidentityuserflow_list_languages" } --> [!INCLUDE [permissions-table](../includes/permissions/b2cidentityuserflow-list-languages-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2cidentityuserflow List Userflowidentityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2cidentityuserflow-list-userflowidentityproviders.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2cidentityuserflow_list_userflowidentityproviders" } --> [!INCLUDE [permissions-table](../includes/permissions/b2cidentityuserflow-list-userflowidentityproviders-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External ID user flow administrator ## HTTP request |
v1.0 | B2cidentityuserflow Post Identityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2cidentityuserflow-post-identityproviders.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2cidentityuserflow_post_identityproviders" } --> [!INCLUDE [permissions-table](../includes/permissions/b2cidentityuserflow-post-identityproviders-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2cidentityuserflow Put Apiconnectorconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2cidentityuserflow-put-apiconnectorconfiguration.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Update the [apiConnectorConfiguration](../resources/userflowapiconnectorconfiguration.md) property in a [b2cIdentityUserFlow](../resources/b2cidentityuserflow.md) to enable or disable an API connector in a user flow. Each relationship of the [apiConnectorConfiguration](../resources/userflowapiconnectorconfiguration.md) corresponds to a specific step in the user flow that can be configured to call an API connector. You configure an API connector for a particular step one at a time as shown below. +Update the [apiConnectorConfiguration](../resources/userflowapiconnectorconfiguration.md) property in a [b2cIdentityUserFlow](../resources/b2cidentityuserflow.md) to enable or disable an API connector in a user flow. Each relationship of the [apiConnectorConfiguration](../resources/userflowapiconnectorconfiguration.md) corresponds to a specific step in the user flow that can be configured to call an API connector. You configure an API connector for a particular step in the user flow at a time. ## Permissions Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2cidentityuserflow_put_apiconnectorconfiguration" } --> [!INCLUDE [permissions-table](../includes/permissions/b2cidentityuserflow-put-apiconnectorconfiguration-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request If successful, this method returns a `204 No Content` response code. ## Examples -### Example 1: Enable API connector for Post IDP Federation on sign up +### Example 1: Enable API connector for Post IdP Federation on sign-up #### Request The following example shows the response. HTTP/1.1 204 No Content ``` -### Example 2: Enable API connector for Post Attribute Collection on sign up +### Example 2: Enable API connector for Post Attribute Collection on sign-up #### Request The following example shows the response. HTTP/1.1 204 No Content ``` -### Example 3: Disable an API connector for Post Attribute Collection on sign up +### Example 3: Disable an API connector for Post Attribute Collection on sign-up #### Request |
v1.0 | B2cidentityuserflow Put Languages | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2cidentityuserflow-put-languages.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2cidentityuserflow_put_languages" } --> [!INCLUDE [permissions-table](../includes/permissions/b2cidentityuserflow-put-languages-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2cidentityuserflow Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2cidentityuserflow-update.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2cidentityuserflow_update" } --> [!INCLUDE [permissions-table](../includes/permissions/b2cidentityuserflow-update-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2cidentityuserflow Userflowidentityproviders Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2cidentityuserflow-userflowidentityproviders-update.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2cidentityuserflow_userflowidentityproviders_update" } --> [!INCLUDE [permissions-table](../includes/permissions/b2cidentityuserflow-userflowidentityproviders-update-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External ID user flow administrator ## HTTP request |
v1.0 | B2xidentityuserflow Delete Identityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2xidentityuserflow-delete-identityproviders.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2xidentityuserflow_delete_identityproviders" } --> [!INCLUDE [permissions-table](../includes/permissions/b2xidentityuserflow-delete-identityproviders-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2xidentityuserflow Delete Userflowidentityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2xidentityuserflow-delete-userflowidentityproviders.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2xidentityuserflow_delete_userflowidentityproviders" } --> [!INCLUDE [permissions-table](../includes/permissions/b2xidentityuserflow-delete-userflowidentityproviders-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External ID user flow administrator ## HTTP request |
v1.0 | B2xidentityuserflow Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2xidentityuserflow-delete.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2xidentityuserflow_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/b2xidentityuserflow-delete-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2xidentityuserflow Get Apiconnectorconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2xidentityuserflow-get-apiconnectorconfiguration.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2xidentityuserflow_get_apiconnectorconfiguration" } --> [!INCLUDE [permissions-table](../includes/permissions/b2xidentityuserflow-get-apiconnectorconfiguration-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2xidentityuserflow Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2xidentityuserflow-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2xidentityuserflow_get" } --> [!INCLUDE [permissions-table](../includes/permissions/b2xidentityuserflow-get-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2xidentityuserflow List Identityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2xidentityuserflow-list-identityproviders.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2xidentityuserflow_list_identityproviders" } --> [!INCLUDE [permissions-table](../includes/permissions/b2xidentityuserflow-list-identityproviders-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2xidentityuserflow List Languages | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2xidentityuserflow-list-languages.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2xidentityuserflow_list_languages" } --> [!INCLUDE [permissions-table](../includes/permissions/b2xidentityuserflow-list-languages-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2xidentityuserflow List Userflowidentityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2xidentityuserflow-list-userflowidentityproviders.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2xidentityuserflow_list_userflowidentityproviders" } --> [!INCLUDE [permissions-table](../includes/permissions/b2xidentityuserflow-list-userflowidentityproviders-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External ID user flow administrator ## HTTP request |
v1.0 | B2xidentityuserflow Post Identityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2xidentityuserflow-post-identityproviders.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2xidentityuserflow_post_identityproviders" } --> [!INCLUDE [permissions-table](../includes/permissions/b2xidentityuserflow-post-identityproviders-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2xidentityuserflow Put Apiconnectorconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2xidentityuserflow-put-apiconnectorconfiguration.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2xidentityuserflow_put_apiconnectorconfiguration" } --> [!INCLUDE [permissions-table](../includes/permissions/b2xidentityuserflow-put-apiconnectorconfiguration-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2xidentityuserflow Userflowidentityproviders Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/b2xidentityuserflow-userflowidentityproviders-update.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2xidentityuserflow_userflowidentityproviders_update" } --> [!INCLUDE [permissions-table](../includes/permissions/b2xidentityuserflow-userflowidentityproviders-update-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External ID user flow administrator ## HTTP request |
v1.0 | Basesitepage Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/basesitepage-delete.md | If successful, this method returns a `204 No Content` response code. It doesn't The following example shows a request. ```http-DELETE https://graph.microsoft.com/beta/sites/{site-id}/pages/{page-id} +DELETE https://graph.microsoft.com/beta/sites/a69edae4-9208-4f60-9aa3-cd0911ff0ce1/pages/7f7a2740-2d74-47ba-af0c-71ed3a3384ca ``` ### Response |
v1.0 | Basesitepage Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/basesitepage-get.md | If successful, this method returns a `200` and a [baseSitePage](../resources/bas --> ```msgraph-interactive-GET /sites/{site-id}/pages/{page-id} +GET /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202 ``` # [C#](#tab/csharp) Content-type: application/json "id": "f45354cb-d634-45df-8b88-2b4e96a1dc45", "lastModifiedDateTime": "2023-04-16T10:01:41Z", "name": "Electronic Convertible.aspx",- "webUrl": "SitePages/Electronic Convertible.aspx", + "webUrl": "https://contoso.sharepoint.com/SitePages/Electronic Convertible.aspx", "title": "Electronic Convertible", "pageLayout": "article", "thumbnailWebUrl": "https://media.akamai.odsp.cdn.office.net/_layouts/15/images/sitepagethumbnail.png", |
v1.0 | Basesitepage List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/basesitepage-list.md | Get the collection of [baseSitePage][] objects from the site pages [list][] in a | :-- | :- | | [sitePage][] | Represents a regular page. | -[basesitepage]: ../resources/baseSitePage.md -[sitepage]: ../resources/sitePage.md +[baseSitePage]: ../resources/baseSitePage.md +[sitePage]: ../resources/sitePage.md [list]: ../resources/list.md [site]: ../resources/site.md The following example shows a request. --> ```msgraph-interactive-GET /sites/{site-id}/pages +GET /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages ``` # [C#](#tab/csharp) Content-type: application/json "id": "5fa48f95-2fdf-40e8-a28c-6d0d8345bcd2", "lastModifiedDateTime": "2023-04-16T08:37:51Z", "name": "Account holistic.aspx",- "webUrl": "SitePages/Account holistic.aspx", + "webUrl": "https://contoso.sharepoint.com/SitePages/Account holistic.aspx", "title": "CSS Global Lithuanian meter", "pageLayout": "article", "thumbnailWebUrl": "https://media.akamai.odsp.cdn.office.net/a830edad9050849vanaukyisx52.spgrid.com/_layouts/15/images/sitepagethumbnail.png", Content-type: application/json "id": "da0f67be-977e-4d09-88ac-506a1002e678", "lastModifiedDateTime": "2023-04-16T06:39:30Z", "name": "Analyst Fresh.aspx",- "webUrl": "SitePages/Analyst Fresh.aspx", + "webUrl": "https://contoso.sharepoint.com/SitePages/Analyst Fresh.aspx", "title": "Lesotho Account Metal Analyst du", "pageLayout": "article", "thumbnailWebUrl": "https://media.akamai.odsp.cdn.office.net/a830edad9050849vanaukyisx52.spgrid.com/_layouts/15/images/sitepagethumbnail.png", |
v1.0 | Bitlocker List Recoverykeys | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bitlocker-list-recoverykeys.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "bitlocker_list_recoverykeys" } --> [!INCLUDE [permissions-table](../includes/permissions/bitlocker-list-recoverykeys-permissions.md)] -For delegated permissions to allow apps to get **bitLockerRecoveryKey** resources on behalf of the signed-in user, the user must be the registered owner of the device that the BitLocker recovery key was originally backed up from, or the calling user must be in one of the following directory roles: --* Global administrator -* Cloud device administrator -* Helpdesk administrator -* Intune service administrator -* Security administrator -* Security reader -* Global reader +For delegated permissions to allow apps to get **bitLockerRecoveryKey** resources on behalf of the signed-in user, the user must be the registered owner of the device that the BitLocker recovery key was originally backed up from, or the calling user must be in at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ++* Cloud Device Administrator +* Helpdesk Administrator +* Intune Service Administrator +* Security Administrator +* Security Reader +* Global Reader ## HTTP request To get a list of BitLocker keys within the tenant: |
v1.0 | Bitlockerrecoverykey Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bitlockerrecoverykey-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "bitlockerrecoverykey_get" } --> [!INCLUDE [permissions-table](../includes/permissions/bitlockerrecoverykey-get-permissions.md)] ->**Note:** For delegated permissions to allow apps to get **bitLockerRecoveryKey** resources on behalf of the signed-in user, the tenant administrator must have assigned the user one of the following roles, or the user must be the **registered owner** of the device that the BitLocker key was originally backed up from: -* Global administrator -* Cloud device administrator -* Helpdesk administrator -* Intune service administrator -* Security administrator -* Security reader -* Global reader +>**Note:** For delegated permissions to allow apps to get **bitLockerRecoveryKey** resources on behalf of the signed-in user, the tenant administrator must have assigned the user one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json), or the user must be the **registered owner** of the device that the BitLocker key was originally backed up from: ++* Cloud Device Administrator +* Helpdesk Administrator +* Intune Service Administrator +* Security Administrator +* Security Reader +* Global Reader ## HTTP request To get the specified BitLocker key without returning the **key** property: |
v1.0 | Bookingappointment Cancel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingappointment-cancel.md | Namespace: microsoft.graph Cancel the specified [bookingAppointment](../resources/bookingappointment.md) in the specified [bookingBusiness](../resources/bookingbusiness.md), and send a message to the involved customer and staff members. ## Permissions |
v1.0 | Bookingappointment Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingappointment-delete.md | Namespace: microsoft.graph Delete a [bookingAppointment](../resources/bookingappointment.md) in the specified [bookingBusiness](../resources/bookingbusiness.md). ## Permissions |
v1.0 | Bookingappointment Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingappointment-get.md | Get the properties and relationships of a [bookingAppointment](../resources/book The **start** and **end** properties are always returned in UTC. ## 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). |
v1.0 | Bookingappointment Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingappointment-update.md | Namespace: microsoft.graph Update the properties of a [bookingAppointment](../resources/bookingappointment.md) object in the specified [bookingBusiness](../resources/bookingbusiness.md). ## Permissions |
v1.0 | Bookingbusiness Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-delete.md | Namespace: microsoft.graph Delete a [bookingBusiness](../resources/bookingbusiness.md) object. ## 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). |
v1.0 | Bookingbusiness Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-get.md | Namespace: microsoft.graph Get the properties and relationships of a [bookingBusiness](../resources/bookingbusiness.md) object. ## Permissions |
v1.0 | Bookingbusiness Getstaffavailability | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-getstaffavailability.md | Namespace: microsoft.graph Get the availability information of [staff members](../resources/bookingstaffmember.md) of a [Microsoft Bookings calendar](../resources/bookingappointment.md). ## Permissions |
v1.0 | Bookingbusiness List Appointments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-list-appointments.md | Namespace: microsoft.graph Get a list of [bookingAppointment](../resources/bookingappointment.md) objects for the specified [bookingBusiness](../resources/bookingbusiness.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). |
v1.0 | Bookingbusiness List Calendarview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-list-calendarview.md | Namespace: microsoft.graph Get the collection of [bookingAppointment](../resources/bookingappointment.md) objects for a [bookingBusiness](../resources/bookingbusiness.md), that occurs in the specified date range. ## 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). |
v1.0 | Bookingbusiness List Customers | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-list-customers.md | Namespace: microsoft.graph Get a list of [bookingCustomer](../resources/bookingcustomer.md) objects. ## 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). |
v1.0 | Bookingbusiness List Customquestions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-list-customquestions.md | Namespace: microsoft.graph Get the [bookingCustomQuestion](../resources/bookingcustomquestion.md) resources associated with a [bookingBusiness](../resources/bookingbusiness.md). ## Permissions |
v1.0 | Bookingbusiness List Services | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-list-services.md | Namespace: microsoft.graph Get a list of [bookingService](../resources/bookingservice.md) objects in the specified [bookingBusiness](../resources/bookingbusiness.md). ## Permissions |
v1.0 | Bookingbusiness List Staffmembers | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-list-staffmembers.md | Namespace: microsoft.graph Get a list of [bookingStaffMember](../resources/bookingstaffmember.md) objects in the specified [bookingBusiness](../resources/bookingbusiness.md). ## Permissions |
v1.0 | Bookingbusiness List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-list.md | You can also query for Bookings businesses by specifying a string in a `query` p > **Note:** Results are limited to 500 mailboxes. Pagination of the results is not currently supported. ## Permissions |
v1.0 | Bookingbusiness Post Appointments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-post-appointments.md | Namespace: microsoft.graph Create a new [bookingAppointment](../resources/bookingappointment.md) for the specified [bookingBusiness](../resources/bookingbusiness.md). ## Permissions |
v1.0 | Bookingbusiness Post Bookingbusinesses | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-post-bookingbusinesses.md | Create a new Microsoft Bookings business in a tenant. This is the first step in setting up a Bookings business where you must specify the business display name. You can include other information such as business address, web site address, and scheduling policy, or set that information later by [updating](bookingbusiness-update.md) the **bookingBusiness**. ## 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). |
v1.0 | Bookingbusiness Post Customers | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-post-customers.md | Namespace: microsoft.graph Create a new [bookingCustomer](../resources/bookingcustomer.md) object. ## 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). |
v1.0 | Bookingbusiness Post Customquestions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-post-customquestions.md | Namespace: microsoft.graph Create a new [bookingCustomQuestion](../resources/bookingcustomquestion.md) object. ## Permissions |
v1.0 | Bookingbusiness Post Services | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-post-services.md | Namespace: microsoft.graph Create a new [bookingService](../resources/bookingservice.md) for the specified [bookingBusiness](../resources/bookingbusiness.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). |
v1.0 | Bookingbusiness Post Staffmembers | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-post-staffmembers.md | Namespace: microsoft.graph Create a new [staff member](../resources/bookingstaffmember.md) in the specified [bookingBusiness](../resources/bookingbusiness.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). |
v1.0 | Bookingbusiness Publish | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-publish.md | Make the scheduling page of this business available to external customers. Set the **isPublished** property to true, and **publicUrl** property to the URL of the scheduling page. ## 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). |
v1.0 | Bookingbusiness Unpublish | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-unpublish.md | Make the scheduling page of this business not available to external customers. Set the **isPublished** property to false, and **publicUrl** property to null. ## 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). |
v1.0 | Bookingbusiness Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-update.md | Namespace: microsoft.graph Update the properties of a [bookingBusiness](../resources/bookingbusiness.md) object. ## 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). |
v1.0 | Bookingcurrency Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingcurrency-get.md | Namespace: microsoft.graph Get the properties of a [bookingCurrency](../resources/bookingcurrency.md) object that is available to a Microsoft Bookings business. Use the **id** property, which is the currency code, to specify the currency. ## 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). |
v1.0 | Bookingcurrency List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingcurrency-list.md | Namespace: microsoft.graph Get a list of [bookingCurrency](../resources/bookingcurrency.md) objects available to a Microsoft Bookings business. ## 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). |
v1.0 | Bookingcustomer Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingcustomer-delete.md | Namespace: microsoft.graph Delete the specified [bookingCustomer](../resources/bookingcustomer.md) object. ## 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). |
v1.0 | Bookingcustomer Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingcustomer-get.md | Namespace: microsoft.graph Get the properties and relationships of a [bookingCustomer](../resources/bookingcustomer.md) object. ## 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). |
v1.0 | Bookingcustomer Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingcustomer-update.md | Namespace: microsoft.graph Update the properties of a [bookingCustomer](../resources/bookingcustomer.md) object. ## Permissions |
v1.0 | Bookingcustomquestion Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingcustomquestion-delete.md | Namespace: microsoft.graph Delete the specified [bookingCustomQuestion](../resources/bookingcustomquestion.md) object. ## Permissions |
v1.0 | Bookingcustomquestion Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingcustomquestion-get.md | Namespace: microsoft.graph Read the properties and relationships of a [bookingCustomQuestion](../resources/bookingcustomquestion.md) object. ## Permissions |
v1.0 | Bookingcustomquestion Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingcustomquestion-update.md | Namespace: microsoft.graph Update the properties of a [bookingCustomQuestion](../resources/bookingcustomquestion.md) object. ## Permissions |
v1.0 | Bookingservice Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingservice-delete.md | Namespace: microsoft.graph Delete a [bookingService](../resources/bookingservice.md) object in the specified [bookingBusiness](../resources/bookingbusiness.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). |
v1.0 | Bookingservice Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingservice-get.md | Namespace: microsoft.graph Get the properties and relationships of a [bookingService](../resources/bookingservice.md) object in the specified [bookingBusiness](../resources/bookingbusiness.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). |
v1.0 | Bookingservice Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingservice-update.md | The following are some examples you can customize for a service: - Any, time buffer to set up before or finish up after the service - [Scheduling policy](../resources/bookingschedulingpolicy.md) parameters such as minimum notice to book or cancel, and whether customers can select specific staff members for an appointment. ## 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). |
v1.0 | Bookingstaffmember Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingstaffmember-delete.md | Namespace: microsoft.graph Delete a [staff member](../resources/bookingstaffmember.md) in the specified [bookingbusiness](../resources/bookingbusiness.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). |
v1.0 | Bookingstaffmember Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingstaffmember-get.md | Namespace: microsoft.graph Get the properties and relationships of a [bookingStaffMember](../resources/bookingstaffmember.md) in the specified [bookingBusiness](../resources/bookingbusiness.md). ## Permissions |
v1.0 | Bookingstaffmember Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingstaffmember-update.md | Namespace: microsoft.graph Update the properties of a [bookingStaffMember](../resources/bookingstaffmember.md) in the specified [bookingBusiness](../resources/bookingbusiness.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). |
v1.0 | Calendar Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calendar-delete.md | The following example shows a request. DELETE https://graph.microsoft.com/beta/me/calendar ``` -# [C#](#tab/csharp) --# [CLI](#tab/cli) --# [Go](#tab/go) --# [Java](#tab/java) - # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/delete-calendar-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -# [PHP](#tab/php) --# [Python](#tab/python) - ##### Response |
v1.0 | Callrecording Delta | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/callrecording-delta.md | A GET request with the delta function returns either: - A `@odata.nextLink` (that contains a URL with a **delta** function call and a `skipToken`), or - A `@odata.deltaLink` (that contains a URL with a **delta** function call and `deltaToken`). -State tokens are completely opaque to the client. To proceed with a round of change tracking, simply copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL returned from the last GET request to the next **delta** function call for that same recording view. A `@odata.deltaLink` returned in a response signifies that the current round of change tracking is complete. You can save and use the `@odata.deltaLink` URL when you start the next round of synchronization to get the new recordings added after acquiring `@odata.deltaLink`. +State tokens are opaque to the client. To proceed with a round of change tracking, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL returned from the last GET request to the next **delta** function call for that same recording view. A `@odata.deltaLink` returned in a response signifies that the current round of change tracking is complete. You can save and use the `@odata.deltaLink` URL when you start the next round of synchronization to get the new recordings added after acquiring `@odata.deltaLink`. For more information, see the [delta query](/graph/delta-query-overview) documentation. +### Known issues ++The following known issues are associated with this API: ++- [Using the `$top` query parameter might not return the @odata.nextLink](https://developer.microsoft.com/en-us/graph/known-issues/?search=22931). +- [Transcript URLs might not include any content](https://developer.microsoft.com/en-us/graph/known-issues/?search=22932). +- [Recordings aren't exported for meetings that don't have transcription turned on](https://developer.microsoft.com/en-us/graph/known-issues/?search=22933). +- [Delta queries might return older artifacts when meetings have unrelated changes](https://developer.microsoft.com/en-us/graph/known-issues/?search=22934). + ## 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). Choose the permission or permissions marked as least privileged for this API. Us ## HTTP request <!-- { "blockType": "ignored" } -->-```http -GET /users/{id}/onlineMeetings/getAllRecordings/delta?$filter=meetingOrganizerId%20eq%20'{id}' +``` http +GET /users/{usersId}/onlineMeetings/getAllRecordings(meetingOrganizerUserId='{userId}',startDateTime={startDateTime})/delta ```->**Note:** If you don't specify a **meetingOrganizerId**, the request fails. +>**Note:** If you don't pass the function parameter **meetingOrganizerUserId**, the request fails. ## Query parameters In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLin |:|:--|:-| | `$deltatoken` | string | A [state token](/graph/delta-query-overview) returned in the `@odata.deltaLink` URL of the previous **delta** function call, indicating the completion of that round of change tracking. Save and apply the entire `@odata.deltaLink` URL including this token in the first request of the next round of change tracking for that collection.| | `$skiptoken` | string | A [state token](/graph/delta-query-overview) returned in the `@odata.nextLink` URL of the previous **delta** function call, indicating that there are further changes to be tracked. |+| `$top` | integer | Allows the caller to specify the maximum number of objects per page. | ## Request headers+ | Header | Value | ||| |Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| The following example shows a series of three requests to synchronize the call r - Step 2: [second request](#second-request) and [response](#second-response) - Step 3: [third request](#third-request) and [final response](#third-and-final-response-for-the-round). -See also what you'll do in the [next round to get additional recordings](#example-2-next-round-to-get-additional-recordings). +See also what you'll do in the [next round to get more recordings](#example-2-next-round-to-get-more-recordings). #### Initial request In this example, the call recordings are being synchronized for the first time, <!-- { "blockType": "ignored" } --> ```http-GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllRecordings/delta?$filter=meetingOrganizerId%20eq%20'8b081ef6-4792-4def-b2c9-c363a1bf41d5' +GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta ``` #### Initial response HTTP/1.1 200 OK Content-type: application/json {- "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callRecording)", - "@odata.count": 2, - "@odata.nextLink": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeeting/getAllRecordings?$skiptoken=GGXvkS7mbjFAe9Uidm2D70e58K-BOnoJadAqkZEJmoLprr5eSP1hQPlb3dJ1AVz3xCYKxov6hSEJhsasyg", - "value":[ - { - "@odata.type": "#microsoft.graph.callRecording", - "meetingId": "MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19OMUUxWTFJME56QXRabVF5T0MxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy", - "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5", - "recordingContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19OMUUxWTFJME56QXRabVF5T0MxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/recordings/MSMjMCMjZDExYWQ2OGEtMWVhYS00MGFjLWJkZWItMTExNjMyNjExYzRl/content", - "createdDateTime": "2023-08-03T22:29:42.6514074Z", - "id": "MSMjMCMjZDExYWQ2OGEtMWVhYS00MGFjLWJkZWItMTExNjMyNjExYzRl" - }, - { + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callRecording)", + "@odata.nextLink": "https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={skipToken1}", + "@odata.count": 1, + "value": [ + { "@odata.type": "#microsoft.graph.callRecording",- "meetingId": "MSo4YjA5MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19OMUUxWTFJME56QXRabVF5T0MxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy", + "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=", + "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy", "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",- "recordingContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA5MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19OMUUxWTFJME56QXRabVF5T0MxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/recordings/MSMjMCMjZDExYWQ3OGEtMWVhYS00MGFjLWJkZWItMTExNjMyNjExYzRl/content", - "createdDateTime": "2023-08-05T11:24:30.6414074Z", - "id": "MSMjMCMjZDExYWQ3OGEtMWVhYS00MGFjLWJkZWItMTExNjMyNjExYzRl" - } - ] + "createdDateTime": "2023-12-02T06:59:34.7411768Z", + "recordingContentUrl": "https://graph.microsoft.com/betAtOWJiMy1jMTUzYzE4ODY4NGY=/content", + "meetingOrganizer": { + "application": null, + "device": null, + "user": { + "@odata.type": "#microsoft.graph.teamworkUserIdentity", + "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5", + "displayName": null, + "userIdentityType": "aadUser", + "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853" + } + } + } + ] } ``` Content-type: application/json The second request specifies the `@odata.nextLink` URL returned from the previous response. Notice that it no longer has to specify the same query parameters as in the initial request, as the `skipToken` in the `@odata.nextLink` URL encodes and includes them. - <!-- { "blockType": "ignored" } --> ```http-GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeeting/getAllRecordings?$skiptoken=GGXvkS7mbjFAe9Uidm2D70e58K-BOnoJadAqkZEJmoLprr5eSP1hQPlb3dJ1AVz3xCYKxov6hSEJhsasyg +GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta +$skiptoken={skipToken1} ``` #### Second response -The second response returns the next two call recordings and a `@odata.nextLink` property with a `skipToken`, which indicates there are more recordings. +The second response returns one or more next call recordings and a `@odata.nextLink` property with a `skipToken`, which indicates there are more recordings. <!-- { "blockType": "response", HTTP/1.1 200 OK Content-type: application/json {- "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callRecording)", - "@odata.count": 2, - "@odata.nextLink": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeeting/getAllRecordings?$skiptoken=GGXve9Uidm2D70kS7mbjFAe58K-BOnPlb3dJ1AVz3xCYmoLprr5eSP1hQKxov6hSEJhsasyg", - "value":[ - { - "@odata.type": "#microsoft.graph.callRecording", - "meetingId": "MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy", - "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5", - "recordingContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/recordings/MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl/content", - "createdDateTime": "2023-08-11T21:29:42.6514074Z", - "id": "MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl" - }, - { + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callRecording)", + "@odata.nextLink": "https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={skipToken2}", + "@odata.count": 1, + "value": [ + { "@odata.type": "#microsoft.graph.callRecording",- "meetingId": "MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19BQkMxRDFEMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy", + "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=", + "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy", "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",- "recordingContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19BQkMxRDFEMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/recordings/MSMjMCMjZDIyYWQyMmEtMmVhYS0yMmFjLWJkZWItMjIyNjMyNjExYzRl/content", - "createdDateTime": "2023-08-12T11:24:30.6414074Z", - "id": "MSMjMCMjZDIyYWQyMmEtMmVhYS0yMmFjLWJkZWItMjIyNjMyNjExYzRl" - } - ] + "createdDateTime": "2023-12-02T06:59:34.7411768Z", + "recordingContentUrl": "https://graph.microsoft.com/betAtOWJiMy1jMTUzYzE4ODY4NGY=/content", + "meetingOrganizer": { + "application": null, + "device": null, + "user": { + "@odata.type": "#microsoft.graph.teamworkUserIdentity", + "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5", + "displayName": null, + "userIdentityType": "aadUser", + "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853" + } + } + } + ] } ``` The third request continues to use the latest `@odata.nextLink` returned from th <!-- { "blockType": "ignored" } --> ```http-GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeeting/getAllRecordings?$skiptoken=GGXve9Uidm2D70kS7mbjFAe58K-BOnPlb3dJ1AVz3xCYmoLprr5eSP1hQKxov6hSEJhsasyg +GET https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={skipToken2} ``` #### Third and final response for the round -The third response returns the only remaining recordings and a `@odata.deltaLink` property with a `deltaToken` which indicates that all recordings have been returned. Save and use the `@odata.deltaLink` URL to query for any new recording that is added from this point onwards. +The third response returns the only remaining recordings and a `@odata.deltaLink` property with a `deltaToken`, which indicates that all recordings are returned. Save and use the `@odata.deltaLink` URL to query for any new recording that is added from this point onwards. <!-- { "blockType": "response", HTTP/1.1 200 OK Content-type: application/json {- "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callRecording)", - "@odata.count": 1, - "@odata.deltaLink": "https://graph.microsoft.com/betik_JIC44iCZpv-GLiA2VnFuE5yG-kCEBROb2iaPT_y_eMWVQtBO_ejzzyIxl00ji-tQ3HzAbW4liZAVG88lO3nG_6-MBFoHY1n8y21YUzjocG-Cn1tCNeeLPLTzIe5Dw.EP9gLiCoF2CE_e6l_m1bTk2aokD9KcgfgfcLGqd1r_4", - "value":[ - { + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callRecording)", + "@odata.deltaLink": "https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken1}", + "@odata.count": 1, + "value": [ + { "@odata.type": "#microsoft.graph.callRecording",- "meetingId": "MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy", + "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=", + "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy", "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",- "recordingContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/recordings/MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl/content", - "createdDateTime": "2023-08-11T21:29:42.6514074Z", - "id": "MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl" - } - ] + "createdDateTime": "2023-12-02T06:59:34.7411768Z", + "recordingContentUrl": "https://graph.microsoft.com/betAtOWJiMy1jMTUzYzE4ODY4NGY=/content", + "meetingOrganizer": { + "application": null, + "device": null, + "user": { + "@odata.type": "#microsoft.graph.teamworkUserIdentity", + "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5", + "displayName": null, + "userIdentityType": "aadUser", + "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853" + } + } + } + ] } ``` -### Example 2: Next round to get additional recordings +### Example 2: Next round to get more recordings Using the `@odata.deltaLink` from the last request in the last round, you can get only those recordings added since the `@odata.deltaLink` was acquired. The following example shows a request. <!-- { "blockType": "ignored" } --> ```http-GET https://graph.microsoft.com/betik_JIC44iCZpv-GLiA2VnFuE5yG-kCEBROb2iaPT_y_eMWVQtBO_ejzzyIxl00ji-tQ3HzAbW4liZAVG88lO3nG_6-MBFoHY1n8y21YUzjocG-Cn1tCNeeLPLTzIe5Dw.EP9gLiCoF2CE_e6l_m1bTk2aokD9KcgfgfcLGqd1r_4 +GET https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken1} ``` - #### Response The following example shows the response. Content-type: application/json { "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callRecording)",- "@odata.deltaLink": "https://graph.microsoft.com/betik_JIC44iCZpv-GLiA2VnFuE5yG-kCEBROb2iaPT_yjz2nsMoh1gXNtXii7s78HapCi5woifXqwXlVNxICh8wUUnvE2gExsa8eZ2Vy_ch5rVIhm067_1mUPML3iYUVyg.3o0rhgaBUduuxOr98An5pjBDP5JjKUiVWku3flSiOsk", + "@odata.deltaLink": "https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken2}", + "@odata.count": 1, "value": [- { + { "@odata.type": "#microsoft.graph.callRecording",- "meetingId": "MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy", + "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=", + "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy", "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",- "recordingContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/recordings/MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl/content", - "createdDateTime": "2023-08-11T21:29:42.6514074Z", - "id": "MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl" - } + "createdDateTime": "2023-12-02T06:59:34.7411768Z", + "recordingContentUrl": "https://graph.microsoft.com/betAtOWJiMy1jMTUzYzE4ODY4NGY=/content", + "meetingOrganizer": { + "application": null, + "device": null, + "user": { + "@odata.type": "#microsoft.graph.teamworkUserIdentity", + "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5", + "displayName": null, + "userIdentityType": "aadUser", + "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853" + } + } + } ] } ``` |
v1.0 | Calltranscript Delta | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calltranscript-delta.md | Title: "callTranscript: delta" -description: "Get a set of callTranscript resources that have been added for onlineMeeting instances organized by the specified user." +description: "Get a set of callTranscript resources added for onlineMeeting instances organized by the specified user." ms.localizationpriority: medium doc_type: apiPageType Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Get a set of [callTranscript](../resources/calltranscript.md) resources that have been added for [onlineMeeting](../resources/onlinemeeting.md) instances organized by the specified user. +Get a set of [callTranscript](../resources/calltranscript.md) resources added for [onlineMeeting](../resources/onlinemeeting.md) instances organized by the specified user. -Delta query supports both full synchronization that gets all the transcripts for online meetings organized by a given user, and incremental synchronization that gets transcripts that have been added since the last synchronization. Typically, you would do an initial full synchronization, and then get incremental changes to that transcript view periodically. +Delta query supports both full synchronization that gets all the transcripts for online meetings organized by the user, and incremental synchronization that gets transcripts added since the last synchronization. Typically, you would do an initial full synchronization, and then get incremental changes to that transcript view periodically. A GET request with the delta function returns either: - A `@odata.nextLink` (that contains a URL with a **delta** function call and a `skipToken`), or - A `@odata.deltaLink` (that contains a URL with a **delta** function call and `deltaToken`). -State tokens are completely opaque to the client. To proceed with a round of change tracking, simply copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL returned from the last GET request to the next **delta** function call for that same transcript view. A `@odata.deltaLink` returned in a response signifies that the current round of change tracking is complete. You can save and use the `@odata.deltaLink` URL when you start the next round of synchronization to get the new transcripts that have been added after acquiring `@odata.deltaLink`.. +State tokens are opaque to the client. To proceed with a round of change tracking, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL returned from the last GET request to the next **delta** function call for that same transcript view. A `@odata.deltaLink` returned in a response signifies that the current round of change tracking is complete. You can save and use the `@odata.deltaLink` URL when you start the next round of synchronization to get the new transcripts added after acquiring `@odata.deltaLink`. For more information, see the [delta query](/graph/delta-query-overview) documentation. +### Known issues ++The following known issues are associated with this API: ++- [Using the `$top` query parameter might not return the @odata.nextLink](https://developer.microsoft.com/en-us/graph/known-issues/?search=22931). +- [Delta queries might return older artifacts when meetings have unrelated changes](https://developer.microsoft.com/en-us/graph/known-issues/?search=22934). + ## 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). Choose the permission or permissions marked as least privileged for this API. Us ## HTTP request <!-- { "blockType": "ignored" } -->-```http -GET /users/{id}/onlineMeetings/getAllTranscripts/delta?$filter=meetingOrganizerId%20eq%20'{id}' +``` http +GET /users/{usersId}/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='{userId}',startDateTime={startDateTime})/delta ```->**Note:** If you don't specify a **meetingOrganizerId**, the request fails. +>**Note:** If you don't pass the function parameter **meetingOrganizerUserId**, the request fails. ## Query parameters In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLin |:|:--|:-| | `$deltatoken` | string | A [state token](/graph/delta-query-overview) returned in the `@odata.deltaLink` URL of the previous **delta** function call, indicating the completion of that round of change tracking. Save and apply the entire `@odata.deltaLink` URL including this token in the first request of the next round of change tracking for that collection.| | `$skiptoken` | string | A [state token](/graph/delta-query-overview) returned in the `@odata.nextLink` URL of the previous **delta** function call, indicating that there are further changes to be tracked. |+| `$top` | integer | Allows the caller to specify the maximum number of objects per page. | + ## Request headers | Header | Value | The following example shows a series of three requests to synchronize the call t - Step 2: [second request](#second-request) and [response](#second-response) - Step 3: [third request](#third-request) and [final response](#third-and-final-response-for-the-round). -See also what you'll do in the [next round to get additional transcripts](#example-2-next-round-to-get-additional-transcripts). +See also what you'll do in the [next round to get more transcripts](#example-2-next-round-to-get-more-transcripts). #### Initial request In this example, the call transcripts are being synchronized for the first time, <!-- { "blockType": "ignored" } --> ```http-GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllTranscripts/delta?$filter=meetingOrganizerId%20eq%20'8b081ef6-4792-4def-b2c9-c363a1bf41d5' +GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta ``` #### Initial response The response includes two call transcripts and a `@odata.nextLink` response head <!-- { "blockType": "response", "truncated": true,- "@odata.type": "Collection(microsoft.graph.callTranscript)" + "@odata.type": "microsoft.graph.callTranscript", + "isCollection": true } --> ```http HTTP/1.1 200 OK Content-type: application/json {- "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callTranscript)", - "@odata.count": 2, - "@odata.nextLink": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllTranscripts?$skiptoken=GGXvkS7mbjFAe9Uidm2D70e58K-BOnoJadAqkZEJmoLprr5eSP1hQPlb3dJ1AVz3xCYKxov6hSEJhsasyg", - "value":[ - { - "@odata.type": "#microsoft.graph.callTranscript", - "meetingId": "MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19OMUUxWTFJME56QXRabVF5T0MxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy", - "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5", - "transcriptContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19OMUUxWTFJME56QXRabVF5T0MxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/transcripts/MSMjMCMjZDExYWQ2OGEtMWVhYS00MGFjLWJkZWItMTExNjMyNjExYzRl/content", - "createdDateTime": "2023-08-03T22:29:42.6514074Z", - "id": "MSMjMCMjZDExYWQ2OGEtMWVhYS00MGFjLWJkZWItMTExNjMyNjExYzRl" - }, - { + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callTranscript)", + "@odata.nextLink": "https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={skipToken1}", + "@odata.count": 1, + "value": [ + { "@odata.type": "#microsoft.graph.callTranscript",- "meetingId": "MSo4YjA5MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19OMUUxWTFJME56QXRabVF5T0MxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy", + "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=", + "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy", "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",- "transcriptContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA5MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19OMUUxWTFJME56QXRabVF5T0MxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/transcripts/MSMjMCMjZDExYWQ3OGEtMWVhYS00MGFjLWJkZWItMTExNjMyNjExYzRl/content", - "createdDateTime": "2023-08-05T11:24:30.6414074Z", - "id": "MSMjMCMjZDExYWQ3OGEtMWVhYS00MGFjLWJkZWItMTExNjMyNjExYzRl" - } - ] + "createdDateTime": "2023-12-02T06:59:34.7411768Z", + "transcriptContentUrl": "https://graph.microsoft.com/betAtOWJiMy1jMTUzYzE4ODY4NGY=/content", + "meetingOrganizer": { + "application": null, + "device": null, + "user": { + "@odata.type": "#microsoft.graph.teamworkUserIdentity", + "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5", + "displayName": null, + "userIdentityType": "aadUser", + "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853" + } + } + } + ] } ``` Content-type: application/json The second request specifies the `@odata.nextLink` URL returned from the previous response. Notice that it no longer has to specify the same query parameters as in the initial request, as the `skipToken` in the `@odata.nextLink` URL encodes and includes them. - <!-- { "blockType": "ignored" } --> ```http-GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllTranscripts?$skiptoken=GGXvkS7mbjFAe9Uidm2D70e58K-BOnoJadAqkZEJmoLprr5eSP1hQPlb3dJ1AVz3xCYKxov6hSEJhsasyg +GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta +$skiptoken={skipToken1} ``` #### Second response -The second response returns the next 2 call transcripts and a `@odata.nextLink` property with a `skipToken` which indicates there are more transcripts. +The second response returns one or more next call transcripts and a `@odata.nextLink` property with a `skipToken`, which indicates there are more transcripts. <!-- { "blockType": "response", "truncated": true,- "@odata.type": "Collection(microsoft.graph.callTranscript)" + "@odata.type": "microsoft.graph.callTranscript", + "isCollection": true } --> ```http HTTP/1.1 200 OK Content-type: application/json {- "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callTranscript)", - "@odata.count": 2, - "@odata.nextLink": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllTranscripts?$skiptoken=GGXve9Uidm2D70kS7mbjFAe58K-BOnPlb3dJ1AVz3xCYmoLprr5eSP1hQKxov6hSEJhsasyg", - "value":[ - { - "@odata.type": "#microsoft.graph.callTranscript", - "meetingId": "MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy", - "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5", - "transcriptContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/transcripts/MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl/content", - "createdDateTime": "2023-08-11T21:29:42.6514074Z", - "id": "MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl" - }, - { + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callTranscript)", + "@odata.nextLink": "https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={skipToken2}", + "@odata.count": 1, + "value": [ + { "@odata.type": "#microsoft.graph.callTranscript",- "meetingId": "MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19BQkMxRDFEMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy", + "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=", + "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy", "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",- "transcriptContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19BQkMxRDFEMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/transcripts/MSMjMCMjZDIyYWQyMmEtMmVhYS0yMmFjLWJkZWItMjIyNjMyNjExYzRl/content", - "createdDateTime": "2023-08-12T11:24:30.6414074Z", - "id": "MSMjMCMjZDIyYWQyMmEtMmVhYS0yMmFjLWJkZWItMjIyNjMyNjExYzRl" - } - ] + "createdDateTime": "2023-12-02T06:59:34.7411768Z", + "transcriptContentUrl": "https://graph.microsoft.com/betAtOWJiMy1jMTUzYzE4ODY4NGY=/content", + "meetingOrganizer": { + "application": null, + "device": null, + "user": { + "@odata.type": "#microsoft.graph.teamworkUserIdentity", + "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5", + "displayName": null, + "userIdentityType": "aadUser", + "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853" + } + } + } + ] } ``` The third request continues to use the latest `@odata.nextLink` returned from th <!-- { "blockType": "ignored" } --> ```http-GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllTranscripts?$skiptoken=GGXve9Uidm2D70kS7mbjFAe58K-BOnPlb3dJ1AVz3xCYmoLprr5eSP1hQKxov6hSEJhsasyg +GET https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={skipToken2} ``` #### Third and final response for the round -The third response returns the only remaining transcripts and a `@odata.deltaLink` property with a `deltaToken` which indicates that all transcripts have been returned. Save and use the `@odata.deltaLink` URL to query for any new transcript that is added from this point onwards. +The third response returns the only remaining transcripts and a `@odata.deltaLink` property with a `deltaToken`, which indicates that all transcripts are returned. Save and use the `@odata.deltaLink` URL to query for any new transcript that is added from this point onwards. <!-- { "blockType": "response", "truncated": true,- "@odata.type": "Collection(microsoft.graph.callTranscript)" + "@odata.type": "microsoft.graph.callTranscript", + "isCollection": true } --> ```http HTTP/1.1 200 OK Content-type: application/json {- "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callTranscript)", - "@odata.count": 1, - "@odata.deltaLink": "https://graph.microsoft.com/betik_JIC44iCZpv-GLiA2VnFuE5yG-kCEBROb2iaPT_y_eMWVQtBO_ejzzyIxl00ji-tQ3HzAbW4liZAVG88lO3nG_6-MBFoHY1n8y21YUzjocG-Cn1tCNeeLPLTzIe5Dw.EP9gLiCoF2CE_e6l_m1bTk2aokD9KcgfgfcLGqd1r_4", - "value":[ - { + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callTranscript)", + "@odata.deltaLink": "https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken1}", + "@odata.count": 1, + "value": [ + { "@odata.type": "#microsoft.graph.callTranscript",- "meetingId": "MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy", + "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=", + "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy", "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",- "transcriptContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/transcripts/MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl/content", - "createdDateTime": "2023-08-11T21:29:42.6514074Z", - "id": "MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl" - } - ] + "createdDateTime": "2023-12-02T06:59:34.7411768Z", + "transcriptContentUrl": "https://graph.microsoft.com/betAtOWJiMy1jMTUzYzE4ODY4NGY=/content", + "meetingOrganizer": { + "application": null, + "device": null, + "user": { + "@odata.type": "#microsoft.graph.teamworkUserIdentity", + "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5", + "displayName": null, + "userIdentityType": "aadUser", + "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853" + } + } + } + ] } ``` -### Example 2: Next round to get additional transcripts +### Example 2: Next round to get more transcripts -Using the `@odata.deltaLink` from the last request in the last round, you can get only those transcripts that have been added since the `@odata.deltaLink` was acquired. +Using the `@odata.deltaLink` from the last request in the last round, you can get only those transcripts added since the `@odata.deltaLink` was acquired. #### Request+The following example shows a request. <!-- { "blockType": "ignored" } --> ```http-GET https://graph.microsoft.com/betik_JIC44iCZpv-GLiA2VnFuE5yG-kCEBROb2iaPT_y_eMWVQtBO_ejzzyIxl00ji-tQ3HzAbW4liZAVG88lO3nG_6-MBFoHY1n8y21YUzjocG-Cn1tCNeeLPLTzIe5Dw.EP9gLiCoF2CE_e6l_m1bTk2aokD9KcgfgfcLGqd1r_4 +GET https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken1} ```- #### 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.callTranscript)" + "@odata.type": "microsoft.graph.callTranscript", + "isCollection": true } --> ```http HTTP/1.1 200 OK Content-type: application/json { "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callTranscript)",- "@odata.deltaLink": "https://graph.microsoft.com/betik_JIC44iCZpv-GLiA2VnFuE5yG-kCEBROb2iaPT_yjz2nsMoh1gXNtXii7s78HapCi5woifXqwXlVNxICh8wUUnvE2gExsa8eZ2Vy_ch5rVIhm067_1mUPML3iYUVyg.3o0rhgaBUduuxOr98An5pjBDP5JjKUiVWku3flSiOsk", + "@odata.deltaLink": "https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken2}", + "@odata.count": 1, "value": [ { "@odata.type": "#microsoft.graph.callTranscript",- "meetingId": "MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy", + "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=", + "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy", "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",- "transcriptContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/transcripts/MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl/content", - "createdDateTime": "2023-08-11T21:29:42.6514074Z", - "id": "MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl" + "createdDateTime": "2023-12-02T06:59:34.7411768Z", + "transcriptContentUrl": "https://graph.microsoft.com/betAtOWJiMy1jMTUzYzE4ODY4NGY=/content", + "meetingOrganizer": { + "application": null, + "device": null, + "user": { + "@odata.type": "#microsoft.graph.teamworkUserIdentity", + "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5", + "displayName": null, + "userIdentityType": "aadUser", + "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853" + } + } } ] } |
v1.0 | Certificatebasedauthconfiguration Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/certificatebasedauthconfiguration-delete.md | Title: "Delete certificateBasedAuthConfiguration" description: "Delete certificateBasedAuthConfiguration." ms.localizationpriority: medium-+ doc_type: "apiPageType" |
v1.0 | Certificatebasedauthconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/certificatebasedauthconfiguration-get.md | Title: "Get certificateBasedAuthConfiguration" description: "Get the properties of a certificatebasedauthconfiguration object." ms.localizationpriority: medium-+ doc_type: "apiPageType" |
v1.0 | Certificatebasedauthconfiguration List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/certificatebasedauthconfiguration-list.md | Title: "List certificateBasedAuthConfigurations" description: "Get a list of certificatebasedauthconfiguration objects." ms.localizationpriority: medium-+ doc_type: "apiPageType" |
v1.0 | Certificatebasedauthconfiguration Post Certificatebasedauthconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/certificatebasedauthconfiguration-post-certificatebasedauthconfiguration.md | Title: "Create certificateBasedAuthConfiguration" description: "Use this API to create a new certificateBasedAuthConfiguration." ms.localizationpriority: medium-+ doc_type: "apiPageType" |
v1.0 | Channel Archive | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-archive.md | + + Title: "channel: archive" +description: "Archive a channel in a team. " ++ms.localizationpriority: medium ++++# channel: archive ++Namespace: microsoft.graph +++Archive a [channel](../resources/channel.md) in a team. When a channel is archived, users can't send new messages or react to existing messages in the channel, edit the channel settings, or make other changes to the channel. ++You can delete an archived channel, or add and remove members from it. If you archive a team, its channels are archived for you. ++Archiving is asynchronous; a channel is archived after the asynchronous archiving operation completes successfully, which might occur after the response returns. ++A channel without an owner, or that belongs to a [group](../resources/group.md) that has no owner, can't be archived. ++To restore a channel from its archived state, use the [unarchive](channel-unarchive.md) method. A channel canΓÇÖt be archived or unarchived if its team is archived. +++## 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": "channel_archive" } --> ++> **Note**: This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of. ++## HTTP request +<!-- { "blockType": "ignored" } --> +```http +POST /teams/{team-id}/channels/{channel-id}/archive +POST /groups/{team-id}/team/channels/{channel-id}/archive +``` ++## Request headers ++| Header | Value | +|:|:--| +| Authorization | Bearer {token}. Required. | ++## Request body ++In the request, you can optionally include the `shouldSetSpoSiteReadOnlyForMembers` parameter in a JSON body, as follows. +```JSON +{ + "shouldSetSpoSiteReadOnlyForMembers": true +} +``` +This optional parameter defines whether to set permissions for channel members to read-only on the SharePoint Online site associated with the team. Setting it to false or omitting the body altogether results in this step being skipped. ++## Response ++If archiving is started successfully, this method returns a `202 Accepted` response code. The response contains a `Location` header, which contains the location of the [teamsAsyncOperation](../resources/teamsasyncoperation.md) that was created to handle archiving of the channel in a team. Check the status of the archiving operation by making a GET request to this location. ++## Examples ++### Example 1: Archive a channel ++The following example shows a request to archive a channel. ++#### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "archive_channel" +}--> +```http +POST https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}/archive +``` ++# [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. +<!-- { + "blockType": "response", + "name": "archive_channel" +}--> +```http +HTTP/1.1 202 Accepted +Location: /teams/{team-id}/operations/{operation-id} +Content-Type: text/plain +Content-Length: 0 +``` ++### Example 2: Archive a channel when the team is archived ++The following example shows a request when the **team is archived**. ++#### Request ++<!-- { "blockType": "ignored" } --> +```http +POST https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}/archive +``` ++#### Response +The following example shows the `400` error response. ++<!-- { "blockType": "ignored" } --> ++```http +http/1.1 400 Bad Request +Content-Type: application/json +Content-Length: 193 ++{ + "error": { + "code": "BadRequest", + "message": "Team has to be active, for channel to be archived or unarchived: {channel-id}", + "innerError": { + "message": "Team has to be active, for channel to be archived or unarchived: {channel-id}", + "code": "Unknown", + "innerError": {}, + "date": "2023-12-11T04:26:35", + "request-id": "8f897345980-f6f3-49dd-83a8-a3064eeecdf8", + "client-request-id": "50a0er33-4567-3f6c-01bf-04d144fc8bbe" + } + } +} ++``` ++<!-- uuid: e848414b-4669-4484-ac36-1504c58a3fb8 +2015-10-25 14:57:30 UTC --> +<!-- +{ + "type": "#page.annotation", + "description": "Archive Channel", + "keywords": "", + "section": "documentation", + "tocPath": "", + "suppressions": [] +} +--> |
v1.0 | Channel Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-get.md | Choose the permission or permissions marked as least privileged for this API. Us This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + <!-- { "blockType": "permissions", "name": "channel_get" } --> [!INCLUDE [permissions-table](../includes/permissions/channel-get-permissions.md)] HTTP/1.1 200 OK "email": "", "webUrl": "https://teams.microsoft.com/l/channel/19%3Ad468258bc90f4a358361b5d73b89d39b%40thread.skype/General?groupId=8bb12236-b929-42e0-94a0-1c417466ebf8&tenantId=139d16b4-7223-43ad-b9a8-674ba63c7924", "membershipType": "standard",+ "isArchived": false, "moderationSettings": { "userNewMessageRestriction": "everyone", "replyRestriction": "everyone", Content-type: application/json "email": "", "webUrl": "https://teams.microsoft.com/l/channel/19%3Ad468258bc90f4a358361b5d73b89d39b%40thread.skype/General?groupId=8bb12236-b929-42e0-94a0-1c417466ebf8&tenantId=139d16b4-7223-43ad-b9a8-674ba63c7924", "membershipType": "standard",+ "isArchived": false, "moderationSettings": { "userNewMessageRestriction": "moderators", "replyRestriction": "everyone", Content-type: application/json "email": "", "webUrl": "https://teams.microsoft.com/l/channel/19%3Ad468258bc90f4a358361b5d73b89d39b%40thread.skype/General?groupId=8bb12236-b929-42e0-94a0-1c417466ebf8&tenantId=139d16b4-7223-43ad-b9a8-674ba63c7924", "membershipType": "private",+ "isArchived": false, "moderationSettings": null } ``` |
v1.0 | Channel List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-list.md | Content-type: application/json "description": "AutoTestTeam_20210311_150740.2550_fim3udfdjen9", "membershipType": "standard", "email": "someperson@microsoft.com",- "moderationSettings": null + "moderationSettings": null, + "isArchived": false } ] } Content-type: application/json "createdDateTime": "2020-05-27T19:22:25.692Z", "displayName": "General", "description": "test private team",- "membershipType": "private" + "membershipType": "private", + "isArchived": false, } ] } Content-length: 262 "webUrl": "https://teams.microsoft.com/l/channel/19%3ALpxShHZZh9utjNcEmUS5aOEP9ASw85OUn05NcWYAhX81%40thread.tacv2/shared%20channel-01?groupId=6a720ba5-7373-463b-bc9f-4cd04b5c6742&tenantId=df81db53-c7e2-418a-8803-0e68d4b88607", "membershipType": "shared", "email": "someperson@microsoft.com",+ "isArchived": false, "moderationSettings": null } ] |
v1.0 | Channel Patch Tabs | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-patch-tabs.md | Update the properties of the specified [tab](../resources/teamstab.md). This API can be used to configure the content of the tab. +> [!NOTE] +> You can't use this API to update a static tab. An attempt to update a static tab returns a `400 Bad Request` response code. + [!INCLUDE [national-cloud-support](../../includes/global-us.md)] ## Permissions |
v1.0 | Channel Post Members | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-post-members.md | Include the following properties in the request body. If successful, this method returns a `201 Created` response code and a [conversationMember](../resources/conversationmember.md) object in the response body. +> [!NOTE] +> The response code `404 Not Found` is returned when you attempt to add a disabled/blocked user. + ## Examples ### Example 1: Add a member to a private channel |
v1.0 | Channel Post Messages | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-post-messages.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "channel_post_messages" } --> [!INCLUDE [permissions-table](../includes/permissions/channel-post-messages-permissions.md)] -> **Note**: The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. --> **Note**: Application permissions are *only* supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). -In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. +> [!NOTE] +> - The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> - Application permissions are only supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. <!-- markdownlint-disable MD024 --> <!-- markdownlint-disable MD001 --> |
v1.0 | Channel Post Tabs | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-post-tabs.md | Namespace: microsoft.graph Add (pin) a [tab](../resources/teamstab.md) to the specified [channel](../resources/channel.md) within a [team](../resources/team.md). The app must be [preinstalled in the team](../api/team-list-installedapps.md) and have the [configurableTabs](/microsoftteams/platform/resources/schema/manifest-schema#configurabletabs) property defined in the app manifest. +> **Note**: If the app manifest for a given **appId** contains a static tab that matches the current scope (**team**), the static tab is pinned by default. + [!INCLUDE [national-cloud-support](../../includes/global-us.md)] ## Permissions POST /teams/{id}/channels/{id}/tabs ## Request body -A [teamsTab](../resources/teamstab.md). +In the request body, supply a JSON representation of a [teamsTab](../resources/teamstab.md). ++> [!NOTE] +> When you pin a static tab, Teams takes the **displayName** and **configuration** from the app manifest. If these properties are specified in the request body, this API returns a `400 Bad Request` response code. ## Response |
v1.0 | Channel Unarchive | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-unarchive.md | + + Title: "channel: unarchive" +description: "Restore an archived channel in a team. Unarchiving restores the ability for users to send messages and edit the channel." +ms.localizationpriority: medium +++++# channel: unarchive ++Namespace: microsoft.graph +++Restore an archived [channel](../resources/channel.md). Unarchiving restores the ability for users to send messages and edit the channel. Channels are archived via the [archive](channel-archive.md) API. ++Unarchiving is an asynchronous operation; a channel is unarchived when the asynchronous unarchive operation completes successfully, which might occur after this method responds. ++> **Note**: An archived channel that belongs to an archived team cannot be unarchived. Unarchive the team before you unarchive the channel; otherwise, an error will occur. +++## 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": "channel_unarchive" } --> ++> **Note**: This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of. ++## HTTP request +<!-- { "blockType": "ignored" } --> +```http +POST /teams/{team-id}/channels/{channel-id}/unarchive +POST /groups/{team-id}/team/channels/{channel-id}/unarchive +``` ++## Request headers ++| Header | Value | +|:|:--| +| Authorization | Bearer {token}. Required. | ++## Request body ++Don't supply a request body for this method. ++## Response ++If unarchiving is started successfully, this method returns a `202 Accepted` response code. The response contains a `Location` header, which contains the location of the [teamsAsyncOperation](../resources/teamsasyncoperation.md) that was created to handle unarchiving of the channel of the team. Check the status of the unarchiving operation by making a GET request to this location. ++## Example ++### Example 1: Unarchive a channel +The following example shows a request to unarchive a channel. ++#### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "unarchive_channel" +}--> +```http +POST https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}/unarchive +``` ++# [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. +<!-- { + "blockType": "response", + "name": "unarchive_channel" +}--> +```http +HTTP/1.1 202 Accepted +Location: /teams/{team-id}/operations/{operation-id} +Content-Type: text/plain +Content-Length: 0 +``` ++### Example 2: Unarchive a channel when the team is archived ++The following example shows a request to unarchive a channel in an archived team. ++#### Request ++<!-- { "blockType": "ignored" } --> +```http +POST https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}/unarchive +``` ++#### Response +The following example shows the `400` error response. ++<!-- { "blockType": "ignored" } --> +```http +http/1.1 400 Bad Request +Content-Type: application/json +Content-Length: 193 ++{ + "error": { + "code": "BadRequest", + "message": "Team has to be active, for channel to be archived or unarchived: {channel-id}", + "innerError": { + "message": "Team has to be active, for channel to be archived or unarchived: {channel-id}", + "code": "Unknown", + "innerError": {}, + "date": "2023-12-11T04:26:35", + "request-id": "8f897345980-f6f3-49dd-83a8-a3064eeecdf8", + "client-request-id": "50a0er33-4567-3f6c-01bf-04d144fc8bbe" + } + } +} ++``` +<!-- uuid: 9a9bb83f-6f35-4426-bb04-73ca43ad6cc8 +2015-10-25 14:57:30 UTC --> +<!-- +{ + "type": "#page.annotation", + "description": "Unarchive channel", + "keywords": "", + "section": "documentation", + "tocPath": "", + "suppressions": [] +} +--> |
v1.0 | Chat Delete Installedapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chat-delete-installedapps.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_delete_installedapps" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-delete-installedapps-permissions.md)] -> **Note**: The Chat.Manage.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The Chat.Manage.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request |
v1.0 | Chat Delete Members | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chat-delete-members.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_delete_members" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-delete-members-permissions.md)] -> **Note**: The Chat.Manage.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The Chat.Manage.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request |
v1.0 | Chat Delete Tabs | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chat-delete-tabs.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_delete_tabs" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-delete-tabs-permissions.md)] -> **Note**: The TeamsTab.Delete.Chat and TeamsTab.ReadWrite.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamsTab.Delete.Chat and TeamsTab.ReadWrite.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Chat Get Installedapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chat-get-installedapps.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_get_installedapps" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-get-installedapps-permissions.md)] -> **Note**: -The TeamsAppInstallation.Read.Chat and Chat.Manage.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamsAppInstallation.Read.Chat and Chat.Manage.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request Content-type: application/json ``` ### Example 2: Get the set of resource-specific permissions consented for the app installed in the specified chat -The following example gets the list of any [resource-specific permissions that were granted to an app](../resources/teamsapppermissionset.md) as part of installation. A `$select` query parameterd is required to show the consented permission set. +The following example gets the list of any [resource-specific permissions that were granted to an app](../resources/teamsapppermissionset.md) as part of installation. A `$select` query parameter is required to show the consented permission set. #### Request |
v1.0 | Chat Get Members | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chat-get-members.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_get_members" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-get-members-permissions.md)] -> **Note**: The TeamsAppInstallation.Read.Chat and Chat.Manage.Chat pPermissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamsAppInstallation.Read.Chat and Chat.Manage.Chat pPermissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request <!-- { "blockType": "ignored" } --> GET /users/{user-id | user-principal-name}/chats/{chat-id}/members/{membership-i ## Optional query parameters -This operation does not support the [OData query parameters](/graph/query-parameters) to customize the response. +This operation doesn't support the [OData query parameters](/graph/query-parameters) to customize the response. ## Request headers |
v1.0 | Chat Get Tabs | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chat-get-tabs.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_get_tabs" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-get-tabs-permissions.md)] -> **Note**: The TeamsTab.Read.Chat and TeamsTab.ReadWrite.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamsTab.Read.Chat and TeamsTab.ReadWrite.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request |
v1.0 | Chat Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chat-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_get" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-get-permissions.md)] -> **Note**: The ChatSettings.Read.Chat, ChatSettings.ReadWrite.Chat, and Chat.Manage.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChatSettings.Read.Chat, ChatSettings.ReadWrite.Chat, and Chat.Manage.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request |
v1.0 | Chat Getallretainedmessages | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chat-getallretainedmessages.md | The following example shows a request that uses the `$top` and `$filter` query p ```http GET /users/{id}/chats/getAllRetainedMessages?$top=50&$filter=lastModifiedDateTime gt 2020-06-04T18:03:11.591Z and lastModifiedDateTime lt 2020-06-05T21:00:09.413Z ```++The following table lists examples that show how to use the `$filter` parameter. ++|Scenario | `$filter` parameter |Possible values | +|:--|:|:--| +|Get messages sent by user identity type |$filter=from/user/userIdentityType eq '{teamworkUserIdentityType}' |aadUser, onPremiseAadUser, anonymousGuest, federatedUser, personalMicrosoftAccountUser, skypeUser, phoneUser| +|Get messages sent by application type |$filter=from/application/applicationIdentityType eq '{teamworkApplicationIdentity}' |aadApplication, bot, tenantBot, office365Connector, outgoingWebhook | +|Get messages sent by user ID |$filter=from/user/id eq '{oid}' || +|Get control (system event) messages |$filter=messageType eq 'systemEventMessage' || +|Exclude control (system event) messages |$filter=messageType ne 'systemEventMessage' || + ## Request headers |Name|Description| |
v1.0 | Chat List Installedapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chat-list-installedapps.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_list_installedapps" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-list-installedapps-permissions.md)] -> **Note:** -The following permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent): +> [!NOTE] +> The following permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent): > - TeamsAppInstallation.ReadWriteAndConsentSelfForChat > - TeamsAppInstallation.ReadWriteAndConsentForChat > - TeamsAppInstallation.ReadWriteAndConsentSelfForChat.All |
v1.0 | Chat List Members | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chat-list-members.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_list_members" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-list-members-permissions.md)] -> **Note**: The ChatMember.Read.Chat and Chat.Manage.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChatMember.Read.Chat and Chat.Manage.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Chat List Messages | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chat-list-messages.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_list_messages" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-list-messages-permissions.md)] -> **Note:** The ChatMessage.Read.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChatMessage.Read.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request This method supports the following [OData query parameters](/graph/query-paramet | [$orderby](/graph/query-parameters#orderby-parameter) | Currently supports the **lastModifiedDateTime** (default) and **createdDateTime** properties in descending order. The ascending order is currently not supported.| | [$filter](/graph/query-parameters#filter-parameter) | Sets the date range filter for the **lastModifiedDateTime** and **createdDateTime** properties. The **lastModifiedDateTime** property supports the `gt` and `lt` operators. The **createdDateTime** property supports the `lt` operator. You can only filter results if the request URL contains the `$orderby` and `$filter` query parameters configured for the same property; otherwise, the `$filter` query option is ignored.| -The other [OData query parameters](/graph/query-parameters) are not currently supported. +The other [OData query parameters](/graph/query-parameters) aren't currently supported. ## Request headers |
v1.0 | Chat List Operations | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chat-list-operations.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_list_operations" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-list-operations-permissions.md)] -> **Note:** The ChatSettings.Read.Chat and ChatSettings.ReadWrite.Chat, and Chat.Manage.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChatSettings.Read.Chat and ChatSettings.ReadWrite.Chat, and Chat.Manage.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request <!-- { |
v1.0 | Chat List Permissiongrants | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chat-list-permissiongrants.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_list_permissiongrants" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-list-permissiongrants-permissions.md)] -> **Note**: The TeamsAppInstallation.Read.Chat and Chat.Manage.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamsAppInstallation.Read.Chat and Chat.Manage.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Chat Patch Tabs | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chat-patch-tabs.md | Namespace: microsoft.graph Update the properties of the specified [tab](../resources/teamstab.md) in a [chat](../resources/chat.md). This API can be used to configure the content of the tab. -> **Note:** If the chat is associated with an [onlineMeeting](../resources/onlinemeeting.md) instance, then, effectively, the tab pinned in the meeting will be updated. +> [!NOTE] +> - If the chat is associated with an [onlineMeeting](../resources/onlinemeeting.md) instance, then, effectively, the tab pinned in the meeting will be updated. +> - You can't use this API to update a static tab. An attempt to update a static tab returns a `400 Bad Request` response code. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_patch_tabs" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-patch-tabs-permissions.md)] -> **Note:** The TeamsTab.ReadWrite.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamsTab.ReadWrite.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request PATCH /chats/{chat-id}/tabs/{tab-id} | Content-Type | application/json. Required. | ## Request body-In the request body, supply a JSON representation of [tab](../resources/teamstab.md) object. +In the request body, supply a JSON representation of a [tab](../resources/teamstab.md) object. ## Response |
v1.0 | Chat Patch | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chat-patch.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_patch" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-patch-permissions.md)] -> **Note:**S The ChatSettings.ReadWrite.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChatSettings.ReadWrite.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request |
v1.0 | Chat Post Installedapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chat-post-installedapps.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_post_installedapps" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-post-installedapps-permissions.md)] -> **Notes:** +> [!NOTE] > - The TeamsAppInstallation.ReadWriteSelfForChat, TeamsAppInstallation.ReadWriteForChat, TeamsAppInstallation.ReadWriteSelfForChat.All, and TeamsAppInstallation.ReadWriteForChat.All permissions cannot be used to install apps that require consent to resource-specific permissions. > - The Chat.Manage.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). |
v1.0 | Chat Post Members | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chat-post-members.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_post_members" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-post-members-permissions.md)] -> **Note:** The Chat.Manage.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The Chat.Manage.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request |
v1.0 | Chat Post Tabs | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chat-post-tabs.md | Namespace: microsoft.graph Add (pin) a [tab](../resources/teamstab.md) to the specified [chat](../resources/chat.md). The corresponding app must already be [installed in the chat](../api/chat-list-installedapps.md). -> **Note:** If the chat is associated with an [onlineMeeting](../resources/onlinemeeting.md) instance, then, effectively, the tab will get added to the meeting. +> **Notes**: +> * If the chat is associated with an [onlineMeeting](../resources/onlinemeeting.md) instance, then the tab is effectively added to the meeting. +> * If the app manifest for a given **appId** contains a static tab that matches the current scope (`chat`/`groupChat`), the static tab is pinned by default. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_post_tabs" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-post-tabs-permissions.md)] -> **Note:** The TeamsTab.Create.Chat and TeamsTab.ReadWrite.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamsTab.Create.Chat and TeamsTab.ReadWrite.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request <!-- { "blockType": "ignored" } --> POST /chats/{chat-id}/tabs In the request body include a JSON representation of a [teamsTab](../resources/teamstab.md). +> [!NOTE] +> When you pin a static tab, Teams takes the **displayName** and **configuration** from the app manifest. If these properties are specified in the request body, this API returns a `400 Bad Request` response code. + ## Response If successful, this method returns a `201 Created` response code and an instance of the [teamsTab](../resources/teamstab.md) resource in the body. |
v1.0 | Chat Sendactivitynotification | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chat-sendactivitynotification.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_sendactivitynotification" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-sendactivitynotification-permissions.md)] ->**Note:** The TeamsActivity.Send.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamsActivity.Send.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request |
v1.0 | Chat Teamsappinstallation Upgrade | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chat-teamsappinstallation-upgrade.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_teamsappinstallation_upgrade" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-teamsappinstallation-upgrade-permissions.md)] -> **Notes:** +> [!NOTE] > - The TeamsAppInstallation.ReadWriteSelfForChat, TeamsAppInstallation.ReadWriteForChat, TeamsAppInstallation.ReadWriteSelfForChat.All, and TeamsAppInstallation.ReadWriteForChat.All permissions can't be used to install apps that require consent to resource-specific permissions. > - The Chat.Manage.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). |
v1.0 | Chatmessage Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chatmessage-get.md | One of the following permissions is required to call this API. To learn more, in |Delegated (personal Microsoft account)|Not supported.| |Application| ChatMessage.Read.Chat, Chat.Read.All, Chat.ReadWrite.All| -> **Note**: The _ChannelMessage.Read.Group_ and _ChatMessage.Read.Chat_ permissions use [resource-specific consent]( https://aka.ms/teams-rsc). +> [!NOTE] +> The ChannelMessage.Read.Group and ChatMessage.Read.Chat permissions use [resource-specific consent]( https://aka.ms/teams-rsc). ## HTTP request GET /me/chats/{chat-id}/messages/{message-id} ``` ## Optional query parameters-This method does not support the [OData query parameters](/graph/query-parameters) to customize the response. +This method doesn't support the [OData query parameters](/graph/query-parameters) to customize the response. ## Request headers | Header | Value | Content-type: application/json "messageHistory": [] } ```+### Example 4: Get a chat message with custom emojis and reactions ++The following example shows a request to get a chat message that contains custom emojis in the message body and includes custom reactions. ++#### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_chatmessage_4", + "sampleKeys": ["19:bcf84b15c2994a909770f7d05bc4fe16@thread.v2", "1706763669648"] +}--> +```msgraph-interactive +GET https://graph.microsoft.com/beta/chats/19:bcf84b15c2994a909770f7d05bc4fe16@thread.v2/messages/1706763669648 +``` ++# [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. The message body contains a `<customemoji></customemoji>` tag, and the message includes a custom reaction indicated by `"reactionType": "custom"`. You can access both custom emojis and reactions as content hosted within a chat message. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.chatMessage" +} --> ++```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#chats('19%3Abcf84b15c2994a909770f7d05bc4fe16%40thread.v2')/messages/$entity", + "id": "1706763669648", + "replyToId": null, + "etag": "1707948456260", + "messageType": "message", + "createdDateTime": "2024-02-01T05:01:09.648Z", + "lastModifiedDateTime": "2024-02-14T22:07:36.26Z", + "lastEditedDateTime": null, + "deletedDateTime": null, + "subject": null, + "summary": null, + "chatId": "19:bcf84b15c2994a909770f7d05bc4fe16@thread.v2", + "importance": "normal", + "locale": "en-us", + "webUrl": null, + "channelIdentity": null, + "onBehalfOf": null, + "policyViolation": null, + "eventDetail": null, + "from": { + "application": null, + "device": null, + "user": { + "@odata.type": "#microsoft.graph.teamworkUserIdentity", + "id": "670374fa-3b0e-4a3b-9d33-0e1bc5ff1956", + "displayName": "Adele Vance", + "userIdentityType": "aadUser", + "tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34" + } + }, + "body": { + "contentType": "html", + "content": "<p>I am looking <emoji id=\"1f440_eyes\" alt=\"👀\" title=\"Eyes\"></emoji><customemoji id=\"dGVzdHNjOzAtd3VzLWQyLTdiNWRkZGQ2ZGVjMDNkYzIwNTgxY2NkYTE1MmEyZTM4\" alt=\"testsc\" source=\"https://graph.microsoft.com/beta/chats/19:bcf84b15c2994a909770f7d05bc4fe16@thread.v2/messages/1706638496169/hostedContents/aWQ9LHR5cGU9MSx1cmw9aHR0cHM6Ly91cy1jYW5hcnkuYXN5bmNndy50ZWFtcy5taWNyb3NvZnQuY29tL3YxL29iamVjdHMvMC13dXMtZDItN2I1ZGRkZDZkZWMwM2RjMjA1ODFjY2RhMTUyYTJlMzgvdmlld3MvaW1ndDJfYW5pbQ==/$value\"></customemoji></p>" + }, + "attachments": [], + "mentions": [], + "reactions": [ + { + "reactionType": "💯", + "reactionContentUrl": null, + "createdDateTime": "2024-02-14T22:07:36.3Z", + "user": { + "application": null, + "device": null, + "user": { + "@odata.type": "#microsoft.graph.teamworkUserIdentity", + "id": "670374fa-3b0e-4a3b-9d33-0e1bc5ff1956", + "displayName": null, + "userIdentityType": "aadUser" + } + } + }, + { + "reactionType": "custom", + "reactionContentUrl": "https://graph.microsoft.com/beta/chats/19:bcf84b15c2994a909770f7d05bc4fe16@thread.v2/messages/1706763669648/hostedContents/aWQ9MC13dXMtZDExLTc3ZmI2NmY4MTMwMGI2OGEzYzRkOWUyNmU1YTc5ZmMyLHR5cGU9MSx1cmw9/$value", + "createdDateTime": "2024-02-14T22:07:02.288Z", + "user": { + "application": null, + "device": null, + "user": { + "@odata.type": "#microsoft.graph.teamworkUserIdentity", + "id": "28c10244-4bad-4fda-993c-f332faef94f0", + "displayName": null, + "userIdentityType": "aadUser" + } + } + } + ] +} +``` ## Related content |
v1.0 | Chatmessage List Hostedcontents | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chatmessage-list-hostedcontents.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Retrieve the list of [chatMessageHostedContent](../resources/chatmessagehostedcontent.md) objects from a message. This API only lists the hosted content objects. To get the content bytes, see [get chatmessage hosted content](chatmessagehostedcontent-get.md) +Retrieve the list of [chatMessageHostedContent](../resources/chatmessagehostedcontent.md) objects from a message. This API only lists the hosted content objects. To get the content bytes, see [get chatmessage hosted content](chatmessagehostedcontent-get.md).s [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] Retrieve the list of [chatMessageHostedContent](../resources/chatmessagehostedco |Delegated (personal Microsoft account)|Not supported.| |Application| ChannelMessage.Read.Group, ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All | -> **Note**: The Group.Read.All and Group.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> [!NOTE] +> The Group.Read.All and Group.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. ### Permissions for chat <!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. --> Retrieve the list of [chatMessageHostedContent](../resources/chatmessagehostedco |Delegated (personal Microsoft account)|Not supported.| |Application| ChatMessage.Read.Chat, Chat.Read.All, Chat.ReadWrite.All| -> **Note**: The _ChannelMessage.Read.Group_ and _ChatMessage.Read.Chat_ permissions use [resource-specific consent]( https://aka.ms/teams-rsc). +> [!NOTE] +> The ChannelMessage.Read.Group and ChatMessage.Read.Chat permissions use [resource-specific consent]( https://aka.ms/teams-rsc). ## HTTP request |
v1.0 | Chatmessage List Replies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chatmessage-list-replies.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chatmessage_list_replies" } --> [!INCLUDE [permissions-table](../includes/permissions/chatmessage-list-replies-permissions.md)] -> **Note:** The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Chatmessage Post Replies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chatmessage-post-replies.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chatmessage_post_replies" } --> [!INCLUDE [permissions-table](../includes/permissions/chatmessage-post-replies-permissions.md)] -> **Note**: The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. --> **Note**: Application permissions are *only* supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). -In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. +> [!NOTE] +> - The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> - Application permissions are only supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Chatmessage Post | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chatmessage-post.md | Namespace: microsoft.graph Send a new [chatMessage](../resources/chatmessage.md) in the specified [channel](../resources/channel.md) or a [chat](../resources/chat.md). -> **Notes:** +> [!NOTE] > - We don't recommend that you use this API for data migration. It does not have the throughput necessary for a typical migration. > - It is a violation of the [terms of use](/legal/microsoft-apis/terms-of-use) to use Microsoft Teams as a log file. Only send messages that people will read. Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chatmessage_post" } --> [!INCLUDE [permissions-table](../includes/permissions/chatmessage-post-permissions.md)] -> **Note**: The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. --> **Note**: Application permissions are *only* supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. +> [!NOTE] +> - The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> - Application permissions are *only* supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. ### Permissions for chat <!-- { "blockType": "permissions", "name": "chatmessage_post_2" } --> Content-type: application/json "messageHistory": [] } ```+### Example 5: Send a message with a file attachment in it using file share link ++#### Request +The following example shows a request ++>**Notes:** +> - The file to attach must already be in SharePoint. Use any GUID for your attachment ID. Use the file share link as **contentURL**. User must have permissions to drive item using the file [share link](/graph/api/shares-get?view=graph-rest-1.0&tabs=http). +> - Using file share link for sending messages is not supported in [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams) scenario. +++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "post_chatmessage_5", + "sampleKeys": ["1e769eab-06a8-4b2e-ac42-1f040a4e52a1", "19:e28d1f9b354f4de88d2e9e4d8b983763@thread.tacv2"] +}--> +```http +POST https://graph.microsoft.com/v1.0/teams/1e769eab-06a8-4b2e-ac42-1f040a4e52a1/channels/19:e28d1f9b354f4de88d2e9e4d8b983763@thread.tacv2/messages +Content-type: application/json ++{ + "body": { + "contentType": "html", + "content": "Testing with file share link. <attachment id=\"668f7fa8-8129-4de7-b32b-fe1b442e6ef1\"></attachment>" + }, + "attachments": [ + { + "id": "668f7fa8-8129-4de7-b32b-fe1b442e6ef1", + "contentType": "reference", + "contentUrl": "https://teamsgraph-my.sharepoint.com/:w:/g/personal/test_teamsgraph_onmicrosoft_com/Eah_j2YpgedNsyv-G0QubvEBma6Sd_76UtYkXwoJ-nYVEg?e=0H2Ibm" + } + ] +} +``` ++# [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. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.chatMessage" +} --> +```http +HTTP/1.1 201 Created +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('1e769eab-06a8-4b2e-ac42-1f040a4e52a1')/channels('19%3Ae28d1f9b354f4de88d2e9e4d8b983763%40thread.tacv2')/messages/$entity", + "id": "1709663385319", + "replyToId": null, + "etag": "1709663385319", + "messageType": "message", + "createdDateTime": "2024-03-05T18:29:45.319Z", + "lastModifiedDateTime": "2024-03-05T18:29:45.319Z", + "lastEditedDateTime": null, + "deletedDateTime": null, + "subject": null, + "summary": null, + "chatId": null, + "importance": "normal", + "locale": "en-us", + "webUrl": "https://teams.microsoft.com/l/message/19%3Ae28d1f9b354f4de88d2e9e4d8b983763%40thread.tacv2/1709663385319?groupId=1e769eab-06a8-4b2e-ac42-1f040a4e52a1&tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34&createdTime=1709663385319&parentMessageId=1709663385319", + "policyViolation": null, + "eventDetail": null, + "from": { + "application": null, + "device": null, + "user": { + "@odata.type": "#microsoft.graph.teamworkUserIdentity", + "id": "28c10244-4bad-4fda-993c-f332faef94f0", + "displayName": "Test User", + "userIdentityType": "aadUser" + } + }, + "body": { + "contentType": "html", + "content": "Testing with file share link. <attachment id=\"668f7fa8-8129-4de7-b32b-fe1b442e6ef1\"></attachment>" + }, + "channelIdentity": { + "teamId": "1e769eab-06a8-4b2e-ac42-1f040a4e52a1", + "channelId": "19:e28d1f9b354f4de88d2e9e4d8b983763@thread.tacv2" + }, + "attachments": [ + { + "id": "668f7fa8-8129-4de7-b32b-fe1b442e6ef1", + "contentType": "reference", + "contentUrl": "https://teamsgraph-my.sharepoint.com/personal/test_teamsgraph_onmicrosoft_com/Documents/Personal%20Drive%20file%201.docx", + "content": null, + "name": "Personal Drive file 1.docx", + "thumbnailUrl": null, + "teamsAppId": null + } + ], + "mentions": [], + "reactions": [] +} +``` -### Example 5: Send inline images along with the message +### Example 6: Send inline images along with the message #### Request The following example shows a request. The following example shows a request. # [HTTP](#tab/http) <!-- { "blockType": "request",- "name": "post_chatmessage_5", + "name": "post_chatmessage_6", "sampleKeys": ["19:2da4c29f6d7041eca70b638b43d45437@thread.v2"] }--> ```http Content-type: application/json ``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [CLI](#tab/cli) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] Content-type: application/json } ``` -### Example 6: Send a card with inline images +### Example 7: Send a card with inline images #### Request The following example shows a request. The following example shows a request. # [HTTP](#tab/http) <!-- { "blockType": "request",- "name": "post_chatmessage_6", + "name": "post_chatmessage_7", "sampleKeys": ["fbe2bf47-16c8-47cf-b4a5-4b9b187c508b", "19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2"] }--> ```http Content-type: application/json ``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [CLI](#tab/cli) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] Content-type: application/json } ``` -### Example 7: @mention a channel in a channel message +### Example 8: @mention a channel in a channel message #### Request The following example shows a request. For information about how to get a list of channels in a team, see [List channels](../api/channel-list.md). Content-type: application/json } ``` -### Example 8: @mention a team in a channel message +### Example 9: @mention a team in a channel message #### Request The following example shows a request. Content-type: application/json } ``` -### Example 9: @mention a tag in a channel message +### Example 10: @mention a tag in a channel message #### Request The following example shows a request. For information about how to get a list of tags in a team, see [List teamworkTags](../api/teamworktag-list.md). Content-type: application/json } ``` -### Example 10: Send message that contains cards that are attributed to a Teams app +### Example 11: Send message that contains cards that are attributed to a Teams app #### Request The following example shows a request. # [HTTP](#tab/http) <!-- { "blockType": "request",- "name": "post_chatmessage_e10", + "name": "post_chatmessage_11", "sampleKeys": ["fbe2bf47-16c8-47cf-b4a5-4b9b187c508b", "19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2"] }--> Content-type: application/json ``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [CLI](#tab/cli) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] Content-type: application/json } ``` -### Example 11: Send a message that contains an announcement +### Example 12: Send a message that contains an announcement #### Request The following example shows a request. # [HTTP](#tab/http) <!-- { "blockType": "request",- "name": "post_chatmessage_11", + "name": "post_chatmessage_12", "sampleKeys": ["5c884e2f-83f8-4cff-af8e-0177f260b9f8", "19:81f49626414645c99469ee65a1a7e1a4@thread.tacv2"] }--> Content-type: application/json ``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [CLI](#tab/cli) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] Content-type: application/json ``` -### Example 12: Send a message with an emoji +### Example 13: Send a message with an emoji #### Request The following example shows a request. # [HTTP](#tab/http) <!-- { "blockType": "request",- "name": "post_chatmessage_12", + "name": "post_chatmessage_13", "sampleKeys": ["19:7fb82b685f9c457296a0ab6a1d98b4c1@thread.v2"] }--> Content-type: application/json ``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [CLI](#tab/cli) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Chatmessage Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chatmessage-update.md | You can update all the properties of **chatMessage** in delegated permissions sc Updating works only for chats where conversation members are Microsoft Teams users. If one of the members is using Skype, the operation fails. -This method does not support federation. Only the user in the tenant who sent the message can perform data loss prevention (DLP) updates on the specified chat message. +This method doesn't support federation. Only the user in the tenant who sent the message can perform data loss prevention (DLP) updates on the specified chat message. [!INCLUDE [teams-model-A-only-disclaimer](../../includes/teams-model-A-only-disclaimer.md)] One of the following permissions is required to call this API. To learn more, in | Delegated (personal Microsoft account) | Not supported. | | Application | ChannelMessage.UpdatePolicyViolation.All, Group.ReadWrite.All** | -> **Note:** The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> [!NOTE] +> The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. ### Permissions for chat <!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. --> PATCH /teams/(team-id)/channels/{channel-id}/messages/{message-id}/replies/{repl PATCH /chats/{chatThread-id}/messages/{message-id}?model=A ``` -If no `model` is specified, [evaluation mode](/graph/teams-licenses#evaluation-mode-default-requirements) will be used. +If no `model` is specified, [evaluation mode](/graph/teams-licenses#evaluation-mode-default-requirements) is used. ## Request headers HTTP/1.1 204 NoContent The following example shows a request to update the attachments on a Microsoft Teams channel message by using delegated permissions. - # [HTTP](#tab/http) <!-- { "blockType": "request", |
v1.0 | Chatmessagehostedcontent Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chatmessagehostedcontent-get.md | One of the following permissions is required to call this API. To learn more, in |Delegated (personal Microsoft account)|Not supported.| |Application| ChannelMessage.Read.Group, ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All | -> **Note:**: The Group.Read.All and Group.ReadWrite.All permissionsare supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> [!NOTE] +> The Group.Read.All and Group.ReadWrite.All permissionsare supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. ### Permissions for chat <!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. --> GET /users/{user-id | user-principal-name}/chats/{chat-id}/messages/{message-id} ## Optional query parameters -This operation does not support the [OData query parameters](/graph/query-parameters) to customize the response. +This operation doesn't support the [OData query parameters](/graph/query-parameters) to customize the response. ## Request headers |
v1.0 | Cloudclipboarditem Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudclipboarditem-get.md | Read the properties and relationships of a [cloudClipboardItem](../resources/clo This API doesn't support using another user's credentials to get a [cloudClipboardItem](../resources/cloudclipboarditem.md) 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). |
v1.0 | Cloudclipboardroot List Items | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudclipboardroot-list-items.md | Get a list of the [cloudClipboardItem](../resources/cloudclipboarditem.md) objec This API doesn't support using another user's credentials to get a [cloudClipboardItem](../resources/cloudclipboarditem.md) 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). |
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 "userPrincipalName": "pmitchell@contoso.com", "lastModifiedDateTime": "2020-11-03T18:14:34Z", "gracePeriodEndDateTime": "2020-11-010T20:00:34Z",- "provisioningType": "shared", + "provisioningType": "sharedByUser", "diskEncryptionState": "notAvailable" } ``` Content-Type: application/json The following example shows a request. - # [HTTP](#tab/http) <!-- { "blockType": "request", 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 +GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/40cee9d2-03fb-4066-8d35-dbdf2875c33f?$select=id,displayName,imageDisplayName,lastModifiedDateTime,lastRemoteActionResult,lastLoginResult,connectivityResult,allotmentDisplayName ``` # [C#](#tab/csharp) Content-Type: application/json "additionalDetails": "SessionHost unhealthy: SessionHost is not joined to a domain" } ]- } + }, + "allotmentDisplayName": null } ``` Content-Type: application/json "userPrincipalName": "pmitchell@contoso.com", "lastModifiedDateTime": "2020-11-03T18:14:34Z", "gracePeriodEndDateTime": "2020-11-010T20:00:34Z",- "provisioningType": "shared", + "provisioningType": "dedicated", "diskEncryptionState": "notAvailable" } ``` |
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 "lastModifiedDateTime": "2020-07-23T10:29:57Z", "statusDetails": null, "provisioningType": "dedicated",+ "allotmentDisplayName": null, "connectivityResult": "", "gracePeriodEndDateTime": null, "lastLoginResult": "2020-07-23T10:29:57Z", Content-Type: application/json "lastModifiedDateTime": "2020-07-28T18:14:34Z", "statusDetails": null, "provisioningType": "dedicated",+ "allotmentDisplayName": null, "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 | HTTP/1.1 200 OK Content-Type: application/json {- "@odata.type": "#microsoft.graph.cloudPcAuditEvent", - "id": "250473f5-029f-4037-813d-ba4768201d61", - "displayName": "Display Name value", - "componentName": "Component Name value",  - "activity": "Activity value",  - "activityDateTime": "2021-02-14T13:10:51.814636+08:00", - "activityType": " Activity Type value",  - "activityOperationType": "Activity Operation Type value", - "activityResult": "Activity Result value",  - "correlationId": "a5c71cc6-2271-4d5c-9bfe-d94781e83fe6", - "category": "Category value", - "actor": { - "@odata.type": "microsoft.graph.cloudPcAuditActor", - "type": "Type value", - "userPermissions": [ - "User Permissions value" - ], - "applicationId": "Application Id value", - "applicationDisplayName": "Application Display Name value", - "userPrincipalName": "User Principal Name value", - "servicePrincipalName": "Service Principal Name value", - "ipAddress": "Ip Address value", - "userId": "User Id value", - "userRoleScopeTags": [ - { - "@odata.type": "microsoft.graph.cloudPcUserRoleScopeTagInfo", - "displayName": "Display Name value", - "roleScopeTagId": "Role Scope Tag Id value" - } - ], - "remoteTenantId": "Remote Tenant Id value", - "remoteUserId": "Remote User Id value" - }, - "resources": [ + "@odata.type": "#microsoft.graph.cloudPcAuditEvent", + "id": "250473f5-029f-4037-813d-ba4768201d61", + "displayName": "Update OnPremisesConnection", + "componentName": "CloudPcOnPremisesConnectionsController", + "activity": null, + "activityDateTime": "2021-02-14T13:10:51.814636+08:00", + "activityType": "Patch CloudPcOnPremisesConnection", + "activityOperationType": "Patch", + "activityResult": "Success", + "correlationId": "a5c71cc6-2271-4d5c-9bfe-d94781e83fe6", + "category": "Cloud PC", + "actor": { + "@odata.type": "microsoft.graph.cloudPcAuditActor", + "type": "application", + "userPermissions": [], + "applicationId": "69cc3193-b6c4-4172-98e5-ed0f38ab3ff8", + "applicationDisplayName": "Cloud PC Ibiza", + "userPrincipalName": null, + "servicePrincipalName": null, + "ipAddress": null, + "userId": "ccaf0214-2d5c-4c72-b23f-191ff2c87313", + "userRoleScopeTags": [ + { + "@odata.type": "microsoft.graph.cloudPcUserRoleScopeTagInfo", + "displayName": "Europe", + "roleScopeTagId": "8ad48104-cb5c-497c-b144-6fc9927354ab" + } + ], + "remoteTenantId": "33c73c76-bf5d-45ba-ab4f-ee49c9a9be76", + "remoteUserId": "ccaf0214-2d5c-4c72-b23f-191ff2c87313" + }, + "resources": [ + { + "@odata.type": "microsoft.graph.cloudPcAuditResource", + "displayName": "ecmadao-test-azureconnection-1", + "modifiedProperties": [ {- "@odata.type": "microsoft.graph.cloudPcAuditResource", - "displayName": "Display Name value", - "modifiedProperties": [ - { - "@odata.type": "microsoft.graph.cloudPcAuditProperty", - "displayName": "Display Name value", - "oldValue": "Old Value value", - "newValue": "New Value value" - } - ], - "type": "Type value", - "resourceId": "Resource Id value" + "@odata.type": "microsoft.graph.cloudPcAuditProperty", + "displayName": "AdDomainUsername", + "oldValue": "12312", + "newValue": "new-adDomainUsername" }- ] + ], + "type": "CloudPcOnPremisesConnection", + "resourceType": "CloudPcOnPremisesConnection", + "resourceId": "a7508af8-d334-41ba-83a7-26cc88959724" + } + ] } ``` |
v1.0 | Cloudpcbulkaction Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcbulkaction-get.md | + + Title: "Get cloudPcBulkAction" +description: "Read the properties and relationships of a cloudPcBulkAction object." ++ms.localizationpriority: medium ++++# Get cloudPcBulkAction +Namespace: microsoft.graph +++Read the properties and relationships of a [cloudPcBulkAction](../resources/cloudpcbulkaction.md) object. +++## 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": "cloudpcbulkaction_get" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /deviceManagement/virtualEndpoint/bulkActions/{cloudPcBulkActionId} +``` ++## Optional query parameters +This method supports the `$select` OData query parameter 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 [cloudPcBulkAction](../resources/cloudpcbulkaction.md) object in the response body. ++## Examples ++### Request +The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_cloudpcbulkaction" +} +--> +``` http +GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/bulkActions/231ad98f-41b3-872b-dd37-c70bf22cbdac +``` ++# [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. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.cloudPcBulkAction" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": { + "@odata.type": "#microsoft.graph.cloudPcBulkAction", + "id": "231ad98f-41b3-872b-dd37-c70bf22cbdac", + "displayName": "Bulk Power Off by Andy", + "cloudPcIds": [ + "d6e0b8ee-8836-4b8d-b038-6130a97a3a9d", + "85994912-197b-4927-b569-447bd81350ec" + ], + "actionSummary": { + "failedCount": 1, + "inProgressCount": 0, + "notSupportedCount": 0, + "pendingCount": 1, + "successfulCount": 0 + }, + "scheduledDuringMaintenanceWindow": true, + "createdDateTime": "2024-02-05T10:29:57Z" + } +} +``` + |
v1.0 | Cloudpcdeviceimage Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcdeviceimage-delete.md | If successful, this method returns a `204 No Content` response code. ### Request +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "delete_deviceimages_from_virtualendpoint" If successful, this method returns a `204 No Content` response code. DELETE https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/deviceImages/435849e6-0263-4621-9f93-8657667af3bb ``` +# [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 **Note:** The response object shown here might be shortened for readability. |
v1.0 | Cloudpcdeviceimage Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcdeviceimage-get.md | If successful, this method returns a `200 OK` response code and a [cloudPcDevice ### Request +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_cloudpcdeviceimage" If successful, this method returns a `200 OK` response code and a [cloudPcDevice GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/deviceImages/eda7ed64-7705-4079-9d08-c2bd883f4fff ``` +# [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 **Note:** The response object shown here might be shortened for readability. |
v1.0 | Cloudpcexportjob Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcexportjob-get.md | Read the properties and relationships of a [cloudPcExportJob](../resources/cloud You can download a report by first [creating a new cloudPcExportJob resource](cloudpcreports-post-exportjobs.md) to initiate downloading. -Use this GET operation to verify the **exportJobStatus** property of the **cloudPcExportJob** resource. When the property becomes `completed`, the report has finished downloading in the location specified by the **exportUrl** property. +Use this GET operation to verify the **exportJobStatus** property of the **cloudPcExportJob** resource. The property becomes `completed` when the report finishes downloading in the location specified by the **exportUrl** property. [!INCLUDE [national-cloud-support](../../includes/global-only.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). +Choose the least privileged permission or permissions to download reports with this API. Delegated access require read access to the report that you need to export. App-only tokens with CloudPC.ReadWrite.All have permission or permissions to download all reports without specific permission. 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": "cloudpcexportjob_get" } --> [!INCLUDE [permissions-table](../includes/permissions/cloudpcexportjob-get-permissions.md)] +The following permissions in the in the [Cloud PC admin portal](https://intune.microsoft.com/#view/Microsoft_Intune_DeviceSettings/RolesLandingMenuBlade/~/myPermissions) provide access to specific kinds of reports: +- ActionStatus/Read +- DeviceRecommendation/Read +- CrossRegionDisasterRecovery/Read +- FrontlineReports/Read +- InaccessibleReports/Read +- PerformanceReports/Read + ## HTTP request <!-- { If successful, this method returns a `200 OK` response code and a [cloudPcExport ### Example 1: Get an export job for the TotalAggregatedRemoteConnectionReports report -The following example shows how to get an export job that was created by the POST request for the `TotalAggregatedRemoteConnectionReports` report. +The following example shows how to get an export job that a POST request for the `TotalAggregatedRemoteConnectionReports` report created. #### Request Content-Type: application/json ### Example 2: Get an export job for the RemoteConnectionQualityReports report -The following example shows how to get an export job that was created by the POST request for the `RemoteConnectionQualityReports` report. +The following example shows how to get an export job that a POST request for the `RemoteConnectionQualityReports` report created. #### Request |
v1.0 | Cloudpcgalleryimage Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcgalleryimage-get.md | If successful, this method returns a `200 OK` response code and a [cloudPcGaller The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_cloudpcgalleryimage", The following example shows a request. GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/galleryImages/MicrosoftWindowsDesktop_windows-ent-cpc_19h2-ent-cpc-os ``` +# [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. |
v1.0 | Cloudpcprovisioningpolicy Apply | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcprovisioningpolicy-apply.md | + + Title: "cloudPcProvisioningPolicy: apply" +description: "Apply the current provisioning policy configuration to all Cloud PC devices under a specified policy." ++ms.localizationpriority: medium ++++# cloudPcProvisioningPolicy: apply ++Namespace: microsoft.graph +++Apply the current [provisioning policy](../resources/cloudpcprovisioningpolicy.md) configuration to all Cloud PC devices under a specified policy. Currently, the region is the only policy setting that you can apply. +++## 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": "cloudpcprovisioningpolicy_apply" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++``` http +POST /deviceManagement/virtualEndpoint/provisioningPolicies/{id}/apply +``` ++## 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 parameters. ++The following table shows the parameter that you can use with this method. ++|Parameter|Type|Description| +|:|:|:| +|policySettings|cloudPcPolicySettingType|The target property of this apply action. Possible values are: `region`, `singleSignOn`, `unknownFutureValue`. The default value is `region`. This action applies `region` as a value if this parameter is `null`.| ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "apply_cloudpcprovisioningpolicy" +} +--> ++``` http +POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/provisioningPolicies/1d164206-bf41-4fd2-8424-a3192d39ffff/apply +Content-Type: application/json ++{ + "policySettings": "region" +} +``` ++# [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. ++<!-- { + "blockType": "response", + "truncated": true +} +--> ++``` http +HTTP/1.1 204 No Content +``` |
v1.0 | Cloudpcprovisioningpolicy Applyconfig | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcprovisioningpolicy-applyconfig.md | + + Title: "cloudPcProvisioningPolicy: applyConfig" +description: "Update the provisioning policy configuration for a set of Cloud PC devices by their IDs." ++ms.localizationpriority: medium ++++# cloudPcProvisioningPolicy: applyConfig ++Namespace: microsoft.graph +++Update the [provisioning policy](../resources/cloudpcprovisioningpolicy.md) configuration for a set of Cloud PC devices by their IDs. This method supports retry and allows you to apply the configuration to a subset of Cloud PCs initially to test. +++## 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": "cloudpcprovisioningpolicy_applyconfig" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /deviceManagement/virtualEndpoint/provisioningPolicies/applyConfig +``` ++## 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 parameters. ++The following table shows the parameters that you can use with this method. ++|Parameter|Type|Description| +|:|:|:| +|cloudPcIds|String collection|A collection of Cloud PC IDs.| +|policySettings|cloudPcPolicySettingType|The target property of this apply action. Possible values are: `region`, `singleSignOn`, `unknownFutureValue`. The default value is `region`. This action applies `region` as a value if this parameter is `null`.| ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "cloudpcprovisioningpolicythis.applyconfig" +} +--> +``` http +POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/provisioningPolicies/applyConfig +Content-Type: application/json ++{ + "cloudPcIds": [ + "52aa2645-36ee-47d2-9eb3-b8fbb17c3fc4", + "ff117b6c-e3e6-41be-9cae-eb6743249a30" + ], + "policySettings": "region" +} +``` ++# [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. +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` |
v1.0 | Cloudpcprovisioningpolicy Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcprovisioningpolicy-get.md | Content-Type: application/json "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy", "description": "Description value", "displayName": "Display Name value",- "domainJoinConfiguration": { - "domainJoinType": "hybridAzureADJoin", - "onPremisesConnectionId": "16ee6c71-fc10-438b-88ac-daa1ccafffff" - }, "domainJoinConfigurations": [ { "onPremisesConnectionId": "16ee6c71-fc10-438b-88ac-daa1ccafffff", Content-Type: application/json "imageDisplayName": "Image Display Name value", "imageId": "Image ID value", "imageType": "custom",- "onPremisesConnectionId": "4e47d0f6-6f77-44f0-8893-c0fe1701ffff", - "windowsSettings": { - "language": "en-US" - }, "windowsSetting": { "locale": "en-US" }, Content-Type: application/json "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy", "description": "Description value", "displayName": "Display Name value",- "domainJoinConfiguration": { - "onPremisesConnectionId": "4e47d0f6-6f77-44f0-8893-c0fe1701ffff", - "regionName": null, - "type": "hybridAzureADJoin" - }, "domainJoinConfigurations": [ { "onPremisesConnectionId": "16ee6c71-fc10-438b-88ac-daa1ccafffff", Content-Type: application/json "imageDisplayName": "Image Display Name value", "imageId": "Image ID value", "imageType": "custom",- "onPremisesConnectionId": "4e47d0f6-6f77-44f0-8893-c0fe1701ffff", - "windowsSettings": { - "language": "en-US" - }, "windowsSetting": { "locale": "en-US" }, The following example shows a request. --> ``` http-GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/provisioningPolicies/60b94f83-3e22-430e-a69d-440f65b922d6?$select=id,description,displayName,domainJoinConfiguration,imageDisplayName,imageId,imageType,onPremisesConnectionId,windowsSetting,managedBy,cloudPcGroupDisplayName,gracePeriodInHours,localAdminEnabled,alternateResourceUrl +GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/provisioningPolicies/60b94f83-3e22-430e-a69d-440f65b922d6?$select=id,description,displayName,domainJoinConfigurations,imageDisplayName,imageId,imageType,windowsSetting,managedBy,cloudPcGroupDisplayName,gracePeriodInHours,localAdminEnabled,alternateResourceUrl ``` # [C#](#tab/csharp) Content-Type: application/json "cloudPcGroupDisplayName": "MyCloudPcGroup", "description": "The ProvisioningPolicy for West US employees.", "displayName": "WestUsPolicy",- "domainJoinConfiguration": { - "onPremisesConnectionId": "4e47d0f6-6f77-44f0-8893-c0fe1701ffff", - "regionName": null, - "type": "hybridAzureADJoin" - }, "domainJoinConfigurations": [ { "onPremisesConnectionId": "16ee6c71-fc10-438b-88ac-daa1ccafffff", Content-Type: application/json "imageType": "custom", "localAdminEnabled": true, "managedBy": "windows365",- "onPremisesConnectionId": "4e47d0f6-6f77-44f0-8893-c0fe1701ffff", - "windowsSettings": { - "language": "en-US" - }, "windowsSetting": { "locale": "en-US" }, |
v1.0 | Cloudpcprovisioningpolicy Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcprovisioningpolicy-update.md | The following table shows the properties that can be updated for the [cloudPcPro |imageId|String|The ID of the OS image you want to provision on Cloud PCs. The format for a gallery type image is: {publisher_offer_sku}. Supported values for each of the parameters are as follows: <ul><li>publisher: Microsoftwindowsdesktop.</li> <li>offer: windows-ent-cpc.</li> <li>sku: 21h1-ent-cpc-m365, 21h1-ent-cpc-os, 20h2-ent-cpc-m365, 20h2-ent-cpc-os, 20h1-ent-cpc-m365, 20h1-ent-cpc-os, 19h2-ent-cpc-m365 and 19h2-ent-cpc-os.</li></ul>| |imageType|cloudPcProvisioningPolicyImageType|The type of OS image (custom or gallery) you want to provision on Cloud PCs. Possible values are: `gallery`, `custom`.| |windowsSetting|[cloudPcWindowsSettings](../resources/cloudpcwindowssetting.md)|Indicates a specific Windows setting to configure during the creation of Cloud PCs for this provisioning policy. Supports `$select`. |-|domainJoinConfiguration (deprecated)|[cloudPcDomainJoinConfiguration](../resources/cloudpcdomainjoinconfiguration.md)|Specifies how Cloud PCs join Microsoft Entra ID.| -|onPremisesConnectionId (deprecated)|String|The ID of the cloudPcOnPremisesConnection. To ensure that Cloud PCs have network connectivity and that they domain join, choose a connection with a virtual network thatΓÇÖs validated by the Cloud PC service.| +|domainJoinConfiguration (deprecated)|[cloudPcDomainJoinConfiguration](../resources/cloudpcdomainjoinconfiguration.md)|Specifies how Cloud PCs join Microsoft Entra ID. The **domainJoinConfiguration** property is deprecated and will stop returning data on May 31, 2024. Going forward, use the **domainJoinConfigurations** property.| +|onPremisesConnectionId (deprecated)|String|The ID of the cloudPcOnPremisesConnection. To ensure that Cloud PCs have network connectivity and that they domain join, choose a connection with a virtual network thatΓÇÖs validated by the Cloud PC service. The **onPremisesConnectionId** property is deprecated and will stop returning data on May 31, 2024. Going forward, use the **domainJoinConfigurations** property.| |windowsSettings (deprecated)|[cloudPcWindowsSettings](../resources/cloudpcwindowssettings.md)|Specific Windows settings to configure during the creation of Cloud PCs for this provisioning policy. Supports `$select`. The **windowsSettings** property is deprecated and will stop returning data on January 31, 2024. Going forward, use the **windowsSetting** property.| ## Response |
v1.0 | Cloudpcreports Getremoteconnectionhistoricalreports | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcreports-getremoteconnectionhistoricalreports.md | The following table shows the parameters that can be used with this action. |Parameter|Type|Description| |:|:|:|-|filter|String|OData filter syntax. Supported filters include `and`, `or`, `lt`, `le`, `gt`, `ge` and `eq`.| +|filter|String|OData filter syntax. Supported filters include `and`, `or`, `lt`, `le`, `gt`, `ge` and `eq`. The `CloudPcId` filter is required; for example: `CloudPcId eq xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`. If this filter is missing, malformed, or invalid, a query config will be thrown.| |select|String collection|OData select syntax. The columns to include in the report.| |search|String|The string to search for.| |groupBy|String collection|A list of columns that describe how to group the data in the report.| Content-length: 199 "UsageInHour", "RoundTripTimeInMsP50", "AvailableBandwidthInMBpsP50",- "RemoteSignInTimeInSec", + "RemoteSignInTimeInSec" ], "top": 25,- "skip": 0, + "skip": 0 } ``` |
v1.0 | Dailyuserinsightmetricsroot List Activeusersbreakdown | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/dailyuserinsightmetricsroot-list-activeusersbreakdown.md | - Title: "List daily activeUsersBreakdown (deprecated)" -description: "Get a list of daily activeUsersBreakdown objects on apps registered in your tenant configured for Microsoft Entra External ID for customers." ---doc_type: apiPageType ---# List daily activeUsersBreakdown (deprecated) -Namespace: microsoft.graph ---> [!CAUTION] -> This API is deprecated and will stop returning data on March 9, 2024. Use the [List monthly activeUsers](../api/monthlyuserinsightmetricsroot-list-activeusers.md) API instead. --Get a list of daily [activeUsersBreakdown](../resources/activeusersbreakdownmetric.md) objects on apps registered in your tenant configured for Microsoft Entra External ID for customers. ---## 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": "dailyuserinsightmetricsroot_list_activeusersbreakdown" } --> ---## HTTP request -<!-- { - "blockType": "ignored" -} >-``` http -GET /reports/userInsights/daily/activeUsersBreakdown -``` --## Optional query parameters -This method supports the `$filter` OData query parameter 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 [activeUsersBreakdownMetric](../resources/activeusersbreakdownmetric.md) objects in the response body. --## Examples --### Request -The following example shows a request. -# [HTTP](#tab/http) -<!-- { - "blockType": "request", - "name": "list_dailyactiveusersbreakdownmetric" -} >-``` http -GET https://graph.microsoft.com/beta/reports/userInsights/daily/activeUsersBreakdown -``` --# [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. ->**Note:** The response object shown here might be shortened for readability. -<!-- { - "blockType": "response", - "truncated": true, - "@odata.type": "Collection(microsoft.graph.activeUsersBreakdownMetric)" -} >-``` http -HTTP/1.1 200 OK -Content-Type: application/json --{ - "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.activeUsersBreakdownMetric)", - "value": [ - { - "id": "2", - "appId": "7a30b8ef-42h3-4d1e-84ad-17d4ca3c9a52", - "appName": "Bank", - "count": 1, - "factDate": "2023-09-28", - "os": "Windows" - }, - { - "id": "1", - "appId": "65e59557-d9d1-485f-87c5-80b92a99dfda", - "appName": "Kiosk", - "count": 1, - "factDate": "2023-09-20", - "os": "Ios" - } - ] -} -``` |
v1.0 | Delegatedadminrelationship Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/delegatedadminrelationship-update.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Update the properties of a [delegatedAdminRelationship](../resources/delegatedadminrelationship.md) object. You can only update a relationship when it's in the `created` **status**. However, you can update the **autoExtendDuration** property when the relationship is in either the `created` or `active` **status**. +Update the properties of a [delegatedAdminRelationship](../resources/delegatedadminrelationship.md) object. ++The following restrictions apply: +- You can update this relationship when its **status** property is `created`. +- You can update the **autoExtendDuration** property when **status** is either `created` or `active`. +- You can only remove the Microsoft Entra Global Administrator role when the **status** property is `active`, which indicates a long-running operation. + [!INCLUDE [national-cloud-support](../../includes/global-only.md)] PATCH /tenantRelationships/delegatedAdminRelationships/{delegatedAdminRelationsh ## Response -If successful, this method returns a `200 OK` response code and an updated [delegatedAdminRelationship](../resources/delegatedadminrelationship.md) object in the response body. +If successful, this method returns either a `200 OK` or a `202 Accepted` response code. The response body contains a + [delegatedAdminRelationship](../resources/delegatedadminrelationship.md) object when the response is `200 OK`. ++### Response headers +|Name|Description| +|:|:| +|Content-Type|application/json.| +|Location|The location of the long-running operation.| +|Retry-After|The time after which a subsequent API call can be made to the Location URL to check the status of the long-running operation.| ++This method returns a `202 Accepted` response if you remove the Microsoft Entra Global Administrator role from the relationship while its **status** property is `active`. The response includes a URL in the Location header that you can use to monitor the operation's progress. ++If you don't supply the template ID that corresponds to the Microsoft Entra Global Administrator role in the `unifiedRoles` array in the `accessDetails` property of the request body, then the API returns `200 OK` and the original [delegatedAdminRelationship](../resources/delegatedAdminRelationship.md) object in the response body. ## Examples ### Request+The following example shows the request. # [HTTP](#tab/http) <!-- { Content-Type: application/json ### Response+The following example shows the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json } ``` +The following is an example response that returns a `202 Accepted` response code along with **Location** and **Retry-After** headers. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.delegatedAdminRelationship" +} +--> ++``` http +HTTP/1.1 202 Accepted +Location: https://graph.microsoft.com/beta/tenantRelationships/delegatedAdminRelationships/5e5594d3-6f82-458b-b567-77db4811f0cd-00000000-0000-0000-0000-000000001234/operations/d8dbb27b-7fe7-4523-a3df-f766355fe0f2 +Retry-After: 10 +Content-Type: application/json ++{ +} +``` + |
v1.0 | Device Delete Registeredusers | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/device-delete-registeredusers.md | Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [limited-info](../../includes/limited-info.md)] -The calling user must also be in one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): *Global Administrator*, *Intune Administrator*, or *Windows 365 Administrator*. +The calling user must also be in at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): *Intune Administrator* or *Windows 365 Administrator*. ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Device Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/device-delete.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "device_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/device-delete-permissions.md)] -The calling user must also be in one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): *Global Administrator*, *Intune Administrator*, *Windows 365 Administrator*, or *Cloud Device Administrator*. +The calling user must also be in at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): *Intune Administrator*, *Windows 365 Administrator*, or *Cloud Device Administrator*. ## HTTP request |
v1.0 | Device Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/device-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "device_get" } --> [!INCLUDE [permissions-table](../includes/permissions/device-get-permissions.md)] -The calling user must also be in one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): +The calling user must also be in at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): -* Global Administrator * Users * Directory Readers * Directory Writers |
v1.0 | Device List Registeredusers | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/device-list-registeredusers.md | Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [limited-info](../../includes/limited-info.md)] -The calling user must also be in one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): +The calling user must also be in at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): -* Global Administrator * Users * Directory Readers * Directory Writers |
v1.0 | Device List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/device-list.md | Choose the permission or permissions marked as least privileged for this API. Us The calling user must also be in one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): -* Global Administrator * Users * Directory Readers * Directory Writers |
v1.0 | Device Post Devices | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/device-post-devices.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "device_post_devices" } --> [!INCLUDE [permissions-table](../includes/permissions/device-post-devices-permissions.md)] -The calling user must also be in one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): *Global Administrator*, *Intune Administrator*, or *Windows 365 Administrator*. +The calling user must also be in at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): *Intune Administrator* or *Windows 365 Administrator*. ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Device Post Registeredusers | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/device-post-registeredusers.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "device_post_registeredusers" } --> [!INCLUDE [permissions-table](../includes/permissions/device-post-registeredusers-permissions.md)] -The calling user must also be in one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): *Global Administrator*, *Intune Administrator*, or *Windows 365 Administrator*. +The calling user must also be in at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): *Intune Administrator* or *Windows 365 Administrator*. ## HTTP request |
v1.0 | Device Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/device-update.md | Choose the permission or permissions marked as least privileged for this API. Us In application-only scenarios and for non-Windows devices, that is, where the **operatingSystem** property is not `Windows`, the app can update only the **extensionAttributes** property. -In delegated scenarios, the calling user must also be in one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): *Global Administrator*, *Intune Administrator*. A calling user in the *Cloud Device Administrator* role can only enable or disable devices using this API and a user with the *Windows 365 Administrator* role can only update basic device properties. +The calling user must also be in at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): *Intune Administrator* or *Windows 365 Administrator*. A calling user in the *Cloud Device Administrator* role can only enable or disable devices using this API and a user with the *Windows 365 Administrator* role can only update basic device properties. A Global Administrator has full management privileges over the device. ## HTTP request |
v1.0 | Devicemanagement Alertrecord Changealertrecordsportalnotificationassent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/devicemanagement-alertrecord-changealertrecordsportalnotificationassent.md | + + Title: "alertRecord: changeAlertRecordsPortalNotificationAsSent" +description: "Change the isPortalNotificationSent property to true for a list of alert records for the current user." ++ms.localizationpriority: medium ++++# alertRecord: changeAlertRecordsPortalNotificationAsSent ++Namespace: microsoft.graph.deviceManagement +++Set the **isPortalNotificationSent** property of all [portal notification](../resources/devicemanagement-portalnotification.md) resources associated with the specified [alertRecord](../resources/devicemanagement-alertrecord.md) to `true`, marking them as sent. A maximum of 100 [alertRecord](../resources/devicemanagement-alertrecord.md) IDs can be received at one time, and a maximum of 100 **portal notification** resources can be changed in the **isPortalNotificationSent** property status. +++## 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": "devicemanagement_alertrecord_changealertrecordsportalnotificationassent" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /deviceManagement/monitoring/alertRecords/changeAlertRecordsPortalNotificationAsSent +``` ++## 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 ++|Property|Type|Description| +|:|:|:| +|alertRecordIds| String collection | A list of up to 100 [alertRecord](../resources/devicemanagement-alertrecord.md) IDs.| ++## Response ++If successful, this action returns a `202 Accepted` response code. ++## Example ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "alertrecordthis.changeAlertRecordsPortalNotificationAsSent" +} +--> +``` http +POST https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRecords/changeAlertRecordsPortalNotificationAsSent ++{ + "alertRecordIds": [ + "1d2b92e3-539a-481f-b38a-c2c050b422ad", + "4bf624c4-a801-4631-989c-7f1a3a0d1d83", + ] ++} +``` ++# [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. ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 202 ACCEPTED +``` |
v1.0 | Directory Delete Externaluserprofiles | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directory-delete-externaluserprofiles.md | DELETE https://graph.microsoft.com/beta/directory/externalUserProfiles/{id} [!INCLUDE [sample-code](../includes/snippets/php/delete-externaluserprofile-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-externaluserprofile-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Directory Delete Pendingexternaluserprofiles | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directory-delete-pendingexternaluserprofiles.md | description: "Delete a pendingExternalUserProfile object." ms.localizationpriority: medium doc_type: apiPageType + DELETE https://graph.microsoft.com/beta/directory/pendingExternalUserProfiles/{i [!INCLUDE [sample-code](../includes/snippets/php/delete-pendingexternaluserprofile-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-pendingexternaluserprofile-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Directory Deleteditems List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directory-deleteditems-list.md | ConsistencyLevel: eventual This example requires the **ConsistencyLevel** header because the `$orderby` and `$count` query parameters are used in the query. -### Examples using the $orderby OData query parameter +### $orderby OData query parameter examples -The `$orderby` OData query parameter is supported on the **deletedDateTime**, **displayName**, and **userPrincipalName** properties of the deleted object types. On the **deletedDateTime** property, the query requires adding the [advanced query parameters](/graph/aad-advanced-queries) (**ConsistencyLevel** header set to `true` and `$count=true` query string). +The `$orderby` OData query parameter is supported on the **deletedDateTime**, **displayName**, and **userPrincipalName** properties of the deleted object types. On the **deletedDateTime** property, the query requires adding the [advanced query parameters](/graph/aad-advanced-queries) (**ConsistencyLevel** header set to `eventual` and `$count=true` query string). | OData cast | Properties supporting $orderby | Example | | : | : | : | |
v1.0 | Directory List Externaluserprofiles | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directory-list-externaluserprofiles.md | GET https://graph.microsoft.com/beta/directory/externalUserProfiles [!INCLUDE [sample-code](../includes/snippets/php/list-externaluserprofiles-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-externaluserprofiles-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Directory List Inboundshareduserprofiles | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directory-list-inboundshareduserprofiles.md | Title: "List inboundSharedUserProfiles" description: "Retrieve the properties of an inboundSharedUserProfiles." + ms.localizationpriority: medium doc_type: apiPageType |
v1.0 | Directory List Outboundshareduserprofiles | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directory-list-outboundshareduserprofiles.md | Title: "List outboundSharedUserProfiles" description: "Retrieve the properties of all outboundSharedUserProfiles." + ms.localizationpriority: medium doc_type: apiPageType |
v1.0 | Directory List Pendingexternaluserprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directory-list-pendingexternaluserprofile.md | description: "List all pendingExternalUserProfile objects." ms.localizationpriority: medium doc_type: apiPageType + GET https://graph.microsoft.com/beta/directory/pendingExternalUserProfiles [!INCLUDE [sample-code](../includes/snippets/php/list-pendingexternaluserprofiles-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-pendingexternaluserprofiles-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Directory Post Administrativeunits | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directory-post-administrativeunits.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "directory_post_administrativeunits" } --> [!INCLUDE [permissions-table](../includes/permissions/directory-post-administrativeunits-permissions.md)] -To create an administrative unit, the calling principal must be assigned one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): --* Privileged Role Administrator -* Global Administrator +To create an administrative unit, the calling principal must be assigned at least the *Privileged Role Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Directory Post Pendingexternaluserprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directory-post-pendingexternaluserprofile.md | description: "Create a new pendingExternalUserProfile object." ms.localizationpriority: medium doc_type: apiPageType + Content-type: application/json [!INCLUDE [sample-code](../includes/snippets/php/create-pendingexternaluserprofile-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/create-pendingexternaluserprofile-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Directoryobject Checkmemberobjects | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directoryobject-checkmemberobjects.md | description: "Check for membership in a list of groups, administrative units, or ms.localizationpriority: medium + doc_type: "apiPageType" |
v1.0 | Domain Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/domain-delete.md | Title: "Delete domain" -description: "Deletes a domain from a tenant." -+description: "Delete a domain from a tenant." + ms.localizationpriority: medium doc_type: apiPageType Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Deletes a domain from a tenant. +Delete a domain from a tenant. > **Important:** > Deleted domains are not recoverable. Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "domain_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/domain-delete-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* Domain Name Administrator +The work or school account needs to belong to at least the *Domain Name Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Domain Forcedelete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/domain-forcedelete.md | Title: "domain: forceDelete" -description: "Deletes a domain using an asynchronous operation." -+description: "Delete a domain using an asynchronous operation." + ms.localizationpriority: medium doc_type: apiPageType Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Deletes a domain using an asynchronous operation. +Delete a domain using an asynchronous operation. -Prior to calling [forceDelete](domain-forcedelete.md), you must update or remove any references to **Exchange** as the provisioning service. +Before performing this operation, you must update or remove any references to **Exchange** as the provisioning service. The following actions are performed as part of this operation: The following actions are performed as part of this operation: * If the number of objects to be renamed is greater than 1,000, an error is returned. -* If one of the applications to be renamed is a multi-tenant app, an error is returned. +* If one of the applications to be renamed is a multitenant app, an error is returned. -After the domain deletion completes, API operations for the deleted domain will return a 404 HTTP response code. To verify deletion of a domain, you can perform a [get domain](domain-get.md). If the domain was successfully deleted, a 404 HTTP response code will be returned in the response. +After the domain deletion completes, API operations for the deleted domain return a 404 HTTP response code. To verify deletion of a domain, you can perform a [get domain](domain-get.md). If the domain was successfully deleted, a 404 HTTP response code is returned in the response. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "domain_forcedelete" } --> [!INCLUDE [permissions-table](../includes/permissions/domain-forcedelete-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* Domain Name Administrator +The work or school account needs to belong to at least the *Domain Name Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request In the request body, provide a JSON object with the following parameters. | Parameter | Type |Description| |:|:--|:-|-|disableUserAccounts|Boolean| Option to disable renamed user accounts. If a user account is disabled, the user will not be allowed to sign in.<br>*True* (default) - User accounts renamed as part of this operation are disabled.<br>*False* - User accounts renamed as part of this operation are not disabled. | +|disableUserAccounts|Boolean| Option to disable renamed user accounts. If a user account is disabled, the user isn't allowed to sign in.<br>`true` (default) - User accounts renamed as part of this operation are disabled.<br>`false` - User accounts renamed as part of this operation aren't disabled. | ## Response |
v1.0 | Domain Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/domain-get.md | Title: "Get domain" description: "Retrieve the properties and relationships of domain object."-+ ms.localizationpriority: medium doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "domain_get" } --> [!INCLUDE [permissions-table](../includes/permissions/domain-get-permissions.md)] -The work or school account needs to belong to one of the following roles: +The work or school account needs to belong to at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). -* Global Administrator * User Administrator * Helpdesk Administrator * Service Support Administrator |
v1.0 | Domain List Domainnamereferences | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/domain-list-domainnamereferences.md | Title: "List domainNameReferences" description: "Retrieve a list of directoryObject with a reference to the domain."-+ ms.localizationpriority: medium doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "domain_list_domainnamereferences" } --> [!INCLUDE [permissions-table](../includes/permissions/domain-list-domainnamereferences-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* Domain Name Administrator -* Global Reader +The work or school account needs to belong to at least the *Domain Name Administrator* or*Global Reader* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). [!INCLUDE [limited-info](../../includes/limited-info.md)] |
v1.0 | Domain List Serviceconfigurationrecords | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/domain-list-serviceconfigurationrecords.md | Title: "List serviceConfigurationRecords" description: "Retrieves a list of domainDnsRecord objects needed to enable services for the domain."-+ ms.localizationpriority: medium doc_type: apiPageType |
v1.0 | Domain List Verificationdnsrecords | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/domain-list-verificationdnsrecords.md | Title: "List verificationDnsRecords" description: "Retrieve a list of domainDnsRecord objects."-+ ms.localizationpriority: medium doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "domain_list_verificationdnsrecords" } --> [!INCLUDE [permissions-table](../includes/permissions/domain-list-verificationdnsrecords-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* Domain Name Administrator -* Global Reader +The work or school account needs to belong to at least the *Domain Name Administrator* or *Global Reader* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Domain List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/domain-list.md | Title: "List domains" description: "Retrieve a list of domain objects."-+ ms.localizationpriority: medium doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "domain_list" } --> [!INCLUDE [permissions-table](../includes/permissions/domain-list-permissions.md)] -The work or school account needs to belong to one of the following roles: +The work or school account needs to belong to at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): -* Global Administrator * User Administrator * Helpdesk Administrator * Service Support Administrator |
v1.0 | Domain Post Domains | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/domain-post-domains.md | Title: "Create domain" description: "Adds a domain to the tenant."-+ ms.localizationpriority: medium doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "domain_post_domains" } --> [!INCLUDE [permissions-table](../includes/permissions/domain-post-domains-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* Domain Name Administrator +The work or school account needs to belong to at least the *Domain Name Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request |
v1.0 | Domain Post Federationconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/domain-post-federationconfiguration.md | Title: "Create internalDomainFederation" description: "Create a new internalDomainFederation object." ms.localizationpriority: medium-+ doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "domain_post_federationconfiguration" } --> [!INCLUDE [permissions-table](../includes/permissions/domain-post-federationconfiguration-permissions.md)] +> [!IMPORTANT] +> This method has a [known permissions issue](https://developer.microsoft.com/en-us/graph/known-issues/?search=21445) and might require consenting to the *Directory.AccessAsUser.All* permission for delegated scenarios. + [!INCLUDE [rbac-domainfederation-apis-write](../includes/rbac-for-apis/rbac-domainfederation-apis-write.md)] ## HTTP request You can specify the following properties when creating an **internalDomainFedera |displayName|String|The display name of the federated identity provider.| |issuerUri|String|Issuer URI of the federation server.| |metadataExchangeUri|String|URI of the metadata exchange endpoint used for authentication from rich client applications.|-|signingCertificate|String|Current certificate used to sign tokens passed to the Microsoft identity platform. The certificate is formatted as a Base64 encoded string of the public portion of the federated IdP's token signing certificate and must be compatible with the X509Certificate2 class. <br>This property is used in the following scenarios: <li> If a rollover is required outside of the autorollover update <li> A new federation service is being set up <li> If the new token signing certificate isn't present in the federation properties after the federation service certificate has been updated.<br>Microsoft Entra ID updates certificates via an autorollover process in which it attempts to retrieve a new certificate from the federation service metadata, 30 days before expiry of the current certificate. If a new certificate isn't available, Microsoft Entra ID monitors the metadata daily and will update the federation settings for the domain when a new certificate is available.| +|signingCertificate|String|Current certificate used to sign tokens passed to the Microsoft identity platform. The certificate is formatted as a Base 64 encoded string of the public portion of the federated IdP's token signing certificate and must be compatible with the X509Certificate2 class. <br>This property is used in the following scenarios: <li> If a rollover is required outside of the autorollover update <li> A new federation service is being set up <li> If the new token signing certificate isn't present in the federation properties after the federation service certificate has been updated.<br>Microsoft Entra ID updates certificates via an autorollover process in which it attempts to retrieve a new certificate from the federation service metadata, 30 days before expiry of the current certificate. If a new certificate isn't available, Microsoft Entra ID monitors the metadata daily and updates the federation settings for the domain when a new certificate is available.| |passiveSignInUri|String|URI that web-based clients are directed to when signing in to Microsoft Entra services.| |preferredAuthenticationProtocol|authenticationProtocol|Preferred authentication protocol. The possible values are: `wsFed`, `saml`, `unknownFutureValue`.| |activeSignInUri|String|URL of the endpoint used by active clients when authenticating with federated domains set up for single sign-on in Microsoft Entra ID. Corresponds to the **ActiveLogOnUri** property of the [Set-MsolDomainFederationSettings MSOnline v1 PowerShell cmdlet](/powershell/module/msonline/set-msoldomainfederationsettings).| |signOutUri|String|URI that clients are redirected to when they sign out of Microsoft Entra services. Corresponds to the **LogOffUri** property of the [Set-MsolDomainFederationSettings MSOnline v1 PowerShell cmdlet](/powershell/module/msonline/set-msoldomainfederationsettings).| |promptLoginBehavior|promptLoginBehavior|Sets the preferred behavior for the sign-in prompt. The possible values are: `translateToFreshPasswordAuthentication`, `nativeSupport`, `disabled`, `unknownFutureValue`.| |isSignedAuthenticationRequestRequired|Boolean|If true, when SAML authentication requests are sent to the federated SAML IDP, Microsoft Entra ID signs those requests using the OrgID signing key. If false (default), the SAML authentication requests sent to the federated IDP aren't signed.|-|nextSigningCertificate|String|Fallback token signing certificate that is used to sign tokens when the primary signing certificate expires. Formatted as Base64 encoded strings of the public portion of the federated IdP's token signing certificate. Needs to be compatible with the X509Certificate2 class. Much like the **signingCertificate**, the **nextSigningCertificate** property is used if a rollover is required outside of the auto-rollover update, a new federation service is being set up, or if the new token signing certificate isn't present in the federation properties after the federation service certificate has been updated.| +|nextSigningCertificate|String|Fallback token signing certificate that is used to sign tokens when the primary signing certificate expires. Formatted as Base 64 encoded strings of the public portion of the federated IdP's token signing certificate. Needs to be compatible with the X509Certificate2 class. Much like the **signingCertificate**, the **nextSigningCertificate** property is used if a rollover is required outside of the autorollover update, a new federation service is being set up, or if the new token signing certificate isn't present in the federation properties after the federation service certificate has been updated.| |signingCertificateUpdateStatus|[signingCertificateUpdateStatus](../resources/signingcertificateupdatestatus.md)|Provides status and timestamp of the last update of the signing certificate.| |federatedIdpMfaBehavior|federatedIdpMfaBehavior|Determines whether Microsoft Entra ID accepts the MFA performed by the federated IdP when a federated user accesses an application that is governed by a conditional access policy that requires MFA. The possible values are: `acceptIfMfaDoneByFederatedIdp`, `enforceMfaByFederatedIdp`, `rejectMfaByFederatedIdp`, `unknownFutureValue`. For more information, see [federatedIdpMfaBehavior values](#federatedidpmfabehavior-values).| + ### federatedIdpMfaBehavior values | Member | Description | You can specify the following properties when creating an **internalDomainFedera | rejectMfaByFederatedIdp | Microsoft Entra ID always performs MFA and rejects MFA that's performed by the federated identity provider. | **Note:** **federatedIdpMfaBehavior** is an evolved version of the **SupportsMfa** property of the [Set-MsolDomainFederationSettings MSOnline v1 PowerShell cmdlet](/powershell/module/msonline/set-msoldomainfederationsettings). -+ Switching between **federatedIdpMfaBehavior** and **SupportsMfa** is not supported. ++ Switching between **federatedIdpMfaBehavior** and **SupportsMfa** isn't supported. + Once **federatedIdpMfaBehavior** property is set, Microsoft Entra ID ignores the **SupportsMfa** setting. + If the **federatedIdpMfaBehavior** property is never set, Microsoft Entra ID continues to honor the **SupportsMfa** setting. + If neither **federatedIdpMfaBehavior** nor **SupportsMfa** is set, Microsoft Entra ID defaults to `acceptIfMfaDoneByFederatedIdp` behavior. Content-Type: application/json "federatedIdpMfaBehavior": "rejectMfaByFederatedIdp" } ```++<!-- +{ + "type": "#page.annotation", + "description": "", + "keywords": "", + "section": "documentation", + "tocPath": "", + "suppressions": [ + "Error: /api/domain-post-federationconfiguration.md: + Exception processing links. + Link Definition was null. Link text: !INCLUDE Azure AD PowerShell deprecation note (Parameter 'Definition')" + ] +} +--> |
v1.0 | Domain Promote | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/domain-promote.md | Title: "domain: promote" description: "Promote a verified subdomain to the root domain."-+ ms.localizationpriority: medium doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "domain_promote" } --> [!INCLUDE [permissions-table](../includes/permissions/domain-promote-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* Domain Name Administrator +The work or school account needs to belong to at least the *Domain Name Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request |
v1.0 | Domain Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/domain-update.md | Title: "Update domain" description: "Update the properties of domain object."-+ ms.localizationpriority: medium doc_type: apiPageType Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Update the properties of domain object. --> **Important:** -> Only verified domains can be updated. +Update the properties of [domain](../resources/domain.md) object. Only verified domains can be updated. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "domain_update" } --> [!INCLUDE [permissions-table](../includes/permissions/domain-update-permissions.md)] -The work or school account needs to belong to one of the following roles: +The work or school account needs to belong to at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): -* Global Administrator * Domain Name Administrator * Security Administrator * External Identity Provider Administrator |
v1.0 | Domain Verify | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/domain-verify.md | Title: "domain: verify" -description: "Validates the ownership of the domain." -+description: "Validate the ownership of a domain." + ms.localizationpriority: medium doc_type: apiPageType Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Validates the ownership of the domain. +Validate the ownership of a domain. > **Important:** > Only applies to an unverified domain. For an unverified domain, the isVerified property of the [domain](../resources/domain.md) is false. Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "domain_verify" } --> [!INCLUDE [permissions-table](../includes/permissions/domain-verify-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* Domain Name Administrator +The work or school account needs to belong to at least the *Domain Name Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request |
v1.0 | Driveitem Assignsensitivitylabel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/driveitem-assignsensitivitylabel.md | Namespace: microsoft.graph Asynchronously assign a sensitivity label to a [driveItem][item-resource]. -This API is part of Microsoft SharePoint and OneDrive APIs that perform advanced premium administrative functions and is considered a protected API. Protected APIs require you to have more validation, beyond permission and consent, before you can use them. Before you call this API, you must [request access](https://aka.ms/PreviewSPOPremiumAPI). --For more information about sensitivity labels from an administrator's perspective, see [Enable sensitivity labels for Office files in SharePoint and OneDrive](/microsoft-365/compliance/sensitivity-labels-sharepoint-onedrive-files?view=o365-worldwide&preserve-view=true). +This API is part of the Microsoft SharePoint and OneDrive APIs that perform advanced premium administrative functions, and is considered a protected API. Protected APIs require you to have more validation, beyond permission and consent, before you can use them. > [!NOTE] -> This is a metered API and some charges for use may apply. For details, see [Overview of metered Microsoft 365 APIs in Microsoft Graph](/graph/metered-api-overview). +> This is a metered API and some charges for use may apply. For details, see [Overview of metered Microsoft 365 APIs in Microsoft Graph](/graph/metered-api-overview). Before you call this API, you must [Enable metered APIs and services in Microsoft Graph](/graph/metered-api-setup?tabs=azurecloudshell). ++This API applies sensitivity labels to files at rest. Office clients don't apply watermarks, headers, or footers to files that contain the label information. For more information about sensitivity labels from an administrator's perspective, see [Enable sensitivity labels for Office files in SharePoint and OneDrive](/microsoft-365/compliance/sensitivity-labels-sharepoint-onedrive-files?view=o365-worldwide&preserve-view=true). [!INCLUDE [national-cloud-support](../../includes/global-only.md)] |
v1.0 | Driveitem Get Contentstream | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/driveitem-get-contentstream.md | Namespace: microsoft.graph Download the contents of the primary stream (file) of a [driveItem](../resources/driveitem.md). Only **driveItem** objects with the **file** property can be downloaded. + ## 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). The following example shows how to download a file. GET https://graph.microsoft.com/beta/drives/b!fMInbiL5dkK51VbATG0ddrCg6AJpEj9Lm4uGj5HgEi4guyuYp4W5SbH4dPfXTbCF/items/014Y52UITTNSVUQI43PZBJMKLAY6LJBUVE/contentStream ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/download-item-content-stream-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) + #### Response GET https://graph.microsoft.com/beta/drives/b!fMInbiL5dkK51VbATG0ddrCg6AJpEj9Lm4 Range: bytes=0-1023 ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/download-item-partial-stream-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) + #### Response |
v1.0 | Educationclass Delete Members | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationclass-delete-members.md | The following example shows a request. "sampleKeys": ["11003", "14008"] }--> ```http-DELETE https://graph.microsoft.com/beta/education/classes/11003/members/14008 +DELETE https://graph.microsoft.com/beta/education/classes/11003/members/14008/$ref ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/create-educationclass-from-educationschool-1-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) + ### Response |
v1.0 | Educationgradingscheme Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationgradingscheme-delete.md | Namespace: microsoft.graph Delete an [educationGradingScheme](../resources/educationgradingscheme.md) object. + ## 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). DELETE https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-856 [!INCLUDE [sample-code](../includes/snippets/php/delete-educationgradingscheme-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-educationgradingscheme-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Educationgradingscheme Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationgradingscheme-get.md | Namespace: microsoft.graph Read the properties and relationships of an [educationGradingScheme](../resources/educationgradingscheme.md) object. + ## 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). GET https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f [!INCLUDE [sample-code](../includes/snippets/php/get-educationgradingscheme-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-educationgradingscheme-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Educationgradingscheme Post | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationgradingscheme-post.md | Namespace: microsoft.graph Create a new [educationGradingScheme](../resources/educationgradingscheme.md) object. + ## 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). |
v1.0 | Educationgradingscheme Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationgradingscheme-update.md | Namespace: microsoft.graph Update the properties of an [educationGradingScheme](../resources/educationgradingscheme.md) object. + ## 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). Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/update-educationgradingscheme-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/update-educationgradingscheme-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] Content-Type: application/json [!INCLUDE [snippet-not-available](../includes/snippets/snippet-not-available.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [snippet-not-available](../includes/snippets/snippet-not-available.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Encryptedawsstoragebucketfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/encryptedawsstoragebucketfinding-get.md | description: "Read the properties and relationships of an encryptedAwsStorageBuc ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Encryptedawsstoragebucketfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/encryptedawsstoragebucketfinding-list.md | description: "Get a list of the encryptedAwsStorageBucketFinding objects and the ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Encryptedazurestorageaccountfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/encryptedazurestorageaccountfinding-get.md | description: "Read the properties and relationships of an encryptedAzureStorageA ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Encryptedazurestorageaccountfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/encryptedazurestorageaccountfinding-list.md | description: "Get a list of the encryptedAzureStorageAccountFinding objects and ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Encryptedgcpstoragebucketfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/encryptedgcpstoragebucketfinding-get.md | description: "Read the properties and relationships of an encryptedGcpStorageBuc ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Encryptedgcpstoragebucketfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/encryptedgcpstoragebucketfinding-list.md | description: "Get a list of the encryptedGcpStorageBucketFinding objects and the ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Entitlementmanagement Post Accesspackageassignmentrequests | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/entitlementmanagement-post-accesspackageassignmentrequests.md | If successful, this method returns a 200-series response code and a new [accessP If this is an `AdminAdd` request, then subsequently an [accessPackageAssignment](../resources/accesspackageassignment.md) and, if needed, an [accessPackageSubject](../resources/accesspackagesubject.md) are also created. You can locate those using the query parameters when [listing accessPackageAssignments](entitlementmanagement-list-accesspackageassignments.md). ## Examples+ ### Example 1: Admin requests a direct assignment for a user already in the directory+ #### Request -The following example shows a request for a direct assignment, in which the administrator is requesting the creation of an assignment for the user. Because the [accessPackageSubject](../resources/accesspackagesubject.md) might not yet exist, the value of the **targetID** is the object ID of the user being assigned, the value of the **accessPackageId** is the desired access package for that user, and the value of **assignmentPolicyId** is a direct assignment policy in that access package. - +The following example shows a request for a direct assignment, in which the administrator requests the creation of an assignment for a user. Because the [accessPackageSubject](../resources/accesspackagesubject.md) might not yet exist, the value of the **targetID** is the object ID of the user being assigned, the value of the **accessPackageId** is the desired access package for that user, and the value of **assignmentPolicyId** is a direct assignment policy in that access package. # [HTTP](#tab/http) <!-- { HTTP/1.1 201 Created Content-type: application/json {- "id": "7e382d02-4454-436b-b700-59c7dd77f466", "requestType": "AdminAdd", "requestState": "Submitted", Content-type: application/json } ``` -### Example 2: User requests a package and answers questions for approval +### Example 2: Remove an assignment ++To remove assignments, create a new accessPackageAssignmentRequest object with the following settings: ++* The value of the **requestType** property set to `AdminRemove`. +* In the **accessPackageAssignment** property, include an object with the identifier of the **accessPackageAssignment** objects to delete. + #### Request +The following example shows how to remove an assignment. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_accesspackageassignmentrequest_from_accesspackageassignmentrequests_remove_assignment" +}--> ++```http +POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignmentRequests +Content-type: application/json ++{ + "requestType": "AdminRemove", + "accessPackageAssignment":{ + "id": "a6bb6942-3ae1-4259-9908-0133aaee9377" + } +} +``` ++# [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. ++> **Note:** The response object shown here might be shortened for readability. All the properties are returned from an actual call. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.accessPackageAssignmentRequest" +} --> ++```http +HTTP/1.1 201 Created +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#accessPackageAssignmentRequests/$entity", ++ "id": "78eaee8c-e6cf-48c9-8f99-aae44c35e379", + "requestType": "AdminRemove", + "requestState": "Submitted", + "requestStatus": "Accepted" +} +``` ++### Example 3: Request an assignment by providing answers to questions + The following example shows a request where the requestor provided answers to the approver to help them make their decision.- +#### Request +The following example shows a request. # [HTTP](#tab/http) <!-- { Content-type: application/json ] } ```-### Example 3: Request a package and provide a justification -#### Request ++### Example 4: Request a package and provide a justification The following example shows how to request an access package and provide justification to the approver.- +#### Request +The following example shows a request. # [HTTP](#tab/http) <!-- { Content-type: application/json The following example shows the response. -> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call. +> **Note:** The response object shown here might be shortened for readability. All the properties are returned from an actual call. <!-- { "blockType": "response", Content-type: application/json } ``` -### Example 4: Remove an assignment --To remove assignments, create a new accessPackageAssignmentRequest object with the following settings: --+ The value of the **requestType** property set to `AdminRemove`. -+ In the accessPackageAssignment property, include an object with the identifier of the accessPackageAssignment objects to delete. +### Example 5: Admin requests a direct assignment for a user not yet in the directory #### Request -The following example shows how to remove an assignment. --+The following example shows a request for a direct assignment, in which the administrator requests the creation of an assignment for a user who doesn't exist in the directory. The value of the **accessPackageId** is the desired access package for that user, and the value of **assignmentPolicyId** is a direct assignment policy in that access package. # [HTTP](#tab/http) <!-- { "blockType": "request",- "name": "create_accesspackageassignmentrequest_from_accesspackageassignmentrequests_remove_assignment" + "name": "create_accesspackageassignmentrequest_from_accesspackageassignmentrequests_direct_assignment" }--> ```http POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/a Content-type: application/json {- "requestType": "AdminRemove", - "accessPackageAssignment":{ - "id": "a6bb6942-3ae1-4259-9908-0133aaee9377" - } + "requestType": "AdminAdd", + "accessPackageAssignment":{ + "target": { + "email": "user@contoso.com" + }, + "assignmentPolicyId":"2264bf65-76ba-417b-a27d-54d291f0cbc8", + "accessPackageId":"a914b616-e04e-476b-aa37-91038f0b165b" + } } ``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [CLI](#tab/cli) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] Content-type: application/json The following example shows the response. -> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call. +> **Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", HTTP/1.1 201 Created Content-type: application/json {- "@odata.context": "https://graph.microsoft.com/beta/$metadata#accessPackageAssignmentRequests/$entity", -- "id": "78eaee8c-e6cf-48c9-8f99-aae44c35e379", - "requestType": "AdminRemove", - "requestState": "Submitted", - "requestStatus": "Accepted" + "id": "7e382d02-4454-436b-b700-59c7dd77f466", + "requestType": "AdminAdd", + "requestState": "Submitted", + "requestStatus": "Accepted", + "isValidationOnly": false } ``` -### Example 5: Admin requests a direct assignment for a user not yet in the directory -#### Request +### Example 6: Request an update to answers for an assignment -The following example shows a request for a direct assignment, in which the administrator is requesting the creation of an assignment for the user, for a user who does not exist in the directory. The value of the **accessPackageId** is the desired access package for that user, and the value of **assignmentPolicyId** is a direct assignment policy in that access package. +The following example shows how an admin can request updates to an assignment to edit their responses to questions that were answered during the request for the assignment. +#### Request ++The following example shows a request. # [HTTP](#tab/http) <!-- { "blockType": "request",- "name": "create_accesspackageassignmentrequest_from_accesspackageassignmentrequests_direct_assignment" + "name": "update_accesspackageassignmentrequest_from_accesspackageassignmentrequests_requestor_answer_to_approver" }-->- ```http POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignmentRequests Content-type: application/json {- "requestType": "AdminAdd", - "accessPackageAssignment":{ - "target": { - "email": "user@contoso.com" - }, - "assignmentPolicyId":"2264bf65-76ba-417b-a27d-54d291f0cbc8", - "accessPackageId":"a914b616-e04e-476b-aa37-91038f0b165b" - } + "@odata.type": "#microsoft.graph.accessPackageAssignmentRequest", + "id": "7a6ab703-0780-4b37-8445-81f679b2d75c", + "requestType": "adminUpdate", + "answers": [ + { + "@odata.type": "#microsoft.graph.accessPackageAnswerString", + "value": "UpdatedAnswerValue", + "answeredQuestion": { + "@odata.type": "#microsoft.graph.accessPackageMultipleChoiceQuestion", + "id": "8fe745e7-80b2-490d-bd22-4e708c77288c" + } + }, + { + "@odata.type": "#microsoft.graph.accessPackageAnswerString", + "value": "My updated answer.", + "displayValue": "This is my updated answer to the question.", + "answeredQuestion": { + "@odata.type": "#microsoft.graph.accessPackageTextInputQuestion", + "id": "7aaa18c9-8e4f-440f-bd5a-3a7ce312cbe6" + } + } + ], + "assignment": { + "id": "44c741c1-2cf4-40db-83b6-e0112f8e5a83" + } } ``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [CLI](#tab/cli) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] Content-type: application/json The following example shows the response. -> **Note:** The response object shown here might be shortened for readability. +> **Note:** The response object shown here might be shortened for readability. All the properties are returned from an actual call. <!-- { "blockType": "response", HTTP/1.1 201 Created Content-type: application/json {-- "id": "7e382d02-4454-436b-b700-59c7dd77f466", - "requestType": "AdminAdd", - "requestState": "Submitted", - "requestStatus": "Accepted", - "isValidationOnly": false + "@odata.context": "https://graph.microsoft.com/beta/$metadata#accessPackageAssignmentRequests/$entity", + "id": "0c471116-e439-40a6-8441-fe739dd48dab", + "requestType": "adminUpdate", + "state": "submitted", + "status": "Accepted", + "createdDateTime": null, + "completedDateTime": null, + "schedule": { + "startDateTime": null, + "recurrence": null, + "expiration": { + "endDateTime": null, + "duration": null, + "type": "notSpecified" + } + }, + "answers": [ + { + "@odata.type": "#microsoft.graph.accessPackageAnswerString", + "value": "UpdatedAnswerValue", + "displayValue": "This is the answer to a multiple choice question", + "answeredQuestion": { + "@odata.type": "#microsoft.graph.accessPackageMultipleChoiceQuestion", + "id": "8fe745e7-80b2-490d-bd22-4e708c77288c" + } + }, + { + "@odata.type": "#microsoft.graph.accessPackageAnswerString", + "value": "My updated answer.", + "displayValue": "This is my updated answer to the question.", + "answeredQuestion": { + "@odata.type": "#microsoft.graph.accessPackageTextInputQuestion", + "id": "7aaa18c9-8e4f-440f-bd5a-3a7ce312cbe6" + } + } + ] } ``` - <!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98 2019-02-04 14:57:30 UTC --> <!-- { |
v1.0 | Entitlementmanagement Post Assignmentrequests | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/entitlementmanagement-post-assignmentrequests.md | If this is an `adminAdd` request, then subsequently an [accessPackageAssignment] ## Examples ### Example 1: Admin requests a direct assignment for a user already in the directory+ #### Request -The following example shows a request for a direct assignment, in which the administrator is requesting the creation of an assignment for the user. Because the [accessPackageSubject](../resources/accesspackagesubject.md) might not yet exist, the value of the **targetID** is the object ID of the user being assigned, the value of the **accessPackageId** is the desired access package for that user, and the value of **assignmentPolicyId** is a direct assignment policy in that access package. +The following example shows a request for a direct assignment, in which the administrator requests the creation of an assignment for a user. Because the [accessPackageSubject](../resources/accesspackagesubject.md) might not yet exist, the value of the **targetID** is the object ID of the user being assigned, the value of the **accessPackageId** is the desired access package for that user, and the value of **assignmentPolicyId** is a direct assignment policy in that access package. # [HTTP](#tab/http) <!-- { HTTP/1.1 201 Created Content-type: application/json {-- "id": "7e382d02-4454-436b-b700-59c7dd77f466", + "id": "46184453-e63b-4f20-86c2-c557ed5d5df9", "requestType": "adminAdd", "requestState": "Submitted", "requestStatus": "Accepted" Content-type: application/json ### Example 2: Remove an assignment -To remove assignments, create a new accessPackageAssignmentRequest object with the following settings: +To remove assignments, create a new **accessPackageAssignmentRequest** object with the following settings: -+ The value of the **requestType** property set to `adminRemove`. -+ In the assignment property, include an object with the identifier of the accessPackageAssignment object to delete. +* The value of the **requestType** property set to `adminRemove`. +* In the **assignment** property, include an object with the identifier of the **accessPackageAssignment** object to delete. #### Request Content-type: application/json The following example shows the response. -> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call. +> **Note:** The response object shown here might be shortened for readability. All the properties are returned from an actual call. <!-- { "blockType": "response", HTTP/1.1 201 Created Content-type: application/json {- "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#accessPackageAssignmentRequests/$entity", -+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#accessPackageAssignmentRequests/$entity", "id": "78eaee8c-e6cf-48c9-8f99-aae44c35e379", "requestType": "adminRemove", "requestState": "Submitted", Content-type: application/json } ``` -### Example 3: Request an assignment +### Example 3: Request an assignment by providing answers to questions -The following example shows how a user can request an access package assignment for themselves. +The following example shows how a user can request an access package assignment for themselves by answering questions required by the policy during the request process. #### Request +The following example shows a request. + # [HTTP](#tab/http) <!-- { "blockType": "request",- "name": "create_accesspackageassignmentrequest_from_accesspackageassignmentrequests_packageID" + "name": "create_accesspackageassignmentrequest_from_accesspackageassignmentrequests_requestor_answer_approver" }-->+ ```http POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/assignmentRequests Content-type: application/json {+ "@odata.type": "#microsoft.graph.accessPackageAssignmentRequest", "requestType": "userAdd",+ "answers": [ + { + "@odata.type": "#microsoft.graph.accessPackageAnswerString", + "displayValue": "This is the answer to a multiple choice question", + "value": "MultipleChoiceAnswerValue", + "answeredQuestion": { + "@odata.type": "#microsoft.graph.accessPackageMultipleChoiceQuestion", + "id": "8fe745e7-80b2-490d-bd22-4e708c77288c" + } + }, + { + "@odata.type": "#microsoft.graph.accessPackageAnswerString", + "value": "This is my answer to a text input question.", + "displayValue": "This is my answer.", + "answeredQuestion": { + "@odata.type": "#microsoft.graph.accessPackageTextInputQuestion", + "id": "7aaa18c9-8e4f-440f-bd5a-3a7ce312cbe6" + } + } + ], "assignment": {- "accessPackageId": "d7be3253-b9c6-4fab-adef-30d30de8da2b" + "accessPackageId": "977c7ff4-ef8f-4910-9d31-49048ddf3120" } } ``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [CLI](#tab/cli) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] Content-type: application/json The following example shows the response. -> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call. +> **Note:** The response object shown here might be shortened for readability. All the properties are returned from an actual call. <!-- { "blockType": "response", HTTP/1.1 201 Created Content-type: application/json {- "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identityGovernance/entitlementManagement/assignmentRequests/$entity", - "id": "724bc62d-90ff-48f3-903f-b59ec8453343", + "@odata.context": "https://graph.microsoft.com/beta/$metadata#accessPackageAssignmentRequests/$entity", + "id": "7a6ab703-0780-4b37-8445-81f679b2d75c", "requestType": "userAdd",- "state": "submitted" + "state": "submitted", + "status": "Accepted", + "createdDateTime": null, + "completedDateTime": null, + "schedule": { + "startDateTime": null, + "recurrence": null, + "expiration": { + "endDateTime": null, + "duration": null, + "type": "notSpecified" + } + }, + "answers": [ + { + "@odata.type": "#microsoft.graph.accessPackageAnswerString", + "value": "MultipleChoiceAnswerValue", + "answeredQuestion": { + "@odata.type": "#microsoft.graph.accessPackageMultipleChoiceQuestion", + "id": "8fe745e7-80b2-490d-bd22-4e708c77288c" + }, + "displayValue": "This is the answer to a multiple choice question" + }, + { + "@odata.type": "#microsoft.graph.accessPackageAnswerString", + "value": "This is my answer to a text input question.", + "answeredQuestion": { + "@odata.type": "#microsoft.graph.accessPackageTextInputQuestion", + "id": "7aaa18c9-8e4f-440f-bd5a-3a7ce312cbe6" + }, + "displayValue": "This is my answer." + } + ] } ``` -### Example 4: Request an assignment by providing answers to questions +### Example 4: Request a package and provide a justification -The following example shows how a user can request an access package assignment for themselves by answering questions required by the policy while making the request. +The following example shows how to request an access package and provide justification to the approver. #### Request +The following example shows a request. + # [HTTP](#tab/http) <!-- { "blockType": "request",- "name": "create_accesspackageassignmentrequest_from_accesspackageassignmentrequests_requestor_answer_approver" + "name": "create_assignmentrequests_from_assignmentrequests_justification_provided" }--> ```http POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/a Content-type: application/json {- "@odata.type": "#microsoft.graph.accessPackageAssignmentRequest", - "requestType": "userAdd", - "answers": [ - { - "@odata.type": "#microsoft.graph.accessPackageAnswerString", - "displayValue": "This is the answer to a multiple choice question", - "value": "MultipleChoiceAnswerValue", - "answeredQuestion": { - "@odata.type": "#microsoft.graph.accessPackageMultipleChoiceQuestion", - "id": "8fe745e7-80b2-490d-bd22-4e708c77288c" - } - }, - { - "@odata.type": "#microsoft.graph.accessPackageAnswerString", - "value": "This is my answer to a text input question.", - "displayValue": "This is my answer.", - "answeredQuestion": { - "@odata.type": "#microsoft.graph.accessPackageTextInputQuestion", - "id": "7aaa18c9-8e4f-440f-bd5a-3a7ce312cbe6" - } - } - ], - "assignment": { - "accessPackageId": "977c7ff4-ef8f-4910-9d31-49048ddf3120" - } + "requestType": "UserAdd", + "accessPackageAssignment": { + "accessPackageId": "a914b616-e04e-476b-aa37-91038f0b165b" + }, + "justification":"Need access to New Hire access package" } ``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [CLI](#tab/cli) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] Content-type: application/json The following example shows the response. -> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call. +> **Note:** The response object shown here might be shortened for readability. All the properties are returned from an actual call. <!-- { "blockType": "response", HTTP/1.1 201 Created Content-type: application/json {- "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#accessPackageAssignmentRequests/$entity", - "id": "7a6ab703-0780-4b37-8445-81f679b2d75c", - "requestType": "userAdd", - "state": "submitted", - "status": "Accepted", + "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/entitlementManagement/assignmentRequests/$entity", + "id": "9c1e258d-7723-43b1-ae21-e6eeeb324fe5", + "requestType": "UserAdd", + "requestState": "Submitted", + "requestStatus": "Accepted", "createdDateTime": null,- "completedDateTime": null, + "completedDate": null, + "justification": "Need access to New Hire access package", + "isValidationOnly": false, "schedule": { "startDateTime": null, "recurrence": null, Content-type: application/json "type": "notSpecified" } },- "answers": [ - { - "@odata.type": "#microsoft.graph.accessPackageAnswerString", - "value": "MultipleChoiceAnswerValue", - "answeredQuestion": { - "@odata.type": "#microsoft.graph.accessPackageMultipleChoiceQuestion", - "id": "8fe745e7-80b2-490d-bd22-4e708c77288c" - }, - "displayValue": "This is the answer to a multiple choice question" - }, - { - "@odata.type": "#microsoft.graph.accessPackageAnswerString", - "value": "This is my answer to a text input question.", - "answeredQuestion": { - "@odata.type": "#microsoft.graph.accessPackageTextInputQuestion", - "id": "7aaa18c9-8e4f-440f-bd5a-3a7ce312cbe6" - }, - "displayValue": "This is my answer." + "answers": [], + "verifiedCredentialsData": [], + "customExtensionHandlerInstances": [], + "customExtensionCalloutInstances": [] +} +``` ++### Example 5: Admin requests a direct assignment for a user not yet in the directory ++#### Request ++The following example shows a request for a direct assignment, in which the administrator is requests the creation of an assignment for a user who doesn't exist in the directory. The value of the **accessPackageId** is the desired access package for that user, and the value of **assignmentPolicyId** is a direct assignment policy in that access package. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_assignmentrequest_from_assignmentrequests_direct_assignment" +}--> ++```http +POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/assignmentRequests +Content-type: application/json ++{ + "requestType": "AdminAdd", + "accessPackageAssignment":{ + "target": { + "email": "user@contoso.com" + }, + "assignmentPolicyId":"2264bf65-76ba-417b-a27d-54d291f0cbc8", + "accessPackageId":"a914b616-e04e-476b-aa37-91038f0b165b" + } +} +``` ++# [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. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.accessPackageAssignmentRequest" +} --> ++```http +HTTP/1.1 201 Created +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/entitlementManagement/assignmentRequests/$entity", + "id": "cb32aef9-2976-496d-9804-eb432fd894a7", + "requestType": "AdminAdd", + "requestState": "Submitted", + "requestStatus": "Accepted", + "createdDateTime": null, + "completedDate": null, + "justification": null, + "isValidationOnly": false, + "schedule": { + "startDateTime": null, + "recurrence": null, + "expiration": { + "endDateTime": null, + "duration": null, + "type": "notSpecified" }- ] + }, + "answers": [], + "verifiedCredentialsData": [], + "customExtensionHandlerInstances": [], + "customExtensionCalloutInstances": [] } ``` -### Example 5: Request an update to answers for an assignment +### Example 6: Request an update to answers for an assignment -The following example shows how an admin can request updates to an assignment to edit their responses to questions that were answered while requesting the assignment. +The following example shows how an admin can request updates to an assignment to edit their responses to questions that were answered during the request for the assignment. #### Request +The following example shows a request. + # [HTTP](#tab/http) <!-- { "blockType": "request",- "name": "update_accesspackageassignmentrequest_from_accesspackageassignmentrequests_requestor_answer_to_approver" + "name": "update_accesspackageassignmentrequest_from_assignmentrequests_requestor_answer_to_approver" }--> ```http POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/assignmentRequests Content-type: application/json ``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [CLI](#tab/cli) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] Content-type: application/json The following example shows the response. -> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call. +> **Note:** The response object shown here might be shortened for readability. All the properties are returned from an actual call. <!-- { "blockType": "response", HTTP/1.1 201 Created Content-type: application/json {- "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#accessPackageAssignmentRequests/$entity", + "@odata.context": "https://graph.microsoft.com/beta/$metadata#accessPackageAssignmentRequests/$entity", "id": "0c471116-e439-40a6-8441-fe739dd48dab", "requestType": "adminUpdate", "state": "submitted", Content-type: application/json ] } ```++<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98 +2019-02-04 14:57:30 UTC --> +<!-- { + "type": "#page.annotation", + "description": "Create accessPackageAssignmentRequest", + "keywords": "", + "section": "documentation", + "tocPath": "" +}--> |
v1.0 | Extensionproperty Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/extensionproperty-delete.md | Title: "Delete extensionProperty (directory extension)" description: "Delete a directory extension definition." ms.localizationpriority: medium + doc_type: "apiPageType" |
v1.0 | Extensionproperty Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/extensionproperty-get.md | Title: "Get extensionProperty (directory extension)" description: "Read a directory extension definition." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Externalauthenticationmethodconfiguration Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externalauthenticationmethodconfiguration-delete.md | + + Title: "Delete externalAuthenticationMethodConfiguration" +description: "Delete an externalAuthenticationMethodConfiguration object." ++ms.localizationpriority: medium ++++# Delete externalAuthenticationMethodConfiguration ++Namespace: microsoft.graph +++Delete an [externalAuthenticationMethodConfiguration](../resources/externalauthenticationmethodconfiguration.md) object. +++## 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": "externalauthenticationmethodconfiguration-delete-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/{id} +``` ++## 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 `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_externalauthenticationmethodconfiguration" +} +--> +``` http +DELETE https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/b3107ab7-68c7-4553-a167-48c1e9c24d52 +``` ++# [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. +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Externalauthenticationmethodconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externalauthenticationmethodconfiguration-get.md | + + Title: "Get externalAuthenticationMethodConfiguration" +description: "Read the properties and relationships of an externalAuthenticationMethodConfiguration object." ++ms.localizationpriority: medium ++++# Get externalAuthenticationMethodConfiguration ++Namespace: microsoft.graph +++Read the properties and relationships of an [externalAuthenticationMethodConfiguration](../resources/externalauthenticationmethodconfiguration.md) object. +++## 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": "externalauthenticationmethodconfiguration-get-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/{id} +``` ++## Optional query parameters ++This method does not support 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 an [externalAuthenticationMethodConfiguration](../resources/externalauthenticationmethodconfiguration.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_externalauthenticationmethodconfiguration" +} +--> +``` http +GET https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/b3107ab7-68c7-4553-a167-48c1e9c24d52 +``` ++# [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. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.externalAuthenticationMethodConfiguration" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.externalAuthenticationMethodConfiguration", + "id": "b3107ab7-68c7-4553-a167-48c1e9c24d52", + "displayName": "Adatum", + "appId": "fb262304-618c-4ffb-878a-114490bdf200", + "openIdConnectSetting": { + "clientId": "06a011bd-ec92-4404-80fb-db6d5ada8ee2", + "discoveryUrl": "https//Adatum.com/.well-known/openid-configuration" + }, + "state": "disabled", + "excludeTargets": [], + "includeTargets": [] +} +``` + |
v1.0 | Externalauthenticationmethodconfiguration Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externalauthenticationmethodconfiguration-update.md | + + Title: "Update externalAuthenticationMethodConfiguration" +description: "Update the properties of an externalAuthenticationMethodConfiguration object." ++ms.localizationpriority: medium ++++# Update externalAuthenticationMethodConfiguration ++Namespace: microsoft.graph +++Update the properties of an [externalAuthenticationMethodConfiguration](../resources/externalauthenticationmethodconfiguration.md) object. +++## 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": "externalauthenticationmethodconfiguration-update-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/{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 ++++|Property|Type|Description| +|:|:|:| +|state|authenticationMethodState|The state of the method in the policy. The possible values are: `enabled`, `disabled`. | +|excludeTargets|[excludeTarget](../resources/excludetarget.md) collection|Groups representing the users that should be excluded from the policy. | +|appId|String|**appId** for the app registration in Microsoft Entra ID representing the integration with the external provider.| +|openIdConnectSetting|[openIdConnectSetting](../resources/openidconnectsetting.md)|Object representing the required settings for the OIDC request to the external provider.| ++++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_externalauthenticationmethodconfiguration" +} +--> +``` http +PATCH https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/b183b746-e7db-4fa2-bafc-69ecf18850dd +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.externalAuthenticationMethodConfiguration", + "includeTargets": [ + { + "targetType": "group", + "id": "b183b746-e7db-4fa2-bafc-69ecf18850dd", + "isRegistrationRequired": false, + } + ], + "state": "enabled" +} ++``` ++# [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. +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Externalconnectors External List Authorizationsystems | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externalconnectors-external-list-authorizationsystems.md | description: "List the authorizationSystem objects and their properties." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Externallyaccessibleawsstoragebucketfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externallyaccessibleawsstoragebucketfinding-get.md | description: "Read the properties and relationships of an externallyAccessibleAw ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Externallyaccessibleawsstoragebucketfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externallyaccessibleawsstoragebucketfinding-list.md | description: "Get a list of the externallyAccessibleAwsStorageBucketFinding obje ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Externallyaccessibleazureblobcontainerfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externallyaccessibleazureblobcontainerfinding-get.md | description: "Read the properties and relationships of an externallyAccessibleAz ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Externallyaccessibleazureblobcontainerfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externallyaccessibleazureblobcontainerfinding-list.md | description: "Get a list of the externallyAccessibleAzureBlobContainerFinding ob ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Externallyaccessiblegcpstoragebucketfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externallyaccessiblegcpstoragebucketfinding-get.md | description: "Read the properties and relationships of an externallyAccessibleGc ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Externallyaccessiblegcpstoragebucketfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externallyaccessiblegcpstoragebucketfinding-list.md | description: "Get a list of the externallyAccessibleGcpStorageBucketFinding obje ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Externaluserprofile Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externaluserprofile-get.md | GET https://graph.microsoft.com/beta/directory/externalUserProfiles/{id} [!INCLUDE [sample-code](../includes/snippets/php/get-externaluserprofile-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-externaluserprofile-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Externaluserprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externaluserprofile-update.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/update-externaluserprofile-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/update-externaluserprofile-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Federatedidentitycredential Upsert | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/federatedidentitycredential-upsert.md | Namespace: microsoft.graph Create a new [federatedIdentityCredential](../resources/federatedidentitycredential.md) object for an application if it does exist, or update the properties of an existing [federatedIdentityCredential](../resources/federatedidentitycredential.md) object. By [configuring a trust relationship](/azure/active-directory/develop/workload-identity-federation-create-trust) between your Microsoft Entra application registration and the identity provider for your compute platform, you can use tokens issued by that platform to authenticate with Microsoft identity platform and call APIs in the Microsoft ecosystem. Maximum of 20 objects can be added to an application. + ## 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). |
v1.0 | Federatedtokenvalidationpolicy Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/federatedtokenvalidationpolicy-get.md | Namespace: microsoft.graph Read the properties and relationships of a [federatedTokenValidationPolicy](../resources/federatedtokenvalidationpolicy.md) object. + ## 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). Choose the permission or permissions marked as least privileged for this API. Us --> [!INCLUDE [permissions-table](../includes/permissions/federatedtokenvalidationpolicy-get-permissions.md)] + ## HTTP request <!-- { |
v1.0 | Federatedtokenvalidationpolicy Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/federatedtokenvalidationpolicy-update.md | Choose the permission or permissions marked as least privileged for this API. Us --> [!INCLUDE [permissions-table](../includes/permissions/federatedtokenvalidationpolicy-update-permissions.md)] + ## HTTP request <!-- { |
v1.0 | Gcpassociatedidentities List All | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/gcpassociatedidentities-list-all.md | description: "Get a list of the gcpIdentity objects and their properties." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Gcpassociatedidentities List Serviceaccounts | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/gcpassociatedidentities-list-serviceaccounts.md | description: "Get a list of the gcpServiceAccount objects and their properties." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Gcpassociatedidentities List Users | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/gcpassociatedidentities-list-users.md | description: "Get a list of the gcpUser objects and their properties." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Gcpauthorizationsystem List Actions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/gcpauthorizationsystem-list-actions.md | description: "List the gcpAuthorizationSystemTypeAction objects and their proper ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Gcpauthorizationsystem List Resources | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/gcpauthorizationsystem-list-resources.md | description: "List the gcpAuthorizationSystemResource objects and their properti ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Gcpauthorizationsystem List Roles | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/gcpauthorizationsystem-list-roles.md | description: "List all GCP roles in a GCP authorization system." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Gcpauthorizationsystem List Services | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/gcpauthorizationsystem-list-services.md | description: "Get all services in a GCP authorization system." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Gcpauthorizationsystem List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/gcpauthorizationsystem-list.md | description: "Get a list of the gcpAuthorizationSystem objects and their propert ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Gcpauthorizationsystemresource Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/gcpauthorizationsystemresource-get.md | description: "Read the properties and relationships of a gcpAuthorizationSystemR ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Gcpauthorizationsystemtypeaction Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/gcpauthorizationsystemtypeaction-get.md | description: "Read the properties and relationships of a gcpAuthorizationSystemT ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Gcpidentity Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/gcpidentity-get.md | description: "Read the properties and relationships of a gcpIdentity object." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Gcprole Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/gcprole-get.md | description: "Get a GCP role in a GCP authorization system." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Gcpserviceaccount Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/gcpserviceaccount-get.md | description: "Read the properties and relationships of a gcpServiceAccount objec ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Gcpuser Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/gcpuser-get.md | description: "Read the properties and relationships of a gcpUser object." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Group Assignlicense | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-assignlicense.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "group_assignlicense" } --> [!INCLUDE [permissions-table](../includes/permissions/group-assignlicense-permissions.md)] -For delegated scenarios, the calling user needs one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). +For delegated scenarios, the calling user needs at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). - Directory Writers - Groups Administrator - License Administrator - User Administrator-- Global Administrator ## HTTP request |
v1.0 | Group Delete Acceptedsenders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-delete-acceptedsenders.md | DELETE https://graph.microsoft.com/beta/groups/{id}/acceptedSenders/$ref?$id=htt [!INCLUDE [sample-code](../includes/snippets/php/remove-user-from-acceptedsenderslist-of-group-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/remove-user-from-acceptedsenderslist-of-group-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] DELETE https://graph.microsoft.com/beta/groups/{id}/acceptedSenders/$ref?$id=htt [!INCLUDE [sample-code](../includes/snippets/php/remove-group-from-acceptedsenderslist-of-group-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/remove-group-from-acceptedsenderslist-of-group-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Group Delete Rejectedsenders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-delete-rejectedsenders.md | DELETE https://graph.microsoft.com/beta/groups/{id}/rejectedSenders/$ref?$id=htt [!INCLUDE [sample-code](../includes/snippets/php/remove-user-from-rejectedsenderslist-of-group-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/remove-user-from-rejectedsenderslist-of-group-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] DELETE https://graph.microsoft.com/beta/groups/{id}/rejectedSenders/$ref?$id=htt [!INCLUDE [sample-code](../includes/snippets/php/remove-group-from-rejectedsenderslist-of-group-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/remove-group-from-rejectedsenderslist-of-group-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Group Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-delete.md | Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/group-delete-permissions.md)] The following conditions apply for apps to delete role-assignable groups:-+ For delegated scenarios, the app must be assigned the _RoleManagement.ReadWrite.Directory_ delegated permission, and the calling user must be the creator of the group or a global administrator or a privileged role administrator. -+ For app-only scenarios, the calling app must be the owner of the group or be assigned the _RoleManagement.ReadWrite.Directory_ application permission or be assigned the Global Administrator or Privileged Role Administrator Microsoft Entra role. ++ For delegated scenarios, the app must be assigned the _RoleManagement.ReadWrite.Directory_ delegated permission, and the calling user must be the creator of the group or a privileged role administrator.++ For app-only scenarios, the calling app must be the owner of the group or be assigned the _RoleManagement.ReadWrite.Directory_ application permission or be assigned the Privileged Role Administrator Microsoft Entra role. ## HTTP request |
v1.0 | Group Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-update.md | The following table specifies the properties that can be updated. | mailNickname | String | The mail alias for the group, unique for Microsoft 365 groups in the organization. Maximum length is 64 characters. This property can contain only characters in the [ASCII character set 0 - 127](/office/vba/language/reference/user-interface-help/character-set-0127) except the following: ` @ () \ [] " ; : . <> , SPACE`. | | preferredDataLocation | String | The preferred data location for the Microsoft 365 group. To update this property, the calling user must be assigned one of the following Microsoft Entra roles: <br><ul><li> Global Administrator <li> User Account Administrator <li> Directory Writer <li> Exchange Administrator <li> SharePoint Administrator </ul> <br/>For more information about this property, see [OneDrive Online Multi-Geo](/sharepoint/dev/solution-guidance/multigeo-introduction). | | securityEnabled | Boolean | Specifies whether the group is a security group, including Microsoft 365 groups. |+| uniqueName | String | The unique identifier that can be assigned to a group and used as an alternate key. Can updated only if `null` and is immutable once set. | | visibility | String | Specifies the visibility of a Microsoft 365 group. Possible values are: **Private**, **Public**, or empty (which is interpreted as **Public**). | | writebackConfiguration | [groupWritebackConfiguration](../resources/groupwritebackconfiguration.md) | Specifies whether or not a group is configured to write back group object properties to on-premise Active Directory. These properties are used when group writeback is configured in the [Microsoft Entra Connect](/azure/active-directory/hybrid/how-to-connect-group-writeback-v2) sync client.| |
v1.0 | Group Upsert | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-upsert.md | You can create or update the following types of group: - Microsoft 365 group (unified group) - Security group - By default, this operation returns only a subset of the properties for each group. For a list of properties that are returned by default, see thethe [Properties](../resources/group.md#properties) section of the [group](../resources/group.md) resource. To get properties that are _not_ returned by default, do a [GET operation](group-get.md) and specify the properties in a `$select` OData query option. + By default, this operation returns only a subset of the properties for each group. For a list of properties that are returned by default, see the [Properties](../resources/group.md#properties) section of the [group](../resources/group.md) resource. To get properties that are _not_ returned by default, do a [GET operation](group-get.md) and specify the properties in a `$select` OData query option. -**Note**: To create a [team](../resources/team.md), first create a group then add a team to it, see [create team](../api/team-put-teams.md). +> **Note**: To create a [team](../resources/team.md), first create a group, and then add a team to it. For more information, see [Create team](../api/team-put-teams.md). ## Permissions The following table lists the properties that are required when you create the [ | Property | Type | Description | | :-- | : | :-- |-| displayName | string | The name to display in the address book for the group. Maximum length is 256 characters. Required. | -| mailEnabled | boolean | Set to `true` for mail-enabled groups. Required. | -| mailNickname | string | The mail alias for the group, unique for Microsoft 365 groups in the organization. Maximum length is 64 characters. This property can contain only characters in the [ASCII character set 0 - 127](/office/vba/language/reference/user-interface-help/character-set-0127) except the following: ` @ () \ [] " ; : <> , SPACE`. Required. | -| securityEnabled | boolean | Set to `true` for security-enabled groups, including Microsoft 365 groups. Required. **Note:** Groups created using the Microsoft Entra admin center or the Azure portal always have **securityEnabled** initially set to `true`. | +| displayName | String | The name to display in the address book for the group. Maximum length is 256 characters. Required. | +| mailEnabled | Boolean | Set to `true` for mail-enabled groups. Required. | +| mailNickname | String | The mail alias for the group, unique for Microsoft 365 groups in the organization. Maximum length is 64 characters. This property can contain only characters in the [ASCII character set 0 - 127](/office/vba/language/reference/user-interface-help/character-set-0127) except the following: ` @ () \ [] " ; : <> , SPACE`. Required. | +| securityEnabled | Boolean | Set to `true` for security-enabled groups, including Microsoft 365 groups. Required. **Note:** Groups created using the Microsoft Entra admin center or the Azure portal always have **securityEnabled** initially set to `true`. | > [!IMPORTANT]-> > - Creating a group using the **Group.Create** application permission without specifying owners will create the group anonymously and the group will not be modifiable. Add owners to the group while creating it to specify owners who can modify the group.-> > - Creating a Microsoft 365 group programmatically with an app-only context and without specifying owners will create the group anonymously. Doing so can result in the associated SharePoint Online site not being created automatically until further manual action is taken.-> -> - To following properties can't be set in the initial POST request and must be set in a subsequent PATCH request: **allowExternalSenders**, **autoSubscribeNewMembers**, **hideFromAddressLists**, **hideFromOutlookClients**, **isSubscribedByMail**, **unseenCount**. +> - The following properties can't be set in the initial POST request and must be set in a subsequent PATCH request: **allowExternalSenders**, **autoSubscribeNewMembers**, **hideFromAddressLists**, **hideFromOutlookClients**, **isSubscribedByMail**, **unseenCount**. Because the **group** resource supports [extensions](/graph/extensibility-overview), you can add custom properties with your own data to the group while creating it. Content-type: application/json ### Example 2: Create a security group with an owner and members if it doesn't exist -The following example creates a security group with an owner and members specified because a group with the specified **uniqueName** value does not exist. Note that a maximum of 20 relationships, such as owners and members, can be added as part of group creation. You can subsequently add multiple additional members by using [add member](/graph/api/group-post-members?view=graph-rest-beta&preserve-view=true) API or JSON batching. +The following example creates a security group with an owner and members specified because a group with the specified **uniqueName** value does not exist. Note that a maximum of 20 relationships, such as owners and members, can be added as part of group creation. You can subsequently add multiple additional members by using the [add member](/graph/api/group-post-members?view=graph-rest-beta&preserve-view=true) API or JSON batching. #### Request The following example shows the response. The value of the **preferredDataLocati HTTP/1.1 204 No Content ``` -## See also +## Related content - [Add custom data to resources using extensions](/graph/extensibility-overview) - [Add custom data to users using open extensions (preview)](/graph/extensibility-open-users) |
v1.0 | Horizontalsection Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/horizontalsection-delete.md | DELETE /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/ho ## Request body -Do not supply a request body with this method. +Don't supply a request body with this method. ## Response If the target horizontal section is not found, this method returns `404 Not Foun <!-- { "blockType": "ignored" } --> ``` http-DELETE https://graph.microsoft.com/beta/sites/{sitesId}/pages/{sitePageId}/microsoft.graph.sitePage/canvasLayout/horizontalSections/{horizontalSectionId} +DELETE https://graph.microsoft.com/beta/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/horizontalSections/1 ``` -ve ### Response <!-- { "blockType": "response" } --> |
v1.0 | Horizontalsection Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/horizontalsection-get.md | The following example shows a request. <!-- { "blockType": "ignored" } --> ``` http-GET https://graph.microsoft.com/beta/sites/{sitesId}/pages/{sitePageId}/microsoft.graph.sitePage/canvasLayout/horizontalSections/{horizontalSectionId} +GET https://graph.microsoft.com/beta/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/horizontalSections/1 ``` #### Response Content-Type: application/json ### Example 2: Get a horizontalSection object using select and expand #### Request -With `select` and `expand` statements, you can retrieve horizontalSection metadata and column information in a single request. +With `$select` and `$expand` statements, you can retrieve horizontalSection metadata and column information in a single request. <!-- { "blockType": "ignored" } --> ``` http-GET https://graph.microsoft.com/beta/sites/{sitesId}/pages/{sitePageId}/microsoft.graph.sitePage/canvasLayout/horizontalSections/{horizontalSectionId}?select=id,expand=columns +GET https://graph.microsoft.com/beta/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/horizontalSections/1?$select=id&$expand=columns ``` #### Response |
v1.0 | Horizontalsection List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/horizontalsection-list.md | The following example shows a request. <!-- { "blockType": "ignored" } --> ``` http-GET https://graph.microsoft.com/beta/sites/{sitesId}/pages/{sitePageId}/microsoft.graph.sitePage/canvasLayout/horizontalSections +GET https://graph.microsoft.com/beta/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/horizontalSections ``` ### Response |
v1.0 | Horizontalsection Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/horizontalsection-update.md | The following example shows a request. <!-- { "blockType": "ignored" } --> ``` http-PATCH https://graph.microsoft.com/beta/sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/horizontalSections/{horizontalSectionId} +PATCH https://graph.microsoft.com/beta/sites/a69edae4-9208-4f60-9aa3-cd0911ff0ce1/pages/7f7a2740-2d74-47ba-af0c-71ed3a3384ca/microsoft.graph.sitePage/canvasLayout/horizontalSections/1 Content-Type: application/json |
v1.0 | Horizontalsectioncolumn Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/horizontalsectioncolumn-get.md | The following example shows a request. <!-- { "blockType": "ignored" } --> ```http-GET https://graph.microsoft.com/beta/sites/{sitesId}/pages/{sitePageId}/microsoft.graph.sitePage/canvasLayout/horizontalSections/{horizontalSectionId}/columns/{horizontalSectionColumnId} +GET https://graph.microsoft.com/beta/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/horizontalSections/1/columns/1 ``` #### Response Content-Type: application/json ### Example 2: Get a horizontalSectionColumn using select and expand #### Request -With `select` and `expand` statements, you can retrieve horizontalSectionColumn metadata and associated webParts in a single request. +With `$select` and `$expand` statements, you can retrieve horizontalSectionColumn metadata and associated webParts in a single request. <!-- { "blockType": "ignored" } --> ```http-GET https://graph.microsoft.com/beta/sites/{sitesId}/pages/{sitePageId}/microsoft.graph.sitePage/canvasLayout/horizontalSections/{horizontalSectionId}/columns/{horizontalSectionColumnId}?select=id,expand=webparts +GET https://graph.microsoft.com/beta/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/horizontalSections/1/columns/1?$select=id&$expand=webparts ``` #### Response |
v1.0 | Identityapiconnector Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identityapiconnector-create.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityapiconnector_create" } --> [!INCLUDE [permissions-table](../includes/permissions/identityapiconnector-create-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Identityapiconnector Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identityapiconnector-delete.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityapiconnector_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/identityapiconnector-delete-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Identityapiconnector Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identityapiconnector-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityapiconnector_get" } --> [!INCLUDE [permissions-table](../includes/permissions/identityapiconnector-get-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Identityapiconnector List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identityapiconnector-list.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityapiconnector_list" } --> [!INCLUDE [permissions-table](../includes/permissions/identityapiconnector-list-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Identityapiconnector Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identityapiconnector-update.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityapiconnector_update" } --> [!INCLUDE [permissions-table](../includes/permissions/identityapiconnector-update-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Identityapiconnector Uploadclientcertificate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identityapiconnector-uploadclientcertificate.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityapiconnector_uploadclientcertificate" } --> [!INCLUDE [permissions-table](../includes/permissions/identityapiconnector-uploadclientcertificate-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Identitycontainer List B2cuserflows | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitycontainer-list-b2cuserflows.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identitycontainer_list_b2cuserflows" } --> [!INCLUDE [permissions-table](../includes/permissions/identitycontainer-list-b2cuserflows-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Identitycontainer List B2xuserflows | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitycontainer-list-b2xuserflows.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identitycontainer_list_b2xuserflows" } --> [!INCLUDE [permissions-table](../includes/permissions/identitycontainer-list-b2xuserflows-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Identitycontainer List Identityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitycontainer-list-identityproviders.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identitycontainer_list_identityproviders" } --> [!INCLUDE [permissions-table](../includes/permissions/identitycontainer-list-identityproviders-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* External Identity Provider Administrator -* External ID user flow administrator ## HTTP request |
v1.0 | Identitycontainer Post Authenticationeventlisteners | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitycontainer-post-authenticationeventlisteners.md | Create a new [authenticationEventListener](../resources/authenticationeventliste - [onAttributeCollectionStartListener](../resources/onattributecollectionstartlistener.md) - [onAttributeCollectionSubmitListener](../resources/onattributecollectionsubmitlistener.md) +> [!NOTE] +> +> You can have a maximum of 250 event listeners. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] |
v1.0 | Identitycontainer Post B2cuserflows | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitycontainer-post-b2cuserflows.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identitycontainer_post_b2cuserflows" } --> [!INCLUDE [permissions-table](../includes/permissions/identitycontainer-post-b2cuserflows-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Identitycontainer Post B2xuserflows | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitycontainer-post-b2xuserflows.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identitycontainer_post_b2xuserflows" } --> [!INCLUDE [permissions-table](../includes/permissions/identitycontainer-post-b2xuserflows-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Identitycontainer Post Customauthenticationextensions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitycontainer-post-customauthenticationextensions.md | Create a new [customAuthenticationExtension](../resources/customauthenticationex - [onAttributeCollectionStartCustomExtension](../resources/onattributecollectionstartcustomextension.md) resource type. - [onAttributeCollectionSubmitCustomExtension](../resources/onattributecollectionsubmitcustomextension.md) resource type. +> [!NOTE] +> +> You can have a maximum of 100 custom extension policies. + [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions |
v1.0 | Identitycontainer Post Identityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitycontainer-post-identityproviders.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identitycontainer_post_identityproviders" } --> [!INCLUDE [permissions-table](../includes/permissions/identitycontainer-post-identityproviders-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Identitygovernance Lifecycleworkflowscontainer List Taskdefinitions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-lifecycleworkflowscontainer-list-taskdefinitions.md | Content-Type: application/json { "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/taskDefinitions",- "@odata.count": 16, + "@odata.count": 25, "value": [ {- "category": "joiner,leaver", + "category": "joiner,leaver,mover", "description": "Add user to selected groups",- "displayName": "Add User To Groups", + "displayName": "Add user to groups", "id": "22085229-5809-45e8-97fd-270d28d66910", "version": 1, "parameters": [ Content-Type: application/json { "category": "joiner,leaver", "description": "Disable user account in the directory",- "displayName": "Disable User Account", + "displayName": "Disable user account", "id": "1dfdfcc7-52fa-4c2e-bf3a-e3919cc12950", "version": 1,- "parameters": [] + "parameters": [ + { + "name": "disableOnPremisesAccount", + "values": [ + "true", + "false" + ], + "valueType": "enum" + } + ] }, { "category": "joiner,leaver", "description": "Enable user account in the directory",- "displayName": "Enable User Account", + "displayName": "Enable user account", "id": "6fc52c9d-398b-4305-9763-15f42c1676fc", "version": 1,- "parameters": [] + "parameters": [ + { + "name": "enableOnPremisesAccount", + "values": [ + "true", + "false" + ], + "valueType": "enum" + } + ] }, {- "category": "joiner,leaver", + "category": "joiner,leaver,mover", "description": "Remove user from membership of selected Azure AD groups", "displayName": "Remove user from selected groups", "id": "1953a66c-751c-45e5-8bfe-01462c70da3c", Content-Type: application/json { "category": "joiner", "description": "Generate Temporary Access Pass and send via email to user's manager",- "displayName": "Generate TAP And Send Email", + "displayName": "Generate TAP and send email", "id": "1b555e50-7f65-41d5-b514-5894a026d10d", "version": 1, "parameters": [ Content-Type: application/json "false" ], "valueType": "enum"+ }, + { + "name": "cc", + "values": [], + "valueType": "string" + }, + { + "name": "customSubject", + "values": [], + "valueType": "string" + }, + { + "name": "customBody", + "values": [], + "valueType": "string" + }, + { + "name": "locale", + "values": [], + "valueType": "string" } ] }, { "category": "joiner", "description": "Send welcome email to new hire",- "displayName": "Send Welcome Email", + "displayName": "Send welcome email", "id": "70b29d51-b59a-4773-9280-8841dfd3f2ea", "version": 1,- "parameters": [] + "parameters": [ + { + "name": "cc", + "values": [], + "valueType": "string" + }, + { + "name": "customSubject", + "values": [], + "valueType": "string" + }, + { + "name": "customBody", + "values": [], + "valueType": "string" + }, + { + "name": "locale", + "values": [], + "valueType": "string" + } + ] }, {- "category": "joiner,leaver", - "description": "Add user to selected teams", - "displayName": "Add User To Teams", + "category": "joiner,leaver,mover", + "description": "Add user to selected Teams", + "displayName": "Add user to Teams", "id": "e440ed8d-25a1-4618-84ce-091ed5be5594", "version": 1, "parameters": [ Content-Type: application/json { "category": "leaver", "description": "Delete user account in Azure AD",- "displayName": "Delete User Account", + "displayName": "Delete user account", "id": "8d18588d-9ad3-4c0f-99d0-ec215f0e3dff", "version": 1,- "parameters": [] + "parameters": [ + { + "name": "deleteOnPremisesAccount", + "values": [ + "true", + "false" + ], + "valueType": "enum" + } + ] }, {- "category": "joiner,leaver", + "category": "joiner,leaver,mover", "description": "Remove user from membership of selected Teams", "displayName": "Remove user from selected Teams", "id": "06aa7acb-01af-4824-8899-b14e5ed788d6", Content-Type: application/json "parameters": [] }, {- "category": "joiner,leaver", + "category": "joiner,leaver,mover", "description": "Run a Custom Task Extension to callout to an external system.", "displayName": "Run a Custom Task Extension", "id": "4262b724-8dba-4fad-afc3-43fcbb497a0e", Content-Type: application/json "displayName": "Send email before userΓÇÖs last day", "id": "52853a3e-f4e5-4eb8-bb24-1ac09a1da935", "version": 1,- "parameters": [] + "parameters": [ + { + "name": "cc", + "values": [], + "valueType": "string" + }, + { + "name": "customSubject", + "values": [], + "valueType": "string" + }, + { + "name": "customBody", + "values": [], + "valueType": "string" + }, + { + "name": "locale", + "values": [], + "valueType": "string" + } + ] }, { "category": "leaver", Content-Type: application/json "displayName": "Send email on userΓÇÖs last day", "id": "9c0a1eaf-5bda-4392-9d9e-6e155bb57411", "version": 1,- "parameters": [] + "parameters": [ + { + "name": "cc", + "values": [], + "valueType": "string" + }, + { + "name": "customSubject", + "values": [], + "valueType": "string" + }, + { + "name": "customBody", + "values": [], + "valueType": "string" + }, + { + "name": "locale", + "values": [], + "valueType": "string" + } + ] }, { "category": "leaver", Content-Type: application/json "displayName": "Send email after userΓÇÖs last day", "id": "6f22ddd4-b3a5-47a4-a846-0d7c201a49ce", "version": 1,+ "parameters": [ + { + "name": "cc", + "values": [], + "valueType": "string" + }, + { + "name": "customSubject", + "values": [], + "valueType": "string" + }, + { + "name": "customBody", + "values": [], + "valueType": "string" + }, + { + "name": "locale", + "values": [], + "valueType": "string" + } + ] + }, + { + "category": "joiner", + "description": "Send onboarding reminder email to userΓÇÖs manager", + "displayName": "Send onboarding reminder email", + "id": "3C860712-2D37-42A4-928F-5C93935D26A1", + "version": 1, + "parameters": [ + { + "name": "cc", + "values": [], + "valueType": "string" + }, + { + "name": "customSubject", + "values": [], + "valueType": "string" + }, + { + "name": "customBody", + "values": [], + "valueType": "string" + }, + { + "name": "locale", + "values": [], + "valueType": "string" + } + ] + }, + { + "category": "joiner,mover", + "description": "Request user assignment to selected access package", + "displayName": "Request user access package assignment", + "id": "c1ec1e76-f374-4375-aaa6-0bb6bd4c60be", + "version": 1, + "parameters": [ + { + "name": "assignmentPolicyId", + "values": [], + "valueType": "string" + }, + { + "name": "accessPackageId", + "values": [], + "valueType": "string" + } + ] + }, + { + "category": "leaver,mover", + "description": "Remove user assignment of selected access package", + "displayName": "Remove access package assignment for user", + "id": "4a0b64f2-c7ec-46ba-b117-18f262946c50", + "version": 1, + "parameters": [ + { + "name": "accessPackageId", + "values": [], + "valueType": "string" + } + ] + }, + { + "category": "leaver", + "description": "Remove all access packages assigned to the user", + "displayName": "Remove all access package assignments for user", + "id": "42ae2956-193d-4f39-be06-691b8ac4fa1d", + "version": 1, + "parameters": [] + }, + { + "category": "leaver", + "description": "Cancel all pending access packages assignment requests for the user", + "displayName": "Cancel pending access package assignment requests for user", + "id": "498770d9-bab7-4e4c-b73d-5ded82a1d0b3", + "version": 1, + "parameters": [] + }, + { + "category": "mover", + "description": "Send email to notify userΓÇÖs manager of user move", + "displayName": "Send email to notify manager of user move", + "id": "aab41899-9972-422a-9d97-f626014578b7", + "version": 1, + "parameters": [ + { + "name": "cc", + "values": [], + "valueType": "string" + }, + { + "name": "customSubject", + "values": [], + "valueType": "string" + }, + { + "name": "customBody", + "values": [], + "valueType": "string" + }, + { + "name": "locale", + "values": [], + "valueType": "string" + } + ] + }, + { + "category": "joiner,mover", + "description": "Assign selected licenses to the user", + "displayName": "Assign licenses to user", + "id": "683c87a4-2ad4-420b-97d4-220d90afcd24", + "version": 1, + "parameters": [ + { + "name": "licenses", + "values": [], + "valueType": "string" + } + ] + }, + { + "category": "leaver,mover", + "description": "Remove selected licenses assigned to the user", + "displayName": "Remove licenses from user", + "id": "5fc402a8-daaf-4b7b-9203-da868b05fc5f", + "version": 1, + "parameters": [ + { + "name": "licenses", + "values": [], + "valueType": "string" + } + ] + }, + { + "category": "leaver,mover", + "description": "Transfer groups the user owned to the user's manager", + "displayName": "Transfer group ownership to manager", + "id": "dde2a64c-8420-447b-9075-7309449de5cd", + "version": 1, "parameters": [] } ] |
v1.0 | Identitygovernance Lifecycleworkflowscontainer List Workflowtemplates | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-lifecycleworkflowscontainer-list-workflowtemplates.md | Content-Type: application/json { "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/workflowTemplates",+ "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET identityGovernance/lifecycleWorkflows/workflowTemplates?$select=category,description", "value": [ { "category": "joiner", Content-Type: application/json "category": "joiner", "continueOnError": false, "description": "Generate Temporary Access Pass and send via email to user's manager",- "displayName": "Generate TAP And Send Email", + "displayName": "Generate TAP And send email", "executionSequence": 1, "id": "3e062c24-d219-483d-9258-288f2a039b94", "isEnabled": true, Content-Type: application/json "category": "joiner,leaver", "continueOnError": false, "description": "Enable user account in the directory",- "displayName": "Enable User Account", + "displayName": "Enable user account", "executionSequence": 1, "id": "e18f3208-311c-46a3-a27b-d9c15cd595bc", "isEnabled": true, Content-Type: application/json "category": "joiner", "continueOnError": false, "description": "Send welcome email to new hire",- "displayName": "Send Welcome Email", + "displayName": "Send welcome email", "executionSequence": 2, "id": "e9551045-4302-499f-9108-60b9e23c067a", "isEnabled": true, Content-Type: application/json "category": "joiner,leaver", "continueOnError": false, "description": "Add user to selected groups",- "displayName": "Add User To Groups", + "displayName": "Add user to groups", "executionSequence": 3, "id": "560acd0c-321e-4e7e-9f31-ff8899c55878", "isEnabled": true, Content-Type: application/json } ] },+ { + "category": "joiner", + "description": "Configure onboarding tasks for an employee after their first day of work.", + "displayName": "Post-Onboarding of an employee", + "id": "dce038a6-482a-46a2-9ee0-675c5e8477b9", + "executionConditions": { + "@odata.type": "#microsoft.graph.identityGovernance.triggerAndScopeBasedConditions", + "scope": { + "@odata.type": "#microsoft.graph.identityGovernance.ruleBasedSubjectSet", + "rule": "department eq 'Marketing'" + }, + "trigger": { + "@odata.type": "#microsoft.graph.identityGovernance.timeBasedAttributeTrigger", + "timeBasedAttribute": "employeeHireDate", + "offsetInDays": 7 + } + }, + "tasks@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/workflowTemplates('dce038a6-482a-46a2-9ee0-675c5e8477b9')/tasks", + "tasks": [ + { + "category": "joiner,leaver", + "continueOnError": false, + "description": "Add user to selected groups", + "displayName": "Add user to groups", + "executionSequence": 1, + "id": "33350498-4404-487f-94ae-db312e436eda", + "isEnabled": true, + "taskDefinitionId": "22085229-5809-45e8-97fd-270d28d66910", + "arguments": [ + { + "name": "groupID", + "value": "" + } + ] + }, + { + "category": "joiner,leaver", + "continueOnError": false, + "description": "Add user to selected Teams", + "displayName": "Add user To Teams", + "executionSequence": 2, + "id": "6f7925a5-633d-4cd9-9c4b-8f4b2f040e2b", + "isEnabled": true, + "taskDefinitionId": "e440ed8d-25a1-4618-84ce-091ed5be5594", + "arguments": [ + { + "name": "teamID", + "value": "" + } + ] + } + ] + }, + { + "category": "mover", + "description": "Execute real-time tasks for employee job changes", + "displayName": "Real-time employee job change", + "id": "77a82a99-9dfb-471d-a396-107954328b7f", + "executionConditions": { + "@odata.type": "#microsoft.graph.identityGovernance.onDemandExecutionOnly" + }, + "tasks@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/workflowTemplates('77a82a99-9dfb-471d-a396-107954328b7f')/tasks", + "tasks": [ + { + "category": "joiner,leaver,mover", + "continueOnError": false, + "description": "Run a Custom Task Extension to callout to an external system.", + "displayName": "Run a Custom Task Extension", + "executionSequence": 1, + "id": "f187bcde-830a-4f4b-bed0-e2347b418c01", + "isEnabled": true, + "taskDefinitionId": "4262b724-8dba-4fad-afc3-43fcbb497a0e", + "arguments": [ + { + "name": "customTaskExtensionID", + "value": "" + } + ] + } + ] + }, + { + "category": "mover", + "description": "Configure mover tasks for employees once their group membership changes", + "displayName": "Employee group membership changes", + "id": "56da3093-d105-40d4-9886-fccd074f2f2a", + "executionConditions": { + "@odata.type": "#microsoft.graph.identityGovernance.triggerAndScopeBasedConditions", + "scope": { + "@odata.type": "#microsoft.graph.identityGovernance.groupBasedSubjectSet", + "groups": [ + { + "id": "groupID" + } + ] + }, + "trigger": { + "@odata.type": "#microsoft.graph.identityGovernance.membershipChangeTrigger", + "changeType": "add" + } + }, + "tasks@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/workflowTemplates('56da3093-d105-40d4-9886-fccd074f2f2a')/tasks", + "tasks": [ + { + "category": "leaver,mover", + "continueOnError": false, + "description": "Remove user assignment of selected access package", + "displayName": "Remove access package assignment for user", + "executionSequence": 1, + "id": "db0500d1-c988-4114-a005-f227649aedfd", + "isEnabled": true, + "taskDefinitionId": "4a0b64f2-c7ec-46ba-b117-18f262946c50", + "arguments": [ + { + "name": "accessPackageId", + "value": "" + } + ] + }, + { + "category": "joiner,leaver,mover", + "continueOnError": false, + "description": "Remove user from membership of selected Teams", + "displayName": "Remove user from selected Teams", + "executionSequence": 2, + "id": "b1049615-0be5-43dc-a919-1f5bf6db967b", + "isEnabled": true, + "taskDefinitionId": "06aa7acb-01af-4824-8899-b14e5ed788d6", + "arguments": [ + { + "name": "teamID", + "value": "" + } + ] + }, + { + "category": "mover", + "continueOnError": false, + "description": "Send email to notify userΓÇÖs manager of user move", + "displayName": "Send email to notify manager of user move", + "executionSequence": 3, + "id": "96c00437-3a06-4710-bd0b-ab57773a9189", + "isEnabled": true, + "taskDefinitionId": "aab41899-9972-422a-9d97-f626014578b7", + "arguments": [] + } + ] + }, + { + "category": "mover", + "description": "Configure mover tasks for employees once their job profile changes", + "displayName": "Employee job profile change", + "id": "16819b2d-74e9-4fb9-9ba7-48b8a26ab11d", + "executionConditions": { + "@odata.type": "#microsoft.graph.identityGovernance.triggerAndScopeBasedConditions", + "scope": { + "@odata.type": "#microsoft.graph.identityGovernance.ruleBasedSubjectSet", + "rule": "department eq 'Marketing'" + }, + "trigger": { + "@odata.type": "#microsoft.graph.identityGovernance.attributeChangeTrigger", + "triggerAttributes": [ + { + "name": "department" + } + ] + } + }, + "tasks@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/workflowTemplates('16819b2d-74e9-4fb9-9ba7-48b8a26ab11d')/tasks", + "tasks": [ + { + "category": "mover", + "continueOnError": false, + "description": "Send email to notify userΓÇÖs manager of user move", + "displayName": "Send email to notify manager of user move", + "executionSequence": 1, + "id": "96c00437-3a06-4710-bd0b-ab57773a9189", + "isEnabled": true, + "taskDefinitionId": "aab41899-9972-422a-9d97-f626014578b7", + "arguments": [] + }, + { + "category": "joiner,leaver,mover", + "continueOnError": false, + "description": "Remove user from membership of selected Azure AD groups", + "displayName": "Remove user from selected groups", + "executionSequence": 2, + "id": "e9e641d3-e457-433c-9d6c-78a4f2505aef", + "isEnabled": true, + "taskDefinitionId": "1953a66c-751c-45e5-8bfe-01462c70da3c", + "arguments": [ + { + "name": "groupID", + "value": "" + } + ] + }, + { + "category": "joiner,leaver,mover", + "continueOnError": false, + "description": "Remove user from membership of selected Teams", + "displayName": "Remove user from selected Teams", + "executionSequence": 3, + "id": "b1049615-0be5-43dc-a919-1f5bf6db967b", + "isEnabled": true, + "taskDefinitionId": "06aa7acb-01af-4824-8899-b14e5ed788d6", + "arguments": [ + { + "name": "teamID", + "value": "" + } + ] + }, + { + "category": "joiner,mover", + "continueOnError": false, + "description": "Request user assignment to selected access package", + "displayName": "Request user access package assignment", + "executionSequence": 4, + "id": "8c2c653f-46a1-4042-9b4d-2c3d503a4fcc", + "isEnabled": true, + "taskDefinitionId": "c1ec1e76-f374-4375-aaa6-0bb6bd4c60be", + "arguments": [ + { + "name": "assignmentPolicyId", + "value": "" + }, + { + "name": "accessPackageId", + "value": "" + } + ] + } + ] + }, { "category": "leaver", "description": "Execute real-time termination tasks for employees on their last day of work", Content-Type: application/json "category": "leaver", "continueOnError": false, "description": "Delete user account in Azure AD",- "displayName": "Delete User Account", + "displayName": "Delete user account", "executionSequence": 3, "id": "adbd4f05-99f0-4260-a155-7657623ca071", "isEnabled": true, Content-Type: application/json "category": "joiner,leaver", "continueOnError": false, "description": "Disable user account in the directory",- "displayName": "Disable User Account", + "displayName": "Disable user account", "executionSequence": 1, "id": "8d9eab35-6c32-4b76-acbd-6a22cb07aa6a", "isEnabled": true, Content-Type: application/json "category": "leaver", "continueOnError": false, "description": "Delete user account in Azure AD",- "displayName": "Delete User Account", + "displayName": "Delete user account", "executionSequence": 3, "id": "46849618-30e7-4b67-abf0-f8c7f0d54b95", "isEnabled": true, Content-Type: application/json The following example shows a request. + # [HTTP](#tab/http) <!-- { "blockType": "request", GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workf ++ #### Response <!-- { |
v1.0 | Identitygovernance Lifecycleworkflowscontainer Post Workflows | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-lifecycleworkflowscontainer-post-workflows.md | Title: "Create workflow" -description: "Create a new workflow object. You can create up to 50 workflows in a tenant." +description: "Create a new workflow object. You can create up to 100 workflows in a tenant." ms.localizationpriority: medium Namespace: microsoft.graph.identityGovernance [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Create a new [workflow](../resources/identitygovernance-workflow.md) object. You can create up to 50 workflows in a tenant. +Create a new [workflow](../resources/identitygovernance-workflow.md) object. You can create up to 100 workflows in a tenant. [!INCLUDE [national-cloud-support](../../includes/global-us.md)] You can specify the following properties when creating a **workflow**. |Property|Type|Description| |:|:|:|-|category|[microsoft.graph.identityGovernance.lifecycleWorkflowCategory](../resources/identitygovernance-workflow.md)|The category of the workflow. The possible values are: `joiner`, `leaver`, `unknownFutureValue`. Can be only one value. Required.| +|category|[microsoft.graph.identityGovernance.lifecycleWorkflowCategory](../resources/identitygovernance-workflow.md)|The category of the workflow. The possible values are: `joiner`, `leaver`, `unknownFutureValue`. It can be only one value. Required.| |description|String|A string that describes the purpose of the workflow for administrative use.| |displayName|String|A unique string that identifies the workflow. Required.|-|executionConditions|[microsoft.graph.identityGovernance.workflowExecutionConditions](../resources/identitygovernance-workflowexecutionconditions.md)|Defines for who and when a workflow will run. Required. | +|executionConditions|[microsoft.graph.identityGovernance.workflowExecutionConditions](../resources/identitygovernance-workflowexecutionconditions.md)|Defines for who and when a workflow runs. Required. | |id|String|Identifier used for individually addressing a specific workflow.| |isEnabled|Boolean|A Boolean value that denotes whether the workflow is set to run or not.| |isSchedulingEnabled|Boolean|A Boolean value that denotes whether scheduling is enabled or not. | If successful, this method returns a `201 Created` response code and a [microsof ## Examples -### Example 1: Create a new workflow +### Example 1: Create a joiner workflow using the time based trigger #### Request The following example shows a request that creates a workflow with the following configuration:-+ It's a "joiner" workflow that's enabled and schedule to run. -+ It runs for new users that are based in Australia, on their employeeHireDate. ++ It's a "joiner" workflow-enabled and scheduled to run.++ It runs for new users based in Australia, on their employeeHireDate using the time-based attribute trigger. + Two tasks are carried out when the workflow runs: the user's account is enabled and a "Welcome" email is sent to the user. # [HTTP](#tab/http) Content-Type: application/json } ``` -### Example 2: Create a new version of a task with customized email +### Example 2: Create a mover workflow using the attribute changes trigger #### Request -The following example shows a request. +The following example shows a request that creates a workflow with the following configuration: ++ It's a "mover" workflow-enabled and scheduled to run.++ It runs for existing users added to the "Sales" department using the attribute changes trigger.++ One task is carried out, which is to send an email to notify the user's manager of the move. # [HTTP](#tab/http) <!-- { "blockType": "request",- "name": "lifecycleworkflows_create_workflow_from_customemail" + "name": "lifecycleworkflows_create_workflow_from_attribute" } --> ``` http Content-Type: application/json Content-length: 631 {- "category": "joiner", - "description": "Configure new hire tasks for onboarding employees on their first day", - "displayName": "custom email marketing API test", + "category": "mover", + "description": "Configure mover tasks for a user when their job profile changes", + "displayName": "Sales contractor moves to full-time employee", "isEnabled": true,- "isSchedulingEnabled": false, + "isSchedulingEnabled": true, "executionConditions": { "@odata.type": "#microsoft.graph.identityGovernance.triggerAndScopeBasedConditions", "scope": { "@odata.type": "#microsoft.graph.identityGovernance.ruleBasedSubjectSet",- "rule": "(department eq 'Marketing')" + "rule": "(department eq 'Sales')" }, "trigger": {- "@odata.type": "#microsoft.graph.identityGovernance.timeBasedAttributeTrigger", - "timeBasedAttribute": "employeeHireDate", - "offsetInDays": 0 + "@odata.type": "#microsoft.graph.identityGovernance.attributeChangeTrigger", + "triggerAttributes": [ + { + "name": "department" + } + ] } }, "tasks": [ { "continueOnError": false,- "description": "Enable user account in the directory", - "displayName": "Enable User Account", + "description": "Send email to moving employee's manager", + "displayName": "Notify manager of move", "isEnabled": true,- "taskDefinitionId": "6fc52c9d-398b-4305-9763-15f42c1676fc", + "taskDefinitionId": "aab41899-9972-422a-9d97-f626014578b7", "arguments": []+ } + ] +} +``` ++# [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. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.identityGovernance.workflow" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "category": "mover", + "description": "Configure mover tasks for a user when their job profile changes", + "displayName": "Sales contractor moves to full time employee", + "isEnabled": true, + "isSchedulingEnabled": true, + "executionConditions": { + "@odata.type": "#microsoft.graph.identityGovernance.triggerAndScopeBasedConditions", + "scope": { + "@odata.type": "#microsoft.graph.identityGovernance.ruleBasedSubjectSet", + "rule": "(department eq 'Sales')" },+ "trigger": { + "@odata.type": "#microsoft.graph.identityGovernance.attributeChangeTrigger", + "triggerAttributes": [ + { + "name": "department" + } + ] + } + }, + "tasks": [ { "continueOnError": false,- "description": "Send welcome email to new hire", - "displayName": "Send Welcome Email", + "description": "Send email to moving employee's manager", + "displayName": "Notify manager of move", "isEnabled": true,- "taskDefinitionId": "70b29d51-b59a-4773-9280-8841dfd3f2ea", - "arguments": [ - { - "name": "cc", - "value": "1baa57fa-3c4e-4526-ba5a-db47a9df95f0" - }, - { - "name": "customSubject", - "value": "Welcome to the organization {{userDisplayName}}!" - }, - { - "name": "customBody", - "value": "Welcome to our organization {{userGivenName}}!" - }, + "taskDefinitionId": "aab41899-9972-422a-9d97-f626014578b7", + "arguments": [] + } + ] +} +``` ++### Example 3: Create a leaver workflow using the group based trigger ++#### Request ++The following example shows a request that creates a workflow with the following configuration: ++ It's a "leaver" workflow enabled and scheduled to run.++ It runs for users who are removed from the Sales group using the group-based trigger.++ Two tasks are carried out when the workflow runs: Remove user from all Teams, Remove user from all groups.++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "lifecycleworkflows_create_workflow_from_group" +} +--> +``` http +POST https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows +Content-Type: application/json ++{ + "category": "leaver", + "description": "Configure offboarding tasks for employees on their last day of work", + "displayName": "Offboard an employee", + "isEnabled": true, + "isSchedulingEnabled": true, + "executionConditions": { + "@odata.type": "#microsoft.graph.identityGovernance.triggerAndScopeBasedConditions", + "scope": { + "@odata.type": "#microsoft.graph.identityGovernance.groupBasedSubjectSet", + "groups": [ {- "name": "locale", - "value": "en-us" + "id": "668e7540-7f8e-4ca4-a207-b7dffbb6d038" } ]+ }, + "trigger": { + "@odata.type": "#microsoft.graph.identityGovernance.membershipChangeTrigger", + "changeType": "remove" + } + }, + "tasks": [ + { + "category": "leaver", + "continueOnError": false, + "description": "Remove user from all Teams memberships", + "displayName": "Remove user from all Teams", + "isEnabled": true, + "taskDefinitionId": "81f7b200-2816-4b3b-8c5d-dc556f07b024", + "arguments": [] + }, + { + "category": "leaver", + "continueOnError": false, + "description": "Remove user from all Azure AD groups memberships", + "displayName": "Remove user from all groups", + "isEnabled": true, + "taskDefinitionId": "b3a31406-2a15-4c9a-b25b-a658fa5f07fc", + "arguments": [] } ] } ``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [CLI](#tab/cli) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] #### Response - The following example shows the response. >**Note:** The response object shown here might be shortened for readability. <!-- { The following example shows the response. } --> ``` http-HTTP/1.1 200 OK +HTTP/1.1 201 Created Content-Type: application/json {- "workflow":{ - "category": "joiner", - "description": "Configure new hire tasks for onboarding employees on their first day", - "displayName": "Global onboard new hire employee", - "isEnabled": true, - "isSchedulingEnabled": false, - "executionConditions": { - "@odata.type": "#microsoft.graph.identityGovernance.triggerAndScopeBasedConditions", - "scope": { - "@odata.type": "#microsoft.graph.identityGovernance.ruleBasedSubjectSet", - "rule": "(department eq 'Marketing')" - }, - "trigger": { - "@odata.type": "#microsoft.graph.identityGovernance.timeBasedAttributeTrigger", - "timeBasedAttribute": "employeeHireDate", - "offsetInDays": 1 - } + "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/workflows/$entity", + "category": "leaver", + "description": "Configure offboarding tasks for employees on their last day of work", + "displayName": "Offboard an employee", + "isEnabled": true, + "isSchedulingEnabled": true, + "lastModifiedDateTime": "2024-03-28T20:20:05.6599449Z", + "createdDateTime": "2024-03-28T20:20:05.6599142Z", + "deletedDateTime": null, + "id": "73ed8912-6a04-4f5d-bef8-61fcc94336a7", + "nextScheduleRunDateTime": "2024-03-28T20:37:08Z", + "version": 1, + "executionConditions": { + "@odata.type": "#microsoft.graph.identityGovernance.triggerAndScopeBasedConditions", + "scope": { + "@odata.type": "#microsoft.graph.identityGovernance.groupBasedSubjectSet" },- "tasks": [ - { - "continueOnError": false, - "description": "Enable user account in the directory", - "displayName": "Enable User Account", - "isEnabled": true, - "taskDefinitionId": "6fc52c9d-398b-4305-9763-15f42c1676fc", - "arguments": [] - }, - { - "continueOnError": false, - "description": "Send welcome email to new hire", - "displayName": "Send Welcome Email", - "isEnabled": true, - "taskDefinitionId": "70b29d51-b59a-4773-9280-8841dfd3f2ea", - "arguments": [ - { - "name": "cc", - "value": "b47471b9-af8f-4a5a-bfa2-b78e82398f6e, a7a23ce0-909b-40b9-82cf-95d31f0aaca2" - }, - { - "name": "customSubject", - "value": "Welcome to the organization {{userDisplayName}}!" - }, - { - "name": "customBody", - "value": "Welcome to our organization {{userGivenName}} {{userSurname}}. \nFor more information, reach out to your manager {{managerDisplayName}} at {{managerEmail}}." - }, - { - "name": "locale", - "value": "en-us" - }, - ] - } - ] + "trigger": { + "@odata.type": "#microsoft.graph.identityGovernance.membershipChangeTrigger", + "changeType": "remove" + } } } ``` |
v1.0 | Identitygovernance Workflow Createnewversion | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-workflow-createnewversion.md | If successful, this action returns a `200 OK` response code and a [microsoft.gra ## Examples -### Example 1: Create a new version of a workflow +### Example 1: Create a new version of a joiner workflow with time based trigger #### Request |
v1.0 | Identityprovider Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identityprovider-delete.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityprovider_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/identityprovider-delete-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Identityprovider Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identityprovider-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityprovider_get" } --> [!INCLUDE [permissions-table](../includes/permissions/identityprovider-get-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity Provider administrator ## HTTP request |
v1.0 | Identityprovider List Availableprovidertypes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identityprovider-list-availableprovidertypes.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityprovider_list_availableprovidertypes" } --> [!INCLUDE [permissions-table](../includes/permissions/identityprovider-list-availableprovidertypes-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Identityprovider List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identityprovider-list.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityprovider_list" } --> [!INCLUDE [permissions-table](../includes/permissions/identityprovider-list-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Identityprovider Post Identityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identityprovider-post-identityproviders.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityprovider_post_identityproviders" } --> [!INCLUDE [permissions-table](../includes/permissions/identityprovider-post-identityproviders-permissions.md)] -The work or school account needs to belong to one of the following roles: -* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Identityprovider Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identityprovider-update.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityprovider_update" } --> [!INCLUDE [permissions-table](../includes/permissions/identityprovider-update-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Identityproviderbase Availableprovidertypes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identityproviderbase-availableprovidertypes.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityproviderbase_availableprovidertypes" } --> [!INCLUDE [permissions-table](../includes/permissions/identityproviderbase-availableprovidertypes-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Identityproviderbase Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identityproviderbase-delete.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityproviderbase_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/identityproviderbase-delete-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Identityproviderbase Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identityproviderbase-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityproviderbase_get" } --> [!INCLUDE [permissions-table](../includes/permissions/identityproviderbase-get-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* External Identity Provider Administrator -* External ID user flow administrator +The work or school account needs to belong to at least the *External Identity Provider Administrator* or *External Identity User Flow administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request |
v1.0 | Identityproviderbase Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identityproviderbase-update.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityproviderbase_update" } --> [!INCLUDE [permissions-table](../includes/permissions/identityproviderbase-update-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Inactiveawsresourcefinding Aggregatedsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactiveawsresourcefinding-aggregatedsummary.md | description: View the count of inactive AWS resources for the specified authoriz ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Inactiveawsresourcefinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactiveawsresourcefinding-get.md | description: "Read the properties and relationships of an inactiveAwsResourceFin ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Inactiveawsresourcefinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactiveawsresourcefinding-list.md | description: "List the details of inactive AWS resources." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Inactiveawsrolefinding Aggregatedsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactiveawsrolefinding-aggregatedsummary.md | description: "Retrieve the raw count of inactive roles relative to the total rol ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Inactiveawsrolefinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactiveawsrolefinding-list.md | description: "List the details of inactive roles in AWS authorization systems on ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Inactiveazureserviceprincipalfinding Aggregatedsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactiveazureserviceprincipalfinding-aggregatedsummary.md | description: "View the count of inactive Azure service principals for the specif ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Inactiveazureserviceprincipalfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactiveazureserviceprincipalfinding-get.md | description: "Read the properties and relationships of an inactiveAzureServicePr ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Inactiveazureserviceprincipalfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactiveazureserviceprincipalfinding-list.md | description: "Get a list of the inactiveAzureServicePrincipalFinding objects and ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Inactivegcpserviceaccountfinding Aggregatedsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactivegcpserviceaccountfinding-aggregatedsummary.md | description: View the count of inactive GCP service accounts in your authorizati ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Inactivegcpserviceaccountfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactivegcpserviceaccountfinding-get.md | description: "Read the properties and relationships of an inactiveGcpServiceAcco ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Inactivegcpserviceaccountfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactivegcpserviceaccountfinding-list.md | description: "Get a list of the inactiveGcpServiceAccountFinding objects and the ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Inactivegroupfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactivegroupfinding-get.md | description: "Get details about an inactive group in AWS, Azure, or GCP environm ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Inactivegroupfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactivegroupfinding-list.md | description: "List inactive groups in AWS, Azure and GCP environments." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Inactiveserverlessfunctionfinding Aggregatedsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactiveserverlessfunctionfinding-aggregatedsummary.md | description: "A raw count of inactive serverless functions in the specified AWS, ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Inactiveserverlessfunctionfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactiveserverlessfunctionfinding-get.md | description: "Read the properties and relationships of inactive serverless funct ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Inactiveserverlessfunctionfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactiveserverlessfunctionfinding-list.md | description: "List the details of inactive serverless functions in authorization ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Inactiveuserfinding Aggregatedsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactiveuserfinding-aggregatedsummary.md | description: "View the raw count of inactive users in the specified AWS, Azure, ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Inactiveuserfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactiveuserfinding-get.md | description: "Get the details of an inactiveUserFinding in an authorization syst ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Inactiveuserfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactiveuserfinding-list.md | description: "Get a list of the inactiveUserFinding objects and their properties ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Inboundshareduserprofile Exportpersonaldata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inboundshareduserprofile-exportpersonaldata.md | Title: "inboundSharedUserProfile: exportPersonalData" description: "Create a request to export the personal data for an inboundSharedUserProfile." + ms.localizationpriority: medium doc_type: apiPageType |
v1.0 | Inboundshareduserprofile Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inboundshareduserprofile-get.md | Title: "Get inboundSharedUserProfile" description: "Read the properties of an inboundSharedUserProfile." + ms.localizationpriority: medium doc_type: apiPageType |
v1.0 | Inboundshareduserprofile Removepersonaldata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inboundshareduserprofile-removepersonaldata.md | Title: "inboundSharedUserProfile: removePersonalData" description: "Create a request to remove the personal data for an inboundSharedUserProfile." + ms.localizationpriority: medium doc_type: apiPageType |
v1.0 | Industrydata Administrativeunitprovisioningflow Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-administrativeunitprovisioningflow-delete.md | + + Title: "Delete administrativeUnitProvisioningFlow" +description: "Delete an administrativeUnitProvisioningFlow object." ++ms.localizationpriority: medium ++++# Delete administrativeUnitProvisioningFlow ++Namespace: microsoft.graph.industryData +++Delete an [administrativeUnitProvisioningFlow](../resources/industrydata-administrativeunitprovisioningflow.md) object. +++## 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": "industrydata-administrativeunitprovisioningflow-delete-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +DELETE /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlows/{id} +``` ++## Request headers ++| Name | Description | +| : | : | +| Authorization | Bearer {token}. Required. | ++## Request body ++Don't supply a request body for this method. ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_administrativeunitprovisioningflow" +} +--> ++```http +DELETE https://graph.microsoft.com/beta/external/industryData/OutboundProvisioningFlowSets/9ab41255-5364-4c53-e15c-08dc4ab6ee03/provisioningFlows/f66e97ad-0870-46e0-3ff3-08dc49dccdc9 +``` ++# [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. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true +} +--> ++```http +HTTP/1.1 204 No Content +``` |
v1.0 | Industrydata Administrativeunitprovisioningflow Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-administrativeunitprovisioningflow-get.md | + + Title: "Get administrativeUnitProvisioningFlow" +description: "Read the properties and relationships of an administrativeUnitProvisioningFlow object." ++ms.localizationpriority: medium ++++# Get administrativeUnitProvisioningFlow ++Namespace: microsoft.graph.industryData +++Read the properties and relationships of an [administrativeUnitProvisioningFlow](../resources/industrydata-administrativeunitprovisioningflow.md) object. +++## 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": "industrydata-administrativeunitprovisioningflow-get-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +GET /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlows/{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. | ++## Request body ++Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [microsoft.graph.industryData.administrativeUnitProvisioningFlow](../resources/industrydata-administrativeunitprovisioningflow.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_administrativeunitprovisioningflow" +} +--> ++```msgraph-interactive +GET https://graph.microsoft.com/beta/external/industryData/OutboundProvisioningFlowSets/9ab41255-5364-4c53-e15c-08dc4ab6ee03/provisioningFlows/f66e97ad-0870-46e0-3ff3-08dc49dccdc9 +``` ++# [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. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.industryData.administrativeUnitProvisioningFlow" +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#external/industryData/outboundProvisioningFlowSets('9ab41255-5364-4c53-e15c-08dc4ab6ee03')/provisioningFlows/$entity", + "@odata.type": "#microsoft.graph.industryData.administrativeUnitProvisioningFlow", + "id": "f66e97ad-0870-46e0-3ff3-08dc49dccdc9", + "createdDateTime": "2024-03-22T21:28:02.7164229Z", + "lastModifiedDateTime": "2024-03-22T21:28:02.7164229Z", + "readinessStatus": "disabled", + "creationOptions": { + "createBasedOnOrg": true, + "createBasedOnOrgPlusRoleGroup": true + } +} +``` |
v1.0 | Industrydata Administrativeunitprovisioningflow Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-administrativeunitprovisioningflow-update.md | + + Title: "Update administrativeUnitProvisioningFlow" +description: "Update the properties of an administrativeUnitProvisioningFlow object." ++ms.localizationpriority: medium ++++# Update administrativeUnitProvisioningFlow ++Namespace: microsoft.graph.industryData +++Update the properties of an [administrativeUnitProvisioningFlow](../resources/industrydata-administrativeunitprovisioningflow.md) object. +++## 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": "industrydata-administrativeunitprovisioningflow-update-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +PATCH /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlows/{id} +``` ++## Request headers ++| Name | Description | +| : | :-- | +| Authorization | Bearer {token}. Required. | +| Content-Type | application/json. Required. | ++## Request body +++|Property|Type|Description| +|:|:|:| +|creationOptions|[microsoft.graph.industryData.adminUnitCreationOptions](../resources/industrydata-adminunitcreationoptions.md)|The different attribute choices for the administrative units to be provisioned. Required.| ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_administrativeunitprovisioningflow" +} +--> ++```http +PATCH https://graph.microsoft.com/beta/external/industryData/OutboundProvisioningFlowSets/9ab41255-5364-4c53-e15c-08dc4ab6ee03/provisioningFlows/f66e97ad-0870-46e0-3ff3-08dc49dccdc9 +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.industryData.administrativeUnitProvisioningFlow", + "creationOptions": + { + "createBasedOnOrg": true, + "createBasedOnOrgPlusroleGroup": false + } +} +``` ++# [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. ++<!-- { + "blockType": "response", + "truncated": true +} +--> ++```http +HTTP/1.1 204 No Content +``` |
v1.0 | Industrydata Classgroupprovisioningflow Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-classgroupprovisioningflow-delete.md | + + Title: "Delete classGroupProvisioningFlow" +description: "Delete a classGroupProvisioningFlow object." ++ms.localizationpriority: medium ++++# Delete classGroupProvisioningFlow ++Namespace: microsoft.graph.industryData +++Delete a [classGroupProvisioningFlow](../resources/industrydata-classgroupprovisioningflow.md) object. +++## 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": "industrydata-classgroupprovisioningflow-delete-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +DELETE /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlows/{id} +``` ++## Request headers ++| Name | Description | +| : | : | +| Authorization | Bearer {token}. Required. | ++## Request body ++Don't supply a request body for this method. ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_classgroupprovisioningflow" +} +--> ++```http +DELETE https://graph.microsoft.com/beta/external/industryData/OutboundProvisioningFlowSets/9ab41255-5364-4c53-e15c-08dc4ab6ee03/provisioningFlows/417a82c8-7caa-4f82-3ac6-08dc4ac6fb7f +``` ++# [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. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true +} +--> ++```http +HTTP/1.1 204 No Content +``` |
v1.0 | Industrydata Classgroupprovisioningflow Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-classgroupprovisioningflow-get.md | + + Title: "Get classGroupProvisioningFlow" +description: "Read the properties and relationships of a classGroupProvisioningFlow object." ++ms.localizationpriority: medium ++++# Get classGroupProvisioningFlow ++Namespace: microsoft.graph.industryData +++Read the properties and relationships of a [classGroupProvisioningFlow](../resources/industrydata-classgroupprovisioningflow.md) object. +++## 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": "industrydata-classgroupprovisioningflow-get-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +GET /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlows/{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. | ++## Request body ++Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [microsoft.graph.industryData.classGroupProvisioningFlow](../resources/industrydata-classgroupprovisioningflow.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_classgroupprovisioningflow" +} +--> ++```msgraph-interactive +GET https://graph.microsoft.com/beta/external/industryData/OutboundProvisioningFlowSets/9ab41255-5364-4c53-e15c-08dc4ab6ee03/provisioningFlows/417a82c8-7caa-4f82-3ac6-08dc4ac6fb7f +``` ++# [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. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.industryData.classGroupProvisioningFlow" +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#external/industryData/outboundProvisioningFlowSets('9ab41255-5364-4c53-e15c-08dc4ab6ee03')/provisioningFlows/$entity", + "@odata.type": "#microsoft.graph.industryData.classGroupProvisioningFlow", + "id": "417a82c8-7caa-4f82-3ac6-08dc4ac6fb7f", + "createdDateTime": "2024-03-22T23:34:18.5035988Z", + "lastModifiedDateTime": "2024-03-22T23:34:18.5035988Z", + "readinessStatus": "disabled", + "configuration": { + "additionalAttributes": [ + "courseTitle", + "courseCode", + "courseSubject", + "courseGradeLevel", + "courseExternalId", + "academicSessionTitle", + "academicSessionExternalId" + ], + "additionalOptions": { + "createTeam": true, + "writeDisplayNameOnCreateOnly": true + }, + "enrollmentMappings": { + "ownerEnrollmentMappings": [ + { + "code": "teacher" + }, + { + "code": "proctor" + }, + { + "code": "teacherAssistant" + }, + { + "code": "paraprofessional" + }, + { + "code": "physicalTherapist" + }, + { + "code": "speechTherapist" + }, + { + "code": "visionTherapist" + }, + { + "code": "occupationalTherapist" + }, + { + "code": "staff" + } + ], + "memberEnrollmentMappings": [ + { + "code": "student" + }, + { + "code": "substitute" + }, + { + "code": "aide" + }, + { + "code": "proctor" + }, + { + "code": "teacherAssistant" + }, + { + "code": "paraprofessional" + }, + { + "code": "physicalTherapist" + }, + { + "code": "speechTherapist" + }, + { + "code": "visionTherapist" + }, + { + "code": "occupationalTherapist" + }, + { + "code": "staff" + } + ] + } + } +} +``` |
v1.0 | Industrydata Classgroupprovisioningflow Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-classgroupprovisioningflow-update.md | + + Title: "Update classGroupProvisioningFlow" +description: "Update the properties of a classGroupProvisioningFlow object." ++ms.localizationpriority: medium ++++# Update classGroupProvisioningFlow ++Namespace: microsoft.graph.industryData +++Update the properties of a [classGroupProvisioningFlow](../resources/industrydata-classgroupprovisioningflow.md) object. +++## 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": "industrydata-classgroupprovisioningflow-update-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +PATCH /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlows/{id} +``` ++## Request headers ++| Name | Description | +| : | :-- | +| Authorization | Bearer {token}. Required. | +| Content-Type | application/json. Required. | ++## Request body +++| Property | Type | Description | +| : | :-- | :-- | +| configuration | [microsoft.graph.industryData.classGroupConfiguration](../resources/industrydata-classgroupconfiguration.md) | The different attribute choices for the class groups to be provisioned. Required. | ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_classgroupprovisioningflow" +} +--> ++```http +PATCH https://graph.microsoft.com/beta/external/industryData/OutboundProvisioningFlowSets/9ab41255-5364-4c53-e15c-08dc4ab6ee03/provisioningFlows/417a82c8-7caa-4f82-3ac6-08dc4ac6fb7f +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.industryData.classGroupProvisioningFlow", + "configuration": { + "@odata.type": "#microsoft.graph.industryData.classGroupConfiguration", + "additionalAttributes": [ + "courseTitle", + "courseCode" + ], + "additionalOptions": { + "@odata.type": "#microsoft.graph.industryData.additionalClassGroupOptions", + "createTeam": false, + "writeDisplayNameOnCreateOnly": false + }, + "enrollmentMappings": { + "@odata.type": "#microsoft.graph.industryData.enrollmentMappings", + "memberEnrollmentMappings": [ + { + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "substitute" + } + ], + "ownerEnrollmentMappings": [ + { + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "teacher" + } + ] + } + } +} +``` ++# [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. ++<!-- { + "blockType": "response", + "truncated": true +} +--> ++```http +HTTP/1.1 204 No Content +``` |
v1.0 | Industrydata Industrydataroot Delete Outboundprovisioningflowsets | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-industrydataroot-delete-outboundprovisioningflowsets.md | + + Title: "Delete outboundProvisioningFlowSet" +description: "Delete an outboundProvisioningFlowSet object." ++ms.localizationpriority: medium ++++# Delete outboundProvisioningFlowSet ++Namespace: microsoft.graph.industryData +++Delete an [outboundProvisioningFlowSet](../resources/industrydata-outboundprovisioningflowset.md) object. +++## 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": "industrydata-industrydataroot-delete-outboundprovisioningflowsets-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +DELETE /external/industryData/outboundProvisioningFlowSets/{id} +``` ++## Request headers ++| Name | Description | +| : | : | +| Authorization | Bearer {token}. Required. | ++## Request body ++Don't supply a request body for this method. ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_outboundprovisioningflowset" +} +--> ++```http +DELETE https://graph.microsoft.com/beta/external/industryData/OutboundProvisioningFlowSets/8ac3c08f-6f93-465b-4bd9-08dc4ac773d0 +``` ++# [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. ++<!-- { + "blockType": "response", + "truncated": true +} +--> ++```http +HTTP/1.1 204 No Content +``` |
v1.0 | Industrydata Industrydataroot List Outboundprovisioningflowsets | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-industrydataroot-list-outboundprovisioningflowsets.md | + + Title: "List outboundProvisioningFlowSet objects" +description: "Get a list of the outboundProvisioningFlowSet objects and their properties." ++ms.localizationpriority: medium ++++# List outboundProvisioningFlowSet objects ++Namespace: microsoft.graph.industryData +++Get a list of the [outboundProvisioningFlowSet](../resources/industrydata-outboundprovisioningflowset.md) objects and their properties. +++## 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": "industrydata-industrydataroot-list-outboundprovisioningflowsets-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +GET /external/industryData/outboundProvisioningFlowSets +``` ++## 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. | ++## 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 [outboundProvisioningFlowSet](../resources/industrydata-outboundprovisioningflowset.md) objects in the response body. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "list_outboundprovisioningflowset" +} +--> ++```msgraph-interactive +GET https://graph.microsoft.com/beta/external/industryData/outboundProvisioningFlowSets +``` ++# [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. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.industryData.outboundProvisioningFlowSet)" +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#external/industryData/outboundProvisioningFlowSets", + "value": [ + { + "id": "6c74bedb-23fa-44c9-d478-08dc3a38e458", + "createdDateTime": "2024-03-05T02:12:29.6430906Z", + "lastModifiedDateTime": "2024-03-05T02:12:29.6430906Z", + "displayName": "Outbound Provisioning Flow Test", + "filter": { + "@odata.type": "#microsoft.graph.industryData.basicFilter", + "attribute": "orgExternalId", + "in": [ + "Quarter", + "Demo" + ] + } + }, + { + "id": "8c33d025-5e64-4550-2aa3-08dc4ac66fca", + "createdDateTime": "2024-03-25T22:24:06.0882415Z", + "lastModifiedDateTime": "2024-03-25T22:24:06.0882415Z", + "displayName": "Outbound Provisioning Flow", + "filter": { + "@odata.type": "#microsoft.graph.industryData.basicFilter", + "attribute": "orgExternalId", + "in": [ + "Practice", + "Tactics" + ] + } + } + ] +} +``` |
v1.0 | Industrydata Industrydataroot Post Outboundprovisioningflowsets | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-industrydataroot-post-outboundprovisioningflowsets.md | + + Title: "Create outboundProvisioningFlowSet" +description: "Create a new outboundProvisioningFlowSet object." ++ms.localizationpriority: medium ++++# Create outboundProvisioningFlowSet ++Namespace: microsoft.graph.industryData +++Create a new [outboundProvisioningFlowSet](../resources/industrydata-outboundprovisioningflowset.md) object. +++## 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": "industrydata-industrydataroot-post-outboundprovisioningflowsets-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +POST /external/industryData/OutboundProvisioningFlowSets +``` ++## Request headers ++| Name | Description | +| : | :-- | +| Authorization | Bearer {token}. Required. | +| Content-Type | application/json. Required. | ++## Request body ++In the request body, supply a JSON representation of the [outboundProvisioningFlowSet](../resources/industrydata-outboundprovisioningflowset.md) object. ++## Response ++If successful, this method returns a `201 Created` response code and an [outboundProvisioningFlowSet](../resources/industrydata-outboundprovisioningflowset.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_outboundprovisioningflowset_from_" +} +--> ++```http +POST https://graph.microsoft.com/beta/external/industryData/OutboundProvisioningFlowSets +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.industryData.outboundProvisioningFlowSet", + "displayName": "Outbound Provisioning Flow Test", + "filter": { + "@odata.type": "#microsoft.graph.industryData.basicFilter", + "attribute": "orgExternalId", + "in": [ + "Quarter", + "Demo" + ] + } +} +``` ++# [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. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.industryData.outboundProvisioningFlowSet" +} +--> ++```http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#external/industryData/outboundProvisioningFlowSets/$entity", + "id": "8ac3c08f-6f93-465b-4bd9-08dc4ac773d0", + "createdDateTime": "2024-03-25T21:55:03.495336Z", + "lastModifiedDateTime": "2024-03-25T21:55:03.495336Z", + "displayName": "Outbound Provisioning Flow Test", + "filter": { + "@odata.type": "#microsoft.graph.industryData.basicFilter", + "attribute": "orgExternalId", + "in": [ + "Quarter", + "Demo" + ] + } +} +``` |
v1.0 | Industrydata Outboundprovisioningflowset Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-outboundprovisioningflowset-get.md | + + Title: "Get outboundProvisioningFlowSet" +description: "Read the properties and relationships of an outboundProvisioningFlowSet object." ++ms.localizationpriority: medium ++++# Get outboundProvisioningFlowSet ++Namespace: microsoft.graph.industryData +++Read the properties and relationships of an [outboundProvisioningFlowSet](../resources/industrydata-outboundprovisioningflowset.md) object. +++## 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": "industrydata-outboundprovisioningflowset-get-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +GET /external/industryData/outboundProvisioningFlowSets/{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. | ++## Request body ++Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and an [outboundProvisioningFlowSet](../resources/industrydata-outboundprovisioningflowset.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_outboundprovisioningflowset" +} +--> ++```msgraph-interactive +GET https://graph.microsoft.com/beta/external/industryData/OutboundProvisioningFlowSets/8ac3c08f-6f93-465b-4bd9-08dc4ac773d0 +``` ++# [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. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.industryData.outboundProvisioningFlowSet" +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#external/industryData/outboundProvisioningFlowSets/$entity", + "id": "8ac3c08f-6f93-465b-4bd9-08dc4ac773d0", + "createdDateTime": "2024-03-25T21:55:03.495336Z", + "lastModifiedDateTime": "2024-03-25T21:55:03.495336Z", + "displayName": "Outbound Provisioning Flow Test", + "filter": { + "@odata.type": "#microsoft.graph.industryData.basicFilter", + "attribute": "orgExternalId", + "in": [ + "Quarter", + "Demo" + ] + } +} +``` |
v1.0 | Industrydata Outboundprovisioningflowset List Provisioningflows | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-outboundprovisioningflowset-list-provisioningflows.md | + + Title: "List provisioningFlow objects" +description: "Get a list of the provisioningFlow objects and their properties." ++ms.localizationpriority: medium ++++# List provisioningFlow objects ++Namespace: microsoft.graph.industryData +++Get a list of the [provisioningFlow](../resources/industrydata-provisioningflow.md) objects and their properties. +++## 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": "industrydata-outboundprovisioningflowset-list-provisioningflows-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +GET /external/industryData/outboundProvisioningFlowSets/{id}/provisioningFlows +``` ++## 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. | ++## 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 [provisioningFlow](../resources/industrydata-provisioningflow.md) objects in the response body. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "list_provisioningflow" +} +--> ++```msgraph-interactive +GET https://graph.microsoft.com/beta/external/industryData/outboundProvisioningFlowSets/8c33d025-5e64-4550-2aa3-08dc4ac66fca/provisioningFlows +``` ++# [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. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.industryData.provisioningFlow)" +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#external/industryData/outboundProvisioningFlowSets('8c33d025-5e64-4550-2aa3-08dc4ac66fca')/provisioningFlows", + "value": [ + { + "@odata.type": "#microsoft.graph.industryData.securityGroupProvisioningFlow", + "id": "51f99e09-bdc5-47ff-7a0a-08dc4ac74cf1", + "createdDateTime": "2024-03-25T22:29:22.6303479Z", + "lastModifiedDateTime": "2024-03-25T22:29:22.6303479Z", + "readinessStatus": "disabled", + "creationOptions": { + "createBasedOnRoleGroup": true, + "createBasedOnOrgPlusRoleGroup": false + } + }, + { + "@odata.type": "#microsoft.graph.industryData.classGroupProvisioningFlow", + "id": "6207e7d7-5eba-4ddc-e607-08dc4ac77409", + "createdDateTime": "2024-03-25T22:29:16.1177912Z", + "lastModifiedDateTime": "2024-03-25T22:29:16.1177912Z", + "readinessStatus": "disabled", + "configuration": { + "additionalAttributes": [ + "courseTitle", + "courseCode", + "courseSubject", + "courseGradeLevel", + "courseExternalId", + "academicSessionTitle", + "academicSessionExternalId" + ], + "additionalOptions": { + "createTeam": true, + "writeDisplayNameOnCreateOnly": true + }, + "enrollmentMappings": { + "ownerEnrollmentMappings": [ + { + "code": "teacher" + }, + { + "code": "proctor" + }, + { + "code": "teacherAssistant" + }, + { + "code": "paraprofessional" + }, + { + "code": "physicalTherapist" + }, + { + "code": "speechTherapist" + }, + { + "code": "visionTherapist" + }, + { + "code": "occupationalTherapist" + }, + { + "code": "staff" + } + ], + "memberEnrollmentMappings": [ + { + "code": "student" + }, + { + "code": "substitute" + }, + { + "code": "aide" + }, + { + "code": "proctor" + }, + { + "code": "teacherAssistant" + }, + { + "code": "paraprofessional" + }, + { + "code": "physicalTherapist" + }, + { + "code": "speechTherapist" + }, + { + "code": "visionTherapist" + }, + { + "code": "occupationalTherapist" + }, + { + "code": "staff" + } + ] + } + } + }, + { + "@odata.type": "#microsoft.graph.industryData.administrativeUnitProvisioningFlow", + "id": "7b355e84-0af2-42fd-d392-08dc4ac68cf2", + "createdDateTime": "2024-03-25T22:29:05.4272368Z", + "lastModifiedDateTime": "2024-03-25T22:29:05.4272368Z", + "readinessStatus": "disabled", + "creationOptions": { + "createBasedOnOrg": true, + "createBasedOnOrgPlusRoleGroup": true + } + }, + { + "@odata.type": "#microsoft.graph.industryData.userProvisioningFlow", + "id": "dfeec276-d507-4008-d393-08dc4ac68cf2", + "createdDateTime": "2024-03-25T22:29:10.0687495Z", + "lastModifiedDateTime": "2024-03-25T22:29:10.0687495Z", + "readinessStatus": "disabled", + "createUnmatchedUsers": true, + "managementOptions": { + "additionalAttributes": [ + "userGradeLevel" + ], + "additionalOptions": { + "markAllStudentsAsMinors": true, + "allowStudentContactAssociation": false + } + }, + "creationOptions": { + "configurations": [ + { + "licenseSkus": [ + "world-class" + ], + "defaultPasswordSettings": { + "@odata.type": "#microsoft.graph.industryData.simplePasswordSettings", + "password": "***************" + }, + "roleGroup@odata.context": "https://graph.microsoft.com/beta/$metadata#external/industryData/outboundProvisioningFlowSets('8c33d025-5e64-4550-2aa3-08dc4ac66fca')/provisioningFlows('dfeec276-d507-4008-d393-08dc4ac68cf2')/microsoft.graph.industryData.userProvisioningFlow/creationOptions/configurations/roleGroup/$entity", + "roleGroup": { + "id": "students", + "displayName": "Students", + "roles": [ + { + "code": "student" + } + ] + } + }, + { + "licenseSkus": [ + "Strategist" + ], + "defaultPasswordSettings": { + "@odata.type": "#microsoft.graph.industryData.simplePasswordSettings", + "password": "***************" + }, + "roleGroup@odata.context": "https://graph.microsoft.com/beta/$metadata#external/industryData/outboundProvisioningFlowSets('8c33d025-5e64-4550-2aa3-08dc4ac66fca')/provisioningFlows('dfeec276-d507-4008-d393-08dc4ac68cf2')/microsoft.graph.industryData.userProvisioningFlow/creationOptions/configurations/roleGroup/$entity", + "roleGroup": { + "id": "staff", + "displayName": "Staff", + "roles": [ + { + "code": "adjunct" + }, + { + "code": "administrator" + }, + { + "code": "advisor" + }, + { + "code": "affiliate" + }, + { + "code": "aide" + }, + { + "code": "alumni" + }, + { + "code": "assistant" + }, + { + "code": "chair" + }, + { + "code": "coach" + }, + { + "code": "faculty" + }, + { + "code": "instructor" + }, + { + "code": "itAdmin" + }, + { + "code": "lecturer" + }, + { + "code": "nurse" + }, + { + "code": "occupationalTherapist" + }, + { + "code": "officeStaff" + }, + { + "code": "paraprofessional" + }, + { + "code": "physicalTherapist" + }, + { + "code": "principal" + }, + { + "code": "proctor" + }, + { + "code": "professor" + }, + { + "code": "researcher" + }, + { + "code": "specialServices" + }, + { + "code": "speechTherapist" + }, + { + "code": "staff" + }, + { + "code": "substitute" + }, + { + "code": "teacher" + }, + { + "code": "teacherAssistant" + }, + { + "code": "visionTherapist" + } + ] + } + } + ] + } + } + ] +} +``` |
v1.0 | Industrydata Outboundprovisioningflowset Post Provisioningflows | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-outboundprovisioningflowset-post-provisioningflows.md | + + Title: "Create provisioningFlow" +description: "Create a new provisioningFlow object." ++ms.localizationpriority: medium ++++# Create provisioningFlow ++Namespace: microsoft.graph.industryData +++Create a new [provisioningFlow](../resources/industrydata-provisioningflow.md) object. +++## 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": "industrydata-outboundprovisioningflowset-post-provisioningflows-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +POST /external/industryData/outboundProvisioningFlowSets/{id}/provisioningFlows +``` ++## Request headers ++| Name | Description | +| : | :-- | +| Authorization | Bearer {token}. Required. | +| Content-Type | application/json. Required. | ++## Request body ++In the request body, supply a JSON representation of the [provisioningFlow](../resources/industrydata-provisioningflow.md) object. ++Any of the following provisioning flows are valid: ++- [administrativeUnitProvisioningFlow](../resources/industrydata-administrativeUnitProvisioningFlow.md) +- [classGroupProvisioningFlow](../resources/industrydata-classGroupProvisioningFlow.md) +- [securityGroupProvisioningFlow](../resources/industrydata-securityGroupProvisioningFlow.md) +- [userProvisioningFlow](../resources/industrydata-userProvisioningFlow.md) ++## Response ++If successful, this method returns a `201 Created` response code and a [provisioningFlow](../resources/industrydata-provisioningflow.md) object in the response body. ++## Examples ++### Example 1: Create an administrativeUnitProvisioningFlow ++#### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "post_adminunit" +}--> ++```http +POST https://graph.microsoft.com/beta/external/industryData/OutboundProvisioningFlowSets/9ab41255-5364-4c53-e15c-08dc4ab6ee03/provisioningFlows +Content-type: application/json ++{ + "@odata.type": "#microsoft.graph.industryData.administrativeUnitProvisioningFlow", + "creationOptions": + { + "createBasedOnOrg": true, + "createBasedOnOrgPlusroleGroup": true + } +} +``` ++# [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. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.industryData.provisioningFlow" +} --> ++```http +HTTP/1.1 201 Created +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#external/industryData/outboundProvisioningFlowSets('9ab41255-5364-4c53-e15c-08dc4ab6ee03')/provisioningFlows/$entity", + "@odata.type": "#microsoft.graph.industryData.administrativeUnitProvisioningFlow", + "id": "f66e97ad-0870-46e0-3ff3-08dc49dccdc9", + "createdDateTime": "2024-03-22T21:28:02.7164229Z", + "lastModifiedDateTime": "2024-03-22T21:28:02.7164229Z", + "readinessStatus": "notReady", + "creationOptions": { + "createBasedOnOrg": true, + "createBasedOnOrgPlusRoleGroup": true + } +} +``` ++### Example 2: Create a classGroupProvisioningFlow ++#### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "post_classgroup" +}--> ++```http +POST https://graph.microsoft.com/beta/external/industryData/OutboundProvisioningFlowSets/9ab41255-5364-4c53-e15c-08dc4ab6ee03/provisioningFlows +Content-type: application/json ++{ + "@odata.type": "#microsoft.graph.industryData.classGroupProvisioningFlow", + "configuration": { + "@odata.type": "#microsoft.graph.industryData.classGroupConfiguration", + "additionalAttributes": [ + "courseTitle", + "courseCode", + "courseSubject", + "courseGradeLevel", + "courseExternalId", + "academicSessionTitle", + "academicSessionExternalId" + ], + "additionalOptions": { + "@odata.type": "#microsoft.graph.industryData.additionalClassGroupOptions", + "createTeam": true, + "writeDisplayNameOnCreateOnly": true + }, + "enrollmentMappings": { + "@odata.type": "#microsoft.graph.industryData.enrollmentMappings", + "ownerEnrollmentMappings": [ + { + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "teacher" + }, + { + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "proctor" + }, + { + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "teacherAssistant" + }, + { + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "paraProfessional" + }, + { + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "physicalTherapist" + }, + { + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "speechTherapist" + }, + { + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "visionTherapist" + }, + { + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "occupationalTherapist" + }, + { + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "staff" + } + ], + "memberEnrollmentMappings": [ + { + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "student" + }, + { + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "substitute" + }, + { + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "aide" + }, + { + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "proctor" + }, + { + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "teacherAssistant" + }, + { + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "paraProfessional" + }, + { + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "physicalTherapist" + }, + { + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "speechTherapist" + }, + { + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "visionTherapist" + }, + { + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "occupationalTherapist" + }, + { + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "staff" + } + ] + } + } +} +``` ++# [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. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.industryData.provisioningFlow" +} --> ++```http +HTTP/1.1 201 Created +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#external/industryData/outboundProvisioningFlowSets('9ab41255-5364-4c53-e15c-08dc4ab6ee03')/provisioningFlows/$entity", + "@odata.type": "#microsoft.graph.industryData.classGroupProvisioningFlow", + "id": "417a82c8-7caa-4f82-3ac6-08dc4ac6fb7f", + "createdDateTime": "2024-03-22T23:34:18.5035988Z", + "lastModifiedDateTime": "2024-03-22T23:34:18.5035988Z", + "readinessStatus": "notReady", + "configuration": { + "additionalAttributes": [ + "courseTitle", + "courseCode", + "courseSubject", + "courseGradeLevel", + "courseExternalId", + "academicSessionTitle", + "academicSessionExternalId" + ], + "additionalOptions": { + "createTeam": true, + "writeDisplayNameOnCreateOnly": true + }, + "enrollmentMappings": { + "ownerEnrollmentMappings": [ + { + "code": "teacher" + }, + { + "code": "proctor" + }, + { + "code": "teacherAssistant" + }, + { + "code": "paraprofessional" + }, + { + "code": "physicalTherapist" + }, + { + "code": "speechTherapist" + }, + { + "code": "visionTherapist" + }, + { + "code": "occupationalTherapist" + }, + { + "code": "staff" + } + ], + "memberEnrollmentMappings": [ + { + "code": "student" + }, + { + "code": "substitute" + }, + { + "code": "aide" + }, + { + "code": "proctor" + }, + { + "code": "teacherAssistant" + }, + { + "code": "paraprofessional" + }, + { + "code": "physicalTherapist" + }, + { + "code": "speechTherapist" + }, + { + "code": "visionTherapist" + }, + { + "code": "occupationalTherapist" + }, + { + "code": "staff" + } + ] + } + } +} +``` ++### Example 3: Create a securityGroupProvisioningFlow ++#### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "post_securitygroup" +}--> ++```http +POST https://graph.microsoft.com/beta/external/industryData/OutboundProvisioningFlowSets/9ab41255-5364-4c53-e15c-08dc4ab6ee03/provisioningFlows +Content-type: application/json ++{ + "@odata.type": "#microsoft.graph.industryData.securityGroupProvisioningFlow", + "creationOptions": + { + "createBasedOnroleGroup": true, + "createBasedOnOrgPlusroleGroup": false + } +} +``` ++# [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. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.industryData.provisioningFlow" +} --> ++```http +HTTP/1.1 201 Created +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#external/industryData/outboundProvisioningFlowSets('9ab41255-5364-4c53-e15c-08dc4ab6ee03')/provisioningFlows/$entity", + "@odata.type": "#microsoft.graph.industryData.securityGroupProvisioningFlow", + "id": "4598f62a-7bd9-40a1-d38a-08dc4ac68cf2", + "createdDateTime": "2024-03-22T23:55:06.3141592Z", + "lastModifiedDateTime": "2024-03-22T23:55:06.3141592Z", + "readinessStatus": "notReady", + "creationOptions": { + "createBasedOnRoleGroup": true, + "createBasedOnOrgPlusRoleGroup": false + } +} +``` ++### Example 4: Create a userProvisioningFlow ++#### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "post_user" +}--> ++```http +POST https://graph.microsoft.com/beta/external/industryData/OutboundProvisioningFlowSets/9ab41255-5364-4c53-e15c-08dc4ab6ee03/provisioningFlows +Content-type: application/json ++{ + "@odata.type": "#microsoft.graph.industryData.userProvisioningFlow", + "createUnmatchedUsers": true, + "managementOptions": + { + "additionalAttributes": ["userGradeLevel"], + "additionalOptions": + { + "markAllStudentsAsMinors": true, + "allowStudentContactAssociation" : false + } + }, + "creationOptions": + { + "configurations": [ + { + "roleGroup@odata.bind": "https://graph.microsoft.com/beta/external/industryData/roleGroups/staff", + "defaultPasswordSettings": + { + "@odata.type": "#microsoft.graph.industryData.simplePasswordSettings", + "password": "********" + }, + "licenseSkus": [ "Sku1"] + }, + { + "roleGroup@odata.bind": "https://graph.microsoft.com/beta/external/industryData/roleGroups/students", + "defaultPasswordSettings": + { + "@odata.type": "#microsoft.graph.industryData.simplePasswordSettings", + "password": "********" + }, + "licenseSkus": [ "Sku2"] + } + ] + } +} +``` ++# [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. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.industryData.provisioningFlow" +} --> ++```http +HTTP/1.1 201 Created +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#external/industryData/outboundProvisioningFlowSets('9ab41255-5364-4c53-e15c-08dc4ab6ee03')/provisioningFlows/$entity", + "@odata.type": "#microsoft.graph.industryData.userProvisioningFlow", + "id": "dbd36d16-c574-4ed8-3ac7-08dc4ac6fb7f", + "createdDateTime": "2024-03-23T00:24:32.3286035Z", + "lastModifiedDateTime": "2024-03-23T00:24:32.3286035Z", + "readinessStatus": "notReady", + "createUnmatchedUsers": true, + "managementOptions": { + "additionalAttributes": [ + "userGradeLevel" + ], + "additionalOptions": { + "markAllStudentsAsMinors": true, + "allowStudentContactAssociation": false + } + }, + "creationOptions": { + "configurations": [ + { + "licenseSkus": [ + "Sku1" + ], + "defaultPasswordSettings": { + "@odata.type": "#microsoft.graph.industryData.simplePasswordSettings", + "password": "***************" + } + }, + { + "licenseSkus": [ + "Sku2" + ], + "defaultPasswordSettings": { + "@odata.type": "#microsoft.graph.industryData.simplePasswordSettings", + "password": "***************" + } + } + ] + } +} +``` |
v1.0 | Industrydata Outboundprovisioningflowset Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-outboundprovisioningflowset-update.md | + + Title: "Update outboundProvisioningFlowSet" +description: "Update the properties of an outboundProvisioningFlowSet object." ++ms.localizationpriority: medium ++++# Update outboundProvisioningFlowSet ++Namespace: microsoft.graph.industryData +++Update the properties of an [outboundProvisioningFlowSet](../resources/industrydata-outboundprovisioningflowset.md) object. +++## 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": "industrydata-outboundprovisioningflowset-update-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +PATCH /external/industryData/outboundProvisioningFlowSets/{id} +``` ++## Request headers ++| Name | Description | +| : | :-- | +| Authorization | Bearer {token}. Required. | +| Content-Type | application/json. Required. | ++## Request body +++| Property | Type | Description | +| :- | :- | :- | +| displayName | String | The display name of the flowSet provided by the caller. Required. | +| filter | [microsoft.graph.industryData.filter](../resources/industrydata-filter.md) | The collection of provisioning filters applicable to all the flows under the given flowSet. Optional. | ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_outboundprovisioningflowset" +} +--> ++```http +PATCH https://graph.microsoft.com/beta/external/industryData/OutboundProvisioningFlowSets/8ac3c08f-6f93-465b-4bd9-08dc4ac773d0 +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.industryData.outboundProvisioningFlowSet", + "displayName": "Outbound provisioning flow Updated" +} +``` ++# [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. ++<!-- { + "blockType": "response", + "truncated": true +} +--> ++```http +HTTP/1.1 204 No Content +``` |
v1.0 | Industrydata Securitygroupprovisioningflow Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-securitygroupprovisioningflow-delete.md | + + Title: "Delete securityGroupProvisioningFlow" +description: "Delete a securityGroupProvisioningFlow object." ++ms.localizationpriority: medium ++++# Delete securityGroupProvisioningFlow ++Namespace: microsoft.graph.industryData +++Delete a [securityGroupProvisioningFlow](../resources/industrydata-securitygroupprovisioningflow.md) object. +++## 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": "industrydata-securitygroupprovisioningflow-delete-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +DELETE /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlows/{id} +``` ++## Request headers ++| Name | Description | +| : | : | +| Authorization | Bearer {token}. Required. | ++## Request body ++Don't supply a request body for this method. ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_securitygroupprovisioningflow" +} +--> ++```http +DELETE https://graph.microsoft.com/beta/external/industryData/OutboundProvisioningFlowSets/9ab41255-5364-4c53-e15c-08dc4ab6ee03/provisioningFlows/4598f62a-7bd9-40a1-d38a-08dc4ac68cf2 +``` ++# [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. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true +} +--> ++```http +HTTP/1.1 204 No Content +``` |
v1.0 | Industrydata Securitygroupprovisioningflow Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-securitygroupprovisioningflow-get.md | + + Title: "Get securityGroupProvisioningFlow" +description: "Read the properties and relationships of a securityGroupProvisioningFlow object." ++ms.localizationpriority: medium ++++# Get securityGroupProvisioningFlow ++Namespace: microsoft.graph.industryData +++Read the properties and relationships of a [securityGroupProvisioningFlow](../resources/industrydata-securitygroupprovisioningflow.md) object. +++## 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": "industrydata-securitygroupprovisioningflow-get-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +GET /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlows/{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. | ++## Request body ++Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [securityGroupProvisioningFlow](../resources/industrydata-securitygroupprovisioningflow.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_securitygroupprovisioningflow" +} +--> ++```msgraph-interactive +GET https://graph.microsoft.com/beta/external/industryData/OutboundProvisioningFlowSets/9ab41255-5364-4c53-e15c-08dc4ab6ee03/provisioningFlows/4598f62a-7bd9-40a1-d38a-08dc4ac68cf2 +``` ++# [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. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.industryData.securityGroupProvisioningFlow" +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#external/industryData/outboundProvisioningFlowSets('9ab41255-5364-4c53-e15c-08dc4ab6ee03')/provisioningFlows/$entity", + "@odata.type": "#microsoft.graph.industryData.securityGroupProvisioningFlow", + "id": "4598f62a-7bd9-40a1-d38a-08dc4ac68cf2", + "createdDateTime": "2024-03-22T23:55:06.3141592Z", + "lastModifiedDateTime": "2024-03-22T23:55:06.3141592Z", + "readinessStatus": "disabled", + "creationOptions": { + "createBasedOnRoleGroup": true, + "createBasedOnOrgPlusRoleGroup": false + } +} +``` |
v1.0 | Industrydata Securitygroupprovisioningflow Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-securitygroupprovisioningflow-update.md | + + Title: "Update securityGroupProvisioningFlow" +description: "Update the properties of a securityGroupProvisioningFlow object." ++ms.localizationpriority: medium ++++# Update securityGroupProvisioningFlow ++Namespace: microsoft.graph.industryData +++Update the properties of a [securityGroupProvisioningFlow](../resources/industrydata-securitygroupprovisioningflow.md) object. +++## 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": "industrydata-securitygroupprovisioningflow-update-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +PATCH /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlows/{id} +``` ++## Request headers ++| Name | Description | +| : | :-- | +| Authorization | Bearer {token}. Required. | +| Content-Type | application/json. Required. | ++## Request body +++| Property | Type | Description | +| :-- | : | :-- | +| creationOptions | [microsoft.graph.industryData.securityGroupCreationOptions](../resources/industrydata-securitygroupcreationoptions.md) | The different attribute choices for the class groups to be provisioned. Required. | ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_securitygroupprovisioningflow" +} +--> ++```http +PATCH https://graph.microsoft.com/beta/external/industryData/OutboundProvisioningFlowSets/9ab41255-5364-4c53-e15c-08dc4ab6ee03/provisioningFlows/4598f62a-7bd9-40a1-d38a-08dc4ac68cf2 +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.industryData.securityGroupProvisioningFlow", + "creationOptions": + { + "createBasedOnRoleGroup": true, + "createBasedOnOrgPlusRoleGroup": true + } +} +``` ++# [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. ++<!-- { + "blockType": "response", + "truncated": true +} +--> ++```http +HTTP/1.1 204 No Content +``` |
v1.0 | Industrydata Userprovisioningflow Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-userprovisioningflow-delete.md | + + Title: "Delete userProvisioningFlow" +description: "Delete a userProvisioningFlow object." ++ms.localizationpriority: medium ++++# Delete userProvisioningFlow ++Namespace: microsoft.graph.industryData +++Delete a [userProvisioningFlow](../resources/industrydata-userprovisioningflow.md) object. +++## 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": "industrydata-userprovisioningflow-delete-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +DELETE /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlows/{id} +``` ++## Request headers ++| Name | Description | +| : | : | +| Authorization | Bearer {token}. Required. | ++## Request body ++Don't supply a request body for this method. ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_userprovisioningflow" +} +--> ++```http +DELETE https://graph.microsoft.com/beta/external/industryData/OutboundProvisioningFlowSets/9ab41255-5364-4c53-e15c-08dc4ab6ee03/provisioningFlows/dbd36d16-c574-4ed8-3ac7-08dc4ac6fb7f +``` ++# [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. ++<!-- { + "blockType": "response", + "truncated": true +} +--> ++```http +HTTP/1.1 204 No Content +``` |
v1.0 | Industrydata Userprovisioningflow Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-userprovisioningflow-get.md | + + Title: "Get userProvisioningFlow" +description: "Read the properties and relationships of a userProvisioningFlow object." ++ms.localizationpriority: medium ++++# Get userProvisioningFlow ++Namespace: microsoft.graph.industryData +++Read the properties and relationships of a [userProvisioningFlow](../resources/industrydata-userprovisioningflow.md) object. +++## 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": "industrydata-userprovisioningflow-get-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +GET /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlows/{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. | ++## Request body ++Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [userProvisioningFlow](../resources/industrydata-userprovisioningflow.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_userprovisioningflow" +} +--> ++```msgraph-interactive +GET https://graph.microsoft.com/beta/external/industryData/OutboundProvisioningFlowSets/9ab41255-5364-4c53-e15c-08dc4ab6ee03/provisioningFlows/dbd36d16-c574-4ed8-3ac7-08dc4ac6fb7f +``` ++# [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. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.industryData.userProvisioningFlow" +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/testprodbetalocal_sds-ppe/$metadata#external/industryData/outboundProvisioningFlowSets('9ab41255-5364-4c53-e15c-08dc4ab6ee03')/provisioningFlows/$entity", + "@odata.type": "#microsoft.graph.industryData.userProvisioningFlow", + "id": "dbd36d16-c574-4ed8-3ac7-08dc4ac6fb7f", + "createdDateTime": "2024-03-23T00:24:32.3286035Z", + "lastModifiedDateTime": "2024-03-23T00:24:32.3286035Z", + "readinessStatus": "disabled", + "createUnmatchedUsers": true, + "managementOptions": { + "additionalAttributes": [ + "userGradeLevel" + ], + "additionalOptions": { + "markAllStudentsAsMinors": true, + "allowStudentContactAssociation": false + } + }, + "creationOptions": { + "configurations": [ + { + "licenseSkus": [ + "Sku1" + ], + "defaultPasswordSettings": { + "@odata.type": "#microsoft.graph.industryData.simplePasswordSettings", + "password": "***************" + }, + "roleGroup@odata.context": "https://graph.microsoft.com/beta/$metadata#external/industryData/outboundProvisioningFlowSets('9ab41255-5364-4c53-e15c-08dc4ab6ee03')/provisioningFlows('dbd36d16-c574-4ed8-3ac7-08dc4ac6fb7f')/microsoft.graph.industryData.userProvisioningFlow/creationOptions/configurations/roleGroup/$entity", + "roleGroup": { + "id": "students", + "displayName": "Students", + "roles": [ + { + "code": "student" + } + ] + } + }, + { + "licenseSkus": [ + "Sku2" + ], + "defaultPasswordSettings": { + "@odata.type": "#microsoft.graph.industryData.simplePasswordSettings", + "password": "***************" + }, + "roleGroup@odata.context": "https://canary.graph.microsoft.com/testprodbetalocal_sds-ppe/$metadata#external/industryData/outboundProvisioningFlowSets('9ab41255-5364-4c53-e15c-08dc4ab6ee03')/provisioningFlows('dbd36d16-c574-4ed8-3ac7-08dc4ac6fb7f')/microsoft.graph.industryData.userProvisioningFlow/creationOptions/configurations/roleGroup/$entity", + "roleGroup": { + "id": "staff", + "displayName": "Staff", + "roles": [ + { + "code": "adjunct" + }, + { + "code": "administrator" + }, + { + "code": "advisor" + }, + { + "code": "affiliate" + }, + { + "code": "aide" + }, + { + "code": "alumni" + }, + { + "code": "assistant" + }, + { + "code": "chair" + }, + { + "code": "coach" + }, + { + "code": "faculty" + }, + { + "code": "instructor" + }, + { + "code": "itAdmin" + }, + { + "code": "lecturer" + }, + { + "code": "nurse" + }, + { + "code": "occupationalTherapist" + }, + { + "code": "officeStaff" + }, + { + "code": "paraprofessional" + }, + { + "code": "physicalTherapist" + }, + { + "code": "principal" + }, + { + "code": "proctor" + }, + { + "code": "professor" + }, + { + "code": "researcher" + }, + { + "code": "specialServices" + }, + { + "code": "speechTherapist" + }, + { + "code": "staff" + }, + { + "code": "substitute" + }, + { + "code": "teacher" + }, + { + "code": "teacherAssistant" + }, + { + "code": "visionTherapist" + } + ] + } + } + ] + } +} +``` |
v1.0 | Industrydata Userprovisioningflow Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-userprovisioningflow-update.md | + + Title: "Update userProvisioningFlow" +description: "Update the properties of a userProvisioningFlow object." ++ms.localizationpriority: medium ++++# Update userProvisioningFlow ++Namespace: microsoft.graph.industryData +++Update the properties of a [userProvisioningFlow](../resources/industrydata-userprovisioningflow.md) object. +++## 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": "industrydata-userprovisioningflow-update-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +PATCH /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlows/{id} +``` ++## Request headers ++| Name | Description | +| : | :-- | +| Authorization | Bearer {token}. Required. | +| Content-Type | application/json. Required. | ++## Request body +++| Property | Type | Description | +| :- | :-- | : | +| createUnmatchedUsers | Boolean | A boolean choice indicating whether unmatched users should be created or ignored. Optional. | +| managementOptions | [microsoft.graph.industryData.userManagementOptions](../resources/industrydata-usermanagementoptions.md) | The different attribute choices for all the users to be considered. Required. | +| creationOptions | [microsoft.graph.industryData.userCreationOptions](../resources/industrydata-usercreationoptions.md) | The different management choices for the new users to be provisioned. Optional. | ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_userprovisioningflow" +} +--> ++```http +PATCH https://graph.microsoft.com/beta/external/industryData/OutboundProvisioningFlowSets/9ab41255-5364-4c53-e15c-08dc4ab6ee03/provisioningFlows/dbd36d16-c574-4ed8-3ac7-08dc4ac6fb7f +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.industryData.userProvisioningFlow", + "createUnmatchedUsers": true, + "managementOptions": + { + "additionalAttributes": ["userGradeLevel"], + "additionalOptions": + { + "markAllStudentsAsMinors": true, + "allowStudentContactAssociation" : true + } + }, + "creationOptions": + { + "configurations": [ + { + "roleGroup@odata.bind": "https://graph.microsoft.com/beta/external/industryData/roleGroups/staff", + "defaultPasswordSettings": + { + "@odata.type": "#microsoft.graph.industryData.simplePasswordSettings", + "password": "********" + }, + "licenseSkus": [ "SkuUpdated"] + }, + { + "roleGroup@odata.bind": "https://graph.microsoft.com/beta/external/industryData/roleGroups/students", + "defaultPasswordSettings": + { + "@odata.type": "#microsoft.graph.industryData.simplePasswordSettings", + "password": "********" + }, + "licenseSkus": [ "SkuUpdated2"] + } + ] + } +} +``` ++# [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. ++<!-- { + "blockType": "response", + "truncated": true +} +--> ++```http +HTTP/1.1 204 No Content +``` |
v1.0 | Insightssettings Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/insightssettings-update.md | To learn more about customizing insights privacy for your organization, see: The following tables show the least privileged permission or permissions required to call this API on each supported resource type. Follow [best practices](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions) to request least privileged 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). +### To update **contact insights** settings for an organization <!-- { "blockType": "permissions", "name": "insightssettings_update" } --> [!INCLUDE [permissions-table](../includes/permissions/insightssettings-update-permissions.md)] -To update settings for item insights or people insights, one of the following permissions is required to call this API. To learn more, including how to choose permissions, see [permissions](/graph/permissions-reference). +### To update **item insights** settings for an organization <!-- { "blockType": "permissions", "name": "insightssettings_update_2" } --> [!INCLUDE [permissions-table](../includes/permissions/insightssettings-update-2-permissions.md)] +### To update **people insights** settings for an organization +<!-- { "blockType": "permissions", "name": "insightssettings_update_3" } --> >**Note:** Using delegated permissions for this operation to update insights for contacts, item, or people requires the signed-in user to have a Global Administrator role. To update settings for item insights: <!-- { "blockType": "ignored" } --> ```http-PATCH /organization/{organizationId}/settings/itemInsights +PATCH /admin/people/itemInsights ``` To update settings for people insights: PATCH /organization/{organizationId}/settings/peopleInsights | Property | Type |Description| |:|:--|:-| |disabledForGroup|String| The ID of a Microsoft Entra group, of which the specified type of insights are disabled for its members. Default is `empty`. Optional.|-|isEnabledInOrganization|Boolean| `true` if the specified type of insights are enabled for the organization; `false` if the specified type of insights are disabled for all users without exceptions. Default is `true`. Optional.| +|isEnabledInOrganization|Boolean| `true` if the specified insight type is enabled for the organization; `false` if the specified insight type is disabled for all users without exceptions. Default is `true`. Optional.| >**Note:** This operation does not verify the **disabledForGroup** property value if you include it in the request body. If you set the **disabledForGroup** property to a String, this operation does not check the existence of the corresponding Microsoft Entra group. This means, if you set **disabledForGroup** to a Microsoft Entra group that does not exist or is deleted afterwards, this operation will not be able to identify any group membership and disable item or people insights for any specific users. If **isEnabledInOrganization** is set to `true`, the operation will enable the specified type of insights for _all_ the users in the organization. The following example shows how an admin updates the **disabledForGroup** privac }--> ```http-PATCH https://graph.microsoft.com/beta/organization/{organizationId}/settings/itemInsights +PATCH https://graph.microsoft.com/beta/admin/people/itemInsights Content-type: application/json { |
v1.0 | Internaldomainfederation Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/internaldomainfederation-delete.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "internaldomainfederation_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/internaldomainfederation-delete-permissions.md)] +> [!IMPORTANT] +> This method has a [known permissions issue](https://developer.microsoft.com/en-us/graph/known-issues/?search=21445) and might require consenting to the *Directory.AccessAsUser.All* permission for delegated scenarios. ++<!-- Domain Name Administrator and Hybrid Identity Administrator can't delete federated domains --> The calling user must be assigned one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): - Security Administrator |
v1.0 | Internaldomainfederation Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/internaldomainfederation-update.md | Title: "Update internalDomainFederation" description: "Update the properties of an internalDomainFederation object." ms.localizationpriority: medium-+ doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "internaldomainfederation_update" } --> [!INCLUDE [permissions-table](../includes/permissions/internaldomainfederation-update-permissions.md)] +> [!IMPORTANT] +> This method has a [known permissions issue](https://developer.microsoft.com/en-us/graph/known-issues/?search=21445) and might require consenting to the *Directory.AccessAsUser.All* permission for delegated scenarios. + [!INCLUDE [rbac-domainfederation-apis-write](../includes/rbac-for-apis/rbac-domainfederation-apis-write.md)] ## HTTP request PATCH /domains/{domainsId}/federationConfiguration/{internalDomainFederationId} |passiveSignInUri|String|URI that web-based clients are directed to when signing into Microsoft Entra services. | |preferredAuthenticationProtocol|authenticationProtocol|Preferred authentication protocol. The possible values are: `wsFed`, `saml`, `unknownFutureValue`. | |promptLoginBehavior|promptLoginBehavior|Sets the preferred behavior for the sign-in prompt. The possible values are: `translateToFreshPasswordAuthentication`, `nativeSupport`, `disabled`, `unknownFutureValue`.|-|signingCertificate|String|Current certificate used to sign tokens passed to the Microsoft identity platform. The certificate is formatted as a Base 64 encoded string of the public portion of the federated IdP's token signing certificate and must be compatible with the X509Certificate2 class. <br>This property is used in the following scenarios: <li> If a rollover is required outside of the autorollover update <li> A new federation service is being set up <li> If the new token signing certificate isn't present in the federation properties after the federation service certificate has been updated.<br>Microsoft Entra ID updates certificates via an autorollover process in which it attempts to retrieve a new certificate from the federation service metadata, 30 days before expiry of the current certificate. If a new certificate isn't available, Microsoft Entra ID monitors the metadata daily and will update the federation settings for the domain when a new certificate is available. Inherited from [samlOrWsFedProvider](../resources/samlorwsfedprovider.md).| +|signingCertificate|String|Current certificate used to sign tokens passed to the Microsoft identity platform. The certificate is formatted as a Base 64 encoded string of the public portion of the federated IdP's token signing certificate and must be compatible with the X509Certificate2 class. <br>This property is used in the following scenarios: <li> If a rollover is required outside of the autorollover update <li> A new federation service is being set up <li> If the new token signing certificate isn't present in the federation properties after the federation service certificate has been updated.<br>Microsoft Entra ID updates certificates via an autorollover process in which it attempts to retrieve a new certificate from the federation service metadata, 30 days before expiry of the current certificate. If a new certificate isn't available, Microsoft Entra ID monitors the metadata daily and updates the federation settings for the domain when a new certificate is available. Inherited from [samlOrWsFedProvider](../resources/samlorwsfedprovider.md).| |signingCertificateUpdateStatus|[signingCertificateUpdateStatus](../resources/signingcertificateupdatestatus.md)|Provides status and timestamp of the last update of the signing certificate.| |signOutUri|String|URI that clients are redirected to when they sign out of Microsoft Entra services. Corresponds to the **LogOffUri** property of the [Set-MsolDomainFederationSettings MSOnline v1 PowerShell cmdlet](/powershell/module/msonline/set-msoldomainfederationsettings).| + ### federatedIdpMfaBehavior values | Member | Description | Content-Type: application/json "federatedIdpMfaBehavior": "acceptIfMfaDoneByFederatedIdp" } ```++<!-- +{ + "type": "#page.annotation", + "description": "", + "keywords": "", + "section": "documentation", + "tocPath": "", + "suppressions": [ + "Error: /api/internaldomainfederation-update.md: + Exception processing links. + Link Definition was null. Link text: !INCLUDE Azure AD PowerShell deprecation note (Parameter 'Definition')" + ] +} +--> |
v1.0 | Intune Apps Deviceappmanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-deviceappmanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceAppManagement](../resources/intune-apps-deviceappmanagement.md) object. +Read properties and relationships of the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceAppManagement](../resources/intune-apps-deviceappmanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object in the response body. ## Example |
v1.0 | Intune Apps Deviceappmanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-deviceappmanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceAppManagement](../resources/intune-apps-deviceappmanagement.md) object. +Update the properties of a [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceAppManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceAppManagement](../resources/intune-apps-deviceappmanagement.md) object. +In the request body, supply a JSON representation for the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object. -The following table shows the properties that are required when you create the [deviceAppManagement](../resources/intune-apps-deviceappmanagement.md). +The following table shows the properties that are required when you create the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceAppManagement](../resources/intune-apps-deviceappmanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object in the response body. ## Example |
v1.0 | Intune Apps Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-apps-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-apps-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Apps Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-apps-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-apps-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-apps-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-apps-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Apps Ioslobappprovisioningconfiguration Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-ioslobappprovisioningconfiguration-create.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Create a new [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) object. +Create a new [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] The following table shows the properties that are required when you create the i ## Response-If successful, this method returns a `201 Created` response code and a [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) object in the response body. +If successful, this method returns a `201 Created` response code and a [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) object in the response body. ## Example |
v1.0 | Intune Apps Ioslobappprovisioningconfiguration Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-ioslobappprovisioningconfiguration-delete.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Deletes a [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md). +Deletes a [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] |
v1.0 | Intune Apps Ioslobappprovisioningconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-ioslobappprovisioningconfiguration-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) object. +Read properties and relationships of the [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) object in the response body. +If successful, this method returns a `200 OK` response code and [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) object in the response body. ## Example |
v1.0 | Intune Apps Ioslobappprovisioningconfiguration List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-ioslobappprovisioningconfiguration-list.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -List properties and relationships of the [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) objects. +List properties and relationships of the [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) objects. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] GET /deviceAppManagement/iosLobAppProvisioningConfigurations Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and a collection of [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) objects in the response body. ## Example |
v1.0 | Intune Apps Ioslobappprovisioningconfiguration Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-ioslobappprovisioningconfiguration-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) object. +Update the properties of a [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceAppManagement/iosLobAppProvisioningConfigurations/{iosLobAppProvisi |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) object. +In the request body, supply a JSON representation for the [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) object. -The following table shows the properties that are required when you create the [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md). +The following table shows the properties that are required when you create the [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) object in the response body. ## Example |
v1.0 | Intune Apps Iosvppapp Revokealllicenses | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppapp-revokealllicenses.md | Content-length: 36 Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Apps Iosvppapp Revokedevicelicense | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppapp-revokedevicelicense.md | Content-length: 85 Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Apps Iosvppapp Revokeuserlicense | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppapp-revokeuserlicense.md | Content-length: 66 Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Apps Iosvppappassigneddevicelicense Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneddevicelicense-create.md | Content-Length: 376 "managedDeviceId": "Managed Device Id value", "deviceName": "Device Name value" }-``` +``` |
v1.0 | Intune Apps Iosvppappassigneddevicelicense Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneddevicelicense-delete.md | DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAp Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Apps Iosvppappassigneddevicelicense Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneddevicelicense-get.md | Content-Length: 411 "deviceName": "Device Name value" } }-``` +``` |
v1.0 | Intune Apps Iosvppappassigneddevicelicense List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneddevicelicense-list.md | Content-Length: 441 } ] }-``` +``` |
v1.0 | Intune Apps Iosvppappassigneddevicelicense Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneddevicelicense-update.md | Content-Length: 376 "managedDeviceId": "Managed Device Id value", "deviceName": "Device Name value" }-``` +``` |
v1.0 | Intune Apps Iosvppappassignedlicense Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassignedlicense-create.md | Content-Length: 283 "userName": "User Name value", "userPrincipalName": "User Principal Name value" }-``` +``` |
v1.0 | Intune Apps Iosvppappassignedlicense Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassignedlicense-delete.md | DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAp Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Apps Iosvppappassignedlicense Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassignedlicense-get.md | Content-Length: 314 "userPrincipalName": "User Principal Name value" } }-``` +``` |
v1.0 | Intune Apps Iosvppappassignedlicense List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassignedlicense-list.md | Content-Length: 340 } ] }-``` +``` |
v1.0 | Intune Apps Iosvppappassignedlicense Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassignedlicense-update.md | Content-Length: 283 "userName": "User Name value", "userPrincipalName": "User Principal Name value" }-``` +``` |
v1.0 | Intune Apps Iosvppappassigneduserlicense Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneduserlicense-create.md | Content-Length: 287 "userName": "User Name value", "userPrincipalName": "User Principal Name value" }-``` +``` |
v1.0 | Intune Apps Iosvppappassigneduserlicense Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneduserlicense-delete.md | DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAp Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Apps Iosvppappassigneduserlicense Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneduserlicense-get.md | Content-Length: 318 "userPrincipalName": "User Principal Name value" } }-``` +``` |
v1.0 | Intune Apps Iosvppappassigneduserlicense List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneduserlicense-list.md | Content-Length: 344 } ] }-``` +``` |
v1.0 | Intune Apps Iosvppappassigneduserlicense Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneduserlicense-update.md | Content-Length: 287 "userName": "User Name value", "userPrincipalName": "User Principal Name value" }-``` +``` |
v1.0 | Intune Apps Macosvppappassignedlicense Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-macosvppappassignedlicense-create.md | Content-Length: 285 "userName": "User Name value", "userPrincipalName": "User Principal Name value" }-``` +``` |
v1.0 | Intune Apps Macosvppappassignedlicense Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-macosvppappassignedlicense-delete.md | DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAp Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Apps Macosvppappassignedlicense Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-macosvppappassignedlicense-get.md | Content-Length: 316 "userPrincipalName": "User Principal Name value" } }-``` +``` |
v1.0 | Intune Apps Macosvppappassignedlicense List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-macosvppappassignedlicense-list.md | Content-Length: 342 } ] }-``` +``` |
v1.0 | Intune Apps Macosvppappassignedlicense Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-macosvppappassignedlicense-update.md | Content-Length: 285 "userName": "User Name value", "userPrincipalName": "User Principal Name value" }-``` +``` |
v1.0 | Intune Apps Microsoftstoreforbusinesscontainedapp Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-microsoftstoreforbusinesscontainedapp-create.md | Content-Length: 176 "id": "bf1d79df-79df-bf1d-df79-1dbfdf791dbf", "appUserModelId": "App User Model Id value" }-``` +``` |
v1.0 | Intune Apps Microsoftstoreforbusinesscontainedapp Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-microsoftstoreforbusinesscontainedapp-delete.md | DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAp Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Apps Microsoftstoreforbusinesscontainedapp Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-microsoftstoreforbusinesscontainedapp-get.md | Content-Length: 201 "appUserModelId": "App User Model Id value" } }-``` +``` |
v1.0 | Intune Apps Microsoftstoreforbusinesscontainedapp List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-microsoftstoreforbusinesscontainedapp-list.md | Content-Length: 221 } ] }-``` +``` |
v1.0 | Intune Apps Microsoftstoreforbusinesscontainedapp Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-microsoftstoreforbusinesscontainedapp-update.md | Content-Length: 176 "id": "bf1d79df-79df-bf1d-df79-1dbfdf791dbf", "appUserModelId": "App User Model Id value" }-``` +``` |
v1.0 | Intune Apps Mobileapp Createcatalogapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileapp-createcatalogapp.md | Content-Length: 1010 "supersededAppCount": 2 } }-``` +``` |
v1.0 | Intune Apps Mobileapp Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileapp-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [mobileApp](../resources/intune-apps-mobileapp.md) object. +Read properties and relationships of the [mobileApp](../resources/intune-shared-mobileapp.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [mobileApp](../resources/intune-apps-mobileapp.md) object in the response body. +If successful, this method returns a `200 OK` response code and [mobileApp](../resources/intune-shared-mobileapp.md) object in the response body. ## Example |
v1.0 | Intune Apps Mobileapp Getpublishingconstraints | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileapp-getpublishingconstraints.md | Content-Length: 245 } } }-``` +``` |
v1.0 | Intune Apps Mobileapp List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileapp-list.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -List properties and relationships of the [mobileApp](../resources/intune-apps-mobileapp.md) objects. +List properties and relationships of the [mobileApp](../resources/intune-shared-mobileapp.md) objects. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] GET /deviceAppManagement/mobileApps Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and a collection of [mobileApp](../resources/intune-apps-mobileapp.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [mobileApp](../resources/intune-shared-mobileapp.md) objects in the response body. ## Example |
v1.0 | Intune Apps Mobileappcontent Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontent-create.md | Content-Length: 107 "@odata.type": "#microsoft.graph.mobileAppContent", "id": "fe0bb9a9-b9a9-fe0b-a9b9-0bfea9b90bfe" }-``` +``` |
v1.0 | Intune Apps Mobileappcontent Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontent-delete.md | DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAp Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Apps Mobileappcontent Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontent-get.md | Content-Length: 130 "id": "fe0bb9a9-b9a9-fe0b-a9b9-0bfea9b90bfe" } }-``` +``` |
v1.0 | Intune Apps Mobileappcontent List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontent-list.md | Content-Length: 148 } ] }-``` +``` |
v1.0 | Intune Apps Mobileappcontent Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontent-update.md | Content-Length: 107 "@odata.type": "#microsoft.graph.mobileAppContent", "id": "fe0bb9a9-b9a9-fe0b-a9b9-0bfea9b90bfe" }-``` +``` |
v1.0 | Intune Apps Mobileappcontentfile Commit | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontentfile-commit.md | Content-length: 399 Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Apps Mobileappcontentfile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontentfile-create.md | Content-Length: 555 "isFrameworkFile": true, "isDependency": true }-``` +``` |
v1.0 | Intune Apps Mobileappcontentfile Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontentfile-delete.md | DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAp Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Apps Mobileappcontentfile Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontentfile-get.md | Content-Length: 604 "isDependency": true } }-``` +``` |
v1.0 | Intune Apps Mobileappcontentfile List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontentfile-list.md | Content-Length: 648 } ] }-``` +``` |
v1.0 | Intune Apps Mobileappcontentfile Renewupload | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontentfile-renewupload.md | POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppI Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Apps Mobileappcontentfile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontentfile-update.md | Content-Length: 555 "isFrameworkFile": true, "isDependency": true }-``` +``` |
v1.0 | Intune Apps Mobileappinstallstatus Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappinstallstatus-create.md | The following table shows the properties that are required when you create the m |deviceName|String|Device name| |deviceId|String|Device ID| |lastSyncDateTime|DateTimeOffset|Last sync date time|-|mobileAppInstallStatusValue|[resultantAppState](../resources/intune-apps-resultantappstate.md)|The install state of the app. Possible values are: `installed`, `failed`, `notInstalled`, `uninstallFailed`, `pendingInstall`, `unknown`, `notApplicable`.| -|installState|[resultantAppState](../resources/intune-apps-resultantappstate.md)|The install state of the app. Possible values are: `installed`, `failed`, `notInstalled`, `uninstallFailed`, `pendingInstall`, `unknown`, `notApplicable`.| +|mobileAppInstallStatusValue|[resultantAppState](../resources/intune-shared-resultantappstate.md)|The install state of the app. Possible values are: `installed`, `failed`, `notInstalled`, `uninstallFailed`, `pendingInstall`, `unknown`, `notApplicable`.| +|installState|[resultantAppState](../resources/intune-shared-resultantappstate.md)|The install state of the app. Possible values are: `installed`, `failed`, `notInstalled`, `uninstallFailed`, `pendingInstall`, `unknown`, `notApplicable`.| |installStateDetail|[resultantAppStateDetail](../resources/intune-apps-resultantappstatedetail.md)|The install state detail of the app. Possible values are: `noAdditionalDetails`, `dependencyFailedToInstall`, `dependencyWithRequirementsNotMet`, `dependencyPendingReboot`, `dependencyWithAutoInstallDisabled`, `supersededAppUninstallFailed`, `supersededAppUninstallPendingReboot`, `removingSupersededApps`, `iosAppStoreUpdateFailedToInstall`, `vppAppHasUpdateAvailable`, `userRejectedUpdate`, `uninstallPendingReboot`, `supersedingAppsDetected`, `supersededAppsDetected`, `seeInstallErrorCode`, `autoInstallDisabled`, `managedAppNoLongerPresent`, `userRejectedInstall`, `userIsNotLoggedIntoAppStore`, `untargetedSupersedingAppsDetected`, `appRemovedBySupersedence`, `seeUninstallErrorCode`, `pendingReboot`, `installingDependencies`, `contentDownloaded`, `supersedingAppsNotApplicable`, `powerShellScriptRequirementNotMet`, `registryRequirementNotMet`, `fileSystemRequirementNotMet`, `platformNotApplicable`, `minimumCpuSpeedNotMet`, `minimumLogicalProcessorCountNotMet`, `minimumPhysicalMemoryNotMet`, `minimumOsVersionNotMet`, `minimumDiskSpaceNotMet`, `processorArchitectureNotApplicable`.| |errorCode|Int32|The error code for install or uninstall failures.| |osVersion|String|OS Version| Content-Length: 604 "userPrincipalName": "User Principal Name value", "displayVersion": "Display Version value" }-``` +``` |
v1.0 | Intune Apps Mobileappinstallstatus Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappinstallstatus-delete.md | DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAp Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Apps Mobileappinstallstatus Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappinstallstatus-get.md | Content-Length: 651 "displayVersion": "Display Version value" } }-``` +``` |
v1.0 | Intune Apps Mobileappinstallstatus List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappinstallstatus-list.md | Content-Length: 693 } ] }-``` +``` |
v1.0 | Intune Apps Mobileappinstallstatus Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappinstallstatus-update.md | The following table shows the properties that are required when you create the [ |deviceName|String|Device name| |deviceId|String|Device ID| |lastSyncDateTime|DateTimeOffset|Last sync date time|-|mobileAppInstallStatusValue|[resultantAppState](../resources/intune-apps-resultantappstate.md)|The install state of the app. Possible values are: `installed`, `failed`, `notInstalled`, `uninstallFailed`, `pendingInstall`, `unknown`, `notApplicable`.| -|installState|[resultantAppState](../resources/intune-apps-resultantappstate.md)|The install state of the app. Possible values are: `installed`, `failed`, `notInstalled`, `uninstallFailed`, `pendingInstall`, `unknown`, `notApplicable`.| +|mobileAppInstallStatusValue|[resultantAppState](../resources/intune-shared-resultantappstate.md)|The install state of the app. Possible values are: `installed`, `failed`, `notInstalled`, `uninstallFailed`, `pendingInstall`, `unknown`, `notApplicable`.| +|installState|[resultantAppState](../resources/intune-shared-resultantappstate.md)|The install state of the app. Possible values are: `installed`, `failed`, `notInstalled`, `uninstallFailed`, `pendingInstall`, `unknown`, `notApplicable`.| |installStateDetail|[resultantAppStateDetail](../resources/intune-apps-resultantappstatedetail.md)|The install state detail of the app. Possible values are: `noAdditionalDetails`, `dependencyFailedToInstall`, `dependencyWithRequirementsNotMet`, `dependencyPendingReboot`, `dependencyWithAutoInstallDisabled`, `supersededAppUninstallFailed`, `supersededAppUninstallPendingReboot`, `removingSupersededApps`, `iosAppStoreUpdateFailedToInstall`, `vppAppHasUpdateAvailable`, `userRejectedUpdate`, `uninstallPendingReboot`, `supersedingAppsDetected`, `supersededAppsDetected`, `seeInstallErrorCode`, `autoInstallDisabled`, `managedAppNoLongerPresent`, `userRejectedInstall`, `userIsNotLoggedIntoAppStore`, `untargetedSupersedingAppsDetected`, `appRemovedBySupersedence`, `seeUninstallErrorCode`, `pendingReboot`, `installingDependencies`, `contentDownloaded`, `supersedingAppsNotApplicable`, `powerShellScriptRequirementNotMet`, `registryRequirementNotMet`, `fileSystemRequirementNotMet`, `platformNotApplicable`, `minimumCpuSpeedNotMet`, `minimumLogicalProcessorCountNotMet`, `minimumPhysicalMemoryNotMet`, `minimumOsVersionNotMet`, `minimumDiskSpaceNotMet`, `processorArchitectureNotApplicable`.| |errorCode|Int32|The error code for install or uninstall failures.| |osVersion|String|OS Version| Content-Length: 604 "userPrincipalName": "User Principal Name value", "displayVersion": "Display Version value" }-``` +``` |
v1.0 | Intune Apps Mobileappinstallsummary Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappinstallsummary-get.md | Content-Length: 466 "pendingInstallUserCount": 7 } }-``` +``` |
v1.0 | Intune Apps Mobileappinstallsummary Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappinstallsummary-update.md | Content-Length: 423 "notInstalledUserCount": 5, "pendingInstallUserCount": 7 }-``` +``` |
v1.0 | Intune Apps Mobilecontainedapp Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobilecontainedapp-get.md | Content-Length: 132 "id": "3c02d875-d875-3c02-75d8-023c75d8023c" } }-``` +``` |
v1.0 | Intune Apps Mobilecontainedapp List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobilecontainedapp-list.md | Content-Length: 150 } ] }-``` +``` |
v1.0 | Intune Apps Userappinstallstatus Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-userappinstallstatus-create.md | Content-Length: 288 "failedDeviceCount": 1, "notInstalledDeviceCount": 7 }-``` +``` |
v1.0 | Intune Apps Userappinstallstatus Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-userappinstallstatus-delete.md | DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAp Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Apps Userappinstallstatus Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-userappinstallstatus-get.md | Content-Length: 321 "notInstalledDeviceCount": 7 } }-``` +``` |
v1.0 | Intune Apps Userappinstallstatus List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-userappinstallstatus-list.md | Content-Length: 349 } ] }-``` +``` |
v1.0 | Intune Apps Userappinstallstatus Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-userappinstallstatus-update.md | Content-Length: 288 "failedDeviceCount": 1, "notInstalledDeviceCount": 7 }-``` +``` |
v1.0 | Intune Apps Windowsuniversalappxcontainedapp Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-windowsuniversalappxcontainedapp-create.md | Content-Length: 171 "id": "2d03284a-284a-2d03-4a28-032d4a28032d", "appUserModelId": "App User Model Id value" }-``` +``` |
v1.0 | Intune Apps Windowsuniversalappxcontainedapp Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-windowsuniversalappxcontainedapp-delete.md | DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAp Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Apps Windowsuniversalappxcontainedapp Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-windowsuniversalappxcontainedapp-get.md | Content-Length: 196 "appUserModelId": "App User Model Id value" } }-``` +``` |
v1.0 | Intune Apps Windowsuniversalappxcontainedapp List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-windowsuniversalappxcontainedapp-list.md | Content-Length: 216 } ] }-``` +``` |
v1.0 | Intune Apps Windowsuniversalappxcontainedapp Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-windowsuniversalappxcontainedapp-update.md | Content-Length: 171 "id": "2d03284a-284a-2d03-4a28-032d4a28032d", "appUserModelId": "App User Model Id value" }-``` +``` |
v1.0 | Intune Auditing Auditevent Getauditactivitytypes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-auditing-auditevent-getauditactivitytypes.md | Content-Length: 61 "Get Audit Activity Types value" ] }-``` +``` |
v1.0 | Intune Auditing Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-auditing-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-auditing-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-auditing-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Auditing Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-auditing-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-auditing-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-auditing-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-auditing-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-auditing-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Books Deviceappmanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-books-deviceappmanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceAppManagement](../resources/intune-books-deviceappmanagement.md) object. +Read properties and relationships of the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceAppManagement](../resources/intune-books-deviceappmanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object in the response body. ## Example |
v1.0 | Intune Books Deviceappmanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-books-deviceappmanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceAppManagement](../resources/intune-books-deviceappmanagement.md) object. +Update the properties of a [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceAppManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceAppManagement](../resources/intune-books-deviceappmanagement.md) object. +In the request body, supply a JSON representation for the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object. -The following table shows the properties that are required when you create the [deviceAppManagement](../resources/intune-books-deviceappmanagement.md). +The following table shows the properties that are required when you create the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceAppManagement](../resources/intune-books-deviceappmanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object in the response body. ## Example |
v1.0 | Intune Chromebooksync Chromeosonboardingsettings Connect | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-connect.md | Namespace: microsoft.graph ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Chromebooksync Chromeosonboardingsettings Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-create.md | Namespace: microsoft.graph Create a new [chromeOSOnboardingSettings](../resources/intune-chromebooksync-chromeosonboardingsettings.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Chromebooksync Chromeosonboardingsettings Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-delete.md | Namespace: microsoft.graph Deletes a [chromeOSOnboardingSettings](../resources/intune-chromebooksync-chromeosonboardingsettings.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Chromebooksync Chromeosonboardingsettings Disconnect | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-disconnect.md | Namespace: microsoft.graph ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Chromebooksync Chromeosonboardingsettings Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-get.md | Namespace: microsoft.graph Read properties and relationships of the [chromeOSOnboardingSettings](../resources/intune-chromebooksync-chromeosonboardingsettings.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Chromebooksync Chromeosonboardingsettings List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-list.md | Namespace: microsoft.graph List properties and relationships of the [chromeOSOnboardingSettings](../resources/intune-chromebooksync-chromeosonboardingsettings.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Chromebooksync Chromeosonboardingsettings Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-update.md | Namespace: microsoft.graph Update the properties of a [chromeOSOnboardingSettings](../resources/intune-chromebooksync-chromeosonboardingsettings.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Chromebooksync Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-chromebooksync-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-chromebooksync-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Chromebooksync Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-chromebooksync-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-chromebooksync-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-chromebooksync-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-chromebooksync-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Cloudpkigraphservice Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-cloudpkigraphservice-devicemanagement-get.md | + + Title: "Get deviceManagement" +description: "Read properties and relationships of the deviceManagement object." ++localization_priority: Normal ++++# Get deviceManagement ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. ++Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. +++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| ++## HTTP Request +<!-- { + "blockType": "ignored" +} +--> +``` http +GET /deviceManagement +``` ++## Optional query parameters +This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. ++## Request headers +|Header|Value| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Accept|application/json| ++## Request body +Do not supply a request body for this method. ++## Response +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ++## Example ++### Request +Here is an example of the request. +``` http +GET https://graph.microsoft.com/beta/deviceManagement +``` ++### Response +Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. +``` http +HTTP/1.1 200 OK +Content-Type: application/json +Content-Length: 130 ++{ + "value": { + "@odata.type": "#microsoft.graph.deviceManagement", + "id": "0b283420-3420-0b28-2034-280b2034280b" + } +} +``` |
v1.0 | Intune Cloudpkigraphservice Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-cloudpkigraphservice-devicemanagement-update.md | + + Title: "Update deviceManagement" +description: "Update the properties of a deviceManagement object." ++localization_priority: Normal ++++# Update deviceManagement ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. ++Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. +++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|DeviceManagementConfiguration.ReadWrite.All| ++## HTTP Request +<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /deviceManagement +``` ++## Request headers +|Header|Value| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Accept|application/json| ++## Request body +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. ++The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). ++|Property|Type|Description| +|:|:|:| +|id|String|Required Graph property| ++++## Response +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ++## Example ++### Request +Here is an example of the request. +``` http +PATCH https://graph.microsoft.com/beta/deviceManagement +Content-type: application/json +Content-length: 58 ++{ + "@odata.type": "#microsoft.graph.deviceManagement" +} +``` ++### Response +Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. +``` http +HTTP/1.1 200 OK +Content-Type: application/json +Content-Length: 107 ++{ + "@odata.type": "#microsoft.graph.deviceManagement", + "id": "0b283420-3420-0b28-2034-280b2034280b" +} +``` |
v1.0 | Intune Companyterms Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-companyterms-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-companyterms-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-companyterms-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Companyterms Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-companyterms-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-companyterms-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-companyterms-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-companyterms-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-companyterms-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Deviceconfig Androidcertificateprofilebase Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidcertificateprofilebase-get.md | Content-Length: 1723 ] } }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownercertificateprofilebase Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownercertificateprofilebase-get.md | Content-Length: 1734 "subjectAlternativeNameType": "emailAddress" } }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownerimportedpfxcertificateprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownerimportedpfxcertificateprofile-create.md | The following table shows the properties that are required when you create the a |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |intendedPurpose|[intendedPurpose](../resources/intune-deviceconfig-intendedpurpose.md)|Intended Purpose of the Certificate Profile - which could be Unassigned, SmimeEncryption, SmimeSigning etc. Possible values are: `unassigned`, `smimeEncryption`, `smimeSigning`, `vpn`, `wifi`.| |certificateAccessType|[androidDeviceOwnerCertificateAccessType](../resources/intune-deviceconfig-androiddeviceownercertificateaccesstype.md)|Certificate access type. Possible values are: `userApproval`, `specificApps`, `unknownFutureValue`.| |
v1.0 | Intune Deviceconfig Androiddeviceownerimportedpfxcertificateprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownerimportedpfxcertificateprofile-update.md | The following table shows the properties that are required when you create the [ |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |intendedPurpose|[intendedPurpose](../resources/intune-deviceconfig-intendedpurpose.md)|Intended Purpose of the Certificate Profile - which could be Unassigned, SmimeEncryption, SmimeSigning etc. Possible values are: `unassigned`, `smimeEncryption`, `smimeSigning`, `vpn`, `wifi`.| |certificateAccessType|[androidDeviceOwnerCertificateAccessType](../resources/intune-deviceconfig-androiddeviceownercertificateaccesstype.md)|Certificate access type. Possible values are: `userApproval`, `specificApps`, `unknownFutureValue`.| |
v1.0 | Intune Deviceconfig Androiddeviceownerpkcscertificateprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownerpkcscertificateprofile-create.md | The following table shows the properties that are required when you create the a |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name| |
v1.0 | Intune Deviceconfig Androiddeviceownerpkcscertificateprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownerpkcscertificateprofile-update.md | The following table shows the properties that are required when you create the [ |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name| |
v1.0 | Intune Deviceconfig Androiddeviceownerscepcertificateprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownerscepcertificateprofile-create.md | The following table shows the properties that are required when you create the a |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |
v1.0 | Intune Deviceconfig Androiddeviceownerscepcertificateprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownerscepcertificateprofile-update.md | The following table shows the properties that are required when you create the [ |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |
v1.0 | Intune Deviceconfig Androiddeviceownertrustedrootcertificate Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownertrustedrootcertificate-create.md | Content-Length: 1323 "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value" }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownertrustedrootcertificate Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownertrustedrootcertificate-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownertrustedrootcertificate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownertrustedrootcertificate-get.md | Content-Length: 1410 "certFileName": "Cert File Name value" } }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownertrustedrootcertificate List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownertrustedrootcertificate-list.md | Content-Length: 1492 } ] }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownertrustedrootcertificate Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownertrustedrootcertificate-update.md | Content-Length: 1323 "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value" }-``` +``` |
v1.0 | Intune Deviceconfig Androidforworkcertificateprofilebase Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidforworkcertificateprofilebase-get.md | Content-Length: 1730 "subjectAlternativeNameType": "emailAddress" } }-``` +``` |
v1.0 | Intune Deviceconfig Androidforworkimportedpfxcertificateprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidforworkimportedpfxcertificateprofile-create.md | The following table shows the properties that are required when you create the a |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |intendedPurpose|[intendedPurpose](../resources/intune-deviceconfig-intendedpurpose.md)|Intended Purpose of the Certificate Profile - which could be Unassigned, SmimeEncryption, SmimeSigning etc. Possible values are: `unassigned`, `smimeEncryption`, `smimeSigning`, `vpn`, `wifi`.| |
v1.0 | Intune Deviceconfig Androidforworkimportedpfxcertificateprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidforworkimportedpfxcertificateprofile-update.md | The following table shows the properties that are required when you create the [ |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |intendedPurpose|[intendedPurpose](../resources/intune-deviceconfig-intendedpurpose.md)|Intended Purpose of the Certificate Profile - which could be Unassigned, SmimeEncryption, SmimeSigning etc. Possible values are: `unassigned`, `smimeEncryption`, `smimeSigning`, `vpn`, `wifi`.| |
v1.0 | Intune Deviceconfig Androidforworkpkcscertificateprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidforworkpkcscertificateprofile-create.md | The following table shows the properties that are required when you create the a |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name| |
v1.0 | Intune Deviceconfig Androidforworkpkcscertificateprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidforworkpkcscertificateprofile-update.md | The following table shows the properties that are required when you create the [ |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name| |
v1.0 | Intune Deviceconfig Androidforworkscepcertificateprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidforworkscepcertificateprofile-create.md | The following table shows the properties that are required when you create the a |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |
v1.0 | Intune Deviceconfig Androidforworkscepcertificateprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidforworkscepcertificateprofile-update.md | The following table shows the properties that are required when you create the [ |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |
v1.0 | Intune Deviceconfig Androidforworktrustedrootcertificate Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidforworktrustedrootcertificate-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Deviceconfig Androidforworktrustedrootcertificate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidforworktrustedrootcertificate-get.md | Content-Length: 1406 "certFileName": "Cert File Name value" } }-``` +``` |
v1.0 | Intune Deviceconfig Androidforworktrustedrootcertificate Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidforworktrustedrootcertificate-update.md | Content-Length: 1319 "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value" }-``` +``` |
v1.0 | Intune Deviceconfig Androidimportedpfxcertificateprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidimportedpfxcertificateprofile-create.md | The following table shows the properties that are required when you create the a |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |intendedPurpose|[intendedPurpose](../resources/intune-deviceconfig-intendedpurpose.md)|Intended Purpose of the Certificate Profile - which could be Unassigned, SmimeEncryption, SmimeSigning etc. Possible values are: `unassigned`, `smimeEncryption`, `smimeSigning`, `vpn`, `wifi`.| |
v1.0 | Intune Deviceconfig Androidimportedpfxcertificateprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidimportedpfxcertificateprofile-update.md | The following table shows the properties that are required when you create the [ |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |intendedPurpose|[intendedPurpose](../resources/intune-deviceconfig-intendedpurpose.md)|Intended Purpose of the Certificate Profile - which could be Unassigned, SmimeEncryption, SmimeSigning etc. Possible values are: `unassigned`, `smimeEncryption`, `smimeSigning`, `vpn`, `wifi`.| |
v1.0 | Intune Deviceconfig Androidpkcscertificateprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidpkcscertificateprofile-create.md | The following table shows the properties that are required when you create the a |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name| |certificateTemplateName|String|PKCS Certificate Template Name| |
v1.0 | Intune Deviceconfig Androidpkcscertificateprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidpkcscertificateprofile-update.md | The following table shows the properties that are required when you create the [ |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name| |certificateTemplateName|String|PKCS Certificate Template Name| |
v1.0 | Intune Deviceconfig Androidscepcertificateprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidscepcertificateprofile-create.md | The following table shows the properties that are required when you create the a |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |keyUsage|[keyUsages](../resources/intune-shared-keyusages.md)|SCEP Key Usage. Possible values are: `keyEncipherment`, `digitalSignature`.| |
v1.0 | Intune Deviceconfig Androidscepcertificateprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidscepcertificateprofile-update.md | The following table shows the properties that are required when you create the [ |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |keyUsage|[keyUsages](../resources/intune-shared-keyusages.md)|SCEP Key Usage. Possible values are: `keyEncipherment`, `digitalSignature`.| |
v1.0 | Intune Deviceconfig Androidtrustedrootcertificate Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidtrustedrootcertificate-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Deviceconfig Androidtrustedrootcertificate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidtrustedrootcertificate-get.md | Content-Length: 1399 "certFileName": "Cert File Name value" } }-``` +``` |
v1.0 | Intune Deviceconfig Androidtrustedrootcertificate Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidtrustedrootcertificate-update.md | Content-Length: 1312 "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value" }-``` +``` |
v1.0 | Intune Deviceconfig Androidworkprofilecertificateprofilebase Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidworkprofilecertificateprofilebase-get.md | Content-Length: 1734 "subjectAlternativeNameType": "emailAddress" } }-``` +``` |
v1.0 | Intune Deviceconfig Androidworkprofilepkcscertificateprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidworkprofilepkcscertificateprofile-create.md | The following table shows the properties that are required when you create the a |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name| |
v1.0 | Intune Deviceconfig Androidworkprofilepkcscertificateprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidworkprofilepkcscertificateprofile-update.md | The following table shows the properties that are required when you create the [ |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name| |
v1.0 | Intune Deviceconfig Androidworkprofilescepcertificateprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidworkprofilescepcertificateprofile-create.md | The following table shows the properties that are required when you create the a |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |
v1.0 | Intune Deviceconfig Androidworkprofilescepcertificateprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidworkprofilescepcertificateprofile-update.md | The following table shows the properties that are required when you create the [ |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |
v1.0 | Intune Deviceconfig Androidworkprofiletrustedrootcertificate Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidworkprofiletrustedrootcertificate-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Deviceconfig Androidworkprofiletrustedrootcertificate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidworkprofiletrustedrootcertificate-get.md | Content-Length: 1410 "certFileName": "Cert File Name value" } }-``` +``` |
v1.0 | Intune Deviceconfig Androidworkprofiletrustedrootcertificate Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidworkprofiletrustedrootcertificate-update.md | Content-Length: 1323 "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value" }-``` +``` |
v1.0 | Intune Deviceconfig Aospdeviceownercertificateprofilebase Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-aospdeviceownercertificateprofilebase-get.md | Content-Length: 1731 "subjectAlternativeNameType": "emailAddress" } }-``` +``` |
v1.0 | Intune Deviceconfig Aospdeviceownerpkcscertificateprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-aospdeviceownerpkcscertificateprofile-create.md | The following table shows the properties that are required when you create the a |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name| |
v1.0 | Intune Deviceconfig Aospdeviceownerpkcscertificateprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-aospdeviceownerpkcscertificateprofile-update.md | The following table shows the properties that are required when you create the [ |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name| |
v1.0 | Intune Deviceconfig Aospdeviceownerscepcertificateprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-aospdeviceownerscepcertificateprofile-create.md | The following table shows the properties that are required when you create the a |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |
v1.0 | Intune Deviceconfig Aospdeviceownerscepcertificateprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-aospdeviceownerscepcertificateprofile-update.md | The following table shows the properties that are required when you create the [ |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |
v1.0 | Intune Deviceconfig Aospdeviceownertrustedrootcertificate Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-aospdeviceownertrustedrootcertificate-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Deviceconfig Aospdeviceownertrustedrootcertificate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-aospdeviceownertrustedrootcertificate-get.md | Content-Length: 1407 "certFileName": "Cert File Name value" } }-``` +``` |
v1.0 | Intune Deviceconfig Aospdeviceownertrustedrootcertificate Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-aospdeviceownertrustedrootcertificate-update.md | Content-Length: 1320 "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value" }-``` +``` |
v1.0 | Intune Deviceconfig Devicecompliancepolicy Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-devicecompliancepolicy-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceCompliancePolicy](../resources/intune-deviceconfig-devicecompliancepolicy.md) object. +Read properties and relationships of the [deviceCompliancePolicy](../resources/intune-shared-devicecompliancepolicy.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceCompliancePolicy](../resources/intune-deviceconfig-devicecompliancepolicy.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceCompliancePolicy](../resources/intune-shared-devicecompliancepolicy.md) object in the response body. ## Example |
v1.0 | Intune Deviceconfig Devicecompliancepolicy List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-devicecompliancepolicy-list.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -List properties and relationships of the [deviceCompliancePolicy](../resources/intune-deviceconfig-devicecompliancepolicy.md) objects. +List properties and relationships of the [deviceCompliancePolicy](../resources/intune-shared-devicecompliancepolicy.md) objects. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] GET /deviceManagement/deviceCompliancePolicies Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and a collection of [deviceCompliancePolicy](../resources/intune-deviceconfig-devicecompliancepolicy.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [deviceCompliancePolicy](../resources/intune-shared-devicecompliancepolicy.md) objects in the response body. ## Example |
v1.0 | Intune Deviceconfig Deviceconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-deviceconfiguration-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md) object. +Read properties and relationships of the [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md) object in the response body. ## Example |
v1.0 | Intune Deviceconfig Deviceconfiguration Getomasettingplaintextvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-deviceconfiguration-getomasettingplaintextvalue.md | Namespace: microsoft.graph ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). -> [!NOTE] -> This API involves potential secret values; ReadWrite permission is required. - |Permission type|Permissions (from least to most privileged)| |:|:|-|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| +|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| |Delegated (personal Microsoft account)|Not supported.|-|Application|DeviceManagementConfiguration.ReadWrite.All| +|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| ## HTTP Request <!-- { Content-Length: 57 { "value": "Get Oma Setting Plain Text Value value" }-``` +``` |
v1.0 | Intune Deviceconfig Deviceconfiguration List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-deviceconfiguration-list.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -List properties and relationships of the [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md) objects. +List properties and relationships of the [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md) objects. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] GET /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.gra Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and a collection of [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md) objects in the response body. ## Example |
v1.0 | Intune Deviceconfig Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-deviceconfig-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-deviceconfig-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Deviceconfig Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-deviceconfig-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-deviceconfig-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-deviceconfig-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-deviceconfig-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Deviceconfig Devicemanagementderivedcredentialsettings Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-devicemanagementderivedcredentialsettings-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagementDerivedCredentialSettings](../resources/intune-deviceconfig-devicemanagementderivedcredentialsettings.md) object. +Read properties and relationships of the [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagementDerivedCredentialSettings](../resources/intune-deviceconfig-devicemanagementderivedcredentialsettings.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) object in the response body. ## Example Content-Length: 155 "id": "bc650741-0741-bc65-4107-65bc410765bc" } }-``` +``` |
v1.0 | Intune Deviceconfig Devicemanagementderivedcredentialsettings Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-devicemanagementderivedcredentialsettings-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagementDerivedCredentialSettings](../resources/intune-deviceconfig-devicemanagementderivedcredentialsettings.md) object. +Update the properties of a [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.g |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagementDerivedCredentialSettings](../resources/intune-deviceconfig-devicemanagementderivedcredentialsettings.md) object. +In the request body, supply a JSON representation for the [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) object. -The following table shows the properties that are required when you create the [deviceManagementDerivedCredentialSettings](../resources/intune-deviceconfig-devicemanagementderivedcredentialsettings.md). +The following table shows the properties that are required when you create the [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagementDerivedCredentialSettings](../resources/intune-deviceconfig-devicemanagementderivedcredentialsettings.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) object in the response body. ## Example Content-Length: 132 "@odata.type": "#microsoft.graph.deviceManagementDerivedCredentialSettings", "id": "bc650741-0741-bc65-4107-65bc410765bc" }-``` +``` |
v1.0 | Intune Deviceconfig Hardwareconfiguration Assignhardwareconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-hardwareconfiguration-assignhardwareconfiguration.md | Content-Length: 504 } ] }-``` +``` |
v1.0 | Intune Deviceconfig Hardwareconfiguration Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-hardwareconfiguration-create.md | The following table shows the properties that are required when you create the h |Property|Type|Description| |:|:|:|-|id|String|Unique Identifier for the hardware configuration| -|version|Int32|Version of the hardware configuration (E.g. 1, 2, 3 ...)| -|displayName|String|Name of the hardware configuration| -|description|String|Description of the hardware configuration| -|createdDateTime|DateTimeOffset|Timestamp of when the hardware configuration was created. This property is read-only.| -|lastModifiedDateTime|DateTimeOffset|Timestamp of when the hardware configuration was modified. This property is read-only.| -|fileName|String|File name of the hardware configuration| -|configurationFileContent|Binary|File content of the hardware configuration| -|hardwareConfigurationFormat|[hardwareConfigurationFormat](../resources/intune-deviceconfig-hardwareconfigurationformat.md)|Oem type of the hardware configuration (E.g. DELL, HP, Surface and SurfaceDock). Possible values are: `dell`, `surface`, `surfaceDock`.| -|roleScopeTagIds|String collection|List of Scope Tag IDs for the hardware configuration| -|perDevicePasswordDisabled|Boolean|A value indicating whether per devcive pasword disabled| +|id|String|The unique identifier of the hardware BIOS configuration profile for the enrolled devices. This id is and is autogenerated and assigned when new hardware BIOS configuration profile is created. This distinguishes profiles from each other and cannot be null. Returned by default. Read-Only.| +|version|Int32|The version of the hardware configuration (E.g. 1, 2, 3 ...). This is incremented after a change to the BIOS configuration profile's settings file name (FileName property), settings file content (ConfigurationFileContent property), or the PerDevicePasswordDisabled property. Read-Only.| +|displayName|String|The name of the hardware BIOS configuration profile. It serves as user-friendly name to identify hardware BIOS configuration profiles. Max length is 150 characters. Required. Read-Only.| +|description|String|The description of the hardware configuration. Use this to provide context, purpose, applications, etc of the BIOS configuration profile for your organization's admins. Max length is 1000 characters. Optional.| +|createdDateTime|DateTimeOffset|The date and time of when the BIOS configuration profile was created. The value cannot be modified and is automatically populated when the device is enrolled. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Returned by default. Read-Only. This property is read-only.| +|lastModifiedDateTime|DateTimeOffset|The date and time of when the BIOS configuration profile was last modified. The value cannot be modified and is automatically populated when the device is enrolled. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Returned by default. Read-Only. Read-Only. This property is read-only.| +|fileName|String|The file name for the BIOS configuration profile's ConfigurationFileContent. Max length is 150 characters. Required.| +|configurationFileContent|Binary|The file content contains custom hardware settings that will be applied to the assigned devices' BIOS. Max allowed file size is 5KB. Represented as bytes. Required.| +|hardwareConfigurationFormat|[hardwareConfigurationFormat](../resources/intune-deviceconfig-hardwareconfigurationformat.md)|The OEM type associated with BIOS configuration profile's custom hardware settings. All devices that adheres to profile must be from the same selected OEM. Possible values are Dell, Surface, and Surface dock. Required. Possible values are: `dell`, `surface`, `surfaceDock`.| +|roleScopeTagIds|String collection|A list of unique Scope Tag IDs associated with the hardware configuration. Optional.| +|perDevicePasswordDisabled|Boolean|When TRUE, indicates whether the policy-assigned devices' passwords are disabled. When FALSE, indicates they are enabled. Default is FALSE. Required.| |
v1.0 | Intune Deviceconfig Hardwareconfiguration Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-hardwareconfiguration-update.md | The following table shows the properties that are required when you create the [ |Property|Type|Description| |:|:|:|-|id|String|Unique Identifier for the hardware configuration| -|version|Int32|Version of the hardware configuration (E.g. 1, 2, 3 ...)| -|displayName|String|Name of the hardware configuration| -|description|String|Description of the hardware configuration| -|createdDateTime|DateTimeOffset|Timestamp of when the hardware configuration was created. This property is read-only.| -|lastModifiedDateTime|DateTimeOffset|Timestamp of when the hardware configuration was modified. This property is read-only.| -|fileName|String|File name of the hardware configuration| -|configurationFileContent|Binary|File content of the hardware configuration| -|hardwareConfigurationFormat|[hardwareConfigurationFormat](../resources/intune-deviceconfig-hardwareconfigurationformat.md)|Oem type of the hardware configuration (E.g. DELL, HP, Surface and SurfaceDock). Possible values are: `dell`, `surface`, `surfaceDock`.| -|roleScopeTagIds|String collection|List of Scope Tag IDs for the hardware configuration| -|perDevicePasswordDisabled|Boolean|A value indicating whether per devcive pasword disabled| +|id|String|The unique identifier of the hardware BIOS configuration profile for the enrolled devices. This id is and is autogenerated and assigned when new hardware BIOS configuration profile is created. This distinguishes profiles from each other and cannot be null. Returned by default. Read-Only.| +|version|Int32|The version of the hardware configuration (E.g. 1, 2, 3 ...). This is incremented after a change to the BIOS configuration profile's settings file name (FileName property), settings file content (ConfigurationFileContent property), or the PerDevicePasswordDisabled property. Read-Only.| +|displayName|String|The name of the hardware BIOS configuration profile. It serves as user-friendly name to identify hardware BIOS configuration profiles. Max length is 150 characters. Required. Read-Only.| +|description|String|The description of the hardware configuration. Use this to provide context, purpose, applications, etc of the BIOS configuration profile for your organization's admins. Max length is 1000 characters. Optional.| +|createdDateTime|DateTimeOffset|The date and time of when the BIOS configuration profile was created. The value cannot be modified and is automatically populated when the device is enrolled. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Returned by default. Read-Only. This property is read-only.| +|lastModifiedDateTime|DateTimeOffset|The date and time of when the BIOS configuration profile was last modified. The value cannot be modified and is automatically populated when the device is enrolled. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Returned by default. Read-Only. Read-Only. This property is read-only.| +|fileName|String|The file name for the BIOS configuration profile's ConfigurationFileContent. Max length is 150 characters. Required.| +|configurationFileContent|Binary|The file content contains custom hardware settings that will be applied to the assigned devices' BIOS. Max allowed file size is 5KB. Represented as bytes. Required.| +|hardwareConfigurationFormat|[hardwareConfigurationFormat](../resources/intune-deviceconfig-hardwareconfigurationformat.md)|The OEM type associated with BIOS configuration profile's custom hardware settings. All devices that adheres to profile must be from the same selected OEM. Possible values are Dell, Surface, and Surface dock. Required. Possible values are: `dell`, `surface`, `surfaceDock`.| +|roleScopeTagIds|String collection|A list of unique Scope Tag IDs associated with the hardware configuration. Optional.| +|perDevicePasswordDisabled|Boolean|When TRUE, indicates whether the policy-assigned devices' passwords are disabled. When FALSE, indicates they are enabled. Default is FALSE. Required.| |
v1.0 | Intune Deviceconfig Ioscertificateprofile Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-ioscertificateprofile-get.md | Content-Length: 1279 "version": 7 } }-``` +``` |
v1.0 | Intune Deviceconfig Ioscertificateprofilebase Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-ioscertificateprofilebase-get.md | Content-Length: 1512 "certificateValidityPeriodScale": "months" } }-``` +``` |
v1.0 | Intune Deviceconfig Iosscepcertificateprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-iosscepcertificateprofile-create.md | The following table shows the properties that are required when you create the i |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |keyUsage|[keyUsages](../resources/intune-shared-keyusages.md)|SCEP Key Usage. Possible values are: `keyEncipherment`, `digitalSignature`.| |keySize|[keySize](../resources/intune-shared-keysize.md)|SCEP Key Size. Possible values are: `size1024`, `size2048`, `size4096`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| |subjectAlternativeNameFormatString|String|Custom String that defines the AAD Attribute.| |certificateStore|[certificateStore](../resources/intune-shared-certificatestore.md)|Target store certificate. Possible values are: `user`, `machine`.| |customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. The OnPremisesUserPrincipalName variable is support as well as others documented here: https://go.microsoft.com/fwlink/?LinkId=2027630. This collection can contain a maximum of 500 elements.| |
v1.0 | Intune Deviceconfig Iosscepcertificateprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-iosscepcertificateprofile-update.md | The following table shows the properties that are required when you create the [ |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |keyUsage|[keyUsages](../resources/intune-shared-keyusages.md)|SCEP Key Usage. Possible values are: `keyEncipherment`, `digitalSignature`.| |keySize|[keySize](../resources/intune-shared-keysize.md)|SCEP Key Size. Possible values are: `size1024`, `size2048`, `size4096`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| |subjectAlternativeNameFormatString|String|Custom String that defines the AAD Attribute.| |certificateStore|[certificateStore](../resources/intune-shared-certificatestore.md)|Target store certificate. Possible values are: `user`, `machine`.| |customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. The OnPremisesUserPrincipalName variable is support as well as others documented here: https://go.microsoft.com/fwlink/?LinkId=2027630. This collection can contain a maximum of 500 elements.| |
v1.0 | Intune Deviceconfig Iostrustedrootcertificate Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-iostrustedrootcertificate-create.md | Content-Length: 1308 "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value" }-``` +``` |
v1.0 | Intune Deviceconfig Iostrustedrootcertificate Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-iostrustedrootcertificate-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Deviceconfig Iostrustedrootcertificate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-iostrustedrootcertificate-get.md | Content-Length: 1395 "certFileName": "Cert File Name value" } }-``` +``` |
v1.0 | Intune Deviceconfig Iostrustedrootcertificate List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-iostrustedrootcertificate-list.md | Content-Length: 1477 } ] }-``` +``` |
v1.0 | Intune Deviceconfig Iostrustedrootcertificate Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-iostrustedrootcertificate-update.md | Content-Length: 1308 "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value" }-``` +``` |
v1.0 | Intune Deviceconfig Macoscertificateprofilebase Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macoscertificateprofilebase-get.md | Content-Length: 1514 "certificateValidityPeriodScale": "months" } }-``` +``` |
v1.0 | Intune Deviceconfig Macosscepcertificateprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macosscepcertificateprofile-create.md | The following table shows the properties that are required when you create the m |keyUsage|[keyUsages](../resources/intune-shared-keyusages.md)|SCEP Key Usage. Possible values are: `keyEncipherment`, `digitalSignature`.| |keySize|[keySize](../resources/intune-shared-keysize.md)|SCEP Key Size. Possible values are: `size1024`, `size2048`, `size4096`.| |hashAlgorithm|[hashAlgorithms](../resources/intune-shared-hashalgorithms.md)|SCEP Hash Algorithm. Possible values are: `sha1`, `sha2`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| |subjectAlternativeNameFormatString|String|Custom String that defines the AAD Attribute.| |certificateStore|[certificateStore](../resources/intune-shared-certificatestore.md)|Target store certificate. Possible values are: `user`, `machine`.| |customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. This collection can contain a maximum of 500 elements.| |
v1.0 | Intune Deviceconfig Macosscepcertificateprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macosscepcertificateprofile-update.md | The following table shows the properties that are required when you create the [ |keyUsage|[keyUsages](../resources/intune-shared-keyusages.md)|SCEP Key Usage. Possible values are: `keyEncipherment`, `digitalSignature`.| |keySize|[keySize](../resources/intune-shared-keysize.md)|SCEP Key Size. Possible values are: `size1024`, `size2048`, `size4096`.| |hashAlgorithm|[hashAlgorithms](../resources/intune-shared-hashalgorithms.md)|SCEP Hash Algorithm. Possible values are: `sha1`, `sha2`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| |subjectAlternativeNameFormatString|String|Custom String that defines the AAD Attribute.| |certificateStore|[certificateStore](../resources/intune-shared-certificatestore.md)|Target store certificate. Possible values are: `user`, `machine`.| |customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. This collection can contain a maximum of 500 elements.| |
v1.0 | Intune Deviceconfig Macostrustedrootcertificate Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macostrustedrootcertificate-create.md | Content-Length: 1310 "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value" }-``` +``` |
v1.0 | Intune Deviceconfig Macostrustedrootcertificate Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macostrustedrootcertificate-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Deviceconfig Macostrustedrootcertificate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macostrustedrootcertificate-get.md | Content-Length: 1397 "certFileName": "Cert File Name value" } }-``` +``` |
v1.0 | Intune Deviceconfig Macostrustedrootcertificate List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macostrustedrootcertificate-list.md | Content-Length: 1479 } ] }-``` +``` |
v1.0 | Intune Deviceconfig Macostrustedrootcertificate Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macostrustedrootcertificate-update.md | Content-Length: 1310 "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value" }-``` +``` |
v1.0 | Intune Deviceconfig Manageddevicecertificatestate Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-manageddevicecertificatestate-create.md | Content-Length: 1566 "certificateIssuanceDateTime": "2016-12-31T23:59:41.5044473-08:00", "certificateErrorCode": 4 }-``` +``` |
v1.0 | Intune Deviceconfig Manageddevicecertificatestate Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-manageddevicecertificatestate-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Deviceconfig Manageddevicecertificatestate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-manageddevicecertificatestate-get.md | Content-Length: 1637 "certificateErrorCode": 4 } }-``` +``` |
v1.0 | Intune Deviceconfig Manageddevicecertificatestate List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-manageddevicecertificatestate-list.md | Content-Length: 1703 } ] }-``` +``` |
v1.0 | Intune Deviceconfig Manageddevicecertificatestate Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-manageddevicecertificatestate-update.md | Content-Length: 1566 "certificateIssuanceDateTime": "2016-12-31T23:59:41.5044473-08:00", "certificateErrorCode": 4 }-``` +``` |
v1.0 | Intune Deviceconfig Reportroot Deviceconfigurationdeviceactivity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-reportroot-deviceconfigurationdeviceactivity.md | GET /reports/deviceConfigurationDeviceActivity Do not supply a request body for this method. ## Response-If successful, this function returns a `200 OK` response code and a [report](../resources/intune-deviceconfig-report.md) in the response body. +If successful, this function returns a `200 OK` response code and a [report](../resources/intune-shared-report.md) in the response body. ## Example |
v1.0 | Intune Deviceconfig Reportroot Deviceconfigurationuseractivity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-reportroot-deviceconfigurationuseractivity.md | GET /reports/deviceConfigurationUserActivity Do not supply a request body for this method. ## Response-If successful, this function returns a `200 OK` response code and a [report](../resources/intune-deviceconfig-report.md) in the response body. +If successful, this function returns a `200 OK` response code and a [report](../resources/intune-shared-report.md) in the response body. ## Example |
v1.0 | Intune Deviceconfig Reportroot Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-reportroot-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [reportRoot](../resources/intune-deviceconfig-reportroot.md) object. +Read properties and relationships of the [reportRoot](../resources/intune-shared-reportroot.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [reportRoot](../resources/intune-deviceconfig-reportroot.md) object in the response body. +If successful, this method returns a `200 OK` response code and [reportRoot](../resources/intune-shared-reportroot.md) object in the response body. ## Example |
v1.0 | Intune Deviceconfig Reportroot Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-reportroot-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [reportRoot](../resources/intune-deviceconfig-reportroot.md) object. +Update the properties of a [reportRoot](../resources/intune-shared-reportroot.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /reports |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [reportRoot](../resources/intune-deviceconfig-reportroot.md) object. +In the request body, supply a JSON representation for the [reportRoot](../resources/intune-shared-reportroot.md) object. -The following table shows the properties that are required when you create the [reportRoot](../resources/intune-deviceconfig-reportroot.md). +The following table shows the properties that are required when you create the [reportRoot](../resources/intune-shared-reportroot.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [reportRoot](../resources/intune-deviceconfig-reportroot.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [reportRoot](../resources/intune-shared-reportroot.md) object in the response body. ## Example |
v1.0 | Intune Deviceconfig Softwareupdatestatussummary Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-softwareupdatestatussummary-update.md | Content-Length: 567 "conflictUserCount": 1, "notApplicableUserCount": 6 }-``` +``` |
v1.0 | Intune Deviceconfig Windows10pkcscertificateprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows10pkcscertificateprofile-create.md | The following table shows the properties that are required when you create the w |certificationAuthorityName|String|PKCS Certification Authority Name| |certificateTemplateName|String|PKCS Certificate Template Name| |subjectAlternativeNameFormatString|String|Custom String that defines the AAD Attribute.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |certificateStore|[certificateStore](../resources/intune-shared-certificatestore.md)|Target store certificate. Possible values are: `user`, `machine`.| |customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. This collection can contain a maximum of 500 elements.| |
v1.0 | Intune Deviceconfig Windows10pkcscertificateprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows10pkcscertificateprofile-update.md | The following table shows the properties that are required when you create the [ |certificationAuthorityName|String|PKCS Certification Authority Name| |certificateTemplateName|String|PKCS Certificate Template Name| |subjectAlternativeNameFormatString|String|Custom String that defines the AAD Attribute.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |certificateStore|[certificateStore](../resources/intune-shared-certificatestore.md)|Target store certificate. Possible values are: `user`, `machine`.| |customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. This collection can contain a maximum of 500 elements.| |
v1.0 | Intune Deviceconfig Windows10vpnconfiguration Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows10vpnconfiguration-create.md | The following table shows the properties that are required when you create the w |rememberUserCredentials|Boolean|Remember user credentials.| |enableConditionalAccess|Boolean|Enable conditional access.| |enableSingleSignOnWithAlternateCertificate|Boolean|Enable single sign-on (SSO) with alternate certificate.|-|singleSignOnEku|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md)|Single sign-on Extended Key Usage (EKU).| +|singleSignOnEku|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md)|Single sign-on Extended Key Usage (EKU).| |singleSignOnIssuerHash|String|Single sign-on issuer hash.| |eapXml|Binary|Extensible Authentication Protocol (EAP) XML. (UTF8 encoded byte array)| |proxyServer|[windows10VpnProxyServer](../resources/intune-deviceconfig-windows10vpnproxyserver.md)|Proxy Server.| |
v1.0 | Intune Deviceconfig Windows10vpnconfiguration Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows10vpnconfiguration-update.md | The following table shows the properties that are required when you create the [ |rememberUserCredentials|Boolean|Remember user credentials.| |enableConditionalAccess|Boolean|Enable conditional access.| |enableSingleSignOnWithAlternateCertificate|Boolean|Enable single sign-on (SSO) with alternate certificate.|-|singleSignOnEku|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md)|Single sign-on Extended Key Usage (EKU).| +|singleSignOnEku|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md)|Single sign-on Extended Key Usage (EKU).| |singleSignOnIssuerHash|String|Single sign-on issuer hash.| |eapXml|Binary|Extensible Authentication Protocol (EAP) XML. (UTF8 encoded byte array)| |proxyServer|[windows10VpnProxyServer](../resources/intune-deviceconfig-windows10vpnproxyserver.md)|Proxy Server.| |
v1.0 | Intune Deviceconfig Windows81scepcertificateprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows81scepcertificateprofile-create.md | The following table shows the properties that are required when you create the w |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [windows81CertificateProfileBase](../resources/intune-deviceconfig-windows81certificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [windows81CertificateProfileBase](../resources/intune-deviceconfig-windows81certificateprofilebase.md)| |customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. This collection can contain a maximum of 500 elements. Inherited from [windows81CertificateProfileBase](../resources/intune-deviceconfig-windows81certificateprofilebase.md)| |scepServerUrls|String collection|SCEP Server Url(s).| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |
v1.0 | Intune Deviceconfig Windows81scepcertificateprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows81scepcertificateprofile-update.md | The following table shows the properties that are required when you create the [ |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [windows81CertificateProfileBase](../resources/intune-deviceconfig-windows81certificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [windows81CertificateProfileBase](../resources/intune-deviceconfig-windows81certificateprofilebase.md)| |customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. This collection can contain a maximum of 500 elements. Inherited from [windows81CertificateProfileBase](../resources/intune-deviceconfig-windows81certificateprofilebase.md)| |scepServerUrls|String collection|SCEP Server Url(s).| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |
v1.0 | Intune Deviceconfig Windows81trustedrootcertificate Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows81trustedrootcertificate-create.md | Content-Length: 1370 "certFileName": "Cert File Name value", "destinationStore": "computerCertStoreIntermediate" }-``` +``` |
v1.0 | Intune Deviceconfig Windows81trustedrootcertificate Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows81trustedrootcertificate-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Deviceconfig Windows81trustedrootcertificate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows81trustedrootcertificate-get.md | Content-Length: 1459 "destinationStore": "computerCertStoreIntermediate" } }-``` +``` |
v1.0 | Intune Deviceconfig Windows81trustedrootcertificate List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows81trustedrootcertificate-list.md | Content-Length: 1543 } ] }-``` +``` |
v1.0 | Intune Deviceconfig Windows81trustedrootcertificate Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows81trustedrootcertificate-update.md | Content-Length: 1370 "certFileName": "Cert File Name value", "destinationStore": "computerCertStoreIntermediate" }-``` +``` |
v1.0 | Intune Deviceconfig Windowscertificateprofilebase Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowscertificateprofilebase-get.md | Content-Length: 1576 "certificateValidityPeriodScale": "months" } }-``` +``` |
v1.0 | Intune Deviceconfig Windowsdomainjoinconfiguration Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsdomainjoinconfiguration-create.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Create a new [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) object. +Create a new [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] The following table shows the properties that are required when you create the w |Property|Type|Description| |:|:|:|-|id|String|Key of the entity. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|lastModifiedDateTime|DateTimeOffset|DateTime the object was last modified. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|roleScopeTagIds|String collection|List of Scope Tags for this Entity instance. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|supportsScopeTags|Boolean|Indicates whether or not the underlying Device Configuration supports the assignment of scope tags. Assigning to the ScopeTags property is not allowed when this value is false and entities will not be visible to scoped users. This occurs for Legacy policies created in Silverlight and can be resolved by deleting and recreating the policy in the Azure Portal. This property is read-only. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|deviceManagementApplicabilityRuleOsEdition|[deviceManagementApplicabilityRuleOsEdition](../resources/intune-deviceconfig-devicemanagementapplicabilityruleosedition.md)|The OS edition applicability for this Policy. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|deviceManagementApplicabilityRuleOsVersion|[deviceManagementApplicabilityRuleOsVersion](../resources/intune-deviceconfig-devicemanagementapplicabilityruleosversion.md)|The OS version applicability rule for this Policy. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|deviceManagementApplicabilityRuleDeviceMode|[deviceManagementApplicabilityRuleDeviceMode](../resources/intune-deviceconfig-devicemanagementapplicabilityruledevicemode.md)|The device mode applicability rule for this Policy. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|createdDateTime|DateTimeOffset|DateTime the object was created. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|description|String|Admin provided description of the Device Configuration. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| +|id|String|Key of the entity. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|lastModifiedDateTime|DateTimeOffset|DateTime the object was last modified. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|roleScopeTagIds|String collection|List of Scope Tags for this Entity instance. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|supportsScopeTags|Boolean|Indicates whether or not the underlying Device Configuration supports the assignment of scope tags. Assigning to the ScopeTags property is not allowed when this value is false and entities will not be visible to scoped users. This occurs for Legacy policies created in Silverlight and can be resolved by deleting and recreating the policy in the Azure Portal. This property is read-only. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|deviceManagementApplicabilityRuleOsEdition|[deviceManagementApplicabilityRuleOsEdition](../resources/intune-deviceconfig-devicemanagementapplicabilityruleosedition.md)|The OS edition applicability for this Policy. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|deviceManagementApplicabilityRuleOsVersion|[deviceManagementApplicabilityRuleOsVersion](../resources/intune-deviceconfig-devicemanagementapplicabilityruleosversion.md)|The OS version applicability rule for this Policy. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|deviceManagementApplicabilityRuleDeviceMode|[deviceManagementApplicabilityRuleDeviceMode](../resources/intune-deviceconfig-devicemanagementapplicabilityruledevicemode.md)|The device mode applicability rule for this Policy. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|createdDateTime|DateTimeOffset|DateTime the object was created. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|description|String|Admin provided description of the Device Configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |computerNameStaticPrefix|String|Fixed prefix to be used for computer name.| |computerNameSuffixRandomCharCount|Int32|Dynamically generated characters used as suffix for computer name. Valid values 3 to 14| |activeDirectoryDomainName|String|Active Directory domain name to join.| The following table shows the properties that are required when you create the w ## Response-If successful, this method returns a `201 Created` response code and a [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) object in the response body. +If successful, this method returns a `201 Created` response code and a [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object in the response body. ## Example |
v1.0 | Intune Deviceconfig Windowsdomainjoinconfiguration Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsdomainjoinconfiguration-delete.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Deletes a [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md). +Deletes a [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] |
v1.0 | Intune Deviceconfig Windowsdomainjoinconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsdomainjoinconfiguration-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) object. +Read properties and relationships of the [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) object in the response body. +If successful, this method returns a `200 OK` response code and [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object in the response body. ## Example |
v1.0 | Intune Deviceconfig Windowsdomainjoinconfiguration List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsdomainjoinconfiguration-list.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -List properties and relationships of the [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) objects. +List properties and relationships of the [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) objects. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] GET /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.gra Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and a collection of [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) objects in the response body. ## Example |
v1.0 | Intune Deviceconfig Windowsdomainjoinconfiguration Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsdomainjoinconfiguration-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) object. +Update the properties of a [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.g |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) object. +In the request body, supply a JSON representation for the [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object. -The following table shows the properties that are required when you create the [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md). +The following table shows the properties that are required when you create the [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md). |Property|Type|Description| |:|:|:|-|id|String|Key of the entity. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|lastModifiedDateTime|DateTimeOffset|DateTime the object was last modified. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|roleScopeTagIds|String collection|List of Scope Tags for this Entity instance. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|supportsScopeTags|Boolean|Indicates whether or not the underlying Device Configuration supports the assignment of scope tags. Assigning to the ScopeTags property is not allowed when this value is false and entities will not be visible to scoped users. This occurs for Legacy policies created in Silverlight and can be resolved by deleting and recreating the policy in the Azure Portal. This property is read-only. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|deviceManagementApplicabilityRuleOsEdition|[deviceManagementApplicabilityRuleOsEdition](../resources/intune-deviceconfig-devicemanagementapplicabilityruleosedition.md)|The OS edition applicability for this Policy. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|deviceManagementApplicabilityRuleOsVersion|[deviceManagementApplicabilityRuleOsVersion](../resources/intune-deviceconfig-devicemanagementapplicabilityruleosversion.md)|The OS version applicability rule for this Policy. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|deviceManagementApplicabilityRuleDeviceMode|[deviceManagementApplicabilityRuleDeviceMode](../resources/intune-deviceconfig-devicemanagementapplicabilityruledevicemode.md)|The device mode applicability rule for this Policy. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|createdDateTime|DateTimeOffset|DateTime the object was created. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|description|String|Admin provided description of the Device Configuration. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| +|id|String|Key of the entity. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|lastModifiedDateTime|DateTimeOffset|DateTime the object was last modified. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|roleScopeTagIds|String collection|List of Scope Tags for this Entity instance. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|supportsScopeTags|Boolean|Indicates whether or not the underlying Device Configuration supports the assignment of scope tags. Assigning to the ScopeTags property is not allowed when this value is false and entities will not be visible to scoped users. This occurs for Legacy policies created in Silverlight and can be resolved by deleting and recreating the policy in the Azure Portal. This property is read-only. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|deviceManagementApplicabilityRuleOsEdition|[deviceManagementApplicabilityRuleOsEdition](../resources/intune-deviceconfig-devicemanagementapplicabilityruleosedition.md)|The OS edition applicability for this Policy. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|deviceManagementApplicabilityRuleOsVersion|[deviceManagementApplicabilityRuleOsVersion](../resources/intune-deviceconfig-devicemanagementapplicabilityruleosversion.md)|The OS version applicability rule for this Policy. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|deviceManagementApplicabilityRuleDeviceMode|[deviceManagementApplicabilityRuleDeviceMode](../resources/intune-deviceconfig-devicemanagementapplicabilityruledevicemode.md)|The device mode applicability rule for this Policy. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|createdDateTime|DateTimeOffset|DateTime the object was created. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|description|String|Admin provided description of the Device Configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |computerNameStaticPrefix|String|Fixed prefix to be used for computer name.| |computerNameSuffixRandomCharCount|Int32|Dynamically generated characters used as suffix for computer name. Valid values 3 to 14| |activeDirectoryDomainName|String|Active Directory domain name to join.| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object in the response body. ## Example |
v1.0 | Intune Deviceconfig Windowsphone81certificateprofilebase Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsphone81certificateprofilebase-get.md | Content-Length: 1783 ] } }-``` +``` |
v1.0 | Intune Deviceconfig Windowsphone81scepcertificateprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsphone81scepcertificateprofile-create.md | The following table shows the properties that are required when you create the w |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validtiy Period. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md)| |scepServerUrls|String collection|SCEP Server Url(s).| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |keyUsage|[keyUsages](../resources/intune-shared-keyusages.md)|SCEP Key Usage. Possible values are: `keyEncipherment`, `digitalSignature`.| |
v1.0 | Intune Deviceconfig Windowsphone81scepcertificateprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsphone81scepcertificateprofile-update.md | The following table shows the properties that are required when you create the [ |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validtiy Period. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md)| |scepServerUrls|String collection|SCEP Server Url(s).| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |keyUsage|[keyUsages](../resources/intune-shared-keyusages.md)|SCEP Key Usage. Possible values are: `keyEncipherment`, `digitalSignature`.| |
v1.0 | Intune Deviceconfig Windowsphone81trustedrootcertificate Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsphone81trustedrootcertificate-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Deviceconfig Windowsphone81trustedrootcertificate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsphone81trustedrootcertificate-get.md | Content-Length: 1406 "certFileName": "Cert File Name value" } }-``` +``` |
v1.0 | Intune Deviceconfig Windowsphone81trustedrootcertificate Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsphone81trustedrootcertificate-update.md | Content-Length: 1319 "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value" }-``` +``` |
v1.0 | Intune Deviceconfig Windowsprivacydataaccesscontrolitem Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsprivacydataaccesscontrolitem-create.md | Content-Length: 299 "appPackageFamilyName": "App Package Family Name value", "appDisplayName": "App Display Name value" }-``` +``` |
v1.0 | Intune Deviceconfig Windowsprivacydataaccesscontrolitem Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsprivacydataaccesscontrolitem-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Deviceconfig Windowsprivacydataaccesscontrolitem Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsprivacydataaccesscontrolitem-get.md | Content-Length: 330 "appDisplayName": "App Display Name value" } }-``` +``` |
v1.0 | Intune Deviceconfig Windowsprivacydataaccesscontrolitem List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsprivacydataaccesscontrolitem-list.md | Content-Length: 356 } ] }-``` +``` |
v1.0 | Intune Deviceconfig Windowsprivacydataaccesscontrolitem Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsprivacydataaccesscontrolitem-update.md | Content-Length: 299 "appPackageFamilyName": "App Package Family Name value", "appDisplayName": "App Display Name value" }-``` +``` |
v1.0 | Intune Deviceconfig Windowsupdateforbusinessconfiguration Extendfeatureupdatespause | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsupdateforbusinessconfiguration-extendfeatureupdatespause.md | POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{dev Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Deviceconfig Windowsupdateforbusinessconfiguration Extendqualityupdatespause | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsupdateforbusinessconfiguration-extendqualityupdatespause.md | POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{dev Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementcompliancepolicy Assign | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementcompliancepolicy-assign.md | - Title: "assign action" -description: "Intune Deviceconfigv2 Devicemanagementcompliancepolicy Assign Api ." --localization_priority: Normal --doc_type: apiPageType ---# assign action --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -----## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST /deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assign -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply JSON representation of the parameters. --The following table shows the parameters that can be used with this action. --|Property|Type|Description| -|:|:|:| -|assignments|[deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection|| ----## Response -If successful, this action returns a `200 OK` response code and a [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection in the response body. --## Example --### Request -Here is an example of the request. -``` http -POST https://graph.microsoft.com/beta/deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assign --Content-type: application/json -Content-length: 610 --{ - "assignments": [ - { - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "id": "1f069921-9921-1f06-2199-061f2199061f", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value", - "deviceAndAppManagementAssignmentFilterType": "include", - "targetType": "user", - "entraObjectId": "Entra Object Id value" - }, - "source": "policySets", - "sourceId": "Source Id value" - } - ] -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 604 --{ - "value": [ - { - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "id": "1f069921-9921-1f06-2199-061f2199061f", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value", - "deviceAndAppManagementAssignmentFilterType": "include", - "targetType": "user", - "entraObjectId": "Entra Object Id value" - }, - "source": "policySets", - "sourceId": "Source Id value" - } - ] -} -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementcompliancepolicy Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementcompliancepolicy-create.md | The following table shows the properties that are required when you create the d |name|String|Policy name| |description|String|Policy description| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| +|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `extensibility`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| |createdDateTime|DateTimeOffset|Policy creation date and time. This property is read-only.| |lastModifiedDateTime|DateTimeOffset|Policy last modification date and time. This property is read-only.| |settingCount|Int32|Number of settings. This property is read-only.| |
v1.0 | Intune Deviceconfigv2 Devicemanagementcompliancepolicy Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementcompliancepolicy-update.md | The following table shows the properties that are required when you create the [ |name|String|Policy name| |description|String|Policy description| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| +|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `extensibility`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| |createdDateTime|DateTimeOffset|Policy creation date and time. This property is read-only.| |lastModifiedDateTime|DateTimeOffset|Policy last modification date and time. This property is read-only.| |settingCount|Int32|Number of settings. This property is read-only.| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationcategory Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationcategory-create.md | One of the following permissions is required to call this API. To learn more, in } --> ``` http+POST /deviceManagement/inventoryCategories POST /deviceManagement/complianceCategories POST /deviceManagement/configurationCategories ``` The following table shows the properties that are required when you create the d |name|String|Name of the item| |displayName|String|Name of the category. For example: Device Lock| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms types, which settings in the category have. Possible values are: none. android, androidEnterprise, iOs, macOs, windows10X, windows10, aosp, and linux. If this property is not set, or set to none, returns categories in all platforms. Supports: $filters, $select. Read-only. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies types, which settings in the category have. Possible values are: none, mdm, configManager, intuneManagementExtension, thirdParty, documentGateway, appleRemoteManagement, microsoftSense, exchangeOnline, edgeMam, linuxMdm, extensibility, enrollment, endpointPrivilegeManagement. If this property is not set, or set to none, returns categories in all platforms. Supports: $filters, $select. Read-only. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| -|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicates that the category contains settings that are used for compliance, configuration, or reusable settings. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Read-only. Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies types, which settings in the category have. Possible values are: none, mdm, configManager, intuneManagementExtension, thirdParty, documentGateway, appleRemoteManagement, microsoftSense, exchangeOnline, edgeMam, linuxMdm, extensibility, enrollment, endpointPrivilegeManagement. If this property is not set, or set to none, returns categories in all platforms. Supports: $filters, $select. Read-only. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `extensibility`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicates that the category contains settings that are used for compliance, configuration, or reusable settings. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Read-only. Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |parentCategoryId|String|Direct parent id of the category. If the category is the root, the parent id is same as its id.| |rootCategoryId|String|Root id of the category.| |childCategoryIds|String collection|List of child ids of the category.| If successful, this method returns a `201 Created` response code and a [deviceMa ### Request Here is an example of the request. ``` http-POST https://graph.microsoft.com/beta/deviceManagement/complianceCategories +POST https://graph.microsoft.com/beta/deviceManagement/inventoryCategories Content-type: application/json Content-length: 523 |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationcategory Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationcategory-delete.md | One of the following permissions is required to call this API. To learn more, in } --> ``` http+DELETE /deviceManagement/inventoryCategories/{deviceManagementConfigurationCategoryId} DELETE /deviceManagement/complianceCategories/{deviceManagementConfigurationCategoryId} DELETE /deviceManagement/configurationCategories/{deviceManagementConfigurationCategoryId} ``` If successful, this method returns a `204 No Content` response code. ### Request Here is an example of the request. ``` http-DELETE https://graph.microsoft.com/beta/deviceManagement/complianceCategories/{deviceManagementConfigurationCategoryId} +DELETE https://graph.microsoft.com/beta/deviceManagement/inventoryCategories/{deviceManagementConfigurationCategoryId} ``` ### Response |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationcategory Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationcategory-get.md | One of the following permissions is required to call this API. To learn more, in } --> ``` http+GET /deviceManagement/inventoryCategories/{deviceManagementConfigurationCategoryId} GET /deviceManagement/complianceCategories/{deviceManagementConfigurationCategoryId} GET /deviceManagement/configurationCategories/{deviceManagementConfigurationCategoryId} ``` If successful, this method returns a `200 OK` response code and [deviceManagemen ### Request Here is an example of the request. ``` http-GET https://graph.microsoft.com/beta/deviceManagement/complianceCategories/{deviceManagementConfigurationCategoryId} +GET https://graph.microsoft.com/beta/deviceManagement/inventoryCategories/{deviceManagementConfigurationCategoryId} ``` ### Response |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationcategory List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationcategory-list.md | One of the following permissions is required to call this API. To learn more, in } --> ``` http+GET /deviceManagement/inventoryCategories GET /deviceManagement/complianceCategories GET /deviceManagement/configurationCategories ``` If successful, this method returns a `200 OK` response code and a collection of ### Request Here is an example of the request. ``` http-GET https://graph.microsoft.com/beta/deviceManagement/complianceCategories +GET https://graph.microsoft.com/beta/deviceManagement/inventoryCategories ``` ### Response |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationcategory Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationcategory-update.md | One of the following permissions is required to call this API. To learn more, in } --> ``` http+PATCH /deviceManagement/inventoryCategories/{deviceManagementConfigurationCategoryId} PATCH /deviceManagement/complianceCategories/{deviceManagementConfigurationCategoryId} PATCH /deviceManagement/configurationCategories/{deviceManagementConfigurationCategoryId} ``` The following table shows the properties that are required when you create the [ |name|String|Name of the item| |displayName|String|Name of the category. For example: Device Lock| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms types, which settings in the category have. Possible values are: none. android, androidEnterprise, iOs, macOs, windows10X, windows10, aosp, and linux. If this property is not set, or set to none, returns categories in all platforms. Supports: $filters, $select. Read-only. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies types, which settings in the category have. Possible values are: none, mdm, configManager, intuneManagementExtension, thirdParty, documentGateway, appleRemoteManagement, microsoftSense, exchangeOnline, edgeMam, linuxMdm, extensibility, enrollment, endpointPrivilegeManagement. If this property is not set, or set to none, returns categories in all platforms. Supports: $filters, $select. Read-only. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| -|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicates that the category contains settings that are used for compliance, configuration, or reusable settings. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Read-only. Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies types, which settings in the category have. Possible values are: none, mdm, configManager, intuneManagementExtension, thirdParty, documentGateway, appleRemoteManagement, microsoftSense, exchangeOnline, edgeMam, linuxMdm, extensibility, enrollment, endpointPrivilegeManagement. If this property is not set, or set to none, returns categories in all platforms. Supports: $filters, $select. Read-only. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `extensibility`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicates that the category contains settings that are used for compliance, configuration, or reusable settings. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Read-only. Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |parentCategoryId|String|Direct parent id of the category. If the category is the root, the parent id is same as its id.| |rootCategoryId|String|Root id of the category.| |childCategoryIds|String collection|List of child ids of the category.| If successful, this method returns a `200 OK` response code and an updated [devi ### Request Here is an example of the request. ``` http-PATCH https://graph.microsoft.com/beta/deviceManagement/complianceCategories/{deviceManagementConfigurationCategoryId} +PATCH https://graph.microsoft.com/beta/deviceManagement/inventoryCategories/{deviceManagementConfigurationCategoryId} Content-type: application/json Content-length: 523 |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationchoicesettingcollectiondefinition Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationchoicesettingcollectiondefinition-create.md | One of the following permissions is required to call this API. To learn more, in --> ``` http POST /deviceManagement/reusableSettings+POST /deviceManagement/inventorySettings POST /deviceManagement/complianceSettings POST /deviceManagement/configurationSettings POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions The following table shows the properties that are required when you create the d |offsetUri|String|Offset CSP Path from Base Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |rootDefinitionId|String|Root setting definition id if the setting is a child setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |categoryId|String|Specify category in which the setting is under. Support $filters. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |id|String|Identifier for item Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |description|String|Description of the setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationchoicesettingcollectiondefinition Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationchoicesettingcollectiondefinition-delete.md | One of the following permissions is required to call this API. To learn more, in --> ``` http DELETE /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+DELETE /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationchoicesettingcollectiondefinition Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationchoicesettingcollectiondefinition-get.md | One of the following permissions is required to call this API. To learn more, in --> ``` http GET /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+GET /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationchoicesettingcollectiondefinition List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationchoicesettingcollectiondefinition-list.md | One of the following permissions is required to call this API. To learn more, in --> ``` http GET /deviceManagement/reusableSettings+GET /deviceManagement/inventorySettings GET /deviceManagement/complianceSettings GET /deviceManagement/configurationSettings GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationchoicesettingcollectiondefinition Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationchoicesettingcollectiondefinition-update.md | One of the following permissions is required to call this API. To learn more, in --> ``` http PATCH /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+PATCH /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} The following table shows the properties that are required when you create the [ |offsetUri|String|Offset CSP Path from Base Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |rootDefinitionId|String|Root setting definition id if the setting is a child setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |categoryId|String|Specify category in which the setting is under. Support $filters. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |id|String|Identifier for item Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |description|String|Description of the setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationchoicesettingdefinition Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationchoicesettingdefinition-create.md | One of the following permissions is required to call this API. To learn more, in --> ``` http POST /deviceManagement/reusableSettings+POST /deviceManagement/inventorySettings POST /deviceManagement/complianceSettings POST /deviceManagement/configurationSettings POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions The following table shows the properties that are required when you create the d |offsetUri|String|Offset CSP Path from Base Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |rootDefinitionId|String|Root setting definition id if the setting is a child setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |categoryId|String|Specify category in which the setting is under. Support $filters. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |id|String|Identifier for item Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |description|String|Description of the setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationchoicesettingdefinition Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationchoicesettingdefinition-delete.md | One of the following permissions is required to call this API. To learn more, in --> ``` http DELETE /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+DELETE /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationchoicesettingdefinition Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationchoicesettingdefinition-get.md | One of the following permissions is required to call this API. To learn more, in --> ``` http GET /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+GET /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationchoicesettingdefinition List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationchoicesettingdefinition-list.md | One of the following permissions is required to call this API. To learn more, in --> ``` http GET /deviceManagement/reusableSettings+GET /deviceManagement/inventorySettings GET /deviceManagement/complianceSettings GET /deviceManagement/configurationSettings GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationchoicesettingdefinition Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationchoicesettingdefinition-update.md | One of the following permissions is required to call this API. To learn more, in --> ``` http PATCH /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+PATCH /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} The following table shows the properties that are required when you create the [ |offsetUri|String|Offset CSP Path from Base Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |rootDefinitionId|String|Root setting definition id if the setting is a child setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |categoryId|String|Specify category in which the setting is under. Support $filters. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |id|String|Identifier for item Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |description|String|Description of the setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Assign | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-assign.md | - Title: "assign action" -description: "Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Assign Api ." --localization_priority: Normal --doc_type: apiPageType ---# assign action --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -----## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assign -POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId}/assign -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply JSON representation of the parameters. --The following table shows the parameters that can be used with this action. --|Property|Type|Description| -|:|:|:| -|assignments|[deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection|| ----## Response -If successful, this action returns a `200 OK` response code and a [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection in the response body. --## Example --### Request -Here is an example of the request. -``` http -POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assign --Content-type: application/json -Content-length: 610 --{ - "assignments": [ - { - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "id": "1f069921-9921-1f06-2199-061f2199061f", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value", - "deviceAndAppManagementAssignmentFilterType": "include", - "targetType": "user", - "entraObjectId": "Entra Object Id value" - }, - "source": "policySets", - "sourceId": "Source Id value" - } - ] -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 604 --{ - "value": [ - { - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "id": "1f069921-9921-1f06-2199-061f2199061f", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value", - "deviceAndAppManagementAssignmentFilterType": "include", - "targetType": "user", - "entraObjectId": "Entra Object Id value" - }, - "source": "policySets", - "sourceId": "Source Id value" - } - ] -} -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Assignjustintimeconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-assignjustintimeconfiguration.md | - Title: "assignJustInTimeConfiguration action" -description: "Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Assignjustintimeconfiguration Api ." --localization_priority: Normal --doc_type: apiPageType ---# assignJustInTimeConfiguration action --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -----## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assignJustInTimeConfiguration -POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId}/assignJustInTimeConfiguration -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply JSON representation of the parameters. --The following table shows the parameters that can be used with this action. --|Property|Type|Description| -|:|:|:| -|justInTimeAssignments|[deviceManagementConfigurationJustInTimeAssignmentPolicy](../resources/intune-deviceconfigv2-devicemanagementconfigurationjustintimeassignmentpolicy.md)|| ----## Response -If successful, this action returns a `200 OK` response code and a Boolean in the response body. --## Example --### Request -Here is an example of the request. -``` http -POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assignJustInTimeConfiguration --Content-type: application/json -Content-length: 221 --{ - "justInTimeAssignments": { - "@odata.type": "microsoft.graph.deviceManagementConfigurationJustInTimeAssignmentPolicy", - "targetType": "entraSecurityGroup", - "target": [ - "Target value" - ] - } -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 21 --{ - "value": true -} -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-create.md | The following table shows the properties that are required when you create the d |name|String|Policy name| |description|String|Policy description| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| +|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `extensibility`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| |createdDateTime|DateTimeOffset|Policy creation date and time| |lastModifiedDateTime|DateTimeOffset|Policy last modification date and time| |settingCount|Int32|Number of settings| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-update.md | The following table shows the properties that are required when you create the [ |name|String|Policy name| |description|String|Policy description| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| +|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `extensibility`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| |createdDateTime|DateTimeOffset|Policy creation date and time| |lastModifiedDateTime|DateTimeOffset|Policy last modification date and time| |settingCount|Int32|Number of settings| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicyassignment Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment-create.md | - Title: "Create deviceManagementConfigurationPolicyAssignment" -description: "Create a new deviceManagementConfigurationPolicyAssignment object." --localization_priority: Normal --doc_type: apiPageType ---# Create deviceManagementConfigurationPolicyAssignment --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Create a new [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST /deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assignments -POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assignments -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the deviceManagementConfigurationPolicyAssignment object. --The following table shows the properties that are required when you create the deviceManagementConfigurationPolicyAssignment. --|Property|Type|Description| -|:|:|:| -|id|String|The key of the assignment.| -|target|[deviceAndAppManagementAssignmentTarget](../resources/intune-shared-deviceandappmanagementassignmenttarget.md)|The assignment target for the DeviceManagementConfigurationPolicy.| -|source|[deviceAndAppManagementAssignmentSource](../resources/intune-shared-deviceandappmanagementassignmentsource.md)|The assignment source for the device compliance policy, direct or parcel/policySet. Possible values are: `direct`, `policySets`.| -|sourceId|String|The identifier of the source of the assignment.| ----## Response -If successful, this method returns a `201 Created` response code and a [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -POST https://graph.microsoft.com/beta/deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assignments -Content-type: application/json -Content-length: 478 --{ - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value", - "deviceAndAppManagementAssignmentFilterType": "include", - "targetType": "user", - "entraObjectId": "Entra Object Id value" - }, - "source": "policySets", - "sourceId": "Source Id value" -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 201 Created -Content-Type: application/json -Content-Length: 527 --{ - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "id": "1f069921-9921-1f06-2199-061f2199061f", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value", - "deviceAndAppManagementAssignmentFilterType": "include", - "targetType": "user", - "entraObjectId": "Entra Object Id value" - }, - "source": "policySets", - "sourceId": "Source Id value" -} -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicyassignment Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment-delete.md | - Title: "Delete deviceManagementConfigurationPolicyAssignment" -description: "Deletes a deviceManagementConfigurationPolicyAssignment." --localization_priority: Normal --doc_type: apiPageType ---# Delete deviceManagementConfigurationPolicyAssignment --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Deletes a [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md). ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -DELETE /deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId} -DELETE /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId} -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `204 No Content` response code. --## Example --### Request -Here is an example of the request. -``` http -DELETE https://graph.microsoft.com/beta/deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 204 No Content -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicyassignment Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment-get.md | - Title: "Get deviceManagementConfigurationPolicyAssignment" -description: "Read properties and relationships of the deviceManagementConfigurationPolicyAssignment object." --localization_priority: Normal --doc_type: apiPageType ---# Get deviceManagementConfigurationPolicyAssignment --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Read properties and relationships of the [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId} -GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId} -``` --## Optional query parameters -This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -GET https://graph.microsoft.com/beta/deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 568 --{ - "value": { - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "id": "1f069921-9921-1f06-2199-061f2199061f", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value", - "deviceAndAppManagementAssignmentFilterType": "include", - "targetType": "user", - "entraObjectId": "Entra Object Id value" - }, - "source": "policySets", - "sourceId": "Source Id value" - } -} -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicyassignment List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment-list.md | - Title: "List deviceManagementConfigurationPolicyAssignments" -description: "List properties and relationships of the deviceManagementConfigurationPolicyAssignment objects." --localization_priority: Normal --doc_type: apiPageType ---# List deviceManagementConfigurationPolicyAssignments --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --List properties and relationships of the [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) objects. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assignments -GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assignments -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and a collection of [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) objects in the response body. --## Example --### Request -Here is an example of the request. -``` http -GET https://graph.microsoft.com/beta/deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assignments -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 604 --{ - "value": [ - { - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "id": "1f069921-9921-1f06-2199-061f2199061f", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value", - "deviceAndAppManagementAssignmentFilterType": "include", - "targetType": "user", - "entraObjectId": "Entra Object Id value" - }, - "source": "policySets", - "sourceId": "Source Id value" - } - ] -} -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicyassignment Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment-update.md | - Title: "Update deviceManagementConfigurationPolicyAssignment" -description: "Update the properties of a deviceManagementConfigurationPolicyAssignment object." --localization_priority: Normal --doc_type: apiPageType ---# Update deviceManagementConfigurationPolicyAssignment --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Update the properties of a [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -PATCH /deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId} -PATCH /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId} -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) object. --The following table shows the properties that are required when you create the [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md). --|Property|Type|Description| -|:|:|:| -|id|String|The key of the assignment.| -|target|[deviceAndAppManagementAssignmentTarget](../resources/intune-shared-deviceandappmanagementassignmenttarget.md)|The assignment target for the DeviceManagementConfigurationPolicy.| -|source|[deviceAndAppManagementAssignmentSource](../resources/intune-shared-deviceandappmanagementassignmentsource.md)|The assignment source for the device compliance policy, direct or parcel/policySet. Possible values are: `direct`, `policySets`.| -|sourceId|String|The identifier of the source of the assignment.| ----## Response -If successful, this method returns a `200 OK` response code and an updated [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -PATCH https://graph.microsoft.com/beta/deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId} -Content-type: application/json -Content-length: 478 --{ - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value", - "deviceAndAppManagementAssignmentFilterType": "include", - "targetType": "user", - "entraObjectId": "Entra Object Id value" - }, - "source": "policySets", - "sourceId": "Source Id value" -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 527 --{ - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "id": "1f069921-9921-1f06-2199-061f2199061f", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value", - "deviceAndAppManagementAssignmentFilterType": "include", - "targetType": "user", - "entraObjectId": "Entra Object Id value" - }, - "source": "policySets", - "sourceId": "Source Id value" -} -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicytemplate Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicytemplate-create.md | The following table shows the properties that are required when you create the d |displayVersion|String|Description of template version| |lifecycleState|[deviceManagementTemplateLifecycleState](../resources/intune-deviceconfigv2-devicemanagementtemplatelifecyclestate.md)|Indicate current lifecycle state of template. Possible values are: `invalid`, `draft`, `active`, `superseded`, `deprecated`, `retired`.| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this template. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this template. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| +|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this template. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `extensibility`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| |templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|TemplateFamily for this template. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `endpointSecurityEndpointPrivilegeManagement`, `enrollmentConfiguration`, `appQuietTime`, `baseline`, `unknownFutureValue`, `deviceConfigurationScripts`, `deviceConfigurationPolicies`, `windowsOsRecoveryPolicies`, `companyPortal`.| |allowUnmanagedSettings|Boolean|Allow unmanaged setting templates| |settingTemplateCount|Int32|Number of setting templates. Valid values 0 to 2147483647. This property is read-only.| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicytemplate Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicytemplate-update.md | The following table shows the properties that are required when you create the [ |displayVersion|String|Description of template version| |lifecycleState|[deviceManagementTemplateLifecycleState](../resources/intune-deviceconfigv2-devicemanagementtemplatelifecyclestate.md)|Indicate current lifecycle state of template. Possible values are: `invalid`, `draft`, `active`, `superseded`, `deprecated`, `retired`.| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this template. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this template. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| +|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this template. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `extensibility`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| |templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|TemplateFamily for this template. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `endpointSecurityEndpointPrivilegeManagement`, `enrollmentConfiguration`, `appQuietTime`, `baseline`, `unknownFutureValue`, `deviceConfigurationScripts`, `deviceConfigurationPolicies`, `windowsOsRecoveryPolicies`, `companyPortal`.| |allowUnmanagedSettings|Boolean|Allow unmanaged setting templates| |settingTemplateCount|Int32|Number of setting templates. Valid values 0 to 2147483647. This property is read-only.| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationredirectsettingdefinition Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationredirectsettingdefinition-create.md | One of the following permissions is required to call this API. To learn more, in --> ``` http POST /deviceManagement/reusableSettings+POST /deviceManagement/inventorySettings POST /deviceManagement/complianceSettings POST /deviceManagement/configurationSettings POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions The following table shows the properties that are required when you create the d |offsetUri|String|Offset CSP Path from Base Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |rootDefinitionId|String|Root setting definition id if the setting is a child setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |categoryId|String|Specify category in which the setting is under. Support $filters. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |id|String|Identifier for item Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |description|String|Description of the setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationredirectsettingdefinition Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationredirectsettingdefinition-delete.md | One of the following permissions is required to call this API. To learn more, in --> ``` http DELETE /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+DELETE /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationredirectsettingdefinition Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationredirectsettingdefinition-get.md | One of the following permissions is required to call this API. To learn more, in --> ``` http GET /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+GET /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationredirectsettingdefinition List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationredirectsettingdefinition-list.md | One of the following permissions is required to call this API. To learn more, in --> ``` http GET /deviceManagement/reusableSettings+GET /deviceManagement/inventorySettings GET /deviceManagement/complianceSettings GET /deviceManagement/configurationSettings GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationredirectsettingdefinition Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationredirectsettingdefinition-update.md | One of the following permissions is required to call this API. To learn more, in --> ``` http PATCH /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+PATCH /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} The following table shows the properties that are required when you create the [ |offsetUri|String|Offset CSP Path from Base Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |rootDefinitionId|String|Root setting definition id if the setting is a child setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |categoryId|String|Specify category in which the setting is under. Support $filters. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |id|String|Identifier for item Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |description|String|Description of the setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsimplesettingcollectiondefinition Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsimplesettingcollectiondefinition-create.md | One of the following permissions is required to call this API. To learn more, in --> ``` http POST /deviceManagement/reusableSettings+POST /deviceManagement/inventorySettings POST /deviceManagement/complianceSettings POST /deviceManagement/configurationSettings POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions The following table shows the properties that are required when you create the d |offsetUri|String|Offset CSP Path from Base Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |rootDefinitionId|String|Root setting definition id if the setting is a child setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |categoryId|String|Specify category in which the setting is under. Support $filters. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |id|String|Identifier for item Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |description|String|Description of the setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsimplesettingcollectiondefinition Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsimplesettingcollectiondefinition-delete.md | One of the following permissions is required to call this API. To learn more, in --> ``` http DELETE /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+DELETE /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsimplesettingcollectiondefinition Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsimplesettingcollectiondefinition-get.md | One of the following permissions is required to call this API. To learn more, in --> ``` http GET /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+GET /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsimplesettingcollectiondefinition List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsimplesettingcollectiondefinition-list.md | One of the following permissions is required to call this API. To learn more, in --> ``` http GET /deviceManagement/reusableSettings+GET /deviceManagement/inventorySettings GET /deviceManagement/complianceSettings GET /deviceManagement/configurationSettings GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsimplesettingcollectiondefinition Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsimplesettingcollectiondefinition-update.md | One of the following permissions is required to call this API. To learn more, in --> ``` http PATCH /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+PATCH /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} The following table shows the properties that are required when you create the [ |offsetUri|String|Offset CSP Path from Base Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |rootDefinitionId|String|Root setting definition id if the setting is a child setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |categoryId|String|Specify category in which the setting is under. Support $filters. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |id|String|Identifier for item Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |description|String|Description of the setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsimplesettingdefinition Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsimplesettingdefinition-create.md | One of the following permissions is required to call this API. To learn more, in --> ``` http POST /deviceManagement/reusableSettings+POST /deviceManagement/inventorySettings POST /deviceManagement/complianceSettings POST /deviceManagement/configurationSettings POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions The following table shows the properties that are required when you create the d |offsetUri|String|Offset CSP Path from Base Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |rootDefinitionId|String|Root setting definition id if the setting is a child setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |categoryId|String|Specify category in which the setting is under. Support $filters. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |id|String|Identifier for item Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |description|String|Description of the setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsimplesettingdefinition Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsimplesettingdefinition-delete.md | One of the following permissions is required to call this API. To learn more, in --> ``` http DELETE /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+DELETE /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsimplesettingdefinition Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsimplesettingdefinition-get.md | One of the following permissions is required to call this API. To learn more, in --> ``` http GET /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+GET /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsimplesettingdefinition List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsimplesettingdefinition-list.md | One of the following permissions is required to call this API. To learn more, in --> ``` http GET /deviceManagement/reusableSettings+GET /deviceManagement/inventorySettings GET /deviceManagement/complianceSettings GET /deviceManagement/configurationSettings GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsimplesettingdefinition Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsimplesettingdefinition-update.md | One of the following permissions is required to call this API. To learn more, in --> ``` http PATCH /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+PATCH /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} The following table shows the properties that are required when you create the [ |offsetUri|String|Offset CSP Path from Base Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |rootDefinitionId|String|Root setting definition id if the setting is a child setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |categoryId|String|Specify category in which the setting is under. Support $filters. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |id|String|Identifier for item Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |description|String|Description of the setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |
v1.0 | Intune Deviceintent Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceintent-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-deviceintent-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-deviceintent-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Deviceintent Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceintent-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-deviceintent-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-deviceintent-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-deviceintent-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-deviceintent-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Deviceintent Devicemanagementintent Compare | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceintent-devicemanagementintent-compare.md | Content-Length: 364 } ] }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementtemplate Compare | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceintent-devicemanagementtemplate-compare.md | Content-Length: 364 } ] }-``` +``` |
v1.0 | Intune Deviceintent Securitybaselinecategorystatesummary Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceintent-securitybaselinecategorystatesummary-create.md | Content-Length: 310 "notApplicableCount": 2, "displayName": "Display Name value" }-``` +``` |
v1.0 | Intune Deviceintent Securitybaselinecategorystatesummary Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceintent-securitybaselinecategorystatesummary-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/templates/{deviceManage Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Deviceintent Securitybaselinecategorystatesummary Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceintent-securitybaselinecategorystatesummary-get.md | Content-Length: 347 "displayName": "Display Name value" } }-``` +``` |
v1.0 | Intune Deviceintent Securitybaselinecategorystatesummary List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceintent-securitybaselinecategorystatesummary-list.md | Content-Length: 379 } ] }-``` +``` |
v1.0 | Intune Deviceintent Securitybaselinecategorystatesummary Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceintent-securitybaselinecategorystatesummary-update.md | Content-Length: 310 "notApplicableCount": 2, "displayName": "Display Name value" }-``` +``` |
v1.0 | Intune Deviceintent Securitybaselinedevicestate Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceintent-securitybaselinedevicestate-create.md | Content-Length: 359 "state": "secure", "lastReportedDateTime": "2017-01-01T00:00:17.7769392-08:00" }-``` +``` |
v1.0 | Intune Deviceintent Securitybaselinedevicestate Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceintent-securitybaselinedevicestate-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/templates/{deviceManage Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Deviceintent Securitybaselinedevicestate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceintent-securitybaselinedevicestate-get.md | Content-Length: 392 "lastReportedDateTime": "2017-01-01T00:00:17.7769392-08:00" } }-``` +``` |
v1.0 | Intune Deviceintent Securitybaselinedevicestate List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceintent-securitybaselinedevicestate-list.md | Content-Length: 420 } ] }-``` +``` |
v1.0 | Intune Deviceintent Securitybaselinedevicestate Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceintent-securitybaselinedevicestate-update.md | Content-Length: 359 "state": "secure", "lastReportedDateTime": "2017-01-01T00:00:17.7769392-08:00" }-``` +``` |
v1.0 | Intune Deviceintent Securitybaselinestatesummary Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceintent-securitybaselinestatesummary-get.md | Content-Length: 297 "notApplicableCount": 2 } }-``` +``` |
v1.0 | Intune Deviceintent Securitybaselinestatesummary Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceintent-securitybaselinestatesummary-update.md | Content-Length: 262 "conflictCount": 13, "notApplicableCount": 2 }-``` +``` |
v1.0 | Intune Devices Deviceappmanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceappmanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceAppManagement](../resources/intune-devices-deviceappmanagement.md) object. +Read properties and relationships of the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceAppManagement](../resources/intune-devices-deviceappmanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object in the response body. ## Example |
v1.0 | Intune Devices Deviceappmanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceappmanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceAppManagement](../resources/intune-devices-deviceappmanagement.md) object. +Update the properties of a [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceAppManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceAppManagement](../resources/intune-devices-deviceappmanagement.md) object. +In the request body, supply a JSON representation for the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object. -The following table shows the properties that are required when you create the [deviceAppManagement](../resources/intune-devices-deviceappmanagement.md). +The following table shows the properties that are required when you create the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceAppManagement](../resources/intune-devices-deviceappmanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object in the response body. ## Example |
v1.0 | Intune Devices Devicecategory Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-devicecategory-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceCategory](../resources/intune-devices-devicecategory.md) object. +Read properties and relationships of the [deviceCategory](../resources/intune-shared-devicecategory.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceCategory](../resources/intune-devices-devicecategory.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceCategory](../resources/intune-shared-devicecategory.md) object in the response body. ## Example Content-Length: 128 "id": "f881b841-b841-f881-41b8-81f841b881f8" } }-``` +``` |
v1.0 | Intune Devices Devicecategory Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-devicecategory-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceCategory](../resources/intune-devices-devicecategory.md) object. +Update the properties of a [deviceCategory](../resources/intune-shared-devicecategory.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/devic |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceCategory](../resources/intune-devices-devicecategory.md) object. +In the request body, supply a JSON representation for the [deviceCategory](../resources/intune-shared-devicecategory.md) object. -The following table shows the properties that are required when you create the [deviceCategory](../resources/intune-devices-devicecategory.md). +The following table shows the properties that are required when you create the [deviceCategory](../resources/intune-shared-devicecategory.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceCategory](../resources/intune-devices-devicecategory.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceCategory](../resources/intune-shared-devicecategory.md) object in the response body. ## Example Content-Length: 105 "@odata.type": "#microsoft.graph.deviceCategory", "id": "f881b841-b841-f881-41b8-81f841b881f8" }-``` +``` |
v1.0 | Intune Devices Devicehealthscriptpolicystate Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-devicehealthscriptpolicystate-create.md | Content-Length: 1094 "Assignment Filter Ids value" ] }-``` +``` |
v1.0 | Intune Devices Devicehealthscriptpolicystate Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-devicehealthscriptpolicystate-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Devices Devicehealthscriptpolicystate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-devicehealthscriptpolicystate-get.md | Content-Length: 1155 ] } }-``` +``` |
v1.0 | Intune Devices Devicehealthscriptpolicystate List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-devicehealthscriptpolicystate-list.md | Content-Length: 1211 } ] }-``` +``` |
v1.0 | Intune Devices Devicehealthscriptpolicystate Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-devicehealthscriptpolicystate-update.md | Content-Length: 1094 "Assignment Filter Ids value" ] }-``` +``` |
v1.0 | Intune Devices Devicelogcollectionresponse Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-devicelogcollectionresponse-create.md | Content-Length: 607 "sizeInKB": 2.6666666666666665, "enrolledByUser": "Enrolled By User value" }-``` +``` |
v1.0 | Intune Devices Devicelogcollectionresponse Createdownloadurl | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-devicelogcollectionresponse-createdownloadurl.md | Content-Length: 57 { "value": "https://example.com/createDownloadUrl/" }-``` +``` |
v1.0 | Intune Devices Devicelogcollectionresponse Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-devicelogcollectionresponse-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Devices Devicelogcollectionresponse Downloaddevicelogs | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-devicelogcollectionresponse-downloaddevicelogs.md | + + Title: "downloadDeviceLogs action" +description: "Intune Devices Devicelogcollectionresponse Downloaddevicelogs Api ." ++localization_priority: Normal ++++# downloadDeviceLogs action ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. +++++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementManagedDevices.Read.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|DeviceManagementConfiguration.Read.All, DeviceManagementManagedDevices.Read.All| ++## HTTP Request +<!-- { + "blockType": "ignored" +} +--> +``` http +POST /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/logCollectionRequests/{deviceLogCollectionResponseId}/downloadDeviceLogs +``` ++## Request headers +|Header|Value| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Accept|application/json| ++## Request body +Do not supply a request body for this method. ++## Response +If successful, this action returns a `200 OK` response code and a String in the response body. ++## Example ++### Request +Here is an example of the request. +``` http +POST https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/logCollectionRequests/{deviceLogCollectionResponseId}/downloadDeviceLogs +``` ++### Response +Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. +``` http +HTTP/1.1 200 OK +Content-Type: application/json +Content-Length: 45 ++{ + "value": "Download Device Logs value" +} +``` |
v1.0 | Intune Devices Devicelogcollectionresponse Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-devicelogcollectionresponse-get.md | Content-Length: 650 "enrolledByUser": "Enrolled By User value" } }-``` +``` |
v1.0 | Intune Devices Devicelogcollectionresponse List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-devicelogcollectionresponse-list.md | Content-Length: 688 } ] }-``` +``` |
v1.0 | Intune Devices Devicelogcollectionresponse Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-devicelogcollectionresponse-update.md | Content-Length: 607 "sizeInKB": 2.6666666666666665, "enrolledByUser": "Enrolled By User value" }-``` +``` |
v1.0 | Intune Devices Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-devices-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-devices-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Devices Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-devices-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-devices-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-devices-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-devices-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Devices Devicemanagementscript Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-devicemanagementscript-create.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Create a new [deviceManagementScript](../resources/intune-devices-devicemanagementscript.md) object. +Create a new [deviceManagementScript](../resources/intune-shared-devicemanagementscript.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] The following table shows the properties that are required when you create the d |scriptContent|Binary|The script content.| |createdDateTime|DateTimeOffset|The date and time the device management script was created. This property is read-only.| |lastModifiedDateTime|DateTimeOffset|The date and time the device management script was last modified. This property is read-only.|-|runAsAccount|[runAsAccountType](../resources/intune-devices-runasaccounttype.md)|Indicates the type of execution context. Possible values are: `system`, `user`.| +|runAsAccount|[runAsAccountType](../resources/intune-shared-runasaccounttype.md)|Indicates the type of execution context. Possible values are: `system`, `user`.| |fileName|String|Script file name.| |roleScopeTagIds|String collection|List of Scope Tag IDs for this PowerShellScript instance.| ## Response-If successful, this method returns a `201 Created` response code and a [deviceManagementScript](../resources/intune-devices-devicemanagementscript.md) object in the response body. +If successful, this method returns a `201 Created` response code and a [deviceManagementScript](../resources/intune-shared-devicemanagementscript.md) object in the response body. ## Example |
v1.0 | Intune Devices Devicemanagementscript Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-devicemanagementscript-delete.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Deletes a [deviceManagementScript](../resources/intune-devices-devicemanagementscript.md). +Deletes a [deviceManagementScript](../resources/intune-shared-devicemanagementscript.md). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] |
v1.0 | Intune Devices Devicemanagementscript Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-devicemanagementscript-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagementScript](../resources/intune-devices-devicemanagementscript.md) object. +Read properties and relationships of the [deviceManagementScript](../resources/intune-shared-devicemanagementscript.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagementScript](../resources/intune-devices-devicemanagementscript.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagementScript](../resources/intune-shared-devicemanagementscript.md) object in the response body. ## Example |
v1.0 | Intune Devices Devicemanagementscript List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-devicemanagementscript-list.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -List properties and relationships of the [deviceManagementScript](../resources/intune-devices-devicemanagementscript.md) objects. +List properties and relationships of the [deviceManagementScript](../resources/intune-shared-devicemanagementscript.md) objects. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] GET /deviceManagement/deviceManagementScripts Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and a collection of [deviceManagementScript](../resources/intune-devices-devicemanagementscript.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [deviceManagementScript](../resources/intune-shared-devicemanagementscript.md) objects in the response body. ## Example |
v1.0 | Intune Devices Devicemanagementscript Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-devicemanagementscript-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagementScript](../resources/intune-devices-devicemanagementscript.md) object. +Update the properties of a [deviceManagementScript](../resources/intune-shared-devicemanagementscript.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId} |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagementScript](../resources/intune-devices-devicemanagementscript.md) object. +In the request body, supply a JSON representation for the [deviceManagementScript](../resources/intune-shared-devicemanagementscript.md) object. -The following table shows the properties that are required when you create the [deviceManagementScript](../resources/intune-devices-devicemanagementscript.md). +The following table shows the properties that are required when you create the [deviceManagementScript](../resources/intune-shared-devicemanagementscript.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ |scriptContent|Binary|The script content.| |createdDateTime|DateTimeOffset|The date and time the device management script was created. This property is read-only.| |lastModifiedDateTime|DateTimeOffset|The date and time the device management script was last modified. This property is read-only.|-|runAsAccount|[runAsAccountType](../resources/intune-devices-runasaccounttype.md)|Indicates the type of execution context. Possible values are: `system`, `user`.| +|runAsAccount|[runAsAccountType](../resources/intune-shared-runasaccounttype.md)|Indicates the type of execution context. Possible values are: `system`, `user`.| |fileName|String|Script file name.| |roleScopeTagIds|String collection|List of Scope Tag IDs for this PowerShellScript instance.| ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagementScript](../resources/intune-devices-devicemanagementscript.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagementScript](../resources/intune-shared-devicemanagementscript.md) object in the response body. ## Example |
v1.0 | Intune Devices Devicemanagementscriptrunsummary Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-devicemanagementscriptrunsummary-update.md | Content-Length: 228 "successUserCount": 0, "errorUserCount": 14 }-``` +``` |
v1.0 | Intune Devices Manageddevice Appdiagnostics | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-manageddevice-appdiagnostics.md | Content-Length: 485 } ] }-``` +``` |
v1.0 | Intune Devices Manageddevice Retrievedevicelogcollectionrequests | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-manageddevice-retrievedevicelogcollectionrequests.md | Content-Length: 667 "enrolledByUserPrincipalName": "Enrolled By User Principal Name value" } }-``` +``` |
v1.0 | Intune Devices Manageddevice Syncpayloads | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-manageddevice-syncpayloads.md | Content-length: 421 Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Devices Manageddevice Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-manageddevice-update.md | The following table shows the properties that are required when you create the [ |deviceType|[deviceType](../resources/intune-shared-devicetype.md)|Platform of the device. Examples: Desktop, WindowsRT, etc. Default is unknown. Supports $filter operator 'eq' and 'or'. This property is read-only. Possible values are: `desktop`, `windowsRT`, `winMO6`, `nokia`, `windowsPhone`, `mac`, `winCE`, `winEmbedded`, `iPhone`, `iPad`, `iPod`, `android`, `iSocConsumer`, `unix`, `macMDM`, `holoLens`, `surfaceHub`, `androidForWork`, `androidEnterprise`, `windows10x`, `androidnGMS`, `chromeOS`, `linux`, `blackberry`, `palm`, `unknown`, `cloudPC`.| |complianceState|[complianceState](../resources/intune-devices-compliancestate.md)|Compliance state of the device. Examples: Compliant, Conflict, Error, etc. Default is unknown. Supports $filter operator 'eq' and 'or'. This property is read-only. Possible values are: `unknown`, `compliant`, `noncompliant`, `conflict`, `error`, `inGracePeriod`, `configManager`.| |jailBroken|String|Whether the device is jail broken or rooted. Default is an empty string. Supports $filter operator 'eq' and 'or'. This property is read-only.|-|managementAgent|[managementAgentType](../resources/intune-devices-managementagenttype.md)|Management channel of the device. Examples: Intune, EAS, etc. Default is unknown. Supports $filter operator 'eq' and 'or'. This property is read-only. Possible values are: `eas`, `mdm`, `easMdm`, `intuneClient`, `easIntuneClient`, `configurationManagerClient`, `configurationManagerClientMdm`, `configurationManagerClientMdmEas`, `unknown`, `jamf`, `googleCloudDevicePolicyController`, `microsoft365ManagedMdm`, `msSense`, `intuneAosp`, `google`, `unknownFutureValue`.| +|managementAgent|[managementAgentType](../resources/intune-shared-managementagenttype.md)|Management channel of the device. Examples: Intune, EAS, etc. Default is unknown. Supports $filter operator 'eq' and 'or'. This property is read-only. Possible values are: `eas`, `mdm`, `easMdm`, `intuneClient`, `easIntuneClient`, `configurationManagerClient`, `configurationManagerClientMdm`, `configurationManagerClientMdmEas`, `unknown`, `jamf`, `googleCloudDevicePolicyController`, `microsoft365ManagedMdm`, `msSense`, `intuneAosp`, `google`, `unknownFutureValue`.| |osVersion|String|Operating system version of the device. This property is read-only.| |easActivated|Boolean|Whether the device is Exchange ActiveSync activated. This property is read-only.| |easDeviceId|String|Exchange ActiveSync Id of the device. This property is read-only.| The following table shows the properties that are required when you create the [ |configurationManagerClientInformation|[configurationManagerClientInformation](../resources/intune-devices-configurationmanagerclientinformation.md)|Configuration manager client information, valid only for devices managed, duel-managed or tri-managed by ConfigMgr Agent| |ethernetMacAddress|String|Indicates Ethernet MAC Address of the device. Default, is Null (Non-Default property) for this property when returned as part of managedDevice entity. Individual get call with select query options is needed to retrieve actual values. Example: deviceManagement/managedDevices({managedDeviceId})?$select=ethernetMacAddress Supports: $select. $Search is not supported. Read-only. This property is read-only.| |physicalMemoryInBytes|Int64|Total Memory in Bytes. Default is 0. To retrieve actual values GET call needs to be made, with device id and included in select parameter. Supports: $select. Read-only. This property is read-only.|-|processorArchitecture|[managedDeviceArchitecture](../resources/intune-devices-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| +|processorArchitecture|[managedDeviceArchitecture](../resources/intune-shared-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| |specificationVersion|String|Specification version. This property is read-only.| |joinType|[joinType](../resources/intune-devices-jointype.md)|Device join type. Possible values are: `unknown`, `azureADJoined`, `azureADRegistered`, `hybridAzureADJoined`.| |skuFamily|String|Device sku family| |
v1.0 | Intune Devices Manageddeviceoverview Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-manageddeviceoverview-update.md | Content-Length: 1384 }, "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00" }-``` +``` |
v1.0 | Intune Devices Mobileapptroubleshootingevent Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-mobileapptroubleshootingevent-create.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Create a new [mobileAppTroubleshootingEvent](../resources/intune-devices-mobileapptroubleshootingevent.md) object. +Create a new [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] The following table shows the properties that are required when you create the m ## Response-If successful, this method returns a `201 Created` response code and a [mobileAppTroubleshootingEvent](../resources/intune-devices-mobileapptroubleshootingevent.md) object in the response body. +If successful, this method returns a `201 Created` response code and a [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) object in the response body. ## Example |
v1.0 | Intune Devices Mobileapptroubleshootingevent Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-mobileapptroubleshootingevent-delete.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Deletes a [mobileAppTroubleshootingEvent](../resources/intune-devices-mobileapptroubleshootingevent.md). +Deletes a [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] |
v1.0 | Intune Devices Mobileapptroubleshootingevent Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-mobileapptroubleshootingevent-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [mobileAppTroubleshootingEvent](../resources/intune-devices-mobileapptroubleshootingevent.md) object. +Read properties and relationships of the [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [mobileAppTroubleshootingEvent](../resources/intune-devices-mobileapptroubleshootingevent.md) object in the response body. +If successful, this method returns a `200 OK` response code and [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) object in the response body. ## Example |
v1.0 | Intune Devices Mobileapptroubleshootingevent List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-mobileapptroubleshootingevent-list.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -List properties and relationships of the [mobileAppTroubleshootingEvent](../resources/intune-devices-mobileapptroubleshootingevent.md) objects. +List properties and relationships of the [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) objects. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] GET /deviceManagement/mobileAppTroubleshootingEvents Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and a collection of [mobileAppTroubleshootingEvent](../resources/intune-devices-mobileapptroubleshootingevent.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) objects in the response body. ## Example |
v1.0 | Intune Devices Mobileapptroubleshootingevent Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-mobileapptroubleshootingevent-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [mobileAppTroubleshootingEvent](../resources/intune-devices-mobileapptroubleshootingevent.md) object. +Update the properties of a [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement/mobileAppTroubleshootingEvents/{mobileAppTroubleshooting |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [mobileAppTroubleshootingEvent](../resources/intune-devices-mobileapptroubleshootingevent.md) object. +In the request body, supply a JSON representation for the [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) object. -The following table shows the properties that are required when you create the [mobileAppTroubleshootingEvent](../resources/intune-devices-mobileapptroubleshootingevent.md). +The following table shows the properties that are required when you create the [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [mobileAppTroubleshootingEvent](../resources/intune-devices-mobileapptroubleshootingevent.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) object in the response body. ## Example |
v1.0 | Intune Devices User Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-user-create.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Create a new [user](../resources/intune-devices-user.md) object. +Create a new [user](../resources/intune-shared-user.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] The following table shows the properties that are required when you create the u ## Response-If successful, this method returns a `201 Created` response code and a [user](../resources/intune-devices-user.md) object in the response body. +If successful, this method returns a `201 Created` response code and a [user](../resources/intune-shared-user.md) object in the response body. ## Example Content-Length: 95 "@odata.type": "#microsoft.graph.user", "id": "d36894ae-94ae-d368-ae94-68d3ae9468d3" }-``` +``` |
v1.0 | Intune Devices User Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-user-delete.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Deletes a [user](../resources/intune-devices-user.md). +Deletes a [user](../resources/intune-shared-user.md). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] DELETE https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Devices User Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-user-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [user](../resources/intune-devices-user.md) object. +Read properties and relationships of the [user](../resources/intune-shared-user.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [user](../resources/intune-devices-user.md) object in the response body. +If successful, this method returns a `200 OK` response code and [user](../resources/intune-shared-user.md) object in the response body. ## Example Content-Length: 118 "id": "d36894ae-94ae-d368-ae94-68d3ae9468d3" } }-``` +``` |
v1.0 | Intune Devices User List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-user-list.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -List properties and relationships of the [user](../resources/intune-devices-user.md) objects. +List properties and relationships of the [user](../resources/intune-shared-user.md) objects. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] GET /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceR Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and a collection of [user](../resources/intune-devices-user.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [user](../resources/intune-shared-user.md) objects in the response body. ## Example Content-Length: 136 } ] }-``` +``` |
v1.0 | Intune Devices User Removealldevicesfrommanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-user-removealldevicesfrommanagement.md | POST https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{ Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Devices User Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-user-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [user](../resources/intune-devices-user.md) object. +Update the properties of a [user](../resources/intune-shared-user.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/devic |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [user](../resources/intune-devices-user.md) object. +In the request body, supply a JSON representation for the [user](../resources/intune-shared-user.md) object. -The following table shows the properties that are required when you create the [user](../resources/intune-devices-user.md). +The following table shows the properties that are required when you create the [user](../resources/intune-shared-user.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [user](../resources/intune-devices-user.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [user](../resources/intune-shared-user.md) object in the response body. ## Example Content-Length: 95 "@odata.type": "#microsoft.graph.user", "id": "d36894ae-94ae-d368-ae94-68d3ae9468d3" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsdeviceperformance Summarizedeviceperformancedevices | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsdeviceperformance-summarizedeviceperformancedevices.md | Content-Length: 909 } ] }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsdevicetimelineevents Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsdevicetimelineevents-get.md | Content-Length: 479 "eventAdditionalInformation": "Event Additional Information value" } }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsmetric Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsmetric-get.md | Content-Length: 204 "unit": "Unit value" } }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsmetric List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsmetric-list.md | Content-Length: 226 } ] }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsregressionsummary Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsregressionsummary-get.md | Content-Length: 154 "id": "41683327-3327-4168-2733-684127336841" } }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsregressionsummary Summarizedeviceregressionperformance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsregressionsummary-summarizedeviceregressionperformance.md | Content-Length: 154 "id": "41683327-3327-4168-2733-684127336841" } }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsremoteconnection Summarizedeviceremoteconnection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsremoteconnection-summarizedeviceremoteconnection.md | Content-Length: 715 } ] }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsresourceperformance Summarizedeviceresourceperformance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsresourceperformance-summarizedeviceresourceperformance.md | Content-Length: 979 } ] }-``` +``` |
v1.0 | Intune Devices Windowsdevicemalwarestate Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-windowsdevicemalwarestate-create.md | Content-Length: 533 "detectionCount": 14, "category": "adware" }-``` +``` |
v1.0 | Intune Devices Windowsdevicemalwarestate Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-windowsdevicemalwarestate-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Devices Windowsdevicemalwarestate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-windowsdevicemalwarestate-get.md | Content-Length: 576 "category": "adware" } }-``` +``` |
v1.0 | Intune Devices Windowsdevicemalwarestate List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-windowsdevicemalwarestate-list.md | Content-Length: 614 } ] }-``` +``` |
v1.0 | Intune Devices Windowsdevicemalwarestate Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-windowsdevicemalwarestate-update.md | Content-Length: 533 "detectionCount": 14, "category": "adware" }-``` +``` |
v1.0 | Intune Devices Windowsmanageddevice Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-windowsmanageddevice-create.md | The following table shows the properties that are required when you create the w |deviceType|[deviceType](../resources/intune-shared-devicetype.md)|Platform of the device. Examples: Desktop, WindowsRT, etc. Default is unknown. Supports $filter operator 'eq' and 'or'. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `desktop`, `windowsRT`, `winMO6`, `nokia`, `windowsPhone`, `mac`, `winCE`, `winEmbedded`, `iPhone`, `iPad`, `iPod`, `android`, `iSocConsumer`, `unix`, `macMDM`, `holoLens`, `surfaceHub`, `androidForWork`, `androidEnterprise`, `windows10x`, `androidnGMS`, `chromeOS`, `linux`, `blackberry`, `palm`, `unknown`, `cloudPC`.| |complianceState|[complianceState](../resources/intune-devices-compliancestate.md)|Compliance state of the device. Examples: Compliant, Conflict, Error, etc. Default is unknown. Supports $filter operator 'eq' and 'or'. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `compliant`, `noncompliant`, `conflict`, `error`, `inGracePeriod`, `configManager`.| |jailBroken|String|Whether the device is jail broken or rooted. Default is an empty string. Supports $filter operator 'eq' and 'or'. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|-|managementAgent|[managementAgentType](../resources/intune-devices-managementagenttype.md)|Management channel of the device. Examples: Intune, EAS, etc. Default is unknown. Supports $filter operator 'eq' and 'or'. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `eas`, `mdm`, `easMdm`, `intuneClient`, `easIntuneClient`, `configurationManagerClient`, `configurationManagerClientMdm`, `configurationManagerClientMdmEas`, `unknown`, `jamf`, `googleCloudDevicePolicyController`, `microsoft365ManagedMdm`, `msSense`, `intuneAosp`, `google`, `unknownFutureValue`.| +|managementAgent|[managementAgentType](../resources/intune-shared-managementagenttype.md)|Management channel of the device. Examples: Intune, EAS, etc. Default is unknown. Supports $filter operator 'eq' and 'or'. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `eas`, `mdm`, `easMdm`, `intuneClient`, `easIntuneClient`, `configurationManagerClient`, `configurationManagerClientMdm`, `configurationManagerClientMdmEas`, `unknown`, `jamf`, `googleCloudDevicePolicyController`, `microsoft365ManagedMdm`, `msSense`, `intuneAosp`, `google`, `unknownFutureValue`.| |osVersion|String|Operating system version of the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |easActivated|Boolean|Whether the device is Exchange ActiveSync activated. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |easDeviceId|String|Exchange ActiveSync Id of the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| The following table shows the properties that are required when you create the w |configurationManagerClientInformation|[configurationManagerClientInformation](../resources/intune-devices-configurationmanagerclientinformation.md)|Configuration manager client information, valid only for devices managed, duel-managed or tri-managed by ConfigMgr Agent Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |ethernetMacAddress|String|Indicates Ethernet MAC Address of the device. Default, is Null (Non-Default property) for this property when returned as part of managedDevice entity. Individual get call with select query options is needed to retrieve actual values. Example: deviceManagement/managedDevices({managedDeviceId})?$select=ethernetMacAddress Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |physicalMemoryInBytes|Int64|Total Memory in Bytes. Default is 0. To retrieve actual values GET call needs to be made, with device id and included in select parameter. Supports: $select. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|-|processorArchitecture|[managedDeviceArchitecture](../resources/intune-devices-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| +|processorArchitecture|[managedDeviceArchitecture](../resources/intune-shared-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| |specificationVersion|String|Specification version. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |joinType|[joinType](../resources/intune-devices-jointype.md)|Device join type Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `azureADJoined`, `azureADRegistered`, `hybridAzureADJoined`.| |skuFamily|String|Device sku family Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |
v1.0 | Intune Devices Windowsmanageddevice Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-windowsmanageddevice-update.md | The following table shows the properties that are required when you create the [ |deviceType|[deviceType](../resources/intune-shared-devicetype.md)|Platform of the device. Examples: Desktop, WindowsRT, etc. Default is unknown. Supports $filter operator 'eq' and 'or'. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `desktop`, `windowsRT`, `winMO6`, `nokia`, `windowsPhone`, `mac`, `winCE`, `winEmbedded`, `iPhone`, `iPad`, `iPod`, `android`, `iSocConsumer`, `unix`, `macMDM`, `holoLens`, `surfaceHub`, `androidForWork`, `androidEnterprise`, `windows10x`, `androidnGMS`, `chromeOS`, `linux`, `blackberry`, `palm`, `unknown`, `cloudPC`.| |complianceState|[complianceState](../resources/intune-devices-compliancestate.md)|Compliance state of the device. Examples: Compliant, Conflict, Error, etc. Default is unknown. Supports $filter operator 'eq' and 'or'. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `compliant`, `noncompliant`, `conflict`, `error`, `inGracePeriod`, `configManager`.| |jailBroken|String|Whether the device is jail broken or rooted. Default is an empty string. Supports $filter operator 'eq' and 'or'. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|-|managementAgent|[managementAgentType](../resources/intune-devices-managementagenttype.md)|Management channel of the device. Examples: Intune, EAS, etc. Default is unknown. Supports $filter operator 'eq' and 'or'. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `eas`, `mdm`, `easMdm`, `intuneClient`, `easIntuneClient`, `configurationManagerClient`, `configurationManagerClientMdm`, `configurationManagerClientMdmEas`, `unknown`, `jamf`, `googleCloudDevicePolicyController`, `microsoft365ManagedMdm`, `msSense`, `intuneAosp`, `google`, `unknownFutureValue`.| +|managementAgent|[managementAgentType](../resources/intune-shared-managementagenttype.md)|Management channel of the device. Examples: Intune, EAS, etc. Default is unknown. Supports $filter operator 'eq' and 'or'. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `eas`, `mdm`, `easMdm`, `intuneClient`, `easIntuneClient`, `configurationManagerClient`, `configurationManagerClientMdm`, `configurationManagerClientMdmEas`, `unknown`, `jamf`, `googleCloudDevicePolicyController`, `microsoft365ManagedMdm`, `msSense`, `intuneAosp`, `google`, `unknownFutureValue`.| |osVersion|String|Operating system version of the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |easActivated|Boolean|Whether the device is Exchange ActiveSync activated. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |easDeviceId|String|Exchange ActiveSync Id of the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| The following table shows the properties that are required when you create the [ |configurationManagerClientInformation|[configurationManagerClientInformation](../resources/intune-devices-configurationmanagerclientinformation.md)|Configuration manager client information, valid only for devices managed, duel-managed or tri-managed by ConfigMgr Agent Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |ethernetMacAddress|String|Indicates Ethernet MAC Address of the device. Default, is Null (Non-Default property) for this property when returned as part of managedDevice entity. Individual get call with select query options is needed to retrieve actual values. Example: deviceManagement/managedDevices({managedDeviceId})?$select=ethernetMacAddress Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |physicalMemoryInBytes|Int64|Total Memory in Bytes. Default is 0. To retrieve actual values GET call needs to be made, with device id and included in select parameter. Supports: $select. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|-|processorArchitecture|[managedDeviceArchitecture](../resources/intune-devices-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| +|processorArchitecture|[managedDeviceArchitecture](../resources/intune-shared-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| |specificationVersion|String|Specification version. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |joinType|[joinType](../resources/intune-devices-jointype.md)|Device join type Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `azureADJoined`, `azureADRegistered`, `hybridAzureADJoined`.| |skuFamily|String|Device sku family Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |
v1.0 | Intune Devices Windowsmanagementapp Setasmanagedinstaller | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-windowsmanagementapp-setasmanagedinstaller.md | POST https://graph.microsoft.com/beta/deviceAppManagement/windowsManagementApp/s Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Devices Windowsmanagementapp Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-windowsmanagementapp-update.md | Content-Length: 284 "managedInstaller": "enabled", "managedInstallerConfiguredDateTime": "Managed Installer Configured Date Time value" }-``` +``` |
v1.0 | Intune Devices Windowsmanagementapphealthstate Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-windowsmanagementapphealthstate-create.md | Content-Length: 349 "deviceName": "Device Name value", "deviceOSVersion": "Device OSVersion value" }-``` +``` |
v1.0 | Intune Devices Windowsmanagementapphealthstate Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-windowsmanagementapphealthstate-delete.md | DELETE https://graph.microsoft.com/beta/deviceAppManagement/windowsManagementApp Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Devices Windowsmanagementapphealthstate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-windowsmanagementapphealthstate-get.md | Content-Length: 382 "deviceOSVersion": "Device OSVersion value" } }-``` +``` |
v1.0 | Intune Devices Windowsmanagementapphealthstate List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-windowsmanagementapphealthstate-list.md | Content-Length: 410 } ] }-``` +``` |
v1.0 | Intune Devices Windowsmanagementapphealthstate Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-windowsmanagementapphealthstate-update.md | Content-Length: 349 "deviceName": "Device Name value", "deviceOSVersion": "Device OSVersion value" }-``` +``` |
v1.0 | Intune Devices Windowsprotectionstate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-windowsprotectionstate-get.md | Content-Length: 1083 "tamperProtectionEnabled": true } }-``` +``` |
v1.0 | Intune Devices Windowsprotectionstate Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-windowsprotectionstate-update.md | Content-Length: 1020 "isVirtualMachine": true, "tamperProtectionEnabled": true }-``` +``` |
v1.0 | Intune Enrollment Activedirectorywindowsautopilotdeploymentprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-activedirectorywindowsautopilotdeploymentprofile-create.md | The following table shows the properties that are required when you create the a |Property|Type|Description| |:|:|:| |id|String|Profile Key Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)|-|displayName|String|Name of the profile Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|description|String|Description of the profile Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|language|String|Language configured on the device Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|createdDateTime|DateTimeOffset|Profile creation time Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|lastModifiedDateTime|DateTimeOffset|Profile last modified time Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|outOfBoxExperienceSettings|[outOfBoxExperienceSettings](../resources/intune-enrollment-outofboxexperiencesettings.md)|Out of box experience setting Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|displayName|String|The display name of the deployment profile. Max allowed length is 200 chars. Returned by default. Supports: $select, $top, $skip, $orderby. $Search and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|description|String|A description of the deployment profile. Max allowed length is 1500 chars. Supports: $select, $top, $skip, $orderBy. $Search and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|language|String|The language code to be used when configuring the device. E.g. en-US. The default value is os-default. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use locale instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|locale|String|The locale (language) to be used when configuring the device. E.g. en-US. The default value is os-default. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|createdDateTime|DateTimeOffset|The date and time of when the deployment profile was created. The value cannot be modified and is automatically populated when the profile was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|lastModifiedDateTime|DateTimeOffset|The date and time of when the deployment profile was last modified. The value cannot be updated manually and is automatically populated when any changes are made to the profile. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported Read-Only. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|outOfBoxExperienceSettings|[outOfBoxExperienceSettings](../resources/intune-enrollment-outofboxexperiencesettings.md)|The Windows Autopilot Deployment Profile settings used by the Autopilot device for out-of-box experience. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use outOfBoxExperienceSetting instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|outOfBoxExperienceSetting|[outOfBoxExperienceSetting](../resources/intune-enrollment-outofboxexperiencesetting.md)|The Windows Autopilot Deployment Profile settings used by the device for the out-of-box experience. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| |enrollmentStatusScreenSettings|[windowsEnrollmentStatusScreenSettings](../resources/intune-enrollment-windowsenrollmentstatusscreensettings.md)|Enrollment status screen setting Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)|-|extractHardwareHash|Boolean|HardwareHash Extraction for the profile Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|deviceNameTemplate|String|The template used to name the AutoPilot Device. This can be a custom text and can also contain either the serial number of the device, or a randomly generated number. The total length of the text generated by the template can be no more than 15 characters. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|deviceType|[windowsAutopilotDeviceType](../resources/intune-enrollment-windowsautopilotdevicetype.md)|The AutoPilot device type that this profile is applicable to. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md). Possible values are: `windowsPc`, `surfaceHub2`, `holoLens`, `surfaceHub2S`, `virtualMachine`, `unknownFutureValue`.| -|enableWhiteGlove|Boolean|Enable Autopilot White Glove for the profile. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|roleScopeTagIds|String collection|Scope tags for the profile. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|managementServiceAppId|String|AzureAD management app ID used during client device-based enrollment discovery Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|extractHardwareHash|Boolean|Indicates whether the profile supports the extraction of hardware hash values and registration of the device into Windows Autopilot. When TRUE, indicates if hardware extraction and Windows Autopilot registration will happen on the next successful check-in. When FALSE, hardware hash extraction and Windows Autopilot registration will not happen. Default value is FALSE. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use hardwareHashExtractionEnabled instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|hardwareHashExtractionEnabled|Boolean|Indicates whether the profile supports the extraction of hardware hash values and registration of the device into Windows Autopilot. When TRUE, indicates if hardware extraction and Windows Autopilot registration will happen on the next successful check-in. When FALSE, hardware hash extraction and Windows Autopilot registration will not happen. Default value is FALSE. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|deviceNameTemplate|String|The template used to name the Autopilot device. This can be a custom text and can also contain either the serial number of the device, or a randomly generated number. The total length of the text generated by the template can be no more than 15 characters. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|deviceType|[windowsAutopilotDeviceType](../resources/intune-enrollment-windowsautopilotdevicetype.md)|The Windows device type that this profile is applicable to. Possible values include windowsPc, holoLens, and virtualMachine. The default is windowsPc. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md). Possible values are: `windowsPc`, `surfaceHub2`, `holoLens`, `surfaceHub2S`, `virtualMachine`, `unknownFutureValue`.| +|enableWhiteGlove|Boolean|Indicates whether the user is allowed to use Windows Autopilot for pre-provisioned deployment mode during Out of Box experience (OOBE). When TRUE, indicates that Windows Autopilot for pre-provisioned deployment mode is allowed. When false, Windows Autopilot for pre-provisioned deployment mode is not allowed. The default is FALSE. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use preprovisioningAllowed instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|preprovisioningAllowed|Boolean|Indicates whether the user is allowed to use Windows Autopilot for pre-provisioned deployment mode during Out of Box experience (OOBE). When TRUE, indicates that Windows Autopilot for pre-provisioned deployment mode for OOBE is allowed to be used. When false, Windows Autopilot for pre-provisioned deployment mode for OOBE is not allowed. The default is FALSE. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|roleScopeTagIds|String collection|List of role scope tags for the deployment profile. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|managementServiceAppId|String|The Entra management service App ID which gets used during client device-based enrollment discovery. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| |hybridAzureADJoinSkipConnectivityCheck|Boolean|The Autopilot Hybrid Azure AD join flow will continue even if it does not establish domain controller connectivity during OOBE.| Here is an example of the request. ``` http POST https://graph.microsoft.com/beta/deviceManagement/windowsAutopilotDeploymentProfiles Content-type: application/json-Content-length: 1282 +Content-length: 1690 { "@odata.type": "#microsoft.graph.activeDirectoryWindowsAutopilotDeploymentProfile", "displayName": "Display Name value", "description": "Description value", "language": "Language value",+ "locale": "Locale value", "outOfBoxExperienceSettings": { "@odata.type": "microsoft.graph.outOfBoxExperienceSettings", "hidePrivacySettings": true, Content-length: 1282 "skipKeyboardSelectionPage": true, "hideEscapeLink": true },+ "outOfBoxExperienceSetting": { + "@odata.type": "microsoft.graph.outOfBoxExperienceSetting", + "privacySettingsHidden": true, + "eulaHidden": true, + "userType": "standard", + "deviceUsageType": "shared", + "keyboardSelectionPageSkipped": true, + "escapeLinkHidden": true + }, "enrollmentStatusScreenSettings": { "@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings", "hideInstallationProgress": true, Content-length: 1282 "allowDeviceUseOnInstallFailure": true }, "extractHardwareHash": true,+ "hardwareHashExtractionEnabled": true, "deviceNameTemplate": "Device Name Template value", "deviceType": "surfaceHub2", "enableWhiteGlove": true,+ "preprovisioningAllowed": true, "roleScopeTagIds": [ "Role Scope Tag Ids value" ], Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 201 Created Content-Type: application/json-Content-Length: 1454 +Content-Length: 1862 { "@odata.type": "#microsoft.graph.activeDirectoryWindowsAutopilotDeploymentProfile", Content-Length: 1454 "displayName": "Display Name value", "description": "Description value", "language": "Language value",+ "locale": "Locale value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", "outOfBoxExperienceSettings": { Content-Length: 1454 "skipKeyboardSelectionPage": true, "hideEscapeLink": true },+ "outOfBoxExperienceSetting": { + "@odata.type": "microsoft.graph.outOfBoxExperienceSetting", + "privacySettingsHidden": true, + "eulaHidden": true, + "userType": "standard", + "deviceUsageType": "shared", + "keyboardSelectionPageSkipped": true, + "escapeLinkHidden": true + }, "enrollmentStatusScreenSettings": { "@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings", "hideInstallationProgress": true, Content-Length: 1454 "allowDeviceUseOnInstallFailure": true }, "extractHardwareHash": true,+ "hardwareHashExtractionEnabled": true, "deviceNameTemplate": "Device Name Template value", "deviceType": "surfaceHub2", "enableWhiteGlove": true,+ "preprovisioningAllowed": true, "roleScopeTagIds": [ "Role Scope Tag Ids value" ], |
v1.0 | Intune Enrollment Activedirectorywindowsautopilotdeploymentprofile Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-activedirectorywindowsautopilotdeploymentprofile-get.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1543 +Content-Length: 1975 { "value": { Content-Length: 1543 "displayName": "Display Name value", "description": "Description value", "language": "Language value",+ "locale": "Locale value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", "outOfBoxExperienceSettings": { Content-Length: 1543 "skipKeyboardSelectionPage": true, "hideEscapeLink": true },+ "outOfBoxExperienceSetting": { + "@odata.type": "microsoft.graph.outOfBoxExperienceSetting", + "privacySettingsHidden": true, + "eulaHidden": true, + "userType": "standard", + "deviceUsageType": "shared", + "keyboardSelectionPageSkipped": true, + "escapeLinkHidden": true + }, "enrollmentStatusScreenSettings": { "@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings", "hideInstallationProgress": true, Content-Length: 1543 "allowDeviceUseOnInstallFailure": true }, "extractHardwareHash": true,+ "hardwareHashExtractionEnabled": true, "deviceNameTemplate": "Device Name Template value", "deviceType": "surfaceHub2", "enableWhiteGlove": true,+ "preprovisioningAllowed": true, "roleScopeTagIds": [ "Role Scope Tag Ids value" ], |
v1.0 | Intune Enrollment Activedirectorywindowsautopilotdeploymentprofile List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-activedirectorywindowsautopilotdeploymentprofile-list.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1627 +Content-Length: 2083 { "value": [ Content-Length: 1627 "displayName": "Display Name value", "description": "Description value", "language": "Language value",+ "locale": "Locale value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", "outOfBoxExperienceSettings": { Content-Length: 1627 "skipKeyboardSelectionPage": true, "hideEscapeLink": true },+ "outOfBoxExperienceSetting": { + "@odata.type": "microsoft.graph.outOfBoxExperienceSetting", + "privacySettingsHidden": true, + "eulaHidden": true, + "userType": "standard", + "deviceUsageType": "shared", + "keyboardSelectionPageSkipped": true, + "escapeLinkHidden": true + }, "enrollmentStatusScreenSettings": { "@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings", "hideInstallationProgress": true, Content-Length: 1627 "allowDeviceUseOnInstallFailure": true }, "extractHardwareHash": true,+ "hardwareHashExtractionEnabled": true, "deviceNameTemplate": "Device Name Template value", "deviceType": "surfaceHub2", "enableWhiteGlove": true,+ "preprovisioningAllowed": true, "roleScopeTagIds": [ "Role Scope Tag Ids value" ], |
v1.0 | Intune Enrollment Activedirectorywindowsautopilotdeploymentprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-activedirectorywindowsautopilotdeploymentprofile-update.md | The following table shows the properties that are required when you create the [ |Property|Type|Description| |:|:|:| |id|String|Profile Key Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)|-|displayName|String|Name of the profile Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|description|String|Description of the profile Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|language|String|Language configured on the device Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|createdDateTime|DateTimeOffset|Profile creation time Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|lastModifiedDateTime|DateTimeOffset|Profile last modified time Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|outOfBoxExperienceSettings|[outOfBoxExperienceSettings](../resources/intune-enrollment-outofboxexperiencesettings.md)|Out of box experience setting Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|displayName|String|The display name of the deployment profile. Max allowed length is 200 chars. Returned by default. Supports: $select, $top, $skip, $orderby. $Search and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|description|String|A description of the deployment profile. Max allowed length is 1500 chars. Supports: $select, $top, $skip, $orderBy. $Search and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|language|String|The language code to be used when configuring the device. E.g. en-US. The default value is os-default. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use locale instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|locale|String|The locale (language) to be used when configuring the device. E.g. en-US. The default value is os-default. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|createdDateTime|DateTimeOffset|The date and time of when the deployment profile was created. The value cannot be modified and is automatically populated when the profile was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|lastModifiedDateTime|DateTimeOffset|The date and time of when the deployment profile was last modified. The value cannot be updated manually and is automatically populated when any changes are made to the profile. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported Read-Only. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|outOfBoxExperienceSettings|[outOfBoxExperienceSettings](../resources/intune-enrollment-outofboxexperiencesettings.md)|The Windows Autopilot Deployment Profile settings used by the Autopilot device for out-of-box experience. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use outOfBoxExperienceSetting instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|outOfBoxExperienceSetting|[outOfBoxExperienceSetting](../resources/intune-enrollment-outofboxexperiencesetting.md)|The Windows Autopilot Deployment Profile settings used by the device for the out-of-box experience. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| |enrollmentStatusScreenSettings|[windowsEnrollmentStatusScreenSettings](../resources/intune-enrollment-windowsenrollmentstatusscreensettings.md)|Enrollment status screen setting Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)|-|extractHardwareHash|Boolean|HardwareHash Extraction for the profile Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|deviceNameTemplate|String|The template used to name the AutoPilot Device. This can be a custom text and can also contain either the serial number of the device, or a randomly generated number. The total length of the text generated by the template can be no more than 15 characters. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|deviceType|[windowsAutopilotDeviceType](../resources/intune-enrollment-windowsautopilotdevicetype.md)|The AutoPilot device type that this profile is applicable to. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md). Possible values are: `windowsPc`, `surfaceHub2`, `holoLens`, `surfaceHub2S`, `virtualMachine`, `unknownFutureValue`.| -|enableWhiteGlove|Boolean|Enable Autopilot White Glove for the profile. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|roleScopeTagIds|String collection|Scope tags for the profile. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|managementServiceAppId|String|AzureAD management app ID used during client device-based enrollment discovery Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|extractHardwareHash|Boolean|Indicates whether the profile supports the extraction of hardware hash values and registration of the device into Windows Autopilot. When TRUE, indicates if hardware extraction and Windows Autopilot registration will happen on the next successful check-in. When FALSE, hardware hash extraction and Windows Autopilot registration will not happen. Default value is FALSE. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use hardwareHashExtractionEnabled instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|hardwareHashExtractionEnabled|Boolean|Indicates whether the profile supports the extraction of hardware hash values and registration of the device into Windows Autopilot. When TRUE, indicates if hardware extraction and Windows Autopilot registration will happen on the next successful check-in. When FALSE, hardware hash extraction and Windows Autopilot registration will not happen. Default value is FALSE. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|deviceNameTemplate|String|The template used to name the Autopilot device. This can be a custom text and can also contain either the serial number of the device, or a randomly generated number. The total length of the text generated by the template can be no more than 15 characters. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|deviceType|[windowsAutopilotDeviceType](../resources/intune-enrollment-windowsautopilotdevicetype.md)|The Windows device type that this profile is applicable to. Possible values include windowsPc, holoLens, and virtualMachine. The default is windowsPc. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md). Possible values are: `windowsPc`, `surfaceHub2`, `holoLens`, `surfaceHub2S`, `virtualMachine`, `unknownFutureValue`.| +|enableWhiteGlove|Boolean|Indicates whether the user is allowed to use Windows Autopilot for pre-provisioned deployment mode during Out of Box experience (OOBE). When TRUE, indicates that Windows Autopilot for pre-provisioned deployment mode is allowed. When false, Windows Autopilot for pre-provisioned deployment mode is not allowed. The default is FALSE. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use preprovisioningAllowed instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|preprovisioningAllowed|Boolean|Indicates whether the user is allowed to use Windows Autopilot for pre-provisioned deployment mode during Out of Box experience (OOBE). When TRUE, indicates that Windows Autopilot for pre-provisioned deployment mode for OOBE is allowed to be used. When false, Windows Autopilot for pre-provisioned deployment mode for OOBE is not allowed. The default is FALSE. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|roleScopeTagIds|String collection|List of role scope tags for the deployment profile. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|managementServiceAppId|String|The Entra management service App ID which gets used during client device-based enrollment discovery. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| |hybridAzureADJoinSkipConnectivityCheck|Boolean|The Autopilot Hybrid Azure AD join flow will continue even if it does not establish domain controller connectivity during OOBE.| Here is an example of the request. ``` http PATCH https://graph.microsoft.com/beta/deviceManagement/windowsAutopilotDeploymentProfiles/{windowsAutopilotDeploymentProfileId} Content-type: application/json-Content-length: 1282 +Content-length: 1690 { "@odata.type": "#microsoft.graph.activeDirectoryWindowsAutopilotDeploymentProfile", "displayName": "Display Name value", "description": "Description value", "language": "Language value",+ "locale": "Locale value", "outOfBoxExperienceSettings": { "@odata.type": "microsoft.graph.outOfBoxExperienceSettings", "hidePrivacySettings": true, Content-length: 1282 "skipKeyboardSelectionPage": true, "hideEscapeLink": true },+ "outOfBoxExperienceSetting": { + "@odata.type": "microsoft.graph.outOfBoxExperienceSetting", + "privacySettingsHidden": true, + "eulaHidden": true, + "userType": "standard", + "deviceUsageType": "shared", + "keyboardSelectionPageSkipped": true, + "escapeLinkHidden": true + }, "enrollmentStatusScreenSettings": { "@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings", "hideInstallationProgress": true, Content-length: 1282 "allowDeviceUseOnInstallFailure": true }, "extractHardwareHash": true,+ "hardwareHashExtractionEnabled": true, "deviceNameTemplate": "Device Name Template value", "deviceType": "surfaceHub2", "enableWhiteGlove": true,+ "preprovisioningAllowed": true, "roleScopeTagIds": [ "Role Scope Tag Ids value" ], Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1454 +Content-Length: 1862 { "@odata.type": "#microsoft.graph.activeDirectoryWindowsAutopilotDeploymentProfile", Content-Length: 1454 "displayName": "Display Name value", "description": "Description value", "language": "Language value",+ "locale": "Locale value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", "outOfBoxExperienceSettings": { Content-Length: 1454 "skipKeyboardSelectionPage": true, "hideEscapeLink": true },+ "outOfBoxExperienceSetting": { + "@odata.type": "microsoft.graph.outOfBoxExperienceSetting", + "privacySettingsHidden": true, + "eulaHidden": true, + "userType": "standard", + "deviceUsageType": "shared", + "keyboardSelectionPageSkipped": true, + "escapeLinkHidden": true + }, "enrollmentStatusScreenSettings": { "@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings", "hideInstallationProgress": true, Content-Length: 1454 "allowDeviceUseOnInstallFailure": true }, "extractHardwareHash": true,+ "hardwareHashExtractionEnabled": true, "deviceNameTemplate": "Device Name Template value", "deviceType": "surfaceHub2", "enableWhiteGlove": true,+ "preprovisioningAllowed": true, "roleScopeTagIds": [ "Role Scope Tag Ids value" ], |
v1.0 | Intune Enrollment Azureadwindowsautopilotdeploymentprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-azureadwindowsautopilotdeploymentprofile-create.md | The following table shows the properties that are required when you create the a |Property|Type|Description| |:|:|:| |id|String|Profile Key Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)|-|displayName|String|Name of the profile Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|description|String|Description of the profile Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|language|String|Language configured on the device Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|createdDateTime|DateTimeOffset|Profile creation time Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|lastModifiedDateTime|DateTimeOffset|Profile last modified time Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|outOfBoxExperienceSettings|[outOfBoxExperienceSettings](../resources/intune-enrollment-outofboxexperiencesettings.md)|Out of box experience setting Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|displayName|String|The display name of the deployment profile. Max allowed length is 200 chars. Returned by default. Supports: $select, $top, $skip, $orderby. $Search and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|description|String|A description of the deployment profile. Max allowed length is 1500 chars. Supports: $select, $top, $skip, $orderBy. $Search and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|language|String|The language code to be used when configuring the device. E.g. en-US. The default value is os-default. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use locale instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|locale|String|The locale (language) to be used when configuring the device. E.g. en-US. The default value is os-default. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|createdDateTime|DateTimeOffset|The date and time of when the deployment profile was created. The value cannot be modified and is automatically populated when the profile was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|lastModifiedDateTime|DateTimeOffset|The date and time of when the deployment profile was last modified. The value cannot be updated manually and is automatically populated when any changes are made to the profile. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported Read-Only. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|outOfBoxExperienceSettings|[outOfBoxExperienceSettings](../resources/intune-enrollment-outofboxexperiencesettings.md)|The Windows Autopilot Deployment Profile settings used by the Autopilot device for out-of-box experience. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use outOfBoxExperienceSetting instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|outOfBoxExperienceSetting|[outOfBoxExperienceSetting](../resources/intune-enrollment-outofboxexperiencesetting.md)|The Windows Autopilot Deployment Profile settings used by the device for the out-of-box experience. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| |enrollmentStatusScreenSettings|[windowsEnrollmentStatusScreenSettings](../resources/intune-enrollment-windowsenrollmentstatusscreensettings.md)|Enrollment status screen setting Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)|-|extractHardwareHash|Boolean|HardwareHash Extraction for the profile Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|deviceNameTemplate|String|The template used to name the AutoPilot Device. This can be a custom text and can also contain either the serial number of the device, or a randomly generated number. The total length of the text generated by the template can be no more than 15 characters. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|deviceType|[windowsAutopilotDeviceType](../resources/intune-enrollment-windowsautopilotdevicetype.md)|The AutoPilot device type that this profile is applicable to. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md). Possible values are: `windowsPc`, `surfaceHub2`, `holoLens`, `surfaceHub2S`, `virtualMachine`, `unknownFutureValue`.| -|enableWhiteGlove|Boolean|Enable Autopilot White Glove for the profile. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|roleScopeTagIds|String collection|Scope tags for the profile. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|managementServiceAppId|String|AzureAD management app ID used during client device-based enrollment discovery Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|extractHardwareHash|Boolean|Indicates whether the profile supports the extraction of hardware hash values and registration of the device into Windows Autopilot. When TRUE, indicates if hardware extraction and Windows Autopilot registration will happen on the next successful check-in. When FALSE, hardware hash extraction and Windows Autopilot registration will not happen. Default value is FALSE. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use hardwareHashExtractionEnabled instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|hardwareHashExtractionEnabled|Boolean|Indicates whether the profile supports the extraction of hardware hash values and registration of the device into Windows Autopilot. When TRUE, indicates if hardware extraction and Windows Autopilot registration will happen on the next successful check-in. When FALSE, hardware hash extraction and Windows Autopilot registration will not happen. Default value is FALSE. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|deviceNameTemplate|String|The template used to name the Autopilot device. This can be a custom text and can also contain either the serial number of the device, or a randomly generated number. The total length of the text generated by the template can be no more than 15 characters. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|deviceType|[windowsAutopilotDeviceType](../resources/intune-enrollment-windowsautopilotdevicetype.md)|The Windows device type that this profile is applicable to. Possible values include windowsPc, holoLens, and virtualMachine. The default is windowsPc. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md). Possible values are: `windowsPc`, `surfaceHub2`, `holoLens`, `surfaceHub2S`, `virtualMachine`, `unknownFutureValue`.| +|enableWhiteGlove|Boolean|Indicates whether the user is allowed to use Windows Autopilot for pre-provisioned deployment mode during Out of Box experience (OOBE). When TRUE, indicates that Windows Autopilot for pre-provisioned deployment mode is allowed. When false, Windows Autopilot for pre-provisioned deployment mode is not allowed. The default is FALSE. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use preprovisioningAllowed instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|preprovisioningAllowed|Boolean|Indicates whether the user is allowed to use Windows Autopilot for pre-provisioned deployment mode during Out of Box experience (OOBE). When TRUE, indicates that Windows Autopilot for pre-provisioned deployment mode for OOBE is allowed to be used. When false, Windows Autopilot for pre-provisioned deployment mode for OOBE is not allowed. The default is FALSE. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|roleScopeTagIds|String collection|List of role scope tags for the deployment profile. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|managementServiceAppId|String|The Entra management service App ID which gets used during client device-based enrollment discovery. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| Here is an example of the request. ``` http POST https://graph.microsoft.com/beta/deviceManagement/windowsAutopilotDeploymentProfiles Content-type: application/json-Content-length: 1223 +Content-length: 1631 { "@odata.type": "#microsoft.graph.azureADWindowsAutopilotDeploymentProfile", "displayName": "Display Name value", "description": "Description value", "language": "Language value",+ "locale": "Locale value", "outOfBoxExperienceSettings": { "@odata.type": "microsoft.graph.outOfBoxExperienceSettings", "hidePrivacySettings": true, Content-length: 1223 "skipKeyboardSelectionPage": true, "hideEscapeLink": true },+ "outOfBoxExperienceSetting": { + "@odata.type": "microsoft.graph.outOfBoxExperienceSetting", + "privacySettingsHidden": true, + "eulaHidden": true, + "userType": "standard", + "deviceUsageType": "shared", + "keyboardSelectionPageSkipped": true, + "escapeLinkHidden": true + }, "enrollmentStatusScreenSettings": { "@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings", "hideInstallationProgress": true, Content-length: 1223 "allowDeviceUseOnInstallFailure": true }, "extractHardwareHash": true,+ "hardwareHashExtractionEnabled": true, "deviceNameTemplate": "Device Name Template value", "deviceType": "surfaceHub2", "enableWhiteGlove": true,+ "preprovisioningAllowed": true, "roleScopeTagIds": [ "Role Scope Tag Ids value" ], Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 201 Created Content-Type: application/json-Content-Length: 1395 +Content-Length: 1803 { "@odata.type": "#microsoft.graph.azureADWindowsAutopilotDeploymentProfile", Content-Length: 1395 "displayName": "Display Name value", "description": "Description value", "language": "Language value",+ "locale": "Locale value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", "outOfBoxExperienceSettings": { Content-Length: 1395 "skipKeyboardSelectionPage": true, "hideEscapeLink": true },+ "outOfBoxExperienceSetting": { + "@odata.type": "microsoft.graph.outOfBoxExperienceSetting", + "privacySettingsHidden": true, + "eulaHidden": true, + "userType": "standard", + "deviceUsageType": "shared", + "keyboardSelectionPageSkipped": true, + "escapeLinkHidden": true + }, "enrollmentStatusScreenSettings": { "@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings", "hideInstallationProgress": true, Content-Length: 1395 "allowDeviceUseOnInstallFailure": true }, "extractHardwareHash": true,+ "hardwareHashExtractionEnabled": true, "deviceNameTemplate": "Device Name Template value", "deviceType": "surfaceHub2", "enableWhiteGlove": true,+ "preprovisioningAllowed": true, "roleScopeTagIds": [ "Role Scope Tag Ids value" ], |
v1.0 | Intune Enrollment Azureadwindowsautopilotdeploymentprofile Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-azureadwindowsautopilotdeploymentprofile-get.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1482 +Content-Length: 1914 { "value": { Content-Length: 1482 "displayName": "Display Name value", "description": "Description value", "language": "Language value",+ "locale": "Locale value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", "outOfBoxExperienceSettings": { Content-Length: 1482 "skipKeyboardSelectionPage": true, "hideEscapeLink": true },+ "outOfBoxExperienceSetting": { + "@odata.type": "microsoft.graph.outOfBoxExperienceSetting", + "privacySettingsHidden": true, + "eulaHidden": true, + "userType": "standard", + "deviceUsageType": "shared", + "keyboardSelectionPageSkipped": true, + "escapeLinkHidden": true + }, "enrollmentStatusScreenSettings": { "@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings", "hideInstallationProgress": true, Content-Length: 1482 "allowDeviceUseOnInstallFailure": true }, "extractHardwareHash": true,+ "hardwareHashExtractionEnabled": true, "deviceNameTemplate": "Device Name Template value", "deviceType": "surfaceHub2", "enableWhiteGlove": true,+ "preprovisioningAllowed": true, "roleScopeTagIds": [ "Role Scope Tag Ids value" ], |
v1.0 | Intune Enrollment Azureadwindowsautopilotdeploymentprofile List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-azureadwindowsautopilotdeploymentprofile-list.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1564 +Content-Length: 2020 { "value": [ Content-Length: 1564 "displayName": "Display Name value", "description": "Description value", "language": "Language value",+ "locale": "Locale value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", "outOfBoxExperienceSettings": { Content-Length: 1564 "skipKeyboardSelectionPage": true, "hideEscapeLink": true },+ "outOfBoxExperienceSetting": { + "@odata.type": "microsoft.graph.outOfBoxExperienceSetting", + "privacySettingsHidden": true, + "eulaHidden": true, + "userType": "standard", + "deviceUsageType": "shared", + "keyboardSelectionPageSkipped": true, + "escapeLinkHidden": true + }, "enrollmentStatusScreenSettings": { "@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings", "hideInstallationProgress": true, Content-Length: 1564 "allowDeviceUseOnInstallFailure": true }, "extractHardwareHash": true,+ "hardwareHashExtractionEnabled": true, "deviceNameTemplate": "Device Name Template value", "deviceType": "surfaceHub2", "enableWhiteGlove": true,+ "preprovisioningAllowed": true, "roleScopeTagIds": [ "Role Scope Tag Ids value" ], |
v1.0 | Intune Enrollment Azureadwindowsautopilotdeploymentprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-azureadwindowsautopilotdeploymentprofile-update.md | The following table shows the properties that are required when you create the [ |Property|Type|Description| |:|:|:| |id|String|Profile Key Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)|-|displayName|String|Name of the profile Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|description|String|Description of the profile Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|language|String|Language configured on the device Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|createdDateTime|DateTimeOffset|Profile creation time Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|lastModifiedDateTime|DateTimeOffset|Profile last modified time Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|outOfBoxExperienceSettings|[outOfBoxExperienceSettings](../resources/intune-enrollment-outofboxexperiencesettings.md)|Out of box experience setting Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|displayName|String|The display name of the deployment profile. Max allowed length is 200 chars. Returned by default. Supports: $select, $top, $skip, $orderby. $Search and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|description|String|A description of the deployment profile. Max allowed length is 1500 chars. Supports: $select, $top, $skip, $orderBy. $Search and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|language|String|The language code to be used when configuring the device. E.g. en-US. The default value is os-default. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use locale instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|locale|String|The locale (language) to be used when configuring the device. E.g. en-US. The default value is os-default. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|createdDateTime|DateTimeOffset|The date and time of when the deployment profile was created. The value cannot be modified and is automatically populated when the profile was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|lastModifiedDateTime|DateTimeOffset|The date and time of when the deployment profile was last modified. The value cannot be updated manually and is automatically populated when any changes are made to the profile. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported Read-Only. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|outOfBoxExperienceSettings|[outOfBoxExperienceSettings](../resources/intune-enrollment-outofboxexperiencesettings.md)|The Windows Autopilot Deployment Profile settings used by the Autopilot device for out-of-box experience. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use outOfBoxExperienceSetting instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|outOfBoxExperienceSetting|[outOfBoxExperienceSetting](../resources/intune-enrollment-outofboxexperiencesetting.md)|The Windows Autopilot Deployment Profile settings used by the device for the out-of-box experience. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| |enrollmentStatusScreenSettings|[windowsEnrollmentStatusScreenSettings](../resources/intune-enrollment-windowsenrollmentstatusscreensettings.md)|Enrollment status screen setting Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)|-|extractHardwareHash|Boolean|HardwareHash Extraction for the profile Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|deviceNameTemplate|String|The template used to name the AutoPilot Device. This can be a custom text and can also contain either the serial number of the device, or a randomly generated number. The total length of the text generated by the template can be no more than 15 characters. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|deviceType|[windowsAutopilotDeviceType](../resources/intune-enrollment-windowsautopilotdevicetype.md)|The AutoPilot device type that this profile is applicable to. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md). Possible values are: `windowsPc`, `surfaceHub2`, `holoLens`, `surfaceHub2S`, `virtualMachine`, `unknownFutureValue`.| -|enableWhiteGlove|Boolean|Enable Autopilot White Glove for the profile. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|roleScopeTagIds|String collection|Scope tags for the profile. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|managementServiceAppId|String|AzureAD management app ID used during client device-based enrollment discovery Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|extractHardwareHash|Boolean|Indicates whether the profile supports the extraction of hardware hash values and registration of the device into Windows Autopilot. When TRUE, indicates if hardware extraction and Windows Autopilot registration will happen on the next successful check-in. When FALSE, hardware hash extraction and Windows Autopilot registration will not happen. Default value is FALSE. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use hardwareHashExtractionEnabled instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|hardwareHashExtractionEnabled|Boolean|Indicates whether the profile supports the extraction of hardware hash values and registration of the device into Windows Autopilot. When TRUE, indicates if hardware extraction and Windows Autopilot registration will happen on the next successful check-in. When FALSE, hardware hash extraction and Windows Autopilot registration will not happen. Default value is FALSE. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|deviceNameTemplate|String|The template used to name the Autopilot device. This can be a custom text and can also contain either the serial number of the device, or a randomly generated number. The total length of the text generated by the template can be no more than 15 characters. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|deviceType|[windowsAutopilotDeviceType](../resources/intune-enrollment-windowsautopilotdevicetype.md)|The Windows device type that this profile is applicable to. Possible values include windowsPc, holoLens, and virtualMachine. The default is windowsPc. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md). Possible values are: `windowsPc`, `surfaceHub2`, `holoLens`, `surfaceHub2S`, `virtualMachine`, `unknownFutureValue`.| +|enableWhiteGlove|Boolean|Indicates whether the user is allowed to use Windows Autopilot for pre-provisioned deployment mode during Out of Box experience (OOBE). When TRUE, indicates that Windows Autopilot for pre-provisioned deployment mode is allowed. When false, Windows Autopilot for pre-provisioned deployment mode is not allowed. The default is FALSE. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use preprovisioningAllowed instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|preprovisioningAllowed|Boolean|Indicates whether the user is allowed to use Windows Autopilot for pre-provisioned deployment mode during Out of Box experience (OOBE). When TRUE, indicates that Windows Autopilot for pre-provisioned deployment mode for OOBE is allowed to be used. When false, Windows Autopilot for pre-provisioned deployment mode for OOBE is not allowed. The default is FALSE. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|roleScopeTagIds|String collection|List of role scope tags for the deployment profile. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|managementServiceAppId|String|The Entra management service App ID which gets used during client device-based enrollment discovery. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| Here is an example of the request. ``` http PATCH https://graph.microsoft.com/beta/deviceManagement/windowsAutopilotDeploymentProfiles/{windowsAutopilotDeploymentProfileId} Content-type: application/json-Content-length: 1223 +Content-length: 1631 { "@odata.type": "#microsoft.graph.azureADWindowsAutopilotDeploymentProfile", "displayName": "Display Name value", "description": "Description value", "language": "Language value",+ "locale": "Locale value", "outOfBoxExperienceSettings": { "@odata.type": "microsoft.graph.outOfBoxExperienceSettings", "hidePrivacySettings": true, Content-length: 1223 "skipKeyboardSelectionPage": true, "hideEscapeLink": true },+ "outOfBoxExperienceSetting": { + "@odata.type": "microsoft.graph.outOfBoxExperienceSetting", + "privacySettingsHidden": true, + "eulaHidden": true, + "userType": "standard", + "deviceUsageType": "shared", + "keyboardSelectionPageSkipped": true, + "escapeLinkHidden": true + }, "enrollmentStatusScreenSettings": { "@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings", "hideInstallationProgress": true, Content-length: 1223 "allowDeviceUseOnInstallFailure": true }, "extractHardwareHash": true,+ "hardwareHashExtractionEnabled": true, "deviceNameTemplate": "Device Name Template value", "deviceType": "surfaceHub2", "enableWhiteGlove": true,+ "preprovisioningAllowed": true, "roleScopeTagIds": [ "Role Scope Tag Ids value" ], Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1395 +Content-Length: 1803 { "@odata.type": "#microsoft.graph.azureADWindowsAutopilotDeploymentProfile", Content-Length: 1395 "displayName": "Display Name value", "description": "Description value", "language": "Language value",+ "locale": "Locale value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", "outOfBoxExperienceSettings": { Content-Length: 1395 "skipKeyboardSelectionPage": true, "hideEscapeLink": true },+ "outOfBoxExperienceSetting": { + "@odata.type": "microsoft.graph.outOfBoxExperienceSetting", + "privacySettingsHidden": true, + "eulaHidden": true, + "userType": "standard", + "deviceUsageType": "shared", + "keyboardSelectionPageSkipped": true, + "escapeLinkHidden": true + }, "enrollmentStatusScreenSettings": { "@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings", "hideInstallationProgress": true, Content-Length: 1395 "allowDeviceUseOnInstallFailure": true }, "extractHardwareHash": true,+ "hardwareHashExtractionEnabled": true, "deviceNameTemplate": "Device Name Template value", "deviceType": "surfaceHub2", "enableWhiteGlove": true,+ "preprovisioningAllowed": true, "roleScopeTagIds": [ "Role Scope Tag Ids value" ], |
v1.0 | Intune Enrollment Depiosenrollmentprofile Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-depiosenrollmentprofile-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/depOnboardingSettings/{ Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Enrollment Depiosenrollmentprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-depiosenrollmentprofile-update.md | Content-Length: 2623 "carrierActivationUrl": "https://example.com/carrierActivationUrl/", "userlessSharedAadModeEnabled": true }-``` +``` |
v1.0 | Intune Enrollment Depmacosenrollmentprofile Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-depmacosenrollmentprofile-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/depOnboardingSettings/{ Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Enrollment Depmacosenrollmentprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-depmacosenrollmentprofile-update.md | Content-Length: 2172 "requestRequiresNetworkTether": true, "autoAdvanceSetupEnabled": true }-``` +``` |
v1.0 | Intune Enrollment Deponboardingsetting Getexpiringvpptokencount | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-deponboardingsetting-getexpiringvpptokencount.md | Content-Length: 18 { "value": 8 }-``` +``` |
v1.0 | Intune Enrollment Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-enrollment-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-enrollment-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Enrollment Devicemanagement Getsuggestedenrollmentlimit | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-devicemanagement-getsuggestedenrollmentlimit.md | Content-Length: 117 "suggestedDailyLimit": 3 } }-``` +``` |
v1.0 | Intune Enrollment Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-enrollment-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-enrollment-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-enrollment-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-enrollment-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Enrollment Windowsautopilotdeploymentprofile Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-windowsautopilotdeploymentprofile-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [windowsAutopilotDeploymentProfile](../resources/intune-enrollment-windowsautopilotdeploymentprofile.md) object. +Read properties and relationships of the [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [windowsAutopilotDeploymentProfile](../resources/intune-enrollment-windowsautopilotdeploymentprofile.md) object in the response body. +If successful, this method returns a `200 OK` response code and [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md) object in the response body. ## Example Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1475 +Content-Length: 1907 { "value": { Content-Length: 1475 "displayName": "Display Name value", "description": "Description value", "language": "Language value",+ "locale": "Locale value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", "outOfBoxExperienceSettings": { Content-Length: 1475 "skipKeyboardSelectionPage": true, "hideEscapeLink": true },+ "outOfBoxExperienceSetting": { + "@odata.type": "microsoft.graph.outOfBoxExperienceSetting", + "privacySettingsHidden": true, + "eulaHidden": true, + "userType": "standard", + "deviceUsageType": "shared", + "keyboardSelectionPageSkipped": true, + "escapeLinkHidden": true + }, "enrollmentStatusScreenSettings": { "@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings", "hideInstallationProgress": true, Content-Length: 1475 "allowDeviceUseOnInstallFailure": true }, "extractHardwareHash": true,+ "hardwareHashExtractionEnabled": true, "deviceNameTemplate": "Device Name Template value", "deviceType": "surfaceHub2", "enableWhiteGlove": true,+ "preprovisioningAllowed": true, "roleScopeTagIds": [ "Role Scope Tag Ids value" ], |
v1.0 | Intune Enrollment Windowsautopilotdeploymentprofileassignment Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-windowsautopilotdeploymentprofileassignment-create.md | Content-Length: 460 "source": "policySets", "sourceId": "Source Id value" }-``` +``` |
v1.0 | Intune Enrollment Windowsautopilotdeploymentprofileassignment Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-windowsautopilotdeploymentprofileassignment-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/windowsAutopilotDeviceI Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Enrollment Windowsautopilotdeploymentprofileassignment Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-windowsautopilotdeploymentprofileassignment-get.md | Content-Length: 497 "sourceId": "Source Id value" } }-``` +``` |
v1.0 | Intune Enrollment Windowsautopilotdeploymentprofileassignment List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-windowsautopilotdeploymentprofileassignment-list.md | Content-Length: 529 } ] }-``` +``` |
v1.0 | Intune Enrollment Windowsautopilotdeploymentprofileassignment Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-windowsautopilotdeploymentprofileassignment-update.md | Content-Length: 460 "source": "policySets", "sourceId": "Source Id value" }-``` +``` |
v1.0 | Intune Enrollment Windowsautopilotdeviceidentity Deletedevices | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-windowsautopilotdeviceidentity-deletedevices.md | Content-Length: 301 } ] }-``` +``` |
v1.0 | Intune Enrollment Windowsdomainjoinconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-windowsdomainjoinconfiguration-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [windowsDomainJoinConfiguration](../resources/intune-enrollment-windowsdomainjoinconfiguration.md) object. +Read properties and relationships of the [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [windowsDomainJoinConfiguration](../resources/intune-enrollment-windowsdomainjoinconfiguration.md) object in the response body. +If successful, this method returns a `200 OK` response code and [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object in the response body. ## Example Content-Length: 93 "@odata.type": "#microsoft.graph.windowsDomainJoinConfiguration" } }-``` +``` |
v1.0 | Intune Enrollment Windowsdomainjoinconfiguration Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-enrollment-windowsdomainjoinconfiguration-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [windowsDomainJoinConfiguration](../resources/intune-enrollment-windowsdomainjoinconfiguration.md) object. +Update the properties of a [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement/windowsAutopilotDeviceIdentities/{windowsAutopilotDevice |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [windowsDomainJoinConfiguration](../resources/intune-enrollment-windowsdomainjoinconfiguration.md) object. +In the request body, supply a JSON representation for the [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object. -The following table shows the properties that are required when you create the [windowsDomainJoinConfiguration](../resources/intune-enrollment-windowsdomainjoinconfiguration.md). +The following table shows the properties that are required when you create the [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [windowsDomainJoinConfiguration](../resources/intune-enrollment-windowsdomainjoinconfiguration.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object in the response body. ## Example Content-Length: 72 { "@odata.type": "#microsoft.graph.windowsDomainJoinConfiguration" }-``` +``` |
v1.0 | Intune Epmgraphapiservice Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-epmgraphapiservice-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-epmgraphapiservice-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-epmgraphapiservice-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Epmgraphapiservice Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-epmgraphapiservice-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-epmgraphapiservice-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-epmgraphapiservice-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-epmgraphapiservice-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-epmgraphapiservice-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Epmgraphapiservice Privilegemanagementelevationrequest Revoke | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-epmgraphapiservice-privilegemanagementelevationrequest-revoke.md | + + Title: "revoke action" +description: "Intune Epmgraphapiservice Privilegemanagementelevationrequest Revoke Api ." ++localization_priority: Normal ++++# revoke action ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. +++++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|DeviceManagementConfiguration.Read.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|DeviceManagementConfiguration.Read.All| ++## HTTP Request +<!-- { + "blockType": "ignored" +} +--> +``` http +POST /deviceManagement/elevationRequests/{privilegeManagementElevationRequestId}/revoke +``` ++## Request headers +|Header|Value| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Accept|application/json| ++## Request body +In the request body, supply JSON representation of the parameters. ++The following table shows the parameters that can be used with this action. ++|Property|Type|Description| +|:|:|:| +|reviewerJustification|String|| ++++## Response +If successful, this action returns a `200 OK` response code and a [privilegeManagementElevationRequest](../resources/intune-epmgraphapiservice-privilegemanagementelevationrequest.md) in the response body. ++## Example ++### Request +Here is an example of the request. +``` http +POST https://graph.microsoft.com/beta/deviceManagement/elevationRequests/{privilegeManagementElevationRequestId}/revoke ++Content-type: application/json +Content-length: 63 ++{ + "reviewerJustification": "Reviewer Justification value" +} +``` ++### Response +Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. +``` http +HTTP/1.1 200 OK +Content-Type: application/json +Content-Length: 1480 ++{ + "value": { + "@odata.type": "#microsoft.graph.privilegeManagementElevationRequest", + "id": "3df245af-45af-3df2-af45-f23daf45f23d", + "requestedByUserId": "Requested By User Id value", + "requestedOnDeviceId": "Requested On Device Id value", + "requestedByUserPrincipalName": "Requested By User Principal Name value", + "deviceName": "Device Name value", + "requestCreatedDateTime": "2017-01-01T00:00:35.2743776-08:00", + "requestLastModifiedDateTime": "2016-12-31T23:58:50.6194179-08:00", + "requestJustification": "Request Justification value", + "applicationDetail": { + "@odata.type": "microsoft.graph.applicationDetail", + "fileHash": "File Hash value", + "fileName": "File Name value", + "filePath": "File Path value", + "fileDescription": "File Description value", + "publisherName": "Publisher Name value", + "publisherCert": "Publisher Cert value", + "productName": "Product Name value", + "productInternalName": "Product Internal Name value", + "productVersion": "Product Version value" + }, + "status": "pending", + "reviewCompletedByUserId": "Review Completed By User Id value", + "reviewCompletedByUserPrincipalName": "Review Completed By User Principal Name value", + "reviewCompletedDateTime": "2016-12-31T23:59:07.609607-08:00", + "requestExpiryDateTime": "2017-01-01T00:02:44.7662751-08:00", + "reviewerJustification": "Reviewer Justification value" + } +} +``` |
v1.0 | Intune Esim Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-esim-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-esim-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-esim-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Esim Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-esim-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-esim-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-esim-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-esim-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-esim-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Gpanalyticsservice Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-gpanalyticsservice-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-gpanalyticsservice-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-gpanalyticsservice-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Gpanalyticsservice Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-gpanalyticsservice-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-gpanalyticsservice-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-gpanalyticsservice-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-gpanalyticsservice-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-gpanalyticsservice-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Grouppolicy Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-grouppolicy-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-grouppolicy-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Grouppolicy Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-grouppolicy-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-grouppolicy-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-grouppolicy-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-grouppolicy-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Grouppolicy Grouppolicyoperation Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicyoperation-create.md | Content-Length: 285 "id": "4d18865b-865b-4d18-5b86-184d5b86184d", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicyoperation Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicyoperation-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/groupPolicyConfiguratio Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicyoperation Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicyoperation-get.md | Content-Length: 316 "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00" } }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicyoperation List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicyoperation-list.md | Content-Length: 342 } ] }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicyoperation Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicyoperation-update.md | Content-Length: 285 "id": "4d18865b-865b-4d18-5b86-184d5b86184d", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentation Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentation-update.md | Content-Length: 205 "id": "a33caa6a-aa6a-a33c-6aaa-3ca36aaa3ca3", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationcheckbox Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationcheckbox-create.md | Content-Length: 240 "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", "defaultChecked": true }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationcheckbox Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationcheckbox-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/groupPolicyConfiguratio Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationcheckbox List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationcheckbox-list.md | Content-Length: 293 } ] }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationcheckbox Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationcheckbox-update.md | Content-Length: 240 "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", "defaultChecked": true }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationcombobox Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationcombobox-create.md | Content-Length: 346 "required": true, "maxLength": 9 }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationcombobox Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationcombobox-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/groupPolicyConfiguratio Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationcombobox List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationcombobox-list.md | Content-Length: 419 } ] }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationcombobox Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationcombobox-update.md | Content-Length: 346 "required": true, "maxLength": 9 }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationdecimaltextbox Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationdecimaltextbox-create.md | Content-Length: 334 "minValue": 8, "maxValue": 8 }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationdecimaltextbox Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationdecimaltextbox-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/groupPolicyConfiguratio Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationdecimaltextbox List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationdecimaltextbox-list.md | Content-Length: 407 } ] }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationdecimaltextbox Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationdecimaltextbox-update.md | Content-Length: 334 "minValue": 8, "maxValue": 8 }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationdropdownlist Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationdropdownlist-create.md | Content-Length: 602 ], "required": true }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationdropdownlist Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationdropdownlist-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/groupPolicyConfiguratio Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationdropdownlist List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationdropdownlist-list.md | Content-Length: 703 } ] }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationdropdownlist Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationdropdownlist-update.md | Content-Length: 602 ], "required": true }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationlistbox Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationlistbox-create.md | Content-Length: 278 "explicitValue": true, "valuePrefix": "Value Prefix value" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationlistbox Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationlistbox-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/groupPolicyConfiguratio Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationlistbox List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationlistbox-list.md | Content-Length: 335 } ] }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationlistbox Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationlistbox-update.md | Content-Length: 278 "explicitValue": true, "valuePrefix": "Value Prefix value" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationlongdecimaltextbox Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationlongdecimaltextbox-create.md | Content-Length: 338 "minValue": 8, "maxValue": 8 }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationlongdecimaltextbox Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationlongdecimaltextbox-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/groupPolicyConfiguratio Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationlongdecimaltextbox List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationlongdecimaltextbox-list.md | Content-Length: 411 } ] }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationlongdecimaltextbox Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationlongdecimaltextbox-update.md | Content-Length: 338 "minValue": 8, "maxValue": 8 }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationmultitextbox Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationmultitextbox-create.md | Content-Length: 278 "maxLength": 9, "maxStrings": 10 }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationmultitextbox Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationmultitextbox-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/groupPolicyConfiguratio Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationmultitextbox List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationmultitextbox-list.md | Content-Length: 339 } ] }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationmultitextbox Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationmultitextbox-update.md | Content-Length: 278 "maxLength": 9, "maxStrings": 10 }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationtext Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationtext-create.md | Content-Length: 209 "id": "bc77d545-d545-bc77-45d5-77bc45d577bc", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationtext Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationtext-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/groupPolicyConfiguratio Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationtext List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationtext-list.md | Content-Length: 258 } ] }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationtext Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationtext-update.md | Content-Length: 209 "id": "bc77d545-d545-bc77-45d5-77bc45d577bc", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationtextbox Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationtextbox-create.md | Content-Length: 294 "required": true, "maxLength": 9 }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationtextbox Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationtextbox-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/groupPolicyConfiguratio Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationtextbox List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationtextbox-list.md | Content-Length: 355 } ] }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationtextbox Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicypresentationtextbox-update.md | Content-Length: 294 "required": true, "maxLength": 9 }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicyuploadedpresentation Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicyuploadedpresentation-create.md | Content-Length: 213 "id": "6480cc5a-cc5a-6480-5acc-80645acc8064", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicyuploadedpresentation Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicyuploadedpresentation-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/groupPolicyConfiguratio Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicyuploadedpresentation List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicyuploadedpresentation-list.md | Content-Length: 262 } ] }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicyuploadedpresentation Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-grouppolicyuploadedpresentation-update.md | Content-Length: 213 "id": "6480cc5a-cc5a-6480-5acc-80645acc8064", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00" }-``` +``` |
v1.0 | Intune Mam Androidmanagedappprotection Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-androidmanagedappprotection-create.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Create a new [androidManagedAppProtection](../resources/intune-mam-androidmanagedappprotection.md) object. +Create a new [androidManagedAppProtection](../resources/intune-shared-androidmanagedappprotection.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] The following table shows the properties that are required when you create the a ## Response-If successful, this method returns a `201 Created` response code and a [androidManagedAppProtection](../resources/intune-mam-androidmanagedappprotection.md) object in the response body. +If successful, this method returns a `201 Created` response code and a [androidManagedAppProtection](../resources/intune-shared-androidmanagedappprotection.md) object in the response body. ## Example |
v1.0 | Intune Mam Androidmanagedappprotection Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-androidmanagedappprotection-delete.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Deletes a [androidManagedAppProtection](../resources/intune-mam-androidmanagedappprotection.md). +Deletes a [androidManagedAppProtection](../resources/intune-shared-androidmanagedappprotection.md). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] |
v1.0 | Intune Mam Androidmanagedappprotection Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-androidmanagedappprotection-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [androidManagedAppProtection](../resources/intune-mam-androidmanagedappprotection.md) object. +Read properties and relationships of the [androidManagedAppProtection](../resources/intune-shared-androidmanagedappprotection.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [androidManagedAppProtection](../resources/intune-mam-androidmanagedappprotection.md) object in the response body. +If successful, this method returns a `200 OK` response code and [androidManagedAppProtection](../resources/intune-shared-androidmanagedappprotection.md) object in the response body. ## Example |
v1.0 | Intune Mam Androidmanagedappprotection List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-androidmanagedappprotection-list.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -List properties and relationships of the [androidManagedAppProtection](../resources/intune-mam-androidmanagedappprotection.md) objects. +List properties and relationships of the [androidManagedAppProtection](../resources/intune-shared-androidmanagedappprotection.md) objects. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] GET /deviceAppManagement/androidManagedAppProtections Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and a collection of [androidManagedAppProtection](../resources/intune-mam-androidmanagedappprotection.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [androidManagedAppProtection](../resources/intune-shared-androidmanagedappprotection.md) objects in the response body. ## Example |
v1.0 | Intune Mam Androidmanagedappprotection Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-androidmanagedappprotection-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [androidManagedAppProtection](../resources/intune-mam-androidmanagedappprotection.md) object. +Update the properties of a [androidManagedAppProtection](../resources/intune-shared-androidmanagedappprotection.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceAppManagement/androidManagedAppProtections/{androidManagedAppProtec |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [androidManagedAppProtection](../resources/intune-mam-androidmanagedappprotection.md) object. +In the request body, supply a JSON representation for the [androidManagedAppProtection](../resources/intune-shared-androidmanagedappprotection.md) object. -The following table shows the properties that are required when you create the [androidManagedAppProtection](../resources/intune-mam-androidmanagedappprotection.md). +The following table shows the properties that are required when you create the [androidManagedAppProtection](../resources/intune-shared-androidmanagedappprotection.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [androidManagedAppProtection](../resources/intune-mam-androidmanagedappprotection.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [androidManagedAppProtection](../resources/intune-shared-androidmanagedappprotection.md) object in the response body. ## Example |
v1.0 | Intune Mam Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-mam-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-mam-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Mam Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-mam-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-mam-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-mam-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-mam-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Mam Devicemanagementconfigurationchoicesettingcollectiondefinition Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationchoicesettingcollectiondefinition-create.md | Content-Length: 19168 "maximumCount": 12, "minimumCount": 12 }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationchoicesettingcollectiondefinition Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationchoicesettingcollectiondefinition-delete.md | DELETE https://graph.microsoft.com/beta/deviceAppManagement/targetedManagedAppCo Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationchoicesettingcollectiondefinition Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationchoicesettingcollectiondefinition-update.md | Content-Length: 19168 "maximumCount": 12, "minimumCount": 12 }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationchoicesettingdefinition Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationchoicesettingdefinition-create.md | Content-Length: 19112 ], "defaultOptionId": "Default Option Id value" }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationchoicesettingdefinition Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationchoicesettingdefinition-delete.md | DELETE https://graph.microsoft.com/beta/deviceAppManagement/targetedManagedAppCo Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationchoicesettingdefinition Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationchoicesettingdefinition-update.md | Content-Length: 19112 ], "defaultOptionId": "Default Option Id value" }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationredirectsettingdefinition Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationredirectsettingdefinition-create.md | Content-Length: 1445 "redirectMessage": "Redirect Message value", "redirectReason": "Redirect Reason value" }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationredirectsettingdefinition Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationredirectsettingdefinition-delete.md | DELETE https://graph.microsoft.com/beta/deviceAppManagement/targetedManagedAppCo Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationredirectsettingdefinition Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationredirectsettingdefinition-update.md | Content-Length: 1445 "redirectMessage": "Redirect Message value", "redirectReason": "Redirect Reason value" }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationsettingdefinition Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationsettingdefinition-create.md | Content-Length: 1309 "displayName": "Display Name value", "version": "Version value" }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationsettingdefinition Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationsettingdefinition-delete.md | DELETE https://graph.microsoft.com/beta/deviceAppManagement/targetedManagedAppCo Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationsettingdefinition Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationsettingdefinition-update.md | Content-Length: 1309 "displayName": "Display Name value", "version": "Version value" }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationsettinggroupcollectiondefinition Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationsettinggroupcollectiondefinition-create.md | Content-Length: 1836 "maximumCount": 12, "minimumCount": 12 }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationsettinggroupcollectiondefinition Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationsettinggroupcollectiondefinition-delete.md | DELETE https://graph.microsoft.com/beta/deviceAppManagement/targetedManagedAppCo Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationsettinggroupcollectiondefinition Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationsettinggroupcollectiondefinition-update.md | Content-Length: 1836 "maximumCount": 12, "minimumCount": 12 }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationsettinggroupdefinition Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationsettinggroupdefinition-create.md | Content-Length: 1780 } ] }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationsettinggroupdefinition Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationsettinggroupdefinition-delete.md | DELETE https://graph.microsoft.com/beta/deviceAppManagement/targetedManagedAppCo Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationsettinggroupdefinition Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationsettinggroupdefinition-update.md | Content-Length: 1780 } ] }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationsimplesettingcollectiondefinition Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationsimplesettingcollectiondefinition-create.md | Content-Length: 18018 "maximumCount": 12, "minimumCount": 12 }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationsimplesettingcollectiondefinition Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationsimplesettingcollectiondefinition-delete.md | DELETE https://graph.microsoft.com/beta/deviceAppManagement/targetedManagedAppCo Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationsimplesettingcollectiondefinition Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationsimplesettingcollectiondefinition-update.md | Content-Length: 18018 "maximumCount": 12, "minimumCount": 12 }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationsimplesettingdefinition Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationsimplesettingdefinition-create.md | Content-Length: 17962 } ] }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationsimplesettingdefinition Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationsimplesettingdefinition-delete.md | DELETE https://graph.microsoft.com/beta/deviceAppManagement/targetedManagedAppCo Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationsimplesettingdefinition Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-devicemanagementconfigurationsimplesettingdefinition-update.md | Content-Length: 17962 } ] }-``` +``` |
v1.0 | Intune Mam Iosmanagedappprotection Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-iosmanagedappprotection-create.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Create a new [iosManagedAppProtection](../resources/intune-mam-iosmanagedappprotection.md) object. +Create a new [iosManagedAppProtection](../resources/intune-shared-iosmanagedappprotection.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] The following table shows the properties that are required when you create the i |minimumWipeSdkVersion|String|Versions less than the specified version will block the managed app from accessing company data.| |allowedIosDeviceModels|String|Semicolon seperated list of device models allowed, as a string, for the managed app to work.| |appActionIfIosDeviceModelNotAllowed|[managedAppRemediationAction](../resources/intune-mam-managedappremediationaction.md)|Defines a managed app behavior, either block or wipe, if the specified device model is not allowed. Possible values are: `block`, `wipe`, `warn`.|+|appActionIfAccountIsClockedOut|[managedAppRemediationAction](../resources/intune-mam-managedappremediationaction.md)|Defines a managed app behavior, either block or warn, if the user is clocked out (non-working time). Possible values are: `block`, `wipe`, `warn`.| |thirdPartyKeyboardsBlocked|Boolean|Defines if third party keyboards are allowed while accessing a managed app| |filterOpenInToOnlyManagedApps|Boolean|Defines if open-in operation is supported from the managed app to the filesharing locations selected. This setting only applies when AllowedOutboundDataTransferDestinations is set to ManagedApps and DisableProtectionOfManagedOutboundOpenInData is set to False.| |disableProtectionOfManagedOutboundOpenInData|Boolean|Disable protection of data transferred to other apps through IOS OpenIn option. This setting is only allowed to be True when AllowedOutboundDataTransferDestinations is set to ManagedApps.| The following table shows the properties that are required when you create the i ## Response-If successful, this method returns a `201 Created` response code and a [iosManagedAppProtection](../resources/intune-mam-iosmanagedappprotection.md) object in the response body. +If successful, this method returns a `201 Created` response code and a [iosManagedAppProtection](../resources/intune-shared-iosmanagedappprotection.md) object in the response body. ## Example Here is an example of the request. ``` http POST https://graph.microsoft.com/beta/deviceAppManagement/iosManagedAppProtections Content-type: application/json-Content-length: 3838 +Content-length: 3883 { "@odata.type": "#microsoft.graph.iosManagedAppProtection", Content-length: 3838 "minimumWipeSdkVersion": "Minimum Wipe Sdk Version value", "allowedIosDeviceModels": "Allowed Ios Device Models value", "appActionIfIosDeviceModelNotAllowed": "wipe",+ "appActionIfAccountIsClockedOut": "wipe", "thirdPartyKeyboardsBlocked": true, "filterOpenInToOnlyManagedApps": true, "disableProtectionOfManagedOutboundOpenInData": true, Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 201 Created Content-Type: application/json-Content-Length: 4010 +Content-Length: 4055 { "@odata.type": "#microsoft.graph.iosManagedAppProtection", Content-Length: 4010 "minimumWipeSdkVersion": "Minimum Wipe Sdk Version value", "allowedIosDeviceModels": "Allowed Ios Device Models value", "appActionIfIosDeviceModelNotAllowed": "wipe",+ "appActionIfAccountIsClockedOut": "wipe", "thirdPartyKeyboardsBlocked": true, "filterOpenInToOnlyManagedApps": true, "disableProtectionOfManagedOutboundOpenInData": true, |
v1.0 | Intune Mam Iosmanagedappprotection Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-iosmanagedappprotection-delete.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Deletes a [iosManagedAppProtection](../resources/intune-mam-iosmanagedappprotection.md). +Deletes a [iosManagedAppProtection](../resources/intune-shared-iosmanagedappprotection.md). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] |
v1.0 | Intune Mam Iosmanagedappprotection Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-iosmanagedappprotection-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [iosManagedAppProtection](../resources/intune-mam-iosmanagedappprotection.md) object. +Read properties and relationships of the [iosManagedAppProtection](../resources/intune-shared-iosmanagedappprotection.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [iosManagedAppProtection](../resources/intune-mam-iosmanagedappprotection.md) object in the response body. +If successful, this method returns a `200 OK` response code and [iosManagedAppProtection](../resources/intune-shared-iosmanagedappprotection.md) object in the response body. ## Example Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 4213 +Content-Length: 4260 { "value": { Content-Length: 4213 "minimumWipeSdkVersion": "Minimum Wipe Sdk Version value", "allowedIosDeviceModels": "Allowed Ios Device Models value", "appActionIfIosDeviceModelNotAllowed": "wipe",+ "appActionIfAccountIsClockedOut": "wipe", "thirdPartyKeyboardsBlocked": true, "filterOpenInToOnlyManagedApps": true, "disableProtectionOfManagedOutboundOpenInData": true, |
v1.0 | Intune Mam Iosmanagedappprotection List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-iosmanagedappprotection-list.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -List properties and relationships of the [iosManagedAppProtection](../resources/intune-mam-iosmanagedappprotection.md) objects. +List properties and relationships of the [iosManagedAppProtection](../resources/intune-shared-iosmanagedappprotection.md) objects. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] GET /deviceAppManagement/iosManagedAppProtections Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and a collection of [iosManagedAppProtection](../resources/intune-mam-iosmanagedappprotection.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [iosManagedAppProtection](../resources/intune-shared-iosmanagedappprotection.md) objects in the response body. ## Example Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 4411 +Content-Length: 4460 { "value": [ Content-Length: 4411 "minimumWipeSdkVersion": "Minimum Wipe Sdk Version value", "allowedIosDeviceModels": "Allowed Ios Device Models value", "appActionIfIosDeviceModelNotAllowed": "wipe",+ "appActionIfAccountIsClockedOut": "wipe", "thirdPartyKeyboardsBlocked": true, "filterOpenInToOnlyManagedApps": true, "disableProtectionOfManagedOutboundOpenInData": true, |
v1.0 | Intune Mam Iosmanagedappprotection Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-iosmanagedappprotection-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [iosManagedAppProtection](../resources/intune-mam-iosmanagedappprotection.md) object. +Update the properties of a [iosManagedAppProtection](../resources/intune-shared-iosmanagedappprotection.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceAppManagement/iosManagedAppProtections/{iosManagedAppProtectionId} |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [iosManagedAppProtection](../resources/intune-mam-iosmanagedappprotection.md) object. +In the request body, supply a JSON representation for the [iosManagedAppProtection](../resources/intune-shared-iosmanagedappprotection.md) object. -The following table shows the properties that are required when you create the [iosManagedAppProtection](../resources/intune-mam-iosmanagedappprotection.md). +The following table shows the properties that are required when you create the [iosManagedAppProtection](../resources/intune-shared-iosmanagedappprotection.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ |minimumWipeSdkVersion|String|Versions less than the specified version will block the managed app from accessing company data.| |allowedIosDeviceModels|String|Semicolon seperated list of device models allowed, as a string, for the managed app to work.| |appActionIfIosDeviceModelNotAllowed|[managedAppRemediationAction](../resources/intune-mam-managedappremediationaction.md)|Defines a managed app behavior, either block or wipe, if the specified device model is not allowed. Possible values are: `block`, `wipe`, `warn`.|+|appActionIfAccountIsClockedOut|[managedAppRemediationAction](../resources/intune-mam-managedappremediationaction.md)|Defines a managed app behavior, either block or warn, if the user is clocked out (non-working time). Possible values are: `block`, `wipe`, `warn`.| |thirdPartyKeyboardsBlocked|Boolean|Defines if third party keyboards are allowed while accessing a managed app| |filterOpenInToOnlyManagedApps|Boolean|Defines if open-in operation is supported from the managed app to the filesharing locations selected. This setting only applies when AllowedOutboundDataTransferDestinations is set to ManagedApps and DisableProtectionOfManagedOutboundOpenInData is set to False.| |disableProtectionOfManagedOutboundOpenInData|Boolean|Disable protection of data transferred to other apps through IOS OpenIn option. This setting is only allowed to be True when AllowedOutboundDataTransferDestinations is set to ManagedApps.| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [iosManagedAppProtection](../resources/intune-mam-iosmanagedappprotection.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [iosManagedAppProtection](../resources/intune-shared-iosmanagedappprotection.md) object in the response body. ## Example Here is an example of the request. ``` http PATCH https://graph.microsoft.com/beta/deviceAppManagement/iosManagedAppProtections/{iosManagedAppProtectionId} Content-type: application/json-Content-length: 3838 +Content-length: 3883 { "@odata.type": "#microsoft.graph.iosManagedAppProtection", Content-length: 3838 "minimumWipeSdkVersion": "Minimum Wipe Sdk Version value", "allowedIosDeviceModels": "Allowed Ios Device Models value", "appActionIfIosDeviceModelNotAllowed": "wipe",+ "appActionIfAccountIsClockedOut": "wipe", "thirdPartyKeyboardsBlocked": true, "filterOpenInToOnlyManagedApps": true, "disableProtectionOfManagedOutboundOpenInData": true, Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 4010 +Content-Length: 4055 { "@odata.type": "#microsoft.graph.iosManagedAppProtection", Content-Length: 4010 "minimumWipeSdkVersion": "Minimum Wipe Sdk Version value", "allowedIosDeviceModels": "Allowed Ios Device Models value", "appActionIfIosDeviceModelNotAllowed": "wipe",+ "appActionIfAccountIsClockedOut": "wipe", "thirdPartyKeyboardsBlocked": true, "filterOpenInToOnlyManagedApps": true, "disableProtectionOfManagedOutboundOpenInData": true, |
v1.0 | Intune Mam Managedapplogcollectionrequest Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-managedapplogcollectionrequest-create.md | The following table shows the properties that are required when you create the m |Property|Type|Description| |:|:|:| |id|String|The unique identifier of the managed app log collection request. This id is assigned during request creation time. Read-only.|-|managedAppRegistrationId|String|The unique identifier of the app instance for which diagnostic was collected.| +|managedAppRegistrationId|String|The unique identifier of the app instance for which diagnostic logs were collected. Read-only.| |status|String|Indicates the status for the app log collection request - pending, completed or failed. Default is pending.|-|requestedBy|String|The user principal name associated with the request for the managed application log collection.| +|requestedBy|String|The user principal name associated with the request for the managed application log collection. Read-only.| +|requestedByUserPrincipalName|String|The user principal name associated with the request for the managed application log collection. Read-only.| |requestedDateTime|DateTimeOffset|DateTime of when the log upload request was received. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Returned by default. Read-only.| |completedDateTime|DateTimeOffset|DateTime of when the log upload request was completed. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Returned by default. Read-only.|-|userLogUploadConsent|[managedAppLogUploadConsent](../resources/intune-mam-managedapploguploadconsent.md)|Indicates whether the user associated with the device provided consent for the log collection. Possible values are: `default`, `declined`, `accepted`, `unknownFutureValue`.| -|uploadedLogs|[managedAppLogUpload](../resources/intune-mam-managedapplogupload.md) collection|The collection of log upload results as reported by each component on the device. Such components can be the application itself, the Mobile Application Management (MAM) SDK, and other on-device components that are requested to upload diagnostic logs.| +|userLogUploadConsent|[managedAppLogUploadConsent](../resources/intune-mam-managedapploguploadconsent.md)|Indicates whether the user associated with the device provided consent for the log collection. The user must consent before the diagnostic logs can be collected. accepted means the user consented. declined means the user declined. unknown is the default value. The Log Collection Request must be completed within 24 hours or it will be abandoned and deleted. Read-only. Possible values are: `unknown`, `declined`, `accepted`, `unknownFutureValue`.| +|uploadedLogs|[managedAppLogUpload](../resources/intune-mam-managedapplogupload.md) collection|The collection of log upload results as reported by each component on the device. Such components can be the application itself, the Mobile Application Management (MAM) SDK, and other on-device components that are requested to upload diagnostic logs. Read-only.| |version|String|Version of the entity.| Here is an example of the request. ``` http POST https://graph.microsoft.com/beta/deviceAppManagement/managedAppRegistrations/{managedAppRegistrationId}/managedAppLogCollectionRequests Content-type: application/json-Content-length: 646 +Content-length: 799 { "@odata.type": "#microsoft.graph.managedAppLogCollectionRequest", "managedAppRegistrationId": "Managed App Registration Id value", "status": "Status value", "requestedBy": "Requested By value",+ "requestedByUserPrincipalName": "Requested By User Principal Name value", "requestedDateTime": "2017-01-01T00:01:49.2071853-08:00", "completedDateTime": "2016-12-31T23:58:52.3534526-08:00", "userLogUploadConsent": "declined", Content-length: 646 { "@odata.type": "microsoft.graph.managedAppLogUpload", "managedAppComponent": "Managed App Component value",- "status": "partiallyCompleted", + "managedAppComponentDescription": "Managed App Component Description value", + "status": "inProgress", "referenceId": "Reference Id value" } ], Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 201 Created Content-Type: application/json-Content-Length: 695 +Content-Length: 848 { "@odata.type": "#microsoft.graph.managedAppLogCollectionRequest", Content-Length: 695 "managedAppRegistrationId": "Managed App Registration Id value", "status": "Status value", "requestedBy": "Requested By value",+ "requestedByUserPrincipalName": "Requested By User Principal Name value", "requestedDateTime": "2017-01-01T00:01:49.2071853-08:00", "completedDateTime": "2016-12-31T23:58:52.3534526-08:00", "userLogUploadConsent": "declined", Content-Length: 695 { "@odata.type": "microsoft.graph.managedAppLogUpload", "managedAppComponent": "Managed App Component value",- "status": "partiallyCompleted", + "managedAppComponentDescription": "Managed App Component Description value", + "status": "inProgress", "referenceId": "Reference Id value" } ], |
v1.0 | Intune Mam Managedapplogcollectionrequest Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-managedapplogcollectionrequest-get.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 748 +Content-Length: 905 { "value": { Content-Length: 748 "managedAppRegistrationId": "Managed App Registration Id value", "status": "Status value", "requestedBy": "Requested By value",+ "requestedByUserPrincipalName": "Requested By User Principal Name value", "requestedDateTime": "2017-01-01T00:01:49.2071853-08:00", "completedDateTime": "2016-12-31T23:58:52.3534526-08:00", "userLogUploadConsent": "declined", Content-Length: 748 { "@odata.type": "microsoft.graph.managedAppLogUpload", "managedAppComponent": "Managed App Component value",- "status": "partiallyCompleted", + "managedAppComponentDescription": "Managed App Component Description value", + "status": "inProgress", "referenceId": "Reference Id value" } ], |
v1.0 | Intune Mam Managedapplogcollectionrequest List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-managedapplogcollectionrequest-list.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 796 +Content-Length: 957 { "value": [ Content-Length: 796 "managedAppRegistrationId": "Managed App Registration Id value", "status": "Status value", "requestedBy": "Requested By value",+ "requestedByUserPrincipalName": "Requested By User Principal Name value", "requestedDateTime": "2017-01-01T00:01:49.2071853-08:00", "completedDateTime": "2016-12-31T23:58:52.3534526-08:00", "userLogUploadConsent": "declined", Content-Length: 796 { "@odata.type": "microsoft.graph.managedAppLogUpload", "managedAppComponent": "Managed App Component value",- "status": "partiallyCompleted", + "managedAppComponentDescription": "Managed App Component Description value", + "status": "inProgress", "referenceId": "Reference Id value" } ], |
v1.0 | Intune Mam Managedapplogcollectionrequest Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-managedapplogcollectionrequest-update.md | The following table shows the properties that are required when you create the [ |Property|Type|Description| |:|:|:| |id|String|The unique identifier of the managed app log collection request. This id is assigned during request creation time. Read-only.|-|managedAppRegistrationId|String|The unique identifier of the app instance for which diagnostic was collected.| +|managedAppRegistrationId|String|The unique identifier of the app instance for which diagnostic logs were collected. Read-only.| |status|String|Indicates the status for the app log collection request - pending, completed or failed. Default is pending.|-|requestedBy|String|The user principal name associated with the request for the managed application log collection.| +|requestedBy|String|The user principal name associated with the request for the managed application log collection. Read-only.| +|requestedByUserPrincipalName|String|The user principal name associated with the request for the managed application log collection. Read-only.| |requestedDateTime|DateTimeOffset|DateTime of when the log upload request was received. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Returned by default. Read-only.| |completedDateTime|DateTimeOffset|DateTime of when the log upload request was completed. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Returned by default. Read-only.|-|userLogUploadConsent|[managedAppLogUploadConsent](../resources/intune-mam-managedapploguploadconsent.md)|Indicates whether the user associated with the device provided consent for the log collection. Possible values are: `default`, `declined`, `accepted`, `unknownFutureValue`.| -|uploadedLogs|[managedAppLogUpload](../resources/intune-mam-managedapplogupload.md) collection|The collection of log upload results as reported by each component on the device. Such components can be the application itself, the Mobile Application Management (MAM) SDK, and other on-device components that are requested to upload diagnostic logs.| +|userLogUploadConsent|[managedAppLogUploadConsent](../resources/intune-mam-managedapploguploadconsent.md)|Indicates whether the user associated with the device provided consent for the log collection. The user must consent before the diagnostic logs can be collected. accepted means the user consented. declined means the user declined. unknown is the default value. The Log Collection Request must be completed within 24 hours or it will be abandoned and deleted. Read-only. Possible values are: `unknown`, `declined`, `accepted`, `unknownFutureValue`.| +|uploadedLogs|[managedAppLogUpload](../resources/intune-mam-managedapplogupload.md) collection|The collection of log upload results as reported by each component on the device. Such components can be the application itself, the Mobile Application Management (MAM) SDK, and other on-device components that are requested to upload diagnostic logs. Read-only.| |version|String|Version of the entity.| Here is an example of the request. ``` http PATCH https://graph.microsoft.com/beta/deviceAppManagement/managedAppRegistrations/{managedAppRegistrationId}/managedAppLogCollectionRequests/{managedAppLogCollectionRequestId} Content-type: application/json-Content-length: 646 +Content-length: 799 { "@odata.type": "#microsoft.graph.managedAppLogCollectionRequest", "managedAppRegistrationId": "Managed App Registration Id value", "status": "Status value", "requestedBy": "Requested By value",+ "requestedByUserPrincipalName": "Requested By User Principal Name value", "requestedDateTime": "2017-01-01T00:01:49.2071853-08:00", "completedDateTime": "2016-12-31T23:58:52.3534526-08:00", "userLogUploadConsent": "declined", Content-length: 646 { "@odata.type": "microsoft.graph.managedAppLogUpload", "managedAppComponent": "Managed App Component value",- "status": "partiallyCompleted", + "managedAppComponentDescription": "Managed App Component Description value", + "status": "inProgress", "referenceId": "Reference Id value" } ], Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 695 +Content-Length: 848 { "@odata.type": "#microsoft.graph.managedAppLogCollectionRequest", Content-Length: 695 "managedAppRegistrationId": "Managed App Registration Id value", "status": "Status value", "requestedBy": "Requested By value",+ "requestedByUserPrincipalName": "Requested By User Principal Name value", "requestedDateTime": "2017-01-01T00:01:49.2071853-08:00", "completedDateTime": "2016-12-31T23:58:52.3534526-08:00", "userLogUploadConsent": "declined", Content-Length: 695 { "@odata.type": "microsoft.graph.managedAppLogUpload", "managedAppComponent": "Managed App Component value",- "status": "partiallyCompleted", + "managedAppComponentDescription": "Managed App Component Description value", + "status": "inProgress", "referenceId": "Reference Id value" } ], |
v1.0 | Intune Mam Managedapppolicydeploymentsummary Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-managedapppolicydeploymentsummary-get.md | One of the following permissions is required to call this API. To learn more, in ``` http GET /deviceAppManagement/iosManagedAppProtections/{iosManagedAppProtectionId}/deploymentSummary GET /deviceAppManagement/androidManagedAppProtections/{androidManagedAppProtectionId}/deploymentSummary+GET /deviceAppManagement/windowsManagedAppProtections/{windowsManagedAppProtectionId}/deploymentSummary GET /deviceAppManagement/defaultManagedAppProtections/{defaultManagedAppProtectionId}/deploymentSummary GET /deviceAppManagement/targetedManagedAppConfigurations/{targetedManagedAppConfigurationId}/deploymentSummary ``` |
v1.0 | Intune Mam Managedapppolicydeploymentsummary Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-managedapppolicydeploymentsummary-update.md | One of the following permissions is required to call this API. To learn more, in ``` http PATCH /deviceAppManagement/iosManagedAppProtections/{iosManagedAppProtectionId}/deploymentSummary PATCH /deviceAppManagement/androidManagedAppProtections/{androidManagedAppProtectionId}/deploymentSummary+PATCH /deviceAppManagement/windowsManagedAppProtections/{windowsManagedAppProtectionId}/deploymentSummary PATCH /deviceAppManagement/defaultManagedAppProtections/{defaultManagedAppProtectionId}/deploymentSummary PATCH /deviceAppManagement/targetedManagedAppConfigurations/{targetedManagedAppConfigurationId}/deploymentSummary ``` |
v1.0 | Intune Mam Mdmwindowsinformationprotectionpolicy Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-mdmwindowsinformationprotectionpolicy-create.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Create a new [mdmWindowsInformationProtectionPolicy](../resources/intune-mam-mdmwindowsinformationprotectionpolicy.md) object. +Create a new [mdmWindowsInformationProtectionPolicy](../resources/intune-shared-mdmwindowsinformationprotectionpolicy.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] The following table shows the properties that are required when you create the m ## Response-If successful, this method returns a `201 Created` response code and a [mdmWindowsInformationProtectionPolicy](../resources/intune-mam-mdmwindowsinformationprotectionpolicy.md) object in the response body. +If successful, this method returns a `201 Created` response code and a [mdmWindowsInformationProtectionPolicy](../resources/intune-shared-mdmwindowsinformationprotectionpolicy.md) object in the response body. ## Example |
v1.0 | Intune Mam Mdmwindowsinformationprotectionpolicy Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-mdmwindowsinformationprotectionpolicy-delete.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Deletes a [mdmWindowsInformationProtectionPolicy](../resources/intune-mam-mdmwindowsinformationprotectionpolicy.md). +Deletes a [mdmWindowsInformationProtectionPolicy](../resources/intune-shared-mdmwindowsinformationprotectionpolicy.md). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] |
v1.0 | Intune Mam Mdmwindowsinformationprotectionpolicy Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-mdmwindowsinformationprotectionpolicy-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [mdmWindowsInformationProtectionPolicy](../resources/intune-mam-mdmwindowsinformationprotectionpolicy.md) object. +Read properties and relationships of the [mdmWindowsInformationProtectionPolicy](../resources/intune-shared-mdmwindowsinformationprotectionpolicy.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [mdmWindowsInformationProtectionPolicy](../resources/intune-mam-mdmwindowsinformationprotectionpolicy.md) object in the response body. +If successful, this method returns a `200 OK` response code and [mdmWindowsInformationProtectionPolicy](../resources/intune-shared-mdmwindowsinformationprotectionpolicy.md) object in the response body. ## Example |
v1.0 | Intune Mam Mdmwindowsinformationprotectionpolicy List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-mdmwindowsinformationprotectionpolicy-list.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -List properties and relationships of the [mdmWindowsInformationProtectionPolicy](../resources/intune-mam-mdmwindowsinformationprotectionpolicy.md) objects. +List properties and relationships of the [mdmWindowsInformationProtectionPolicy](../resources/intune-shared-mdmwindowsinformationprotectionpolicy.md) objects. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] GET /deviceAppManagement/mdmWindowsInformationProtectionPolicies Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and a collection of [mdmWindowsInformationProtectionPolicy](../resources/intune-mam-mdmwindowsinformationprotectionpolicy.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [mdmWindowsInformationProtectionPolicy](../resources/intune-shared-mdmwindowsinformationprotectionpolicy.md) objects in the response body. ## Example |
v1.0 | Intune Mam Mdmwindowsinformationprotectionpolicy Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-mdmwindowsinformationprotectionpolicy-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [mdmWindowsInformationProtectionPolicy](../resources/intune-mam-mdmwindowsinformationprotectionpolicy.md) object. +Update the properties of a [mdmWindowsInformationProtectionPolicy](../resources/intune-shared-mdmwindowsinformationprotectionpolicy.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceAppManagement/mdmWindowsInformationProtectionPolicies/{mdmWindowsIn |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [mdmWindowsInformationProtectionPolicy](../resources/intune-mam-mdmwindowsinformationprotectionpolicy.md) object. +In the request body, supply a JSON representation for the [mdmWindowsInformationProtectionPolicy](../resources/intune-shared-mdmwindowsinformationprotectionpolicy.md) object. -The following table shows the properties that are required when you create the [mdmWindowsInformationProtectionPolicy](../resources/intune-mam-mdmwindowsinformationprotectionpolicy.md). +The following table shows the properties that are required when you create the [mdmWindowsInformationProtectionPolicy](../resources/intune-shared-mdmwindowsinformationprotectionpolicy.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [mdmWindowsInformationProtectionPolicy](../resources/intune-mam-mdmwindowsinformationprotectionpolicy.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [mdmWindowsInformationProtectionPolicy](../resources/intune-shared-mdmwindowsinformationprotectionpolicy.md) object in the response body. ## Example |
v1.0 | Intune Mam Targetedmanagedappconfiguration Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-targetedmanagedappconfiguration-create.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Create a new [targetedManagedAppConfiguration](../resources/intune-mam-targetedmanagedappconfiguration.md) object. +Create a new [targetedManagedAppConfiguration](../resources/intune-shared-targetedmanagedappconfiguration.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] The following table shows the properties that are required when you create the t ## Response-If successful, this method returns a `201 Created` response code and a [targetedManagedAppConfiguration](../resources/intune-mam-targetedmanagedappconfiguration.md) object in the response body. +If successful, this method returns a `201 Created` response code and a [targetedManagedAppConfiguration](../resources/intune-shared-targetedmanagedappconfiguration.md) object in the response body. ## Example |
v1.0 | Intune Mam Targetedmanagedappconfiguration Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-targetedmanagedappconfiguration-delete.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Deletes a [targetedManagedAppConfiguration](../resources/intune-mam-targetedmanagedappconfiguration.md). +Deletes a [targetedManagedAppConfiguration](../resources/intune-shared-targetedmanagedappconfiguration.md). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] |
v1.0 | Intune Mam Targetedmanagedappconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-targetedmanagedappconfiguration-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [targetedManagedAppConfiguration](../resources/intune-mam-targetedmanagedappconfiguration.md) object. +Read properties and relationships of the [targetedManagedAppConfiguration](../resources/intune-shared-targetedmanagedappconfiguration.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [targetedManagedAppConfiguration](../resources/intune-mam-targetedmanagedappconfiguration.md) object in the response body. +If successful, this method returns a `200 OK` response code and [targetedManagedAppConfiguration](../resources/intune-shared-targetedmanagedappconfiguration.md) object in the response body. ## Example |
v1.0 | Intune Mam Targetedmanagedappconfiguration List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-targetedmanagedappconfiguration-list.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -List properties and relationships of the [targetedManagedAppConfiguration](../resources/intune-mam-targetedmanagedappconfiguration.md) objects. +List properties and relationships of the [targetedManagedAppConfiguration](../resources/intune-shared-targetedmanagedappconfiguration.md) objects. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] GET /deviceAppManagement/targetedManagedAppConfigurations Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and a collection of [targetedManagedAppConfiguration](../resources/intune-mam-targetedmanagedappconfiguration.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [targetedManagedAppConfiguration](../resources/intune-shared-targetedmanagedappconfiguration.md) objects in the response body. ## Example |
v1.0 | Intune Mam Targetedmanagedappconfiguration Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-targetedmanagedappconfiguration-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [targetedManagedAppConfiguration](../resources/intune-mam-targetedmanagedappconfiguration.md) object. +Update the properties of a [targetedManagedAppConfiguration](../resources/intune-shared-targetedmanagedappconfiguration.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceAppManagement/targetedManagedAppConfigurations/{targetedManagedAppC |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [targetedManagedAppConfiguration](../resources/intune-mam-targetedmanagedappconfiguration.md) object. +In the request body, supply a JSON representation for the [targetedManagedAppConfiguration](../resources/intune-shared-targetedmanagedappconfiguration.md) object. -The following table shows the properties that are required when you create the [targetedManagedAppConfiguration](../resources/intune-mam-targetedmanagedappconfiguration.md). +The following table shows the properties that are required when you create the [targetedManagedAppConfiguration](../resources/intune-shared-targetedmanagedappconfiguration.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [targetedManagedAppConfiguration](../resources/intune-mam-targetedmanagedappconfiguration.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [targetedManagedAppConfiguration](../resources/intune-shared-targetedmanagedappconfiguration.md) object in the response body. ## Example |
v1.0 | Intune Mam Targetedmanagedappprotection Assign | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-targetedmanagedappprotection-assign.md | Content-length: 582 Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Mam User Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-user-create.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Create a new [user](../resources/intune-mam-user.md) object. +Create a new [user](../resources/intune-shared-user.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] The following table shows the properties that are required when you create the u ## Response-If successful, this method returns a `201 Created` response code and a [user](../resources/intune-mam-user.md) object in the response body. +If successful, this method returns a `201 Created` response code and a [user](../resources/intune-shared-user.md) object in the response body. ## Example |
v1.0 | Intune Mam User Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-user-delete.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Deletes a [user](../resources/intune-mam-user.md). +Deletes a [user](../resources/intune-shared-user.md). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] |
v1.0 | Intune Mam User Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-user-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [user](../resources/intune-mam-user.md) object. +Read properties and relationships of the [user](../resources/intune-shared-user.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [user](../resources/intune-mam-user.md) object in the response body. +If successful, this method returns a `200 OK` response code and [user](../resources/intune-shared-user.md) object in the response body. ## Example |
v1.0 | Intune Mam User List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-user-list.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -List properties and relationships of the [user](../resources/intune-mam-user.md) objects. +List properties and relationships of the [user](../resources/intune-shared-user.md) objects. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] GET /users Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and a collection of [user](../resources/intune-mam-user.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [user](../resources/intune-shared-user.md) objects in the response body. ## Example |
v1.0 | Intune Mam User Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-user-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [user](../resources/intune-mam-user.md) object. +Update the properties of a [user](../resources/intune-shared-user.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /users/{usersId} |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [user](../resources/intune-mam-user.md) object. +In the request body, supply a JSON representation for the [user](../resources/intune-shared-user.md) object. -The following table shows the properties that are required when you create the [user](../resources/intune-mam-user.md). +The following table shows the properties that are required when you create the [user](../resources/intune-shared-user.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [user](../resources/intune-mam-user.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [user](../resources/intune-shared-user.md) object in the response body. ## Example |
v1.0 | Intune Mam User Wipeandblockmanagedapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-user-wipeandblockmanagedapps.md | Blocks the managed app user from app check-in. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). In addition to the listed permissions, an authenticated user must be assigned the Managed apps/Wipe permission in an Intune Role. Your automation must use delegated permissions as only granting application permissions as listed in the table are insufficient to complete the wipe action. |Permission type|Permissions (from least to most privileged)| |:|:| |
v1.0 | Intune Mam Windowsinformationprotection Assign | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mam-windowsinformationprotection-assign.md | Content-length: 582 Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Mstunnel Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-mstunnel-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-mstunnel-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Mstunnel Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-mstunnel-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-mstunnel-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-mstunnel-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-mstunnel-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Mstunnel Microsofttunnelconfiguration Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelconfiguration-create.md | Namespace: microsoft.graph Create a new [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelconfiguration Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelconfiguration-delete.md | Namespace: microsoft.graph Deletes a [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelconfiguration-get.md | Namespace: microsoft.graph Read properties and relationships of the [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelconfiguration List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelconfiguration-list.md | Namespace: microsoft.graph List properties and relationships of the [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelconfiguration Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelconfiguration-update.md | Namespace: microsoft.graph Update the properties of a [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelhealththreshold Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelhealththreshold-create.md | Namespace: microsoft.graph Create a new [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelhealththreshold Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelhealththreshold-delete.md | Namespace: microsoft.graph Deletes a [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelhealththreshold Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelhealththreshold-get.md | Namespace: microsoft.graph Read properties and relationships of the [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelhealththreshold List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelhealththreshold-list.md | Namespace: microsoft.graph List properties and relationships of the [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelhealththreshold Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelhealththreshold-update.md | Namespace: microsoft.graph Update the properties of a [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserver Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-create.md | Namespace: microsoft.graph Create a new [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserver Createserverlogcollectionrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-createserverlogcollectionrequest.md | Namespace: microsoft.graph ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserver Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-delete.md | Namespace: microsoft.graph Deletes a [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserver Generateserverlogcollectionrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-generateserverlogcollectionrequest.md | Namespace: microsoft.graph ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserver Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-get.md | Namespace: microsoft.graph Read properties and relationships of the [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserver Gethealthmetrics | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-gethealthmetrics.md | Namespace: microsoft.graph ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserver Gethealthmetrictimeseries | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-gethealthmetrictimeseries.md | Namespace: microsoft.graph ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserver List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-list.md | Namespace: microsoft.graph List properties and relationships of the [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserver Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-update.md | Namespace: microsoft.graph Update the properties of a [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserverlogcollectionresponse Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-create.md | Namespace: microsoft.graph Create a new [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserverlogcollectionresponse Createdownloadurl | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-createdownloadurl.md | Namespace: microsoft.graph ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserverlogcollectionresponse Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-delete.md | Namespace: microsoft.graph Deletes a [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserverlogcollectionresponse Generatedownloadurl | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-generatedownloadurl.md | Namespace: microsoft.graph ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserverlogcollectionresponse Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-get.md | Namespace: microsoft.graph Read properties and relationships of the [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserverlogcollectionresponse List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-list.md | Namespace: microsoft.graph List properties and relationships of the [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserverlogcollectionresponse Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-update.md | Namespace: microsoft.graph Update the properties of a [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelsite Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelsite-create.md | Namespace: microsoft.graph Create a new [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelsite Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelsite-delete.md | Namespace: microsoft.graph Deletes a [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelsite Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelsite-get.md | Namespace: microsoft.graph Read properties and relationships of the [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelsite List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelsite-list.md | Namespace: microsoft.graph List properties and relationships of the [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelsite Requestupgrade | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelsite-requestupgrade.md | Namespace: microsoft.graph ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelsite Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelsite-update.md | Namespace: microsoft.graph Update the properties of a [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Notification Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-notification-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-notification-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-notification-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Notification Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-notification-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-notification-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-notification-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-notification-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-notification-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Odj Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-odj-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-odj-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-odj-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Odj Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-odj-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-odj-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-odj-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-odj-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-odj-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Odj Devicemanagementdomainjoinconnector Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-odj-devicemanagementdomainjoinconnector-create.md | Namespace: microsoft.graph Create a new [deviceManagementDomainJoinConnector](../resources/intune-odj-devicemanagementdomainjoinconnector.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Odj Devicemanagementdomainjoinconnector Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-odj-devicemanagementdomainjoinconnector-delete.md | Namespace: microsoft.graph Deletes a [deviceManagementDomainJoinConnector](../resources/intune-odj-devicemanagementdomainjoinconnector.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Odj Devicemanagementdomainjoinconnector Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-odj-devicemanagementdomainjoinconnector-get.md | Namespace: microsoft.graph Read properties and relationships of the [deviceManagementDomainJoinConnector](../resources/intune-odj-devicemanagementdomainjoinconnector.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Odj Devicemanagementdomainjoinconnector List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-odj-devicemanagementdomainjoinconnector-list.md | Namespace: microsoft.graph List properties and relationships of the [deviceManagementDomainJoinConnector](../resources/intune-odj-devicemanagementdomainjoinconnector.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Odj Devicemanagementdomainjoinconnector Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-odj-devicemanagementdomainjoinconnector-update.md | Namespace: microsoft.graph Update the properties of a [deviceManagementDomainJoinConnector](../resources/intune-odj-devicemanagementdomainjoinconnector.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Onboarding Deviceappmanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-deviceappmanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceAppManagement](../resources/intune-onboarding-deviceappmanagement.md) object. +Read properties and relationships of the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceAppManagement](../resources/intune-onboarding-deviceappmanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object in the response body. ## Example |
v1.0 | Intune Onboarding Deviceappmanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-deviceappmanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceAppManagement](../resources/intune-onboarding-deviceappmanagement.md) object. +Update the properties of a [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceAppManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceAppManagement](../resources/intune-onboarding-deviceappmanagement.md) object. +In the request body, supply a JSON representation for the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object. -The following table shows the properties that are required when you create the [deviceAppManagement](../resources/intune-onboarding-deviceappmanagement.md). +The following table shows the properties that are required when you create the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceAppManagement](../resources/intune-onboarding-deviceappmanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object in the response body. ## Example |
v1.0 | Intune Onboarding Devicecategory Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-devicecategory-create.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Create a new [deviceCategory](../resources/intune-onboarding-devicecategory.md) object. +Create a new [deviceCategory](../resources/intune-shared-devicecategory.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] The following table shows the properties that are required when you create the d ## Response-If successful, this method returns a `201 Created` response code and a [deviceCategory](../resources/intune-onboarding-devicecategory.md) object in the response body. +If successful, this method returns a `201 Created` response code and a [deviceCategory](../resources/intune-shared-devicecategory.md) object in the response body. ## Example |
v1.0 | Intune Onboarding Devicecategory Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-devicecategory-delete.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Deletes a [deviceCategory](../resources/intune-onboarding-devicecategory.md). +Deletes a [deviceCategory](../resources/intune-shared-devicecategory.md). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] |
v1.0 | Intune Onboarding Devicecategory Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-devicecategory-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceCategory](../resources/intune-onboarding-devicecategory.md) object. +Read properties and relationships of the [deviceCategory](../resources/intune-shared-devicecategory.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceCategory](../resources/intune-onboarding-devicecategory.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceCategory](../resources/intune-shared-devicecategory.md) object in the response body. ## Example |
v1.0 | Intune Onboarding Devicecategory List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-devicecategory-list.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -List properties and relationships of the [deviceCategory](../resources/intune-onboarding-devicecategory.md) objects. +List properties and relationships of the [deviceCategory](../resources/intune-shared-devicecategory.md) objects. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] GET /deviceManagement/deviceCategories Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and a collection of [deviceCategory](../resources/intune-onboarding-devicecategory.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [deviceCategory](../resources/intune-shared-devicecategory.md) objects in the response body. ## Example |
v1.0 | Intune Onboarding Devicecategory Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-devicecategory-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceCategory](../resources/intune-onboarding-devicecategory.md) object. +Update the properties of a [deviceCategory](../resources/intune-shared-devicecategory.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement/deviceCategories/{deviceCategoryId} |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceCategory](../resources/intune-onboarding-devicecategory.md) object. +In the request body, supply a JSON representation for the [deviceCategory](../resources/intune-shared-devicecategory.md) object. -The following table shows the properties that are required when you create the [deviceCategory](../resources/intune-onboarding-devicecategory.md). +The following table shows the properties that are required when you create the [deviceCategory](../resources/intune-shared-devicecategory.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceCategory](../resources/intune-onboarding-devicecategory.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceCategory](../resources/intune-shared-devicecategory.md) object in the response body. ## Example |
v1.0 | Intune Onboarding Deviceenrollmentconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-deviceenrollmentconfiguration-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceEnrollmentConfiguration](../resources/intune-onboarding-deviceenrollmentconfiguration.md) object. +Read properties and relationships of the [deviceEnrollmentConfiguration](../resources/intune-shared-deviceenrollmentconfiguration.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceEnrollmentConfiguration](../resources/intune-onboarding-deviceenrollmentconfiguration.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceEnrollmentConfiguration](../resources/intune-shared-deviceenrollmentconfiguration.md) object in the response body. ## Example |
v1.0 | Intune Onboarding Deviceenrollmentconfiguration List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-deviceenrollmentconfiguration-list.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -List properties and relationships of the [deviceEnrollmentConfiguration](../resources/intune-onboarding-deviceenrollmentconfiguration.md) objects. +List properties and relationships of the [deviceEnrollmentConfiguration](../resources/intune-shared-deviceenrollmentconfiguration.md) objects. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] GET /deviceManagement/deviceEnrollmentConfigurations Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and a collection of [deviceEnrollmentConfiguration](../resources/intune-onboarding-deviceenrollmentconfiguration.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [deviceEnrollmentConfiguration](../resources/intune-shared-deviceenrollmentconfiguration.md) objects in the response body. ## Example |
v1.0 | Intune Onboarding Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-onboarding-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-onboarding-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Onboarding Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-onboarding-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-onboarding-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-onboarding-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-onboarding-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Onboarding Devicemanagement Verifywindowsenrollmentautodiscovery | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-devicemanagement-verifywindowsenrollmentautodiscovery.md | Content-Length: 21 { "value": true }-``` +``` |
v1.0 | Intune Onboarding Sideloadingkey Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-sideloadingkey-create.md | Content-Length: 295 "totalActivation": 15, "lastUpdatedDateTime": "Last Updated Date Time value" }-``` +``` |
v1.0 | Intune Onboarding Sideloadingkey Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-sideloadingkey-delete.md | DELETE https://graph.microsoft.com/beta/deviceAppManagement/sideLoadingKeys/{sid Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Onboarding Sideloadingkey Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-sideloadingkey-get.md | Content-Length: 328 "lastUpdatedDateTime": "Last Updated Date Time value" } }-``` +``` |
v1.0 | Intune Onboarding Sideloadingkey List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-sideloadingkey-list.md | Content-Length: 356 } ] }-``` +``` |
v1.0 | Intune Onboarding Sideloadingkey Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-sideloadingkey-update.md | Content-Length: 295 "totalActivation": 15, "lastUpdatedDateTime": "Last Updated Date Time value" }-``` +``` |
v1.0 | Intune Onboarding User Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-user-create.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Create a new [user](../resources/intune-onboarding-user.md) object. +Create a new [user](../resources/intune-shared-user.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] The following table shows the properties that are required when you create the u ## Response-If successful, this method returns a `201 Created` response code and a [user](../resources/intune-onboarding-user.md) object in the response body. +If successful, this method returns a `201 Created` response code and a [user](../resources/intune-shared-user.md) object in the response body. ## Example |
v1.0 | Intune Onboarding User Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-user-delete.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Deletes a [user](../resources/intune-onboarding-user.md). +Deletes a [user](../resources/intune-shared-user.md). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] |
v1.0 | Intune Onboarding User Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-user-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [user](../resources/intune-onboarding-user.md) object. +Read properties and relationships of the [user](../resources/intune-shared-user.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [user](../resources/intune-onboarding-user.md) object in the response body. +If successful, this method returns a `200 OK` response code and [user](../resources/intune-shared-user.md) object in the response body. ## Example |
v1.0 | Intune Onboarding User Geteffectivedeviceenrollmentconfigurations | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-user-geteffectivedeviceenrollmentconfigurations.md | GET /users/{usersId}/getEffectiveDeviceEnrollmentConfigurations Do not supply a request body for this method. ## Response-If successful, this function returns a `200 OK` response code and a [deviceEnrollmentConfiguration](../resources/intune-onboarding-deviceenrollmentconfiguration.md) collection in the response body. +If successful, this function returns a `200 OK` response code and a [deviceEnrollmentConfiguration](../resources/intune-shared-deviceenrollmentconfiguration.md) collection in the response body. ## Example |
v1.0 | Intune Onboarding User List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-user-list.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -List properties and relationships of the [user](../resources/intune-onboarding-user.md) objects. +List properties and relationships of the [user](../resources/intune-shared-user.md) objects. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] GET /users Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and a collection of [user](../resources/intune-onboarding-user.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [user](../resources/intune-shared-user.md) objects in the response body. ## Example |
v1.0 | Intune Onboarding User Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-user-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [user](../resources/intune-onboarding-user.md) object. +Update the properties of a [user](../resources/intune-shared-user.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /users/{usersId} |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [user](../resources/intune-onboarding-user.md) object. +In the request body, supply a JSON representation for the [user](../resources/intune-shared-user.md) object. -The following table shows the properties that are required when you create the [user](../resources/intune-onboarding-user.md). +The following table shows the properties that are required when you create the [user](../resources/intune-shared-user.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [user](../resources/intune-onboarding-user.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [user](../resources/intune-shared-user.md) object in the response body. ## Example |
v1.0 | Intune Onboarding Vpptoken Getlicensesforapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-onboarding-vpptoken-getlicensesforapp.md | Content-Length: 298 } ] }-``` +``` |
v1.0 | Intune Osprovisioninggraphservice Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-osprovisioninggraphservice-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-osprovisioninggraphservice-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-osprovisioninggraphservice-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Osprovisioninggraphservice Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-osprovisioninggraphservice-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-osprovisioninggraphservice-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-osprovisioninggraphservice-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-osprovisioninggraphservice-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-osprovisioninggraphservice-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Osprovisioninggraphservice Manageddevicewindowsoperatingsystemimage Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage-create.md | Content-Length: 612 } ] }-``` +``` |
v1.0 | Intune Osprovisioninggraphservice Manageddevicewindowsoperatingsystemimage Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/managedDeviceWindowsOSI Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Osprovisioninggraphservice Manageddevicewindowsoperatingsystemimage Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage-get.md | Content-Length: 671 ] } }-``` +``` |
v1.0 | Intune Osprovisioninggraphservice Manageddevicewindowsoperatingsystemimage Getallmanageddevicewindowsosimages | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage-getallmanageddevicewindowsosimages.md | Content-Length: 725 } ] }-``` +``` |
v1.0 | Intune Osprovisioninggraphservice Manageddevicewindowsoperatingsystemimage List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage-list.md | Content-Length: 725 } ] }-``` +``` |
v1.0 | Intune Osprovisioninggraphservice Manageddevicewindowsoperatingsystemimage Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage-update.md | Content-Length: 612 } ] }-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitymanageddevice Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-appvulnerabilitymanageddevice-create.md | Content-Length: 269 "displayName": "Display Name value", "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00" }-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitymanageddevice Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-appvulnerabilitymanageddevice-delete.md | DELETE https://graph.microsoft.com/beta** Entity URI for microsoft.management.se Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitymanageddevice Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-appvulnerabilitymanageddevice-get.md | Content-Length: 298 "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00" } }-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitymanageddevice List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-appvulnerabilitymanageddevice-list.md | Content-Length: 322 } ] }-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitymanageddevice Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-appvulnerabilitymanageddevice-update.md | Content-Length: 269 "displayName": "Display Name value", "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00" }-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitymobileapp Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-appvulnerabilitymobileapp-create.md | Content-Length: 396 "mobileAppType": "Mobile App Type value", "version": "Version value" }-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitymobileapp Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-appvulnerabilitymobileapp-delete.md | DELETE https://graph.microsoft.com/beta** Entity URI for microsoft.management.se Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitymobileapp Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-appvulnerabilitymobileapp-get.md | Content-Length: 431 "version": "Version value" } }-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitymobileapp List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-appvulnerabilitymobileapp-list.md | Content-Length: 461 } ] }-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitymobileapp Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-appvulnerabilitymobileapp-update.md | Content-Length: 396 "mobileAppType": "Mobile App Type value", "version": "Version value" }-``` +``` |
v1.0 | Intune Partnerintegration Configmanagercollection Getpolicysummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-configmanagercollection-getpolicysummary.md | Content-Length: 276 "enforcedDeviceCount": 3 } }-``` +``` |
v1.0 | Intune Partnerintegration Deviceappmanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-deviceappmanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceAppManagement](../resources/intune-partnerintegration-deviceappmanagement.md) object. +Read properties and relationships of the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceAppManagement](../resources/intune-partnerintegration-deviceappmanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object in the response body. ## Example |
v1.0 | Intune Partnerintegration Deviceappmanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-deviceappmanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceAppManagement](../resources/intune-partnerintegration-deviceappmanagement.md) object. +Update the properties of a [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceAppManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceAppManagement](../resources/intune-partnerintegration-deviceappmanagement.md) object. +In the request body, supply a JSON representation for the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object. -The following table shows the properties that are required when you create the [deviceAppManagement](../resources/intune-partnerintegration-deviceappmanagement.md). +The following table shows the properties that are required when you create the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceAppManagement](../resources/intune-partnerintegration-deviceappmanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object in the response body. ## Example |
v1.0 | Intune Partnerintegration Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-devicemanagement-get.md | + + Title: "Get deviceManagement" +description: "Read properties and relationships of the deviceManagement object." ++localization_priority: Normal ++++# Get deviceManagement ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. ++Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. +++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All| ++## HTTP Request +<!-- { + "blockType": "ignored" +} +--> +``` http +GET /deviceManagement +``` ++## Optional query parameters +This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. ++## Request headers +|Header|Value| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Accept|application/json| ++## Request body +Do not supply a request body for this method. ++## Response +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ++## Example ++### Request +Here is an example of the request. +``` http +GET https://graph.microsoft.com/beta/deviceManagement +``` ++### Response +Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. +``` http +HTTP/1.1 200 OK +Content-Type: application/json +Content-Length: 301 ++{ + "value": { + "@odata.type": "#microsoft.graph.deviceManagement", + "id": "0b283420-3420-0b28-2034-280b2034280b", + "organizationalMessageFeatureOnboarding": { + "@odata.type": "microsoft.graph.organizationalMessageFeatureOnboarding", + "hasRequiredLicense": true + } + } +} +``` |
v1.0 | Intune Partnerintegration Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-devicemanagement-update.md | + + Title: "Update deviceManagement" +description: "Update the properties of a deviceManagement object." ++localization_priority: Normal ++++# Update deviceManagement ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. ++Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. +++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All| ++## HTTP Request +<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /deviceManagement +``` ++## Request headers +|Header|Value| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Accept|application/json| ++## Request body +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. ++The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). ++|Property|Type|Description| +|:|:|:| +|id|String|Key of the entity.| +|organizationalMessageFeatureOnboarding|[organizationalMessageFeatureOnboarding](../resources/intune-partnerintegration-organizationalmessagefeatureonboarding.md)|OrganizationalMessageFeatureOnboarding| ++++## Response +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ++## Example ++### Request +Here is an example of the request. +``` http +PATCH https://graph.microsoft.com/beta/deviceManagement +Content-type: application/json +Content-length: 221 ++{ + "@odata.type": "#microsoft.graph.deviceManagement", + "organizationalMessageFeatureOnboarding": { + "@odata.type": "microsoft.graph.organizationalMessageFeatureOnboarding", + "hasRequiredLicense": true + } +} +``` ++### Response +Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. +``` http +HTTP/1.1 200 OK +Content-Type: application/json +Content-Length: 270 ++{ + "@odata.type": "#microsoft.graph.deviceManagement", + "id": "0b283420-3420-0b28-2034-280b2034280b", + "organizationalMessageFeatureOnboarding": { + "@odata.type": "microsoft.graph.organizationalMessageFeatureOnboarding", + "hasRequiredLicense": true + } +} +``` |
v1.0 | Intune Partnerintegration Vulnerablemanageddevice Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-vulnerablemanageddevice-create.md | Content-Length: 263 "displayName": "Display Name value", "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00" }-``` +``` |
v1.0 | Intune Partnerintegration Vulnerablemanageddevice Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-vulnerablemanageddevice-delete.md | DELETE https://graph.microsoft.com/beta** Entity URI for microsoft.management.se Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Partnerintegration Vulnerablemanageddevice Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-vulnerablemanageddevice-get.md | Content-Length: 292 "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00" } }-``` +``` |
v1.0 | Intune Partnerintegration Vulnerablemanageddevice List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-vulnerablemanageddevice-list.md | Content-Length: 316 } ] }-``` +``` |
v1.0 | Intune Partnerintegration Vulnerablemanageddevice Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-vulnerablemanageddevice-update.md | Content-Length: 263 "displayName": "Display Name value", "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00" }-``` +``` |
v1.0 | Intune Policylistingservice Deviceconfigurationprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-policylistingservice-deviceconfigurationprofile-create.md | Namespace: microsoft.graph Create a new [deviceConfigurationProfile](../resources/intune-policylistingservice-deviceconfigurationprofile.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Policylistingservice Deviceconfigurationprofile Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-policylistingservice-deviceconfigurationprofile-delete.md | Namespace: microsoft.graph Deletes a [deviceConfigurationProfile](../resources/intune-policylistingservice-deviceconfigurationprofile.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Policylistingservice Deviceconfigurationprofile Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-policylistingservice-deviceconfigurationprofile-get.md | Namespace: microsoft.graph Read properties and relationships of the [deviceConfigurationProfile](../resources/intune-policylistingservice-deviceconfigurationprofile.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Policylistingservice Deviceconfigurationprofile List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-policylistingservice-deviceconfigurationprofile-list.md | Namespace: microsoft.graph List properties and relationships of the [deviceConfigurationProfile](../resources/intune-policylistingservice-deviceconfigurationprofile.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Policylistingservice Deviceconfigurationprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-policylistingservice-deviceconfigurationprofile-update.md | Namespace: microsoft.graph Update the properties of a [deviceConfigurationProfile](../resources/intune-policylistingservice-deviceconfigurationprofile.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Policylistingservice Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-policylistingservice-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-policylistingservice-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-policylistingservice-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Policylistingservice Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-policylistingservice-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-policylistingservice-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-policylistingservice-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-policylistingservice-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-policylistingservice-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Policyset Deviceandappmanagementassignmentfilter Getplatformsupportedproperties | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-policyset-deviceandappmanagementassignmentfilter-getplatformsupportedproperties.md | Content-Length: 407 } ] }-``` +``` |
v1.0 | Intune Policyset Deviceappmanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-policyset-deviceappmanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceAppManagement](../resources/intune-policyset-deviceappmanagement.md) object. +Read properties and relationships of the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceAppManagement](../resources/intune-policyset-deviceappmanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object in the response body. ## Example |
v1.0 | Intune Policyset Deviceappmanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-policyset-deviceappmanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceAppManagement](../resources/intune-policyset-deviceappmanagement.md) object. +Update the properties of a [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceAppManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceAppManagement](../resources/intune-policyset-deviceappmanagement.md) object. +In the request body, supply a JSON representation for the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object. -The following table shows the properties that are required when you create the [deviceAppManagement](../resources/intune-policyset-deviceappmanagement.md). +The following table shows the properties that are required when you create the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceAppManagement](../resources/intune-policyset-deviceappmanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object in the response body. ## Example |
v1.0 | Intune Policyset Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-policyset-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-policyset-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-policyset-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Policyset Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-policyset-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-policyset-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-policyset-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-policyset-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-policyset-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Raimportcerts Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-raimportcerts-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-raimportcerts-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-raimportcerts-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Raimportcerts Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-raimportcerts-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-raimportcerts-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-raimportcerts-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-raimportcerts-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-raimportcerts-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Raimportcerts Onpremencryptedpayload Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-raimportcerts-onpremencryptedpayload-create.md | Content-Length: 781 "eTag": "ETag value", "isDeleted": true }-``` +``` |
v1.0 | Intune Raimportcerts Onpremencryptedpayload Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-raimportcerts-onpremencryptedpayload-delete.md | DELETE https://graph.microsoft.com/beta/onPremEncryptedPayloads/{onPremEncrypted Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Raimportcerts Onpremencryptedpayload Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-raimportcerts-onpremencryptedpayload-get.md | Content-Length: 834 "isDeleted": true } }-``` +``` |
v1.0 | Intune Raimportcerts Onpremencryptedpayload List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-raimportcerts-onpremencryptedpayload-list.md | Content-Length: 882 } ] }-``` +``` |
v1.0 | Intune Raimportcerts Onpremencryptedpayload Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-raimportcerts-onpremencryptedpayload-update.md | Content-Length: 781 "eTag": "ETag value", "isDeleted": true }-``` +``` |
v1.0 | Intune Raimportcerts Pfxrecryptionrequest Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-raimportcerts-pfxrecryptionrequest-create.md | Content-Length: 574 "isDeleted": true, "eTag": "ETag value" }-``` +``` |
v1.0 | Intune Raimportcerts Pfxrecryptionrequest Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-raimportcerts-pfxrecryptionrequest-delete.md | DELETE https://graph.microsoft.com/beta/pfxRecryptionRequests/{pfxRecryptionRequ Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Raimportcerts Pfxrecryptionrequest Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-raimportcerts-pfxrecryptionrequest-get.md | Content-Length: 619 "eTag": "ETag value" } }-``` +``` |
v1.0 | Intune Raimportcerts Pfxrecryptionrequest List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-raimportcerts-pfxrecryptionrequest-list.md | Content-Length: 659 } ] }-``` +``` |
v1.0 | Intune Raimportcerts Pfxrecryptionrequest Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-raimportcerts-pfxrecryptionrequest-update.md | Content-Length: 574 "isDeleted": true, "eTag": "ETag value" }-``` +``` |
v1.0 | Intune Raimportcerts Pfxusercertificate Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-raimportcerts-pfxusercertificate-create.md | Content-Length: 789 "lastModifiedTime": "2017-01-01T00:03:18.5958204-08:00", "eTag": "ETag value" }-``` +``` |
v1.0 | Intune Raimportcerts Pfxusercertificate Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-raimportcerts-pfxusercertificate-delete.md | DELETE https://graph.microsoft.com/beta/pfxUserCertificates/{pfxUserCertificates Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Raimportcerts Pfxusercertificate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-raimportcerts-pfxusercertificate-get.md | Content-Length: 844 "eTag": "ETag value" } }-``` +``` |
v1.0 | Intune Raimportcerts Pfxusercertificate List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-raimportcerts-pfxusercertificate-list.md | Content-Length: 894 } ] }-``` +``` |
v1.0 | Intune Raimportcerts Pfxusercertificate Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-raimportcerts-pfxusercertificate-update.md | Content-Length: 789 "lastModifiedTime": "2017-01-01T00:03:18.5958204-08:00", "eTag": "ETag value" }-``` +``` |
v1.0 | Intune Rapolicy Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-rapolicy-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-rapolicy-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Rapolicy Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-rapolicy-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-rapolicy-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-rapolicy-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-rapolicy-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Rapolicy Devicemanagementderivedcredentialsettings Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-devicemanagementderivedcredentialsettings-create.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Create a new [deviceManagementDerivedCredentialSettings](../resources/intune-rapolicy-devicemanagementderivedcredentialsettings.md) object. +Create a new [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] The following table shows the properties that are required when you create the d ## Response-If successful, this method returns a `201 Created` response code and a [deviceManagementDerivedCredentialSettings](../resources/intune-rapolicy-devicemanagementderivedcredentialsettings.md) object in the response body. +If successful, this method returns a `201 Created` response code and a [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) object in the response body. ## Example |
v1.0 | Intune Rapolicy Devicemanagementderivedcredentialsettings Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-devicemanagementderivedcredentialsettings-delete.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Deletes a [deviceManagementDerivedCredentialSettings](../resources/intune-rapolicy-devicemanagementderivedcredentialsettings.md). +Deletes a [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] |
v1.0 | Intune Rapolicy Devicemanagementderivedcredentialsettings Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-devicemanagementderivedcredentialsettings-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagementDerivedCredentialSettings](../resources/intune-rapolicy-devicemanagementderivedcredentialsettings.md) object. +Read properties and relationships of the [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagementDerivedCredentialSettings](../resources/intune-rapolicy-devicemanagementderivedcredentialsettings.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) object in the response body. ## Example |
v1.0 | Intune Rapolicy Devicemanagementderivedcredentialsettings List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-devicemanagementderivedcredentialsettings-list.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -List properties and relationships of the [deviceManagementDerivedCredentialSettings](../resources/intune-rapolicy-devicemanagementderivedcredentialsettings.md) objects. +List properties and relationships of the [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) objects. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] GET /deviceManagement/derivedCredentials Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and a collection of [deviceManagementDerivedCredentialSettings](../resources/intune-rapolicy-devicemanagementderivedcredentialsettings.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) objects in the response body. ## Example |
v1.0 | Intune Rapolicy Devicemanagementderivedcredentialsettings Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-devicemanagementderivedcredentialsettings-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagementDerivedCredentialSettings](../resources/intune-rapolicy-devicemanagementderivedcredentialsettings.md) object. +Update the properties of a [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement/derivedCredentials/{deviceManagementDerivedCredentialSet |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagementDerivedCredentialSettings](../resources/intune-rapolicy-devicemanagementderivedcredentialsettings.md) object. +In the request body, supply a JSON representation for the [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) object. -The following table shows the properties that are required when you create the [deviceManagementDerivedCredentialSettings](../resources/intune-rapolicy-devicemanagementderivedcredentialsettings.md). +The following table shows the properties that are required when you create the [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagementDerivedCredentialSettings](../resources/intune-rapolicy-devicemanagementderivedcredentialsettings.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) object in the response body. ## Example |
v1.0 | Intune Rapolicy Devicemanagementresourceaccessprofilebase Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-devicemanagementresourceaccessprofilebase-get.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 453 +Content-Length: 713 { "value": { Content-Length: 453 "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", "roleScopeTagIds": [ "Role Scope Tag Ids value"+ ], + "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.osVersionApplicabilityRule", + "filterType": "include", + "minOSVersion": "Min OSVersion value", + "maxOSVersion": "Max OSVersion value" + } ] } } |
v1.0 | Intune Rapolicy Devicemanagementresourceaccessprofilebase List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-devicemanagementresourceaccessprofilebase-list.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 487 +Content-Length: 763 { "value": [ Content-Length: 487 "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", "roleScopeTagIds": [ "Role Scope Tag Ids value"+ ], + "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.osVersionApplicabilityRule", + "filterType": "include", + "minOSVersion": "Min OSVersion value", + "maxOSVersion": "Max OSVersion value" + } ] } ] |
v1.0 | Intune Rapolicy Devicemanagementresourceaccessprofilebase Querybyplatformtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-devicemanagementresourceaccessprofilebase-querybyplatformtype.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 487 +Content-Length: 763 { "value": [ Content-Length: 487 "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", "roleScopeTagIds": [ "Role Scope Tag Ids value"+ ], + "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.osVersionApplicabilityRule", + "filterType": "include", + "minOSVersion": "Min OSVersion value", + "maxOSVersion": "Max OSVersion value" + } ] } ] |
v1.0 | Intune Rapolicy Windows10xcertificateprofile Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-windows10xcertificateprofile-get.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 440 +Content-Length: 595 { "value": { Content-Length: 440 "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", "roleScopeTagIds": [ "Role Scope Tag Ids value"+ ], + "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } ] } } |
v1.0 | Intune Rapolicy Windows10xcertificateprofile List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-windows10xcertificateprofile-list.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 474 +Content-Length: 641 { "value": [ Content-Length: 474 "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", "roleScopeTagIds": [ "Role Scope Tag Ids value"+ ], + "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } ] } ] |
v1.0 | Intune Rapolicy Windows10xscepcertificateprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-windows10xscepcertificateprofile-create.md | The following table shows the properties that are required when you create the w |creationDateTime|DateTimeOffset|DateTime profile was created Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |lastModifiedDateTime|DateTimeOffset|DateTime profile was last modified Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |roleScopeTagIds|String collection|Scope Tags Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)|+|serverApplicabilityRules|[applicabilityRule](../resources/intune-rapolicy-applicabilityrule.md) collection|The list of Applicability Rules for a Device Configuration Profile Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |certificateStore|[certificateStore](../resources/intune-shared-certificatestore.md)|Target store certificate. Possible values are: `user`, `machine`.| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Possible values are: `days`, `months`, `years`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-rapolicy-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings.| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings.| |hashAlgorithm|[hashAlgorithms](../resources/intune-shared-hashalgorithms.md) collection|SCEP Hash Algorithm. Possible values are: `sha1`, `sha2`.| |keySize|[keySize](../resources/intune-shared-keysize.md)|SCEP Key Size. Possible values are: `size1024`, `size2048`, `size4096`.| |keyStorageProvider|[keyStorageProviderOption](../resources/intune-shared-keystorageprovideroption.md)|Key Storage Provider (KSP). Possible values are: `useTpmKspOtherwiseUseSoftwareKsp`, `useTpmKspOtherwiseFail`, `usePassportForWorkKspOtherwiseFail`, `useSoftwareKsp`.| Here is an example of the request. ``` http POST https://graph.microsoft.com/beta/deviceManagement/resourceAccessProfiles Content-type: application/json-Content-length: 1178 +Content-length: 1321 { "@odata.type": "#microsoft.graph.windows10XSCEPCertificateProfile", Content-length: 1178 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "certificateStore": "machine", "certificateValidityPeriodScale": "months", "certificateValidityPeriodValue": 14, Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 201 Created Content-Type: application/json-Content-Length: 1291 +Content-Length: 1434 { "@odata.type": "#microsoft.graph.windows10XSCEPCertificateProfile", Content-Length: 1291 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "certificateStore": "machine", "certificateValidityPeriodScale": "months", "certificateValidityPeriodValue": 14, |
v1.0 | Intune Rapolicy Windows10xscepcertificateprofile Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-windows10xscepcertificateprofile-get.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1388 +Content-Length: 1543 { "value": { Content-Length: 1388 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "certificateStore": "machine", "certificateValidityPeriodScale": "months", "certificateValidityPeriodValue": 14, |
v1.0 | Intune Rapolicy Windows10xscepcertificateprofile List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-windows10xscepcertificateprofile-list.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1480 +Content-Length: 1647 { "value": [ Content-Length: 1480 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "certificateStore": "machine", "certificateValidityPeriodScale": "months", "certificateValidityPeriodValue": 14, |
v1.0 | Intune Rapolicy Windows10xscepcertificateprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-windows10xscepcertificateprofile-update.md | The following table shows the properties that are required when you create the [ |creationDateTime|DateTimeOffset|DateTime profile was created Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |lastModifiedDateTime|DateTimeOffset|DateTime profile was last modified Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |roleScopeTagIds|String collection|Scope Tags Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)|+|serverApplicabilityRules|[applicabilityRule](../resources/intune-rapolicy-applicabilityrule.md) collection|The list of Applicability Rules for a Device Configuration Profile Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |certificateStore|[certificateStore](../resources/intune-shared-certificatestore.md)|Target store certificate. Possible values are: `user`, `machine`.| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Possible values are: `days`, `months`, `years`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-rapolicy-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings.| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings.| |hashAlgorithm|[hashAlgorithms](../resources/intune-shared-hashalgorithms.md) collection|SCEP Hash Algorithm. Possible values are: `sha1`, `sha2`.| |keySize|[keySize](../resources/intune-shared-keysize.md)|SCEP Key Size. Possible values are: `size1024`, `size2048`, `size4096`.| |keyStorageProvider|[keyStorageProviderOption](../resources/intune-shared-keystorageprovideroption.md)|Key Storage Provider (KSP). Possible values are: `useTpmKspOtherwiseUseSoftwareKsp`, `useTpmKspOtherwiseFail`, `usePassportForWorkKspOtherwiseFail`, `useSoftwareKsp`.| Here is an example of the request. ``` http PATCH https://graph.microsoft.com/beta/deviceManagement/resourceAccessProfiles/{deviceManagementResourceAccessProfileBaseId} Content-type: application/json-Content-length: 1178 +Content-length: 1321 { "@odata.type": "#microsoft.graph.windows10XSCEPCertificateProfile", Content-length: 1178 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "certificateStore": "machine", "certificateValidityPeriodScale": "months", "certificateValidityPeriodValue": 14, Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1291 +Content-Length: 1434 { "@odata.type": "#microsoft.graph.windows10XSCEPCertificateProfile", Content-Length: 1291 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "certificateStore": "machine", "certificateValidityPeriodScale": "months", "certificateValidityPeriodValue": 14, |
v1.0 | Intune Rapolicy Windows10xtrustedrootcertificate Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-windows10xtrustedrootcertificate-create.md | The following table shows the properties that are required when you create the w |creationDateTime|DateTimeOffset|DateTime profile was created Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |lastModifiedDateTime|DateTimeOffset|DateTime profile was last modified Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |roleScopeTagIds|String collection|Scope Tags Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)|+|serverApplicabilityRules|[applicabilityRule](../resources/intune-rapolicy-applicabilityrule.md) collection|The list of Applicability Rules for a Device Configuration Profile Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |trustedRootCertificate|Binary|Trusted Root Certificate| |certFileName|String|File name to display in UI.| |destinationStore|[certificateDestinationStore](../resources/intune-shared-certificatedestinationstore.md)|Destination store location for the Trusted Root Certificate. Possible values are: `computerCertStoreRoot`, `computerCertStoreIntermediate`, `userCertStoreIntermediate`.| Here is an example of the request. ``` http POST https://graph.microsoft.com/beta/deviceManagement/resourceAccessProfiles Content-type: application/json-Content-length: 456 +Content-length: 599 { "@odata.type": "#microsoft.graph.windows10XTrustedRootCertificate", Content-length: 456 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value", "destinationStore": "computerCertStoreIntermediate" Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 201 Created Content-Type: application/json-Content-Length: 569 +Content-Length: 712 { "@odata.type": "#microsoft.graph.windows10XTrustedRootCertificate", Content-Length: 569 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value", "destinationStore": "computerCertStoreIntermediate" |
v1.0 | Intune Rapolicy Windows10xtrustedrootcertificate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-windows10xtrustedrootcertificate-get.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 614 +Content-Length: 769 { "value": { Content-Length: 614 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value", "destinationStore": "computerCertStoreIntermediate" |
v1.0 | Intune Rapolicy Windows10xtrustedrootcertificate List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-windows10xtrustedrootcertificate-list.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 654 +Content-Length: 821 { "value": [ Content-Length: 654 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value", "destinationStore": "computerCertStoreIntermediate" |
v1.0 | Intune Rapolicy Windows10xtrustedrootcertificate Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-windows10xtrustedrootcertificate-update.md | The following table shows the properties that are required when you create the [ |creationDateTime|DateTimeOffset|DateTime profile was created Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |lastModifiedDateTime|DateTimeOffset|DateTime profile was last modified Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |roleScopeTagIds|String collection|Scope Tags Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)|+|serverApplicabilityRules|[applicabilityRule](../resources/intune-rapolicy-applicabilityrule.md) collection|The list of Applicability Rules for a Device Configuration Profile Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |trustedRootCertificate|Binary|Trusted Root Certificate| |certFileName|String|File name to display in UI.| |destinationStore|[certificateDestinationStore](../resources/intune-shared-certificatedestinationstore.md)|Destination store location for the Trusted Root Certificate. Possible values are: `computerCertStoreRoot`, `computerCertStoreIntermediate`, `userCertStoreIntermediate`.| Here is an example of the request. ``` http PATCH https://graph.microsoft.com/beta/deviceManagement/resourceAccessProfiles/{deviceManagementResourceAccessProfileBaseId} Content-type: application/json-Content-length: 456 +Content-length: 599 { "@odata.type": "#microsoft.graph.windows10XTrustedRootCertificate", Content-length: 456 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value", "destinationStore": "computerCertStoreIntermediate" Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 569 +Content-Length: 712 { "@odata.type": "#microsoft.graph.windows10XTrustedRootCertificate", Content-Length: 569 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value", "destinationStore": "computerCertStoreIntermediate" |
v1.0 | Intune Rapolicy Windows10xvpnconfiguration Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-windows10xvpnconfiguration-create.md | The following table shows the properties that are required when you create the w |creationDateTime|DateTimeOffset|DateTime profile was created Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |lastModifiedDateTime|DateTimeOffset|DateTime profile was last modified Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |roleScopeTagIds|String collection|Scope Tags Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)|+|serverApplicabilityRules|[applicabilityRule](../resources/intune-rapolicy-applicabilityrule.md) collection|The list of Applicability Rules for a Device Configuration Profile Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |authenticationCertificateId|Guid|ID to the Authentication Certificate| |customXmlFileName|String|Custom Xml file name.| |customXml|Binary|Custom XML commands that configures the VPN connection. (UTF8 byte encoding)| Here is an example of the request. ``` http POST https://graph.microsoft.com/beta/deviceManagement/resourceAccessProfiles Content-type: application/json-Content-length: 446 +Content-length: 589 { "@odata.type": "#microsoft.graph.windows10XVpnConfiguration", Content-length: 446 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "authenticationCertificateId": "39b4cd38-cd38-39b4-38cd-b43938cdb439", "customXmlFileName": "Custom Xml File Name value", "customXml": "Y3VzdG9tWG1s" Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 201 Created Content-Type: application/json-Content-Length: 559 +Content-Length: 702 { "@odata.type": "#microsoft.graph.windows10XVpnConfiguration", Content-Length: 559 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "authenticationCertificateId": "39b4cd38-cd38-39b4-38cd-b43938cdb439", "customXmlFileName": "Custom Xml File Name value", "customXml": "Y3VzdG9tWG1s" |
v1.0 | Intune Rapolicy Windows10xvpnconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-windows10xvpnconfiguration-get.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 604 +Content-Length: 759 { "value": { Content-Length: 604 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "authenticationCertificateId": "39b4cd38-cd38-39b4-38cd-b43938cdb439", "customXmlFileName": "Custom Xml File Name value", "customXml": "Y3VzdG9tWG1s" |
v1.0 | Intune Rapolicy Windows10xvpnconfiguration List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-windows10xvpnconfiguration-list.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 644 +Content-Length: 811 { "value": [ Content-Length: 644 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "authenticationCertificateId": "39b4cd38-cd38-39b4-38cd-b43938cdb439", "customXmlFileName": "Custom Xml File Name value", "customXml": "Y3VzdG9tWG1s" |
v1.0 | Intune Rapolicy Windows10xvpnconfiguration Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-windows10xvpnconfiguration-update.md | The following table shows the properties that are required when you create the [ |creationDateTime|DateTimeOffset|DateTime profile was created Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |lastModifiedDateTime|DateTimeOffset|DateTime profile was last modified Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |roleScopeTagIds|String collection|Scope Tags Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)|+|serverApplicabilityRules|[applicabilityRule](../resources/intune-rapolicy-applicabilityrule.md) collection|The list of Applicability Rules for a Device Configuration Profile Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |authenticationCertificateId|Guid|ID to the Authentication Certificate| |customXmlFileName|String|Custom Xml file name.| |customXml|Binary|Custom XML commands that configures the VPN connection. (UTF8 byte encoding)| Here is an example of the request. ``` http PATCH https://graph.microsoft.com/beta/deviceManagement/resourceAccessProfiles/{deviceManagementResourceAccessProfileBaseId} Content-type: application/json-Content-length: 446 +Content-length: 589 { "@odata.type": "#microsoft.graph.windows10XVpnConfiguration", Content-length: 446 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "authenticationCertificateId": "39b4cd38-cd38-39b4-38cd-b43938cdb439", "customXmlFileName": "Custom Xml File Name value", "customXml": "Y3VzdG9tWG1s" Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 559 +Content-Length: 702 { "@odata.type": "#microsoft.graph.windows10XVpnConfiguration", Content-Length: 559 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "authenticationCertificateId": "39b4cd38-cd38-39b4-38cd-b43938cdb439", "customXmlFileName": "Custom Xml File Name value", "customXml": "Y3VzdG9tWG1s" |
v1.0 | Intune Rapolicy Windows10xwificonfiguration Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-windows10xwificonfiguration-create.md | The following table shows the properties that are required when you create the w |creationDateTime|DateTimeOffset|DateTime profile was created Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |lastModifiedDateTime|DateTimeOffset|DateTime profile was last modified Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |roleScopeTagIds|String collection|Scope Tags Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)|+|serverApplicabilityRules|[applicabilityRule](../resources/intune-rapolicy-applicabilityrule.md) collection|The list of Applicability Rules for a Device Configuration Profile Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |authenticationCertificateId|Guid|ID to the Authentication Certificate| |customXmlFileName|String|Custom Xml file name.| |customXml|Binary|Custom XML commands that configures the VPN connection. (UTF8 byte encoding)| Here is an example of the request. ``` http POST https://graph.microsoft.com/beta/deviceManagement/resourceAccessProfiles Content-type: application/json-Content-length: 447 +Content-length: 590 { "@odata.type": "#microsoft.graph.windows10XWifiConfiguration", Content-length: 447 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "authenticationCertificateId": "39b4cd38-cd38-39b4-38cd-b43938cdb439", "customXmlFileName": "Custom Xml File Name value", "customXml": "Y3VzdG9tWG1s" Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 201 Created Content-Type: application/json-Content-Length: 560 +Content-Length: 703 { "@odata.type": "#microsoft.graph.windows10XWifiConfiguration", Content-Length: 560 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "authenticationCertificateId": "39b4cd38-cd38-39b4-38cd-b43938cdb439", "customXmlFileName": "Custom Xml File Name value", "customXml": "Y3VzdG9tWG1s" |
v1.0 | Intune Rapolicy Windows10xwificonfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-windows10xwificonfiguration-get.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 605 +Content-Length: 760 { "value": { Content-Length: 605 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "authenticationCertificateId": "39b4cd38-cd38-39b4-38cd-b43938cdb439", "customXmlFileName": "Custom Xml File Name value", "customXml": "Y3VzdG9tWG1s" |
v1.0 | Intune Rapolicy Windows10xwificonfiguration List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-windows10xwificonfiguration-list.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 645 +Content-Length: 812 { "value": [ Content-Length: 645 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "authenticationCertificateId": "39b4cd38-cd38-39b4-38cd-b43938cdb439", "customXmlFileName": "Custom Xml File Name value", "customXml": "Y3VzdG9tWG1s" |
v1.0 | Intune Rapolicy Windows10xwificonfiguration Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rapolicy-windows10xwificonfiguration-update.md | The following table shows the properties that are required when you create the [ |creationDateTime|DateTimeOffset|DateTime profile was created Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |lastModifiedDateTime|DateTimeOffset|DateTime profile was last modified Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |roleScopeTagIds|String collection|Scope Tags Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)|+|serverApplicabilityRules|[applicabilityRule](../resources/intune-rapolicy-applicabilityrule.md) collection|The list of Applicability Rules for a Device Configuration Profile Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |authenticationCertificateId|Guid|ID to the Authentication Certificate| |customXmlFileName|String|Custom Xml file name.| |customXml|Binary|Custom XML commands that configures the VPN connection. (UTF8 byte encoding)| Here is an example of the request. ``` http PATCH https://graph.microsoft.com/beta/deviceManagement/resourceAccessProfiles/{deviceManagementResourceAccessProfileBaseId} Content-type: application/json-Content-length: 447 +Content-length: 590 { "@odata.type": "#microsoft.graph.windows10XWifiConfiguration", Content-length: 447 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "authenticationCertificateId": "39b4cd38-cd38-39b4-38cd-b43938cdb439", "customXmlFileName": "Custom Xml File Name value", "customXml": "Y3VzdG9tWG1s" Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 560 +Content-Length: 703 { "@odata.type": "#microsoft.graph.windows10XWifiConfiguration", Content-Length: 560 "roleScopeTagIds": [ "Role Scope Tag Ids value" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "include" + } + ], "authenticationCertificateId": "39b4cd38-cd38-39b4-38cd-b43938cdb439", "customXmlFileName": "Custom Xml File Name value", "customXml": "Y3VzdG9tWG1s" |
v1.0 | Intune Rbac Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rbac-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-rbac-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-rbac-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Rbac Devicemanagement Getrolescopetagsbyids | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rbac-devicemanagement-getrolescopetagsbyids.md | Content-Length: 257 } ] }-``` +``` |
v1.0 | Intune Rbac Devicemanagement Getrolescopetagsbyresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rbac-devicemanagement-getrolescopetagsbyresource.md | Content-Length: 257 } ] }-``` +``` |
v1.0 | Intune Rbac Devicemanagement Scopedforresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rbac-devicemanagement-scopedforresource.md | Content-Length: 21 { "value": true }-``` +``` |
v1.0 | Intune Rbac Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rbac-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-rbac-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-rbac-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-rbac-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-rbac-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Rbac Operationapprovalrequest Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rbac-operationapprovalrequest-create.md | The following table shows the properties that are required when you create the o |status|[operationApprovalRequestStatus](../resources/intune-rbac-operationapprovalrequeststatus.md)|The current approval status of the request. Possible values are: `unknown`, `needsApproval`, `approved`, `rejected`, `cancelled`, `completed`, `expired`. Default value is `unknown`. Read-only. This property is read-only. Possible values are: `unknown`, `needsApproval`, `approved`, `rejected`, `cancelled`, `completed`, `expired`, `unknownFutureValue`.| |requestJustification|String|Indicates the justification for creating the request. Maximum length of justification is 1024 characters. For example: 'Needed for Feb 2023 application baseline updates.' Read-only. This property is read-only.| |approvalJustification|String|Indicates the justification for approving or rejecting the request. Maximum length of justification is 1024 characters. For example: 'Approved per Change 23423 - needed for Feb 2023 application baseline updates.' Read-only. This property is read-only.|-|operationApprovalPolicies|String|The operational approval policies used in the request. Indicates the policy and platform combinations that are required for this request to be approved or rejected. Read-only. This property is read-only.| |requiredOperationApprovalPolicyTypes|[operationApprovalPolicyType](../resources/intune-rbac-operationapprovalpolicytype.md) collection|Indicates the approval policy types required by the request in order for the request to be approved or rejected. Read-only. This property is read-only. Possible values are: `unknown`, `deviceAction`, `deviceWipe`, `deviceRetire`, `deviceRetireNonCompliant`, `deviceDelete`, `deviceLock`, `deviceErase`, `deviceDisableActivationLock`, `windowsEnrollment`, `compliancePolicy`, `configurationPolicy`, `appProtectionPolicy`, `policySet`, `filter`, `endpointSecurityPolicy`, `apps`, `script`, `role`, `deviceResetPasscode`, `customOrganizationalMessage`, `unknownFutureValue`.| Here is an example of the request. ``` http POST https://graph.microsoft.com/beta/deviceManagement/operationApprovalRequests Content-type: application/json-Content-length: 1486 +Content-length: 1417 { "@odata.type": "#microsoft.graph.operationApprovalRequest", Content-length: 1486 "status": "needsApproval", "requestJustification": "Request Justification value", "approvalJustification": "Approval Justification value",- "operationApprovalPolicies": "Operation Approval Policies value", "requiredOperationApprovalPolicyTypes": [ "deviceAction" ] Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 201 Created Content-Type: application/json-Content-Length: 1599 +Content-Length: 1530 { "@odata.type": "#microsoft.graph.operationApprovalRequest", Content-Length: 1599 "status": "needsApproval", "requestJustification": "Request Justification value", "approvalJustification": "Approval Justification value",- "operationApprovalPolicies": "Operation Approval Policies value", "requiredOperationApprovalPolicyTypes": [ "deviceAction" ] |
v1.0 | Intune Rbac Operationapprovalrequest Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rbac-operationapprovalrequest-get.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1714 +Content-Length: 1643 { "value": { Content-Length: 1714 "status": "needsApproval", "requestJustification": "Request Justification value", "approvalJustification": "Approval Justification value",- "operationApprovalPolicies": "Operation Approval Policies value", "requiredOperationApprovalPolicyTypes": [ "deviceAction" ] |
v1.0 | Intune Rbac Operationapprovalrequest List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rbac-operationapprovalrequest-list.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1824 +Content-Length: 1751 { "value": [ Content-Length: 1824 "status": "needsApproval", "requestJustification": "Request Justification value", "approvalJustification": "Approval Justification value",- "operationApprovalPolicies": "Operation Approval Policies value", "requiredOperationApprovalPolicyTypes": [ "deviceAction" ] |
v1.0 | Intune Rbac Operationapprovalrequest Retrievemyrequestbyid | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rbac-operationapprovalrequest-retrievemyrequestbyid.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1714 +Content-Length: 1643 { "value": { Content-Length: 1714 "status": "needsApproval", "requestJustification": "Request Justification value", "approvalJustification": "Approval Justification value",- "operationApprovalPolicies": "Operation Approval Policies value", "requiredOperationApprovalPolicyTypes": [ "deviceAction" ] } }-``` +``` |
v1.0 | Intune Rbac Operationapprovalrequest Retrievemyrequests | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rbac-operationapprovalrequest-retrievemyrequests.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1824 +Content-Length: 1751 { "value": [ Content-Length: 1824 "status": "needsApproval", "requestJustification": "Request Justification value", "approvalJustification": "Approval Justification value",- "operationApprovalPolicies": "Operation Approval Policies value", "requiredOperationApprovalPolicyTypes": [ "deviceAction" ] |
v1.0 | Intune Rbac Operationapprovalrequest Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rbac-operationapprovalrequest-update.md | The following table shows the properties that are required when you create the [ |status|[operationApprovalRequestStatus](../resources/intune-rbac-operationapprovalrequeststatus.md)|The current approval status of the request. Possible values are: `unknown`, `needsApproval`, `approved`, `rejected`, `cancelled`, `completed`, `expired`. Default value is `unknown`. Read-only. This property is read-only. Possible values are: `unknown`, `needsApproval`, `approved`, `rejected`, `cancelled`, `completed`, `expired`, `unknownFutureValue`.| |requestJustification|String|Indicates the justification for creating the request. Maximum length of justification is 1024 characters. For example: 'Needed for Feb 2023 application baseline updates.' Read-only. This property is read-only.| |approvalJustification|String|Indicates the justification for approving or rejecting the request. Maximum length of justification is 1024 characters. For example: 'Approved per Change 23423 - needed for Feb 2023 application baseline updates.' Read-only. This property is read-only.|-|operationApprovalPolicies|String|The operational approval policies used in the request. Indicates the policy and platform combinations that are required for this request to be approved or rejected. Read-only. This property is read-only.| |requiredOperationApprovalPolicyTypes|[operationApprovalPolicyType](../resources/intune-rbac-operationapprovalpolicytype.md) collection|Indicates the approval policy types required by the request in order for the request to be approved or rejected. Read-only. This property is read-only. Possible values are: `unknown`, `deviceAction`, `deviceWipe`, `deviceRetire`, `deviceRetireNonCompliant`, `deviceDelete`, `deviceLock`, `deviceErase`, `deviceDisableActivationLock`, `windowsEnrollment`, `compliancePolicy`, `configurationPolicy`, `appProtectionPolicy`, `policySet`, `filter`, `endpointSecurityPolicy`, `apps`, `script`, `role`, `deviceResetPasscode`, `customOrganizationalMessage`, `unknownFutureValue`.| Here is an example of the request. ``` http PATCH https://graph.microsoft.com/beta/deviceManagement/operationApprovalRequests/{operationApprovalRequestId} Content-type: application/json-Content-length: 1486 +Content-length: 1417 { "@odata.type": "#microsoft.graph.operationApprovalRequest", Content-length: 1486 "status": "needsApproval", "requestJustification": "Request Justification value", "approvalJustification": "Approval Justification value",- "operationApprovalPolicies": "Operation Approval Policies value", "requiredOperationApprovalPolicyTypes": [ "deviceAction" ] Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1599 +Content-Length: 1530 { "@odata.type": "#microsoft.graph.operationApprovalRequest", Content-Length: 1599 "status": "needsApproval", "requestJustification": "Request Justification value", "approvalJustification": "Approval Justification value",- "operationApprovalPolicies": "Operation Approval Policies value", "requiredOperationApprovalPolicyTypes": [ "deviceAction" ] |
v1.0 | Intune Rbac Rbacapplicationmultiple Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rbac-rbacapplicationmultiple-get.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 137 +Content-Length: 86 { "value": {- "@odata.type": "#microsoft.graph.rbacApplicationMultiple", - "id": "ee4797e5-97e5-ee47-e597-47eee59747ee" + "@odata.type": "#microsoft.graph.rbacApplicationMultiple" } } ``` |
v1.0 | Intune Rbac Rbacapplicationmultiple Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rbac-rbacapplicationmultiple-update.md | The following table shows the properties that are required when you create the [ |Property|Type|Description| |:|:|:|-|id|String|| Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 114 +Content-Length: 65 {- "@odata.type": "#microsoft.graph.rbacApplicationMultiple", - "id": "ee4797e5-97e5-ee47-e597-47eee59747ee" + "@odata.type": "#microsoft.graph.rbacApplicationMultiple" } ``` |
v1.0 | Intune Rbac Resourceoperation Getscopesforuser | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rbac-resourceoperation-getscopesforuser.md | Content-Length: 56 "Get Scopes For User value" ] }-``` +``` |
v1.0 | Intune Rbac Rolescopetagautoassignment Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rbac-rolescopetagautoassignment-create.md | Content-Length: 447 "entraObjectId": "Entra Object Id value" } }-``` +``` |
v1.0 | Intune Rbac Rolescopetagautoassignment Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rbac-rolescopetagautoassignment-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/roleDefinitions/{roleDe Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Rbac Rolescopetagautoassignment Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rbac-rolescopetagautoassignment-get.md | Content-Length: 484 } } }-``` +``` |
v1.0 | Intune Rbac Rolescopetagautoassignment List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rbac-rolescopetagautoassignment-list.md | Content-Length: 516 } ] }-``` +``` |
v1.0 | Intune Rbac Rolescopetagautoassignment Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-rbac-rolescopetagautoassignment-update.md | Content-Length: 447 "entraObjectId": "Entra Object Id value" } }-``` +``` |
v1.0 | Intune Remoteassistance Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-remoteassistance-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-remoteassistance-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-remoteassistance-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Remoteassistance Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-remoteassistance-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-remoteassistance-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-remoteassistance-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-remoteassistance-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-remoteassistance-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Reporting Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-reporting-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-reporting-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-reporting-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Reporting Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-reporting-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-reporting-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-reporting-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-reporting-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-reporting-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Reporting Devicemanagementreports Getsettingcomplianceaggreport | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-reporting-devicemanagementreports-getsettingcomplianceaggreport.md | Content-Length: 95 { "value": "Z2V0U2V0dGluZ0NvbXBsaWFuY2VBZ2dSZXBvcnQgSW50dW5lIERvYyBTYW1wbGUgMTAwOTk1NjE2" }-``` +``` |
v1.0 | Intune Reporting Devicemanagementreportschedule Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-reporting-devicemanagementreportschedule-create.md | Content-Length: 588 ], "format": "pdf" }-``` +``` |
v1.0 | Intune Reporting Devicemanagementreportschedule Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-reporting-devicemanagementreportschedule-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/reports/reportSchedules Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Reporting Devicemanagementreportschedule Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-reporting-devicemanagementreportschedule-get.md | Content-Length: 647 "format": "pdf" } }-``` +``` |
v1.0 | Intune Reporting Devicemanagementreportschedule List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-reporting-devicemanagementreportschedule-list.md | Content-Length: 701 } ] }-``` +``` |
v1.0 | Intune Reporting Devicemanagementreportschedule Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-reporting-devicemanagementreportschedule-update.md | Content-Length: 588 ], "format": "pdf" }-``` +``` |
v1.0 | Intune Servicenowconnectorservice Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-servicenowconnectorservice-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-servicenowconnectorservice-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-servicenowconnectorservice-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Servicenowconnectorservice Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-servicenowconnectorservice-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-servicenowconnectorservice-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-servicenowconnectorservice-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-servicenowconnectorservice-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-servicenowconnectorservice-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Shared Deviceappmanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-deviceappmanagement-get.md | GET /deviceAppManagement ## Optional query parameters -This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. +This method supports the [OData Query Parameters](https://developer.microsoft.com/graph/docs/concepts/query_parameters) to help customize the response. ## Request headers |
v1.0 | Intune Shared Deviceappmanagement Syncmicrosoftstoreforbusinessapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-deviceappmanagement-syncmicrosoftstoreforbusinessapps.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. Syncs Intune account with Microsoft Store For Business+ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions |
v1.0 | Intune Shared Deviceappmanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-deviceappmanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. Update the properties of a [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object.+ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions The following table shows the properties that are required when you create the [ |microsoftStoreForBusinessLastSuccessfulSyncDateTime|DateTimeOffset|The last time the apps from the Microsoft Store for Business were synced successfully for the account.| |microsoftStoreForBusinessPortalSelection|[microsoftStoreForBusinessPortalSelectionOptions](../resources/intune-onboarding-microsoftstoreforbusinessportalselectionoptions.md)|The end user portal information is used to sync applications from the Microsoft Store for Business to Intune Company Portal. There are three options to pick from \['Company portal only', 'Company portal and private store', 'Private store only'\]. Possible values are: `none`, `companyPortal`, `privateStore`.| -This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. +This method supports the [OData Query Parameters](https://developer.microsoft.com/graph/docs/concepts/query_parameters) to help customize the response. ## Response If successful, this method returns a `200 OK` response code and an updated [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object in the response body. |
v1.0 | Intune Shared Devicecategory Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-devicecategory-delete.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. Deletes a [deviceCategory](../resources/intune-shared-devicecategory.md).+ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions |
v1.0 | Intune Shared Devicecategory Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-devicecategory-get.md | GET /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceR ## Optional query parameters -This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. +This method supports the [OData Query Parameters](https://developer.microsoft.com/graph/docs/concepts/query_parameters) to help customize the response. ## Request headers |
v1.0 | Intune Shared Devicecategory List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-devicecategory-list.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. List properties and relationships of the [deviceCategory](../resources/intune-shared-devicecategory.md) objects.+ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions |
v1.0 | Intune Shared Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-devicemanagement-get.md | GET /deviceManagement ## Optional query parameters -This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. +This method supports the [OData Query Parameters](https://developer.microsoft.com/graph/docs/concepts/query_parameters) to help customize the response. ## Request headers |Header|Value| |
v1.0 | Intune Shared Devicemanagement Getassignedroleidsforloggedinuser | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-devicemanagement-getassignedroleidsforloggedinuser.md | Content-Length: 263 ] } }-``` +``` |
v1.0 | Intune Shared Devicemanagement Getrolescopetagsbyids | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-devicemanagement-getrolescopetagsbyids.md | Content-Length: 231 } ] }-``` +``` |
v1.0 | Intune Shared Devicemanagement Getrolescopetagsbyresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-devicemanagement-getrolescopetagsbyresource.md | Content-Length: 231 } ] }-``` +``` |
v1.0 | Intune Shared Devicemanagement Verifywindowsenrollmentautodiscovery | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-devicemanagement-verifywindowsenrollmentautodiscovery.md | Content-Length: 21 { "value": true }-``` +``` |
v1.0 | Intune Shared Mobileapp Getmobileappcount | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-mobileapp-getmobileappcount.md | Content-Length: 18 { "value": 1 }-``` +``` |
v1.0 | Intune Shared Mobileapp Getrelatedappstates | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-mobileapp-getrelatedappstates.md | Content-Length: 481 } ] }-``` +``` |
v1.0 | Intune Shared Mobileapp Gettopmobileapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-mobileapp-gettopmobileapps.md | Content-Length: 1013 } ] }-``` +``` |
v1.0 | Intune Shared Reportroot Deviceconfigurationdeviceactivity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-reportroot-deviceconfigurationdeviceactivity.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. Metadata for the device configuration device activity report+ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions |
v1.0 | Intune Shared Reportroot Deviceconfigurationuseractivity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-reportroot-deviceconfigurationuseractivity.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. Metadata for the device configuration user activity report+ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions |
v1.0 | Intune Shared Reportroot Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-reportroot-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. Read properties and relationships of the [reportRoot](../resources/intune-shared-reportroot.md) object.+ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions GET /reports ``` ## Optional query parameters-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. +This method supports the [OData Query Parameters](https://developer.microsoft.com/graph/docs/concepts/query_parameters) to help customize the response. ## Request headers |Header|Value| |:|:| |
v1.0 | Intune Shared Reportroot Manageddeviceenrollmentabandonmentdetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-reportroot-manageddeviceenrollmentabandonmentdetails.md | Content-Length: 123 "content": "<Unknown Primitive Type Edm.Stream>" } }-``` +``` |
v1.0 | Intune Shared Reportroot Manageddeviceenrollmentabandonmentsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-reportroot-manageddeviceenrollmentabandonmentsummary.md | Content-Length: 123 "content": "<Unknown Primitive Type Edm.Stream>" } }-``` +``` |
v1.0 | Intune Shared Reportroot Manageddeviceenrollmentfailuretrends | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-reportroot-manageddeviceenrollmentfailuretrends.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. Metadata for the enrollment failure trends report+ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions |
v1.0 | Intune Shared Reportroot Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-reportroot-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. Update the properties of a [reportRoot](../resources/intune-shared-reportroot.md) object.+ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions |
v1.0 | Intune Shared User Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-user-delete.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. Deletes a [user](../resources/intune-shared-user.md).+ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions |
v1.0 | Intune Shared User Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-user-get.md | GET /users/{usersId} ## Optional query parameters -This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. +This method supports the [OData Query Parameters](https://developer.microsoft.com/graph/docs/concepts/query_parameters) to help customize the response. ## Request headers |
v1.0 | Intune Shared User Getmanagedappdiagnosticstatuses | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-user-getmanagedappdiagnosticstatuses.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. Gets diagnostics validation status for a given user.+ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions |
v1.0 | Intune Shared User Getmanageddeviceswithappfailures | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-user-getmanageddeviceswithappfailures.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. Retrieves the list of devices with failed apps+ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions |
v1.0 | Intune Shared User Removealldevicesfrommanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-user-removealldevicesfrommanagement.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. Retire all devices from management for this user+ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions |
v1.0 | Intune Shared Windowsdomainjoinconfiguration Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-windowsdomainjoinconfiguration-create.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. Create a new [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object.+ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions |
v1.0 | Intune Shared Windowsdomainjoinconfiguration Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-windowsdomainjoinconfiguration-delete.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. Deletes a [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md).+ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions |
v1.0 | Intune Shared Windowsdomainjoinconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-windowsdomainjoinconfiguration-get.md | GET /deviceManagement/windowsAutopilotDeviceIdentities/{windowsAutopilotDeviceId ## Optional query parameters -This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. +This method supports the [OData Query Parameters](https://developer.microsoft.com/graph/docs/concepts/query_parameters) to help customize the response. ## Request headers |
v1.0 | Intune Shared Windowsdomainjoinconfiguration List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-windowsdomainjoinconfiguration-list.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. List properties and relationships of the [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) objects.+ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions |
v1.0 | Intune Shared Windowsdomainjoinconfiguration Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-windowsdomainjoinconfiguration-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. Update the properties of a [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object.+ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions |
v1.0 | Intune Shared Windowsupdatestate Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-windowsupdatestate-create.md | Content-Length: 553 "lastScanDateTime": "2016-12-31T23:59:18.0955018-08:00", "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00" }-``` +``` |
v1.0 | Intune Shared Windowsupdatestate Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-windowsupdatestate-delete.md | DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Shared Windowsupdatestate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-windowsupdatestate-get.md | Content-Length: 594 "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00" } }-``` +``` |
v1.0 | Intune Shared Windowsupdatestate List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-windowsupdatestate-list.md | Content-Length: 630 } ] }-``` +``` |
v1.0 | Intune Shared Windowsupdatestate Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-shared-windowsupdatestate-update.md | Content-Length: 553 "lastScanDateTime": "2016-12-31T23:59:18.0955018-08:00", "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00" }-``` +``` |
v1.0 | Intune Softwareupdate Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-softwareupdate-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-softwareupdate-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-softwareupdate-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Softwareupdate Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-softwareupdate-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-softwareupdate-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-softwareupdate-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-softwareupdate-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-softwareupdate-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Troubleshooting Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-troubleshooting-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-troubleshooting-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-troubleshooting-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Troubleshooting Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-troubleshooting-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-troubleshooting-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-troubleshooting-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-troubleshooting-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-troubleshooting-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Troubleshooting Mobileapptroubleshootingevent Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-troubleshooting-mobileapptroubleshootingevent-create.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Create a new [mobileAppTroubleshootingEvent](../resources/intune-troubleshooting-mobileapptroubleshootingevent.md) object. +Create a new [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] The following table shows the properties that are required when you create the m ## Response-If successful, this method returns a `201 Created` response code and a [mobileAppTroubleshootingEvent](../resources/intune-troubleshooting-mobileapptroubleshootingevent.md) object in the response body. +If successful, this method returns a `201 Created` response code and a [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) object in the response body. ## Example |
v1.0 | Intune Troubleshooting Mobileapptroubleshootingevent Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-troubleshooting-mobileapptroubleshootingevent-delete.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Deletes a [mobileAppTroubleshootingEvent](../resources/intune-troubleshooting-mobileapptroubleshootingevent.md). +Deletes a [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] |
v1.0 | Intune Troubleshooting Mobileapptroubleshootingevent Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-troubleshooting-mobileapptroubleshootingevent-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [mobileAppTroubleshootingEvent](../resources/intune-troubleshooting-mobileapptroubleshootingevent.md) object. +Read properties and relationships of the [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [mobileAppTroubleshootingEvent](../resources/intune-troubleshooting-mobileapptroubleshootingevent.md) object in the response body. +If successful, this method returns a `200 OK` response code and [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) object in the response body. ## Example |
v1.0 | Intune Troubleshooting Mobileapptroubleshootingevent List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-troubleshooting-mobileapptroubleshootingevent-list.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -List properties and relationships of the [mobileAppTroubleshootingEvent](../resources/intune-troubleshooting-mobileapptroubleshootingevent.md) objects. +List properties and relationships of the [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) objects. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] GET /users/{usersId}/mobileAppTroubleshootingEvents Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and a collection of [mobileAppTroubleshootingEvent](../resources/intune-troubleshooting-mobileapptroubleshootingevent.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) objects in the response body. ## Example |
v1.0 | Intune Troubleshooting Mobileapptroubleshootingevent Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-troubleshooting-mobileapptroubleshootingevent-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [mobileAppTroubleshootingEvent](../resources/intune-troubleshooting-mobileapptroubleshootingevent.md) object. +Update the properties of a [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /users/{usersId}/mobileAppTroubleshootingEvents/{mobileAppTroubleshootingE |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [mobileAppTroubleshootingEvent](../resources/intune-troubleshooting-mobileapptroubleshootingevent.md) object. +In the request body, supply a JSON representation for the [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) object. -The following table shows the properties that are required when you create the [mobileAppTroubleshootingEvent](../resources/intune-troubleshooting-mobileapptroubleshootingevent.md). +The following table shows the properties that are required when you create the [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [mobileAppTroubleshootingEvent](../resources/intune-troubleshooting-mobileapptroubleshootingevent.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) object in the response body. ## Example |
v1.0 | Intune Troubleshooting Reportroot Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-troubleshooting-reportroot-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [reportRoot](../resources/intune-troubleshooting-reportroot.md) object. +Read properties and relationships of the [reportRoot](../resources/intune-shared-reportroot.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [reportRoot](../resources/intune-troubleshooting-reportroot.md) object in the response body. +If successful, this method returns a `200 OK` response code and [reportRoot](../resources/intune-shared-reportroot.md) object in the response body. ## Example |
v1.0 | Intune Troubleshooting Reportroot Manageddeviceenrollmentabandonmentdetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-troubleshooting-reportroot-manageddeviceenrollmentabandonmentdetails.md | The following table shows the parameters that can be used with this function. ## Response-If successful, this function returns a `200 OK` response code and a [report](../resources/intune-troubleshooting-report.md) in the response body. +If successful, this function returns a `200 OK` response code and a [report](../resources/intune-shared-report.md) in the response body. ## Example Content-Length: 136 "content": "Y29udGVudCBJbnR1bmUgRG9jIFNhbXBsZSAxNTYxOTcwNjY1" } }-``` +``` |
v1.0 | Intune Troubleshooting Reportroot Manageddeviceenrollmentabandonmentsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-troubleshooting-reportroot-manageddeviceenrollmentabandonmentsummary.md | The following table shows the parameters that can be used with this function. ## Response-If successful, this function returns a `200 OK` response code and a [report](../resources/intune-troubleshooting-report.md) in the response body. +If successful, this function returns a `200 OK` response code and a [report](../resources/intune-shared-report.md) in the response body. ## Example Content-Length: 136 "content": "Y29udGVudCBJbnR1bmUgRG9jIFNhbXBsZSAxNTYxOTcwNjY1" } }-``` +``` |
v1.0 | Intune Troubleshooting Reportroot Manageddeviceenrollmentfailuredetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-troubleshooting-reportroot-manageddeviceenrollmentfailuredetails.md | The following table shows the parameters that can be used with this function. ## Response-If successful, this function returns a `200 OK` response code and a [report](../resources/intune-troubleshooting-report.md) in the response body. +If successful, this function returns a `200 OK` response code and a [report](../resources/intune-shared-report.md) in the response body. ## Example |
v1.0 | Intune Troubleshooting Reportroot Manageddeviceenrollmentfailuretrends | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-troubleshooting-reportroot-manageddeviceenrollmentfailuretrends.md | GET /reports/managedDeviceEnrollmentFailureTrends Do not supply a request body for this method. ## Response-If successful, this function returns a `200 OK` response code and a [report](../resources/intune-troubleshooting-report.md) in the response body. +If successful, this function returns a `200 OK` response code and a [report](../resources/intune-shared-report.md) in the response body. ## Example |
v1.0 | Intune Troubleshooting Reportroot Manageddeviceenrollmenttopfailures | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-troubleshooting-reportroot-manageddeviceenrollmenttopfailures.md | The following table shows the parameters that can be used with this function. ## Response-If successful, this function returns a `200 OK` response code and a [report](../resources/intune-troubleshooting-report.md) in the response body. +If successful, this function returns a `200 OK` response code and a [report](../resources/intune-shared-report.md) in the response body. ## Example |
v1.0 | Intune Troubleshooting Reportroot Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-troubleshooting-reportroot-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [reportRoot](../resources/intune-troubleshooting-reportroot.md) object. +Update the properties of a [reportRoot](../resources/intune-shared-reportroot.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /reports |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [reportRoot](../resources/intune-troubleshooting-reportroot.md) object. +In the request body, supply a JSON representation for the [reportRoot](../resources/intune-shared-reportroot.md) object. -The following table shows the properties that are required when you create the [reportRoot](../resources/intune-troubleshooting-reportroot.md). +The following table shows the properties that are required when you create the [reportRoot](../resources/intune-shared-reportroot.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [reportRoot](../resources/intune-troubleshooting-reportroot.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [reportRoot](../resources/intune-shared-reportroot.md) object in the response body. ## Example |
v1.0 | Intune Troubleshooting User Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-troubleshooting-user-create.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Create a new [user](../resources/intune-troubleshooting-user.md) object. +Create a new [user](../resources/intune-shared-user.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] The following table shows the properties that are required when you create the u ## Response-If successful, this method returns a `201 Created` response code and a [user](../resources/intune-troubleshooting-user.md) object in the response body. +If successful, this method returns a `201 Created` response code and a [user](../resources/intune-shared-user.md) object in the response body. ## Example |
v1.0 | Intune Troubleshooting User Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-troubleshooting-user-delete.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Deletes a [user](../resources/intune-troubleshooting-user.md). +Deletes a [user](../resources/intune-shared-user.md). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] |
v1.0 | Intune Troubleshooting User Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-troubleshooting-user-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [user](../resources/intune-troubleshooting-user.md) object. +Read properties and relationships of the [user](../resources/intune-shared-user.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [user](../resources/intune-troubleshooting-user.md) object in the response body. +If successful, this method returns a `200 OK` response code and [user](../resources/intune-shared-user.md) object in the response body. ## Example |
v1.0 | Intune Troubleshooting User List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-troubleshooting-user-list.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -List properties and relationships of the [user](../resources/intune-troubleshooting-user.md) objects. +List properties and relationships of the [user](../resources/intune-shared-user.md) objects. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] GET /users Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and a collection of [user](../resources/intune-troubleshooting-user.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [user](../resources/intune-shared-user.md) objects in the response body. ## Example |
v1.0 | Intune Troubleshooting User Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-troubleshooting-user-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [user](../resources/intune-troubleshooting-user.md) object. +Update the properties of a [user](../resources/intune-shared-user.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /users/{usersId} |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [user](../resources/intune-troubleshooting-user.md) object. +In the request body, supply a JSON representation for the [user](../resources/intune-shared-user.md) object. -The following table shows the properties that are required when you create the [user](../resources/intune-troubleshooting-user.md). +The following table shows the properties that are required when you create the [user](../resources/intune-shared-user.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [user](../resources/intune-troubleshooting-user.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [user](../resources/intune-shared-user.md) object in the response body. ## Example |
v1.0 | Intune Unlock Deviceappmanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-deviceappmanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceAppManagement](../resources/intune-unlock-deviceappmanagement.md) object. +Read properties and relationships of the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceAppManagement](../resources/intune-unlock-deviceappmanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object in the response body. ## Example |
v1.0 | Intune Unlock Deviceappmanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-deviceappmanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceAppManagement](../resources/intune-unlock-deviceappmanagement.md) object. +Update the properties of a [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceAppManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceAppManagement](../resources/intune-unlock-deviceappmanagement.md) object. +In the request body, supply a JSON representation for the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object. -The following table shows the properties that are required when you create the [deviceAppManagement](../resources/intune-unlock-deviceappmanagement.md). +The following table shows the properties that are required when you create the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceAppManagement](../resources/intune-unlock-deviceappmanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object in the response body. ## Example |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicy Assign | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy-assign.md | Namespace: microsoft.graph ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicy Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy-create.md | Namespace: microsoft.graph Create a new [windowsDefenderApplicationControlSupplementalPolicy](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicy Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy-delete.md | Namespace: microsoft.graph Deletes a [windowsDefenderApplicationControlSupplementalPolicy](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicy Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy-get.md | Namespace: microsoft.graph Read properties and relationships of the [windowsDefenderApplicationControlSupplementalPolicy](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicy List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy-list.md | Namespace: microsoft.graph List properties and relationships of the [windowsDefenderApplicationControlSupplementalPolicy](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicy Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy-update.md | Namespace: microsoft.graph Update the properties of a [windowsDefenderApplicationControlSupplementalPolicy](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicyassignment Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicyassignment-create.md | Namespace: microsoft.graph Create a new [windowsDefenderApplicationControlSupplementalPolicyAssignment](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicyassignment.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicyassignment Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicyassignment-delete.md | Namespace: microsoft.graph Deletes a [windowsDefenderApplicationControlSupplementalPolicyAssignment](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicyassignment.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicyassignment Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicyassignment-get.md | Namespace: microsoft.graph Read properties and relationships of the [windowsDefenderApplicationControlSupplementalPolicyAssignment](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicyassignment.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicyassignment List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicyassignment-list.md | Namespace: microsoft.graph List properties and relationships of the [windowsDefenderApplicationControlSupplementalPolicyAssignment](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicyassignment.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicyassignment Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicyassignment-update.md | Namespace: microsoft.graph Update the properties of a [windowsDefenderApplicationControlSupplementalPolicyAssignment](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicyassignment.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus-create.md | Namespace: microsoft.graph Create a new [windowsDefenderApplicationControlSupplementalPolicyDeploymentStatus](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus-delete.md | Namespace: microsoft.graph Deletes a [windowsDefenderApplicationControlSupplementalPolicyDeploymentStatus](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus-get.md | Namespace: microsoft.graph Read properties and relationships of the [windowsDefenderApplicationControlSupplementalPolicyDeploymentStatus](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus-list.md | Namespace: microsoft.graph List properties and relationships of the [windowsDefenderApplicationControlSupplementalPolicyDeploymentStatus](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus-update.md | Namespace: microsoft.graph Update the properties of a [windowsDefenderApplicationControlSupplementalPolicyDeploymentStatus](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicydeploymentsummary Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentsummary-get.md | Namespace: microsoft.graph Read properties and relationships of the [windowsDefenderApplicationControlSupplementalPolicyDeploymentSummary](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentsummary.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicydeploymentsummary Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentsummary-update.md | Namespace: microsoft.graph Update the properties of a [windowsDefenderApplicationControlSupplementalPolicyDeploymentSummary](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentsummary.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Wip Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-wip-devicemanagement-get.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Read properties and relationships of the [deviceManagement](../resources/intune-wip-devicemanagement.md) object. +Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] This method supports the [OData Query Parameters](/graph/query-parameters) to he Do not supply a request body for this method. ## Response-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-wip-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Intune Wip Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-wip-devicemanagement-update.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Update the properties of a [deviceManagement](../resources/intune-wip-devicemanagement.md) object. +Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] PATCH /deviceManagement |Accept|application/json| ## Request body-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-wip-devicemanagement.md) object. +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object. -The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-wip-devicemanagement.md). +The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md). |Property|Type|Description| |:|:|:| The following table shows the properties that are required when you create the [ ## Response-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-wip-devicemanagement.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body. ## Example |
v1.0 | Itemanalytics Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/itemanalytics-get.md | GET /sites/{site-id}/analytics GET /sites/{site-id}/lists/{list-id}/items/{item-id}/analytics ``` +> [!NOTE] +> The value for `{item-id}` in the `/sites/{site-id}/lists/{list-id}/items/{item-id}` request is the `listItemUniqueId`. To get the `listItemUniqueId` of an item, call the `/sites/{site-id}/lists/{list-id}/items/{item-id}?$select=sharepointIds` endpoint. For details, see [sharePointIds](/graph/api/resources/sharepointids). + ## Optional query parameters This method supports the [OData query parameters](/graph/query-parameters) to help customize the response. |
v1.0 | Learningcontent Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/learningcontent-get.md | Content-type: application/json "numberOfPages": 10, "duration": "PT20M", "format": "Book",+ "level": "Beginner", "createdDateTime": "2018-01-01T00:00:00", "lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z", "contributors": [ Content-type: application/json "numberOfPages": 10, "duration": "PT20M", "format": "Book",+ "level": "Beginner", "createdDateTime": "2018-01-01T00:00:00", "lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z", "contributors": [ |
v1.0 | Learningcontent Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/learningcontent-update.md | PATCH /employeeExperience/learningProviders/{learningProviderId}/learningContent |duration|Duration|The duration of the learning content in seconds. The value is represented in ISO 8601 format for durations. Optional.| |externalId|String|Unique external content ID for the learning content. Required.| |format|String|The format of the learning content. For example, `Course`, `Video`, `Book`, `Book Summary`, `Audiobook Summary`. Optional.|+|level|Level|The difficulty level of the learning content. Possible values are: `Beginner`, `Intermediate`, `Advanced`. Optional.| |isActive|Boolean|Indicates whether the content is active or not. Inactive content doesn't show up in the UI. The default value is `true`. Optional.| |isPremium|Boolean|Indicates whether the learning content requires the user to sign-in on the learning provider platform or not. The default value is `false`. Optional.| |isSearchable|Boolean|Indicates whether the learning content is searchable or not. The default value is `true`. Optional.| Content-Type: application/json "numberOfPages": 9, "duration": "PT20M", "format": "Book",+ "level": "Beginner", "createdDateTime": "2018-01-01T00:00:00Z", "lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z", "contributors": ["Scott Simpson"], Content-Type: application/json "numberOfPages": 9, "duration": "PT20M", "format": "Book",+ "level": "Beginner", "createdDateTime": "2018-01-01T00:00:00", "lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z", "contributors": [ Content-Type: application/json "numberOfPages": 9, "duration": "PT20M", "format": "Book",+ "level": "Beginner", "createdDateTime": "2018-01-01T00:00:00", "lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z", "contributor": "Scott Simpson", Content-Type: application/json "numberOfPages": 9, "duration": "PT20M", "format": "Book",+ "level": "Beginner", "createdDateTime": "2018-01-01T00:00:00", "lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z", "contributors": [ |
v1.0 | Learningprovider List Learningcontents | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/learningprovider-list-learningcontents.md | Content-type: application/json { "@odata.context": "https://graph.microsoft.com/beta/$metadata#learningProviders('13727311-e7bb-470d-8b20-6a23d9030d70')/learningContents",+ "@odata.nextLink": "https://graph.microsoft.com/beta/$metadata#learningProviders('13727311-e7bb-470d-8b20-6a23d9030d70')/learningContents?skip=2&top=2", + "@odata.count": 10, "value": [ { "id": "99029577-a660-46b6-ba58-3ce4d21d5f50", |
v1.0 | Listitem Delta | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/listitem-delta.md | description: "Get newly created, updated, or deleted list items without having to perform a full read of the entire items collection." Title: "lisItem: delta" + Title: "listItem: delta" ms.localizationpriority: "medium" doc_type: apiPageType + # listItem: delta Namespace: microsoft.graph Your app begins by calling `delta` without any parameters. The service starts enumerating the hierarchy of the list, returning pages of items, and either an **@odata.nextLink** or an **@odata.deltaLink**. Your app should continue calling with the **@odata.nextLink** until you see an **@odata.deltaLink** returned. -After you have received all the changes, you might apply them to your local state. +After you received all the changes, you can apply them to your local state. To check for changes in the future, call `delta` again with the **@odata.deltaLink** from the previous response. -The delta feed shows the latest state for each item, not each change. If an item were renamed twice, it will only show up once, with its latest name. +The delta feed shows the latest state for each item, not each change. If an item was renamed twice, it only shows up once, with its latest name. The same item might appear more than once in a delta feed, for various reasons. You should use the last occurrence you see. -Deleted items are returned with the [deleted facet](../resources/deleted.md). Deleted indicates that the item is deleted and cannot be restored. +Deleted items are returned with the [deleted](../resources/deleted.md) facet. `Deleted` indicates that the item is deleted and can't be restored. Items with this property should be removed from your local state. > **Note:** You should only delete a folder locally if it's empty after syncing all the changes. In the request URL, you can include the following optional query parameter. | Parameter | Type | Description | |:-|:-|:-|-| token | string | Optional. If unspecified, enumerates the current state of the hierarchy. If `latest`, returns an empty response with the latest delta token. If a previous delta token, returns a new state since that token.| +| token | String | If unspecified, enumerates the current state of the hierarchy. If `latest`, returns an empty response with the latest delta token. If a previous delta token, returns a new state since that token.| -This method supports the `$select`, `$expand`, and `$top` [OData query parameters](/graph/query-parameters) to customize the response. +This method also supports the `$select`, `$expand`, and `$top` [OData query parameters](/graph/query-parameters) to customize the response. ## Request headers Don't supply a request body for this method. If successful, this method returns a `200 OK` response code and a collection of [listItem](../resources/listitem.md) objects in the response body. -In addition to a collection of **listItem** objects, the response will also include one of the following properties. +In addition to a collection of **listItem** objects, the response also includes one of the following properties. -| Name | Value | Description | -|:|:-|:-| -| **@odata.nextLink** | URL | A URL to retrieve the next available page of changes, if there are additional changes in the current set. | -| **@odata.deltaLink** | URL | A URL returned instead of **@odata.nextLink** after all current changes have been returned. Used to read the next set of changes in the future. | +| Name | Value | Description | +|:--|:-|:-| +| @odata.nextLink | URL | A URL to retrieve the next available page of changes, if there are more changes in the current set. | +| @odata.deltaLink | URL | A URL returned instead of **@odata.nextLink** after all current changes have been returned. Use this property to read the next set of changes in the future. | -In some cases, the service will return a `410 Gone` response code with an error response that contains one of the following error codes, and a `Location` header containing a new `nextLink` that starts a fresh delta enumeration. This occurs when the service can't provide a list of changes for a given token (for example, if a client tries to reuse an old token after being disconnected for a long time, or if the server state has changed and a new token is required). +In some cases, the service returns a `410 Gone` response code with an error response that contains one of the following error codes, and a `Location` header that contains a new `nextLink` that starts a fresh delta enumeration. This occurs when the service can't provide a list of changes for a given token; for example, if a client tries to reuse an old token after being disconnected for a long time, or if the server state has changed and a new token is required. After the full enumeration is completed, compare the returned items with your local state and follow the instructions based on the error type. | Error type | Instructions | |:|:-|-| `resyncChangesApplyDifferences` | Replace any local items with the versions from the server (including deletes) if you're sure that the service was up to date with your local changes when you last synchronized. Upload any local changes that the server doesn't know about. | -| `resyncChangesUploadDifferences` | Upload any local items that the service did not return, and upload any items that differ from the versions from the server (keep both copies if you're not sure which one is more up-to-date). | +| `resyncChangesApplyDifferences` | Replace any local items with the versions from the server (including deletes) if you're sure that the service was up-to-date with your local changes when you last synchronized. Upload any local changes that the server doesn't know about. | +| `resyncChangesUploadDifferences` | Upload any local items that the service didn't return and upload any items that differ from the versions from the server. Keep both copies if you're not sure which one is more up-to-date. | -In addition to the resync errors and for more details about how errors are returned, see [Microsoft Graph error responses and resource types][error-response]. +In addition to the resync errors and for more details about how errors are returned, see [Microsoft Graph error responses and resource types](/graph/errors). ## Examples ### Example 1: Initial request -The following is an example of the initial request that shows how to call this API to establish your local state. +The following example shows an initial request and how to call this API to establish your local state. #### Request -The following is an example of the initial request. -+The following example shows an initial request. # [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_listItem_delta_first", "sampleKeys": ["contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE", "22e03ef3-6ef4-424d-a1d3-92a337807c30"] } --> GET https://graph.microsoft.com/beta/sites/contoso.sharepoint.com,2C712604-1370- #### Response -The following is an example of the response that includes the first page of changes and the **@odata.nextLink** property that indicates that no more items are available in the current set of items. Your app should continue to request the URL value of **@odata.nextLink** until all pages of items have been retrieved. +The following example shows the response that includes the first page of changes and the **@odata.nextLink** property that indicates that no more items are available in the current set of items. Your app should continue to request the URL value of **@odata.nextLink** until all pages of items have been retrieved. -<!-- { "blockType": "response", "name": "get_listItem_delta_first", "@odata.type": "microsoft.graph.listItem", "isCollection": true, "truncated": true, "scope": "site.read" } --> +<!-- { "blockType": "response", "name": "get_listItem_delta_first", "@odata.type": "Collection(microsoft.graph.listItem)", "truncated": true, "scope": "site.read" } --> ```http HTTP/1.1 200 OK Content-type: application/json {- "value": [ - { - "createdDateTime": "2020-06-02T22:46:58Z", - "eTag": "\"{12AD05BB-59B8-43AA-9456-77C44E9BC066},756\"", - "id": "1", - "lastModifiedDateTime": "2021-10-14T23:27:27Z", - "webUrl": "http://contoso.sharepoint.com/Shared%20Documents/TestFolder", - "createdBy": { - "user": { - "displayName": "John doe", - } - }, - "parentReference": { - "id": "1", - "path": "Shared%20Documents", - "siteId": "12AD05BB-59B8-43AA-9456-77C44E9BC066" - }, - "contentType": { - "id": "0x00123456789abc", - "name": "Folder" - } - }, - { - "createdDateTime": "2020-06-02T22:46:58Z", - "eTag": "\"{12AD05BB-59B8-43AA-9456-77C44E9BC067},756\"", - "id": "2", - "lastModifiedDateTime": "2021-10-14T23:27:27Z", - "webUrl": "http://contoso.sharepoint.com/Shared%20Documents/TestItemA.txt", - "createdBy": { - "user": { - "displayName": "John doe", - } - }, - "parentReference": { - "id": "2", - "path": "Shared%20Documents", - "siteId": "12AD05BB-59B8-43AA-9456-77C44E9BC066" - }, - "contentType": { - "id": "0x00123456789abc", - "name": "Document" - } - }, - { - "createdDateTime": "2020-06-02T22:46:58Z", - "eTag": "\"{12AD05BB-59B8-43AA-9456-77C44E9BC068},756\"", - "id": "3", - "lastModifiedDateTime": "2021-10-14T23:27:27Z", - "webUrl": "http://contoso.sharepoint.com/Shared%20Documents/TestItemB.txt", - "createdBy": { - "user": { - "displayName": "John doe", - } - }, - "parentReference": { - "id": "3", - "path": "Shared%20Documents", - "siteId": "12AD05BB-59B8-43AA-9456-77C44E9BC066" - }, - "contentType": { - "id": "0x00123456789abc", - "name": "Document" - } + "value": [ + { + "createdDateTime": "2020-06-02T22:46:58Z", + "eTag": "\"{12AD05BB-59B8-43AA-9456-77C44E9BC066},756\"", + "id": "1", + "lastModifiedDateTime": "2021-10-14T23:27:27Z", + "webUrl": "http://contoso.sharepoint.com/Shared%20Documents/TestFolder", + "createdBy": { + "user": { + "displayName": "John doe" + } + }, + "parentReference": { + "id": "1", + "path": "Shared%20Documents", + "siteId": "12AD05BB-59B8-43AA-9456-77C44E9BC066" + }, + "contentType": { + "id": "0x00123456789abc", + "name": "Folder" + } + }, + { + "createdDateTime": "2020-06-02T22:46:58Z", + "eTag": "\"{12AD05BB-59B8-43AA-9456-77C44E9BC067},756\"", + "id": "2", + "lastModifiedDateTime": "2021-10-14T23:27:27Z", + "webUrl": "http://contoso.sharepoint.com/Shared%20Documents/TestItemA.txt", + "createdBy": { + "user": { + "displayName": "John doe" + } + }, + "parentReference": { + "id": "2", + "path": "Shared%20Documents", + "siteId": "12AD05BB-59B8-43AA-9456-77C44E9BC066" + }, + "contentType": { + "id": "0x00123456789abc", + "name": "Document" + } + }, + { + "createdDateTime": "2020-06-02T22:46:58Z", + "eTag": "\"{12AD05BB-59B8-43AA-9456-77C44E9BC068},756\"", + "id": "3", + "lastModifiedDateTime": "2021-10-14T23:27:27Z", + "webUrl": "http://contoso.sharepoint.com/Shared%20Documents/TestItemB.txt", + "createdBy": { + "user": { + "displayName": "John doe" }- ], - "@odata.nextLink": "https://graph.microsoft.com/beta/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/22e03ef3-6ef4-424d-a1d3-92a337807c30/items/delta?token=1230919asd190410jlka" + }, + "parentReference": { + "id": "3", + "path": "Shared%20Documents", + "siteId": "12AD05BB-59B8-43AA-9456-77C44E9BC066" + }, + "contentType": { + "id": "0x00123456789abc", + "name": "Document" + } + } + ], + "@odata.nextLink": "https://graph.microsoft.com/beta/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/22e03ef3-6ef4-424d-a1d3-92a337807c30/items/delta?token=1230919asd190410jlka" } ``` The following example shows a request that gets the last page in a set and how t The following example shows a request after the initial request. - # [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get-listItem-delta-last", "sampleKeys": ["contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE","22e03ef3-6ef4-424d-a1d3-92a337807c30"] }--> GET https://graph.microsoft.com/beta/sites/contoso.sharepoint.com,2C712604-1370- #### Response -The following is an example of the response that indicates that the item named `TestItemB.txt` was deleted and the item `TestFolder` was either added or modified between the initial request and this request to update the local state. --The final page of items will include the **@odata.deltaLink** property, which provides the URL that can be used later to retrieve changes since the current set of items. +The following example shows the response that indicates that the item named `TestItemB.txt` was deleted and the item `TestFolder` was either added or modified between the initial request and this request to update the local state. +The final page of items includes the **@odata.deltaLink** property that provides the URL that can be used later to retrieve changes since the current set of items. -<!-- { "blockType": "response", "name": "get-listItem-delta-last", "truncated": true, "@odata.type": "microsoft.graph.listItem", "isCollection": true, "scope": "site.read" } --> +<!-- { "blockType": "response", "name": "get-listItem-delta-last", "truncated": true, "@odata.type": "Collection(microsoft.graph.listItem)", "scope": "site.read" } --> ```http HTTP/1.1 200 OK Content-type: application/json {- "value": [ - { - "createdDateTime": "2020-06-02T22:46:58Z", - "eTag": "\"{12AD05BB-59B8-43AA-9456-77C44E9BC066},756\"", - "id": "1", - "lastModifiedDateTime": "2016-03-21T20:01:37Z", - "webUrl": "http://contoso.sharepoint.com/Shared%20Documents/TestFolder", - "createdBy": { - "user": { - "displayName": "John doe", - } - }, - "parentReference": { - "id": "1", - "path": "Shared%20Documents", - "siteId": "12AD05BB-59B8-43AA-9456-77C44E9BC066" - }, - "contentType": { - "id": "0x00123456789abc", - "name": "Folder" - } - }, - { - "id": "3", - "parentReference": { - "siteId": "12AD05BB-59B8-43AA-9456-77C44E9BC066" - }, - "contentType": { - "id": "0x00123456789abc", - "name": "Document" - }, - "deleted": {"state": "deleted"} + "value": [ + { + "createdDateTime": "2020-06-02T22:46:58Z", + "eTag": "\"{12AD05BB-59B8-43AA-9456-77C44E9BC066},756\"", + "id": "1", + "lastModifiedDateTime": "2016-03-21T20:01:37Z", + "webUrl": "http://contoso.sharepoint.com/Shared%20Documents/TestFolder", + "createdBy": { + "user": { + "displayName": "John doe" }- ], - "@odata.deltaLink": "https://graph.microsoft.com/beta/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/22e03ef3-6ef4-424d-a1d3-92a337807c30/items/delta?token=1230919asd190410jlka" + }, + "parentReference": { + "id": "1", + "path": "Shared%20Documents", + "siteId": "12AD05BB-59B8-43AA-9456-77C44E9BC066" + }, + "contentType": { + "id": "0x00123456789abc", + "name": "Folder" + } + }, + { + "id": "3", + "parentReference": { + "siteId": "12AD05BB-59B8-43AA-9456-77C44E9BC066" + }, + "contentType": { + "id": "0x00123456789abc", + "name": "Document" + }, + "deleted": { + "state": "deleted" + } + } + ], + "@odata.deltaLink": "https://graph.microsoft.com/beta/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/22e03ef3-6ef4-424d-a1d3-92a337807c30/items/delta?token=1230919asd190410jlka" } ``` ### Example 3: Delta link request -In some scenarios, it might be useful to request the current `deltaLink` value without first enumerating all of the items in the list already. This can be useful if your app only wants to know about changes and doesn't need to know about existing items. +In some scenarios, you might want to request the current `deltaLink` value without first enumerating all of the items in the list already. This can be useful if your app only wants to know about changes and doesn't need to know about existing items. To retrieve the latest `deltaLink`, call `delta` with the query string parameter `?token=latest`. #### Request The following example shows a request. - # [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get-delta-latest_datalink_tokenislatest", "scope": "sites.read", "target": "action", "sampleKeys": ["contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE","22e03ef3-6ef4-424d-a1d3-92a337807c30"] } --> ```msgraph-interactive-GET /sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/22e03ef3-6ef4-424d-a1d3-92a337807c30/items/delta?token=latest +GET https://graph.microsoft.com/beta/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/22e03ef3-6ef4-424d-a1d3-92a337807c30/items/delta?token=latest ``` # [C#](#tab/csharp) GET /sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3- The following example shows the response. -<!-- { "blockType": "response", "name": "get-delta-latest_datalink_tokenislatest", "isEmpty": true, "@odata.type": "microsoft.graph.listItem", "isCollection": true } --> +<!-- { "blockType": "response", "name": "get-delta-latest_datalink_tokenislatest", "isEmpty": true, "@odata.type": "Collection(microsoft.graph.listItem)" } --> ```http HTTP/1.1 200 OK Content-type: application/json {- "value": [ ], - "@odata.deltaLink": "https://graph.microsoft.com/beta/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/22e03ef3-6ef4-424d-a1d3-92a337807c30/items/delta?token=1230919asd190410jlka" + "value": [ ], + "@odata.deltaLink": "https://graph.microsoft.com/beta/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/22e03ef3-6ef4-424d-a1d3-92a337807c30/items/delta?token=1230919asd190410jlka" } ``` ## Related content-[Use delta query to track changes in Microsoft Graph data](/graph/delta-query-overview) -[Best practices for discovering files and detecting changes at scale](/onedrive/developer/rest-api/concepts/scan-guidance) -[error-response]: /graph/errors +- [Use delta query to track changes in Microsoft Graph data](/graph/delta-query-overview) +- [Best practices for discovering files and detecting changes at scale](/onedrive/developer/rest-api/concepts/scan-guidance) <!-- { "type": "#page.annotation", |
v1.0 | Mailfolder Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/mailfolder-get.md | This method supports the [OData Query Parameters](/graph/query-parameters) to he ## Request headers -| Name | Type | Description | -|:--|:-|:--| -| Authorization | string | Bearer {token}. Required. | +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Managedtenants Managedtenant List Tenantscustomizedinformation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-tenantscustomizedinformation.md | GET /tenantRelationships/managedTenants/tenantsCustomizedInformation This method supports the [OData query parameters](/graph/query-parameters) to help customize the response, including `$apply`, `$count`, `$filter`, `$orderby`, `$select`, `$skip`, and `$top`. ## Request headers-|Name|Description| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +| 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. Content-Type: application/json "email": "hector@fourthcoffee.com", "phone": "5558009732" }+ ], + "businessRelationship": "Managed", + "complianceRequirements": [ + "NIST", + "HIPPA" + ], + "managedServicesPlans": [ + "Microsoft Entra ID P1" + ], + "note": "This is a test note.", + "noteLastModifiedDateTime": "2024-04-03 00:10:21.1989208", + "partnerRelationshipManagerUserIds": [ + "3c23994c-711b-46f6-ab1e-0aeef19413f3" ] }, { Content-Type: application/json "email": "timothy@consolidatedmessenger.com", "phone": "5558001379" }+ ], + "businessRelationship": "Managed", + "complianceRequirements": [ + "CMMC" + ], + "managedServicesPlans": [ + "Microsoft 365 Business Premium" + ], + "note": "This is another test note", + "noteLastModifiedDateTime": "2024-04-01 18:15:23.00", + "partnerRelationshipManagerUserIds": [ + "8c6881ca-8968-4650-adeb-6ec34180098c" ] } ] |
v1.0 | Meetingattendancereport List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/meetingattendancereport-list.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Get a list of [meetingAttendanceReport](../resources/meetingAttendanceReport.md) objects for an [onlineMeeting](../resources/onlinemeeting.md) or a [virtualEvent](../resources/virtualevent.md). Each time an online meeting ends, an attendance report is generated for that session. +Get a list of [meetingAttendanceReport](../resources/meetingAttendanceReport.md) objects for an [onlineMeeting](../resources/onlinemeeting.md) or a [virtualEvent](../resources/virtualevent.md). Each time an online meeting or a virtual event ends, an attendance report is generated for that session. > [!WARNING] > |
v1.0 | Mobileappmanagementpolicies Delete Includedgroups | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/mobileappmanagementpolicies-delete-includedgroups.md | Namespace: microsoft.graph Delete a group from the list of groups included in a mobile app management policy. ## Permissions DELETE https://graph.microsoft.com/beta/policies/mobileAppManagementPolicies/ab9 [!INCLUDE [sample-code](../includes/snippets/php/delete-group-groupid-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -# [PowerShell](#tab/powershell) - # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-group-groupid-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Mobileappmanagementpolicies Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/mobileappmanagementpolicies-delete.md | Delete a [mobilityManagementPolicy](../resources/mobilitymanagementpolicy.md) ob > [!NOTE] > This operation is only supported when the policy is no longer valid; that is, when the **isValid** property is false, which indicates that the service principal associated with the application for this policy has been deleted. ## Permissions |
v1.0 | Mobileappmanagementpolicies Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/mobileappmanagementpolicies-get.md | Namespace: microsoft.graph Read the properties and relationships of a [mobilityManagementPolicy](../resources/mobilitymanagementpolicy.md) object. ## Permissions |
v1.0 | Mobileappmanagementpolicies List Includedgroups | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/mobileappmanagementpolicies-list-includedgroups.md | Namespace: microsoft.graph Get the list of groups that are included in a mobile app management policy. ## Permissions |
v1.0 | Mobileappmanagementpolicies List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/mobileappmanagementpolicies-list.md | Namespace: microsoft.graph Get a list of the [mobilityManagementPolicy](../resources/mobilitymanagementpolicy.md) objects and their properties. ## Permissions |
v1.0 | Mobileappmanagementpolicies Post Includedgroups | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/mobileappmanagementpolicies-post-includedgroups.md | Namespace: microsoft.graph Add groups to be included in a mobile app management policy. ## 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). |
v1.0 | Mobileappmanagementpolicies Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/mobileappmanagementpolicies-update.md | Namespace: microsoft.graph Update the properties of a [mobilityManagementPolicy](../resources/mobilitymanagementpolicy.md) object. ## Permissions |
v1.0 | Mobiledevicemanagementpolicies Delete Includedgroups | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/mobiledevicemanagementpolicies-delete-includedgroups.md | Namespace: microsoft.graph Delete a group from the list of groups included in a mobile device management policy. ## Permissions DELETE https://graph.microsoft.com/beta/policies/mobileDeviceManagementPolicies/ [!INCLUDE [sample-code](../includes/snippets/php/delete-group-included-groups-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -# [PowerShell](#tab/powershell) - # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-group-included-groups-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Mobiledevicemanagementpolicies Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/mobiledevicemanagementpolicies-delete.md | Delete a [mobilityManagementPolicy](../resources/mobilitymanagementpolicy.md) ob > [!NOTE] > This operation is only supported when the policy is no longer valid; that is, when the **isValid** property is false, which indicates that the service principal associated with the application for this policy has been deleted. ## Permissions |
v1.0 | Mobiledevicemanagementpolicies Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/mobiledevicemanagementpolicies-get.md | Namespace: microsoft.graph Read the properties and relationships of a [mobilityManagementPolicy](../resources/mobilitymanagementpolicy.md) object. ## Permissions |
v1.0 | Mobiledevicemanagementpolicies List Includedgroups | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/mobiledevicemanagementpolicies-list-includedgroups.md | Namespace: microsoft.graph Get the list of groups that are included in a mobile device management policy. ## Permissions |
v1.0 | Mobiledevicemanagementpolicies List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/mobiledevicemanagementpolicies-list.md | Namespace: microsoft.graph Get a list of the [mobilityManagementPolicy](../resources/mobilitymanagementpolicy.md) objects and their properties. ## Permissions |
v1.0 | Mobiledevicemanagementpolicies Post Includedgroups | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/mobiledevicemanagementpolicies-post-includedgroups.md | Namespace: microsoft.graph Add groups to be included in a mobile app management policy. ## Permissions |
v1.0 | Mobiledevicemanagementpolicies Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/mobiledevicemanagementpolicies-update.md | Namespace: microsoft.graph Update the properties of a [mobilityManagementPolicy](../resources/mobilitymanagementpolicy.md) object. ## Permissions |
v1.0 | Monthlyuserinsightmetricsroot List Activeusersbreakdown | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/monthlyuserinsightmetricsroot-list-activeusersbreakdown.md | - Title: "List monthly activeUsersBreakdown (deprecated)" -description: "Get a list of monthly activeUsersBreakdown objects on apps registered in your tenant configured for Microsoft Entra External ID for customers." ---doc_type: apiPageType ---# List monthly activeUsersBreakdown (deprecated) -Namespace: microsoft.graph ---> [!CAUTION] -> This API is deprecated and will stop returning data on March 9, 2024. Use the [List monthly activeUsers](../api/monthlyuserinsightmetricsroot-list-activeusers.md) API instead. --Get a list of monthly [activeUsersBreakdown](../resources/activeusersbreakdownmetric.md) objects on apps registered in your tenant configured for Microsoft Entra External ID for customers. ---## 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": "monthlyuserinsightmetricsroot_list_activeusersbreakdown" } --> ---## HTTP request -<!-- { - "blockType": "ignored" -} >-``` http -GET /reports/userInsights/monthly/activeUsersBreakdown -``` --## Optional query parameters -This method supports the `$filter` OData query parameter 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 [activeUsersBreakdownMetric](../resources/activeusersbreakdownmetric.md) objects in the response body. --## Examples --### Request -The following example shows a request. -# [HTTP](#tab/http) -<!-- { - "blockType": "request", - "name": "list_monthlyctiveusersbreakdownmetric" -} >-``` http -GET https://graph.microsoft.com/beta/reports/userInsights/monthly/activeUsersBreakdown -``` --# [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. ->**Note:** The response object shown here might be shortened for readability. -<!-- { - "blockType": "response", - "truncated": true, - "@odata.type": "Collection(microsoft.graph.activeUsersBreakdownMetric)" -} >-``` http -HTTP/1.1 200 OK -Content-Type: application/json --{ - "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.activeUsersBreakdownMetric)", - "value": [ - { - "id": "2", - "appId": "Groceries API", - "appName": "b97b956d-e881-43b9-9384-5dd684cd7f57", - "count": 3, - "factDate": "2023-07-01", - "os": "Windows" - }, - { - "id": "2", - "appId": "Groceries", - "appName": "10e90284-3cc4-4d82-d641-55ff4068c633", - "count": 9, - "factDate": "2023-07-01", - "os": "MacOs" - } - ] -} -``` |
v1.0 | Multitenantorganization Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/multitenantorganization-update.md | Content-Type: application/json } ``` -# [C#](#tab/csharp) --# [CLI](#tab/cli) --# [Go](#tab/go) --# [Java](#tab/java) - # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/update-multitenantorganization-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -# [PHP](#tab/php) --# [PowerShell](#tab/powershell) --# [Python](#tab/python) - ### Response |
v1.0 | Networkaccess Branchconnectivityconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchconnectivityconfiguration-get.md | Title: "Get branchConnectivityConfiguration" + Title: "Get branchConnectivityConfiguration (deprecated)" description: "Retrieve the IPSec tunnel configuration required to establish a bidirectional communication link between your organization's router and Microsoft's gateway." ms.localizationpriority: medium-# Get branchConnectivityConfiguration +# Get branchConnectivityConfiguration (deprecated) Namespace: microsoft.graph.networkaccess [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] +> [!IMPORTANT] +> Deprecated and to be retired soon. Use the [remoteNetworkConnectivityConfiguration resource type](../resources/networkaccess-remotenetworkconnectivityconfiguration.md) and its associated methods instead. + Retrieve the IPSec tunnel configuration required to establish a bidirectional communication link between your organization's router and the Microsoft gateway. This information is vital for configuring your router (customer premise equipment) after creating a [deviceLink](../resources/networkaccess-devicelink.md). [!INCLUDE [national-cloud-support](../../includes/global-only.md)] |
v1.0 | Networkaccess Branchsite Delete Devicelinks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchsite-delete-devicelinks.md | Title: "Delete deviceLink" -description: "Removes the link between the branch and the CPE device, effectively removing the connection and associated configuration between them." + Title: "Delete deviceLink (deprecated)" +description: "Removes the link between the branch or remote network and the CPE device, effectively removing the connection and associated configuration between them." ms.localizationpriority: medium doc_type: apiPageType -# Delete deviceLink +# Delete deviceLink (deprecated) Namespace: microsoft.graph.networkaccess [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Removes the link between the branch and the CPE device, effectively removing the connection and associated configuration between them. +> [!IMPORTANT] +> Deprecated and to be retired soon. Use the [remoteNetwork resource type](../resources/networkaccess-remotenetwork.md) and its associated methods instead. ++Removes the link between the branch or remote network and the CPE device, effectively removing the connection and associated configuration between them. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] The following example shows a request. # [HTTP](#tab/http) <!-- { "blockType": "request",- "name": "delete_devicelink" + "name": "delete_devicelink_deprecated" } --> ``` http DELETE https://graph.microsoft.com/beta/networkAccess/connectivity/branches/{bra ``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [CLI](#tab/cli) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Branchsite Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchsite-delete.md | Title: "Delete branchSite" + Title: "Delete branchSite (deprecated)" description: "Delete a specific branch." ms.localizationpriority: medium-# Delete branchSite +# Delete branchSite (deprecated) Namespace: microsoft.graph.networkaccess [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] +> [!IMPORTANT] +> Deprecated and to be retired soon. Use the [remoteNetwork resource type](../resources/networkaccess-remotenetwork.md) and its associated methods instead. + Delete a specific branch. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] |
v1.0 | Networkaccess Branchsite Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchsite-get.md | Title: "Get branchSite" + Title: "Get branchSite (deprecated)" description: "Retrieve information about a specific branch." ms.localizationpriority: medium-# Get branchSite +# Get branchSite (deprecated) Namespace: microsoft.graph.networkaccess [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] +> [!IMPORTANT] +> Deprecated and to be retired soon. Use the [remoteNetwork resource type](../resources/networkaccess-remotenetwork.md) and its associated methods instead. + Retrieve information about a specific branch. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] |
v1.0 | Networkaccess Branchsite List Devicelinks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchsite-list-devicelinks.md | Title: "List deviceLinks" + Title: "List deviceLinks (deprecated)" description: "Retrieve a list of device links associated with a specific branch." ms.localizationpriority: medium-# List deviceLinks +# List deviceLinks (deprecated) Namespace: microsoft.graph.networkaccess [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] +> [!IMPORTANT] +> Deprecated and to be retired soon. Use the [remoteNetwork resource type](../resources/networkaccess-remotenetwork.md) and its associated methods instead. + Retrieve a list of device links associated with a specific branch. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] |
v1.0 | Networkaccess Branchsite List Forwardingprofiles | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchsite-list-forwardingprofiles.md | Title: "List forwardingProfiles (for a branch)" + Title: "List forwardingProfiles (deprecated)" description: "Retrieve a list of traffic forwarding profiles associated with a branch." ms.localizationpriority: medium-# List forwardingProfiles (for a branch) +# List forwardingProfiles (deprecated) Namespace: microsoft.graph.networkaccess [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] +> [!IMPORTANT] +> Deprecated and to be retired soon. Use the [remoteNetwork resource type](../resources/networkaccess-remotenetwork.md) and its associated methods instead. + Retrieve a list of traffic forwarding profiles associated with a branch. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] |
v1.0 | Networkaccess Branchsite Post Devicelinks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchsite-post-devicelinks.md | Title: "Create deviceLink" + Title: "Create deviceLink (deprecated)" description: "Create a branch site with associated device links." ms.localizationpriority: medium-# Create deviceLink +# Create deviceLink (deprecated) Namespace: microsoft.graph.networkaccess [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] +> [!IMPORTANT] +> Deprecated and to be retired soon. Use the [remoteNetwork resource type](../resources/networkaccess-remotenetwork.md) and its associated methods instead. + Create a branch site with associated device links. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] |
v1.0 | Networkaccess Branchsite Post Forwardingprofiles | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchsite-post-forwardingprofiles.md | Title: "Assign a forwardingProfile to a branchSite" + Title: "Assign a forwardingProfile (deprecated)" description: "Create a new branch and assign a forwarding profile." ms.localizationpriority: medium-# Create forwardingProfile +# Create forwardingProfile (deprecated) Namespace: microsoft.graph.networkaccess [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] +> [!IMPORTANT] +> Deprecated and to be retired soon. Use the [remoteNetwork resource type](../resources/networkaccess-remotenetwork.md) and its associated methods instead. + Create a new branch and assign a forwarding profile. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] |
v1.0 | Networkaccess Branchsite Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchsite-update.md | Title: "Update branch" + Title: "Update branch (deprecated)" description: "Update the configuration or properties of a specific branch." ms.localizationpriority: medium-# Update branchSite +# Update branchSite (deprecated) Namespace: microsoft.graph.networkaccess [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] +> [!IMPORTANT] +> Deprecated and to be retired soon. Use the [remoteNetwork resource type](../resources/networkaccess-remotenetwork.md) and its associated methods instead. + Update the configuration or properties of a specific branch. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] |
v1.0 | Networkaccess Connectivity Delete Remotenetworks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-connectivity-delete-remotenetworks.md | + + Title: "Delete remoteNetwork" +description: "Delete a specific remote network." ++ms.localizationpriority: medium ++++# Delete remoteNetwork +Namespace: microsoft.graph.networkaccess +++Delete a specific remote network. +++## 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": "networkaccess-connectivity-delete-remotenetworks-permissions" +} +--> +++## HTTP request ++``` http +DELETE /networkAccess/connectivity/remoteNetworks/{remoteNetworkId}/$ref +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request +The following is an example of a request. ++### Response +The following example shows the response. +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` ++ |
v1.0 | Networkaccess Connectivity List Branches | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-connectivity-list-branches.md | Title: "List branches" + Title: "List branches (deprecated)" description: "Retrieve a list of branches within a tenant connected to the Global Secure Access services." ms.localizationpriority: medium-# List branches +# List branches (deprecated) Namespace: microsoft.graph.networkaccess [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] +> [!IMPORTANT] +> Deprecated and to be retired soon. Use the [remoteNetwork resource type](../resources/networkaccess-remotenetwork.md) and its associated methods instead. + Retrieve a list of branches within a tenant connected to the Global Secure Access services. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] |
v1.0 | Networkaccess Connectivity List Remotenetworks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-connectivity-list-remotenetworks.md | + + Title: "List remoteNetworks" +description: "Retrieve a list of remote networks within a tenant connected to the Global Secure Access." ++ms.localizationpriority: medium ++++# List remoteNetworks +Namespace: microsoft.graph.networkaccess +++Retrieve a list of remote networks within a tenant connected to the Global Secure Access services. +++## 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": "networkaccess-connectivity-list-remotenetworks-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /networkAccess/connectivity/remoteNetworks +``` ++## Optional query parameters +This method supports the `$expand` and `$select` 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.| ++## 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 [microsoft.graph.networkaccess.remoteNetwork](../resources/networkaccess-remotenetwork.md) objects in the response body. ++## Examples ++### Request +The following is an example of a request. ++``` http +GET https://graph.microsoft.com/beta/networkAccess/connectivity/remoteNetworks +``` ++### 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.networkaccess.remoteNetwork)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks", + "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET networkAccess/connectivity/remoteNetworks?$select=bandwidthCapacity,connectivityState", + "value": [ + { + "id": "dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04", + "name": "Test branch", + "region": "canadaEast", + "version": "1.0.0", + "lastModifiedDateTime": "2023-12-12T14:26:24Z", + "forwardingProfiles@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks('dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04')/forwardingProfiles", + "forwardingProfiles": [ + { + "trafficForwardingType": "m365", + "priority": 0, + "id": "1adaf535-1e31-4e14-983f-2270408162bf", + "name": "Microsoft 365 traffic forwarding profile", + "description": "Default traffic forwarding profile for Microsoft 365 traffic acquisition. Assign the profile to client or branch offices to acquire Microsoft 365 traffic for Zero Trust Network Access.", + "state": "disabled", + "version": "1.0.0", + "lastModifiedDateTime": "2024-01-22T12:10:49Z", + "associations": [ + { + "@odata.type": "#microsoft.graph.networkaccess.associatedBranch", + "branchId": "9ffbc1a5-2916-4fb4-b277-76cdc89cc491" + }, + { + "@odata.type": "#microsoft.graph.networkaccess.associatedBranch", + "branchId": "dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04" + }, + { + "@odata.type": "#microsoft.graph.networkaccess.associatedBranch", + "branchId": "43c7a0d3-1072-4da1-9e30-e513b02bb559" + }, + { + "@odata.type": "#microsoft.graph.networkaccess.associatedBranch", + "branchId": "4ecfc62c-ec85-42fd-af37-5a93c7deb1d9" + } + ] + } + ], + "deviceLinks@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks('dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04')/deviceLinks", + "deviceLinks": [ + { + "id": "47aab2e9-7f5c-42ba-bbfc-1b049193126a", + "name": "name", + "ipAddress": "1.2.3.1", + "bandwidthCapacityInMbps": "mbps500", + "deviceVendor": "barracudaNetworks", + "lastModifiedDateTime": "2023-12-12T14:26:24Z", + "bgpConfiguration": { + "localIpAddress": "10.1.1.1", + "peerIpAddress": "10.2.2.1", + "asn": 899 + }, + "redundancyConfiguration": { + "zoneLocalIpAddress": null, + "redundancyTier": "noRedundancy" + }, + "tunnelConfiguration": { + "@odata.type": "#microsoft.graph.networkaccess.tunnelConfigurationIKEv2Default", + "preSharedKey": "dcf" + } + } + ] + }, + { + "id": "43c7a0d3-1072-4da1-9e30-e513b02bb559", + "name": "USA branch 1", + "region": "eastUS", + "version": "1.0.0", + "lastModifiedDateTime": "2024-01-17T19:23:32Z", + "forwardingProfiles@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks('43c7a0d3-1072-4da1-9e30-e513b02bb559')/forwardingProfiles", + "forwardingProfiles": [ + { + "trafficForwardingType": "m365", + "priority": 0, + "id": "1adaf535-1e31-4e14-983f-2270408162bf", + "name": "Microsoft 365 traffic forwarding profile", + "description": "Default traffic forwarding profile for Microsoft 365 traffic acquisition. Assign the profile to client or branch offices to acquire Microsoft 365 traffic for Zero Trust Network Access.", + "state": "disabled", + "version": "1.0.0", + "lastModifiedDateTime": "2024-01-22T12:10:49Z", + "associations": [ + { + "@odata.type": "#microsoft.graph.networkaccess.associatedBranch", + "branchId": "9ffbc1a5-2916-4fb4-b277-76cdc89cc491" + }, + { + "@odata.type": "#microsoft.graph.networkaccess.associatedBranch", + "branchId": "dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04" + }, + { + "@odata.type": "#microsoft.graph.networkaccess.associatedBranch", + "branchId": "43c7a0d3-1072-4da1-9e30-e513b02bb559" + }, + { + "@odata.type": "#microsoft.graph.networkaccess.associatedBranch", + "branchId": "4ecfc62c-ec85-42fd-af37-5a93c7deb1d9" + } + ] + } + ], + "deviceLinks@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks('43c7a0d3-1072-4da1-9e30-e513b02bb559')/deviceLinks", + "deviceLinks": [ + { + "id": "6833faf3-b4ea-4cd4-a256-3ee71985e51d", + "name": "Cisco device 1", + "ipAddress": "20.1.1.1", + "bandwidthCapacityInMbps": "mbps1000", + "deviceVendor": "ciscoMeraki", + "lastModifiedDateTime": "2024-01-17T19:23:32Z", + "bgpConfiguration": { + "localIpAddress": "10.1.1.2", + "peerIpAddress": "10.2.2.2", + "asn": 65533 + }, + "redundancyConfiguration": { + "zoneLocalIpAddress": null, + "redundancyTier": "noRedundancy" + }, + "tunnelConfiguration": { + "@odata.type": "#microsoft.graph.networkaccess.tunnelConfigurationIKEv2Default", + "preSharedKey": "test123" + } + } + ] + } + ] +} +``` + |
v1.0 | Networkaccess Connectivity Post Branches | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-connectivity-post-branches.md | Title: "Create branch" + Title: "Create branch (deprecated)" description: "Create a new branch." ms.localizationpriority: medium-# Create branch +# Create branch (deprecated) Namespace: microsoft.graph.networkaccess [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] +> [!IMPORTANT] +> Deprecated and to be retired soon. Use the [remoteNetwork resource type](../resources/networkaccess-remotenetwork.md) and its associated methods instead. + Create a new branch. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] |
v1.0 | Networkaccess Connectivity Post Remotenetworks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-connectivity-post-remotenetworks.md | + + Title: "Create remoteNetwork" +description: "Create a new remote network." ++ms.localizationpriority: medium ++++# Create remoteNetwork +Namespace: microsoft.graph.networkaccess +++Create a new remote network. +++## 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": "networkaccess-connectivity-post-remotenetworks-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /networkAccess/connectivity/remoteNetworks +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [microsoft.graph.networkaccess.remoteNetwork](../resources/networkaccess-remotenetwork.md) object. ++You can specify the following properties when creating a **remote network**. ++|Property|Type|Description| +|:|:|:| +|name|String|Name of the remote network. Required.| +|region|String|Specify the region closest to the remote network location. Required.| +++## Response ++If successful, this method returns a `201 Created` response code and a [microsoft.graph.networkaccess.remoteNetwork](../resources/networkaccess-remotenetwork.md) object in the response body. ++## Example 1: Create a remote network with just name and region ++### Request +The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_remoteNetwork_basic" +} +--> +``` http +POST https://graph.microsoft.com/beta/networkAccess/connectivity/remoteNetworks +Content-Type: application/json ++{ + "name": "Bellevue branch", + "region": "canadaEast" +} +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++++### 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.networkaccess.remoteNetwork" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks/$entity", + "id": "8a273997-b84d-422f-8dec-e1dd82a4035b", + "name": "Bellevue branch", + "region": "canadaEast", + "version": "1.0.0", + "lastModifiedDateTime": "2024-02-01T00:41:48Z" +} +``` ++## Example 2: Create a remote network with forwarding profile +To get the ID of forwarding profiles of your organization, refer to this article - [List forwardingProfiles](networkaccess-networkaccessroot-list-forwardingprofiles.md). ++### Request +The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_remoteNetwork_with_forwardingProfile" +} +--> +``` http +POST https://graph.microsoft.com/beta/networkAccess/connectivity/remoteNetworks +Content-Type: application/json ++{ + "name": "Bellevue branch w/ fwd profile", + "region": "canadaEast", + "forwardingProfiles": [ + { + "id": "1adaf535-1e31-4e14-983f-2270408162bf" + } + ] +} +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++++### 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.networkaccess.remoteNetwork" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks/$entity", + "id": "6542b28c-5ba7-4b50-9576-e63a6210e481", + "name": "Bellevue branch w/ fwd profile", + "region": "canadaEast", + "version": "1.0.0", + "lastModifiedDateTime": "2024-02-01T00:54:45Z" +} +``` ++## Example 3: Create a remote network with device link and forwarding profile +To get the ID of forwarding profiles of your organization, refer to this article - [List forwardingProfiles](networkaccess-networkaccessroot-list-forwardingprofiles.md). ++### Request +The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_remoteNetwork_with_forwardingProfile_deviceLink" +} +--> +``` http +POST https://graph.microsoft.com/beta/networkAccess/connectivity/remoteNetworks +Content-Type: application/json ++{ + "name": "Bellevue branch w/ device link", + "region": "canadaEast", + "forwardingProfiles": [ + { + "id": "1adaf535-1e31-4e14-983f-2270408162bf" + } + ], + "deviceLinks": [ + { + "name": "CPE1", + "ipAddress": "52.13.21.25", + "bandwidthCapacityInMbps": "mbps500", + "deviceVendor": "barracudaNetworks", + "bgpConfiguration": { + "localIpAddress": "192.168.1.2", + "peerIpAddress": "10.1.1.2", + "asn": 65533 + }, + "redundancyConfiguration": { + "zoneLocalIpAddress": null, + "redundancyTier": "noRedundancy" + }, + "tunnelConfiguration": { + "@odata.type": "#microsoft.graph.networkaccess.tunnelConfigurationIKEv2Default", + "preSharedKey": "test123" + } + } + ] +} +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++++### 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.networkaccess.remoteNetwork" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks/$entity", + "id": "5d2f5061-4876-4c1c-ba2d-5acc6a73742d", + "name": "Bellevue branch w/ device link", + "region": "canadaEast", + "version": "1.0.0", + "lastModifiedDateTime": "2024-02-01T01:02:25Z" +} +``` |
v1.0 | Networkaccess Devicelink Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-devicelink-delete.md | + + Title: "Delete deviceLink" +description: "Removes the link between the remote network and the CPE device, effectively removing the connection and associated configuration between them." ++ms.localizationpriority: medium ++++# Delete deviceLink +Namespace: microsoft.graph.networkaccess +++Removes the link between the branch or remote network and the CPE device, effectively removing the connection and associated configuration between them. +++## 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": "networkaccess_devicelink_delete" } --> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /networkAccess/connectivity/remotenetworks/{remoteNetworkId}/deviceLinks/{deviceLinkId} +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request +The following is an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_devicelink" +} +--> +``` http +DELETE https://graph.microsoft.com/beta/networkAccess/connectivity/remoteNetworks/335d3a94-b5a9-41fd-b6dd-ae9a8d31a002/deviceLinks/17cb9017-4a33-424b-85fa-e62ff19531a9 +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++++### Response +The following example shows the response. +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` ++ |
v1.0 | Networkaccess Devicelink Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-devicelink-get.md | Title: "Get deviceLink" -description: "Retrieve the device link associated with a specific branch." -+description: "Retrieve the device link associated with a specific branch or remote network." + ms.localizationpriority: medium doc_type: apiPageType Namespace: microsoft.graph.networkaccess [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Retrieve the device link associated with a specific branch. +Retrieves a specific device link associated with a remote network. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [rbac-global-secure-access-apis-read](../includes/rbac-for-apis/rbac-global-secure-access-apis-read.md)] ## HTTP request-+> [!NOTE] +> The `/branches/{branchSiteId}/...` path will be retired soon. Use the `/remoteNetworks/{remoteNetworkId}/...` path instead. <!-- { "blockType": "ignored" } --> ``` http GET /networkAccess/connectivity/branches/{branchSiteId}/deviceLinks/{deviceLinkId}+GET /networkAccess/connectivity/remoteNetworks/{remoteNetworkId}/deviceLinks/{deviceLinkId} ``` ## Optional query parameters If successful, this method returns a `200 OK` response code and a [microsoft.gra ### Request The following example shows a request.+ # [HTTP](#tab/http) <!-- { "blockType": "request", The following example shows a request. } --> ``` http-GET https://graph.microsoft.com/beta/networkAccess/connectivity/branches/{branchSiteId}/deviceLinks/{deviceLinkId} +GET https://graph.microsoft.com/beta/networkAccess/connectivity/remoteNetworks/dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04/deviceLinks/47aab2e9-7f5c-42ba-bbfc-1b049193126a ``` # [C#](#tab/csharp) HTTP/1.1 200 OK Content-Type: application/json {- "@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/branches('047d69c4-2448-45cc-8c0a-40f3ad93c86c')/deviceLinks/$entity", - "id": "1030ca77-40e9-4cd3-bf71-b5d74c2f3cb0", - "name": "Backup Link", - "ipAddress": "24.123.22.168", - "version": "1.0.0", - "deviceVendor": "checkPoint", - "lastModifiedDateTime": "2023-05-23T09:19:30Z", + "@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks('dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04')/deviceLinks/$entity", + "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET networkAccess/connectivity/remoteNetworks('<guid>')/deviceLinks('<guid>')?$select=bandwidthCapacityInMbps,bgpConfiguration", + "id": "47aab2e9-7f5c-42ba-bbfc-1b049193126a", + "name": "name", + "ipAddress": "1.2.3.1", + "bandwidthCapacityInMbps": "mbps500", + "deviceVendor": "barracudaNetworks", + "lastModifiedDateTime": "2024-01-27T07:09:17Z", "bgpConfiguration": {- "ipAddress": "1.128.24.22", - "asn": 4 + "localIpAddress": "1.2.1.1", + "peerIpAddress": "1.2.3.1", + "asn": 899 + }, + "redundancyConfiguration": { + "zoneLocalIpAddress": null, + "redundancyTier": "noRedundancy" }, "tunnelConfiguration": { "@odata.type": "#microsoft.graph.networkaccess.tunnelConfigurationIKEv2Default",- "preSharedKey": "342342342342342342342342" + "preSharedKey": "dcf" } } ``` |
v1.0 | Networkaccess Devicelink Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-devicelink-update.md | Title: "Update deviceLink" -description: "Update the device link associated with a specific branch." +description: "Update the device link associated with a specific branch or remote network." ms.localizationpriority: medium Namespace: microsoft.graph.networkaccess [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Update the device link associated with a specific branch. +Update the device link associated with a specific branch or remote network. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [rbac-global-secure-access-apis-write](../includes/rbac-for-apis/rbac-global-secure-access-apis-write.md)] ## HTTP request-+> [!NOTE] +> The `/branches/{branchSiteId}/...` path will be retired soon. Use the `/remoteNetworks/{remoteNetworkId}/...` path instead. <!-- { "blockType": "ignored" } --> ``` http PATCH /networkAccess/connectivity/branches/{branchSiteId}/deviceLinks/{deviceLinkId}+PATCH /networkAccess ``` ## Request headers |
v1.0 | Networkaccess Remotenetwork Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-remotenetwork-get.md | + + Title: "Get remoteNetwork" +description: "Retrieve information about a specific remote network." ++ms.localizationpriority: medium ++++# Get remoteNetwork +Namespace: microsoft.graph.networkaccess +++Retrieve information about a specific remote network. +++## 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": "networkaccess-remotenetwork-get-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /networkAccess/connectivity/remoteNetworks/{remoteNetworkId} +``` ++## Optional query parameters +This method supports the `$expand` and `$select` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [microsoft.graph.networkaccess.remoteNetworks](../resources/networkaccess-remotenetwork.md) object in the response body. ++## Examples ++### Request +Here's an example of a request. ++``` http +GET https://graph.microsoft.com/beta/networkAccess/connectivity/remoteNetworks/dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04 +``` ++### Response +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.networkaccess.remoteNetwork" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks/$entity", + "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET networkAccess/connectivity/remoteNetworks('<guid>')?$select=bandwidthCapacity,connectivityState", + "id": "dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04", + "name": "Test branch", + "region": "canadaEast", + "version": "1.0.0", + "lastModifiedDateTime": "2023-12-12T14:26:24Z", + "forwardingProfiles@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks('dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04')/forwardingProfiles", + "forwardingProfiles": [ + { + "trafficForwardingType": "m365", + "priority": 0, + "id": "1adaf535-1e31-4e14-983f-2270408162bf", + "name": "Microsoft 365 traffic forwarding profile", + "description": "Default traffic forwarding profile for Microsoft 365 traffic acquisition. Assign the profile to client or branch offices to acquire Microsoft 365 traffic for Zero Trust Network Access.", + "state": "disabled", + "version": "1.0.0", + "lastModifiedDateTime": "2024-01-22T12:10:49Z", + "associations": [ + { + "@odata.type": "#microsoft.graph.networkaccess.associatedBranch", + "branchId": "9ffbc1a5-2916-4fb4-b277-76cdc89cc491" + }, + { + "@odata.type": "#microsoft.graph.networkaccess.associatedBranch", + "branchId": "dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04" + }, + { + "@odata.type": "#microsoft.graph.networkaccess.associatedBranch", + "branchId": "43c7a0d3-1072-4da1-9e30-e513b02bb559" + }, + { + "@odata.type": "#microsoft.graph.networkaccess.associatedBranch", + "branchId": "4ecfc62c-ec85-42fd-af37-5a93c7deb1d9" + } + ] + } + ], + "deviceLinks@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks('dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04')/deviceLinks", + "deviceLinks": [ + { + "id": "47aab2e9-7f5c-42ba-bbfc-1b049193126a", + "name": "name", + "ipAddress": "1.2.3.1", + "bandwidthCapacityInMbps": "mbps500", + "deviceVendor": "barracudaNetworks", + "lastModifiedDateTime": "2023-12-12T14:26:24Z", + "bgpConfiguration": { + "localIpAddress": "1.2.1.1", + "peerIpAddress": "1.2.3.1", + "asn": 899 + }, + "redundancyConfiguration": { + "zoneLocalIpAddress": null, + "redundancyTier": "noRedundancy" + }, + "tunnelConfiguration": { + "@odata.type": "#microsoft.graph.networkaccess.tunnelConfigurationIKEv2Default", + "preSharedKey": "dcf" + } + } + ] +} +``` |
v1.0 | Networkaccess Remotenetwork List Devicelinks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-remotenetwork-list-devicelinks.md | + + Title: "List deviceLinks" +description: "Retrieve a list of device links associated with a specific remote network." ++ms.localizationpriority: medium ++++# List deviceLinks +Namespace: microsoft.graph.networkaccess +++Retrieve a list of device links associated with a specific remote network. +++## 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": "networkaccess-remotenetwork-list-devicelinks-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /networkAccess/connectivity/remoteNetworks/{remoteNetworkId}/deviceLinks +``` ++## Optional query parameters ++This method supports the `$expand` [OData query parameter](/graph/query-parameters) to help customize the response. +++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## 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 [microsoft.graph.networkaccess.deviceLink](../resources/networkaccess-devicelink.md) objects in the response body. ++## Examples ++### Request +The following is an example of a request. ++``` http +GET hhttps://graph.microsoft.com/beta/networkAccess/connectivity/remoteNetworks/4ecfc62c-ec85-42fd-af37-5a93c7deb1d9/deviceLinks +``` ++### 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.networkaccess.deviceLink)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks('4ecfc62c-ec85-42fd-af37-5a93c7deb1d9')/deviceLinks", + "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET networkAccess/connectivity/remoteNetworks('<guid>')/deviceLinks?$select=bandwidthCapacityInMbps,bgpConfiguration", + "value": [ + { + "id": "109376bf-6dc7-4183-ab11-4a1206fb5e90", + "name": "VNG", + "ipAddress": "20.172.65.16", + "bandwidthCapacityInMbps": "mbps500", + "deviceVendor": "other", + "lastModifiedDateTime": "2024-01-17T20:59:13Z", + "bgpConfiguration": { + "localIpAddress": "192.168.1.2", + "peerIpAddress": "10.0.2.5", + "asn": 65533 + }, + "redundancyConfiguration": { + "zoneLocalIpAddress": "192.168.1.3", + "redundancyTier": "zoneRedundancy" + }, + "tunnelConfiguration": { + "@odata.type": "#microsoft.graph.networkaccess.tunnelConfigurationIKEv2Default", + "preSharedKey": "test123" + } + } + ] +} +``` |
v1.0 | Networkaccess Remotenetwork List Forwardingprofiles | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-remotenetwork-list-forwardingprofiles.md | + + Title: "List forwardingProfiles (for a remote network)" +description: "Retrieve a list of traffic forwarding profiles associated with a remote network." ++ms.localizationpriority: medium ++++# List forwardingProfiles (for a remote network) +Namespace: microsoft.graph.networkaccess +++Retrieve a list of traffic forwarding profiles associated with a remote network. +++## 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": "networkaccess-remotenetwork-list-forwardingprofiles-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /networkAccess/connectivity/remoteNetworks/{remoteNetworkId}/forwardingProfiles +``` ++## Optional query parameters +This method does not support any OData query parameters. ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## 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 [forwardingProfile](../resources/networkaccess-forwardingprofile.md) objects in the response body. ++## Examples ++### Request +The following is an example of a request. ++``` http +GET https://graph.microsoft.com/beta/networkAccess/connectivity/remoteNetworks/dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04/forwardingProfiles +``` ++### 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.networkaccess.forwardingProfile)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "http://graph.microsoft.com/beta/networkAccess/$metadata#forwardingProfiles", + "value": [ + { + "id": "19a92090-c14e-4cea-a933-27d38f72c4d1", + "name": "forwardingProfile 1", + "description": "some description", + "state": "disabled", + "version": "13", + "lastModifiedDate": "2022-06-13T08:22:14Z", + "trafficForwardingType": "m365", + "priority": 500, + "associations" : [ + { + "@odata.type": "microsoft.graph.networkAccess.AssociatedBranch", + "branchId": "19a92090-c14e-4cea-a933-27d38f72c64s" + } + ], + } + ] +} +``` + |
v1.0 | Networkaccess Remotenetwork Post Devicelinks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-remotenetwork-post-devicelinks.md | + + Title: "Create deviceLink" +description: "Create device link for a remote network" ++ms.localizationpriority: medium ++++# Create deviceLink +Namespace: microsoft.graph.networkaccess +++Create device link for a remote network. To create a remote network and device link in the same request, refer to [Create remote network](networkaccess-connectivity-post-remotenetworks.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": "networkaccess-remotenetwork-post-devicelinks-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /networkAccess/connectivity/remoteNetworks/{remoteNetworkId}/deviceLinks +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [microsoft.graph.networkaccess.deviceLink](../resources/networkaccess-devicelink.md) object. ++You can specify the following properties when creating a **deviceLink**. ++|Property|Type|Description| +|:|:|:| +|name|String|The name or identifier associated with a device link. Required.| +|ipAddress|String|The IP address associated with a device link. Required.| +|deviceVendor|microsoft.graph.networkaccess.deviceVendor|The vendor or manufacturer of the device associated with a device link. The possible values are: `barracudaNetworks`, `checkPoint`, `ciscoMeraki`, `citrix`, `fortinet`, `hpeAruba`, `netFoundry`, `nuage`, `openSystems`, `paloAltoNetworks`, `riverbedTechnology`, `silverPeak`, `vmWareSdWan`, `versa`, `other`. Required.| +|tunnelConfiguration|[microsoft.graph.networkaccess.tunnelConfiguration](../resources/networkaccess-tunnelconfiguration.md)|The tunnel configuration settings associated with a device link. Required.| +|bgpConfiguration|[microsoft.graph.networkaccess.bgpConfiguration](../resources/networkaccess-bgpconfiguration.md)|The Border Gateway Protocol (BGP) configuration settings associated with a device link. Required.| +|redundancyConfiguration|[microsoft.graph.networkaccess.redundancyConfiguration](../resources/networkaccess-redundancyconfiguration.md)|The redundancy option for a device link specifies the specific details and configuration settings related to redundancy. Required.| +++## Response ++If successful, this method returns a `201 Created` response code and a [microsoft.graph.networkaccess.deviceLink](../resources/networkaccess-devicelink.md) object in the response body. ++## Example 1: Add a device link with default IKE policy ++### Request +The following example shows a request. ++``` http +POST https://graph.microsoft.com/beta/networkAccess/connectivity/remoteNetworks/dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04/deviceLinks +Content-Type: application/json +{ + "name": "CPE3", + "ipAddress": "20.55.91.42", + "deviceVendor": "ciscoMeraki", + "bandwidthCapacityInMbps": "mbps1000", + "bgpConfiguration": { + "localIpAddress": "192.168.1.2", + "peerIpAddress": "10.2.2.2", + "asn": 65533 + }, + "redundancyConfiguration": { + "redundancyTier": "zoneRedundancy", + "zoneLocalIpAddress": "192.168.1.3" + }, + "tunnelConfiguration": { + "@odata.type": "#microsoft.graph.networkaccess.tunnelConfigurationIKEv2Default", + "preSharedKey": "test123" + } +} +``` +### 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.networkaccess.deviceLink" +} +--> +``` http +HTTP/1.1 204 No Content ++``` ++## Example 2: Add a device link with custom IKE policy ++### Request +The following example shows a request. ++``` http +POST https://graph.microsoft.com/beta/networkAccess/connectivity/remoteNetworks/dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04/deviceLinks +Content-Type: application/json ++{ + "name": "custom link", + "ipAddress": "114.20.4.14", + "deviceVendor": "ciscoMeraki", + "tunnelConfiguration": { + "saLifeTimeSeconds": 300, + "ipSecEncryption": "gcmAes128", + "ipSecIntegrity": "gcmAes128", + "ikeEncryption": "aes128", + "ikeIntegrity": "sha256", + "dhGroup": "ecp384", + "pfsGroup": "ecp384", + "@odata.type": "#microsoft.graph.networkaccess.tunnelConfigurationIKEv2Custom", + "preSharedKey": "SHAREDKEY" + }, + "bgpConfiguration": { + "localIpAddress": "10.1.1.11", + "peerIpAddress": "10.6.6.6", + "asn": 65000 + }, + "redundancyConfiguration": { + "redundancyTier": "zoneRedundancy", + "zoneLocalIpAddress": "10.1.1.12" + }, + "bandwidthCapacityInMbps": "mbps250" +} +``` ++### 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.networkaccess.deviceLink" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{} +``` |
v1.0 | Networkaccess Remotenetwork Post Forwardingprofiles | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-remotenetwork-post-forwardingprofiles.md | + + Title: "Assign forwardingProfile" +description: "Assign a forwarding profile to a remote network" ++ms.localizationpriority: medium ++++# Assign forwardingProfile +Namespace: microsoft.graph.networkaccess +++Assign a forwarding profile to an existing remote network. To create a remote network with traffic forwarding profile, see [Create remoteNetwork](networkaccess-connectivity-post-remotenetworks.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": "networkaccess-remotenetwork-post-forwardingprofiles-permissions" +} +--> ++++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /networkAccess/connectivity/remoteNetworks/{remoteNetworkId}/forwardingProfiles +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [microsoft.graph.networkaccess.forwardingProfile](../resources/networkaccess-forwardingprofile.md) object. ++You can specify the following properties when associating a **forwardingProfile** to a remote network. ++|Property|Type|Description| +|:|:|:| +|id|String|ID of the forwarding profile. Inherited from [microsoft.graph.networkaccess.profile](../resources/networkaccess-profile.md). Required.| ++## Response ++If successful, this method returns a `OK 200` response code. ++## Examples +To get the id of forwarding profiles of your organization, refer to this article - [List forwardingProfiles](networkaccess-networkaccessroot-list-forwardingprofiles.md). ++### Request +The following example shows a request. ++``` http +PATCH https://graph.microsoft.com/beta/networkAccess/connectivity/remoteNetworks/{remoteNetworkId}/forwardingProfiles +Content-Type: application/json ++{ + "@context": "#$delta", + "value": [ + { + "id": "1adaf535-1e31-4e14-983f-2270408162bf" + } + ] +} +``` ++### Response +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 200 OK +``` + |
v1.0 | Networkaccess Remotenetwork Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-remotenetwork-update.md | + + Title: "Update remoteNetwork" +description: "Update the configuration or properties of a specific remote etwork." ++ms.localizationpriority: medium ++++# Update remoteNetwork +Namespace: microsoft.graph.networkaccess +++Update the configuration or properties of a specific remote network. +++## 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": "networkaccess-remotenetwork-update-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /networkAccess/connectivity/remoteNetworks/{remoteNetworkId} +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +++|Property|Type|Description| +|:|:|:| +|name|String|Name of the remote network.| ++## Response ++If successful, this method returns a `200 OK` response code and a [microsoft.graph.networkaccess.remoteNetwork](../resources/networkaccess-remotenetwork.md) object in the response body. ++## Examples ++### Request ++The following is an example of a request. ++``` http +PATCH https://graph.microsoft.com/beta/networkAccess/connectivity/remoteNetworks/dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04 +Content-Type: application/json ++{ + "name": "Test Redmond branch" +} +``` +++### 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.networkaccess.remoteNetwork" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks/$entity", + "id": "dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04", + "name": "Test Redmond branch", + "region": "canadaEast", + "version": "1.0.0", + "lastModifiedDateTime": "2024-01-27T06:16:14Z", + "forwardingProfiles@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks('dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04')/forwardingProfiles", + "forwardingProfiles": [], + "deviceLinks@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks('dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04')/deviceLinks", + "deviceLinks": [ + { + "id": "47aab2e9-7f5c-42ba-bbfc-1b049193126a", + "name": "name", + "ipAddress": "1.2.3.1", + "bandwidthCapacityInMbps": "mbps500", + "deviceVendor": "barracudaNetworks", + "lastModifiedDateTime": "2024-01-27T06:16:14Z", + "bgpConfiguration": { + "localIpAddress": "1.2.1.1", + "peerIpAddress": "1.2.3.1", + "asn": 899 + }, + "redundancyConfiguration": { + "zoneLocalIpAddress": null, + "redundancyTier": "noRedundancy" + }, + "tunnelConfiguration": { + "@odata.type": "#microsoft.graph.networkaccess.tunnelConfigurationIKEv2Default", + "preSharedKey": "dcf" + } + } + ] +} +``` ++ |
v1.0 | Networkaccess Remotenetworkconnectivityconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-remotenetworkconnectivityconfiguration-get.md | + + Title: "Get remoteNetworkConnectivityConfiguration" +description: "Retrieve the IPSec tunnel configuration required to establish a bidirectional communication link between your organization's router and Microsoft's gateway." ++ms.localizationpriority: medium ++++# Get remoteNetworkConnectivityConfiguration +Namespace: microsoft.graph.networkaccess +++Retrieve the IPSec tunnel configuration required to establish a bidirectional communication link between your organization's router and the Microsoft gateway. This information is vital for configuring your router (customer premise equipment) after creating a [deviceLink](../resources/networkaccess-devicelink.md). Refer to [Configure customer premises equipment for Global Secure Access](/entra/global-secure-access/how-to-configure-customer-premises-equipment?tabs=microsoft-entra-admin-center) to understand how to use this information to set up your router. +++## 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": "networkaccess-remotenetworkconnectivityconfiguration-get-permissions" +} +--> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /networkAccess/connectivity/remoteNetworks/{remoteNetworkId}/connectivityConfiguration +``` ++## Optional query parameters +This method does not supports OData query parameters. ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [microsoft.graph.networkaccess.remoteNetworkConnectivityConfiguration](../resources/networkaccess-remotenetworkconnectivityconfiguration.md) object in the response body. ++## Examples ++### Request +The following example shows a request. ++``` http +GET https://graph.microsoft.com/beta/networkAccess/connectivity/remoteNetworks/dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04/connectivityConfiguration +``` ++### 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.networkaccess.remoteNetworkConnectivityConfiguration" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks('4ecfc62c-ec85-42fd-af37-5a93c7deb1d9')/connectivityConfiguration/$entity", + "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET networkAccess/connectivity/remoteNetworks('<guid>')/connectivityConfiguration?$select=remoteNetworkId,remoteNetworkName", + "remoteNetworkId": "4ecfc62c-ec85-42fd-af37-5a93c7deb1d9", + "remoteNetworkName": "Abhijeet Azure VNG", + "links@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks('4ecfc62c-ec85-42fd-af37-5a93c7deb1d9')/connectivityConfiguration/links", + "links": [ + { + "id": "109376bf-6dc7-4183-ab11-4a1206fb5e90", + "displayName": "VNG", + "localConfigurations": [ + { + "endpoint": "20.245.111.21", + "asn": 65476, + "bgpAddress": "192.168.1.2", + "region": "westUS" + }, + { + "endpoint": "20.245.111.77", + "asn": 65476, + "bgpAddress": "192.168.1.3", + "region": "westUS" + } + ], + "peerConfiguration": { + "endpoint": "20.172.65.16", + "asn": 65533, + "bgpAddress": "10.0.2.5" + } + } + ] +} +``` + |
v1.0 | Onattributecollectionexternalusersselfservicesignup Delete Attributes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/onattributecollectionexternalusersselfservicesignup-delete-attributes.md | DELETE https://graph.microsoft.com/beta/identity/authenticationEventsFlows/0313c [!INCLUDE [sample-code](../includes/snippets/php/delete-onattributecollectionexternalusersselfservicesignup-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-onattributecollectionexternalusersselfservicesignup-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Onauthenticationmethodloadstartexternalusersselfservicesignup List Identityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/onauthenticationmethodloadstartexternalusersselfservicesignup-list-identityproviders.md | Don't supply a request body for this method. ## Response -If successful, this method returns a `200 OK` response code and a new [identityProviders](../resources/identityprovider.md) object in the response body. +If successful, this method returns a `200 OK` response code and a collection of [identityProviderBase](../resources/identityproviderbase.md) objects in the response body. ## Examples |
v1.0 | Onlinemeeting Getallrecordings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/onlinemeeting-getallrecordings.md | Title: "onlineMeeting: getAllRecordings" description: "Get recordings from all online meetings that a user is an organizer of."-+ ms.localizationpriority: medium doc_type: apiPageType Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Get all recordings from scheduled [onlineMeeting](../resources/onlinemeeting.md) instances for which the specified user is the organizer. This API currently does not support getting call recordings from channel meetings. +Get all recordings from scheduled [onlineMeeting](../resources/onlinemeeting.md) instances for which the specified user is the organizer. This API currently doesn't support getting call recordings from channel meetings. -You can apply the [delta](callrecording-delta.md) function on **getAllRecordings** to synchronize and get [callRecording](../resources/callrecording.md) resources as they are added for **onlineMeeting** instances organized by the specified user. +You can apply the [delta](callrecording-delta.md) function on **getAllRecordings** to synchronize and get [callRecording](../resources/callrecording.md) resources as they're added for **onlineMeeting** instances organized by the specified user. -Delta query supports both full synchronization that gets all the recordings for online meetings organized by the user, and incremental synchronization that gets recordings that have been added since the last synchronization. Typically, you would do an initial full synchronization, and then get incremental changes to that recording view periodically. +The delta query supports both full synchronization and incremental synchronization. Full synchronization gets all the recordings for online meetings organized by the user. Incremental synchronization gets recordings that are added since the last synchronization. Typically, you would do an initial full synchronization, and then get incremental changes to that recording view periodically. -Find more information in the [delta query](/graph/delta-query-overview) documentation. For additional examples, see [callRecording: delta](callrecording-delta.md). +Find more information in the [delta query](/graph/delta-query-overview) documentation. For more examples, see [callRecording: delta](callrecording-delta.md). To learn more about using the Microsoft Teams export APIs to export content, see [Export content with the Microsoft Teams export APIs](/microsoftteams/export-teams-content). [!INCLUDE [national-cloud-support](../../includes/global-only.md)] +### Known issues ++The following known issues are associated with this API: ++- [Using the `$top` query parameter might not return the @odata.nextLink](https://developer.microsoft.com/en-us/graph/known-issues/?search=22931). +- [Recordings aren't exported for meetings that don't have transcription turned on](https://developer.microsoft.com/en-us/graph/known-issues/?search=22933). + ## 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). Choose the permission or permissions marked as least privileged for this API. Us ## HTTP request <!-- { "blockType": "ignored" } -->-```http -GET /users/{id}/onlineMeetings/getAllRecordings?$filter=meetingOrganizerId%20eq%20'{id}' +``` http +GET /users/{usersId}/onlineMeetings/getAllRecordings(meetingOrganizerUserId='{userId}',startDateTime={startDateTime},endDateTime={endDateTime}) ```+>**Note:** If you don't pass the function parameter **meetingOrganizerUserId**, the request fails. ++## Function parameters +In the request URL, provide the following query parameters with values. ->**Note:** If you don't specify a filter on **meetingOrganizerId**, the request fails. +|Parameter|Type|Description| +|:|:|:| +|meetingOrganizerUserId|String|The user identifier of the meeting organizer to filter for artifacts for meetings organized by the given user identifier.| +|startDateTime|DateTimeOffset|Optional parameter to filter for artifacts created after the given start date.| +|endDateTime|DateTimeOffset|Optional parameter to filter for artifacts created before the given end date.| ++## Supported query patterns ++| Pattern | Supported | Syntax | Notes | +| - | :-: | - | | +| Page size | Γ£ô | `top` | Allows caller to specify max number of objects per page. | ## Request headers+ | Header | Value | |:|:--| |Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| GET /users/{id}/onlineMeetings/getAllRecordings?$filter=meetingOrganizerId%20eq% If successful, this method returns a `200 OK` response code and a list of [callRecording](../resources/callrecording.md) objects in the response body. -## Example +## Examples ++### Example 1: Get all recordings ++The following example shows a request to get all the recordings of a given meeting organizer. -### Request +#### Request -# [HTTP](#tab/http) <!-- { "blockType": "request", "sampleKeys": ["8b081ef6-4792-4def-b2c9-c363a1bf41d5"], "name": "get_allrecordings" }--> ```msgraph-interactive-GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeeting/getAllRecordings?$filter=meetingOrganizerId%20eq%20'8b081ef6-4792-4def-b2c9-c363a1bf41d5' +GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5') ``` -# [JavaScript](#tab/javascript) - -### Response +#### Response >**Note:** The response object shown here might be shortened for readability. <!-- { HTTP/1.1 200 OK Content-type: application/json {- "@odata.context":"https://graph.microsoft.com/beta/$metadata#Collection(callRecording)", - "@odata.count":10, - "@odata.nextLink":"https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeeting/getAllRecordings?$skiptoken=GGXvkS7mbjFAe9Uidm2D70e58K-BOnoJadAqkZEJmoLprr5eSP1hQPlb3dJ1AVz3xCYKxov6hSEJhsasyg", - "value":[ - { + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callRecording)", + "@odata.nextLink": "https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')?skipToken={skipToken}", + "@odata.count": 1, + "value": [ + { + "@odata.type": "#microsoft.graph.callRecording", + "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=", + "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy", + "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5", + "createdDateTime": "2023-12-02T06:59:34.7411768Z", + "recordingContentUrl": "https://graph.microsoft.com/betAtOWJiMy1jMTUzYzE4ODY4NGY=/content", + "meetingOrganizer": { + "application": null, + "device": null, + "user": { + "@odata.type": "#microsoft.graph.teamworkUserIdentity", + "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5", + "displayName": null, + "userIdentityType": "aadUser", + "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853" + } + } + } + ] +} +``` ++### Example 2: Get all recordings of a given meeting organizer with date range filter ++The following example shows a request to get all recordings of a given meeting organizer, that are created between a given start date and an end date. ++#### Request ++<!-- { + "blockType": "request", + "sampleKeys": ["8b081ef6-4792-4def-b2c9-c363a1bf41d5", "2024-01-15T00:00:00Z", "2024-01-31T00:00:00Z"], + "name": "get_allrecordings_with_dates" +}--> +```msgraph-interactive +GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5', startDateTime=2024-01-15T00:00:00Z, endDateTime=2024-01-31T00:00:00Z) +``` ++++#### Response ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "name": "get_allrecordings_with_dates", + "@odata.type": "microsoft.graph.callRecording", + "isCollection": true +} --> +```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callRecording)", + "@odata.nextLink": "https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5', startDateTime=2024-01-15T00:00:00Z, endDateTime=2024-01-31T00:00:00Z)?skipToken={skipToken}", + "@odata.count": 1, + "value": [ + { "@odata.type": "#microsoft.graph.callRecording",- "meetingId": "MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19OMUUxWTFJME56QXRabVF5T0MxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy", + "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=", + "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy", "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",- "recordingContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19OMUUxWTFJME56QXRabVF5T0MxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/recordings/MSMjMCMjZDExYWQ2OGEtMWVhYS00MGFjLWJkZWItMTExNjMyNjExYzRl/content", - "createdDateTime": "2023-08-03T22:29:42.6514074Z", - "id": "MSMjMCMjZDExYWQ2OGEtMWVhYS00MGFjLWJkZWItMTExNjMyNjExYzRl" - } - ] + "createdDateTime": "2023-12-02T06:59:34.7411768Z", + "recordingContentUrl": "https://graph.microsoft.com/betAtOWJiMy1jMTUzYzE4ODY4NGY=/content", + "meetingOrganizer": { + "application": null, + "device": null, + "user": { + "@odata.type": "#microsoft.graph.teamworkUserIdentity", + "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5", + "displayName": null, + "userIdentityType": "aadUser", + "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853" + } + } + } + ] } ``` Content-type: application/json [Microsoft Graph service-specific throttling limits](/graph/throttling-limits#microsoft-teams-service-limits) -[Delta query overview](/graph/delta-query-overview) +[Delta query overview](/graph/delta-query-overview) [Export content with the Microsoft Teams export APIs](/microsoftteams/export-teams-content) |
v1.0 | Onlinemeeting Getalltranscripts | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/onlinemeeting-getalltranscripts.md | Title: "onlineMeeting: getAllTranscripts" description: "Get transcripts from all online meetings that a user is an organizer of."-+ ms.localizationpriority: medium doc_type: apiPageType Namespace: microsoft.graph Get all transcripts from scheduled [onlineMeeting](../resources/onlinemeeting.md) instances for which the specified user is the organizer. This API currently doesn't support getting call transcripts from channel meetings. -You can apply the [delta](calltranscript-delta.md) function on **getAllTranscripts** to synchronize and get [callTranscript](../resources/calltranscript.md) resources as they are added for **onlineMeeting** instances organized by the specified user. +You can apply the [delta](calltranscript-delta.md) function on **getAllTranscripts** to synchronize and get [callTranscript](../resources/calltranscript.md) resources as they're added for **onlineMeeting** instances organized by the specified user. -Delta query supports both full synchronization that gets all the transcripts for online meetings organized by the user, and incremental synchronization that gets transcripts that have been added since the last synchronization. Typically, you would do an initial full synchronization, and then get incremental changes to that transcript view periodically. +Delta query supports both full synchronization and incremental synchronization. Full synchronization gets all the transcripts for online meetings organized by the user. Incremental synchronization gets transcripts that are added since the last synchronization. Typically, you would do an initial full synchronization, and then get incremental changes to that recording view periodically. -Find more information in the [delta query](/graph/delta-query-overview) documentation. For additional examples, see [callTranscript: delta](calltranscript-delta.md). +For more information, see [delta query](/graph/delta-query-overview). For more examples, see [callTranscript: delta](calltranscript-delta.md). To learn more about using the Microsoft Teams export APIs to export content, see [Export content with the Microsoft Teams export APIs](/microsoftteams/export-teams-content). [!INCLUDE [national-cloud-support](../../includes/global-only.md)] +### Known issues ++The following known issues are associated with this API: ++- [Using the `$top` query parameter might not return the @odata.nextLink](https://developer.microsoft.com/en-us/graph/known-issues/?search=22931). +- [Transcript URLs might not include any content](https://developer.microsoft.com/en-us/graph/known-issues/?search=22932). + ## 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). Choose the permission or permissions marked as least privileged for this API. Us ## HTTP request <!-- { "blockType": "ignored" } -->-```http -GET /users/{id}/onlineMeetings/getAllTranscripts?$filter=meetingOrganizerId%20eq%20'{id}' +``` http +GET /users/{usersId}/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='{userId}',startDateTime={startDateTime},endDateTime={endDateTime}) ```+>**Note:** If you don't pass the function parameter **meetingOrganizerUserId**, the request fails. ++## Function parameters +In the request URL, provide the following query parameters with values. ++|Parameter|Type|Description| +|:|:|:| +|meetingOrganizerUserId|String|The user identifier of the meeting organizer. To filter for artifacts for meetings organized by the given user identifier.| +|startDateTime|DateTimeOffset|Optional parameter to filter for artifacts created after the given start date.| +|endDateTime|DateTimeOffset|Optional parameter to filter for artifacts created before the given end date.| ++## Supported query patterns ++| Pattern | Supported | Syntax | Notes | +| - | :-: | - | | +| Page size | Γ£ô | `top` | Allows the caller to specify the maximum number of objects per page. | ->**Note:** If you don't specify a filter on **meetingOrganizerId**, the request fails. ## Request headers+ | Header | Value | |:|:--| |Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Response -If successful, this method returns a `200 OK` response code and a collection of [callTranscript](../resources/calltranscript.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a list of [callTranscript](../resources/calltranscript.md) objects in the response body. ++## Examples -## Example +### Example 1: Get all transcripts -### Request +The following example shows a request to get all the transcripts of a given meeting organizer. -The following example shows a request. +#### Request -# [HTTP](#tab/http) <!-- { "blockType": "request", "sampleKeys": ["8b081ef6-4792-4def-b2c9-c363a1bf41d5"],- "name": "get_alltranscipts" + "name": "get_alltranscripts" }--> ```msgraph-interactive-GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllTranscripts?$filter=meetingOrganizerId%20eq%20'8b081ef6-4792-4def-b2c9-c363a1bf41d5' +GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5') ``` -# [C#](#tab/csharp) + -# [CLI](#tab/cli) +#### Response -# [Go](#tab/go) +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "name": "get_alltranscripts", + "@odata.type": "microsoft.graph.callTranscript", + "isCollection": true +} --> +```http +HTTP/1.1 200 OK +Content-type: application/json -# [Java](#tab/java) +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callTranscript)", + "@odata.nextLink": "https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')?skipToken={skipToken}", + "@odata.count": 1, + "value": [ + { + "@odata.type": "#microsoft.graph.callTranscript", + "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=", + "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy", + "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5", + "createdDateTime": "2023-12-02T06:59:34.7411768Z", + "transcriptContentUrl": "https://graph.microsoft.com/betAtOWJiMy1jMTUzYzE4ODY4NGY=/content", + "meetingOrganizer": { + "application": null, + "device": null, + "user": { + "@odata.type": "#microsoft.graph.teamworkUserIdentity", + "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5", + "displayName": null, + "userIdentityType": "aadUser", + "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853" + } + } + } + ] +} +``` -# [JavaScript](#tab/javascript) +### Example 2: Get all transcripts of a given meeting organizer with date range filter -# [PHP](#tab/php) +The following example shows a request to get all transcripts of a given meeting organizer, that are created between a given start date and an end date. -# [PowerShell](#tab/powershell) +#### Request -# [Python](#tab/python) +<!-- { + "blockType": "request", + "sampleKeys": ["8b081ef6-4792-4def-b2c9-c363a1bf41d5", "2024-01-15T00:00:00Z", "2024-01-31T00:00:00Z"], + "name": "get_alltranscripts_with_dates" +}--> +```msgraph-interactive +GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5', startDateTime=2024-01-15T00:00:00Z, endDateTime=2024-01-31T00:00:00Z) +``` -### Response --The following example shows the response. +#### Response >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", "truncated": true,- "name": "get_alltranscipts", + "name": "get_alltranscripts_with_dates", "@odata.type": "microsoft.graph.callTranscript", "isCollection": true } --> HTTP/1.1 200 OK Content-type: application/json {- "@odata.context":"https://graph.microsoft.com/beta/$metadata#Collection(callTranscript)", - "@odata.count":10, - "@odata.nextLink":"https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllTranscripts?$skiptoken=GGXvkS7mbjFAe9Uidm2D70e58K-BOnoJadAqkZEJmoLprr5eSP1hQPlb3dJ1AVz3xCYKxov6hSEJhsasyg", - "value":[ - { + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callTranscript)", + "@odata.nextLink": "https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5', startDateTime=2024-01-15T00:00:00Z, endDateTime=2024-01-31T00:00:00Z)?skipToken={skipToken}", + "@odata.count": 1, + "value": [ + { "@odata.type": "#microsoft.graph.callTranscript",- "meetingId": "MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19OMUUxWTFJME56QXRabVF5T0MxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy", + "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=", + "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy", "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",- "transcriptContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19OMUUxWTFJME56QXRabVF5T0MxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/transcripts/MSMjMCMjZDExYWQ2OGEtMWVhYS00MGFjLWJkZWItMTExNjMyNjExYzRl/content", - "createdDateTime": "2023-08-03T22:29:42.6514074Z", - "id": "MSMjMCMjZDExYWQ2OGEtMWVhYS00MGFjLWJkZWItMTExNjMyNjExYzRl" - } - ] + "createdDateTime": "2023-12-02T06:59:34.7411768Z", + "transcriptContentUrl": "https://graph.microsoft.com/betAtOWJiMy1jMTUzYzE4ODY4NGY=/content", + "meetingOrganizer": { + "application": null, + "device": null, + "user": { + "@odata.type": "#microsoft.graph.teamworkUserIdentity", + "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5", + "displayName": null, + "userIdentityType": "aadUser", + "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853" + } + } + } + ] } ``` ## Related content -- [Microsoft Graph service-specific throttling limits](/graph/throttling-limits#microsoft-teams-service-limits)-- [Delta query overview](/graph/delta-query-overview) -- [Export content with the Microsoft Teams export APIs](/microsoftteams/export-teams-content)+[Microsoft Graph service-specific throttling limits](/graph/throttling-limits#microsoft-teams-service-limits) +[Delta query overview](/graph/delta-query-overview) +[Export content with the Microsoft Teams export APIs](/microsoftteams/export-teams-content) |
v1.0 | Openawssecuritygroupfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/openawssecuritygroupfinding-get.md | description: "Read the properties and relationships of an openAwsSecurityGroupFi ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Openawssecuritygroupfinding List Assignedcomputeinstancesdetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/openawssecuritygroupfinding-list-assignedcomputeinstancesdetails.md | description: "Get a list of the assignedComputeInstanceDetails objects and their ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Openawssecuritygroupfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/openawssecuritygroupfinding-list.md | description: "Get a list of the openAwsSecurityGroupFinding objects and their pr ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Opennetworkazuresecuritygroupfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/opennetworkazuresecuritygroupfinding-get.md | description: "Read the properties and relationships of an openNetworkAzureSecuri ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Opennetworkazuresecuritygroupfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/opennetworkazuresecuritygroupfinding-list.md | description: "Get a list of the openNetworkAzureSecurityGroupFinding objects and ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Openshiftchangerequest Post | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/openshiftchangerequest-post.md | Create instance of an [openShiftChangeRequest](../resources/openshiftchangereque ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -| Permission type | Permissions (from least to most privileged) | -|:|:--| -| Delegated (work or school account) | Group.ReadWrite.All | -| Delegated (personal Microsoft account) | Not supported. | -| Application | Schedule.ReadWrite.All* | +<!-- { "blockType": "permissions", "name": "openshiftchangerequest_post" } --> ->\* **Important:** Application permissions are currently in private preview only and are not available for public use. +> [!NOTE] +> The Schedule.ReadWrite.All application permission is currently in private preview only and ins't available for public use. ## HTTP request |
v1.0 | Opentypeextension Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/opentypeextension-delete.md | description: "Delete an open extension (openTypeExtension object) from the speci ms.localizationpriority: medium doc_type: apiPageType+ # Delete openTypeExtension |
v1.0 | Opentypeextension Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/opentypeextension-get.md | description: "Get an open extension (openTypeExtension object) identified by nam ms.localizationpriority: medium doc_type: apiPageType+ # Get openTypeExtension |
v1.0 | Opentypeextension Post Opentypeextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/opentypeextension-post-opentypeextension.md | description: "Create an open extension (openTypeExtension object) and add custom ms.localizationpriority: medium doc_type: apiPageType+ # Create openTypeExtension |
v1.0 | Opentypeextension Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/opentypeextension-update.md | description: "Update an open extension (openTypeExtension object) with the prope ms.localizationpriority: medium doc_type: apiPageType+ # Update openTypeExtension |
v1.0 | Organizationsettings List Iteminsights | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/organizationsettings-list-iteminsights.md | Title: "List itemInsights" + Title: "List itemInsights (deprecated)" description: "Retrieve properties of insightsSettings object for displaying or returning item insights in an organization." ms.localizationpriority: medium Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + Get the properties of an [insightsSettings](../resources/insightssettings.md) object for displaying or returning item insights in an organization. To learn how to customize the privacy of item insights in an organization, see [Customize item insights privacy](/graph/insights-customize-item-insights-privacy). - [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions |
v1.0 | Outboundshareduserprofile Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/outboundshareduserprofile-get.md | Title: "Get outboundSharedUserProfile" description: "Get the details of an outboundSharedUserProfile." + ms.localizationpriority: medium doc_type: apiPageType |
v1.0 | Outboundshareduserprofile List Tenants | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/outboundshareduserprofile-list-tenants.md | Title: "Get tenantReferences" description: "List the tenant references of an outboundSharedUserProfile." + ms.localizationpriority: medium doc_type: apiPageType |
v1.0 | Outlookcategory Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/outlookcategory-update.md | Title: "Update Outlook category" -description: "Update the writable property, **color**, of the specified outlookCategory object. You can't modify the **displayName** property " + Title: "Update outlookCategory" +description: "Update the writable property, **color**, of the specified outlookCategory object." ms.localizationpriority: medium doc_type: apiPageType -# Update Outlook category +# Update outlookCategory Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Update the writable property, **color**, of the specified [outlookCategory](../resources/outlookcategory.md) object. You can't modify the **displayName** property -once you have created the category. +Update the writable property, **color**, of the specified [outlookCategory](../resources/outlookcategory.md) object. You can't modify the **displayName** property once you have created the category. [!INCLUDE [national-cloud-support](../../includes/global-us.md)] maintains their previous values or be recalculated based on changes to other pro ## Response -If successful, this method returns a `200 OK` response code and updated [outlookCategory](../resources/outlookcategory.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [outlookCategory](../resources/outlookcategory.md) object in the response body. ## Example-##### Request +### Request The following example shows a request. # [HTTP](#tab/http) Content-type: application/json -##### Response -The following example shows the response. Note: The response object shown here might be shortened for readability. +### Response +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", "truncated": true, |
v1.0 | Outlookuser List Mastercategories | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/outlookuser-list-mastercategories.md | Title: "List Outlook categories" -description: "Get all the categories that have been defined for the user." + Title: "List masterCategories" +description: "Get all the categories that have been defined for a user." ms.localizationpriority: medium doc_type: apiPageType -# List Outlook categories +# List masterCategories Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Get all the categories that have been defined for the user. +Get all the categories that have been defined for a user. [!INCLUDE [national-cloud-support](../../includes/global-us.md)] |
v1.0 | Overprovisionedawsresourcefinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/overprovisionedawsresourcefinding-get.md | description: "Read the properties and relationships of an overprovisionedAwsReso ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Overprovisionedawsresourcefinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/overprovisionedawsresourcefinding-list.md | description: "Get a list of the overprovisionedAwsResourceFinding objects and th ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Overprovisionedawsrolefinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/overprovisionedawsrolefinding-get.md | description: "Read the properties and relationships of an overprovisionedAwsRole ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Overprovisionedawsrolefinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/overprovisionedawsrolefinding-list.md | description: "Get a list of the overprovisionedAwsRoleFinding objects and their ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Overprovisionedazureserviceprincipalfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/overprovisionedazureserviceprincipalfinding-get.md | description: "Read the properties and relationships of an overprovisionedAzureSe ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Overprovisionedazureserviceprincipalfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/overprovisionedazureserviceprincipalfinding-list.md | description: "Get a list of the overprovisionedAzureServicePrincipalFinding obje ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Overprovisionedgcpserviceaccountfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/overprovisionedgcpserviceaccountfinding-get.md | description: "Read the properties and relationships of an overprovisionedGcpServ ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Overprovisionedgcpserviceaccountfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/overprovisionedgcpserviceaccountfinding-list.md | description: "Get a list of the overprovisionedGcpServiceAccountFinding objects ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Overprovisionedserverlessfunctionfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/overprovisionedserverlessfunctionfinding-get.md | description: "Read the properties and relationships of an overprovisionedServerl ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Overprovisionedserverlessfunctionfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/overprovisionedserverlessfunctionfinding-list.md | description: "Get a list of the overprovisionedServerlessFunctionFinding objects ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Overprovisioneduserfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/overprovisioneduserfinding-get.md | description: "Read the properties and relationships of an overprovisionedUserFin ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Overprovisioneduserfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/overprovisioneduserfinding-list.md | description: "Get a list of the overprovisionedUserFinding objects and their pro ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Partner Security Partnersecurityalert Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/partner-security-partnersecurityalert-get.md | + + Title: "Get partnerSecurityAlert" +description: "Read the properties of a partnerSecurityAlert object." ++ms.localizationpriority: medium ++++# Get partnerSecurityAlert ++Namespace: microsoft.graph.partner.security +++Read the properties and relationships of a [partnerSecurityAlert](../resources/partner-security-partnersecurityalert.md) object. ++## 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": "partner-permissions" +} +--> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/partner/securityAlerts/{partnerSecurityAlertId} +``` ++## Optional query parameters ++This method supports the `$count`, `$filter`, and `$select` 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 [microsoft.graph.partner.security.partnerSecurityAlert](../resources/partner-security-partnersecurityalert.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. +<!-- { + "blockType": "request", + "name": "get_partnersecurityalert" +} +--> +``` http +GET https://graph.microsoft.com/beta/security/partner/securityAlerts/d8b202fc-a216-3404-69ef-bdffa445eff6 +``` ++### 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.partner.security.partnerSecurityAlert" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "id": "d8b202fc-a216-3404-69ef-bdffa445eff6", + "displayName": "Action Required: Virtual machine connecting to crypto currency mining pool Detected", + "description": "Analysis of Azure resource network activity detected the resource was connecting to a crypto currency mining pool. This would often be an indication that your Azure resource is compromised.", + "alertType": "networkConnectionsToCryptoMiningPools", + "status": "active", + "severity": "high", + "confidenceLevel": "medium", + "customerTenantId": "1889e718-414b-4bad-8bbe-c1135bd39a41", + "subscriptionId": "5f6e6521-6e5f-4b0b-80aa-bd44fad7a398", + "valueAddedResellerTenantId": "c296b2ce-8cd1-4346-9e82-d8eccca70d65", + "catalogOfferId": "MS-AZR-0017G", + "detectedDateTime": "2024-01-23T16:03:33.05Z", + "firstObservedDateTime": "2024-01-23T16:03:33.05Z", + "lastObservedDateTime": "2024-01-23T16:03:33.05Z", + "resolvedReason": "fraud", + "resolvedOnDateTime": "2024-02-23T16:03:33.05Z", + "resolvedBy": "danas@contoso.com", + "isTest": false, + "affectedResources": [ + { + "resourceId": "/subscriptions/subscription-id/resourceGroups/resourcegroup-name/providers/Microsoft.Compute/virtualMachines/vm-name", + "resourceType": "AzureResource" + } + ], + "activityLogs": [ + { + "statusFrom": "active", + "statusTo": "investigating", + "updatedBy": "samanthab@contoso.com", + "updatedDateTime": "2023-08-10T08:47:10.8454142Z" + }, + { + "statusFrom": "investigating", + "statusTo": "resolved", + "updatedBy": "samanthab@contoso.com", + "updatedDateTime": "2023-08-10T08:47:25.2089246Z" + } + ], + "additionalDetails": { + "VM_IP": "[ \"vm-ip\"]", + "MiningPool_IP": "[ \"mining-pool-ip\"]", + "ConnectionCount": "5", + "CryptoCurrencyMiningPoolDomainName": "pool-name.com" + } +} +``` + |
v1.0 | Partner Security Partnersecurityalert List Securityalerts | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/partner-security-partnersecurityalert-list-securityalerts.md | + + Title: "List securityAlerts" +description: "Get a list of the partnerSecurityAlert objects and their properties." ++ms.localizationpriority: medium ++++# List securityAlerts ++Namespace: microsoft.graph.partner.security +++Get a list of the [partnerSecurityAlert](../resources/partner-security-partnersecurityalert.md) objects and their properties. ++## 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": "partner-permissions" +} +--> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/partner/securityAlerts +``` ++## Optional query parameters ++This method supports the `$count`, `$filter`, and `$select` 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 [microsoft.graph.partner.security.partnerSecurityAlert](../resources/partner-security-partnersecurityalert.md) objects in the response body. ++## Examples ++### Request ++The following example shows a request. +<!-- { + "blockType": "request", + "name": "list_partnersecurityalert" +} +--> +``` http +GET https://graph.microsoft.com/beta/security/partner/securityAlerts +``` ++### 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.partner.security.partnerSecurityAlert)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "id": "d8b202fc-a216-3404-69ef-bdffa445eff6", + "displayName": "Action Required: Virtual machine connecting to crypto currency mining pool Detected", + "description": "Analysis of Azure resource network activity detected the resource was connecting to a crypto currency mining pool. This would often be an indication that your Azure resource is compromised.", + "alertType": "networkConnectionsToCryptoMiningPools", + "status": "active", + "severity": "high", + "confidenceLevel": "medium", + "customerTenantId": "1889e718-414b-4bad-8bbe-c1135bd39a41", + "subscriptionId": "5f6e6521-6e5f-4b0b-80aa-bd44fad7a398", + "valueAddedResellerTenantId": "c296b2ce-8cd1-4346-9e82-d8eccca70d65", + "catalogOfferId": "MS-AZR-0017G", + "detectedDateTime": "2024-01-23T16:03:33.05Z", + "firstObservedDateTime": "2024-01-23T16:03:33.05Z", + "lastObservedDateTime": "2024-01-23T16:03:33.05Z", + "resolvedReason": "fraud", + "resolvedOnDateTime": "2024-02-23T16:03:33.05Z", + "resolvedBy": "danas@contoso.com", + "isTest": false, + "affectedResources": [ + { + "resourceId": "/subscriptions/subscription-id/resourceGroups/resourcegroup-name/providers/Microsoft.Compute/virtualMachines/vm-name", + "resourceType": "AzureResource" + } + ], + "activityLogs": [ + { + "statusFrom": "active", + "statusTo": "investigating", + "updatedBy": "samanthab@contoso.com", + "updatedDateTime": "2023-08-10T08:47:10.8454142Z" + }, + { + "statusFrom": "investigating", + "statusTo": "resolved", + "updatedBy": "samanthab@contoso.com", + "updatedDateTime": "2023-08-10T08:47:25.2089246Z" + } + ], + "additionalDetails": { + "VM_IP": "[ \"vm-ip\"]", + "MiningPool_IP": "[ \"mining-pool-ip\"]", + "ConnectionCount": "5", + "CryptoCurrencyMiningPoolDomainName": "pool-name.com" + } + }, + { + "id": "5f6e6521-6e5f-4b0b-80aa-bd44fad7a398-758e2259-f00b-4dec-8087-0950afe6d6a4", + "displayName": "Action Required: Subscription Usage Anomaly Detected", + "description": "Analysis of Azure resource detected anomalies in: Anomalous increase in Machine Learning General purpose CPU deployment regions compared to trend in the last 30 days Subscription is part of a cluster of subscriptions that are controlled from the same login session IP Address.", + "alertType": "usageAnomalyDetection", + "status": "investigating", + "severity": "high", + "confidenceLevel": "medium", + "customerTenantId": "1889e718-414b-4bad-8bbe-c1135bd39a41", + "subscriptionId": "5f6e6521-6e5f-4b0b-80aa-bd44fad7a398", + "valueAddedResellerTenantId": "c296b2ce-8cd1-4346-9e82-d8eccca70d65", + "catalogOfferId": null, + "detectedDateTime": "2024-01-23T16:03:33.05Z", + "firstObservedDateTime": "2024-01-23T16:03:33.05Z", + "lastObservedDateTime": "2024-01-23T16:03:33.05Z", + "resolvedReason": null, + "resolvedOnDateTime": null, + "resolvedBy": "danas@contoso.com", + "isTest": false, + "affectedResources": [ + { + "resourceId": "/subscriptions/subscription-id/resourceGroups/resourcegroup-name/providers/Microsoft.Compute/virtualMachines/vm-name", + "resourceType": "AzureResource" + } + ], + "activityLogs": [ + { + "statusFrom": "active", + "statusTo": "investigating", + "updatedBy": "samanthab@contoso.com", + "updatedDateTime": "2023-08-10T08:47:10.8454142Z" + } + ], + "additionalDetails": { + "VM_IP": "[ \"vm-ip\"]", + "MiningPool_IP": "[ \"mining-pool-ip\"]", + "ConnectionCount": "5", + "CryptoCurrencyMiningPoolDomainName": "pool-name.com" + } + } + ] +} +``` + |
v1.0 | Partner Security Partnersecurityalert Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/partner-security-partnersecurityalert-update.md | + + Title: "Update partnerSecurityAlert" +description: "Update the properties of a partnerSecurityAlert object." ++ms.localizationpriority: medium ++++# Update partnerSecurityAlert ++Namespace: microsoft.graph.partner.security +++Update the properties of a [partnerSecurityAlert](../resources/partner-security-partnersecurityalert.md) object. ++## 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": "partner-permissions" +} +--> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /security/partner/securityAlerts/{partnerSecurityAlertId} +``` ++## 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 ++++|Property|Type|Description| +|:|:|:| +|status|microsoft.graph.partner.security.securityAlertStatus|The status of the alert. The possible values are: `active`, `resolved`, `investigating`, `unknownFutureValue`. Required.| +|resolvedReason|microsoft.graph.partner.security.securityAlertResolvedReason|The reason provided by the partner for addressing the alert. The possible values are: `legitimate`, `ignore`, `fraud`, `unknownFutureValue`. Optional.| +++## Response ++If successful, this method returns a `200 OK` response code and an updated [microsoft.graph.partner.security.partnerSecurityAlert](../resources/partner-security-partnersecurityalert.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. +<!-- { + "blockType": "request", + "name": "update_partnersecurityalert" +} +--> +``` http +PATCH https://graph.microsoft.com/beta/security/partner/securityAlerts/d8b202fc-a216-3404-69ef-bdffa445eff6 +Content-Type: application/json ++{ + "status": "resolved", + "resolvedReason": "fraud" +} +``` ++### 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.partner.security.partnerSecurityAlert" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++ { + "id": "d8b202fc-a216-3404-69ef-bdffa445eff6", + "displayName": "Action Required: Virtual machine connecting to crypto currency mining pool Detected", + "description": "Analysis of Azure resource network activity detected the resource was connecting to a crypto currency mining pool. This would often be an indication that your Azure resource is compromised.", + "alertType": "networkConnectionsToCryptoMiningPools", + "status": "active", + "severity": "high", + "confidenceLevel": "medium", + "customerTenantId": "1889e718-414b-4bad-8bbe-c1135bd39a41", + "subscriptionId": "5f6e6521-6e5f-4b0b-80aa-bd44fad7a398", + "valueAddedResellerTenantId": "c296b2ce-8cd1-4346-9e82-d8eccca70d65", + "catalogOfferId": "MS-AZR-0017G", + "detectedDateTime": "2024-01-23T16:03:33.05Z", + "firstObservedDateTime": "2024-01-23T16:03:33.05Z", + "lastObservedDateTime": "2024-01-23T16:03:33.05Z", + "resolvedReason": "fraud", + "resolvedOnDateTime": "2024-02-23T16:03:33.05Z", + "resolvedBy": "danas@contoso.com", + "isTest": false, + "affectedResources": [ + { + "resourceId": "/subscriptions/subscription-id/resourceGroups/resourcegroup-name/providers/Microsoft.Compute/virtualMachines/vm-name", + "resourceType": "AzureResource" + } + ], + "activityLogs": [ + { + "statusFrom": "active", + "statusTo": "investigating", + "updatedBy": "samanthab@contoso.com", + "updatedDateTime": "2023-08-10T08:47:10.8454142Z" + }, + { + "statusFrom": "investigating", + "statusTo": "resolved", + "updatedBy": "samanthab@contoso.com", + "updatedDateTime": "2023-08-10T08:47:25.2089246Z" + } + ], + "additionalDetails": { + "VM_IP": "[ \"vm-ip\"]", + "MiningPool_IP": "[ \"mining-pool-ip\"]", + "ConnectionCount": "5", + "CryptoCurrencyMiningPoolDomainName": "pool-name.com" + } +} +``` + |
v1.0 | Partners Billing Billedreconciliation Export | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/partners-billing-billedreconciliation-export.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/billedreconciliationthisexport-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/billedreconciliationthisexport-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Pendingexternaluserprofile Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/pendingexternaluserprofile-get.md | description: "Get a pendingExternalUserProfile object." ms.localizationpriority: medium doc_type: apiPageType + GET https://graph.microsoft.com/beta/directory/pendingExternalUserProfiles/{id} [!INCLUDE [sample-code](../includes/snippets/php/get-pendingexternaluserprofile-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-pendingexternaluserprofile-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Pendingexternaluserprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/pendingexternaluserprofile-update.md | Title: "Update pendingExternalUserProfile" description: "Update the properties of a pendingExternalUserProfile object." + ms.localizationpriority: medium doc_type: apiPageType Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/update-pendingexternaluserprofile-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/update-pendingexternaluserprofile-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Peopleadminsettings List Iteminsights | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/peopleadminsettings-list-iteminsights.md | + + Title: "List insightsSettings" +description: "Retrieve properties of insightsSettings object for displaying or returning item insights in an organization." ++ms.localizationpriority: medium ++++# List insightsSettings ++Namespace: microsoft.graph +++Get the properties of an [insightsSettings](../resources/insightssettings.md) object for displaying or returning item insights in an organization. ++To learn how to customize the privacy of item insights in an organization, see [Customize item insights privacy](/graph/insights-customize-item-insights-privacy). +++## 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": "peopleadminsettings_list_iteminsights" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /admin/people/itemInsights +``` ++## Request headers ++|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## 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 [insightsSettings](../resources/insightssettings.md) objects in the response body. ++## Examples ++### Request ++The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "list_iteminsights" +} +--> +``` http +GET https://graph.microsoft.com/beta/admin/people/itemInsights +``` ++# [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. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.insightsSettings", + "name": "list_iteminsights" +}--> ++``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "isEnabledInOrganization": true, + "disabledForGroup": "edbfe4fb-ec70-4300-928f-dbb2ae86c981" +} +``` |
v1.0 | Permissionsanalytics List Permissionscreepindexdistributions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/permissionsanalytics-list-permissionscreepindexdistributions.md | description: "Get a list of the permissionsCreepIndexDistribution objects and th ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Permissionscreepindexdistribution Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/permissionscreepindexdistribution-get.md | description: "Read the properties and relationships of a permissionsCreepIndexDi ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Permissionsmanagement List Permissionsrequestchanges | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/permissionsmanagement-list-permissionsrequestchanges.md | description: "List the permissionsRequestChange objects and their properties." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Permissionsmanagement Post Scheduledpermissionsrequests | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/permissionsmanagement-post-scheduledpermissionsrequests.md | description: "Create a new scheduledPermissionsRequest object." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Planner Post Plans | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/planner-post-plans.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Create a new [plannerPlan](../resources/plannerplan.md). +Create a new [plannerPlan](../resources/plannerplan.md) object. [!INCLUDE [national-cloud-support](../../includes/global-us.md)] The following table lists the properties that are required when you create a [pl |container|[plannerPlanContainer](../resources/plannerplancontainer.md)|Identifies the container of the plan. Specify only the **url**, the **containerId** and **type**, or all properties. You can only change this property by moving a plan from one container to another using [plan move to container](../api/plannerplan-movetocontainer.md).| |title|String|The title of the plan.| ->**Note:** If the container is a Microsoft 365 group, the user who is creating the plan must be a member of the group that will contain the plan. When you create a new group by using [Create group](../api/group-post-groups.md), you are not added to the group as a member. After the group is created, add yourself as a member by using [group post members](../api/group-post-members.md). +>**Note:** If the container is a Microsoft 365 group, the user who creates the plan must be a member of the group that contains the plan. When you create a new group by using [Create group](../api/group-post-groups.md), you aren't added to the group as a member. After the group is created, add yourself as a member by using [group post members](../api/group-post-members.md). ## Response |
v1.0 | Plannertask Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/plannertask-update.md | PATCH /planner/tasks/{id} | Property | Type |Description| |:|:--|:-|-|appliedCategories|[plannerAppliedCategories](../resources/plannerappliedcategories.md)|specifies the categories to which the planner task has been applied. See [applied Categories](../resources/plannerappliedcategories.md) for possible values.| -|assigneePriority|String|Hint used to order items of this type in a list view. The format is defined as outlined [here](../resources/planner-order-hint-format.md).| +|appliedCategories|[plannerAppliedCategories](../resources/plannerappliedcategories.md)|Specifies the categories to which the Planner task was applied. See [applied Categories](../resources/plannerappliedcategories.md) for possible values.| +|assigneePriority|String|Hint used to order items of this type in a list view. The format is defined in [Using order hints in Planner](../resources/planner-order-hint-format.md).| |assignments|[plannerAssignments](../resources/plannerassignments.md)|The set of users the task is assigned to.|-|bucketId|String|Bucket ID to which the task belongs. The bucket needs to be in the plan that the task is in. It's 28 characters long and case-sensitive. [Format validation](../resources/tasks-identifiers-disclaimer.md) is done on the service. | +|bucketId|String|Bucket ID to which the task belongs. The bucket needs to be in the plan that the task is in. This value 28 characters long and case-sensitive. [Format validation](../resources/tasks-identifiers-disclaimer.md) is done on the service. | |conversationThreadId|String|Thread ID of the conversation on the task and is the ID of the conversation thread object created in the group.| |dueDateTime|DateTimeOffset|Date and time at which the task is due. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| |orderHint|String|Hint used to order items of this type in a list view. The format is defined as outlined [here](../resources/planner-order-hint-format.md).| PATCH /planner/tasks/{id} |startDateTime|DateTimeOffset|Date and time at which the task starts. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| |title|String|Title of the task.| +> [!NOTE] +> For Project tasks that are replicated to Planner, only the **percentComplete** property can be updated. + ## Response -If successful, this method returns a `204 No Content` response code and an empty content. If the request specifies the `Prefer` header with a `return=representation` preference, then this method returns a `200 OK` response code and an updated [plannerTask](../resources/plannertask.md) object in the response body. +If successful, this method returns a `204 No Content` response code and an empty content. If the request specifies the `Prefer` header with a `return=representation` preference, this method returns a `200 OK` response code and an updated [plannerTask](../resources/plannertask.md) object in the response body. This method can return any of the [HTTP status codes](/graph/errors). The most common errors that apps should handle for this method are the 400, 403, 404, 409, and 412 responses. For more information about these errors, see [Common Planner error conditions](../resources/planner-overview.md#common-planner-error-conditions). |
v1.0 | Planneruser List Mydaytasks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/planneruser-list-mydaytasks.md | + + Title: "List myDayTasks" +description: "Retrieve a list of planner tasks to be shown in the user's My Day view.My Day is a view within planner app which will show all the tasks, a user has to focus today based on either user adds the task to the view or the due date of the task is today." +ms.localizationpriority: medium ++++# List myDayTasks ++Namespace: microsoft.graph +++Retrieve a list of [plannerTask](../resources/plannertask.md) objects to be shown in the user's My Day view within Planner. This method returns the list of tasks that the user added to the My Day view or that are due today. +++## 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": "planneruser_list_mydaytasks" } --> ++## HTTP request +<!-- { "blockType": "ignored" } --> +```http +GET /me/planner/myDayTasks +GET /users/{id}/planner/myDayTasks +``` ++## 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 collection of [plannerTask](../resources/plannertask.md) objects in the response body. ++This method can return any of the [HTTP status codes](/graph/errors). The most common errors that apps should handle for this method are the 403 and 404 responses. For more information about these errors, see [Common Planner error conditions](../resources/planner-overview.md#common-planner-error-conditions). ++## Examples +### Request +The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "planneruser_get_mydaytasks" +}--> +```msgraph-interactive +GET https://graph.microsoft.com/beta/me/planner/myDayTasks +``` ++# [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. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.plannerTask", + "isCollection": true +} --> +```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "value": [ + { + "createdBy": { + "user": { + "id": "6463a5ce-2119-4198-9f2a-628761df4a62" + } + }, + "planId": "xqQg5FS2LkCp935s-FIFm2QAFkHM", + "bucketId": "gcrYAaAkgU2EQUvpkNNXLGQAGTtu", + "title": "title-value", + "orderHint": "9223370609546166567W", + "assigneePriority": "90057581\"", + "createdDateTime": "2015-03-25T18:36:49.2407981Z", + "isOnMyDay": true, + "id":"01gzSlKkIUSUl6DF_EilrmQAKDhh" + } + ] +} +``` |
v1.0 | Policyroot List Federatedtokenvalidationpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/policyroot-list-federatedtokenvalidationpolicy.md | Namespace: microsoft.graph Get a list of the [federatedTokenValidationPolicy](../resources/federatedtokenvalidationpolicy.md) objects and their properties. + ## 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). Choose the permission or permissions marked as least privileged for this API. Us --> [!INCLUDE [permissions-table](../includes/permissions/policyroot-list-federatedtokenvalidationpolicy-permissions.md)] + ## HTTP request <!-- { |
v1.0 | Printershare Delete Allowedgroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/printershare-delete-allowedgroup.md | DELETE https://graph.microsoft.com/beta/print/shares/{id}/allowedGroups/{id}/$re [!INCLUDE [sample-code](../includes/snippets/php/delete-allowedgroup-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -# [PowerShell](#tab/powershell) - # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-allowedgroup-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Printershare Delete Alloweduser | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/printershare-delete-alloweduser.md | DELETE https://graph.microsoft.com/beta/print/printerShares/{id}/allowedUsers/{i [!INCLUDE [sample-code](../includes/snippets/php/delete-alloweduser-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -# [PowerShell](#tab/powershell) - # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-alloweduser-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Privilegeescalationawsresourcefinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/privilegeescalationawsresourcefinding-get.md | description: "Read the properties and relationships of a privilegeEscalationAwsR ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Privilegeescalationawsresourcefinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/privilegeescalationawsresourcefinding-list.md | description: "Get a list of the privilegeEscalationAwsResourceFinding objects an ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Privilegeescalationawsrolefinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/privilegeescalationawsrolefinding-get.md | description: "Read the properties and relationships of a privilegeEscalationAwsR ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Privilegeescalationawsrolefinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/privilegeescalationawsrolefinding-list.md | description: "Get a list of the privilegeEscalationAwsRoleFinding objects and th ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Privilegeescalationgcpserviceaccountfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/privilegeescalationgcpserviceaccountfinding-get.md | description: "Read the properties and relationships of a privilegeEscalationGcpS ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Privilegeescalationgcpserviceaccountfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/privilegeescalationgcpserviceaccountfinding-list.md | description: "Get a list of the privilegeEscalationGcpServiceAccountFinding obje ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Privilegeescalationuserfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/privilegeescalationuserfinding-get.md | description: "Read the properties and relationships of a privilegeEscalationUser ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Privilegeescalationuserfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/privilegeescalationuserfinding-list.md | description: "Get a list of the privilegeEscalationUserFinding objects and their ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Profilephoto Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/profilephoto-delete.md | Delete the photo for the signed-in user or the specified group. > > The delete operation supports only user or group photos, but _not Outlook contact nor Teams photos_. + ## Permissions The following tables show the least privileged permission or permissions required to call this API on each supported resource type. Follow [best practices](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions) to request the least privileged 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). The following example shows a request. DELETE https://graph.microsoft.com/beta/me/photo/$value ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/delete-profilephoto-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) ++# [Python](#tab/python) + ### Response |
v1.0 | Regionalandlanguagesettings Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/regionalandlanguagesettings-get.md | Title: "Get regionalAndLanguageSettings resource" description: "Retrieve the properties of a user's regionalAndLanguageSettings" ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Regionalandlanguagesettings Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/regionalandlanguagesettings-update.md | Title: "Update regionalAndLanguageSettings" description: "Update the regional and language settings of a user." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Remotedesktopsecurityconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/remotedesktopsecurityconfiguration-get.md | Namespace: microsoft.graph Read the properties and relationships of a [remoteDesktopSecurityConfiguration](../resources/remotedesktopsecurityconfiguration.md) object on a servicePrincipal. Use this configuration to view the Microsoft Entra ID [Remote Desktop Services (RDS) authentication protocol](/openspecs/windows_protocols/ms-rdpbcgr/dc43f040-d75d-49a9-90c6-0c9999281136) to authenticate a user to [Microsoft Entra joined](/azure/active-directory/devices/concept-directory-join) or [Microsoft Entra hybrid joined](/azure/active-directory/devices/concept-hybrid-join) devices. Additionally you can view any targetDeviceGroups that have been configured for SSO. ## 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). |
v1.0 | Remotedesktopsecurityconfiguration List Targetdevicegroups | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/remotedesktopsecurityconfiguration-list-targetdevicegroups.md | Namespace: microsoft.graph Get a list of the [targetDeviceGroup](../resources/targetdevicegroup.md) objects and their properties on the remoteDesktopSecurityConfiguration resource on the servicePrincipal. Any user authenticating using the Microsoft Entra ID [Remote Desktop Services (RDS) authentication protocol](/openspecs/windows_protocols/ms-rdpbcgr/dc43f040-d75d-49a9-90c6-0c9999281136) to a [Microsoft Entra joined](/azure/active-directory/devices/concept-directory-join) or [Microsoft Entra hybrid joined](/azure/active-directory/devices/concept-hybrid-join) device that belongs to the targetDeviceGroup will get SSO. ## 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). |
v1.0 | Remotedesktopsecurityconfiguration Post Targetdevicegroups | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/remotedesktopsecurityconfiguration-post-targetdevicegroups.md | Namespace: microsoft.graph Create a new [targetDeviceGroup](../resources/targetdevicegroup.md) object for the remoteDesktopSecurityConfiguration object on the servicePrincipal. You can configure a maximum of 10 target device groups for the remoteDesktopSecurityConfiguraiton object on the servicePrincipal. ## 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). |
v1.0 | Remotedesktopsecurityconfiguration Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/remotedesktopsecurityconfiguration-update.md | Namespace: microsoft.graph Update the properties of a [remoteDesktopSecurityConfiguration](../resources/remotedesktopsecurityconfiguration.md) object on the servicePrincipal. Use this configuration to enable or disable the Microsoft Entra ID [Remote Desktop Services (RDS) authentication protocol](/openspecs/windows_protocols/ms-rdpbcgr/dc43f040-d75d-49a9-90c6-0c9999281136) to authenticate a user to [Microsoft Entra joined](/azure/active-directory/devices/concept-directory-join) or [Microsoft Entra hybrid joined](/azure/active-directory/devices/concept-hybrid-join) devices. ## 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). |
v1.0 | Samlorwsfedexternaldomainfederation Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/samlorwsfedexternaldomainfederation-delete.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "samlorwsfedexternaldomainfederation_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/samlorwsfedexternaldomainfederation-delete-permissions.md)] -The work or school account needs to belong to one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Samlorwsfedexternaldomainfederation Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/samlorwsfedexternaldomainfederation-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "samlorwsfedexternaldomainfederation_get" } --> [!INCLUDE [permissions-table](../includes/permissions/samlorwsfedexternaldomainfederation-get-permissions.md)] -The work or school account needs to belong to one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Samlorwsfedexternaldomainfederation List Domains | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/samlorwsfedexternaldomainfederation-list-domains.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "samlorwsfedexternaldomainfederation_list_domains" } --> [!INCLUDE [permissions-table](../includes/permissions/samlorwsfedexternaldomainfederation-list-domains-permissions.md)] -The work or school account needs to belong to one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Samlorwsfedexternaldomainfederation List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/samlorwsfedexternaldomainfederation-list.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "samlorwsfedexternaldomainfederation_list" } --> [!INCLUDE [permissions-table](../includes/permissions/samlorwsfedexternaldomainfederation-list-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Samlorwsfedexternaldomainfederation Post Domains | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/samlorwsfedexternaldomainfederation-post-domains.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "samlorwsfedexternaldomainfederation_post_domains" } --> [!INCLUDE [permissions-table](../includes/permissions/samlorwsfedexternaldomainfederation-post-domains-permissions.md)] -The work or school account needs to belong to one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Samlorwsfedexternaldomainfederation Post | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/samlorwsfedexternaldomainfederation-post.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "samlorwsfedexternaldomainfederation_post" } --> [!INCLUDE [permissions-table](../includes/permissions/samlorwsfedexternaldomainfederation-post-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Samlorwsfedexternaldomainfederation Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/samlorwsfedexternaldomainfederation-update.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "samlorwsfedexternaldomainfederation_update" } --> [!INCLUDE [permissions-table](../includes/permissions/samlorwsfedexternaldomainfederation-update-permissions.md)] -The work or school account needs to belong to one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Schedule List Timeoffreasons | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/schedule-list-timeoffreasons.md | Get the list of [timeOffReasons](../resources/timeoffreason.md) in a [schedule]( ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Group.Read.All, Group.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.Read.All*, Schedule.ReadWrite.All* | +This API supports admin permissions. Global admins can access groups that they aren't a member of. ->\* **Important:** Application permissions are currently in private preview only and are not available for public use. +<!-- { "blockType": "permissions", "name": "schedule_list_timeoffreasons" } --> -> **Note**: This API supports admin permissions. Global admins can access groups that they are not a member of. +> [!NOTE] +> The Schedule.Read.All and Schedule.ReadWrite.All application permissions are currently in private preview only and are not available for public use. ## HTTP request |
v1.0 | Schedule Post Timeoffreasons | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/schedule-post-timeoffreasons.md | Create a new [timeOffReason](../resources/timeoffreason.md). One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +This API supports admin permissions. Global admins can access groups that they aren't a member of. + |Permission type | Permissions (from least to most privileged) | |:--|:| |Delegated (work or school account) | Group.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. | |Application | Schedule.ReadWrite.All* | ->\* **Important:** Application permissions are currently in private preview only and are not available for public use. --> **Note**: This API supports admin permissions. Global admins can access groups that they are not a member of. +> [!NOTE] +> The Schedule.ReadWrite.All application permission is currently in private preview only and isn't available for public use. ## HTTP request |
v1.0 | Schedule Post Timesoff | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/schedule-post-timesoff.md | Create a new [timeOff](../resources/timeoff.md) instance in a [schedule](../reso ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Group.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.ReadWrite.All* | +This API supports admin permissions. Global admins can access groups that they aren't a member of. ->\* **Important:** Application permissions are currently in private preview only and are not available for public use. +<!-- { "blockType": "permissions", "name": "schedule_post_timesoff" } --> -> **Note**: This API supports admin permissions. Global admins can access groups that they are not a member of. +> [!NOTE] +> The Schedule.ReadWrite.All application permission is currently in private preview only and isn't available for public use. ## HTTP request |
v1.0 | Scheduledpermissionsrequest Cancelall | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/scheduledpermissionsrequest-cancelall.md | description: "Cancel a scheduled permission request." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Schemaextension Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/schemaextension-delete.md | description: "Delete the definition of a schema extension." ms.localizationpriority: medium doc_type: apiPageType+ # Delete schemaExtension |
v1.0 | Schemaextension Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/schemaextension-get.md | description: "Get the properties of the specified schemaExtension definition." ms.localizationpriority: medium doc_type: apiPageType+ # Get schemaExtension |
v1.0 | Schemaextension List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/schemaextension-list.md | description: "Get a list of schemaExtension objects created by any apps you own ms.localizationpriority: medium doc_type: apiPageType+ # List schemaExtensions |
v1.0 | Schemaextension Post Schemaextensions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/schemaextension-post-schemaextensions.md | description: "Create a new schemaExtension definition to extend a supporting res ms.localizationpriority: medium doc_type: apiPageType+ # Create schemaExtension |
v1.0 | Schemaextension Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/schemaextension-update.md | description: "Update properties in the definition of the specified schemaExtensi ms.localizationpriority: medium doc_type: apiPageType+ # Update schemaExtension |
v1.0 | Search Query | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/search-query.md | Content-type: application/json - Search [mail messages](/graph/search-concept-messages) - Search [calendar events](/graph/search-concept-events) - Search [person](/graph/search-concept-person)-- Search content in SharePoint and OneDrive ([files, lists and sites](/graph/search-concept-files))+- Search content in SharePoint and OneDrive ([files, lists, and sites](/graph/search-concept-files)) - Search [custom types (Graph Connectors)](/graph/search-concept-custom-types) data - Search with [queryTemplate](/graph/search-concept-query-template) - [Sort](/graph/search-concept-sort) search results |
v1.0 | Search Searchentity Post Bookmarks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/search-searchentity-post-bookmarks.md | Content-Type: application/json "description": "Try or buy Contoso for Home or Business and view product information", "keywords": { "keywords": ["Contoso", "install"],- "reservedKeywords": ["Contoso"], + "reservedKeywords": ["Unique keyword"], "matchSimilarKeywords": true }, "availabilityStartDateTime": null, |
v1.0 | Secretinformationaccessawsresourcefinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/secretinformationaccessawsresourcefinding-get.md | description: "Read the properties and relationships of a secretInformationAccess ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Secretinformationaccessawsresourcefinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/secretinformationaccessawsresourcefinding-list.md | description: "Get a list of the secretInformationAccessAwsResourceFinding object ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Secretinformationaccessawsrolefinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/secretinformationaccessawsrolefinding-get.md | description: "Read the properties and relationships of a secretInformationAccess ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Secretinformationaccessawsrolefinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/secretinformationaccessawsrolefinding-list.md | description: "Get a list of the secretInformationAccessAwsRoleFinding objects an ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Secretinformationaccessawsserverlessfunctionfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/secretinformationaccessawsserverlessfunctionfinding-get.md | description: "Read the properties and relationships of a secretInformationAccess ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Secretinformationaccessawsserverlessfunctionfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/secretinformationaccessawsserverlessfunctionfinding-list.md | description: "Get a list of the secretInformationAccessAwsServerlessFunctionFind ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Secretinformationaccessawsuserfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/secretinformationaccessawsuserfinding-get.md | description: "Read the properties and relationships of a secretInformationAccess ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Secretinformationaccessawsuserfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/secretinformationaccessawsuserfinding-list.md | description: "Get a list of the secretInformationAccessAwsUserFinding objects an ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Security Analyzedemail Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-analyzedemail-get.md | Namespace: microsoft.graph.security Read the properties and relationships of an [analyzedEmail](../resources/security-analyzedemail.md) object. + ## 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). Choose the permission or permissions marked as least privileged for this API. Us GET /security/collaboration/analyzedEmails/{analyzedEmailId} ``` - ## Request headers |Name|Description| Content-Type: application/json { "value": { "@odata.type": "#microsoft.graph.security.analyzedEmail",- "id": "3570a93a-82b1-ffb9-8c26-a9a2ca002a17", - "loggedDateTime": "String (timestamp)", + "id": "String", + "loggedDateTime": "Datetime", "networkMessageId": "String", "internetMessageId": "String", "senderDetail": { "@odata.type": "microsoft.graph.security.analyzedEmailSenderDetail" },- "recipientEmailAddresses": [ - "String" - ], + "recipientEmailAddress": "String", "distributionList": "String", "subject": "String", "returnPath": "String",- "directionality": "String", + "directionality": "microsoft.graph.security.antispamDirectionality", "originalDelivery": { "@odata.type": "microsoft.graph.security.analyzedEmailDeliveryDetail" }, Content-Type: application/json "overrideSources": [ "String" ],- "threatType": "String", + "threatTypes": [ + "microsoft.graph.security.threatType" + ], "detectionMethods": [ "String" ], Content-Type: application/json } } ```- |
v1.0 | Security Analyzedemail Remediate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-analyzedemail-remediate.md | Remove a potential threat from end users' mailboxes. Remediation means to take prescribed action against a threat. This API can trigger email purge actions like move to junk, move to deleted items, soft delete, hard delete, or move to Inbox. This API enables scenarios and use cases such as SOAR integration, playbooks, and automations. For more information read [email remediation, trigger action and track actions](/microsoft-365/security/office-365-security/remediate-malicious-email-delivered-office-365?view=o365-worldwide&preserve-view=true). If there is false positives admins can take move to inbox action. + ## 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). The following table lists the parameters that are required when you call this ac |description|String| The description of the remediation. | |severity|microsoft.graph.security.remediationSeverity| The severity of the remediation. The possible values are: `low`, `medium`, `high`, `unknownFutureValue`.| |action|microsoft.graph.security.remediationAction|The types of move and delete actions that are supported. The possible values are: `moveToJunk`, `moveToInbox`, `hardDelete`, `softDelete`, `moveToDeletedItems`, `unknownFutureValue`.|-|approverUpn|String| Tracks who approved the action. | |remediateSendersCopy|Boolean| For internal or outbound email, indicates whether to remediate the sender's copy of an email. |-|analyzedEmails|[microsoft.graph.security.analyzedEmail](../resources/security-analyzedemail.md) collection|The unique ID of the analyzed email. The ID can be found from the analyzedemails, analyzedemails/Id or runHuntingQuery/reportId. +|analyzedEmails|[microsoft.graph.security.analyzedEmail](../resources/security-analyzedemail.md) collection| Contains the **networkMessageId** and **recipientEmailAddress** values of the analyzed emails. | ## Response Content-Type: application/json "severity": "medium", "action": "softDelete", "remediateSendersCopy": "false",- "analyzedEmails": [ - { - "id": "73ca4154-58d8-43d0-a890-08dc18c52e6d-1311265001240363512-1" - }, - { - "id": "73ca4154-58d8-43d0-a890-08dc18c52e6d-13805748846361900678-1" - } + "analyzedEmails": [ + { + "networkMessageId": "73ca4154-58d8-43d0-a890-08dc18c52e6d", + "recipientEmailAddress": "hannah.jarvis@contoso.com" + }, + { + "networkMessageId": "73ca4154-58d8-43d0-a890-08dc18c52e6d", + "recipientEmailAddress": "preston.morales@contoso.com" + } ] } ``` Location: https://security.microsoft.com/action-center/history?filters={"bulkId" Content-Type: application/json;text/plain Content-Length: 0 ```---- |
v1.0 | Security Authoritytemplate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-authoritytemplate-get.md | The following example shows a request. } --> ``` http-GET https://graph.microsoft.com/beta/security/labels/authorities/{authorityTemplateId} +GET https://graph.microsoft.com/beta/security/labels/authorities/6cf65e55-6baf-44ff-5dcc-08d8de97b1d5 ``` # [C#](#tab/csharp) GET https://graph.microsoft.com/beta/security/labels/authorities/{authorityTempl ### Response-The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json { "value": { "@odata.type": "#microsoft.graph.security.authorityTemplate",- "id": "a94af2e3-853b-6fcc-c898-d61d3a6d9efc", - "displayName": "String", + "id": "6cf65e55-6baf-44ff-5dcc-08d8de97b1d5", + "displayName": "Business", "createdBy": {- "@odata.type": "microsoft.graph.identitySet" - }, - "createdDateTime": "String (timestamp)" - } + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} } ``` |
v1.0 | Security Categorytemplate Delete Subcategories | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-categorytemplate-delete-subcategories.md | Title: "Delete subCategoryTemplate" -description: "Delete a subCategoryTemplate object." + Title: "Delete subcategoryTemplate" +description: "Delete a subcategoryTemplate object." ms.localizationpriority: medium doc_type: apiPageType -# Delete subCategoryTemplate +# Delete subcategoryTemplate Namespace: microsoft.graph.security [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Delete a [subCategoryTemplate](../resources/security-subcategorytemplate.md) object. +Delete a [subcategoryTemplate](../resources/security-subcategorytemplate.md) object. ## 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). Choose the permission or permissions marked as least privileged for this API. Us } --> ``` http-DELETE /security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate/subCategories/{subCategoryTemplateId}/$ref +DELETE /security/labels/categories/{categoryTemplateId}/subcategories/{subcategoryTemplateId}/$ref ``` ## Request headers The following example shows a request. } --> ``` http-DELETE https://graph.microsoft.com/beta/security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate/subCategories/{subCategoryTemplateId} +DELETE https://graph.microsoft.com/beta/security/labels/categories/6cf65e55-6baf-44ff-5dcc-08d8de97b1d5/subcategories/f44dkle55-6baf-44ff-5dcc-08d8de97b1d5 ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/delete-subcategorytemplate-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) + ### Response-The following example shows the response. +Here's an example of the response. > <!-- { "blockType": "response", |
v1.0 | Security Categorytemplate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-categorytemplate-get.md | GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemp ``` ## 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). +This method supports some of the OData query parameters to help customize the response. For example, to retrieve the **subcategories** property associated with this particular category, you can use the `expand` parameter:`$expand=subcategories`. For general information, see [OData query parameters](/graph/query-parameters). ## Request headers |Name|Description| The following example shows a request. } --> ``` http-GET https://graph.microsoft.com/beta/security/labels/categories/{categoryTemplateId} +GET https://graph.microsoft.com/beta/security/labels/categories/e2c79762-34a9-75ba-b6f0-a7c9a57978ef ``` # [C#](#tab/csharp) GET https://graph.microsoft.com/beta/security/labels/categories/{categoryTemplat ### Response-The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json "value": { "@odata.type": "#microsoft.graph.security.categoryTemplate", "id": "e2c79762-34a9-75ba-b6f0-a7c9a57978ef",- "displayName": "String", + "displayName": "Accounts payable", "createdBy": {- "@odata.type": "microsoft.graph.identitySet" - }, - "createdDateTime": "String (timestamp)" - } + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} } ``` |
v1.0 | Security Categorytemplate List Subcategories | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-categorytemplate-list-subcategories.md | Title: "List subCategories" -description: "Get the subCategoryTemplate resources from the subCategories navigation property." + Title: "List subcategories" +description: "Get a list of subcategoryTemplate resources associated with a category template." ms.localizationpriority: medium doc_type: apiPageType -# List subCategories +# List subcategories Namespace: microsoft.graph.security [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Get a list of subcategories [subCategoryTemplate](../resources/security-subcategorytemplate.md) associated with a category template. +Get a list of [subcategoryTemplate](../resources/security-subcategorytemplate.md) objects associated with a category template. + ## 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). Choose the permission or permissions marked as least privileged for this API. Us } --> ``` http-GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate/subCategories +GET /security/labels/categories/{categoryTemplateId}/subcategories ``` ## Optional query parameters Don't supply a request body for this method. ## Response -If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md) objects in the response body. ## Examples The following example shows a request. } --> ``` http-GET https://graph.microsoft.com/beta/security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate/subCategories +GET https://graph.microsoft.com/beta/security/labels/categories/{categoryTemplateId}/subcategories ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/list-subcategorytemplate-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) + ### Response The following example shows the response. <!-- { "blockType": "response", "truncated": true,- "@odata.type": "Collection(microsoft.graph.security.subCategoryTemplate)" + "@odata.type": "Collection(microsoft.graph.security.subcategoryTemplate)" } --> ``` http Content-Type: application/json { "value": [ {- "@odata.type": "#microsoft.graph.security.subCategoryTemplate", + "@odata.type": "#microsoft.graph.security.subcategoryTemplate", "id": "2ac39915-dbeb-e933-82e2-92b981835fa0",- "displayName": "String", + "displayName": "Vendor Invoice", "createdBy": {- "@odata.type": "microsoft.graph.identitySet" + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } },- "createdDateTime": "String (timestamp)" + "createdDateTime": "2021-03-24T02:09:08Z" } ] } |
v1.0 | Security Categorytemplate Post Subcategories | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-categorytemplate-post-subcategories.md | Title: "Create subCategoryTemplate" -description: "Create a new subCategoryTemplate object." + Title: "Create subcategoryTemplate" +description: "Create a new subcategoryTemplate object." ms.localizationpriority: medium doc_type: apiPageType -# Create subCategoryTemplate +# Create subcategoryTemplate Namespace: microsoft.graph.security [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Create a new [subCategoryTemplate](../resources/security-subcategorytemplate.md) object. +Create a new [subcategoryTemplate](../resources/security-subcategorytemplate.md) object. + ## 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). Choose the permission or permissions marked as least privileged for this API. Us } --> ``` http-POST /security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate/subCategories +POST /security/labels/categories/{categoryTemplateId}/subcategories ``` ## Request headers POST /security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTem |Content-Type|application/json. Required.| ## Request body-In the request body, supply a JSON representation of the [microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) object. +In the request body, supply a JSON representation of the [microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md) object. -You can specify the following properties when creating a **subCategoryTemplate**. +You can specify the following properties when creating a **subcategoryTemplate**. |Property|Type|Description| |:|:|:|-|displayName|String| Unique string that defines a sub-category name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptor.md). Optional.| +|displayName|String| Unique string that defines a subcategory name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptor.md). Optional.| ## Response--If successful, this method returns a `201 Created` response code and a [microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) object in the response body. +If successful, this method returns a `201 Created` response code and a [microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md) object in the response body. ## Examples The following example shows a request. } --> ``` http-POST https://graph.microsoft.com/beta/security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate/subCategories +POST https://graph.microsoft.com/beta/security/labels/categories/{categoryTemplateId}/subcategories Content-Type: application/json {- "@odata.type": "#microsoft.graph.security.subCategoryTemplate", - "displayName": "String", - "createdBy": { - "@odata.type": "microsoft.graph.identitySet" - } + "@odata.type": "#microsoft.graph.security.subcategoryTemplate", + "displayName": "Vendor Invoice", } ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/create-subcategorytemplate-from--javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) + ### Response-The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", "truncated": true,- "@odata.type": "microsoft.graph.security.subCategoryTemplate" + "@odata.type": "microsoft.graph.security.subcategoryTemplate" } --> ``` http HTTP/1.1 201 Created Content-Type: application/json {- "@odata.type": "#microsoft.graph.security.subCategoryTemplate", + "@odata.type": "#microsoft.graph.security.subcategoryTemplate", "id": "2ac39915-dbeb-e933-82e2-92b981835fa0",- "displayName": "String", - "createdBy": { - "@odata.type": "microsoft.graph.identitySet" - }, - "createdDateTime": "String (timestamp)" -} + "displayName": "Vendor Invoice", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-03-24T02:09:08Z" + } ``` |
v1.0 | Security Citationtemplate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-citationtemplate-get.md | The following example shows a request. } --> ``` http-GET https://graph.microsoft.com/beta/security/labels/citations/{citationTemplateId} +GET https://graph.microsoft.com/beta/security/labels/citations/c0475d01-d532-8a53-6e26-14ea58c640bf ``` # [C#](#tab/csharp) GET https://graph.microsoft.com/beta/security/labels/citations/{citationTemplate ### Response-The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json "value": { "@odata.type": "#microsoft.graph.security.citationTemplate", "id": "c0475d01-d532-8a53-6e26-14ea58c640bf",- "displayName": "String", + "displayName": "Contoso Company Policy", "createdBy": {- "@odata.type": "microsoft.graph.identitySet" - }, - "createdDateTime": "String (timestamp)", - "citationUrl": "String", - "citationJurisdiction": "String" + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z", + "citationUrl": "www.citationUrl.com", + "citationJurisdiction": "Contoso" } } ``` |
v1.0 | Security Collaborationroot List Analyzedemails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-collaborationroot-list-analyzedemails.md | Get a list of [analyzedEmail](../resources/security-analyzedemail.md) objects an This API allows Security Operations teams to have direct access to hunt (query) for threats, IOCs, attack vectors, and evidences for a tenant. It is a powerful, near real-time tool to help Security Operations teams investigate and respond to threats. It consists of email metadata, verdict information, related underlying entities (attachments/URL), filters, and more. + ## 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). In the request URL, provide the following required query parameters with values. ### OData query parameters -This method supports the following OData query parameters to help customize the response: `$count`, `$filter`, `$skip`, `$top`. For general information, see [OData query parameters](/graph/query-parameters). +This method supports the following OData query parameters to help customize the response: `$count`, `$filter`, `$skiptoken`, `$top`. For general information, see [OData query parameters](/graph/query-parameters). The following example shows how to use the `$filter` parameter to customize the response. <!-- { The following example shows how to use the `$filter` parameter to customize the } --> ``` http-GET /security/collaboration/analyzedemails?startTime=2024-02-18&endTime=2024-02-20&filter=NetworkMessageId eq 'bde1f764-bbf4-5673-fbba-0asdhsgfhf1' +GET /security/collaboration/analyzedemails?startTime=2024-02-18&endTime=2024-02-20&filter=networkMessageId eq 'bde1f764-bbf4-5673-fbba-0asdhsgfhf1' +GET /security/collaboration/analyzedemails?startTime=2024-02-18&endTime=2024-02-20&filter=networkMessageId eq 'bde1f764-bbf4-5673-fbba-0asdhsgfhf1' and recipientEmailAddress eq 'tomas.richardson@contoso.com' ``` ## Request headers The following example shows a request. GET https:security/collaboration/analyzedemails?startTime=2024-02-18&endTime=2024-02-20 ``` - ### Response The following example shows the response. Content-Type: application/json "value": [ { "@odata.type": "#microsoft.graph.security.analyzedEmail",- "id": "3570a93a-82b1-ffb9-8c26-a9a2ca002a17", - "loggedDateTime": "String (timestamp)", + "id": "String", + "loggedDateTime": "Datetime", "networkMessageId": "String", "internetMessageId": "String", "senderDetail": { "@odata.type": "microsoft.graph.security.analyzedEmailSenderDetail" },- "recipientEmailAddresses": [ - "String" - ], + "recipientEmailAddress": "String", "distributionList": "String", "subject": "String", "returnPath": "String",- "directionality": "String", + "directionality": "microsoft.graph.security.antispamDirectionality", "originalDelivery": { "@odata.type": "microsoft.graph.security.analyzedEmailDeliveryDetail" }, Content-Type: application/json "@odata.type": "microsoft.graph.security.analyzedEmailDeliveryDetail" }, "attachmentsCount": "Integer",- "attachments": [ - { - "@odata.type": "microsoft.graph.security.analyzedEmailAttachment" - } - ], "urlsCount": "Integer",- "urls": [ - { - "@odata.type": "microsoft.graph.security.analyzedEmailUrl" - } - ], "language": "String", "sizeInBytes": "Integer", "alertIds": [ Content-Type: application/json "overrideSources": [ "String" ],- "threatType": "String", + "threatTypes": [ + "microsoft.graph.security.threatType" + ], "detectionMethods": [ "String" ], Content-Type: application/json ] } ```- |
v1.0 | Security Departmenttemplate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-departmenttemplate-get.md | The following example shows a request. } --> ``` http-GET https://graph.microsoft.com/beta/security/labels/departments/{departmentTemplateId} +GET https://graph.microsoft.com/beta/security/labels/departments/11b44677-9f06-c85a-4a0b-766b66904bf8 ``` # [C#](#tab/csharp) GET https://graph.microsoft.com/beta/security/labels/departments/{departmentTemp ### Response-The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json "value": { "@odata.type": "#microsoft.graph.security.departmentTemplate", "id": "11b44677-9f06-c85a-4a0b-766b66904bf8",- "displayName": "String", + "displayName": "Finance", "createdBy": {- "@odata.type": "microsoft.graph.identitySet" - }, - "createdDateTime": "String (timestamp)" - } + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} } ``` |
v1.0 | Security Detectionrule Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-detectionrule-delete.md | DELETE https://graph.microsoft.com/beta/security/rules/detectionRules/302 [!INCLUDE [sample-code](../includes/snippets/php/delete-detectionrule-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-detectionrule-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Security Detectionrule Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-detectionrule-get.md | GET https://graph.microsoft.com/beta/security/rules/detectionRules/7506 [!INCLUDE [sample-code](../includes/snippets/php/get-detectionrule-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-detectionrule-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Security Detectionrule List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-detectionrule-list.md | GET https://graph.microsoft.com/beta/security/rules/detectionRules?$top=3 [!INCLUDE [sample-code](../includes/snippets/php/list-detectionrule-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-detectionrule-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Security Fileplanreferencetemplate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-fileplanreferencetemplate-get.md | The following example shows a request. } --> ``` http-GET https://graph.microsoft.com/beta/security/labels/filePlanReferences/{filePlanReferenceTemplateId} +GET https://graph.microsoft.com/beta/security/labels/filePlanReferences/b1f7b518-a44f-1d4b-c6f1-ab8771d3907c ``` # [C#](#tab/csharp) GET https://graph.microsoft.com/beta/security/labels/filePlanReferences/{filePla ### Response-The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json "value": { "@odata.type": "#microsoft.graph.security.filePlanReferenceTemplate", "id": "b1f7b518-a44f-1d4b-c6f1-ab8771d3907c",- "displayName": "String", + "displayName": "FIN 01-02-001", "createdBy": {- "@odata.type": "microsoft.graph.identitySet" - }, - "createdDateTime": "String (timestamp)" - } + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} } ``` |
v1.0 | Security Healthissue Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-healthissue-get.md | + + Title: "Get healthIssue" +description: "Read the properties and relationships of a healthIssue object." ++ms.localizationpriority: medium Last updated : 03/20/2024+++# Get healthIssue ++Namespace: microsoft.graph.security +++Read the properties and relationships of a [healthIssue](../resources/security-healthissue.md) object. +++## 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": "security_healthissue_get" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/identities/healthIssues/{healthIssueId} +``` +++## 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 [microsoft.graph.security.healthIssue](../resources/security-healthissue.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "sampleKeys": ["b3c1b5fc-828c-45fa-a1e1-10d74f6d6e9c"], + "name": "get_security_healthissue" +} +--> +``` http +GET https://graph.microsoft.com/beta/security/identities/healthIssues/b3c1b5fc-828c-45fa-a1e1-10d74f6d6e9c +``` ++# [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. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.security.healthIssue", + "name": "get_security_healthissue" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.security.healthIssue", + "ID": "b3c1b5fc-828c-45fa-a1e1-10d74f6d6e9c", + "displayName": "Directory Services Object Auditing is not configured as required", + "healthIssueType": "Global", + "issueTypeId": "1031", + "severity": "medium", + "status": "open", + "createdDateTime": "2022-07-15T12:19:27.7211305Z", + "lastModifiedDateTime": "2022-07-15T12:19:27.7211305Z", + "domainNames": [ + "domain1.contoso.com", + "domain2.contoso.com" + ], + "sensorDNSNames": [ + "DC1.domain1.contoso.com", + "DC2.domain2.contoso.com" + ], + "description": "Directory Services Object Auditing is not configured as required on domain1.contoso.com", + "recommendations": [ + "Please configure the Directory Services Object Auditing events according to the guidance as described in https://aka.ms/mdi/objectauditing" + ], + "recommendedActionCommands": [ + "Import-Module DefenderForIdentity", + "Set-MDIConfiguration -Configuration DomainObjectAuditing -Mode Domain -Force" + ], + "additionalInformation": [ + "Descendant User Objects (Schema-Id-Guid: bf967aba-0de6-11d0-a285-00aa003049e2)", + "Descendant Group Objects (Schema-Id-Guid: bf967a9c-0de6-11d0-a285-00aa003049e2)", + "Descendant Computer Objects (Schema-Id-Guid: bf967a86-0de6-11d0-a285-00aa003049e2)", + "Descendant msDS-GroupManagedServiceAccount Objects (Schema-Id-Guid: 7b8b558a-93a5-4af7-adca-c017e67f1057)", + "Descendant msDS-ManagedServiceAccount Objects (Schema-Id-Guid: ce206244-5827-4a86-ba1c-1c0c386c1b64)" + ] +} +``` + |
v1.0 | Security Healthissue Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-healthissue-update.md | + + Title: "Update healthIssue" +description: "Update the properties of a healthIssue object." ++ms.localizationpriority: medium Last updated : 03/20/2024+++# Update healthIssue ++Namespace: microsoft.graph.security +++Update the properties of a [healthIssue](../resources/security-healthissue.md) object. +++## 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": "security_healthissue_update" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /security/identities/healthIssues/{healthIssueId} +``` ++## 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 +++|Property|Type|Description| +|:|:|:| +|status|microsoft.graph.security.healthIssueStatus|The status of the health issue. The possible values are: `open`, `closed`, `suppressed`, `unknownFutureValue`.| +++## Response ++If successful, this method returns a `200 OK` response code and an updated [microsoft.graph.security.healthIssue](../resources/security-healthissue.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "sampleKeys": ["b3c1b5fc-828c-45fa-a1e1-10d74f6d6e9c"], + "name": "update_healthissue" +} +--> +``` http +PATCH https://graph.microsoft.com/beta/security/identities/healthIssues/b3c1b5fc-828c-45fa-a1e1-10d74f6d6e9c +Content-Type: application/json ++{ + "status": "closed" +} +``` ++# [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. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "@odata.type": "microsoft.graph.security.healthIssue", + "truncated": true, + "name": "update_healthissue" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.security.healthIssue", + "ID": "b3c1b5fc-828c-45fa-a1e1-10d74f6d6e9c", + "displayName": "Directory Services Object Auditing is not configured as required", + "healthIssueType": "Global", + "issueTypeId": "1031", + "severity": "medium", + "status": "closed", + "createdDateTime": "2022-07-15T12:19:27.7211305Z", + "lastModifiedDateTime": "2022-07-15T12:19:27.7211305Z", + "domainNames": [ + "domain1.contoso.com", + "domain2.contoso.com" + ], + "sensorDNSNames": [ + "DC1.domain1.contoso.com", + "DC2.domain2.contoso.com" + ], + "description": "Directory Services Object Auditing is not configured as required on domain1.contoso.com", + "recommendations": [ + "Please configure the Directory Services Object Auditing events according to the guidance as described in https://aka.ms/mdi/objectauditing" + ], + "recommendedActionCommands": [ + "Import-Module DefenderForIdentity", + "Set-MDIConfiguration -Configuration DomainObjectAuditing -Mode Domain -Force" + ], + "additionalInformation": [ + "Descendant User Objects (Schema-Id-Guid: bf967aba-0de6-11d0-a285-00aa003049e2)", + "Descendant Group Objects (Schema-Id-Guid: bf967a9c-0de6-11d0-a285-00aa003049e2)", + "Descendant Computer Objects (Schema-Id-Guid: bf967a86-0de6-11d0-a285-00aa003049e2)", + "Descendant msDS-GroupManagedServiceAccount Objects (Schema-Id-Guid: 7b8b558a-93a5-4af7-adca-c017e67f1057)", + "Descendant msDS-ManagedServiceAccount Objects (Schema-Id-Guid: ce206244-5827-4a86-ba1c-1c0c386c1b64)" + ] +} +``` + |
v1.0 | Security Identitycontainer List Healthissues | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-identitycontainer-list-healthissues.md | + + Title: "List healthIssues" +description: "Get a list of health issue objects and their properties." ++ms.localizationpriority: medium Last updated : 03/20/2024+++# List healthIssues ++Namespace: microsoft.graph.security +++Get a list of [health issue](../resources/security-healthissue.md) objects and their properties. +++## 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": "security_identitycontainer_list_healthissues" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/identities/healthIssues +``` ++## Optional query parameters ++This method supports the following OData query parameters to help customize the response: `$count`, `$filter`, `$skip`, `$top`. For general information, see [OData query parameters](/graph/query-parameters). ++The following examples show how to use optional query parameters. ++### Get all open health alerts +<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/identities/healthIssues?$filter=Status eq 'open' +``` ++### Get the top five open health alerts +<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/identities/healthIssues?$filter=Status eq 'open'&$top=5 +``` ++### Get open health alerts based on issue type +<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/identities/healthIssues?$filter=Status eq 'open' and healthIssueType eq 'global' +GET /security/identities/healthIssues?$filter=Status eq 'open' and healthIssueType eq 'sensor' +``` ++### Get open health alerts based on severity +<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/identities/healthIssues?$filter=Status eq 'open' and severity eq 'medium' +GET /security/identities/healthIssues?$filter=Status eq 'open' and severity eq 'low' +``` ++See open global health alerts that domain name \ sensor DNS name ends with spesific value (name=contoso.com) +<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/identities/healthissues?$filter=Status eq 'open' and healthIssueType eq 'global' and domainNames/any(s:endswith(s,'contoso.com')) +GET /security/identities/healthissues?$filter=Status eq 'open' and healthIssueType eq 'global' and sensorDNSNames/any(s:endswith(s,'contoso.com')) +``` ++## 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 [healthIssue](../resources/security-healthissue.md) objects in the response body. ++## Examples ++### Request ++The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_healthIssues" +} +--> +``` http +GET https://graph.microsoft.com/beta/security/identities/healthIssues +``` ++# [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. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.security.healthIssue)", + "name": "get_healthIssues" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "@odata.type": "#microsoft.graph.security.healthIssue", + "ID": "b3c1b5fc-828c-45fa-a1e1-10d74f6d6e9c", + "displayName": "Directory Services Object Auditing is not configured as required", + "healthIssueType": "Global", + "issueTypeId": "1031", + "severity": "medium", + "status": "open", + "createdDateTime": "2022-07-15T12:19:27.7211305Z", + "lastModifiedDateTime": "2022-07-15T12:19:27.7211305Z", + "domainNames": [ + "domain1.contoso.com", + "domain2.contoso.com" + ], + "sensorDNSNames": [ + "DC1.domain1.contoso.com", + "DC2.domain2.contoso.com" + ], + "description": "Directory Services Object Auditing is not configured as required on domain1.contoso.com", + "recommendations": [ + "Please configure the Directory Services Object Auditing events according to the guidance as described in https://aka.ms/mdi/objectauditing" + ], + "recommendedActionCommands": [ + "Import-Module DefenderForIdentity", + "Set-MDIConfiguration -Configuration DomainObjectAuditing -Mode Domain -Force" + ], + "additionalInformation": [ + "Descendant User Objects (Schema-Id-Guid: bf967aba-0de6-11d0-a285-00aa003049e2)", + "Descendant Group Objects (Schema-Id-Guid: bf967a9c-0de6-11d0-a285-00aa003049e2)", + "Descendant Computer Objects (Schema-Id-Guid: bf967a86-0de6-11d0-a285-00aa003049e2)", + "Descendant msDS-GroupManagedServiceAccount Objects (Schema-Id-Guid: 7b8b558a-93a5-4af7-adca-c017e67f1057)", + "Descendant msDS-ManagedServiceAccount Objects (Schema-Id-Guid: ce206244-5827-4a86-ba1c-1c0c386c1b64)" + ] + } + ] +} +``` + |
v1.0 | Security Labelsroot Delete Authorities | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-labelsroot-delete-authorities.md | The following example shows a request. } --> ``` http-DELETE https://graph.microsoft.com/beta/security/labels/authorities/{authorityTemplateId} +DELETE https://graph.microsoft.com/beta/security/labels/authorities/f44dkle55-6baf-44ff-5dcc-08d8de97b1d5 ``` # [C#](#tab/csharp) DELETE https://graph.microsoft.com/beta/security/labels/authorities/{authorityTe ### Response-The following example shows the response. +Here's an example of the response. > <!-- { "blockType": "response", |
v1.0 | Security Labelsroot Delete Categories | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-labelsroot-delete-categories.md | The following example shows a request. } --> ``` http-DELETE https://graph.microsoft.com/beta/security/labels/categories/{categoryTemplateId} +DELETE https://graph.microsoft.com/beta/security/labels/categories/f44dkle55-6baf-44ff-5dcc-08d8de97b1d5 ``` # [C#](#tab/csharp) DELETE https://graph.microsoft.com/beta/security/labels/categories/{categoryTemp ### Response-The following example shows the response. +Here's an example of the response. > <!-- { "blockType": "response", |
v1.0 | Security Labelsroot Delete Citations | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-labelsroot-delete-citations.md | The following example shows a request. } --> ``` http-DELETE https://graph.microsoft.com/beta/security/labels/citations/{citationTemplateId} -``` +DELETE https://graph.microsoft.com/beta/security/labels/citations/f44dkle55-6baf-44ff-5dcc-08d8de97b1d5 # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/delete-citationtemplate-csharp-snippets.md)] DELETE https://graph.microsoft.com/beta/security/labels/citations/{citationTempl ### Response-The following example shows the response. +Here's an example of the response. > <!-- { "blockType": "response", |
v1.0 | Security Labelsroot Delete Departments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-labelsroot-delete-departments.md | The following example shows a request. } --> ``` http-DELETE https://graph.microsoft.com/beta/security/labels/departments/{departmentTemplateId} +DELETE https://graph.microsoft.com/beta/security/labels/departments/f44dkle55-6baf-44ff-5dcc-08d8de97b1d5 ``` # [C#](#tab/csharp) DELETE https://graph.microsoft.com/beta/security/labels/departments/{departmentT ### Response-The following example shows the response. +Here's an example of the response. > <!-- { "blockType": "response", |
v1.0 | Security Labelsroot Delete Fileplanreferences | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-labelsroot-delete-fileplanreferences.md | The following example shows a request. } --> ``` http-DELETE https://graph.microsoft.com/beta/security/labels/filePlanReferences/{filePlanReferenceTemplateId} +DELETE https://graph.microsoft.com/beta/security/labels/filePlanReferences/f44dkle55-6baf-44ff-5dcc-08d8de97b1d5 ``` # [C#](#tab/csharp) DELETE https://graph.microsoft.com/beta/security/labels/filePlanReferences/{file ### Response-The following example shows the response. +Here's an example of the response. > <!-- { "blockType": "response", |
v1.0 | Security Labelsroot List Authorities | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-labelsroot-list-authorities.md | GET https://graph.microsoft.com/beta/security/labels/authorities ### Response-The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json { "@odata.type": "#microsoft.graph.security.authorityTemplate", "id": "a94af2e3-853b-6fcc-c898-d61d3a6d9efc",- "displayName": "String", + "displayName": "Business", "createdBy": {- "@odata.type": "microsoft.graph.identitySet" + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } },- "createdDateTime": "String (timestamp)" + "createdDateTime": "2021-03-24T02:09:08Z" + }, + { + "@odata.type": "#microsoft.graph.security.authorityTemplate", + "id": "6cf65e55-6baf-44ff-5dcc-08d8de97b1d5", + "displayName": "Legal", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-03-24T02:09:08Z" } ] } |
v1.0 | Security Labelsroot List Categories | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-labelsroot-list-categories.md | GET https://graph.microsoft.com/beta/security/labels/categories ### Response-The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json { "@odata.type": "#microsoft.graph.security.categoryTemplate", "id": "e2c79762-34a9-75ba-b6f0-a7c9a57978ef",- "displayName": "String", + "displayName": "Accounts Payable", "createdBy": {- "@odata.type": "microsoft.graph.identitySet" + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } },- "createdDateTime": "String (timestamp)" - } + "createdDateTime": "2021-03-24T02:09:08Z" + }, + { + "@odata.type": "#microsoft.graph.security.categoryTemplate", + "id": "6cf65e55-6baf-44ff-5dcc-08d8de97b1d5", + "displayName": "Accounts", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-03-24T02:09:08Z" + } ] } ``` |
v1.0 | Security Labelsroot List Citations | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-labelsroot-list-citations.md | GET https://graph.microsoft.com/beta/security/labels/citations ### Response-The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json { "@odata.type": "#microsoft.graph.security.citationTemplate", "id": "c0475d01-d532-8a53-6e26-14ea58c640bf",- "displayName": "String", + "displayName": "Contoso Company Policy", "createdBy": {- "@odata.type": "microsoft.graph.identitySet" + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } },- "createdDateTime": "String (timestamp)", - "citationUrl": "String", - "citationJurisdiction": "String" + "createdDateTime": "2021-03-24T02:09:08Z", + "citationUrl": "www.citationUrl.com", + "citationJurisdiction": "Contoso" } ] } |
v1.0 | Security Labelsroot List Departments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-labelsroot-list-departments.md | GET https://graph.microsoft.com/beta/security/labels/departments ### Response-The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json { "@odata.type": "#microsoft.graph.security.departmentTemplate", "id": "11b44677-9f06-c85a-4a0b-766b66904bf8",- "displayName": "String", + "displayName": "Finance", "createdBy": {- "@odata.type": "microsoft.graph.identitySet" + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } },- "createdDateTime": "String (timestamp)" + "createdDateTime": "2021-03-24T02:09:08Z" } ] } |
v1.0 | Security Labelsroot List Fileplanreferences | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-labelsroot-list-fileplanreferences.md | GET https://graph.microsoft.com/beta/security/labels/filePlanReferences ### Response-The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json { "@odata.type": "#microsoft.graph.security.filePlanReferenceTemplate", "id": "b1f7b518-a44f-1d4b-c6f1-ab8771d3907c",- "displayName": "String", + "displayName": "FIN 01-02-001", "createdBy": {- "@odata.type": "microsoft.graph.identitySet" + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } },- "createdDateTime": "String (timestamp)" + "createdDateTime": "2021-03-24T02:09:08Z" } ] } |
v1.0 | Security Labelsroot List Retentionlabel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-labelsroot-list-retentionlabel.md | If successful, this method returns a `200 OK` response code and a collection of ## Examples ### Request-+Here's an example of a request. # [HTTP](#tab/http) <!-- { "blockType": "request", GET https://graph.microsoft.com/beta/security/labels/retentionLabels ### Response+Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json { "@odata.type": "#microsoft.graph.security.retentionLabel", "id": "64a99fb4-07be-0481-8746-44c15c0eef1f",- "displayName": "String", - "behaviorDuringRetentionPeriod": "String", - "actionAfterRetentionPeriod": "String", - "retentionTrigger": "String", + "displayName": "Retention Schedule 10004", + "behaviorDuringRetentionPeriod": "retain", + "actionAfterRetentionPeriod": "relabel", + "retentionTrigger": "dateCreated", "retentionDuration": {- "@odata.type": "microsoft.graph.security.retentionDuration" + "@odata.type": "microsoft.graph.security.retentionDurationInDays", + "days": "730" },- "isInUse": "Boolean", - "descriptionForAdmins": "String", - "descriptionForUsers": "String", + "isInUse": true, + "descriptionForAdmins": "creation based retention label for schedule 10004", + "descriptionForUsers": "retains for 2 years then relabeled", "createdBy": {- "@odata.type": "microsoft.graph.identitySet" + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } },- "createdDateTime": "String (timestamp)", + "createdDateTime": "2017-11-27T02:10:12Z", "lastModifiedBy": {- "@odata.type": "microsoft.graph.identitySet" + "user": { + "id": "9563a605-e827-4324-a5a9-09efddff1e90", + "displayName": "Records Manager" + } },- "lastModifiedDateTime": "String (timestamp)", - "labelToBeApplied": "String", - "defaultRecordBehavior": "String" + "lastModifiedDateTime": "2020-08-28T22:13:09Z", + "labelToBeApplied": "Retention schedule 10005", + "defaultRecordBehavior": "startLocked" } ] } |
v1.0 | Security Labelsroot Post Authorities | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-labelsroot-post-authorities.md | You can specify the following properties when creating a **authorityTemplate**. |Property|Type|Description| |:|:|:|-|displayName|String|Unique string that defines an authortiy name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptor.md).| +|displayName|String|Unique string that defines an authority name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptor.md).| Content-Type: application/json { "@odata.type": "#microsoft.graph.security.authorityTemplate",- "displayName": "String", - "createdBy": { - "@odata.type": "microsoft.graph.identitySet" - } + "displayName": "Business", } ``` Content-Type: application/json ### Response-The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json { "@odata.type": "#microsoft.graph.security.authorityTemplate", "id": "a94af2e3-853b-6fcc-c898-d61d3a6d9efc",- "displayName": "String", + "displayName": "Business", "createdBy": {- "@odata.type": "microsoft.graph.identitySet" + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } },- "createdDateTime": "String (timestamp)" + "createdDateTime" : "2021-03-24T02:09:08Z" } ``` |
v1.0 | Security Labelsroot Post Categories | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-labelsroot-post-categories.md | Content-Type: application/json { "@odata.type": "#microsoft.graph.security.categoryTemplate",- "displayName": "String", - "createdBy": { - "@odata.type": "microsoft.graph.identitySet" - } + "displayName": "Accounts Payable", } ``` Content-Type: application/json ### Response-The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json { "@odata.type": "#microsoft.graph.security.categoryTemplate", "id": "e2c79762-34a9-75ba-b6f0-a7c9a57978ef",- "displayName": "String", + "displayName": "Accounts Payable", "createdBy": {- "@odata.type": "microsoft.graph.identitySet" + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } },- "createdDateTime": "String (timestamp)" + "createdDateTime" : "2021-03-24T02:09:08Z" } ``` |
v1.0 | Security Labelsroot Post Citations | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-labelsroot-post-citations.md | Content-Type: application/json { "@odata.type": "#microsoft.graph.security.citationTemplate",- "displayName": "String", - "createdBy": { - "@odata.type": "microsoft.graph.identitySet" - }, - "citationUrl": "String", - "citationJurisdiction": "String" + "displayName": "Contoso Company Policy", + "citationUrl": "www.citationUrl.com", + "citationJurisdiction": "Contoso" } ``` Content-Type: application/json ### Response-The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json { "@odata.type": "#microsoft.graph.security.citationTemplate", "id": "c0475d01-d532-8a53-6e26-14ea58c640bf",- "displayName": "String", - "createdBy": { - "@odata.type": "microsoft.graph.identitySet" + "displayName": "Contoso Company Policy", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } },+ "createdDateTime" : "2021-03-24T02:09:08Z", "createdDateTime": "String (timestamp)",- "citationUrl": "String", + "citationUrl": "www.citationUrl.com", "citationJurisdiction": "String" } ``` |
v1.0 | Security Labelsroot Post Departments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-labelsroot-post-departments.md | Content-Type: application/json { "@odata.type": "#microsoft.graph.security.departmentTemplate",- "displayName": "String", - "createdBy": { - "@odata.type": "microsoft.graph.identitySet" - } + "displayName": "Finance", } ``` Content-Type: application/json ### Response-The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json { "@odata.type": "#microsoft.graph.security.departmentTemplate", "id": "11b44677-9f06-c85a-4a0b-766b66904bf8",- "displayName": "String", + "displayName": "Finance", "createdBy": {- "@odata.type": "microsoft.graph.identitySet" + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } },- "createdDateTime": "String (timestamp)" + "createdDateTime" : "2021-03-24T02:09:08Z" } ``` |
v1.0 | Security Labelsroot Post Fileplanreferences | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-labelsroot-post-fileplanreferences.md | Content-Type: application/json { "@odata.type": "#microsoft.graph.security.filePlanReferenceTemplate",- "displayName": "String", - "createdBy": { - "@odata.type": "microsoft.graph.identitySet" - } + "displayName": "FIN 01-02-001", } ``` Content-Type: application/json ### Response-The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json { "@odata.type": "#microsoft.graph.security.filePlanReferenceTemplate", "id": "b1f7b518-a44f-1d4b-c6f1-ab8771d3907c",- "displayName": "String", + "displayName": "FIN 01-02-001", "createdBy": {- "@odata.type": "microsoft.graph.identitySet" + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } },- "createdDateTime": "String (timestamp)" + "createdDateTime" : "2021-03-24T02:09:08Z" } ``` |
v1.0 | Security Labelsroot Post Retentionlabel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-labelsroot-post-retentionlabel.md | Specify the following properties when you create a **retentionLabel**. |dispositionReviewStages|[microsoft.graph.security.dispositionReviewStage](../resources/security-dispositionreviewstage.md) collection|Review stages during which reviewers are notified to determine whether a document must be deleted or retained. | |retentionDuration|[microsoft.graph.security.retentionDuration](../resources/security-retentionduration.md)|Specifies the number of days to retain the content. | |retentionTrigger|microsoft.graph.security.retentionTrigger|Specifies whether the retention duration is calculated from the content creation date, labeled date, or last modification date. The possible values are: `dateLabeled`, `dateCreated`, `dateModified`, `dateOfEvent`, `unknownFutureValue`. |-|defaultRecordBehavior|microsoft.graph.security.defaultRecordBehavior|Specifies the locked or unlocked state of a record label when it is created.The possible values are: `startLocked`, `startUnlocked`, `unknownFutureValue`. | +|defaultRecordBehavior|microsoft.graph.security.defaultRecordBehavior|Specifies the locked or unlocked state of a record label when it's created. The possible values are: `startLocked`, `startUnlocked`, `unknownFutureValue`. | |labelToBeApplied|String|Specifies the replacement label to be applied automatically after the retention period of the current label ends. | If successful, this method returns a `201 Created` response code and a [microsof ## Examples ### Request+Here's an example of a request. # [HTTP](#tab/http) <!-- { Content-length: 555 { "@odata.type": "#microsoft.graph.security.retentionLabel",- "displayName": "String", - "behaviorDuringRetentionPeriod": "String", - "actionAfterRetentionPeriod": "String", - "retentionTrigger": "String", + "displayName": "Retention Schedule 10005", + "behaviorDuringRetentionPeriod": "retain", + "actionAfterRetentionPeriod": "startDispositionReview", + "retentionTrigger": "dateOfEvent", + "retentionEventType@odata.bind": "https://graph.microsoft.com/beta/security/triggerTypes/retentionEventTypes('e095f4fc-b966-4c40-94de-fb8a383658e4')", "retentionDuration": {- "@odata.type": "microsoft.graph.security.retentionDuration" + "@odata.type": "microsoft.graph.security.retentionDurationInDays", + "days": 2555 },- "isInUse": "Boolean", - "descriptionForAdmins": "String", - "descriptionForUsers": "String", - "createdBy": { - "@odata.type": "microsoft.graph.identitySet" - }, - "labelToBeApplied": "String", - "defaultRecordBehavior": "String", + "dispositionReviewStages": [ + { + "stageNumber" : 1, + "name": "Stage1", + "reviewersEmailAddresses ": [ + "Admin@contoso.onmicrosoft.com" + ] + } + ], + "descriptionForAdmins": "retain for 7 years", + "descriptionForUsers": "retain for 7 years", "descriptors": { "authorityTemplate@odata.bind" : "https://graph.microsoft.com/beta/security/labels/authorities('fie3f4fc-b966-4c40-94de-fb8a383658e4')", "categoryTemplate@odata.bind" : "https://graph.microsoft.com/beta/security/labels/categories('0bjk8-b966-4c40-94de-fb8a383658e4')", Content-length: 555 "departmentTemplate@odata.bind" : "https://graph.microsoft.com/beta/security/labels/departments('p99ef4fc-b966-4c40-94de-fb8a383658e4')", "filePlanReferenceTemplate@odata.bind" : "https://graph.microsoft.com/beta/security/labels/filePlanReferences('e095f4fc-b966-4c40-94de-fb8a383658e4')" },+ "defaultRecordBehavior":"startLocked", } ``` Content-length: 555 [!INCLUDE [sample-code](../includes/snippets/php/create-retentionlabel-from--php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -# [PowerShell](#tab/powershell) - # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/create-retentionlabel-from--python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] Content-length: 555 ### Response-The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json { "@odata.type": "#microsoft.graph.security.retentionLabel", "id": "64a99fb4-07be-0481-8746-44c15c0eef1f",- "displayName": "String", - "behaviorDuringRetentionPeriod": "String", - "actionAfterRetentionPeriod": "String", - "retentionTrigger": "String", + "displayName": "Retention Schedule 10005", + "behaviorDuringRetentionPeriod": "retain", + "actionAfterRetentionPeriod": "startDispositionReview", + "retentionTrigger": "dateOfEvent", "retentionDuration": {- "@odata.type": "microsoft.graph.security.retentionDuration" + "@odata.type": "microsoft.graph.security.retentionDurationInDays", + "days": 2555 },- "isInUse": "Boolean", - "descriptionForAdmins": "String", - "descriptionForUsers": "String", + "dispositionReviewStages": [ + { + "stageNumber" : 1, + "name": "Stage1", + "reviewersEmailAddresses ": [ + "Admin@contoso.onmicrosoft.com" + ] + } + ], + "isInUse": true, + "descriptionForAdmins": "retain for 7 years", + "descriptionForUsers": "retain for 7 years", + "defaultRecordBehavior":"startLocked", "createdBy": {- "@odata.type": "microsoft.graph.identitySet" - }, - "createdDateTime": "String (timestamp)", - "lastModifiedBy": { - "@odata.type": "microsoft.graph.identitySet" + "user": { + "id": "9563a605-e827-4324-a5a9-09efddff1e90", + "displayName": "Admin" + } },- "lastModifiedDateTime": "String (timestamp)", - "labelToBeApplied": "String", - "defaultRecordBehavior": "String", + "createdDateTime": "2021-08-23T16:43:55Z", + "labelToBeApplied": " ", + "defaultRecordBehavior": "startLocked", "descriptors": { "authority": { "displayName": "Business" |
v1.0 | Security Retentionevent Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-retentionevent-get.md | If successful, this method returns a `200 OK` response code and a [microsoft.gra ## Examples ### Request-+Here's an example of a request. # [HTTP](#tab/http) <!-- { "blockType": "request", GET https://graph.microsoft.com/beta/security/triggers/retentionEvents/{retentio ### Response+Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json "description": "String", "eventQueries": [ {- "@odata.type": "microsoft.graph.security.eventQueries" + "@odata.type": "microsoft.graph.security.eventQuery" } ], "eventTriggerDateTime": "String (timestamp)", |
v1.0 | Security Retentionevent List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-retentionevent-list.md | If successful, this method returns a `200 OK` response code and a collection of ## Examples ### Request-+Here's an example of a request. # [HTTP](#tab/http) <!-- { GET https://graph.microsoft.com/beta/security/triggers/retentionEvents ### Response+Here's an example of a request. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json "description": "String", "eventQueries": [ {- "@odata.type": "microsoft.graph.security.eventQueries" + "@odata.type": "microsoft.graph.security.eventQuery" } ], "eventTriggerDateTime": "String (timestamp)", |
v1.0 | Security Retentionevent Post | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-retentionevent-post.md | Title: "Create retentionEvent" description: "Create a new retentionEvent object."-+ ms.localizationpriority: medium doc_type: apiPageType Specify the following properties when creating a **retentionEvent**. |:|:|:| |description|String|Optional information about the event.| |displayName|String|Name of the event.|-|eventQuery|[microsoft.graph.security.eventQueries](../resources/security-eventqueries.md) collection| Represents the workload (SharePoint Online, OneDrive for Business, Exchange Online) and identification information associated with a retention event.| +|eventQuery|[microsoft.graph.security.eventQuery](../resources/security-eventquery.md) collection| Represents the workload (SharePoint Online, OneDrive for Business, Exchange Online) and identification information associated with a retention event.| |eventTriggerDateTime|DateTimeOffset|Optional time when the event should be triggered.| |retentionEventType|String|Name of the event type associated with the event.| If successful, this method returns a `201 Created` response code and a [microsof ## Examples ### Request+Here's an example of a request. # [HTTP](#tab/http) <!-- { Content-length: 616 "description": "String", "eventQueries": [ {- "@odata.type": "microsoft.graph.security.eventQueries" + "@odata.type": "microsoft.graph.security.eventQuery" } ], "eventTriggerDateTime": "String (timestamp)", Content-length: 616 ### Response-The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json "description": "String", "eventQueries": [ {- "@odata.type": "microsoft.graph.security.eventQueries" + "@odata.type": "microsoft.graph.security.eventQuery" } ], "eventTriggerDateTime": "String (timestamp)", |
v1.0 | Security Retentionlabel Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-retentionlabel-delete.md | If successful, this method returns a `204 No Content` response code. ## Examples ### Request+Here's an example of a request. # [HTTP](#tab/http) <!-- { If successful, this method returns a `204 No Content` response code. } --> ``` http-DELETE https://graph.microsoft.com/beta/security/labels/retentionLabels/{retentionLabelId} +DELETE https://graph.microsoft.com/beta/security/labels/retentionLabels/9563a605-e827-4324-a5a9-09efddff1e50 ``` # [C#](#tab/csharp) DELETE https://graph.microsoft.com/beta/security/labels/retentionLabels/{retenti ### Response+Here's an example of the response. + > <!-- { "blockType": "response", |
v1.0 | Security Retentionlabel Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-retentionlabel-get.md | GET /security/triggers/retentionEvents/{retentionEventId}/labels/{retentionLabel ``` ## Optional query parameters-This method supports the expand OData query parameters to help customize the response. For example, to retrieve the **retentionEventType** property, you can use the `expand` parameter:`$expand=retentionEventType`. For general information, see [OData query parameters](/graph/query-parameters). +This method supports the expand OData query parameters to help customize the response. For example, to retrieve the **retentionEventType** property, you can use the `expand` parameter:`$expand=retentionEventType` or `$expand=descriptors`. For general information, see [OData query parameters](/graph/query-parameters). ## Request headers |Name|Description| If successful, this method returns a `200 OK` response code and a [microsoft.gra ## Examples ### Request+Here's an example of a request. # [HTTP](#tab/http) <!-- { GET https://graph.microsoft.com/beta/security/labels/retentionLabels/{retention ### Response+Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json "value": { "@odata.type": "#microsoft.graph.security.retentionLabel", "id": "64a99fb4-07be-0481-8746-44c15c0eef1f",- "displayName": "String", - "behaviorDuringRetentionPeriod": "String", - "actionAfterRetentionPeriod": "String", - "retentionTrigger": "String", - "retentionDuration": { - "@odata.type": "microsoft.graph.security.retentionDuration" - }, - "isInUse": "Boolean", - "descriptionForAdmins": "String", - "descriptionForUsers": "String", - "createdBy": { - "@odata.type": "microsoft.graph.identitySet" - }, - "createdDateTime": "String (timestamp)", - "lastModifiedBy": { - "@odata.type": "microsoft.graph.identitySet" - }, - "lastModifiedDateTime": "String (timestamp)", - "labelToBeApplied": "String", - "defaultRecordBehavior": "String" + "displayName": "Retention Schedule 10004", + "behaviorDuringRetentionPeriod": "retain", + "actionAfterRetentionPeriod": "relabel", + "retentionTrigger": "dateCreated", + "retentionDuration": { + "@odata.type": "microsoft.graph.security.retentionDurationInDays", + "days": 730 + }, + "isInUse": true, + "descriptionForAdmins": "creation based retention label for schedule 10004", + "descriptionForUsers": "retains for 2 years then relabeled", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2017-11-27T02:10:12Z", + "lastModifiedBy": { + "user": { + "id": "9563a605-e827-4324-a5a9-09efddff1e90", + "displayName": "Records Manager" + } + }, + "lastModifiedDateTime": "2020-08-28T22:13:09Z", + "labelToBeApplied": "Retention schedule 10005", + "defaultRecordBehavior": "startLocked" } } ``` |
v1.0 | Security Retentionlabel Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-retentionlabel-update.md | PATCH /security/labels/retentionLabels/{retentionLabelId} |descriptionForUsers|String|This is an optional property that provides the label information for the user.| |dispositionReviewStages|[microsoft.graph.security.dispositionReviewStage](../resources/security-dispositionreviewstage.md) collection|Review stages during which reviewers are notified to determine whether a document must be deleted or retained.| |retentionDuration|[microsoft.graph.security.retentionDuration](../resources/security-retentionduration.md)|Specifies the number of days to retain the content.|-|defaultRecordBehavior|microsoft.graph.security.defaultRecordBehavior|Specifies the locked or unlocked state of a record label when it is created.The possible values are: `startLocked`, `startUnlocked`, `unknownFutureValue`.| +|defaultRecordBehavior|microsoft.graph.security.defaultRecordBehavior|Specifies the locked or unlocked state of a record label when it is created. The possible values are: `startLocked`, `startUnlocked`, `unknownFutureValue`.| |labelToBeApplied|String|Specifies the replacement label to be applied automatically after the retention period of the current label ends. | ## Response -If successful, this method returns a `200 OK` response code and an updated [microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md) object in the response body. +If successful, this method returns a `204 No Content` response code. ## Examples ### Request+Here's an example of a request. # [HTTP](#tab/http) <!-- { If successful, this method returns a `200 OK` response code and an updated [micr } --> ``` http-PATCH https://graph.microsoft.com/beta/security/labels/retentionLabels/{retentionLabelId} +PATCH https://graph.microsoft.com/beta/security/labels/retentionLabels/9563a605-e827-4324-a5a9-09efddff1e50 Content-Type: application/json Content-length: 555 { "@odata.type": "#microsoft.graph.security.retentionLabel", "retentionDuration": {- "@odata.type": "microsoft.graph.security.retentionDuration" + "@odata.type": "microsoft.graph.security.retentionDurationInDays", + "days": 2555 },- "descriptionForAdmins": "String", - "descriptionForUsers": "String", - "labelToBeApplied": "String", - "defaultRecordBehavior": "String" } ``` Content-length: 555 ### Response->**Note:** The response object shown here might be shortened for readability. +Here's an example of the response. + <!-- {- "blockType": "response", - "truncated": true, - "@odata.type": "microsoft.graph.security.retentionLabel" + "blockType": "response" } --> ``` http-HTTP/1.1 200 OK -Content-Type: application/json --{ - "@odata.type": "#microsoft.graph.security.retentionLabel", - "id": "64a99fb4-07be-0481-8746-44c15c0eef1f", - "retentionDuration": { - "@odata.type": "microsoft.graph.security.retentionDuration" - }, - "descriptionForAdmins": "String", - "descriptionForUsers": "String", - "labelToBeApplied": "String", - "defaultRecordBehavior": "String" -} +HTTP/1.1 204 No Content ``` |
v1.0 | Security Subcategorytemplate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-subcategorytemplate-get.md | Title: "Get subCategoryTemplate" -description: "Read the properties and relationships of a subCategoryTemplate object." + Title: "Get subcategoryTemplate" +description: "Read the properties and relationships of a subcategoryTemplate object." ms.localizationpriority: medium doc_type: apiPageType -# Get subCategoryTemplate +# Get subcategoryTemplate Namespace: microsoft.graph.security [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Read the properties and relationships of a [subCategoryTemplate](../resources/security-subcategorytemplate.md) object. +Read the properties and relationships of a [subcategoryTemplate](../resources/security-subcategorytemplate.md) object. + ## 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). Choose the permission or permissions marked as least privileged for this API. Us } --> ``` http-GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate/subCategories/{subCategoryTemplateId} +GET /security/labels/categories/{categoryTemplateId}/subcategories/{subcategoryTemplateId} ``` ## Optional query parameters Don't supply a request body for this method. ## Response -If successful, this method returns a `200 OK` response code and a [microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) object in the response body. +If successful, this method returns a `200 OK` response code and a [microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md) object in the response body. ## Examples The following example shows a request. } --> ``` http-GET https://graph.microsoft.com/beta/security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate/subCategories/{subCategoryTemplateId} +GET https://graph.microsoft.com/beta/security/labels/categories/82d00422-1f60-46cd-9809-33ca0b4d2286/subcategories/2ac39915-dbeb-e933-82e2-92b981835fa0 ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/get-subcategorytemplate-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) + ### Response-The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", "truncated": true,- "@odata.type": "microsoft.graph.security.subCategoryTemplate" + "@odata.type": "microsoft.graph.security.subcategoryTemplate" } --> ``` http Content-Type: application/json { "value": {- "@odata.type": "#microsoft.graph.security.subCategoryTemplate", + "@odata.type": "#microsoft.graph.security.subcategoryTemplate", "id": "2ac39915-dbeb-e933-82e2-92b981835fa0",- "displayName": "String", + "displayName": "Vendor Invoice", "createdBy": {- "@odata.type": "microsoft.graph.identitySet" - }, - "createdDateTime": "String (timestamp)" - } + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} + } ``` |
v1.0 | Securitytoolawsresourceadministratorfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/securitytoolawsresourceadministratorfinding-get.md | description: "Read the properties and relationships of a securityToolAwsResource ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Securitytoolawsresourceadministratorfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/securitytoolawsresourceadministratorfinding-list.md | description: "Get a list of the securityToolAwsResourceAdministratorFinding obje ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Securitytoolawsroleadministratorfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/securitytoolawsroleadministratorfinding-get.md | description: "Read the properties and relationships of a securityToolAwsRoleAdmi ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Securitytoolawsroleadministratorfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/securitytoolawsroleadministratorfinding-list.md | description: "Get a list of the securityToolAwsRoleAdministratorFinding objects ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Securitytoolawsserverlessfunctionadministratorfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/securitytoolawsserverlessfunctionadministratorfinding-get.md | description: "Read the properties and relationships of a securityToolAwsServerle ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Securitytoolawsserverlessfunctionadministratorfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/securitytoolawsserverlessfunctionadministratorfinding-list.md | description: "Get a list of the securityToolAwsServerlessFunctionAdministratorFi ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Securitytoolawsuseradministratorfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/securitytoolawsuseradministratorfinding-get.md | description: "Read the properties and relationships of a securityToolAwsUserAdmi ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Securitytoolawsuseradministratorfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/securitytoolawsuseradministratorfinding-list.md | description: "Get a list of the securityToolAwsUserAdministratorFinding objects ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Serviceactivity Getmetricsforconditionalaccesscompliantdevicessigninsuccess | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceactivity-getmetricsforconditionalaccesscompliantdevicessigninsuccess.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "serviceactivity_getmetricsforconditionalaccesscompliantdevicessigninsuccess" } --> [!INCLUDE [permissions-table](../includes/permissions/serviceactivity-getmetricsforconditionalaccesscompliantdevicessigninsuccess-permissions.md)] -In addition to the delegated permissions, the signed-in user who is accessing the data needs to belong to one of the following directory roles, which allow them to read sign-in reports: +In addition to the delegated permissions, the signed-in user who is accessing the data needs to belong to at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json), which allow them to read sign-in reports: -+ Global Administrator + Global Reader + Reports Reader + Security Administrator + Security Operator + Security Reader -To learn more about directory roles, see [Microsoft Entra built-in roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request <!-- { |
v1.0 | Serviceactivity Getmetricsforconditionalaccessmanageddevicessigninsuccess | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceactivity-getmetricsforconditionalaccessmanageddevicessigninsuccess.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "serviceactivity_getmetricsforconditionalaccessmanageddevicessigninsuccess" } --> [!INCLUDE [permissions-table](../includes/permissions/serviceactivity-getmetricsforconditionalaccessmanageddevicessigninsuccess-permissions.md)] -In addition to the delegated permissions, the signed-in user who is accessing the data needs to belong to one of the following directory roles, which allow them to read sign-in reports: +In addition to the delegated permissions, the signed-in user who is accessing the data needs to belong to at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json), which allow them to read sign-in reports: -+ Global Administrator + Global Reader + Reports Reader + Security Administrator + Security Operator + Security Reader -To learn more about directory roles, see [Microsoft Entra built-in roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request <!-- { |
v1.0 | Serviceactivity Getmetricsformfasigninfailure | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceactivity-getmetricsformfasigninfailure.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "serviceactivity_getmetricsformfasigninfailure" } --> [!INCLUDE [permissions-table](../includes/permissions/serviceactivity-getmetricsformfasigninfailure-permissions.md)] -In addition to the delegated permissions, the signed-in user who is accessing the data needs to belong to one of the following directory roles, which allow them to read sign-in reports: +In addition to the delegated permissions, the signed-in user who is accessing the data needs to belong to at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json), which allow them to read sign-in reports: -+ Global Administrator + Global Reader + Reports Reader + Security Administrator + Security Operator + Security Reader -To learn more about directory roles, see [Microsoft Entra built-in roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) - ## HTTP request <!-- { |
v1.0 | Serviceactivity Getmetricsformfasigninsuccess | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceactivity-getmetricsformfasigninsuccess.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "serviceactivity_getmetricsformfasigninsuccess" } --> [!INCLUDE [permissions-table](../includes/permissions/serviceactivity-getmetricsformfasigninsuccess-permissions.md)] -In addition to the delegated permissions, the signed-in user who is accessing the data needs to belong to one of the following directory roles, which allow them to read sign-in reports: +In addition to the delegated permissions, the signed-in user who is accessing the data needs to belong to at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json), which allow them to read sign-in reports: -+ Global Administrator + Global Reader + Reports Reader + Security Administrator + Security Operator + Security Reader -To learn more about directory roles, see [Microsoft Entra built-in roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). - ## HTTP request <!-- { |
v1.0 | Serviceactivity Getmetricsforsamlsigninsuccess | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceactivity-getmetricsforsamlsigninsuccess.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "serviceactivity_getmetricsforsamlsigninsuccess" } --> [!INCLUDE [permissions-table](../includes/permissions/serviceactivity-getmetricsforsamlsigninsuccess-permissions.md)] -In addition to the delegated permissions, the signed-in user who is accessing the data needs to belong to one of the following directory roles, which allow them to read sign-in reports: +In addition to the delegated permissions, the signed-in user who is accessing the data needs to belong to at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json), which allow them to read sign-in reports: -+ Global Administrator + Global Reader + Reports Reader + Security Administrator + Security Operator + Security Reader -To learn more about directory roles, see [Microsoft Entra built-in roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). - ## HTTP request <!-- { |
v1.0 | Serviceprincipal Addtokensigningcertificate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-addtokensigningcertificate.md | All the objects have the same value of **customKeyIdentifier**. The **passwordCredential** is used to open the PFX file (private key). It and the associated private key object have the same value of **keyId**. Once set during creation through the **displayName** property, the subject of the certificate cannot be updated. The **startDateTime** is set to the same time the certificate is created using the action. The **endDateTime** can be up to three years after the certificate is created. ## 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). |
v1.0 | Serviceprincipal Createpasswordsinglesignoncredentials | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-createpasswordsinglesignoncredentials.md | Namespace: microsoft.graph Create single sign-on credentials using a password for a user or group. ## Permissions |
v1.0 | Serviceprincipal Delete Approleassignedto | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-delete-approleassignedto.md | Namespace: microsoft.graph Deletes an [appRoleAssignment](../resources/approleassignment.md) that a user, group, or client service principal has been granted for a resource service principal. ## Permissions |
v1.0 | Serviceprincipal Delete Approleassignments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-delete-approleassignments.md | Deletes an [appRoleAssignment](../resources/approleassignment.md) that a service App roles that are assigned to service principals are also known as [application permissions](/azure/active-directory/develop/v2-permissions-and-consent#permission-types). Deleting an app role assignment for a service principal is equivalent to revoking the app-only permission grant. ## Permissions |
v1.0 | Serviceprincipal Delete Claimsmappingpolicies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-delete-claimsmappingpolicies.md | Namespace: microsoft.graph Remove a [claimsMappingPolicy](../resources/claimsmappingpolicy.md) from a [servicePrincipal](../resources/servicePrincipal.md). ## Permissions |
v1.0 | Serviceprincipal Delete Delegatedpermissionclassifications | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-delete-delegatedpermissionclassifications.md | Namespace: microsoft.graph Deletes a [delegatedPermissionClassification](../resources/delegatedPermissionClassification.md) which had previously been set for a delegated permission. ## Permissions |
v1.0 | Serviceprincipal Delete Homerealmdiscoverypolicies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-delete-homerealmdiscoverypolicies.md | Namespace: microsoft.graph Remove a [homeRealmDiscoveryPolicy](../resources/homerealmdiscoverypolicy.md) from a [servicePrincipal](../resources/servicePrincipal.md). ## Permissions |
v1.0 | Serviceprincipal Delete Owners | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-delete-owners.md | Namespace: microsoft.graph Remove an owner from a [servicePrincipal](../resources/serviceprincipal.md) object. As a recommended best practice, service principals should have at least two owners. ## 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). |
v1.0 | Serviceprincipal Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-delete.md | Namespace: microsoft.graph Delete a [servicePrincipal](../resources/serviceprincipal.md) object. ## 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). |
v1.0 | Serviceprincipal Deletepasswordsinglesignoncredentials | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-deletepasswordsinglesignoncredentials.md | Namespace: microsoft.graph Delete single sign-on credentials using a password for a user or group. ## Permissions |
v1.0 | Serviceprincipal Delta | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-delta.md | Namespace: microsoft.graph Get newly created, updated, or deleted service principals without having to perform a full read of the entire resource collection. ## Permissions |
v1.0 | Serviceprincipal Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-get.md | Namespace: microsoft.graph Retrieve the properties and relationships of a [servicePrincipal](../resources/serviceprincipal.md) object. ## 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). |
v1.0 | Serviceprincipal Getpasswordsinglesignoncredentials | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-getpasswordsinglesignoncredentials.md | Namespace: microsoft.graph Get a list of single sign-on credentials using a password for a user or group. ## Permissions |
v1.0 | Serviceprincipal List Approleassignedto | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-list-approleassignedto.md | If the resource service principal is an application that has app roles granted t >**Note** This request might have replication delays for app role assignments that were recently granted or removed. ## Permissions |
v1.0 | Serviceprincipal List Approleassignments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-list-approleassignments.md | App roles that are assigned to service principals are also known as [application >**Note** This request might have replication delays for app role assignments that were recently granted or removed. ## Permissions |
v1.0 | Serviceprincipal List Claimsmappingpolicies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-list-claimsmappingpolicies.md | Namespace: microsoft.graph List the [claimsMappingPolicy](../resources/claimsmappingpolicy.md) objects that are assigned to a [servicePrincipal](../resources/servicePrincipal.md). ## Permissions |
v1.0 | Serviceprincipal List Createdobjects | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-list-createdobjects.md | Namespace: microsoft.graph Retrieve a list of directoryobject objects. ## 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). |
v1.0 | Serviceprincipal List Delegatedpermissionclassifications | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-list-delegatedpermissionclassifications.md | Namespace: microsoft.graph Retrieve the list of [delegatedPermissionClassification](../resources/delegatedpermissionclassification.md) currently configured for the delegated permissions exposed by an API. ## Permissions |
v1.0 | Serviceprincipal List Homerealmdiscoverypolicies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-list-homerealmdiscoverypolicies.md | Namespace: microsoft.graph List the [homeRealmDiscoveryPolicy](../resources/homerealmdiscoverypolicy.md) objects that are assigned to a [servicePrincipal](../resources/servicePrincipal.md). ## Permissions |
v1.0 | Serviceprincipal List Memberof | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-list-memberof.md | Namespace: microsoft.graph Get the groups and directory roles that this [servicePrincipal](../resources/serviceprincipal.md) is a direct member of. This operation isn't transitive. ## Permissions |
v1.0 | Serviceprincipal List Oauth2permissiongrants | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-list-oauth2permissiongrants.md | Namespace: microsoft.graph Retrieve a list of [oAuth2PermissionGrant](../resources/oAuth2PermissionGrant.md) entities, representing delegated permissions granted to the service principal (representing the client application) to access an API on behalf of a user. ## Permissions |
v1.0 | Serviceprincipal List Ownedobjects | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-list-ownedobjects.md | Namespace: microsoft.graph Retrieve a list of objects owned by the [servicePrincipal](../resources/serviceprincipal.md). This could include applications or groups. ## 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). |
v1.0 | Serviceprincipal List Owners | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-list-owners.md | Namespace: microsoft.graph Retrieve a list of owners of the [servicePrincipal](../resources/serviceprincipal.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). |
v1.0 | Serviceprincipal List Tokenlifetimepolicies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-list-tokenlifetimepolicies.md | Namespace: microsoft.graph List the [tokenLifetimePolicy](../resources/tokenlifetimepolicy.md) objects that are assigned to a [servicePrincipal](../resources/serviceprincipal.md). Only one object is returned in the collection because only one tokenLifetimePolicy can be assigned to a service principal. ## Permissions |
v1.0 | Serviceprincipal List Transitivememberof | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-list-transitivememberof.md | Namespace: microsoft.graph Get the groups and directory roles that this [servicePrincipal](../resources/serviceprincipal.md) is a member of. This operation is transitive and will include all groups that this service principal is a nested member of. ## 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). |
v1.0 | Serviceprincipal List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-list.md | Namespace: microsoft.graph Retrieve a list of [servicePrincipal](../resources/serviceprincipal.md) objects. ## Permissions |
v1.0 | Serviceprincipal Post Approleassignedto | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-post-approleassignedto.md | To grant an app role assignment, you need three identifiers: - `resourceId`: The `id` of the resource **servicePrincipal** which has defined the app role. - `appRoleId`: The `id` of the **appRole** (defined on the resource service principal) to assign to a user, group, or service principal. ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->-|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | AppRoleAssignment.ReadWrite.All and Application.Read.All, AppRoleAssignment.ReadWrite.All and Directory.Read.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | AppRoleAssignment.ReadWrite.All and Application.Read.All, AppRoleAssignment.ReadWrite.All and Directory.Read.All | [!INCLUDE [rbac-approleassignments-apis-write](../includes/rbac-for-apis/rbac-approleassignments-apis-write.md)] |
v1.0 | Serviceprincipal Post Approleassignments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-post-approleassignments.md | To grant an app role assignment to a client service principal, you need three id - `resourceId`: The `id` of the resource `servicePrincipal` (the API) which has defined the app role (the application permission). - `appRoleId`: The `id` of the `appRole` (defined on the resource service principal) to assign to the client service principal. ## Permissions |
v1.0 | Serviceprincipal Post Claimsmappingpolicies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-post-claimsmappingpolicies.md | Namespace: microsoft.graph Assign a [claimsMappingPolicy](../resources/claimsmappingpolicy.md) to a [servicePrincipal](../resources/servicePrincipal.md). ## Permissions |
v1.0 | Serviceprincipal Post Delegatedpermissionclassifications | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-post-delegatedpermissionclassifications.md | Namespace: microsoft.graph Classify a delegated permission by adding a [delegatedPermissionClassification](../resources/delegatedpermissionclassification.md) to the [servicePrincipal](../resources/servicePrincipal.md) representing the API. ## Permissions |
v1.0 | Serviceprincipal Post Homerealmdiscoverypolicies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-post-homerealmdiscoverypolicies.md | Namespace: microsoft.graph Assign a [homeRealmDiscoveryPolicy](../resources/homerealmdiscoverypolicy.md) to a [servicePrincipal](../resources/servicePrincipal.md). ## Permissions |
v1.0 | Serviceprincipal Post Owners | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-post-owners.md | Namespace: microsoft.graph Add an owner for the [servicePrincipal](../resources/serviceprincipal.md). Service principal owners can be users, the service principal itself, or other service principals. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Serviceprincipal Post Serviceprincipals | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-post-serviceprincipals.md | Create a new [servicePrincipal](../resources/serviceprincipal.md) object. > [!IMPORTANT] > Adding [**passwordCredential**](../resources/passwordcredential.md) when creating servicePrincipals is not supported. Use the [addPassword](serviceprincipal-addpassword.md) method to add passwords or secrets for a servicePrincipal. ## 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). Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "serviceprincipal_post_serviceprincipals" } --> [!INCLUDE [permissions-table](../includes/permissions/serviceprincipal-post-serviceprincipals-permissions.md)] -For multitenant apps, the calling user must also be in one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): +For multitenant apps, the calling user must also be in at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): -+ Global Administrator + Application Administrator + Cloud Application Administrator roles |
v1.0 | Serviceprincipal Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-update.md | Update the properties of [servicePrincipal](../resources/serviceprincipal.md) ob > [!IMPORTANT] > Using PATCH to set [**passwordCredential**](../resources/passwordcredential.md) is not supported. Use the [addPassword](./serviceprincipal-addpassword.md) and [removePassword](./serviceprincipal-removepassword.md) methods to update the password or secret for a servicePrincipal. ## 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). |
v1.0 | Serviceprincipal Updatepasswordsinglesignoncredentials | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-updatepasswordsinglesignoncredentials.md | Namespace: microsoft.graph Update single sign-on credentials using a password for a user or group. ## Permissions |
v1.0 | Serviceprincipal Upsert | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-upsert.md | Create a new [servicePrincipal](../resources/serviceprincipal.md) object if it d > [!IMPORTANT] > Adding [**passwordCredential**](../resources/passwordcredential.md) when creating servicePrincipals is not supported. Use the [addPassword](serviceprincipal-addpassword.md) method to add passwords or secrets for a servicePrincipal. + ## 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). Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "serviceprincipal_upsert" } --> [!INCLUDE [permissions-table](../includes/permissions/serviceprincipal-upsert-permissions.md)] -For multitenant apps, the calling user must also be in one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): +For multitenant apps, the calling user must also be in at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): -+ Global Administrator + Application Administrator + Cloud Application Administrator roles |
v1.0 | Servicestoragequotabreakdown Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/servicestoragequotabreakdown-get.md | Namespace: microsoft.graph Read the properties and relationships of a [serviceStorageQuotaBreakdown](../resources/servicestoragequotabreakdown.md) object. + ## 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). If successful, this method returns a `200 OK` response code and a [serviceStorag ### Request Here's an example of a request.+# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_servicestoragequotabreakdown" Here's an example of a request. GET https://graph.microsoft.com/beta/me/settings/storage/quota/services/OneDrive ``` +# [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 Here's an example of the response |
v1.0 | Signin Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/signin-get.md | One of the following permissions is required to call this API. To learn more, in Apps must be [properly registered](/azure/active-directory/active-directory-reporting-api-prerequisites-azure-portal) to Microsoft Entra ID. -In addition to the delegated permissions, the signed-in user needs to belong to one of the following directory roles that allow them to read sign-in reports. To learn more about directory roles, see [Microsoft Entra built-in roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): -+ Global Administrator +In addition to the delegated permissions, the signed-in user needs to belong to at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) that allow them to read sign-in reports. + + Global Reader + Reports Reader + Security Administrator |
v1.0 | Signin List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/signin-list.md | One of the following permissions is required to call this API. To learn more, in Apps must be [properly registered](/azure/active-directory/active-directory-reporting-api-prerequisites-azure-portal) to Microsoft Entra ID. -In addition to the delegated permissions, the signed-in user needs to belong to one of the following directory roles that allow them to read sign-in reports. To learn more about directory roles, see [Microsoft Entra built-in roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): -+ Global Administrator +In addition to the delegated permissions, the signed-in user needs to belong to at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) that allow them to read sign-in reports. + + Global Reader + Reports Reader + Security Administrator |
v1.0 | Site Delta | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/site-delta.md | Your application should continue making calls using the **@odata.nextLink** unti After you receive all the changes, you can apply them to your local state. To monitor future changes, call the **delta** API by using the **@odata.deltaLink** in the previous response. -Deleted sites are returned with the @removed annotation with the reason of removal. Any resources marked as deleted should be removed from your local state. +Any resources marked as deleted should be removed from your local state. + ## Permissions The following example shows the initial request and how to call this API to esta The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_sites_delta_first", "tags": "service.graph" } --> -```http +```msgraph-interactive GET https://graph.microsoft.com/beta/sites/delta ``` +# [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 that includes the first page of changes and the **@odata.nextLink** property that indicates that no more sites are available in the current set of sites. Your app should continue to request the URL value of **@odata.nextLink** until all pages of sites are retrieved. The following example shows a request that accesses the last page in a set and h The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get-sites-delta-last", "tags": "service.graph" }--> -```http +```msgraph-interactive GET https://graph.microsoft.com/beta/sites/delta?token=1230919asd190410jlka ``` +# [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 that indicates that the site named `AllCompany` was deleted between the initial request and this request to update the local state. Content-type: application/json "displayName": "All Company", "isPersonalSite": false, "id": "bd565af7-7963-4658-9a77-26e11ac73186",- "@removed": { - "reason": "deleted" - }, "root": {} } ] To retrieve the latest `deltaLink`, call `delta` with the query string parameter The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get-sites-delta-latest", "scopes": "sites.read", "tags": "service.graph", "target": "action" } --> -```http +```msgraph-interactive GET https://graph.microsoft.com/beta/sites/delta?token=latest ``` +# [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. |
v1.0 | Site Follow | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/site-follow.md | Namespace: microsoft.graph Follow a user's [site](../resources/site.md) or multiple sites. + ## 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). Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/follow-site-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/follow-site-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Site Unfollow | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/site-unfollow.md | Namespace: microsoft.graph Unfollow a user's [site](../resources/site.md) or multiple sites. + ## 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). Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/unfollow-site-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/unfollow-site-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Sitepage Create Webpart | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/sitepage-create-webpart.md | Namespace: microsoft.graph Create a new [webPart] at a specified position in the [sitePage]. -[sitepage]: ../resources/sitePage.md +[sitePage]: ../resources/sitePage.md [webPart]: ../resources/webPart.md ## Permissions The following example shows how to create a new webpart. <!-- { "blockType": "ignored" } --> ```http-POST /sites/{sitesId}/pages/{sitePageId}/microsoft.graph.sitePage/canvasLayout/verticalSection/webparts +POST /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/verticalSection/webparts Content-Type: application/json { |
v1.0 | Sitepage Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/sitepage-create.md | Namespace: microsoft.graph Create a new [sitePage][] in the site pages [list][] in a [site][]. -[sitePage]: ../resources/sitePage.md +[sitePage]: ../resources/sitepage.md [list]: ../resources/list.md [site]: ../resources/site.md The following example shows how to create a new page. <!-- { "blockType": "request", "name": "create-page", "scopes": "sites.readwrite.all" } --> ```http-POST https://graph.microsoft.com/beta/sites/{site-id}/pages +POST https://graph.microsoft.com/beta/sites/a69edae4-9208-4f60-9aa3-cd0911ff0ce1/pages Content-Type: application/json { Content-Type: application/json "showRecommendedPages": false, "titleArea": { "enableGradientEffect": true,- "imageWebUrl": "/_LAYOUTS/IMAGES/VISUALTEMPLATETITLEIMAGE.JPG", + "imageWebUrl": "https://cdn.hubblecontent.osi.office.net/m365content/publish/005292d6-9dcc-4fc5-b50b-b2d0383a411b/image.jpg", "layout": "colorBlock", "showAuthor": true, "showPublishedDate": false, Content-type: application/json "@odata.type": "microsoft.graph.sitePage", "id": "0dd6ddd6-45bd-4acd-b683-de0e6e7231b7", "name": "test.aspx",- "webUrl": "https://a830edad9050849yd.sharepoint.com/SitePages/test.aspx", + "webUrl": "https://contoso.sharepoint.com/SitePages/test.aspx", "title": "test", "pageLayout": "article", "showComments": true, Content-type: application/json }, "titleArea": { "enableGradientEffect": true,- "imageWebUrl": "/_LAYOUTS/IMAGES/VISUALTEMPLATETITLEIMAGE.JPG", + "imageWebUrl": "https://cdn.hubblecontent.osi.office.net/m365content/publish/005292d6-9dcc-4fc5-b50b-b2d0383a411b/image.jpg", "layout": "colorBlock", "showAuthor": true, "showPublishedDate": false, Content-type: application/json [list]: ../resources/list.md [listitem]: ../resources/listitem.md [site]: ../resources/site.md-[sitepage]: ../resources/sitepage.md +[sitePage]: ../resources/sitepage.md <!-- { |
v1.0 | Sitepage Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/sitepage-get.md | Namespace: microsoft.graph Returns the metadata for a [sitePage][] in the site pages [list][] in a [site][]. -[sitePage]: ../resources/sitePage.md +[sitePage]: ../resources/sitepage.md [list]: ../resources/list.md [site]: ../resources/site.md If successful, this method returns a `200` and a [sitePage](../resources/sitepag <!-- { "blockType": "request", "name": "get-page", "scopes": "sites.read.all", "tags": "service.sharepoint" } --> ```msgraph-interactive-GET /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage +GET /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage ``` # [C#](#tab/csharp) Content-type: application/json "description": "Here's the page description", "id": "65e59907-59d5-44ff-a038-7c0bf3098c01", "name": "Home.aspx",- "webUrl": "https://a830edad9050849yd.sharepoint.com/SitePages/Home.aspx", + "webUrl": "https://contoso.sharepoint.com/SitePages/Home.aspx", "title": "Organization Home", "thumbnailWebUrl": "https://cdn.hubblecontent.osi.office.net/m365content/publish/00210d24-bba0-42e6-9a31-1d452a95dd75/thumbnails/large.jpg?file=163352059.jpg", "promotionKind": "page", Content-type: application/json #### Request -With `select` and `expand` statements, you can retrieve sitePage metadata and page content in a single request. +With `$select` and `$expand` statements, you can retrieve sitePage metadata and page content in a single request. # [HTTP](#tab/http) <!-- { With `select` and `expand` statements, you can retrieve sitePage metadata and pa --> ```msgraph-interactive-GET /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage +GET /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage?$select=id,name ``` # [C#](#tab/csharp) Content-type: application/json { "@odata.etag": "\"{F45354CB-D634-45DF-8B88-2B4E96A1DC45},8\"",- "description": "Reiciendis placeat dolores.Mollitia veniam tempora tempora quidem voluptatum.Quos animi maiores facilis.Dolores officiis consequatur provident beatae deleniti accusamus magni quam tenetur.", - "eTag": "\"{F45354CB-D634-45DF-8B88-2B4E96A1DC45},8\"", "id": "f45354cb-d634-45df-8b88-2b4e96a1dc45",- "lastModifiedDateTime": "2023-04-16T10:01:41Z", - "name": "Electronic Convertible.aspx", - "webUrl": "https://a830edad9050849yd.sharepoint.com/SitePages/Electronic%20Convertible.aspx", - "title": "Electronic Convertible", - "pageLayout": "article", - "thumbnailWebUrl": "https://media.akamai.odsp.cdn.office.net/_layouts/15/images/sitepagethumbnail.png", - "promotionKind": "page", - "showComments": false, - "showRecommendedPages": true, - "contentType": { - "id": "0x0101009D1CB255DA76424F860D91F20E6C4118009E6554A5E299E84FB2E07731DD6C6D4A", - "name": "Site Page" - }, - "createdBy": { - "user": { - "displayName": "admin_contoso", - "email": "admin@contoso.com" - } - }, - "lastModifiedBy": { - "user": { - "displayName": "admin_contoso", - "email": "admin@contoso.com" - } - }, - "parentReference": { - "siteId": "45bb2a3b-0a4e-46f4-8c68-749c3fea75d3" - }, - "publishingState": { - "level": "draft", - "versionId": "0.4" - }, - "reactions": {} + "name": "Electronic Convertible.aspx" } ``` Content-type: application/json #### Request -To access the page with page content, append the `?expand=canvasLayout` query string. +You can expand references in your URL with the _$expand_ query parameter. To access the page with page content, append the `?$expand=canvasLayout` query string. ```http-GET /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage?expand=canvasLayout +GET /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage?$expand=canvasLayout ``` #### Response GET /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage?expand=canvasLayou "id": "f45354cb-d634-45df-8b88-2b4e96a1dc45", "lastModifiedDateTime": "2023-04-16T10:01:41Z", "name": "autotest Electronic Convertible.aspx",- "webUrl": "https://a830edad9050849yd.sharepoint.com/SitePages/autotest Electronic Convertible.aspx", + "webUrl": "https://contoso.sharepoint.com/SitePages/autotest Electronic Convertible.aspx", "title": "autotest Electronic Convertible", "pageLayout": "article", "thumbnailWebUrl": "https://media.akamai.odsp.cdn.office.net/sitepagethumbnail.png", |
v1.0 | Sitepage Getwebpartsbyposition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/sitepage-getwebpartsbyposition.md | The following example shows a request. --> ```msgraph-interactive-GET https://graph.microsoft.com/beta/sites/{siteId}/pages/{sitePageId}/microsoft.graph.sitePage/getWebPartsByPosition?isInVerticalSection=true +GET https://graph.microsoft.com/beta/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/getWebPartsByPosition?isInVerticalSection=true ``` # [JavaScript](#tab/javascript) |
v1.0 | Sitepage List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/sitepage-list.md | If successful, this method returns a `200` and a list of [sitePage](../resources --> ```msgraph-interactive-GET /sites/{site-id}/pages/microsoft.graph.sitePage +GET /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/microsoft.graph.sitePage ``` # [C#](#tab/csharp) Content-type: application/json { "id": "08f48aa6-02e3-407c-bbcb-ff61cec653fa", "name": "sample.aspx",- "webUrl": "https://a830edad9050849yd.sharepoint.com/SitePages/sample.aspx", + "webUrl": "https://contoso.sharepoint.com/SitePages/sample.aspx", "title": "sample", "pageLayout": "article", "showComments": true, Content-type: application/json }, "titleArea": { "enableGradientEffect": true,- "imageWebUrl": "/_LAYOUTS/IMAGES/SLEEKTEMPLATEIMAGETILE.JPG", + "imageWebUrl": "https://cdn.hubblecontent.osi.office.net/m365content/publish/005292d6-9dcc-4fc5-b50b-b2d0383a411b/image.jpg", "layout": "imageAndTitle", "showAuthor": false, "showPublishedDate": false, Content-type: application/json { "id": "7d87eee1-7c77-46b5-b2c4-ad6e4e432a8e", "name": "Home.aspx",- "webUrl": "https://a830edad9050849yd.sharepoint.com/SitePages/Home.aspx", + "webUrl": "https://contoso.sharepoint.com/SitePages/Home.aspx", "title": "Home", "pageLayout": "home", "showComments": true, Content-type: application/json }, "titleArea": { "enableGradientEffect": true,- "imageWebUrl": "/siteAssets/titleBackground.jpg", + "imageWebUrl": "https://cdn.hubblecontent.osi.office.net/m365content/publish/005292d6-9dcc-4fc5-b50b-b2d0383a411b/image.jpg", "layout": "imageAndTitle", "showAuthor": true, "showPublishedDate": false, |
v1.0 | Sitepage Post Horizontalsection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/sitepage-post-horizontalsection.md | The following example shows a request. <!-- { "blockType": "ignored" } --> ```http-POST https://graph.microsoft.com/beta/sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/horizontalSections +POST https://graph.microsoft.com/beta/sites/a69edae4-9208-4f60-9aa3-cd0911ff0ce1/pages/7f7a2740-2d74-47ba-af0c-71ed3a3384ca/microsoft.graph.sitePage/canvasLayout/horizontalSections Content-Type: application/json { |
v1.0 | Sitepage Post Verticalsection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/sitepage-post-verticalsection.md | The following example shows a request. <!-- { "blockType": "ignored" } --> ```http-PUT https://graph.microsoft.com/beta/sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/verticalSection +PUT https://graph.microsoft.com/beta/sites/a69edae4-9208-4f60-9aa3-cd0911ff0ce1/pages/7f7a2740-2d74-47ba-af0c-71ed3a3384ca/microsoft.graph.sitePage/canvasLayout/verticalSection Content-Type: application/json { |
v1.0 | Sitepage Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/sitepage-update.md | The following example shows a request. --> ```http-PATCH https://graph.microsoft.com/beta/sites/{sitesId}/pages/{sitePageId}/microsoft.graph.sitePage +PATCH https://graph.microsoft.com/beta/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage Content-Type: application/json { Content-Type: application/json "@odata.type": "#microsoft.graph.sitePage", "id": "0dd6ddd6-45bd-4acd-b683-de0e6e7231b7", "name": "sample.aspx",- "webUrl": "https://a830edad9050849yd.sharepoint.com/SitePages/sample.aspx", + "webUrl": "https://contoso.sharepoint.com/SitePages/sample.aspx", "title": "sample", "pageLayout": "article", "showComments": true, Content-Type: application/json } }, "publishingState": {- "level": "checkout", - "versionId": "0.1", - "checkedOutBy": { - "user": { - "displayName": "Rahul Mittal", - "email": "rahmit@contoso.com" - } - } + "level": "draft", + "versionId": "0.1" }, "titleArea": { "enableGradientEffect": true,- "imageWebUrl": "/_LAYOUTS/IMAGES/VISUALTEMPLATETITLEIMAGE.JPG", + "imageWebUrl": "https://cdn.hubblecontent.osi.office.net/m365content/publish/005292d6-9dcc-4fc5-b50b-b2d0383a411b/image.jpg", "layout": "colorBlock", "showAuthor": true, "showPublishedDate": false, |
v1.0 | Subscription Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/subscription-delete.md | description: "Delete a subscription." ms.localizationpriority: medium doc_type: apiPageType+ # Delete subscription For the list of resources that support subscribing to change notifications, see Depending on the resource and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference). -> **Note**: -> +> [!NOTE] > Some resources support change notifications in multiple scenarios, each of which may require different permissions. In those cases, use the resource path to differentiate the scenarios.-> -> Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). | Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--| Depending on the resource and the permission type (delegated or application) req |[callRecording](../resources/callrecording.md) <br /> `communications/onlineMeetings/getAllRecordings` <br /> Any recording becomes available in the tenant. | Not supported. | Not supported. | OnlineMeetingRecording.Read.All | |[callRecording](../resources/callrecording.md) <br /> `communications/onlineMeetings/{onlineMeetingId}/recordings` <br /> Any recording becomes available for a specific meeting. | OnlineMeetingRecording.Read.All | Not supported. | OnlineMeetingRecording.Read.All | |[callRecording](../resources/callrecording.md) <br /> `users/{userId}/onlineMeetings/getAllRecordings` <br /> A call recording that becomes available in a meeting organized by a specific user. | OnlineMeetingRecording.Read.All | Not supported. | OnlineMeetingRecording.Read.All |+|[callRecording](../resources/callrecording.md) <br /> `appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings` <br /> A call recording that becomes available in a meeting where a particular Teams app is installed. | Not supported. | Not supported. | OnlineMeetingRecording.Read.All, OnlineMeetingRecording.Read.Chat | |[callTranscript](../resources/calltranscript.md) <br /> `communications/onlineMeetings/getAllTranscripts` <br /> Any transcript becomes available in the tenant. | Not supported. | Not supported. | OnlineMeetingTranscript.Read.All | |[callTranscript](../resources/calltranscript.md) <br /> `communications/onlineMeetings/{onlineMeetingId}/transcripts` <br /> Any transcript becomes available for a specific meeting. | OnlineMeetingTranscript.Read.All | Not supported. | OnlineMeetingTranscript.Read.All | |[callTranscript](../resources/calltranscript.md) <br /> `users/{userId}/onlineMeetings/getAllTranscripts` <br /> A call transcript that becomes available in a meeting organized by a specific user. | OnlineMeetingTranscript.Read.All | Not supported. | OnlineMeetingTranscript.Read.All |+|[callTranscript](../resources/calltranscript.md) <br /> `appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTranscripts` <br /> A call transcript that becomes available in a meeting where a particular Teams app is installed. | Not supported. | Not supported. | OnlineMeetingTranscript.Read.All, OnlineMeetingTranscript.Read.Chat | |[channel](../resources/channel.md) <br />`/teams/getAllChannels` <br /> All channels in an organization. | Not supported. | Not supported. | Channel.ReadBasic.All, ChannelSettings.Read.All | |[channel](../resources/channel.md) <br />`/teams/{id}/channels` <br /> All channels in a particular team in an organization. | Channel.ReadBasic.All, ChannelSettings.Read.All | Not supported. | Channel.ReadBasic.All, ChannelSettings.Read.All | |[chat](../resources/chat.md) <br />`/chats` <br />All chats in an organization. | Not supported. | Not supported. | Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |-|[chat](../resources/chat.md) <br />`/chats/{id}` <br /> A particular chat. | Chat.ReadBasic, Chat.Read, Chat.ReadWrite | Not supported. | ChatSettings.Read.Chat*, ChatSettings.ReadWrite.Chat*, Chat.Manage.Chat*, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | +|[chat](../resources/chat.md) <br />`/chats/{id}` <br /> A particular chat. | Chat.ReadBasic, Chat.Read, Chat.ReadWrite | Not supported. | ChatSettings.Read.Chat, ChatSettings.ReadWrite.Chat, Chat.Manage.Chat, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | |[chat](../resources/chat.md) <br />`/appCatalogs/teamsApps/{id}/installedToChats` <br />All chats in an organization where a particular Teams app is installed. | Not supported. | Not supported. | Chat.ReadBasic.WhereInstalled, Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled |-|[chatMessage](../resources/chatmessage.md) <br />`/teams/{id}/channels/{id}/messages` <br /> All messages and replies in a particular channel. | ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All | Not supported. | ChannelMessage.Read.Group*, ChannelMessage.Read.All | +|[chatMessage](../resources/chatmessage.md) <br />`/teams/{id}/channels/{id}/messages` <br /> All messages and replies in a particular channel. | ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All | Not supported. | ChannelMessage.Read.Group, ChannelMessage.Read.All | |[chatMessage](../resources/chatmessage.md) <br />`/teams/getAllMessages` <br />All channel messages in organization. | Not supported. | Not supported. | ChannelMessage.Read.All | |[chatMessage](../resources/chatmessage.md) <br />`/chats/{id}/messages` <br /> All messages in a chat. | Chat.Read, Chat.ReadWrite | Not supported. | Chat.Read.All | |[chatMessage](../resources/chatmessage.md) <br />`/chats/getAllMessages` <br /> All chat messages in an organization. | Not supported. | Not supported. | Chat.Read.All | Depending on the resource and the permission type (delegated or application) req |[chatMessage](../resources/chatmessage.md) <br />`/appCatalogs/teamsApps/{id}/installedToChats/getAllMessages` <br />Chat messages for all chats in an organization where a particular Teams app is installed. | Not supported. | Not supported. | Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled | |[contact](../resources/contact.md) | Contacts.Read | Contacts.Read | Contacts.Read | |[conversationMember](../resources/conversationmember.md) <br />`/chats/getAllMembers` <br /> Members of all chats in an organization. | Not supported. | Not supported. | ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |-|[conversationMember](../resources/conversationmember.md) <br />`/chats/{id}/members` <br /> Members of a particular chat. | ChatMember.Read, ChatMember.ReadWrite, Chat.ReadBasic, Chat.Read, Chat.ReadWrite | Not supported. | ChatMember.Read.Chat*, Chat.Manage.Chat*, ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | +|[conversationMember](../resources/conversationmember.md) <br />`/chats/{id}/members` <br /> Members of a particular chat. | ChatMember.Read, ChatMember.ReadWrite, Chat.ReadBasic, Chat.Read, Chat.ReadWrite | Not supported. | ChatMember.Read.Chat, Chat.Manage.Chat, ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | |[conversationMember](../resources/conversationmember.md) <br />`/appCatalogs/teamsApps/{id}/installedToChats/getAllMembers` <br />Chat members for all chats in an organization where a particular Teams app is installed. | Not supported. | Not supported. | ChatMember.Read.WhereInstalled, ChatMember.ReadWrite.WhereInstalled, Chat.ReadBasic.WhereInstalled, Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled | |[conversationMember](../resources/conversationmember.md) <br />`/teams/getAllMembers` <br /> Members in all teams in an organization. | Not supported. | Not supported. | TeamMember.Read.All, TeamMember.ReadWrite.All | |[conversationMember](../resources/conversationmember.md) <br />`/teams/{id}/members` <br /> Members in a particular team. | TeamMember.Read.All | Not supported. | TeamMember.Read.All | Depending on the resource and the permission type (delegated or application) req |[virtualEventWebinar](../resources/virtualeventwebinar.md) | VirtualEvent.Read | Not supported. | VirtualEvent.Read.All | |[baseTask](../resources/todotask.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported. | +> [!NOTE] +> The following permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent): +> - OnlineMeetingRecording.Read.Chat +> - OnlineMeetingTranscript.Read.Chat +> - ChatSettings.Read.Chat +> - ChatSettings.ReadWrite.Chat +> - Chat.Manage.Chat +> - ChannelMessage.Read.Group +> - ChatMember.Read.Chat + [!INCLUDE [teams-subscription-notes](../../includes/teams-subscription-notes.md)] ### driveItem |
v1.0 | Subscription Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/subscription-get.md | description: "Retrieve the properties and relationships of a subscription." ms.localizationpriority: medium doc_type: apiPageType+ # Get subscription See the table in the [Permissions](#permissions) section for the list of resourc Depending on the resource and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference). -> **Note**: -> +> [!NOTE] > Some resources support change notifications in multiple scenarios, each of which may require different permissions. In those cases, use the resource path to differentiate the scenarios.-> -> Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). | Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--| Depending on the resource and the permission type (delegated or application) req |[callRecording](../resources/callrecording.md) <br /> `communications/onlineMeetings/getAllRecordings` <br /> Any recording becomes available in the tenant. | Not supported. | Not supported. | OnlineMeetingRecording.Read.All | |[callRecording](../resources/callrecording.md) <br /> `communications/onlineMeetings/{onlineMeetingId}/recordings` <br /> Any recording becomes available for a specific meeting. | OnlineMeetingRecording.Read.All | Not supported. | OnlineMeetingRecording.Read.All | |[callRecording](../resources/callrecording.md) <br /> `users/{userId}/onlineMeetings/getAllRecordings` <br /> A call recording that becomes available in a meeting organized by a specific user. | OnlineMeetingRecording.Read.All | Not supported. | OnlineMeetingRecording.Read.All |+|[callRecording](../resources/callrecording.md) <br /> `appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings` <br /> A call recording that becomes available in a meeting where a particular Teams app is installed. | Not supported. | Not supported. | OnlineMeetingRecording.Read.All, OnlineMeetingRecording.Read.Chat | |[callTranscript](../resources/calltranscript.md) <br /> `communications/onlineMeetings/getAllTranscripts` <br /> Any transcript becomes available in the tenant. | Not supported. | Not supported. | OnlineMeetingTranscript.Read.All | |[callTranscript](../resources/calltranscript.md) <br /> `communications/onlineMeetings/{onlineMeetingId}/transcripts` <br /> Any transcript becomes available for a specific meeting. | OnlineMeetingTranscript.Read.All | Not supported. | OnlineMeetingTranscript.Read.All | |[callTranscript](../resources/calltranscript.md) <br /> `users/{userId}/onlineMeetings/getAllTranscripts` <br /> A call transcript that becomes available in a meeting organized by a specific user. | OnlineMeetingTranscript.Read.All | Not supported. | OnlineMeetingTranscript.Read.All |+|[callTranscript](../resources/calltranscript.md) <br /> `appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTranscripts` <br /> A call recording that becomes available in a meeting where a particular Teams app is installed. | Not supported. | Not supported. | OnlineMeetingTranscript.Read.All, OnlineMeetingTranscript.Read.Chat | |[channel](../resources/channel.md) <br />`/teams/getAllChannels` <br /> All channels in an organization. | Not supported. | Not supported. | Channel.ReadBasic.All, ChannelSettings.Read.All | |[channel](../resources/channel.md) <br />`/teams/{id}/channels` <br /> All channels in a particular team in an organization. | Channel.ReadBasic.All, ChannelSettings.Read.All | Not supported. | Channel.ReadBasic.All, ChannelSettings.Read.All | |[chat](../resources/chat.md) <br />`/chats` <br />All chats in an organization. | Not supported. | Not supported. | Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |-|[chat](../resources/chat.md) <br />`/chats/{id}` <br /> A particular chat.| Chat.ReadBasic, Chat.Read, Chat.ReadWrite | Not supported. | ChatSettings.Read.Chat*, ChatSettings.ReadWrite.Chat*, Chat.Manage.Chat*, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | +|[chat](../resources/chat.md) <br />`/chats/{id}` <br /> A particular chat.| Chat.ReadBasic, Chat.Read, Chat.ReadWrite | Not supported. | ChatSettings.Read.Chat, ChatSettings.ReadWrite.Chat, Chat.Manage.Chat, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | |[chat](../resources/chat.md) <br />`/appCatalogs/teamsApps/{id}/installedToChats` <br />All chats in an organization where a particular Teams app is installed.| Not supported. | Not supported. | Chat.ReadBasic.WhereInstalled, Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled |-|[chatMessage](../resources/chatmessage.md) <br />`/teams/{id}/channels/{id}/messages` <br /> All messages and replies in a particular channel. | ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All | Not supported. | ChannelMessage.Read.Group*, ChannelMessage.Read.All | +|[chatMessage](../resources/chatmessage.md) <br />`/teams/{id}/channels/{id}/messages` <br /> All messages and replies in a particular channel. | ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All | Not supported. | ChannelMessage.Read.Group, ChannelMessage.Read.All | |[chatMessage](../resources/chatmessage.md) <br />`/teams/getAllMessages` <br />All channel messages in organization. | Not supported. | Not supported. | ChannelMessage.Read.All | |[chatMessage](../resources/chatmessage.md) <br />`/chats/{id}/messages` <br /> All messages in a chat. | Chat.Read, Chat.ReadWrite | Not supported. | Chat.Read.All | |[chatMessage](../resources/chatmessage.md) <br />`/chats/getAllMessages` <br /> All chat messages in an organization. | Not supported. | Not supported. | Chat.Read.All | Depending on the resource and the permission type (delegated or application) req |[chatMessage](../resources/chatmessage.md) <br />`/appCatalogs/teamsApps/{id}/installedToChats/getAllMessages` <br />Chat messages for all chats in an organization where a particular Teams app is installed. | Not supported. | Not supported. | Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled | |[contact](../resources/contact.md) | Contacts.Read | Contacts.Read | Contacts.Read | |[conversationMember](../resources/conversationmember.md) <br />`/chats/getAllMembers` <br /> Members of all chats in an organization. | Not supported. | Not supported. | ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |-|[conversationMember](../resources/conversationmember.md) <br />`/chats/{id}/members` <br /> Members of a particular chat. | ChatMember.Read, ChatMember.ReadWrite, Chat.ReadBasic, Chat.Read, Chat.ReadWrite | Not supported. | ChatMember.Read.Chat*, Chat.Manage.Chat*, ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | +|[conversationMember](../resources/conversationmember.md) <br />`/chats/{id}/members` <br /> Members of a particular chat. | ChatMember.Read, ChatMember.ReadWrite, Chat.ReadBasic, Chat.Read, Chat.ReadWrite | Not supported. | ChatMember.Read.Chat, Chat.Manage.Chat, ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | |[conversationMember](../resources/conversationmember.md) <br />`/appCatalogs/teamsApps/{id}/installedToChats/getAllMembers` <br />Chat members for all chats in an organization where a particular Teams app is installed. | Not supported. | Not supported. | ChatMember.Read.WhereInstalled, ChatMember.ReadWrite.WhereInstalled, Chat.ReadBasic.WhereInstalled, Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled | |[conversationMember](../resources/conversationmember.md) <br />`/teams/getAllMembers` <br /> Members in all teams in an organization. | Not supported. | Not supported. | TeamMember.Read.All, TeamMember.ReadWrite.All | |[conversationMember](../resources/conversationmember.md) <br />`/teams/{id}/members` <br /> Members in a particular team. | TeamMember.Read.All | Not supported. | TeamMember.Read.All | Depending on the resource and the permission type (delegated or application) req |[virtualEventWebinar](../resources/virtualeventwebinar.md) | VirtualEvent.Read | Not supported. | VirtualEvent.Read.All | |[baseTask](../resources/basetask.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported. | +> [!NOTE] +> The following permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent): +> - OnlineMeetingRecording.Read.Chat +> - OnlineMeetingTranscript.Read.Chat +> - ChatSettings.Read.Chat +> - ChatSettings.ReadWrite.Chat +> - Chat.Manage.Chat +> - ChannelMessage.Read.Group +> - ChatMember.Read.Chat + [!INCLUDE [teams-subscription-notes](../../includes/teams-subscription-notes.md)] ### driveItem |
v1.0 | Subscription List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/subscription-list.md | description: "Retrieve a list of webhook subscriptions." ms.localizationpriority: medium doc_type: apiPageType+ # List subscriptions The content of the response depends on the context in which the app is calling; Depending on the resource and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference). -> **Note**: -> +> [!NOTE] > Some resources support change notifications in multiple scenarios, each of which may require different permissions. In those cases, use the resource path to differentiate the scenarios.-> -> Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). | Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--| Depending on the resource and the permission type (delegated or application) req |[callRecording](../resources/callrecording.md) <br /> `communications/onlineMeetings/getAllRecordings` <br /> Any recording becomes available in the tenant. | Not supported. | Not supported. | OnlineMeetingRecording.Read.All | |[callRecording](../resources/callrecording.md) <br /> `communications/onlineMeetings/{onlineMeetingId}/recordings` <br /> Any recording becomes available for a specific meeting. | OnlineMeetingRecording.Read.All | Not supported. | OnlineMeetingRecording.Read.All | |[callRecording](../resources/callrecording.md) <br /> `users/{userId}/onlineMeetings/getAllRecordings` <br /> A call recording that becomes available in a meeting organized by a specific user. | OnlineMeetingRecording.Read.All | Not supported. | OnlineMeetingRecording.Read.All |+|[callRecording](../resources/callrecording.md) <br /> `appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings` <br /> A call recording that becomes available in a meeting where a particular Teams app is installed. | Not supported. | Not supported. | OnlineMeetingRecording.Read.All, OnlineMeetingRecording.Read.Chat | |[callTranscript](../resources/calltranscript.md) <br /> `communications/onlineMeetings/getAllTranscripts` <br /> Any transcript becomes available in the tenant. | Not supported. | Not supported. | OnlineMeetingTranscript.Read.All | |[callTranscript](../resources/calltranscript.md) <br /> `communications/onlineMeetings/{onlineMeetingId}/transcripts` <br /> Any transcript becomes available for a specific meeting. | OnlineMeetingTranscript.Read.All | Not supported. | OnlineMeetingTranscript.Read.All | |[callTranscript](../resources/calltranscript.md) <br /> `users/{userId}/onlineMeetings/getAllTranscripts` <br /> A call transcript that becomes available in a meeting organized by a specific user. | OnlineMeetingTranscript.Read.All | Not supported. | OnlineMeetingTranscript.Read.All |+|[callTranscript](../resources/calltranscript.md) <br /> `appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTranscripts` <br /> A call transcript that becomes available in a meeting where a particular Teams app is installed. | Not supported. | Not supported. | OnlineMeetingTranscript.Read.All, OnlineMeetingTranscript.Read.Chat | |[channel](../resources/channel.md) <br />`/teams/getAllChannels` <br /> All channels in an organization. | Not supported. | Not supported. | Channel.ReadBasic.All, ChannelSettings.Read.All | |[channel](../resources/channel.md) <br />`/teams/{id}/channels` <br /> All channels in a particular team in an organization. | Channel.ReadBasic.All, ChannelSettings.Read.All, Subscription.Read.All | Not supported. | Channel.ReadBasic.All, ChannelSettings.Read.All | |[chat](../resources/chat.md) <br />`/chats` <br />All chats in an organization. | Not supported. | Not supported. | Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |-|[chat](../resources/chat.md) <br />`/chats/{id}` <br /> A particular chat. | Chat.ReadBasic, Chat.Read, Chat.ReadWrite, Subscription.Read.All | Not supported. | ChatSettings.Read.Chat*, ChatSettings.ReadWrite.Chat*, Chat.Manage.Chat*, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | +|[chat](../resources/chat.md) <br />`/chats/{id}` <br /> A particular chat. | Chat.ReadBasic, Chat.Read, Chat.ReadWrite, Subscription.Read.All | Not supported. | ChatSettings.Read.Chat, ChatSettings.ReadWrite.Chat, Chat.Manage.Chat, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | |[chat](../resources/chat.md) <br />`/appCatalogs/teamsApps/{id}/installedToChats` <br />All chats in an organization where a particular Teams app is installed. | Not supported. | Not supported. | Chat.ReadBasic.WhereInstalled, Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled |-|[chatMessage](../resources/chatmessage.md) <br />`/teams/{id}/channels/{id}/messages` <br /> All messages and replies in a particular channel.| ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All, Subscription.Read.All | Not supported. | ChannelMessage.Read.Group*, ChannelMessage.Read.All | +|[chatMessage](../resources/chatmessage.md) <br />`/teams/{id}/channels/{id}/messages` <br /> All messages and replies in a particular channel.| ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All, Subscription.Read.All | Not supported. | ChannelMessage.Read.Group, ChannelMessage.Read.All | |[chatMessage](../resources/chatmessage.md) <br />`/teams/getAllMessages` <br />All channel messages in organization. | Not supported. | Not supported. | ChannelMessage.Read.All | |[chatMessage](../resources/chatmessage.md) <br />`/chats/{id}/messages` <br /> All messages in a chat.| Chat.Read, Chat.ReadWrite, Subscription.Read.All | Not supported. | Chat.Read.All | |[chatMessage](../resources/chatmessage.md) <br />`/chats/getAllMessages` <br /> All chat messages in an organization. | Not supported. | Not supported. | Chat.Read.All | Depending on the resource and the permission type (delegated or application) req |[chatMessage](../resources/chatmessage.md) <br />`/appCatalogs/teamsApps/{id}/installedToChats/getAllMessages` <br />Chat messages for all chats in an organization where a particular Teams app is installed. | Not supported. | Not supported. | Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled | |[contact](../resources/contact.md) | Contacts.Read, Subscription.Read.All | Contacts.Read, Subscription.Read.All | Contacts.Read | |[conversationMember](../resources/conversationmember.md) <br />`/chats/getAllMembers` <br /> Members of all chats in an organization.| Not supported. | Not supported. | ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |-|[conversationMember](../resources/conversationmember.md) <br />`/chats/{id}/members` <br /> Members of a particular chat.| ChatMember.Read, ChatMember.ReadWrite, Chat.ReadBasic, Chat.Read, Chat.ReadWrite, Subscription.Read.All | Not supported. | ChatMember.Read.Chat*, Chat.Manage.Chat*, ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | +|[conversationMember](../resources/conversationmember.md) <br />`/chats/{id}/members` <br /> Members of a particular chat.| ChatMember.Read, ChatMember.ReadWrite, Chat.ReadBasic, Chat.Read, Chat.ReadWrite, Subscription.Read.All | Not supported. | ChatMember.Read.Chat, Chat.Manage.Chat, ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | |[conversationMember](../resources/conversationmember.md) <br />`appCatalogs/teamsApps/{id}/installedToChats/getAllMembers` <br />Chat members for all chats in an organization where a particular Teams app is installed. | Not supported. | Not supported. | ChatMember.Read.WhereInstalled, ChatMember.ReadWrite.WhereInstalled, Chat.ReadBasic.WhereInstalled, Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled | |[conversationMember](../resources/conversationmember.md) <br />`/teams/getAllMembers` <br /> Members in all teams in an organization.| Not supported. | Not supported. | TeamMember.Read.All, TeamMember.ReadWrite.All | |[conversationMember](../resources/conversationmember.md) <br />`/teams/{id}/members` <br /> Members in a particular team.| TeamMember.Read.All, Subscription.Read.All | Not supported. | TeamMember.Read.All | Depending on the resource and the permission type (delegated or application) req |[user](../resources/user.md) | User.Read.All, Subscription.Read.All | User.Read.All | User.Read.All | |[baseTask](../resources/basetask.md) (deprecated) | Tasks.ReadWrite, Subscription.Read.All | Tasks.ReadWrite, Subscription.Read.All | Not supported. | +> [!NOTE] +> The following permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent): +> - OnlineMeetingRecording.Read.Chat +> - OnlineMeetingTranscript.Read.Chat +> - ChatSettings.Read.Chat +> - ChatSettings.ReadWrite.Chat +> - Chat.Manage.Chat +> - ChannelMessage.Read.Group +> - ChatMember.Read.Chat + Response results are based on the context of the calling app. The following sections describe the common scenarios. ### Basic scenarios |
v1.0 | Subscription Post Subscriptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/subscription-post-subscriptions.md | description: "Subscribes a listener application to receive change notifications ms.localizationpriority: medium doc_type: apiPageType+ # Create subscription Creating a subscription requires read permission to the resource. For example, t Depending on the resource and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing the permissions, search for the following permissions in [Permissions](/graph/permissions-reference). -> **Note**: -> -> Due to security restrictions, Microsoft Graph subscriptions do not support write access permissions when only read access permissions are needed. -> -> Some resources support change notifications in multiple scenarios, each of which may require different permissions. In those cases, use the resource path to differentiate the scenarios. -> -> Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> - Due to security restrictions, Microsoft Graph subscriptions do not support write access permissions when only read access permissions are needed. +> - Some resources support change notifications in multiple scenarios, each of which may require different permissions. In those cases, use the resource path to differentiate the scenarios. | Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--| Depending on the resource and the permission type (delegated or application) req |[callRecording](../resources/callrecording.md) <br /> `communications/onlineMeetings/getAllRecordings` <br /> Any recording becomes available in the tenant. | Not supported. | Not supported. | OnlineMeetingRecording.Read.All | |[callRecording](../resources/callrecording.md) <br /> `communications/onlineMeetings/{onlineMeetingId}/recordings` <br /> Any recording becomes available for a specific meeting. | OnlineMeetingRecording.Read.All | Not supported. | OnlineMeetingRecording.Read.All | |[callRecording](../resources/callrecording.md) <br /> `users/{userId}/onlineMeetings/getAllRecordings` <br /> A call recording that becomes available in a meeting organized by a specific user. | OnlineMeetingRecording.Read.All | Not supported. | OnlineMeetingRecording.Read.All |+|[callRecording](../resources/callrecording.md) <br /> `appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings` <br /> A call recording that becomes available in a meeting where a particular Teams app is installed. | Not supported. | Not supported. | OnlineMeetingRecording.Read.All, OnlineMeetingRecording.Read.Chat | |[callTranscript](../resources/calltranscript.md) <br /> `communications/onlineMeetings/getAllTranscripts` <br /> Any transcript becomes available in the tenant. | Not supported. | Not supported. | OnlineMeetingTranscript.Read.All | |[callTranscript](../resources/calltranscript.md) <br /> `communications/onlineMeetings/{onlineMeetingId}/transcripts` <br /> Any transcript becomes available for a specific meeting. | OnlineMeetingTranscript.Read.All | Not supported. | OnlineMeetingTranscript.Read.All | |[callTranscript](../resources/calltranscript.md) <br /> `users/{userId}/onlineMeetings/getAllTranscripts` <br /> A call transcript that becomes available in a meeting organized by a specific user. | OnlineMeetingTranscript.Read.All | Not supported. | OnlineMeetingTranscript.Read.All |+|[callTranscript](../resources/calltranscript.md) <br /> `appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTranscripts` <br /> A call transcript that becomes available in a meeting where a particular Teams app is installed. | Not supported. | Not supported. | OnlineMeetingTranscript.Read.All, OnlineMeetingTranscript.Read.Chat | |[channel](../resources/channel.md) <br />`/teams/getAllChannels` <br /> All channels in an organization. | Not supported. | Not supported. | Channel.ReadBasic.All, ChannelSettings.Read.All | |[channel](../resources/channel.md) <br />`/teams/{id}/channels` <br /> All channels in a particular team in an organization. | Channel.ReadBasic.All, ChannelSettings.Read.All | Not supported. | Channel.ReadBasic.All, ChannelSettings.Read.All | |[chat](../resources/chat.md) <br />`/chats` <br />All chats in an organization. | Not supported. | Not supported. | Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |-|[chat](../resources/chat.md) <br />`/chats/{id}` <br /> A particular chat.| Chat.ReadBasic, Chat.Read, Chat.ReadWrite | Not supported. | ChatSettings.Read.Chat*, ChatSettings.ReadWrite.Chat*, Chat.Manage.Chat*, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | +|[chat](../resources/chat.md) <br />`/chats/{id}` <br /> A particular chat.| Chat.ReadBasic, Chat.Read, Chat.ReadWrite | Not supported. | ChatSettings.Read.Chat, ChatSettings.ReadWrite.Chat, Chat.Manage.Chat, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | |[chat](../resources/chat.md) <br />`/appCatalogs/teamsApps/{id}/installedToChats` <br />All chats in an organization where a particular Teams app is installed. | Not supported. | Not supported. | Chat.ReadBasic.WhereInstalled, Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled |-|[chatMessage](../resources/chatmessage.md) <br />`/teams/{id}/channels/{id}/messages` <br /> All messages and replies in a particular channel. | ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All | Not supported. | ChannelMessage.Read.Group*, ChannelMessage.Read.All | +|[chatMessage](../resources/chatmessage.md) <br />`/teams/{id}/channels/{id}/messages` <br /> All messages and replies in a particular channel. | ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All | Not supported. | ChannelMessage.Read.Group, ChannelMessage.Read.All | |[chatMessage](../resources/chatmessage.md) <br />`/teams/getAllMessages` <br />All channel messages in organization. | Not supported. | Not supported. | ChannelMessage.Read.All | |[chatMessage](../resources/chatmessage.md) <br />`/chats/{id}/messages` <br /> All messages in a chat. | Chat.Read, Chat.ReadWrite | Not supported. | Chat.Read.All | |[chatMessage](../resources/chatmessage.md) <br />`/chats/getAllMessages` <br /> All chat messages in an organization. | Not supported. | Not supported. | Chat.Read.All | Depending on the resource and the permission type (delegated or application) req |[chatMessage](../resources/chatmessage.md) <br />`/appCatalogs/teamsApps/{id}/installedToChats/getAllMessages` <br />Chat messages for all chats in an organization where a particular Teams app is installed. | Not supported. | Not supported. | Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled | |[contact](../resources/contact.md) | Contacts.Read | Contacts.Read | Contacts.Read | |[conversationMember](../resources/conversationmember.md) <br />`/chats/getAllMembers` <br /> Members of all chats in an organization. | Not supported. | Not supported. | ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |-|[conversationMember](../resources/conversationmember.md) <br />`/chats/{id}/members` <br /> Members of a particular chat. | ChatMember.Read, ChatMember.ReadWrite, Chat.ReadBasic, Chat.Read, Chat.ReadWrite | Not supported. | ChatMember.Read.Chat*, Chat.Manage.Chat*, ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | +|[conversationMember](../resources/conversationmember.md) <br />`/chats/{id}/members` <br /> Members of a particular chat. | ChatMember.Read, ChatMember.ReadWrite, Chat.ReadBasic, Chat.Read, Chat.ReadWrite | Not supported. | ChatMember.Read.Chat, Chat.Manage.Chat, ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | |[conversationMember](../resources/conversationmember.md) <br />`/appCatalogs/teamsApps/{id}/installedToChats/getAllMembers` <br />Chat members for all chats in an organization where a particular Teams app is installed. | Not supported. | Not supported. | ChatMember.Read.WhereInstalled, ChatMember.ReadWrite.WhereInstalled, Chat.ReadBasic.WhereInstalled, Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled | |[conversationMember](../resources/conversationmember.md) <br />`/teams/getAllMembers` <br /> Members in all teams in an organization. | Not supported. | Not supported. | TeamMember.Read.All, TeamMember.ReadWrite.All | |[conversationMember](../resources/conversationmember.md) <br />`/teams/{id}/members` <br /> Members in a particular team. | TeamMember.Read.All | Not supported. | TeamMember.Read.All | Depending on the resource and the permission type (delegated or application) req |[virtualEventWebinar](../resources/virtualeventwebinar.md) | VirtualEvent.Read | Not supported. | VirtualEvent.Read.All | |[baseTask](../resources/basetask.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported. | +> [!NOTE] +> The following permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent): +> - OnlineMeetingRecording.Read.Chat +> - OnlineMeetingTranscript.Read.Chat +> - ChatSettings.Read.Chat +> - ChatSettings.ReadWrite.Chat +> - Chat.Manage.Chat +> - ChannelMessage.Read.Group +> - ChatMember.Read.Chat + [!INCLUDE [teams-subscription-notes](../../includes/teams-subscription-notes.md)] ### driveItem The following are valid values for the resource property. | Resource type | Examples | |: |:-- | |[callRecord](../resources/callrecords-callrecord.md)|`communications/callRecords`|-|[callRecording](../resources/callrecording.md)| `communications/onlineMeetings/getAllRecordings`, `communications/onlineMeetings/{onlineMeetingId}/recordings`, `users/{userId}/onlineMeetings/getAllRecordings`| -|[callTranscript](../resources/calltranscript.md) | `communications/onlineMeetings/getAllTranscripts`, `communications/onlineMeetings/{onlineMeetingId}/transcripts`, `users/{userId}/onlineMeetings/getAllTranscripts`| +|[callRecording](../resources/callrecording.md)| `communications/onlineMeetings/getAllRecordings`, `communications/onlineMeetings/{onlineMeetingId}/recordings`, `users/{userId}/onlineMeetings/getAllRecordings`, `appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings`| +|[callTranscript](../resources/calltranscript.md) | `communications/onlineMeetings/getAllTranscripts`, `communications/onlineMeetings/{onlineMeetingId}/transcripts`, `users/{userId}/onlineMeetings/getAllTranscripts`, `appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTranscripts`| |[channel](../resources/channel.md)|`/teams/getAllChannels`, `/teams/{id}/channels`| |[chat](../resources/chat.md)|`/chats`, `/chats/{id}`| |[chatMessage](../resources/chatmessage.md) | `chats/{id}/messages`, `chats/getAllMessages`, `teams/{id}/channels/{id}/messages`, `teams/getAllMessages` | The following are valid values for the resource property. |[security alert](../resources/alert.md)|`security/alerts?$filter=status eq 'NewAlert'`| |[baseTask](../resources/basetask.md) (deprecated) | `/me/tasks/lists/{Id}/tasks`| -> **Note:** Any path starting with `me` can also be used with `users/{id}` instead of `me` to target a specific user instead of the current user. +> [!NOTE] +> Any path starting with `me` can also be used with `users/{id}` instead of `me` to target a specific user instead of the current user. ### Response |
v1.0 | Subscription Reauthorize | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/subscription-reauthorize.md | Title: "subscription: reauthorize" description: "Reauthorize a subscription when you receive a reauthorizationRequired challenge." ms.localizationpriority: medium+ doc_type: apiPageType Reauthorize a subscription when you receive a **reauthorizationRequired** challe Depending on the resource and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference). -> **Note**: -> +> [!NOTE] > Some resources support change notifications in multiple scenarios, each of which may require different permissions. In those cases, use the resource path to differentiate the scenarios.-> -> Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). | Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--| Depending on the resource and the permission type (delegated or application) req |[callRecording](../resources/callrecording.md) <br /> `communications/onlineMeetings/getAllRecordings` <br /> Any recording becomes available in the tenant. | Not supported. | Not supported. | OnlineMeetingRecording.Read.All | |[callRecording](../resources/callrecording.md) <br /> `communications/onlineMeetings/{onlineMeetingId}/recordings` <br /> Any recording becomes available for a specific meeting. | OnlineMeetingRecording.Read.All | Not supported. | OnlineMeetingRecording.Read.All | |[callRecording](../resources/callrecording.md) <br /> `users/{userId}/onlineMeetings/getAllRecordings` <br /> A call recording that becomes available in a meeting organized by a specific user. | OnlineMeetingRecording.Read.All | Not supported. | OnlineMeetingRecording.Read.All |+|[callRecording](../resources/callrecording.md) <br /> `appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings` <br /> A call recording that becomes available in a meeting where a particular Teams app is installed. | Not supported. | Not supported. | OnlineMeetingRecording.Read.All, OnlineMeetingRecording.Read.Chat | |[callTranscript](../resources/calltranscript.md) <br /> `communications/onlineMeetings/getAllTranscripts` <br /> Any transcript becomes available in the tenant. | Not supported. | Not supported. | OnlineMeetingTranscript.Read.All | |[callTranscript](../resources/calltranscript.md) <br /> `communications/onlineMeetings/{onlineMeetingId}/transcripts` <br /> Any transcript becomes available for a specific meeting. | OnlineMeetingTranscript.Read.All | Not supported. | OnlineMeetingTranscript.Read.All | |[callTranscript](../resources/calltranscript.md) <br /> `users/{userId}/onlineMeetings/getAllTranscripts` <br /> A call transcript that becomes available in a meeting organized by a specific user. | OnlineMeetingTranscript.Read.All | Not supported. | OnlineMeetingTranscript.Read.All |+|[callTranscript](../resources/calltranscript.md) <br /> `appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTranscripts` <br /> A call transcript that becomes available in a meeting where a particular Teams app is installed. | Not supported. | Not supported. | OnlineMeetingTranscript.Read.All, OnlineMeetingTranscript.Read.Chat | |[channel](../resources/channel.md) <br />`/teams/getAllChannels` <br /> All channels in an organization. | Not supported. | Not supported. | Channel.ReadBasic.All, ChannelSettings.Read.All | |[channel](../resources/channel.md) <br />`/teams/{id}/channels` <br /> All channels in a particular team in an organization. | Channel.ReadBasic.All, ChannelSettings.Read.All | Not supported. | Channel.ReadBasic.All, ChannelSettings.Read.All | |[chat](../resources/chat.md) <br />`/chats` <br />All chats in an organization. | Not supported. | Not supported. | Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |-|[chat](../resources/chat.md) <br />`/chats/{id}` <br /> A particular chat. | Chat.ReadBasic, Chat.Read, Chat.ReadWrite | Not supported. | ChatSettings.Read.Chat*, ChatSettings.ReadWrite.Chat*, Chat.Manage.Chat*, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | +|[chat](../resources/chat.md) <br />`/chats/{id}` <br /> A particular chat. | Chat.ReadBasic, Chat.Read, Chat.ReadWrite | Not supported. | ChatSettings.Read.Chat, ChatSettings.ReadWrite.Chat, Chat.Manage.Chat, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | |[chat](../resources/chat.md) <br />`/appCatalogs/teamsApps/{id}/installedToChats` <br />All chats in an organization where a particular Teams app is installed. | Not supported. | Not supported. | Chat.ReadBasic.WhereInstalled, Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled |-|[chatMessage](../resources/chatmessage.md) <br />`/teams/{id}/channels/{id}/messages` <br /> All messages and replies in a particular channel. | ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All | Not supported. | ChannelMessage.Read.Group*, ChannelMessage.Read.All | +|[chatMessage](../resources/chatmessage.md) <br />`/teams/{id}/channels/{id}/messages` <br /> All messages and replies in a particular channel. | ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All | Not supported. | ChannelMessage.Read.Group, ChannelMessage.Read.All | |[chatMessage](../resources/chatmessage.md) <br />`/teams/getAllMessages` <br />All channel messages in organization. | Not supported. | Not supported. | ChannelMessage.Read.All | |[chatMessage](../resources/chatmessage.md) <br />`/chats/{id}/messages` <br /> All messages in a chat. | Chat.Read, Chat.ReadWrite | Not supported. | Chat.Read.All | |[chatMessage](../resources/chatmessage.md) <br />`/chats/getAllMessages` <br /> All chat messages in an organization. | Not supported. | Not supported. | Chat.Read.All | Depending on the resource and the permission type (delegated or application) req |[chatMessage](../resources/chatmessage.md) <br />`/appCatalogs/teamsApps/{id}/installedToChats/getAllMessages` <br />Chat messages for all chats in an organization where a particular Teams app is installed. | Not supported. | Not supported. | Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled | |[contact](../resources/contact.md) | Contacts.Read | Contacts.Read | Contacts.Read | |[conversationMember](../resources/conversationmember.md) <br />`/chats/getAllMembers` <br /> Members of all chats in an organization. | Not supported. | Not supported. | ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |-|[conversationMember](../resources/conversationmember.md) <br />`/chats/{id}/members` <br /> Members of a particular chat. | ChatMember.Read, ChatMember.ReadWrite, Chat.ReadBasic, Chat.Read, Chat.ReadWrite | Not supported. | ChatMember.Read.Chat*, Chat.Manage.Chat*, ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | +|[conversationMember](../resources/conversationmember.md) <br />`/chats/{id}/members` <br /> Members of a particular chat. | ChatMember.Read, ChatMember.ReadWrite, Chat.ReadBasic, Chat.Read, Chat.ReadWrite | Not supported. | ChatMember.Read.Chat, Chat.Manage.Chat, ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | |[conversationMember](../resources/conversationmember.md) <br />`/appCatalogs/teamsApps/{id}/installedToChats/getAllMembers` <br />Chat members for all chats in an organization where a particular Teams app is installed. | Not supported. | Not supported. | ChatMember.Read.WhereInstalled, ChatMember.ReadWrite.WhereInstalled, Chat.ReadBasic.WhereInstalled, Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled | |[conversationMember](../resources/conversationmember.md) <br />`/teams/getAllMembers` <br /> Members in all teams in an organization. | Not supported. | Not supported. | TeamMember.Read.All, TeamMember.ReadWrite.All | |[conversationMember](../resources/conversationmember.md) <br />`/teams/{id}/members` <br /> Members in a particular team. | TeamMember.Read.All | Not supported. | TeamMember.Read.All | Depending on the resource and the permission type (delegated or application) req |[user](../resources/user.md) | User.Read.All | User.Read.All | User.Read.All | |[baseTask](../resources/todotask.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported. | +> [!NOTE] +> The following permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent): +> - OnlineMeetingRecording.Read.Chat +> - OnlineMeetingTranscript.Read.Chat +> - ChatSettings.Read.Chat +> - ChatSettings.ReadWrite.Chat +> - Chat.Manage.Chat +> - ChannelMessage.Read.Group +> - ChatMember.Read.Chat + [!INCLUDE [teams-subscription-notes](../../includes/teams-subscription-notes.md)] ## HTTP request |
v1.0 | Subscription Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/subscription-update.md | description: "Renew a subscription by extending its expiry time." ms.localizationpriority: medium doc_type: apiPageType+ # Update subscription Subscriptions expire after a length of time that varies by resource type. In ord Depending on the resource and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference). -> **Note**: -> +> [!NOTE] > Some resources support change notifications in multiple scenarios, each of which may require different permissions. In those cases, use the resource path to differentiate the scenarios.-> -> Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). | Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--| Depending on the resource and the permission type (delegated or application) req |[callRecording](../resources/callrecording.md) <br /> `communications/onlineMeetings/getAllRecordings` <br /> Any recording becomes available in the tenant. | Not supported. | Not supported. | OnlineMeetingRecording.Read.All | |[callRecording](../resources/callrecording.md) <br /> `communications/onlineMeetings/{onlineMeetingId}/recordings` <br /> Any recording becomes available for a specific meeting. | OnlineMeetingRecording.Read.All | Not supported. | OnlineMeetingRecording.Read.All | |[callRecording](../resources/callrecording.md) <br /> `users/{userId}/onlineMeetings/getAllRecordings` <br /> A call recording that becomes available in a meeting organized by a specific user. | OnlineMeetingRecording.Read.All | Not supported. | OnlineMeetingRecording.Read.All |+|[callRecording](../resources/callrecording.md) <br /> `appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings` <br /> A call recording that becomes available in a meeting where a particular Teams app is installed. | Not supported. | Not supported. | OnlineMeetingRecording.Read.All, OnlineMeetingRecording.Read.Chat | |[callTranscript](../resources/calltranscript.md) <br /> `communications/onlineMeetings/getAllTranscripts` <br /> Any transcript becomes available in the tenant. | Not supported. | Not supported. | OnlineMeetingTranscript.Read.All | |[callTranscript](../resources/calltranscript.md) <br /> `communications/onlineMeetings/{onlineMeetingId}/transcripts` <br /> Any transcript becomes available for a specific meeting. | OnlineMeetingTranscript.Read.All | Not supported. | OnlineMeetingTranscript.Read.All | |[callTranscript](../resources/calltranscript.md) <br /> `users/{userId}/onlineMeetings/getAllTranscripts` <br /> A call transcript that becomes available in a meeting organized by a specific user. | OnlineMeetingTranscript.Read.All | Not supported. | OnlineMeetingTranscript.Read.All |+|[callTranscript](../resources/calltranscript.md) <br /> `appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTranscripts` <br /> A call transcript that becomes available in a meeting where a particular Teams app is installed. | Not supported. | Not supported. | OnlineMeetingTranscript.Read.All, OnlineMeetingTranscript.Read.Chat | |[channel](../resources/channel.md) <br />`/teams/getAllChannels` <br /> All channels in an organization. | Not supported. | Not supported. | Channel.ReadBasic.All, ChannelSettings.Read.All | |[channel](../resources/channel.md) <br />`/teams/{id}/channels` <br /> All channels in a particular team in an organization. | Channel.ReadBasic.All, ChannelSettings.Read.All | Not supported. | Channel.ReadBasic.All, ChannelSettings.Read.All | |[chat](../resources/chat.md) <br />`/chats` <br />All chats in an organization. | Not supported. | Not supported. | Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |-|[chat](../resources/chat.md) <br />`/chats/{id}` <br /> A particular chat.| Chat.ReadBasic, Chat.Read, Chat.ReadWrite | Not supported. | ChatSettings.Read.Chat*, ChatSettings.ReadWrite.Chat*, Chat.Manage.Chat*, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | +|[chat](../resources/chat.md) <br />`/chats/{id}` <br /> A particular chat.| Chat.ReadBasic, Chat.Read, Chat.ReadWrite | Not supported. | ChatSettings.Read.Chat, ChatSettings.ReadWrite.Chat, Chat.Manage.Chat, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | |[chat](../resources/chat.md) <br />`/appCatalogs/teamsApps/{id}/installedToChats` <br />All chats in an organization where a particular Teams app is installed.| Not supported. | Not supported. | Chat.ReadBasic.WhereInstalled, Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled |-|[chatMessage](../resources/chatmessage.md) <br />`/teams/{id}/channels/{id}/messages` <br /> All messages and replies in a particular channel. | ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All | Not supported. | ChannelMessage.Read.Group*, ChannelMessage.Read.All | +|[chatMessage](../resources/chatmessage.md) <br />`/teams/{id}/channels/{id}/messages` <br /> All messages and replies in a particular channel. | ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All | Not supported. | ChannelMessage.Read.Group, ChannelMessage.Read.All | |[chatMessage](../resources/chatmessage.md) <br />`/teams/getAllMessages` <br />All channel messages in organization. | Not supported. | Not supported. | ChannelMessage.Read.All | |[chatMessage](../resources/chatmessage.md) <br />`/chats/{id}/messages` <br /> All messages in a chat. | Chat.Read, Chat.ReadWrite | Not supported. | Chat.Read.All | |[chatMessage](../resources/chatmessage.md) <br />`/chats/getAllMessages` <br /> All chat messages in an organization. | Not supported. | Not supported. | Chat.Read.All | Depending on the resource and the permission type (delegated or application) req |[chatMessage](../resources/chatmessage.md) <br />`/appCatalogs/teamsApps/{id}/installedToChats/getAllMessages` <br />Chat messages for all chats in an organization where a particular Teams app is installed. | Not supported. | Not supported. | Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled | |[contact](../resources/contact.md) | Contacts.Read | Contacts.Read | Contacts.Read | |[conversationMember](../resources/conversationmember.md) <br />`/chats/getAllMembers` <br /> Members of all chats in an organization. | Not supported. | Not supported. | ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |-|[conversationMember](../resources/conversationmember.md) <br />`/chats/{id}/members` <br /> Members of a particular chat. | ChatMember.Read, ChatMember.ReadWrite, Chat.ReadBasic, Chat.Read, Chat.ReadWrite | Not supported. | ChatMember.Read.Chat*, Chat.Manage.Chat*, ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | +|[conversationMember](../resources/conversationmember.md) <br />`/chats/{id}/members` <br /> Members of a particular chat. | ChatMember.Read, ChatMember.ReadWrite, Chat.ReadBasic, Chat.Read, Chat.ReadWrite | Not supported. | ChatMember.Read.Chat, Chat.Manage.Chat, ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | |[conversationMember](../resources/conversationmember.md) <br />`/appCatalogs/teamsApps/{id}/installedToChats/getAllMembers` <br />Chat members for all chats in an organization where a particular Teams app is installed. | Not supported. | Not supported. | ChatMember.Read.WhereInstalled, ChatMember.ReadWrite.WhereInstalled, Chat.ReadBasic.WhereInstalled, Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled | |[conversationMember](../resources/conversationmember.md) <br />`/teams/getAllMembers` <br /> Members in all teams in an organization. | Not supported. | Not supported. | TeamMember.Read.All, TeamMember.ReadWrite.All | |[conversationMember](../resources/conversationmember.md) <br />`/teams/{id}/members` <br /> Members in a particular team. | TeamMember.Read.All | Not supported. | TeamMember.Read.All | Depending on the resource and the permission type (delegated or application) req |[virtualEventWebinar](../resources/virtualeventwebinar.md) | VirtualEvent.Read | Not supported. | VirtualEvent.Read.All | |[baseTask](../resources/basetask.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported. | +> [!NOTE] +> The following permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent): +> - OnlineMeetingRecording.Read.Chat +> - OnlineMeetingTranscript.Read.Chat +> - ChatSettings.Read.Chat +> - ChatSettings.ReadWrite.Chat +> - Chat.Manage.Chat +> - ChannelMessage.Read.Group +> - ChatMember.Read.Chat + [!INCLUDE [teams-subscription-notes](../../includes/teams-subscription-notes.md)] ### driveItem |
v1.0 | Superawsresourcefinding Aggregatedsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/superawsresourcefinding-aggregatedsummary.md | description: "View the count of super AWS resources for the specified authorizat ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Superawsresourcefinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/superawsresourcefinding-get.md | description: "Read the properties and relationships of a superAwsResourceFinding ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Superawsresourcefinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/superawsresourcefinding-list.md | description: "Get a list of the superAwsResourceFinding objects and their proper ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Superawsrolefinding Aggregatedsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/superawsrolefinding-aggregatedsummary.md | description: View the count of super AWS roles in your authorization systems. ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Superawsrolefinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/superawsrolefinding-get.md | description: "Read the properties and relationships of a superAwsRoleFinding obj ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Superawsrolefinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/superawsrolefinding-list.md | description: "Get a list of the superAwsRoleFinding objects and their properties ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Superazureserviceprincipalfinding Aggregatedsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/superazureserviceprincipalfinding-aggregatedsummary.md | description: View the count of super Azure service principals in your authorizat ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Superazureserviceprincipalfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/superazureserviceprincipalfinding-get.md | description: "Read the properties and relationships of a superAzureServicePrinci ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Superazureserviceprincipalfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/superazureserviceprincipalfinding-list.md | description: "Get a list of the superAzureServicePrincipalFinding objects and th ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Supergcpserviceaccountfinding Aggregatedsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/supergcpserviceaccountfinding-aggregatedsummary.md | description: View the count of super GCP service accounts in your authorization ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Supergcpserviceaccountfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/supergcpserviceaccountfinding-get.md | description: "Read the properties and relationships of a superGcpServiceAccountF ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Supergcpserviceaccountfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/supergcpserviceaccountfinding-list.md | description: "Get a list of the superGcpServiceAccountFinding objects and their ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Superserverlessfunctionfinding Aggregatedsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/superserverlessfunctionfinding-aggregatedsummary.md | description: "View the raw count of super serverless functions in the specified ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Superserverlessfunctionfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/superserverlessfunctionfinding-get.md | description: "Read the properties and relationships of a superServerlessFunction ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Superserverlessfunctionfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/superserverlessfunctionfinding-list.md | description: "Get a list of the superServerlessFunctionFinding objects and their ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Superuserfinding Aggregatedsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/superuserfinding-aggregatedsummary.md | description: "View the raw count of super users in the specified AWS, Azure, or ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Superuserfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/superuserfinding-get.md | description: "Read the properties and relationships of a superUserFinding object ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Superuserfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/superuserfinding-list.md | description: "Get a list of the superUserFinding objects and their properties." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Swapshiftschangerequest Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/swapshiftschangerequest-get.md | Retrieve the properties and relationships of a [swapShiftsChangeRequest](../reso ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -| Permission type | Permissions (from least to most privileged) | -|:|:--| -| Delegated (work or school account) | Group.ReadWrite.All | -| Delegated (personal Microsoft account) | Not supported. | -| Application | Schedule.Read.All*, Schedule.ReadWrite.All* | +<!-- { "blockType": "permissions", "name": "swapshiftschangerequest_get" } --> ->\* **Important:** Application permissions are currently in private preview only and are not available for public use. +> [!NOTE] +> The Schedule.Read.All and Schedule.ReadWrite.All application permissions are currently in private preview only and are not available for public use. ## HTTP request |
v1.0 | Swapshiftschangerequest List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/swapshiftschangerequest-list.md | Retrieve a list of [swapShiftsChangeRequest](../resources/swapshiftschangereques ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -| Permission type | Permissions (from least to most privileged) | -|:|:--| -| Delegated (work or school account) | Group.ReadWrite.All | -| Delegated (personal Microsoft account) | Not supported. | -| Application | Schedule.Read.All*, Schedule.ReadWrite.All* | +<!-- { "blockType": "permissions", "name": "swapshiftschangerequest_list" } --> ->\* **Important:** Application permissions are currently in private preview only and are not available for public use. +> [!NOTE] +> The Schedule.Read.All and Schedule.ReadWrite.All application permissions are currently in private preview only and are not available for public use. ## HTTP request |
v1.0 | Swapshiftschangerequest Post | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/swapshiftschangerequest-post.md | Create an instance of a [swapShiftsChangeRequest](../resources/swapshiftschanger ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -| Permission type | Permissions (from least to most privileged) | -|:|:--| -| Delegated (work or school account) | Group.ReadWrite.All | -| Delegated (personal Microsoft account) | Not supported. | -| Application | Schedule.ReadWrite.All* | +<!-- { "blockType": "permissions", "name": "swapshiftschangerequest_post" } --> ->\* **Important:** Application permissions are currently in private preview only and are not available for public use. +> [!NOTE] +> The Schedule.ReadWrite.All application permission is currently in private preview only and isn't available for public use. ## HTTP request |
v1.0 | Targetdevicegroup Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/targetdevicegroup-get.md | Namespace: microsoft.graph Read the properties and relationships of a [targetDeviceGroup](../resources/targetdevicegroup.md) object for the remoteDesktopSecurityConfiguration object on the servicePrincipal. ## 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). |
v1.0 | Targetdevicegroup Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/targetdevicegroup-update.md | Namespace: microsoft.graph Update the properties of a [targetDeviceGroup](../resources/targetdevicegroup.md) object for remoteDesktopSecurityConfiguration object on the servicePrincipal. You can configure a maximum of 10 target device groups for the remoteDesktopSecurityConfiguraiton object on the servicePrincipal. ## 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). |
v1.0 | Team Clone | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-clone.md | Cloning is a long-running operation. After the POST clone returns, you need to G ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Team.Create, Group.ReadWrite.All**, Directory.ReadWrite.All** | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Team.Create, Group.ReadWrite.All**, Directory.ReadWrite.All** | +<!-- { "blockType": "permissions", "name": "team_clone" } --> -> **Note**: Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> [!NOTE] +> The Group.ReadWrite.All and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. ## HTTP request <!-- { "blockType": "ignored" } --> POST /teams/{id}/clone | Property | Type |Description| |:|:--|:-| |classification|String (optional)|Describes a classification for the group (such as low, medium or high business impact). Valid values for this property are defined by creating a ClassificationList [setting](../resources/directorysetting.md) value, based on the [template definition](../resources/directorysettingtemplate.md). If classification isn't specified, the classification is copied from the original team/group.|-|description|String (optional)|An optional description for the group. If this property isn't specified, it is left blank.| +|description|String (optional)|An optional description for the group. If this property isn't specified, it's left blank.| |displayName|String|The display name for the group. This property is required when a group is created and it can't be cleared during updates. Supports $filter and $orderby.| |mailNickname|String|The mail alias for the group, unique in the organization. This property must be specified when a group is created. Supports $filter. If this property isn't specified, it's computed from the displayName. Known issue: this property is currently ignored.| |partsToClone| [clonableTeamParts](../resources/clonableteamparts.md) |A comma-separated list of the parts to clone. Legal parts are "apps, tabs, settings, channels, members".| |
v1.0 | Team Delete Installedapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-delete-installedapps.md | Uninstalls an [app](../resources/teamsappinstallation.md) from the specified [te ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | TeamsAppInstallation.ReadWriteSelfForTeam, TeamsAppInstallation.ReadWriteForTeam, Group.ReadWrite.All**, Directory.ReadWrite.All** | -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamsAppInstallation.ReadWriteSelfForTeam.All, TeamsAppInstallation.ReadWriteForTeam.All, Group.ReadWrite.All**, Directory.ReadWrite.All** | +<!-- { "blockType": "permissions", "name": "team_delete_installedapps" } --> -> **Note**: Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> [!NOTE] +> The Group.ReadWrite.All and Directory.ReadWrite.All permission are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Team Get Installedapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-get-installedapps.md | Retrieve the [app](../resources/teamsappinstallation.md) installed in the specif ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | TeamsAppInstallation.ReadWriteSelfForTeam, TeamsAppInstallation.ReadForUser, TeamsAppInstallation.ReadForTeam, TeamsAppInstallation.ReadWriteForTeam, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam, TeamsAppInstallation.ReadWriteAndConsentForTeam, Group.Read.All<sup>1</sup>, Group.ReadWrite.All<sup>1</sup>, Directory.Read.All<sup>1</sup>, Directory.ReadWrite.All<sup>1</sup> | -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamsAppInstallation.Read.Group<sup>2</sup>, TeamsAppInstallation.ReadWriteSelfForTeam, TeamsAppInstallation.ReadForTeam.All, TeamsAppInstallation.ReadWriteForTeam.All, TeamsAppInstallation.ReadWriteAndConsentForTeam.All, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam.All, Group.Read.All<sup>1</sup>, Group.ReadWrite.All<sup>1</sup>, Directory.Read.All<sup>1</sup>, Directory.ReadWrite.All<sup>1</sup> | +<!-- { "blockType": "permissions", "name": "team_get_installedapps" } --> +> [!NOTE] +> - The Group.Read.All, Group.ReadWrite.All, Directory.Read.All, and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission and avoid using these permissions going forward. +> - The TeamsAppInstallation.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request |
v1.0 | Team Get Members | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-get-members.md | Get a [conversationMember](../resources/conversationmember.md) from a [team](../ ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission Type|Permissions (from least to most privileged)| -||-| -|Delegated (work or school account)| TeamMember.Read.All, TeamMember.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application| TeamMember.Read.Group*, TeamMember.Read.All, TeamMember.ReadWrite.All | +<!-- { "blockType": "permissions", "name": "team_get_members" } --> -> **Note**: Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamMember.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request <!-- { "blockType": "ignored"} --> GET /teams/{team-id}/members/{membership-id} ## Optional query parameters -This operation does not support the [OData query parameters](/graph/query-parameters) to customize the response. +This operation doesn't support the [OData query parameters](/graph/query-parameters) to customize the response. ## Request headers |
v1.0 | Team Get Primarychannel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-get-primarychannel.md | Get the default [channel](../resources/channel.md), **General**, of a [team](../ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | ChannelSettings.Read.Group*, ChannelSettings.ReadWrite.Group*, Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All | +This API supports admin permissions. Global admins can access groups that they aren't a member of. -> **Note**: Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +<!-- { "blockType": "permissions", "name": "team_get_primarychannel" } --> -> **Note**: This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of. +> [!NOTE] +> The ChannelSettings.Read.Group and ChannelSettings.ReadWrite.Group permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Team List Allchannels | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-list-allchannels.md | Don't supply a request body for this method. ## Response -If successful, this method returns a `200 OK` response code and a collection of [channel](../resources/channel.md) objects in the response body. The response also includes the **@odata.id** property which can be used to access the channel and run other operations on the [channel](../resources/channel.md) object. +If successful, this method returns a `200 OK` response code and a collection of [channel](../resources/channel.md) objects in the response body. The response also includes the **@odata.id** property, which can be used to access the channel and run other operations on the [channel](../resources/channel.md) object. > [!Note]-> Currently, invoking the URL returned from the **@odata.id** property fails for cross-tenant shared channels. You can solve this issue if you remove the `/tenants/{tenant-id}` part from the URL before you call this API. For more details, see [Known issues with Microsoft Graph](https://developer.microsoft.com/en-us/graph/known-issues/?search=14971). +> Currently, invoking the URL returned from the **@odata.id** property fails for cross-tenant shared channels. You can solve this issue if you remove the `/tenants/{tenant-id}` part from the URL before you call this API. For more information, see [Known issues with Microsoft Graph](https://developer.microsoft.com/en-us/graph/known-issues/?search=14971). ## Examples Content-Type: application/json "displayName": "General", "description": "AutoTestTeam_20210311_150740.2550_fim3udfdjen9", "membershipType": "standard",+ "isArchived": false, "tenantId": "b3246f44-b4gb-4627-96c6-25b18fa2c910" }, { Content-Type: application/json "createdDateTime": "2020-05-27T19:22:25.692Z", "displayName": "Shared channel from Contoso", "membershipType": "shared",+ "isArchived": false, "tenantId": "b3246f44-b4gb-5678-96c6-25b18fa2c910" } ] Content-Type: application/json "membershipType": "shared", "tenantId": "b3246f44-b4gb-5678-96c6-25b18fa2c910", "email": "someperson@microsoft.com",- "moderationSettings": null + "moderationSettings": null, + "isArchived": false, + "tenantId": "b3246f44-b4gb-5678-96c6-25b18fa2c910" } ] } |
v1.0 | Team List Installedapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-list-installedapps.md | Retrieve the list of [apps installed](../resources/teamsappinstallation.md) in t ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | TeamsAppInstallation.ReadForTeam, TeamsAppInstallation.ReadWriteSelfForTeam, TeamsAppInstallation.ReadWriteForTeam, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam, TeamsAppInstallation.ReadWriteAndConsentForTeam, Group.Read.All<sup>1</sup>, Group.ReadWrite.All<sup>1</sup>, Directory.Read.All<sup>1</sup>, Directory.ReadWrite.All<sup>1</sup> | -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamsAppInstallation.Read.Group<sup>2</sup>, TeamsAppInstallation.ReadWriteSelfForTeam.All, TeamsAppInstallation.ReadForTeam.All, TeamsAppInstallation.ReadWriteForTeam.All, TeamsAppInstallation.ReadWriteAndConsentForTeam.All, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam.All, Group.Read.All<sup>1</sup>, Group.ReadWrite.All<sup>1</sup>, Directory.Read.All<sup>1</sup>, Directory.ReadWrite.All<sup>1</sup> | +<!-- { "blockType": "permissions", "name": "team_list_installedapps" } --> +> [!NOTE] +> - The Group.Read.All, Group.ReadWrite.All, Directory.Read.All, and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission and avoid using these permissions going forward. +> - The TeamsAppInstallation.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request |
v1.0 | Team List Members | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-list-members.md | Namespace: microsoft.graph Get the [conversationMember](../resources/conversationmember.md) collection of a [team](../resources/team.md). -The membership IDs returned by the server must be treated as opaque strings. The client should not try to parse or make assumptions about these resource IDs. +The membership IDs returned by the server must be treated as opaque strings. The client shouldn't try to parse or make assumptions about these resource IDs. -In the future, membership results may include users from various tenants, as indicated in the response. Clients should avoid assuming that all members exclusively belong to the current tenant. +In the future, membership results can include users from various tenants, as indicated in the response. Clients should avoid assuming that all members exclusively belong to the current tenant. > [!NOTE] > This API results in a 401 error when a newly created tenant calls this method. For more information, see [Known issues](https://developer.microsoft.com/en-us/graph/known-issues/?search=19164). In the future, membership results may include users from various tenants, as ind [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)| TeamMember.Read.All, TeamMember.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application| TeamMember.Read.Group*, TeamMember.Read.All, TeamMember.ReadWrite.All | +<!-- { "blockType": "permissions", "name": "team_list_members" } --> -> **Note**: Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamMember.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request |
v1.0 | Team List Permissiongrants | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-list-permissiongrants.md | One of the following permissions is required to call this API. To learn more, in | :- | :-- | | Delegated (work or school account) | TeamsAppInstallation.ReadForTeam, TeamsAppInstallation.ReadWriteSelfForTeam, TeamsAppInstallation.ReadWriteForTeam | | Delegated (personal Microsoft account) | Not supported. |-| Application | TeamsAppInstallation.Read.Group*, TeamsAppInstallation.ReadForTeam.All, TeamsAppInstallation.ReadWriteSelfForTeam.All, TeamsAppInstallation.ReadWriteForTeam.All, TeamsApp.Read.Group* | +| Application | TeamsAppInstallation.Read.Group*, TeamsAppInstallation.ReadForTeam.All, TeamsAppInstallation.ReadWriteSelfForTeam.All, TeamsAppInstallation.ReadWriteForTeam.All, TeamsApp.Read.Group | -> **Note**: Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamsApp.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request <!-- { "blockType": "ignored" } --> GET /teams/{team-id}/permissionGrants ## Optional query parameters -This operation does not support the [OData query parameters](/graph/query-parameters) to customize the response. +This operation doesn't support the [OData query parameters](/graph/query-parameters) to customize the response. ## Request headers |
v1.0 | Team Post Installedapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-post-installedapps.md | Install an [app](../resources/teamsapp.md) to the specified [team](../resources/ ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | TeamsAppInstallation.ReadWriteSelfForTeam<sup>1</sup>, TeamsAppInstallation.ReadWriteForTeam<sup>1</sup>, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam, Group.ReadWrite.All<sup>2</sup>, Directory.ReadWrite.All<sup>2</sup> | -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamsAppInstallation.ReadWriteSelfForTeam.All<sup>1</sup>, TeamsAppInstallation.ReadWriteForTeam.All<sup>1</sup>, TeamsAppInstallation.ReadWriteAndConsentForTeam.All, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam.All, Group.ReadWrite.All<sup>2</sup>, Directory.ReadWrite.All<sup>2</sup> | +<!-- { "blockType": "permissions", "name": "team_post_installedapps" } --> -> **Note**: -<br><sup>1</sup> These permissions cannot be used to install apps that require consent to [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent) permissions -<br><sup>2</sup> These permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission and avoid using these permissions going forward. +> [!NOTE] +> - The TeamsAppInstallation.ReadWriteSelfForTeam, TeamsAppInstallation.ReadWriteForTeam, TeamsAppInstallation.ReadWriteSelfForTeam.All, and TeamsAppInstallation.ReadWriteForTeam.All permissions cannot be used to install apps that require consent to [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent) permissions. +> - The Group.ReadWrite.All and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission and avoid using these permissions going forward. ## HTTP request <!-- { "blockType": "ignored" } --> POST /teams/{team-id}/installedApps The request body should contain the catalog app's generated app ID. For details, see [teamsApp properties](../resources/teamsapp.md#properties). -The following table lists additional properties that can be included in the request body. +The following table lists other properties that can be included in the request body. | Property | Type |Description| |:|:--|:-| |
v1.0 | Team Post Members | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-post-members.md | If successful, this method returns a `201 Created` response code and a [conversa For best results, stagger calls with a 2 second buffer. +> [!NOTE] +> The response code `404 Not Found` is returned when you attempt to add a disabled/blocked user. + ## Examples ### Example 1: Add a member to a team |
v1.0 | Team Post | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-post.md | Create a new [team](../resources/team.md). ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -| Permission type | Permissions (from least to most privileged) | -| :- | : | -| Delegated (work or school account) | Team.Create, Group.ReadWrite.All**, Directory.ReadWrite.All** | -| Delegated (personal Microsoft account) | Not supported. | -| Application | Team.Create, Teamwork.Migrate.All, Group.ReadWrite.All**, Directory.ReadWrite.All** | +<!-- { "blockType": "permissions", "name": "team_post" } --> -> **Note**: The Teamwork.Migrate.All permission is *only* supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). -In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. --> **Note**: Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> [!NOTE] +> The Teamwork.Migrate.All permission is only supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. +> - The Group.ReadWrite.All and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. ## HTTP request To create a team from a non-standard base template, you want to change the `temp To learn more about supported base template types, see [Get started with Teams templates](/MicrosoftTeams/get-started-with-teams-templates). -> [!Note] +> [!NOTE] > It can take up to 24 hours for Teams users to see a custom template change in the gallery. #### Request |
v1.0 | Team Sendactivitynotification | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-sendactivitynotification.md | Send an activity feed notification in the scope of a team. For more information, [!INCLUDE [national-cloud-support](../../includes/global-us.md)] ## Permissions-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|TeamsActivity.Send| -|Delegated (personal Microsoft account)|Not Supported.| -|Application|TeamsActivity.Send.Group*, TeamsActivity.Send| +<!-- { "blockType": "permissions", "name": "team_sendactivitynotification" } --> ->**Note:** Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamsActivity.Send.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request |
v1.0 | Team Teamsappinstallation Upgrade | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-teamsappinstallation-upgrade.md | Title: "teamsAppInstallation: upgrade" -description: "Upgrade an app installation in a team" +description: "Upgrade an app installation in a team." ms.localizationpriority: medium Upgrade an [app installation](../resources/teamsappinstallation.md) in a [team]( ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | TeamsAppInstallation.ReadWriteSelfForTeam<sup>1</sup>, TeamsAppInstallation.ReadWriteForTeam<sup>1</sup>, TeamsAppInstallation.ReadWriteAndConsentForTeam, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam, Group.ReadWrite.All<sup>2</sup>, Directory.ReadWrite.All<sup>2</sup> | -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamsAppInstallation.ReadWriteSelfForTeam.All<sup>1</sup>, TeamsAppInstallation.ReadWriteForTeam.All<sup>1</sup>, TeamsAppInstallation.ReadWriteAndConsentForTeam.All, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam.All, Group.ReadWrite.All<sup>2</sup>, Directory.ReadWrite.All<sup>2</sup> | +<!-- { "blockType": "permissions", "name": "team_teamsappinstallation_upgrade" } --> -> **Note**: -<br><sup>1</sup> These permissions cannot be used to install apps that require consent to [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent) permissions. -<br><sup>2</sup> These permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission and avoid using these permissions going forward. +> [!NOTE] +> - The TeamsAppInstallation.ReadWriteSelfForTeam, TeamsAppInstallation.ReadWriteForTeampermissions, TeamsAppInstallation.ReadWriteSelfForTeam.All, and TeamsAppInstallation.ReadWriteForTeam.All permissions cannot be used to install apps that require consent to [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent) permissions. +> - The Group.ReadWrite.All and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission and avoid using these permissions going forward. ## HTTP request <!-- { "blockType": "ignored" } --> POST /teams/{team-id}/installedApps/{app-installation-id}/upgrade In the request body, supply a JSON representation of the parameters. -The following table shows additional parameters that can be used with the upgrade action. +The following table shows more parameters that can be used with the upgrade action. |Parameter|Type|Description| |:|:|:| |
v1.0 | Teamsapp Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/teamsapp-delete.md | You can also use this API to remove a submitted app from the review process. ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). ->**Note:** Only global administrators can call this API. +>**Note:** Only global administrators can call this API. -| Permission Type | Permissions (from least to most privileged)| -|:- |:-| -| Delegated (work or school account) | AppCatalog.Submit, AppCatalog.ReadWrite.All, Directory.ReadWrite.All** | -| Delegated (personal Microsoft account) | Not supported.| -| Application | Not supported. | +<!-- { "blockType": "permissions", "name": "teamsapp_delete" } --> -> **Note:** -> -> * Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. -> * You can only use the `AppCatalog.Submit` permission to delete app definitions in review. +> [!NOTE] +> - The Directory.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> - You can only use the AppCatalog.Submit permission to delete app definitions in review. ## HTTP request To delete an app from the app catalog: DELETE /appCatalogs/teamsApps/{id} ``` -To delete an app that has been submitted but has not been approved: +To delete an app that is submitted but isn't yet approved: ```http DELETE appCatalogs/teamsApps/{appId}/appDefinitions/{appDefinitionId} |
v1.0 | Teamsapp Publish | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/teamsapp-publish.md | Title: "Publish teamsapp" + Title: "Publish teamsApp" description: "Publish an app to the Microsoft Teams app catalog." ms.localizationpriority: medium The **requiresReview** property allows any user to submit an app for review by a ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -| Permission Type | Permissions (from least to most privileged)| -|:- |:-| -| Delegated (work or school account) | AppCatalog.Submit, AppCatalog.ReadWrite.All, Directory.ReadWrite.All** | -| Delegated (personal Microsoft account) | Not supported. | -| Application | Not supported. | +<!-- { "blockType": "permissions", "name": "teamsapp_publish" } --> -> **Note**: Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> [!NOTE] +> The Directory.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. ## HTTP request POST /appCatalogs/teamsApps?requiresReview={Boolean} |Property|Type|Description| |-|-|-|-|requiresReview| Boolean | This optional query parameter triggers the app review process. Users with admin privileges can submit apps without triggering a review. If users want to request a review before publishing, they must set **requiresReview** to `true`. A user who has admin privileges can opt not to set **requiresReview** or set the value to `false` and the app will be considered approved and will publish instantly.| +|requiresReview| Boolean | This optional query parameter triggers the app review process. Users with admin privileges can submit apps without triggering a review. If users want to request a review before publishing, they must set **requiresReview** to `true`. A user who has admin privileges can opt not to set **requiresReview** or set the value to `false` and the app is approved and immediately published.| ## Request headers |
v1.0 | Teamsapp Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/teamsapp-update.md | This API specifically updates an app published to your organization's app catalo ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -| Permission Type | Permissions (from least to most privileged)| -|:- |:-| -| Delegated (work or school account) | AppCatalog.Submit, AppCatalog.ReadWrite.All, Directory.ReadWrite.All** | -| Delegated (personal Microsoft account) | Not supported. | -| Application | Not supported. | +Only Global Administrators can call this API. -> **Note:** -> * Only Global Administrators can call this API. -> * Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +<!-- { "blockType": "permissions", "name": "teamsapp_update" } --> ++> [!NOTE] +> The Directory.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. ## HTTP request POST /appCatalogs/teamsApps/{id}/appDefinitions |Property|Type|Description| |-|-|-|-|requiresReview| Boolean | This optional query parameter triggers the app review process. Users with admin privileges can submit apps without triggering a review. If users want to request a review before publishing, they must set **requiresReview** to `true`. A user who has admin privileges can opt not to set **requiresReview** or set the value to `false` and the app will be considered approved and will publish instantly.| +|requiresReview| Boolean | This optional query parameter triggers the app review process. Users with admin privileges can submit apps without triggering a review. If users want to request a review before publishing, they must set **requiresReview** to `true`. A user who has admin privileges can opt not to set **requiresReview** or set the value to `false` and the app is approved and immediately published.| ## Request headers If successful, this method returns a `204 No Content` response code. HTTP/1.1 204 No Content ``` -### Example 2: Update a new version of an existing app for admin review prior to publication in the current tenant catalog +### Example 2: Update a new version of an existing app for admin review before publication in the current tenant catalog #### Request |
v1.0 | Teamsasyncoperation Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/teamsasyncoperation-get.md | Get the specified [Teams async operation](../resources/teamsasyncoperation.md) t [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). The following permissions are for getting the operation on a chat: -| Permission type | Permissions (from least to most privileged)| -| :- | : | -| Delegated (work or school account) | Chat.ReadBasic, Chat.Read, Chat.ReadWrite| -| Delegated (personal Microsoft account) | Not supported. | -| Application | ChatSettings.Read.Chat*, ChatSettings.ReadWrite.Chat*, Chat.Manage.Chat*, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All | +<!-- { "blockType": "permissions", "name": "teamsasyncoperation_get" } --> -> **Note**: Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChatSettings.Read.Chat, ChatSettings.ReadWrite.Chat, and Chat.Manage.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request <!-- { |
v1.0 | Tenantreference Removepersonaldata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/tenantreference-removepersonaldata.md | Title: "tenantReference: removePersonalData" description: "Create a request to remove the personal data for an outboundSharedUserProfile." + ms.localizationpriority: medium doc_type: apiPageType |
v1.0 | Tenantrelationship Put Multitenantorganization | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/tenantrelationship-put-multitenantorganization.md | Content-Type: application/json } ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/create-multitenantorganization-from--javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) + ### Response |
v1.0 | Timecard Clockin | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/timecard-clockin.md | Clock in to start a [timeCard](../resources/timeCard.md). ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Schedule.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.ReadWrite.All* | +<!-- { "blockType": "permissions", "name": "timecard_clockin" } --> ->\* **Important:** When you use application permissions, you must include the `MS-APP-ACTS-AS` header in the request. +> [!IMPORTANT] +> When you use the Schedule.ReadWrite.All application permission, you must include the `MS-APP-ACTS-AS` header in the request. ## HTTP request |
v1.0 | Timecard Clockout | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/timecard-clockout.md | Clock out to end an open [timeCard](../resources/timeCard.md). ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Schedule.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.ReadWrite.All* | +<!-- { "blockType": "permissions", "name": "timecard_clockout" } --> ->\* **Important:** When you use application permissions, you must include the `MS-APP-ACTS-AS` header in the request. +> [!IMPORTANT] +> When you use the Schedule.ReadWrite.All application permission, you must include the `MS-APP-ACTS-AS` header in the request. ## HTTP request |
v1.0 | Timecard Confirm | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/timecard-confirm.md | Confirm a specific [timeCard](../resources/timecard.md). ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Schedule.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.ReadWrite.All* | +<!-- { "blockType": "permissions", "name": "timecard_confirm" } --> ->\* **Important:** When you use application permissions, you must include the `MS-APP-ACTS-AS` header in the request. +> [!IMPORTANT] +> When you use the Schedule.ReadWrite.All application permission, you must include the `MS-APP-ACTS-AS` header in the request. ## HTTP request |
v1.0 | Timecard Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/timecard-delete.md | Delete a [timeCard](../resources/timecard.md) instance in a [schedule](../resour ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Schedule.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.ReadWrite.All* | +<!-- { "blockType": "permissions", "name": "timecard_delete" } --> ->\* **Important:** When you use application permissions, you must include the `MS-APP-ACTS-AS` header in the request. +> [!IMPORTANT] +> When you use the Schedule.ReadWrite.All application permission, you must include the `MS-APP-ACTS-AS` header in the request. ## HTTP request |
v1.0 | Timecard Endbreak | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/timecard-endbreak.md | End the open break in a specific [timeCard](../resources/timeCard.md). ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Schedule.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.ReadWrite.All* | +<!-- { "blockType": "permissions", "name": "timecard_endbreak" } --> ->\* **Important:** When you use application permissions, you must include the `MS-APP-ACTS-AS` header in the request. +> [!IMPORTANT] +> When you use the Schedule.ReadWrite.All application permission, you must include the `MS-APP-ACTS-AS` header in the request. ## HTTP request |
v1.0 | Timecard Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/timecard-get.md | Get the properties and relationships of a [timeCard](../resources/timecard.md) o ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Schedule.Read.All, Schedule.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.Read.All*, Schedule.ReadWrite.All* | +<!-- { "blockType": "permissions", "name": "timecard_get" } --> ->\* **Important:** When you use application permissions, you must include the `MS-APP-ACTS-AS` header in the request. +> [!IMPORTANT] +> When you use the Schedule.Read.All and Schedule.ReadWrite.All application permissions, you must include the `MS-APP-ACTS-AS` header in the request. ## HTTP request GET /teams/{teamId}/schedule/timeCards/{timeCardId} ``` ## Optional query parameters-This method does not support [OData query parameters](/graph/query-parameters) to customize the response. +This method doesn't support [OData query parameters](/graph/query-parameters) to customize the response. ## Request headers |
v1.0 | Timecard List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/timecard-list.md | Retrieve a list of [timeCard](../resources/timecard.md) entries in a [schedule]( ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Schedule.Read.All, Schedule.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.Read.All*, Schedule.ReadWrite.All* | +<!-- { "blockType": "permissions", "name": "timecard_list" } --> ->\* **Important:** When you use application permissions, you must include the `MS-APP-ACTS-AS` header in the request. +> [!IMPORTANT] +> When you use the Schedule.Read.All and Schedule.ReadWrite.All application permissions, you must include the `MS-APP-ACTS-AS` header in the request. ## HTTP request |
v1.0 | Timecard Post | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/timecard-post.md | Create a [timeCard](../resources/timecard.md) instance in a [schedule](../resour ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Schedule.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.ReadWrite.All* | +<!-- { "blockType": "permissions", "name": "timecard_post" } --> ->\* **Important:** When you use application permissions, you must include the `MS-APP-ACTS-AS` header in the request. +> [!IMPORTANT] +> When you use the Schedule.ReadWrite.All application permission, you must include the `MS-APP-ACTS-AS` header in the request. ## HTTP request |
v1.0 | Timecard Replace | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/timecard-replace.md | Replace an existing [timeCard](../resources/timecard.md) with updated values. ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Schedule.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.ReadWrite.All* | +<!-- { "blockType": "permissions", "name": "timecard_replace" } --> ->\* **Important:** When you use application permissions, you must include the `MS-APP-ACTS-AS` header in the request. +> [!IMPORTANT] +> When you use the Schedule.ReadWrite.All application permission, you must include the `MS-APP-ACTS-AS` header in the request. ## HTTP request |
v1.0 | Timecard Startbreak | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/timecard-startbreak.md | Start a break in a specific [timeCard](../resources/timeCard.md). ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Schedule.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.ReadWrite.All* | +<!-- { "blockType": "permissions", "name": "timecard_startbreak" } --> ->\* **Important:** When you use application permissions, you must include the `MS-APP-ACTS-AS` header in the request. +> [!IMPORTANT] +> When you use Schedule.ReadWrite.All application permission, you must include the `MS-APP-ACTS-AS` header in the request. ## HTTP request |
v1.0 | Timeoff Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/timeoff-delete.md | Delete a [timeOff](../resources/timeoff.md) instance from a [schedule](../resour ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Group.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.ReadWrite.All* | +This API supports admin permissions. Global admins can access groups that they aren't a member of. ->\* **Important:** Application permissions are currently in private preview only and are not available for public use. +<!-- { "blockType": "permissions", "name": "timeoff_delete" } --> -> **Note**: This API supports admin permissions. Global admins can access groups that they are not a member of. +> [!NOTE] +> The Schedule.ReadWrite.All application permission is currently in private preview only and isn't available for public use. ## HTTP request |
v1.0 | Timeoff Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/timeoff-get.md | Retrieve the properties and relationships of a [timeOff](../resources/timeoff.md ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Group.Read.All, Group.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.Read.All*, Schedule.ReadWrite.All* | +This API supports admin permissions. Global admins can access groups that they aren't a member of. ->\* **Important:** Application permissions are currently in private preview only and are not available for public use. +<!-- { "blockType": "permissions", "name": "timeoff_get" } --> -> **Note**: This API supports admin permissions. Global admins can access groups that they are not a member of. +> [!NOTE] +> The Schedule.Read.All and Schedule.ReadWrite.All application permissions are currently in private preview only and aren't available for public use. ## HTTP request GET /teams/{teamId}/schedule/timesOff/{timeOffId} ## Optional query parameters -This method does not support OData query parameters to customize the response. +This method doesn't support OData query parameters to customize the response. ## Request headers |
v1.0 | Timeoff Put | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/timeoff-put.md | If the specified [timeOff](../resources/timeoff.md) doesn't exist, this method r ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Group.Read.All, Group.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.ReadWrite.All* | +This API supports admin permissions. Global admins can access groups that they aren't a member of. ->\* **Important:** Application permissions are currently in private preview only and are not available for public use. +<!-- { "blockType": "permissions", "name": "timeoff_put" } --> -> **Note**: This API supports admin permissions. Global admins can access groups that they are not a member of. +> [!NOTE] +> The Schedule.ReadWrite.All application permission is currently in private preview only and isn't available for public use. ## HTTP request |
v1.0 | Timeoffreason Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/timeoffreason-delete.md | Namespace: microsoft.graph Mark a [timeOffReason](../resources/timeoffreason.md) as inactive by setting the **isActive** property. Every team must include at least one **timeOffReason**. -This method does not remove the specified **timeOffReason** instance. [timeOffItem](../resources/timeoffitem.md) instances that have been assigned this reason remain assigned to this reason. +This method doesn't remove the specified **timeOffReason** instance. [timeOffItem](../resources/timeoffitem.md) instances that were assigned this reason remain assigned to this reason. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Group.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.ReadWrite.All* | +This API supports admin permissions. Global admins can access groups that they aren't a member of. ->\* **Important:** Application permissions are currently in private preview only and are not available for public use. +<!-- { "blockType": "permissions", "name": "timeoffreason_delete" } --> -> **Note**: This API supports admin permissions. Global admins can access groups that they are not a member of. +> [!NOTE] +> The Schedule.ReadWrite.All application permission is currently in private preview only and isn't available for public use. ## HTTP request |
v1.0 | Timeoffreason Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/timeoffreason-get.md | Retrieve the properties and relationships of a [timeOffReason](../resources/time ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Group.Read.All, Group.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.Read.All*, Schedule.ReadWrite.All* | +This API supports admin permissions. Global admins can access groups that they aren't a member of. ->\* **Important:** Application permissions are currently in private preview only and are not available for public use. +<!-- { "blockType": "permissions", "name": "timeoffreason_get" } --> -> **Note**: This API supports admin permissions. Global admins can access groups that they are not a member of. +> [!NOTE] +> The Schedule.Read.All and Schedule.ReadWrite.All application permissions are currently in private preview only and aren't available for public use. ## HTTP request GET /teams/{teamId}/schedule/timeOffReasons/{timeOffReasonId} ## Optional query parameters -This method does not support OData query parameters to customize the response. +This method doesn't support OData query parameters to customize the response. ## Request headers |
v1.0 | Timeoffreason Put | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/timeoffreason-put.md | If the specified [timeOffReason](../resources/timeoffreason.md) doesn't exist, t ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Group.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.ReadWrite.All* | +This API supports admin permissions. Global admins can access groups that they aren't a member of. ->\* **Important:** Application permissions are currently in private preview only and are not available for public use. +<!-- { "blockType": "permissions", "name": "timeoffreason_put" } --> -> **Note**: This API supports admin permissions. Global admins can access groups that they are not a member of. +> [!NOTE] +> The Schedule.ReadWrite.All application permission is currently in private preview only and isn't available for public use. ## HTTP request |
v1.0 | Timeoffrequest Approve | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/timeoffrequest-approve.md | Approve a [timeoffrequest](../resources/timeoffrequest.md). ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -| Permission type | Permissions (from least to most privileged) | -|:|:--| -| Delegated (work or school account) | Group.ReadWrite.All | -| Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.ReadWrite.All* | +<!-- { "blockType": "permissions", "name": "timeoffrequest_approve" } --> ->\* **Important:** Application permissions are currently in private preview only and are not available for public use. +> [!NOTE] +> The Schedule.ReadWrite.All application permission is currently in private preview only and isn't available for public use. ## HTTP request In the request body, provide a JSON object with the following parameters. If successful, this method returns a `200, OK` response code. It doesn't return anything in the response body. -## Examples --The following is an example of how to call this API. +## Example ### Request |
v1.0 | Timeoffrequest Decline | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/timeoffrequest-decline.md | Decline a [timeoffrequest](../resources/timeoffrequest.md) object. ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -| Permission type | Permissions (from least to most privileged) | -|:|:--| -| Delegated (work or school account) | Group.ReadWrite.All | -| Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.ReadWrite.All* | +<!-- { "blockType": "permissions", "name": "timeoffrequest_decline" } --> ->\* **Important:** Application permissions are currently in private preview only and are not available for public use. +> [!NOTE] +> The Schedule.ReadWrite.All application permission is currently in private preview only and isn't available for public use. ## HTTP request In the request body, provide a JSON object with the following parameters. If successful, this method returns a `200 OK` response code. It doesn't return anything in the response body. -## Examples --The following is an example of how to call this API. +## Example ### Request |
v1.0 | Timeoffrequest Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/timeoffrequest-delete.md | Delete a [timeOffRequest](../resources/timeoffrequest.md) object. ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -| Permission type | Permissions (from least to most privileged) | -|:|:--| -| Delegated (work or school account) | Group.ReadWrite.All | -| Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.ReadWrite.All* | +<!-- { "blockType": "permissions", "name": "timeoffrequest_delete" } --> ->\* **Important:** Application permissions are currently in private preview only and are not available for public use. +> [!NOTE] +> The Schedule.ReadWrite.All application permission is currently in private preview only and isn't available for public use. ## HTTP request |
v1.0 | Timeoffrequest Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/timeoffrequest-get.md | Retrieve the properties and relationships of a [timeoffrequest](../resources/tim ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -| Permission type | Permissions (from least to most privileged) | -|:|:--| -| Delegated (work or school account) | Group.Read.All, Group.ReadWrite.All | -| Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.Read.All*, Schedule.ReadWrite.All* | +<!-- { "blockType": "permissions", "name": "timeoffrequest_get" } --> ->\* **Important:** Application permissions are currently in private preview only and are not available for public use. +> [!NOTE] +> The Schedule.Read.All and Schedule.ReadWrite.All application permissions are currently in private preview only and aren't available for public use. ## HTTP request GET /teams/{teamId}/schedule/timeOffRequests/{timeOffRequestId} ## Optional query parameters -This method does not support OData query parameters to customize the response. +This method doesn't support OData query parameters to customize the response. ## Request headers |
v1.0 | Timeoffrequest List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/timeoffrequest-list.md | Retrieve a list of [timeoffrequest](../resources/timeoffrequest.md) objects in t ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -| Permission type | Permissions (from least to most privileged) | -|:|:--| -|Delegated (work or school account) | Schedule.Read.All, Group.Read.All, Schedule.ReadWrite.All, Group.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Schedule.Read.All*, Schedule.ReadWrite.All* | +This API supports admin permissions. Global admins can access groups that they aren't a member of. ->\* **Important:** Application permissions are currently in private preview only and are not available for public use. +<!-- { "blockType": "permissions", "name": "timeoffrequest_list" } --> -> **Note**: This API supports admin permissions. Global admins can access groups that they are not a member of. +> [!NOTE] +> The Schedule.Read.All and Schedule.ReadWrite.All application permissions are currently in private preview only and aren't available for public use. ## HTTP request |
v1.0 | Training Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/training-get.md | GET /security/attackSimulation/trainings/{trainingId} ## Optional query parameters -This method does not currently support the [OData query parameters](/graph/query-parameters) to customize the response. +This method doesn't currently support [OData query parameters](/graph/query-parameters) to customize the response. ## Request headers Content-Type: application/json "email": "yibsu", "id": null, "displayName": null- } + }, + "customUrl" : null } ``` |
v1.0 | Trainingcampaign Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/trainingcampaign-get.md | + + Title: "Get trainingCampaign" +description: "Read the properties and relationships of a trainingCampaign object." ++ms.localizationpriority: medium +++# Get trainingCampaign ++Namespace: microsoft.graph +++Read the properties and relationships of a [trainingCampaign](../resources/trainingcampaign.md) object. +++## 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": "trainingcampaign_get" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/attackSimulation/trainingCampaigns/{trainingCampaignId} +``` ++## 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 [trainingCampaign](../resources/trainingcampaign.md) object in the response body. ++## Examples ++### Example 1: Get a training campaign ++The following example shows how to get an attack simulation campaign for a tenant. ++#### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name" : "get_trainingcampaign" +}--> ++``` http +GET https://graph.microsoft.com/beta/security/attackSimulation/trainingCampaigns/f1b13829-3829-f1b1-2938-b1f12938b1a +``` ++# [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. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.trainingCampaign", + "name" : "get_trainingcampaign" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "id": "81c59451-2929-5b39-86f0-5a2b15f1314f", + "displayName": "graph toc update 2", + "description": "Graph Test", + "createdDateTime": "2024-02-18T08:36:07.6534871Z", + "lastModifiedDateTime": "2024-02-19T08:00:01.9417887Z", + "endUserNotificationSetting": null, + "includedAccountTarget": null, + "excludedAccountTarget": null, + "trainingSetting": null, + "report": null, + "campaignSchedule": { + "launchDateTime": "2024-02-18T08:37:44Z", + "completionDateTime": "2024-02-19T07:59:44Z", + "status": "completed" + }, + "createdBy": { + "email": "attacksim@a830edad9050849EQTPWBJZXODQ.onmicrosoft.com", + "id": "478a22cd-aecc-41df-b995-88c8de17aaf5", + "displayName": "attacksim" + }, + "lastModifiedBy": { + "email": "attacksim@a830edad9050849EQTPWBJZXODQ.onmicrosoft.com", + "id": "478a22cd-aecc-41df-b995-88c8de17aaf5", + "displayName": "attacksim" + } +} +``` ++### Example 2: Get included account targets ++The following example shows how to get included account targets (users) for a Training campaign for a tenant. ++#### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name" : "get_trainingcampaign_includedtargets" +} +--> +``` http +GET https://graph.microsoft.com/beta/security/attackSimulation/trainingCampaigns/f1b13829-3829-f1b1-2938-b1f12938b1a/includedAccountTarget +``` ++# [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. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.accountTargetContent", + "name" : "get_trainingcampaign_includedtargets" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.addressBookAccountTargetContent", + "type": "addressBook", + "accountTargetEmails": [ + "john@contoso.com" + ] +} +``` ++### Example 3: Get excluded account targets ++The following example shows how to get the excluded account targets (users) for a Training campaign for a tenant. ++#### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name" : "get_trainingcampaign_excludedtargets" +} +--> +``` http +GET https://graph.microsoft.com/beta/security/attackSimulation/trainingCampaigns/f1b13829-3829-f1b1-2938-b1f12938b1a/excludedAccountTarget +``` ++# [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. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.accountTargetContent", + "name" : "get_trainingcampaign_excludedtargets" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.addressBookAccountTargetContent", + "type": "addressBook", + "accountTargetEmails": [ + "alie@contoso.com" + ] +} +``` ++### Example 4: Get training setting ++The following example shows how to get training setting details for a training campaign. ++#### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name" : "get_trainingcampaign_training" +} +--> ++``` http +GET https://graph.microsoft.com/beta/security/attackSimulation/trainingCampaigns/f1b13829-3829-f1b1-2938-b1f12938b1a/trainingSetting +``` ++# [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. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.trainingSetting", + "name" : "get_trainingcampaign_training" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "trainingCompletionDuration": "0", + "completionDateTime": "2024-02-19T07:59:44Z", + "settingType": "microsoftManaged" +} +``` ++### Example 5: Get end user notification setting ++The following example shows how to get end user notification setting details for a training campaign. ++#### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name" : "get_trainingcampaign_eun" +} +--> +``` http +GET https://graph.microsoft.com/beta/security/attackSimulation/trainingCampaigns/f1b13829-3829-f1b1-2938-b1f12938b1a/endUserNotificationSetting +``` ++# [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. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.endUserNotificationSetting", + "name" : "get_trainingcampaign_eun" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "settingType": "trainingSelected", + "positiveReinforcement": null, + "notificationPreference": "microsoft", + "trainingAssignment" : { + "deliveryFrequency": "unknown", + "defaultLanguage": "en", + "endUserNotification": { + "id": "36fb4dc1-7c37-4b96-9096-12e6d6014fae", + "displayName": "Microsoft default training only campaign-training assignment notification" + } + }, + "trainingReminder" : { + "deliveryFrequency": "weekly", + "defaultLanguage": "en", + "endUserNotification": { + "id": "fe521249-9901-4584-a987-026a9980c58e", + "displayName": "Microsoft default training only campaign-training reminder notification" + } + } +} +``` |
v1.0 | Trainingcampaign Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/trainingcampaign-update.md | + + Title: "Update trainingCampaign" +description: "Update the properties of a trainingCampaign object." ++ms.localizationpriority: medium +++# Update trainingCampaign ++Namespace: microsoft.graph +++Update the properties of a [trainingCampaign](../resources/trainingcampaign.md) object. +++## 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": "trainingcampaign_update" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /security/attackSimulation/trainingCampaigns/{trainingCampaignId} +``` ++## 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 +++|Property|Type|Description| +|:|:|:| +|createdBy|[emailIdentity](../resources/emailidentity.md)|The identity of the user who created the training campaign. Optional.| +|createdDateTime|DateTimeOffset|The date and time of creation of the training campaign. Optional.| +|description|String|The description of the training campaign. Optional.| +|displayName|String|The display name of the training campaign. Required.| +|endUserNotificationSetting|[endUserNotificationSetting](../resources/endusernotificationsetting.md)|Details about the end user notification setting. Required.| +|excludedAccountTarget|[accountTargetContent](../resources/accounttargetcontent.md)|The users who are excluded from the training campaign. Optional.| +|includedAccountTarget|[accountTargetContent](../resources/accounttargetcontent.md)|The users who are targeted in the training campaign. Required.| +|lastModifiedDateTime|DateTimeOffset|The identity of the user who most recently modified the training campaign. Optional.| +|trainingSetting|[trainingSetting](../resources/trainingsetting.md)|Details about the training settings for a training campaign. Required.| +|campaignSchedule|[campaignSchedule](../resources/campaignschedule.md)|Details about the schedule and current status for a training campaign. Required.| ++## Response ++If successful, this method returns a `202 Accepted` response code and a tracking header named `location` in the response. ++## Example ++The following example shows how to update the status of the training campaign. In this case, a scheduled training campaign is canceled. ++### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_trainingcampaign" +} +--> +``` http +PATCH https://graph.microsoft.com/beta/security/attackSimulation/trainingCampaigns/{trainingCampaignId} +Content-Type: application/json ++{ + "displayName": "Graph Training Campaign", + "description": "Graph Training Campaign Description", + "createdBy": { + "email": "john@contoso.com" + }, + "lastModifiedBy": { + "email": "john@contoso.com" + }, + "includedAccountTarget": { + "type": "addressBook", + "accountTargetEmails": [ + "john@contoso.com" + ] + }, + "endUserNotificationSetting": { + "notificationPreference": "microsoft", + "settingType": "trainingSelected", + "trainingReminder": { + "deliveryFrequency": "weekly", + "endUserNotification@odata.bind": "https://graph.microsoft.com/beta/security/attackSimulation/endUserNotifications('fe521249-9901-4584-a987-026a9980c58e')", + "defaultLanguage": "en" + }, + "trainingAssignment": { + "endUserNotification@odata.bind": "https://graph.microsoft.com/beta/security/attackSimulation/endUserNotifications('36fb4dc1-7c37-4b96-9096-12e6d6014fae')", + "defaultLanguage": "en" + } + }, + "trainingSetting": { + "settingType": "microsoftCustom", + "trainingAssignmentMappings": [ + { + "assignedTo": [ + "allUsers" + ], + "training@odata.bind": "https://graph.microsoft.com/beta/security/attackSimulation/trainings('40454905-dc26-4f36-b854-3042a5362cb3')" + }, + { + "assignedTo": [ + "allUsers" + ], + "training@odata.bind": "https://graph.microsoft.com/beta/security/attackSimulation/trainings('ea70ae06-3859-4818-be9d-270ee81d80a4')" + }, + { + "assignedTo": [ + "allUsers" + ], + "training@odata.bind": "https://graph.microsoft.com/beta/security/attackSimulation/trainings('d733d88c-1b5a-48e3-a588-9910e41ac21d')" + } + ] + }, + "campaignSchedule": { + "launchDateTime": "2024-02-15T07:59:44Z", + "completionDateTime": "2024-02-18T07:59:44Z", + "status": "Cancelled" + } +} +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) ++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true +} +--> ++```http +HTTP/1.1 202 Accepted +``` + |
v1.0 | Trainingcampaignreportoverview Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/trainingcampaignreportoverview-get.md | + + Title: "Get trainingCampaignReportOverview" +description: "Get an overview of a training campaign." ++ms.localizationpriority: medium +++# Get trainingCampaignReportOverview +Namespace: microsoft.graph +++Get an overview of a training campaign. ++## 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": "trainingcampaignreportoverview_get" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/attackSimulation/trainingCampaigns/{trainingCampaignId}/report/overview +``` ++## 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 [trainingCampaignReportOverview](../resources/trainingcampaignreportoverview.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. +<!-- { + "blockType": "request" +} +--> +``` http +GET https://graph.microsoft.com/beta/security/attackSimulation/trainingCampaigns/f1b13829-3829-f1b1-2938-b1f12938b1a/report/overview +``` ++++### 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.trainingCampaignReportOverview" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "trainingModuleCompletion": { + "trainingsAssignedUserCount": 1, + "assignedTrainingsInfos": [ + { + "assignedUserCount": 1, + "completedUserCount": 0, + "displayName": "Identity Theft" + }, + { + "assignedUserCount": 1, + "completedUserCount": 0, + "displayName": "Introduction to Information Security" + }, + { + "assignedUserCount": 1, + "completedUserCount": 0, + "displayName": "Malware" + } + ] + }, + "userCompletionStatus": { + "notStartedUsersCount": 0, + "completedUsersCount": 0, + "inProgressUsersCount": 1, + "notCompletedUsersCount": 0, + "previouslyAssignedUsersCount": 0 + }, + "trainingNotificationDeliveryStatus": { + "resolvedTargetsCount": 1, + "successfulMessageDeliveryCount": 1, + "failedMessageDeliveryCount": 0 + } +} +``` + |
v1.0 | Trustframework List Trustframeworkpolicies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/trustframework-list-trustframeworkpolicies.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "trustframework_list_trustframeworkpolicies" } --> [!INCLUDE [permissions-table](../includes/permissions/trustframework-list-trustframeworkpolicies-permissions.md)] -The work or school account must be a global administrator of the tenant. +The work or school account must have at least the *B2C IEF Keyset Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request |
v1.0 | Trustframework Post Trustframeworkpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/trustframework-post-trustframeworkpolicy.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "trustframework_post_trustframeworkpolicy" } --> [!INCLUDE [permissions-table](../includes/permissions/trustframework-post-trustframeworkpolicy-permissions.md)] -The work or school account must be a global administrator of the tenant. +The work or school account must have at least the *B2C IEF Keyset Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request |
v1.0 | Trustframework Put Trustframeworkpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/trustframework-put-trustframeworkpolicy.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "trustframework_put_trustframeworkpolicy" } --> [!INCLUDE [permissions-table](../includes/permissions/trustframework-put-trustframeworkpolicy-permissions.md)] -The work or school account must be a global administrator of the tenant. +The work or school account must have at least the *B2C IEF Keyset Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request HTTP/1.1 200 OK Content-Type: application/xml <TrustFrameworkPolicy xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/online/cpim/schemas/2013/06" PolicySchemaVersion="0.3.0.0" TenantId="contoso.com" PolicyId="B2C_1A_Test" PublicPolicyUri="http://contoso.com/B2C_1A_Test">- ..... - .... - <!PolicyContent--> - .... - .... + ..... + .... + <!PolicyContent--> + .... + .... </TrustFrameworkPolicy> ``` |
v1.0 | Trustframeworkkey_V2 Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/trustframeworkkey_v2-get.md | + + Title: "Get trustFrameworkKey_v2" +description: "Read the properties and relationships of a trustFrameworkKey_v2 object." ++ms.localizationpriority: medium ++++# Get trustFrameworkKey_v2 ++Namespace: microsoft.graph +++Read the properties and relationships of a [trustFrameworkKey_v2](../resources/trustframeworkkey_v2.md) object. ++## 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": "trustframeworkkey_v2-get-permissions" +} +--> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /trustFramework/keySets/{trustFrameworkKeySetId}/keys_v2/{trustFrameworkKey_v2Id} +``` ++## 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 [trustFrameworkKey_v2](../resources/trustframeworkkey_v2.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_trustframeworkkey_v2" +} +--> +``` http +GET https://graph.microsoft.com/beta/trustFramework/keySets/{trustFrameworkKeySetId}/keys_v2/{aTREvwojOB9ph3fr2r6eTf_5eD5fmQsfsapVMwYI3o} +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) +++++### 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.trustFrameworkKey_v2" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": { + "@odata.type": "#microsoft.graph.trustFrameworkKey_v2", + "k": "AQHF", + "x5c": [ + "MIICDTCCAXagAwIBAgIQAkiG9w0zWT5PduVXKynAjHTATBgNVHSUEDDAKBggrBgEFBQcDATANBgkqhkiG9w.." + ], + "x5t": "kr03PNLOFr9InfdsfbIyoC4KCKS8", + "kty": "oct", + "use": "sig", + "status": "enabled", + "exp": "1712952360", + "nbf": "1712952300", + "kid": "aTREvwojOB9ph3fr2r6eTf_5eD5fmQsfsapVMwYI3o", + "e": "AQHF", + "n": "oNuJk44jzFgZ9R26gfdgfgtR_9Btg8vRKh3Y0", + } +} ++``` |
v1.0 | Trustframeworkkey_V2 Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/trustframeworkkey_v2-update.md | + + Title: "Update trustFrameworkKey_v2" +description: "Update the properties of a trustFrameworkKey_v2 object." ++ms.localizationpriority: medium ++++# Update trustFrameworkKey_v2 ++Namespace: microsoft.graph +++Update the properties of a [trustFrameworkKey_v2](../resources/trustframeworkkey_v2.md) object. Only Status Property is allowed to update from this request. ++## 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": "trustframeworkkey_v2-update-permissions" +} +--> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /trustFramework/keySets/{trustFrameworkKeySetId}/keys_v2/{trustFrameworkKey_v2Id} +``` ++## Request headers ++|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ++## Request body +++|Property|Type|Description| +|:|:|:| +|status|trustFrameworkKeyStatus|Status of the key. The possible values are: `enabled`, `disabled`, `unknownFutureValue`. Optional.| ++## Response ++If successful, this method returns a `204 No Content` response code and an updated [trustFrameworkKey_v2](../resources/trustframeworkkey_v2.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_trustframeworkkey_v2" +} +--> +``` http +PATCH https://graph.microsoft.com/beta/trustFramework/keySets/{trustFrameworkKeySetId}/keys_v2/aTREvwojOB9ph3fr2r6eTf_5eD5fmQsfsapVMwYI3o +Content-Type: application/json ++{ + "status": "enabled" +} +``` ++# [JavaScript](#tab/javascript) +++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` |
v1.0 | Trustframeworkpolicy Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/trustframeworkpolicy-delete.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "trustframeworkpolicy_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/trustframeworkpolicy-delete-permissions.md)] -The work or school account must be a global administrator of the tenant. +The work or school account must have at least the *B2C IEF Keyset Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request |
v1.0 | Trustframeworkpolicy Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/trustframeworkpolicy-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "trustframeworkpolicy_get" } --> [!INCLUDE [permissions-table](../includes/permissions/trustframeworkpolicy-get-permissions.md)] -The work or school account must be a global administrator of the tenant. +The work or school account must have at least the *B2C IEF Keyset Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request HTTP/1.1 200 OK Content-Type: application/xml <TrustFrameworkPolicy xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/online/cpim/schemas/2013/06" PolicySchemaVersion="0.3.0.0" TenantId="contoso.com" PolicyId="B2C_1A_Test" PublicPolicyUri="http://contoso.com/B2C_1A_Test">- ..... - .... - <!PolicyContent--> - .... - .... + ..... + .... + <!PolicyContent--> + .... + .... </TrustFrameworkPolicy> ``` |
v1.0 | Unenforcedmfaawsuserfinding Aggregatedsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/unenforcedmfaawsuserfinding-aggregatedsummary.md | description: View the count of AWS users with unenforced MFA in your authorizati ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Unenforcedmfaawsuserfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/unenforcedmfaawsuserfinding-get.md | description: "Read the properties and relationships of an unenforcedMfaAwsUserFi ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Unenforcedmfaawsuserfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/unenforcedmfaawsuserfinding-list.md | description: "Get a list of the unenforcedMfaAwsUserFinding objects and their pr ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Unifiedstoragequota Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/unifiedstoragequota-get.md | Namespace: microsoft.graph Read the properties and relationships of a [unifiedStorageQuota](../resources/unifiedstoragequota.md) object. + ## 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). If successful, this method returns a `200 OK` response code and a [unifiedStorag ### Example 1: Get the unified quota information for the current user #### Request Here's an example of a request.+# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_unifiedstoragequota" Here's an example of a request. GET https://graph.microsoft.com/beta/me/settings/storage/quota ``` +# [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 Here's an example of the response Content-Type: application/json ### Example 2: Get the unified quota information for the current user #### Request Here's an example of a request.+# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_unifiedstoragequotabyuserid", Here's an example of a request. GET https://graph.microsoft.com/beta/users/1234BBS1121YY95/settings/storage/quota ``` +# [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 Here's an example of the response Content-Type: application/json ### Example 3: Get the unified quota information, along with the service breakdowns, for the current user #### Request Here's an example of a request.+# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_unifiedstoragequotaandservices" Here's an example of a request. GET https://graph.microsoft.com/beta/me/settings/storage/quota?$expand=services ``` +# [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 Here's an example of the response |
v1.0 | Unifiedstoragequota List Services | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/unifiedstoragequota-list-services.md | Namespace: microsoft.graph Get a list of [serviceStorageQuotaBreakdown](../resources/servicestoragequotabreakdown.md) objects and their properties. + ## 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). If successful, this method returns a `200 OK` response code and a collection of ### Request Here's an example of a request.+# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "list_servicestoragequotabreakdown" Here's an example of a request. GET https://graph.microsoft.com/beta/me/settings/storage/quota/services ``` +# [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 Here's an example of the response |
v1.0 | User Assignlicense | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-assignlicense.md | Title: "user: assignLicense" description: "Add or remove licenses for the user to enable or disable their use of Microsoft cloud offerings. " ms.localizationpriority: medium + doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "user_assignlicense" } --> [!INCLUDE [permissions-table](../includes/permissions/user-assignlicense-permissions.md)] -For delegated scenarios, the calling user needs one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). +For delegated scenarios, the calling user needs at least one of the following [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). - Directory Writers - License Administrator - User Administrator-- Global Administrator ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | User Changepassword | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-changepassword.md | description: "Update your own password." ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | User Convertexternaltointernalmemberuser | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-convertexternaltointernalmemberuser.md | description: "Convert an external user to an internal member." ms.localizationpriority: medium+ doc_type: apiPageType Namespace: microsoft.graph Convert an externally authenticated user into an internal user. The user is able to sign into the host tenant as an internal user and access resources as a member. For more information about this conversion, see [Convert external users to internal users](/entra/identity/users/convert-external-users-internal). + ## 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). Content-type: application/json [!INCLUDE [sample-code](../includes/snippets/php/userthisconvertexternaltointernalmemberuser-cloudonly-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/userthisconvertexternaltointernalmemberuser-cloudonly-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] Content-type: application/json [!INCLUDE [sample-code](../includes/snippets/php/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] POST https://graph.microsoft.com/beta/users/0b8cc234-ef87-4015-9785-cbb42000d41c [!INCLUDE [sample-code](../includes/snippets/php/userthisconvertexternaltointernalmemberuser-synceduser-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/userthisconvertexternaltointernalmemberuser-synceduser-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | User Delete Approleassignments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-delete-approleassignments.md | Title: "Delete appRoleAssignment" description: "Delete an appRoleAssignment that has been granted to a user." ms.localizationpriority: medium doc_type: apiPageType+ |
v1.0 | User Delete Manager | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-delete-manager.md | description: "Remove a user's manager." ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | User Delete Sponsors | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-delete-sponsors.md | Title: "Remove sponsor" description: "Remove a user's sponsor." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | User Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-delete.md | description: "Describes the delete method of the user resource (entity) of the M ms.localizationpriority: medium+ doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "ignored", "name": "user_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/user-delete-permissions.md)] -The calling user must be assigned one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): +The calling user must be assigned at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): - User Administrator - Privileged Authentication Administrator-- Global Administrator To delete users with privileged administrator roles in delegated scenarios, the app must be assigned the *Directory.AccessAsUser.All* delegated permission, and the calling user must have a higher privileged administrator role as indicated in [Who can perform sensitive actions](../resources/users.md#who-can-perform-sensitive-actions). |
v1.0 | User Deletepasswordsinglesignoncredentials | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-deletepasswordsinglesignoncredentials.md | Title: "user: deletePasswordSingleSignOnCredentials" description: "Delete password-based single sign-on credentials for a service principal that is associated to a user." ms.localizationpriority: medium+ doc_type: apiPageType Namespace: microsoft.graph Delete the password-based single sign-on credentials for a given user to a given service principal. ## Permissions |
v1.0 | User Delta | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-delta.md | description: "Get newly created, updated, or deleted users without having to per ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | User Exportpersonaldata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-exportpersonaldata.md | description: "Submits a data policy operation request, made by a Company Adminis ms.localizationpriority: medium + doc_type: apiPageType doc_type: apiPageType Namespace: microsoft.graph -Submit a data policy operation request from a company administrator or an application to export an organizational user's data. This data includes the user's data stored in OneDrive and their activity reports. For more guidance about exporting data while complying with regulations, see [Data Subject Requests and the GDPR and CCPA](/compliance/regulatory/gdpr-data-subject-requests). +Submit a data policy operation request from a company administrator or an application to export an organizational user's data. This data includes the user's data stored in OneDrive and their activity reports. For more information about exporting data while complying with regulations, see [Data Subject Requests and the GDPR and CCPA](/compliance/regulatory/gdpr-data-subject-requests). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] POST /users/{id}/exportPersonalData ## Request body In the request body, provide a JSON object with the following parameters. -| Parameter | Type |Description | +| Parameter | Type |Description | |:|:--|:-| |storageLocation|String|This is a shared access signature (SAS) URL to an Azure Storage account, to where data should be exported.| |
v1.0 | User Get Transitivereports | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-get-transitivereports.md | description: "Get the count of transitive reports for a user." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | User Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-get.md | description: "Retrieve the properties and relationships of user object." ms.localizationpriority: high+ doc_type: apiPageType |
v1.0 | User Getpasswordsinglesignoncredentials | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-getpasswordsinglesignoncredentials.md | Title: "user: getPasswordSingleSignOnCredentials" description: "Get the list of password-based single sign-on credentials for a given user. This API returns the encrypted passwords as null or empty strings." ms.localizationpriority: medium+ doc_type: apiPageType Namespace: microsoft.graph Get the list of password-based single sign-on credentials for a given user. This API returns the encrypted passwords as null or empty strings. ## Permissions |
v1.0 | User Invalidateallrefreshtokens | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-invalidateallrefreshtokens.md | description: "Invalidates all of the user's refresh tokens issued to application ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | User List Agreementacceptances | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-agreementacceptances.md | Title: "List agreementAcceptances" description: "Retrieve a list of a user's agreementAcceptance objects." ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | User List Approleassignedresources | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-approleassignedresources.md | Title: "List appRoleAssignedResources" description: "Get the service principals to which the user has an app role assignment either directly or through group membership." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | User List Approleassignments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-approleassignments.md | Title: "List appRoleAssignments granted to a user" description: "Retrieve the list of app role assignments granted to a user." ms.localizationpriority: high doc_type: apiPageType+ |
v1.0 | User List Createdobjects | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-createdobjects.md | description: "Get a list of directory objects that were created by the user." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | User List Devices | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-devices.md | description: "Get a list of user devices that support Project Rome capabilities. ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | User List Directreports | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-directreports.md | description: "Get a user's direct reports." ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | User List Joinedteams | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-joinedteams.md | Get the [teams](../resources/team.md) in Microsoft Teams that the user is a dire [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, User.Read.All, User.ReadWrite.All, Directory.Read.All**, Directory.ReadWrite.All** | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, User.Read.All, User.ReadWrite.All, Directory.Read.All**, Directory.ReadWrite.All** | +<!-- { "blockType": "permissions", "name": "user_list_joinedteams" } --> -> **Note:** Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> [!NOTE] +> The Directory.Read.All and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. ## HTTP request <!-- { "blockType": "ignored" } --> GET /users/{id | user-principal-name}/joinedTeams ``` ## Optional query parameters-This method does not currently support the [OData query parameters](/graph/query-parameters) to customize the response. +This method doesn't currently support the [OData query parameters](/graph/query-parameters) to customize the response. ## Request headers | Header | Value | Don't supply a request body for this method. If successful, this method returns a `200 OK` response code and a collection of [team](../resources/team.md) objects in the response body. -> [!Note] +> [!NOTE] > This API has a [known issue](https://developer.microsoft.com/en-us/graph/known-issues/?search=13633) where it returns only the **id**, **displayName**, and **description** properties of a [team](../resources/team.md).To get all properties, use the [Get team](../api/team-get.md) operation. |
v1.0 | User List Licensedetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-licensedetails.md | Title: "List licenseDetails" description: "Retrieve a list of licenseDetails objects." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | User List Manager | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-manager.md | description: "Get user's manager. Returns the user or contact assigned as the us ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | User List Memberof | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-memberof.md | description: "Get groups, directory roles, and administrative units that the use ms.localizationpriority: medium + doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [limited-info](../../includes/limited-info.md)] +> [!TIP] +> - Calling the `/me/memberOf` endpoint requires a signed-in user and therefore a delegated permission. Application permissions are not supported when you use the `/me/memberOf` endpoint. +> - To list the members of a group with hidden membership, the `Member.Read.Hidden` permission is required. + ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | User List Owneddevices | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-owneddevices.md | description: "Get the list of devices that are owned by the user." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | User List Ownedobjects | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-ownedobjects.md | description: "Get the list of directory objects that are owned by the user." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | User List Registereddevices | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-registereddevices.md | description: "Get the list of user's registered devices." ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | User List Scopedrolememberof | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-scopedrolememberof.md | description: "Retrieve a list of scopedRoleMembership for the user." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | User List Sponsors | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-sponsors.md | Title: "List sponsors" description: "Get a user's sponsors." ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | User List Transitivememberof | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-transitivememberof.md | description: "Get groups, directory roles, and administrative units that the use ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | User List Trendingaround | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-trendingaround.md | description: "Calculated insight that returns the list of items trending around ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | User List Usagerights | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-usagerights.md | Title: "List user usageRights" description: "Retrieve a list of usageRights objects for a user." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | User List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list.md | description: "Retrieve a list of user objects." ms.localizationpriority: high+ doc_type: apiPageType |
v1.0 | User Post Approleassignments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-post-approleassignments.md | Title: "Grant an appRoleAssignment to a user" description: "Grant an app role assignment to a user." ms.localizationpriority: high doc_type: apiPageType+ |
v1.0 | User Post Manager | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-post-manager.md | description: "Assign a user's manager." ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | User Post Sponsors | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-post-sponsors.md | Title: "Add sponsor" description: "Assign a user a sponsor." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | User Post Users | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-post-users.md | description: "Create a new user." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | User Reprocesslicenseassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-reprocesslicenseassignment.md | description: "Reprocess all group-based license assignments for the user." ms.localizationpriority: medium + doc_type: "apiPageType" Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "user_reprocesslicenseassignment" } --> [!INCLUDE [permissions-table](../includes/permissions/user-reprocesslicenseassignment-permissions.md)] -For delegated scenarios, the calling user needs one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). +For delegated scenarios, the calling user needs at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). - Directory Writers - License Administrator - User Administrator-- Global Administrator ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | User Retryserviceprovisioning | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-retryserviceprovisioning.md | Title: "user: retryServiceProvisioning" description: "Retries user service provisioning." ms.localizationpriority: medium + doc_type: "apiPageType" |
v1.0 | User Revokesigninsessions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-revokesigninsessions.md | description: "Invalidates all the user's refresh tokens issued to applications ( ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | User Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-update.md | description: "Update the properties of a user object." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | User Validatepassword | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-validatepassword.md | description: "Check a user's password against the organization's password valida ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Userflowlanguageconfiguration Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/userflowlanguageconfiguration-delete.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "userflowlanguageconfiguration_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/userflowlanguageconfiguration-delete-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Userflowlanguageconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/userflowlanguageconfiguration-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "userflowlanguageconfiguration_get" } --> [!INCLUDE [permissions-table](../includes/permissions/userflowlanguageconfiguration-get-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Userflowlanguageconfiguration List Defaultpages | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/userflowlanguageconfiguration-list-defaultpages.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "userflowlanguageconfiguration_list_defaultpages" } --> [!INCLUDE [permissions-table](../includes/permissions/userflowlanguageconfiguration-list-defaultpages-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Userflowlanguageconfiguration List Overridespages | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/userflowlanguageconfiguration-list-overridespages.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "userflowlanguageconfiguration_list_overridespages" } --> [!INCLUDE [permissions-table](../includes/permissions/userflowlanguageconfiguration-list-overridespages-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Userflowlanguagepage Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/userflowlanguagepage-delete.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "userflowlanguagepage_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/userflowlanguagepage-delete-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request Here's an example of the request. DELETE https://graph.microsoft.com/beta/identity/b2cUserFlows/B2C_1_Customer/languages/en/overridesPages/phonefactor/$value ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/delete-userflowlanguagepage-beta-e1-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) ++# [Python](#tab/python) + ### Response |
v1.0 | Userflowlanguagepage Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/userflowlanguagepage-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "userflowlanguagepage_get" } --> [!INCLUDE [permissions-table](../includes/permissions/userflowlanguagepage-get-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Userflowlanguagepage Put | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/userflowlanguagepage-put.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "userflowlanguagepage_put" } --> [!INCLUDE [permissions-table](../includes/permissions/userflowlanguagepage-put-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Usersettings Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/usersettings-get.md | description: "Read the user and organization settings object." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Usersettings List Windows | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/usersettings-list-windows.md | Namespace: microsoft.graph Get a list of [windowsSetting](../resources/windowssetting.md) objects and their properties for the signed in 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). GET https://graph.microsoft.com/beta/me/settings/windows [!INCLUDE [sample-code](../includes/snippets/php/list-windowssetting1-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-windowssetting1-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] GET https://graph.microsoft.com/beta/me/settings/windows?$filter=settingType eq [!INCLUDE [sample-code](../includes/snippets/php/list-windowssetting2-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-windowssetting2-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] GET https://graph.microsoft.com/beta/me/settings/windows?$filter=settingType eq [!INCLUDE [sample-code](../includes/snippets/php/list-windowssetting3-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-windowssetting3-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] GET https://graph.microsoft.com/beta/me/settings/windows?$filter=windowsDeviceId [!INCLUDE [sample-code](../includes/snippets/php/list-windowssetting4-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-windowssetting4-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Usersettings Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/usersettings-update.md | description: "Update the properties of the settings object. " ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Usertrainingcampaigndetails List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/usertrainingcampaigndetails-list.md | + + Title: "List campaign users" +description: "List users of a tenant and their online actions in a training campaign." ++ms.localizationpriority: medium +++# List trainingCampaignUsers +Namespace: microsoft.graph +++List users of a tenant and their online actions in a training campaign. ++## 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": "usertrainingcampaigndetails_list" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/attackSimulation/trainingCampaigns/{trainingCampaignId}/report/campaignUsers +``` ++## Optional query parameters ++This method supports the `$count`, `$skipToken`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. ++If the result set spans multiple pages, the response body contains an `@odata.nextLink` that you can use to page through the result set. ++The following list shows some examples of requests that use the supported OData query parameters: ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/attackSimulation/trainingCampaigns/{trainingCampaignId}/report/campaignUsers?$count=true +GET /security/attackSimulation/trainingCampaigns/{trainingCampaignId}/report/campaignUsers?$skipToken={skipToken} +GET /security/attackSimulation/trainingCampaigns/{trainingCampaignId}/report/campaignUsers?$top=1 +``` ++## 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 [userSimulationDetails](../resources/usersimulationdetails.md) objects in the response body. ++## Examples ++### Request ++The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "list_campaignusersdetails" +} +--> +``` http +GET https://graph.microsoft.com/beta/security/attackSimulation/trainingCampaigns/f1b13829-3829-f1b1-2938-b1f12938b1a/report/campaignUsers +``` ++# [JavaScript](#tab/javascript) ++++++### 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.userSimulationDetails)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "isCompromised": true, + "compromisedDateTime": "2021-01-01T01:02:01.01Z", + "simulationEvents": [ + { + "eventName": "SuccessfullyDeliveredEmail", + "eventDateTime": "2021-01-01T01:01:01.01Z", + "ipAddress": "100.200.100.200", + "osPlatformDeviceDetails": "Sample OS", + "browser": "Sample Browser" + }, + { + "eventName": "EmailLinkClicked", + "eventDateTime": "2021-01-01T01:02:01.01Z", + "ipAddress": "100.200.100.200", + "osPlatformDeviceDetails": "Sample OS", + "browser": "Sample Browser" + } + ], + "trainingEvents": [ + { + "displayName": "Sample Training", + "latestTrainingStatus": "assigned", + "trainingAssignedProperties": { + "contentDateTime": "2021-01-01T01:03:01.01Z", + "ipAddress": "100.200.100.200", + "osPlatformDeviceDetails": "Sample OS", + "browser": "Sample Browser", + "potentialScoreImpact": 5.0 + }, + "trainingUpdatedProperties": { + "contentDateTime": "2021-01-01T01:04:01.01Z", + "ipAddress": "100.200.100.201", + "osPlatformDeviceDetails": "Sample OS-2", + "browser": "Sample Browser", + "potentialScoreImpact": 5.0 + }, + "trainingCompletedProperties": { + "contentDateTime": "2021-01-01T01:05:01.01Z", + "ipAddress": "100.200.100.202", + "osPlatformDeviceDetails": "Sample OS", + "browser": "Sample Browser-2", + "potentialScoreImpact": 5.0 + } + } + ], + "assignedTrainingsCount": 1, + "completedTrainingsCount": 0, + "inProgressTrainingsCount": 0, + "reportedPhishDateTime": "2021-01-01T01:01:01.01Z", + "simulationUser": { + "userId": "99af58b9-ef1a-412b-a581-cb42fe8c8e21", + "displayName": "Reed Flores", + "email": "reed@contoso.com" + } + } + ] +} +``` + |
v1.0 | Verticalsection Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/verticalsection-delete.md | DELETE /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/ve ## Request body -Do not supply a request body with this method. +Don't supply a request body with this method. ## Response If successful, this call returns a `204 No Content`. It doesn't return anything in the response body. -If the vertical section is not found, this method returns `404 Not Found`. +If the vertical section isn't found, this method returns `404 Not Found`. ## Example If the vertical section is not found, this method returns `404 Not Found`. <!-- { "blockType": "ignored" } --> ```http-DELETE https://graph.microsoft.com/beta/sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/verticalSection +DELETE https://graph.microsoft.com/beta/sites/a69edae4-9208-4f60-9aa3-cd0911ff0ce1/pages/7f7a2740-2d74-47ba-af0c-71ed3a3384ca/microsoft.graph.sitePage/canvasLayout/verticalSection ``` ### Response |
v1.0 | Verticalsection Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/verticalsection-get.md | The following example shows a request. <!-- { "blockType": "ignored" } --> ```http-GET https://graph.microsoft.com/beta/sites/{sitesId}/pages/{sitePageId}/microsoft.graph.sitePage/canvasLayout/verticalSection +GET https://graph.microsoft.com/beta/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/verticalSection ``` #### Response Content-Type: application/json ### Example 2: Get a verticalSection object using select and expand #### Request -With `select` and `expand` statements, you can retrieve verticalSection metadata and associated webParts in a single request. +With `$select` and `$expand` statements, you can retrieve verticalSection metadata and associated webParts in a single request. <!-- { "blockType": "ignored" } --> ```http-GET https://graph.microsoft.com/beta/sites/{sitesId}/pages/{sitePageId}/microsoft.graph.sitePage/canvasLayout/verticalSection?select=emphasis,expand=webparts +GET https://graph.microsoft.com/beta/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/verticalSection?$select=emphasis&$expand=webparts ``` #### Response |
v1.0 | Verticalsection Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/verticalsection-update.md | The following example shows a request. <!-- { "blockType": "ignored" } --> ```http-PATCH https://graph.microsoft.com/beta/sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/verticalSection +PATCH https://graph.microsoft.com/beta/sites/a69edae4-9208-4f60-9aa3-cd0911ff0ce1/pages/7f7a2740-2d74-47ba-af0c-71ed3a3384ca/microsoft.graph.sitePage/canvasLayout/verticalSection Content-Type: application/json { |
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 { "@odata.type": "#microsoft.graph.cloudPcAuditEvent", "id": "250473f5-029f-4037-813d-ba4768201d61",- "displayName": "Display Name value", - "componentName": "Component Name value",  - "activity": "Activity value",  - "activityDateTime": "2021-02-14T13:10:51.814636+08:00",  - "activityType": " Activity Type value",  - "activityOperationType": "Activity Operation Type value",  - "activityResult": "Activity Result value",  - "correlationId": "a5c71cc6-2271-4d5c-9bfe-d94781e83fe6",  - "category": "Category value", + "displayName": "Delete OnPremisesConnection", + "componentName": "CloudPcOnPremisesConnectionsController", + "activity": null, + "activityDateTime": "2021-02-14T13:10:51.814636+08:00", + "activityType": "Delete CloudPcOnPremisesConnection", + "activityOperationType": "Delete", + "activityResult": "Success", + "correlationId": "a5c71cc6-2271-4d5c-9bfe-d94781e83fe6", + "category": "Cloud PC", "actor": {- "@odata.type": "microsoft.graph.cloudPcAuditActor", - "type": "Type value", - "userPermissions": [ - "User Permissions value" - ], - "applicationId": "Application Id value", - "applicationDisplayName": "Application Display Name value", - "userPrincipalName": "User Principal Name value", - "servicePrincipalName": "Service Principal Name value", - "ipAddress": "Ip Address value", - "userId": "User Id value", - "userRoleScopeTags": [ - { - "@odata.type": "microsoft.graph.cloudPcUserRoleScopeTagInfo", - "displayName": "Display Name value", - "roleScopeTagId": "Role Scope Tag Id value" - } - ], - "remoteTenantId": "Remote Tenant Id value", - "remoteUserId": "Remote User Id value" + "@odata.type": "microsoft.graph.cloudPcAuditActor", + "type": "application", + "userPermissions": [], + "applicationId": "69cc3193-b6c4-4172-98e5-ed0f38ab3ff8", + "applicationDisplayName": "Cloud PC Ibiza", + "userPrincipalName": null, + "servicePrincipalName": null, + "ipAddress": null, + "userId": "ccaf0214-2d5c-4c72-b23f-191ff2c87313", + "userRoleScopeTags": [ + { + "@odata.type": "microsoft.graph.cloudPcUserRoleScopeTagInfo", + "displayName": "Europe", + "roleScopeTagId": "8ad48104-cb5c-497c-b144-6fc9927354ab" + } + ], + "remoteTenantId": "33c73c76-bf5d-45ba-ab4f-ee49c9a9be76", + "remoteUserId": "ccaf0214-2d5c-4c72-b23f-191ff2c87313" }, "resources": [ { "@odata.type": "microsoft.graph.cloudPcAuditResource",- "displayName": "Display Name value", + "displayName": "ecmadao-test-azureconnection-1", "modifiedProperties": [ { "@odata.type": "microsoft.graph.cloudPcAuditProperty",- "displayName": "Display Name value", - "oldValue": "Old Value value", - "newValue": "New Value value" + "displayName": "AdDomainUsername", + "oldValue": "12312", + "newValue": "new-adDomainUsername" } ],- "type": "Type value", - "resourceId": "Resource Id value" + "type": "CloudPcOnPremisesConnection", + "resourceType": "CloudPcOnPremisesConnection", + "resourceId": "a7508af8-d334-41ba-83a7-26cc88959724" }- ], + ] } ] } |
v1.0 | Virtualendpoint List Bulkactions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualendpoint-list-bulkactions.md | + + Title: "List bulkActions" +description: "Get a list of the cloudPcBulkAction objects and their properties." ++ms.localizationpriority: medium ++++# List bulkActions +Namespace: microsoft.graph +++Get a list of the [cloudPcBulkAction](../resources/cloudpcbulkaction.md) objects and their properties. +++## 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": "virtualendpoint_list_bulkactions" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /deviceManagement/virtualEndpoint/bulkActions +``` ++## Optional query parameters +This method supports the `$select`, `$filter`, `$orderby`, `$top` OData query parameter 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 [cloudPcBulkAction](../resources/cloudpcbulkaction.md) objects in the response body. ++## Examples ++### Request +The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "list_cloudpcbulkaction" +} +--> +``` http +GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/bulkActions +``` ++# [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. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.cloudPcBulkAction)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "value": { + "@odata.type": "#microsoft.graph.cloudPcBulkAction", + "id": "231ad98f-41b3-872b-dd37-c70bf22cbdac", + "displayName": "Bulk Power Off by Andy", + "cloudPcIds": [ + "d6e0b8ee-8836-4b8d-b038-6130a97a3a9d", + "85994912-197b-4927-b569-447bd81350ec" + ], + "actionSummary": { + "failedCount": 1, + "inProgressCount": 0, + "notSupportedCount": 0, + "pendingCount": 1, + "successfulCount": 0 + }, + "scheduledDuringMaintenanceWindow": true, + "createdDateTime": "2024-02-05T10:29:57Z" + } + } + ] +} +``` |
v1.0 | Virtualendpoint List Provisioningpolicies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualendpoint-list-provisioningpolicies.md | Content-Type: application/json "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy", "description": "Description value", "displayName": "Display Name value",- "domainJoinConfiguration": { - "onPremisesConnectionId": "16ee6c71-fc10-438b-88ac-daa1ccafffff", - "type": "hybridAzureADJoin" - }, "domainJoinConfigurations": [ { "onPremisesConnectionId": "16ee6c71-fc10-438b-88ac-daa1ccafffff", Content-Type: application/json ], "enableSingleSignOn": true, "id": "1d164206-bf41-4fd2-8424-a3192d39ffff",- "onPremisesConnectionId": "4e47d0f6-6f77-44f0-8893-c0fe1701ffff", "imageDisplayName": "Image Display Name value", "imageId": "Image ID value", "imageType":"custom",- "windowsSettings": { - "language": "en-US" - }, "windowsSetting": { "locale": "en-US" }, |
v1.0 | Virtualendpoint Post Bulkactions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualendpoint-post-bulkactions.md | + + Title: "Create cloudPcBulkAction" +description: "Create a new cloudPcBulkAction object." ++ms.localizationpriority: medium ++++# Create cloudPcBulkAction +Namespace: microsoft.graph +++Create a new [cloudPcBulkAction](../resources/cloudpcbulkaction.md) object. +++## 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": "virtualendpoint_post_bulkactions" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /deviceManagement/virtualEndpoint/bulkActions +``` ++## 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 [cloudPcBulkAction](../resources/cloudpcbulkaction.md) object. ++You can specify the following properties when you create a **cloudPcBulkAction**. ++|Property|Type|Description| +|:|:|:| +|displayName|String|Name of this bulk action. Required.| +|cloudPcIds|String collection|IDs of the Cloud PCs the bulk action applies to. Required.| +|scheduledDuringMaintenanceWindow|Boolean|Indicates whether the bulk actions can be initiated during maintenance window. When `true`, bulk action will use maintenance window to schedule action, When `false` means bulk action will not use the maintenance window. Default value is `false`.| ++## Response ++If successful, this method returns a `201 Created` response code and a [cloudPcBulkAction](../resources/cloudpcbulkaction.md) object in the response body. ++## Examples ++### Request +The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_cloudpcbulkaction_from_" +} +--> +``` http +POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/bulkActions +Content-type: application/json ++{ + "@odata.type": "#microsoft.graph.cloudPcBulkAction", + "displayName": "Bulk Power Off by Andy", + "cloudPcIds": [ + "d6e0b8ee-8836-4b8d-b038-6130a97a3a9d", + "85994912-197b-4927-b569-447bd81350ec" + ], + "scheduledDuringMaintenanceWindow": true +} +``` ++# [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. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.cloudPcBulkAction" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.cloudPcBulkAction", + "id": "231ad98f-41b3-872b-dd37-c70bf22cbdac", + "displayName": "Bulk Power Off by Andy", + "cloudPcIds": [ + "d6e0b8ee-8836-4b8d-b038-6130a97a3a9d", + "85994912-197b-4927-b569-447bd81350ec" + ], + "actionSummary": { + "failedCount": 0, + "inProgressCount": 0, + "notSupportedCount": 0, + "pendingCount": 2, + "successfulCount": 0 + }, + "scheduledDuringMaintenanceWindow": true, + "createdDateTime": "2024-02-05T10:29:57Z" +} +``` |
v1.0 | Virtualendpoint Post Provisioningpolicies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualendpoint-post-provisioningpolicies.md | The following table lists the properties that are required when you create the [ |imageDisplayName|String|The display name for the OS image youΓÇÖre provisioning.| |imageId|String|The ID of the operating system image you want to provision on Cloud PCs. The format for a gallery type image is: {publisher_offer_sku}. Supported values for each of the parameters are as follows:<ul><li>publisher: `Microsoftwindowsdesktop`.</li> <li>offer: `windows-ent-cpc`.</li> <li>sku: `21h1-ent-cpc-m365`, `21h1-ent-cpc-os`, `20h2-ent-cpc-m365`, `20h2-ent-cpc-os`, `20h1-ent-cpc-m365`, `20h1-ent-cpc-os`, `19h2-ent-cpc-m365` and `19h2-ent-cpc-os`.</li></ul>| |imageType|cloudPcProvisioningPolicyImageType|The type of OS image (custom or gallery) you want to provision on Cloud PCs. Possible values are: `gallery`, `custom`.|-|provisioningType|[cloudPcProvisioningType](../resources/cloudpcprovisioningpolicy.md#cloudpcprovisioningtype-values)|Specifies the type of license used when provisioning Cloud PCs using this policy. By default, the license type is `dedicated` if the **provisioningType** isn't specified when you create the **cloudPcProvisioningPolicy**. You can't change this property after the **cloudPcProvisioningPolicy** was created. Possible values are: `dedicated`, `shared`, `unknownFutureValue`.| +|provisioningType|[cloudPcProvisioningType](../resources/cloudpcprovisioningpolicy.md#cloudpcprovisioningtype-values)|Specifies the type of license used when provisioning Cloud PCs using this policy. By default, the license type is `dedicated` if the **provisioningType** isn't specified when you create the **cloudPcProvisioningPolicy**. You can't change this property after the **cloudPcProvisioningPolicy** was created. Possible values are: `dedicated`, `shared`, `unknownFutureValue`, `sharedByUser`, `sharedByEntraGroup`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `sharedByUser`, `sharedByEntraGroup`. The `shared` member is deprecated and will stop returning on April 30, 2027; going forward, use the `sharedByUser` member. | |windowsSetting|[cloudPcWindowsSettings](../resources/cloudpcwindowssetting.md)|Indicates a specific Windows setting to configure during the creation of Cloud PCs for this provisioning policy. Supports `$select`. |-|domainJoinConfiguration (deprecated)|[cloudPcDomainJoinConfiguration](../resources/cloudpcdomainjoinconfiguration.md)|Specifies how Cloud PCs join Microsoft Entra ID.| -|onPremisesConnectionId (deprecated)|String|The ID of the cloudPcOnPremisesConnection. To ensure that Cloud PCs have network connectivity and that they domain join, choose a connection with a virtual network thatΓÇÖs validated by the Cloud PC service.| +|domainJoinConfiguration (deprecated)|[cloudPcDomainJoinConfiguration](../resources/cloudpcdomainjoinconfiguration.md)|Specifies how Cloud PCs join Microsoft Entra ID. The **domainJoinConfiguration** property is deprecated and will stop returning data on May 31, 2024. Going forward, use the **domainJoinConfigurations** property.| +|onPremisesConnectionId (deprecated)|String|The ID of the cloudPcOnPremisesConnection. To ensure that Cloud PCs have network connectivity and that they domain join, choose a connection with a virtual network that the Cloud PC service validated it. The **onPremisesConnectionId** property is deprecated and will stop returning data on May 31, 2024. Going forward, use the **domainJoinConfigurations** property.| |windowsSettings (deprecated)|[cloudPcWindowsSettings](../resources/cloudpcwindowssettings.md)|Specific Windows settings to configure during the creation of Cloud PCs for this provisioning policy. Supports `$select`. The **windowsSettings** property is deprecated and will stop returning data on January 31, 2024. Going forward, use the **windowsSetting** property.| ## Response |
v1.0 | Virtualevent Cancel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualevent-cancel.md | + + Title: "virtualEvent: cancel" +description: "Cancel a virtual event." ++ms.localizationpriority: medium ++++# virtualEvent: cancel +Namespace: microsoft.graph +++Cancel a virtual event. ++Currently the supported virtual event type is [virtualEventTownhall](../resources/virtualeventtownhall.md). A canceled town hall has its **status** set to `canceled` permanently. You can still get a canceled town hall by using the [Get virtualEventTownhall](../api/virtualeventtownhall-get.md) API. ++## Permissions ++One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++<!-- { + "blockType": "permissions", + "name": "virtualevent-cancel-permissions" +} +--> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /solutions/virtualEvents/townhalls/{townhallId}/cancel +``` ++## Request headers ++|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body ++Don't supply a request body for this method. ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "virtualeventthis.cancel", + "sampleKeys": ["bce9a3ca-a310-48fa-baf3-1cedcd04bb3f@4aa05bcc-1cac-4a83-a9ae-0db84b88f4ba"] +} +--> +``` http +POST https://graph.microsoft.com/beta/solutions/virtualEvents/townhalls/bce9a3ca-a310-48fa-baf3-1cedcd04bb3f@4aa05bcc-1cac-4a83-a9ae-0db84b88f4ba/cancel +``` ++# [JavaScript](#tab/javascript) ++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` |
v1.0 | Virtualevent List Presenters | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualevent-list-presenters.md | + + Title: "List presenters" +description: "Get the list of all virtualEventPresenter objects of a virtual event." ++ms.localizationpriority: medium ++++# List presenters ++Namespace: microsoft.graph +++Get the list of all [virtualEventPresenter](../resources/virtualeventpresenter.md) objects associated with a virtual event. ++Currently the supported virtual event type is [virtualEventTownhall](../resources/virtualeventtownhall.md). +++## Permissions ++One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++<!-- { + "blockType": "permissions", + "name": "virtualevent-list-presenters-permissions" +} +--> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +To list all presenters of a town hall: ++``` http +GET /solutions/virtualEvents/townhalls/{townhallId}/presenters +``` ++## Request headers ++|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## 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 [virtualEventPresenter](../resources/virtualeventpresenter.md) objects in the response body. ++## Examples ++### Request ++The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "list_virtualeventpresenter", + "sampleKeys": ["88b245ac-b0b2-f1aa-e34a-c81c27abdac2@f9448ec4-804b-46af-b810-62085248da33"] +} +--> +``` http +GET https://graph.microsoft.com/beta/solutions/virtualEvents/townhalls/88b245ac-b0b2-f1aa-e34a-c81c27abdac2@f9448ec4-804b-46af-b810-62085248da33/presenters +``` ++# [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. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.virtualEventPresenter)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "id": "831affc2-4c8a-9929-50e7-02964563b6e4", + "identity": { + "displayName": "Diane Demoss", + "id": "831affc2-4c8a-9929-50e7-02964563b6e4", + "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" + }, + "email": "DianeDemoss@contoso.com", + "presenterDetails": null + }, + { + "id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b", + "identity": { + "id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b", + "displayName": "Kenneth Brown", + "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" + }, + "email": "KennethBrown@contoso.com", + "presenterDetails": null + } + ] +} +``` |
v1.0 | Virtualevent List Sessions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualevent-list-sessions.md | Namespace: microsoft.graph Get a list of all [virtualEventSession](../resources/virtualeventsession.md) objects under a virtual event. +Currently, the following virtual event types are supported: [virtualEventTownhall](../resources/virtualeventtownhall.md) and [virtualEventWebinar](../resources/virtualeventwebinar.md). + [!INCLUDE [national-cloud-support](../../includes/global-only.md)] ## Permissions Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/virtualeventsession-list-permissions.md)] > [!NOTE]-> > To use application permissions for this API, tenant administrators must create an [application access policy](/graph/cloud-communication-online-meeting-application-access-policy) and assign it to a user. This allows the authorized application to access registrants' information from virtual events created by that specific user. ## HTTP request Choose the permission or permissions marked as least privileged for this API. Us "blockType": "ignored" } -->+ To list all sessions of a webinar: ``` http GET /solutions/virtualEvents/webinars/{webinarId}/sessions ``` +To list all sessions of a town hall: ++``` http +GET /solutions/virtualEvents/townhalls/{townhallId}/sessions +``` + ## Optional query parameters This method doesn't support the OData query parameters. For general information, see [OData query parameters](/graph/query-parameters). |
v1.0 | Virtualevent Post Presenters | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualevent-post-presenters.md | + + Title: "Create virtualEventPresenter" +description: "Create a new virtualEventPresenter object to a virtual event." ++ms.localizationpriority: medium ++++# Create virtualEventPresenter ++Namespace: microsoft.graph +++Create a new [virtualEventPresenter](../resources/virtualeventpresenter.md) object on a virtual event. ++Currently the supported virtual event type is [virtualEventTownhall](../resources/virtualeventtownhall.md). +++## Permissions ++One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++<!-- { + "blockType": "permissions", + "name": "virtualevent-post-presenters-permissions" +} +--> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /solutions/virtualEvents/townhalls/{townhallId}/presenters +``` ++## Request headers ++|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body ++In the request body, supply a JSON representation of the [virtualEventPresenter](../resources/virtualeventpresenter.md) object. ++You can specify the following properties when you create a presenter on a **virtualEventTownhall**: ++|Property|Type|Description| +|:|:|:| +|identity|[identity](../resources/identity.md)|Identity information of the presenter. The supported identities are: [communicationsGuestIdentity](../resources/communicationsguestidentity.md) and [communicationsUserIdentity](../resources/communicationsuseridentity.md). | ++## Response ++If successful, this method returns a `201 Created` response code and a [virtualEventPresenter](../resources/virtualeventpresenter.md) object in the response body. ++## Examples ++### Example 1: Create an in-tenant presenter ++The following example shows how to create an internal user as a presenter on a **virtualEventTownhall**. ++#### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_virtualeventpresenter_internal_", + "sampleKeys": ["502dadea-b5d8-44aa-a851-a0ac496a36bf@09a21d49-f0f3-4b3f-96b6-f381e9430742"] +} +--> +``` http +POST https://graph.microsoft.com/beta/solutions/virtualEvents/townhalls/502dadea-b5d8-44aa-a851-a0ac496a36bf@09a21d49-f0f3-4b3f-96b6-f381e9430742/presenters +Content-Type: application/json ++{ + "identity": { + "@odata.type": "#microsoft.graph.communicationsUserIdentity", + "id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b" + } +} +``` ++# [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. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.virtualEventPresenter" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b", + "email": "kenneth.brown@contoso.com", + "identity": { + "@odata.type": "#microsoft.graph.communicationsUserIdentity", + "id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b", + "displayName": "Kennth Brown", + "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" + }, + "presenterDetails": null +} +``` ++### Example 2: Create an out-of-tenant presenter ++The following example shows how to create a guest user as a presenter on a **virtualEventTownhall**. ++#### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_virtualeventpresenter_external", + "sampleKeys": ["502dadea-b5d8-44aa-a851-a0ac496a36bf@09a21d49-f0f3-4b3f-96b6-f381e9430742"] +} +--> +``` http +POST https://graph.microsoft.com/beta/solutions/virtualEvents/townhalls/502dadea-b5d8-44aa-a851-a0ac496a36bf@09a21d49-f0f3-4b3f-96b6-f381e9430742/presenters +Content-Type: application/json ++{ + "identity": { + "@odata.type": "#microsoft.graph.communicationsGuestIdentity", + "displayName": "Guest Speaker", + "email": "guest.speaker@fabrikam.com" + } +} +``` ++# [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. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.virtualEventPresenter" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "id": "184975c0-4096-4a02-b251-c48546691c42", + "email": "guest.speaker@fabrikam.com", + "presenterDetails": null, + "identity": { + "@odata.type": "#microsoft.graph.communicationsGuestIdentity", + "id": "184975c0-4096-4a02-b251-c48546691c42", + "displayName": "Guest Speaker", + "email": "guest.speaker@fabrikam.com" + } +} +``` |
v1.0 | Virtualevent Publish | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualevent-publish.md | + + Title: "virtualEvent: publish" +description: "Publish a virtual event to make it visible to its audience." ++ms.localizationpriority: medium ++++# virtualEvent: publish +Namespace: microsoft.graph +++Publish a virtual event to make it visible to its audience. ++Currently the supported virtual event type is [virtualEventTownhall](../resources/virtualeventtownhall.md). ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++<!-- { + "blockType": "permissions", + "name": "virtualevent-publish-permissions" +} +--> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /solutions/virtualEvents/townhalls/{townhallId}/publish +``` ++## Request headers ++|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body ++Don't supply a request body for this method. ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "virtualeventthis.publish", + "sampleKeys": ["bce9a3ca-a310-48fa-baf3-1cedcd04bb3f@4aa05bcc-1cac-4a83-a9ae-0db84b88f4ba"] +} +--> +``` http +POST https://graph.microsoft.com/beta/solutions/virtualEvents/townhalls/bce9a3ca-a310-48fa-baf3-1cedcd04bb3f@4aa05bcc-1cac-4a83-a9ae-0db84b88f4ba/publish +``` ++# [JavaScript](#tab/javascript) ++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` |
v1.0 | Virtualeventpresenter Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventpresenter-delete.md | + + Title: "Delete virtualEventPresenter" +description: "Delete a virtualEventPresenter object." ++ms.localizationpriority: medium ++++# Delete virtualEventPresenter ++Namespace: microsoft.graph +++Delete a [virtualEventPresenter](../resources/virtualeventpresenter.md) from a virtual event. ++Currently the supported virtual event type is [virtualEventTownhall](../resources/virtualeventtownhall.md). +++## Permissions ++One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++<!-- { + "blockType": "permissions", + "name": "virtualeventpresenter-delete-permissions" +} +--> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /solutions/virtualEvents/townhalls/{townhallId}/presenters/{presenterId} +``` ++## Request headers ++|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body ++Don't supply a request body for this method. ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_presenters_from_virtualeventtownhall", + "sampleKeys": ["502dadea-b5d8-44aa-a851-a0ac496a36bf@09a21d49-f0f3-4b3f-96b6-f381e9430742", "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b"] +} +--> +``` http +DELETE https://graph.microsoft.com/beta/solutions/virtualEvents/townhalls/502dadea-b5d8-44aa-a851-a0ac496a36bf@09a21d49-f0f3-4b3f-96b6-f381e9430742/presenters/7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b +``` ++# [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. ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` |
v1.0 | Virtualeventpresenter Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventpresenter-get.md | + + Title: "Get presenter" +description: "Read the properties and relationships of a virtualEventPresenter object." ++ms.localizationpriority: medium ++++# Get presenter +Namespace: microsoft.graph +++Read the properties and relationships of a [virtualEventPresenter](../resources/virtualeventpresenter.md) object. +++## 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": "virtualeventsession_get" } --> ++> [!NOTE] +> +> To use application permissions for this API, tenant administrators must create an [application access policy](/graph/cloud-communication-online-meeting-application-access-policy) and assign it to a user. This allows the authorized application to access registrants' information from virtual events created by that specific user. ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /solutions/virtualEvents/townhalls/{townhallId}/presenters/{presenterId} +``` ++## Request headers ++|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body ++Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [virtualEventPresenter](../resources/virtualeventpresenter.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_virtualeventpresenter" +} +--> +``` http +GET https://graph.microsoft.com/beta/solutions/virtualEvents/townhalls/fc6e8c15-2fd7-1dd5-caa0-87056e6a12be/presenters/831affc2-4c8a-9929-50e7-02964563b6e4 +``` ++# [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. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.virtualEventPresenter" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": { + "@odata.type": "#microsoft.graph.virtualEventPresenter", + "id": "831affc2-4c8a-9929-50e7-02964563b6e4", + "identity": { + "@odata.type": "microsoft.graph.communicationsUserIdentity", + "displayName": "Diane Demoss", + "id": "831affc2-4c8a-9929-50e7-02964563b6e4", + "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" + }, + "email": "DianeDemoss@contoso.com" + } +} +``` |
v1.0 | Virtualeventsession Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventsession-get.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Read the properties and relationships of a [virtualEventSession](../resources/virtualeventsession.md) object. +Read the properties and relationships of a [virtualEventSession](../resources/virtualeventsession.md) object. ++Currently, the following virtual event types are supported: [virtualEventTownhall](../resources/virtualeventtownhall.md) and [virtualEventWebinar](../resources/virtualeventwebinar.md). [!INCLUDE [national-cloud-support](../../includes/global-only.md)] Choose the permission or permissions marked as least privileged for this API. Us ## HTTP request +++To get a session of a webinar: + <!-- { "blockType": "ignored" } -->-To get a session of a webinar: - ``` http GET /solutions/virtualEvents/webinars/{webinarId}/sessions/{sessionId} ``` +To get a session of a town hall: ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /solutions/virtualEvents/townhalls/{townhallId}/sessions/{sessionId} +``` + ## Optional query parameters -This method does not support the OData query parameters. For general information, see [OData query parameters](/graph/query-parameters). +This method doesn't support the OData query parameters. For general information, see [OData query parameters](/graph/query-parameters). ## Request headers |
v1.0 | Virtualeventsroot Post Townhalls | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventsroot-post-townhalls.md | + + Title: "Create virtualEventTownhall" +description: "Create a new virtualEventTownhall object in draft mode." ++ms.localizationpriority: medium ++++# Create virtualEvent +Namespace: microsoft.graph +++Create a new [virtualEventTownhall](../resources/virtualeventtownhall.md) object in draft mode. +++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++<!-- { + "blockType": "permissions", + "name": "virtualeventsroot-post-townhalls-permissions" +} +--> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /solutions/virtualEvents/townhalls +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [virtualEventTownhall](../resources/virtualeventtownhall.md) object. ++You can specify the following properties when you create a **virtualEventTownhall**. ++|Property|Type|Description| +|:|:|:| +| audience | [meetingAudience](../resources/virtualeventtownhall.md#meetingaudience-values) | The audience to whom the town hall is visible. Possible values are: `everyone`, `organization`, `unknownFutureValue`. | +| coOrganizers | [communicationsUserIdentity](../resources/communicationsuseridentity.md) collection | Identity information of coorganizers of the town hall. | +| description | [itemBody](../resources/itembody.md) | Description of the town hall. Inherited from [virtualEvent](../resources/virtualevent.md). | +| displayName | String | Display name of the town hall. Inherited from [virtualEvent](../resources/virtualevent.md). | +| endDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | Date and time when the town hall ends. Inherited from [virtualEvent](../resources/virtualevent.md). | +| invitedAttendees | [identity](../resources/identity.md) collection | Attendees invited to the town hall. The supported identites are [communicationsGuestIdentity](../resources/communicationsguestidentity.md) and [communicationsUserIdentity](../resources/communicationsuseridentity.md). | +| isInviteOnly | Boolean | Indicates whether the town hall is only open to invited people and groups within your organization. The **isInviteOnly** property can only be `true` if the value of the **audience** property is set to `organization`. | +| startDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | Date and time when the town hall starts. Inherited from [virtualEvent](../resources/virtualevent.md). | ++## Response ++If successful, this method returns a `201 Created` response code and a [virtualEventTownhall](../resources/virtualeventtownhall.md) object in the response body. ++## Examples ++### Request +The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_virtualeventtownhall" +} +--> +``` http +POST https://graph.microsoft.com/beta/solutions/virtualEvents/townhalls +Content-Type: application/json ++{     + "displayName": "The Impact of Tech on Our Lives", + "description": "Discusses how technology has changed the way we communicate.", + "startDateTime": { + "dateTime": "2023-03-30T10:00:00", + "timeZone": "Pacific Standard Time" + }, + "endDateTime": { + "dateTime": "2023-03-30T17:00:00", + "timeZone": "Pacific Standard Time" + }, + "audience": "organization", + "coOrganizers": [ + { + "id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b", + "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" + } + ] +} +``` ++# [CLI](#tab/cli) ++# [JavaScript](#tab/javascript) ++++### 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.virtualEventTownhall" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{  + "id": "bce9a3ca-a310-48fa-baf3-1cedcd04bb3f@4aa05bcc-1cac-4a83-a9ae-0db84b88f4ba", + "status": "draft", + "displayName": "The Impact of Tech on Our Lives", + "description": "Discusses how technology has changed the way we communicate.", + "startDateTime": { + "dateTime": "2023-03-30T10:00:00", + "timeZone": "Pacific Standard Time" + }, + "endDateTime": { + "dateTime": "2023-03-30T17:00:00", + "timeZone": "Pacific Standard Time" + }, + "audience": "organization", + "createdBy": { + "application": null, + "device": null, + "user": { + "id": "b7ef013a-c73c-4ec7-8ccb-e56290f45f68", + "displayName": "Diane Demoss", + "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" + } + }, + "coOrganizers": [ + { + "id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b", + "displayName": "Kenneth Brown", + "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" + } + ], + "invitedAttendees": [], + "isInviteOnly": false +} +``` |
v1.0 | Virtualeventtownhall Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventtownhall-get.md | + + Title: "Get virtualEventTownhall" +description: "Read the properties and relationships of a virtualEventTownhall object." ++ms.localizationpriority: medium ++++# Get virtualEventTownhall +Namespace: microsoft.graph +++Read the properties and relationships of a [virtualEventTownhall](../resources/virtualeventtownhall.md) object. +++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++<!-- { + "blockType": "permissions", + "name": "virtualeventtownhall-get-permissions" +} +--> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /solutions/virtualEvents/townhalls/{townhallId} +``` ++## Optional query parameters +This method doesn't currently support the [OData query parameters](/graph/query-parameters) to customize the response. ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body ++Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [virtualEventTownhall](../resources/virtualeventtownhall.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_virtualeventtownhall" +} +--> +``` http +GET https://graph.microsoft.com/beta/solutions/virtualEvents/townhalls/fc6e8c15-2fd7-1dd5-caa0-87056e6a12be +``` ++# [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. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.virtualEventTownhall" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.virtualEventTownhall", + "id": "fc6e8c15-2fd7-1dd5-caa0-87056e6a12be", + "status": "published", + "displayName": "The Impact of Tech on Our Lives", + "description": { + "content": "Discusses how technology has changed the way we communicate, work, and interact with each other.", + "contentType": "Html" + }, + "startDateTime": { + "dateTime": "2023-11-30T16:30:00", + "timeZone": "Eastern Standard Time" + }, + "endDateTime": { + "dateTime": "2023-11-30T17:00:00", + "timeZone": "Eastern Standard Time" + }, + "createdBy": { + "@odata.type": "microsoft.graph.communicationsIdentitySet", + "application": null, + "device": null, + "user": { + "@odata.type": "#microsoft.graph.communicationsUserIdentity", + "id": "b7ef013a-c73c-4ec7-8ccb-e56290f45f68", + "displayName": "Diane Demoss", + "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" + } + }, + "audience": "everyone", + "coOrganizers": [ + { + "id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b", + "displayName": "Kenneth Brown", + "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" + } + ], + "invitedAttendees": [ + { + "@odata.type": "microsoft.graph.communicationsUserIdentity", + "id": "127962bb-84e1-7b62-fd98-1c9d39def7b6", + "displayName": "Emilee Pham", + "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" + } + ], + "isInviteOnly": false +} +``` |
v1.0 | Virtualeventtownhall Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventtownhall-update.md | + + Title: "Update virtualEventTownhall" +description: "Update the properties of a virtualEventTownhall object." ++ms.localizationpriority: medium ++++# Update virtualEventTownhall +Namespace: microsoft.graph +++Update the properties of a [virtualEventTownhall](../resources/virtualeventtownhall.md) object. +++## Permissions ++One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++<!-- { + "blockType": "permissions", + "name": "virtualeventtownhall-update-permissions" +} +--> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /solutions/virtualEvents/townhalls/{id} +``` ++## Request headers ++|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +++|Property|Type|Description| +|:|:|:| +| coOrganizers | [communicationsUserIdentity](../resources/communicationsuseridentity.md) collection | Identity information of coorganizers of the town hall. Optional. | +| description | [itemBody](../resources/itembody.md) | Description of the town hall. Inherited from [virtualEvent](../resources/virtualevent.md). Optional. | +| displayName | String | Display name of the town hall. Inherited from [virtualEvent](../resources/virtualevent.md). Optional. | +| endDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | Date and time when the town hall ends. Inherited from [virtualEvent](../resources/virtualevent.md). Optional. | +| startDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | Date and time when the town hall starts. Inherited from [virtualEvent](../resources/virtualevent.md). Optional. | ++## Response ++If successful, this method returns a `200 OK` response code and an updated [virtualEventTownhall](../resources/virtualeventtownhall.md) object in the response body. ++## Examples ++### Request +The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_virtualeventtownhall" +} +--> +``` http +PATCH https://graph.microsoft.com/beta/solutions/virtualEvents/townhalls/fc6e8c15-2fd7-1dd5-caa0-87056e6a12be +Content-Type: application/json ++{ + "startDateTime": { + "dateTime": "2024-03-31T10:00:00", + "timeZone": "Pacific Standard Time" + }, + "endDateTime": { + "dateTime": "2024-03-31T17:00:00", + "timeZone": "Pacific Standard Time" + } +} +``` ++# [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. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.virtualEventTownhall" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.virtualEventTownhall", + "id": "fc6e8c15-2fd7-1dd5-caa0-87056e6a12be", + "status": "draft", + "displayName": "The Impact of Tech on Our Lives", + "description": { + "content": "<p>Discusses how technology has changed the way we communicate, work, and interact with each other.<p>", + "contentType": "html" + }, + "startDateTime": { + "dateTime": "2024-03-31T10:00:00", + "timeZone": "Pacific Standard Time" + }, + "endDateTime": { + "dateTime": "2024-03-31T17:00:00", + "timeZone": "Pacific Standard Time" + }, + "createdBy": { + "application": null, + "device": null, + "user": { + "@odata.type": "#microsoft.graph.communicationsUserIdentity", + "id": "b7ef013a-c73c-4ec7-8ccb-e56290f45f68", + "displayName": "Diane Demoss", + "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" + } + }, + "audience": "organization", + "isInviteOnly": false, + "coOrganizers": [ + { + "id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b", + "displayName": "Kenneth Brown", + "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" + } + ], + "invitedAttendees": [ + { + "@odata.type": "microsoft.graph.communicationsUserIdentity", + "id": "127962bb-84e1-7b62-fd98-1c9d39def7b6", + "displayName": "Emilee Pham", + "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" + } + ] +} +``` |
v1.0 | Virtualeventwebinar Getbyuseridandrole | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventwebinar-getbyuseridandrole.md | Title: "virtualEventWebinar: getByUserIdAndRole" -description: "List all webinars where the specified user is either the organizer or a coorganizer." +description: "Get a list of virtualEventWebinar objects where the specified user is either the organizer or a coorganizer." ms.localizationpriority: medium Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Get a [virtualEventWebinar](../resources/virtualeventwebinar.md) collection where the specified user is either the organizer or a coorganizer. +Get a list of [virtualEventWebinar](../resources/virtualeventwebinar.md) objects where the specified user is either the organizer or a coorganizer. ## Permissions Don't supply a request body for this method. ## Response -If successful, this function returns a `200 OK` response code and a [virtualEventWebinar](../resources/virtualeventwebinar.md) collection in the response body. +If successful, this function returns a `200 OK` response code and a collection of [virtualEventWebinar](../resources/virtualeventwebinar.md) objects in the response body. ## Examples |
v1.0 | Virtualeventwebinar Getbyuserrole | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventwebinar-getbyuserrole.md | Title: "virtualEventWebinar: getByUserRole" -description: "List all webinars where the signed-in user is either the organizer a coorganizer." +description: "Get a list of virtualEventWebinar objects where the signed-in user is either the organizer a coorganizer." ms.localizationpriority: medium Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Get a [virtualEventWebinar](../resources/virtualeventwebinar.md) collection where the signed-in user is either the organizer or a coorganizer. +Get a list of [virtualEventWebinar](../resources/virtualeventwebinar.md) objects where the signed-in user is either the organizer or a coorganizer. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] Don't supply a request body for this method. ## Response -If successful, this function returns a `200 OK` response code and a [virtualEventWebinar](../resources/virtualeventwebinar.md) collection in the response body. +If successful, this function returns a `200 OK` response code and a collection of [virtualEventWebinar](../resources/virtualeventwebinar.md) objects in the response body. ## Examples |
v1.0 | Virtualeventwebinarregistrationconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventwebinarregistrationconfiguration-get.md | + + Title: "Get virtualEventWebinarRegistrationConfiguration" +description: "Read the properties and relationships of a virtualEventWebinarRegistrationConfiguration object." ++ms.localizationpriority: medium ++++# Get virtualEventWebinarRegistrationConfiguration ++Namespace: microsoft.graph +++Read the properties and relationships of a [virtualEventWebinarRegistrationConfiguration](../resources/virtualeventwebinarregistrationconfiguration.md) object. ++## 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": "virtualeventwebinarregistrationconfiguration-get" } --> ++> [!NOTE] +> +> To use application permissions for this API, tenant administrators must create an [application access policy](/graph/cloud-communication-online-meeting-application-access-policy) and assign it to a user. This allows the authorized application to access registrants' information from virtual events created by that specific user. ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /solutions/virtualEvents/webinars/{webinarId}/registrationConfiguration +``` ++## 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 [virtualEventWebinarRegistrationConfiguration](../resources/virtualeventwebinarregistrationconfiguration.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "get_virtualeventwebinarregistrationconfiguration", + "sampleKeys": ["88b245ac-b0b2-f1aa-e34a-c81c27abdac2@f9448ec4-804b-46af-b810-62085248da33"] +} +--> +``` http +GET https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/88b245ac-b0b2-f1aa-e34a-c81c27abdac2@f9448ec4-804b-46af-b810-62085248da33/registrationConfiguration +``` ++### 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.virtualEventWebinarRegistrationConfiguration" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "registrationWebUrl": "https://events.teams.microsoft.com/event/88b245ac-b0b2-f1aa-e34a-c81c27abdac2@f9448ec4-804b-46af-b810-62085248da33" +} +``` |
v1.0 | Virtualmachinewithawsstoragebucketaccessfinding Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualmachinewithawsstoragebucketaccessfinding-get.md | description: "Read the properties and relationships of a virtualMachineWithAwsSt ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Virtualmachinewithawsstoragebucketaccessfinding List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualmachinewithawsstoragebucketaccessfinding-list.md | description: "Get a list of the virtualMachineWithAwsStorageBucketAccessFinding ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Webpart Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/webpart-delete.md | If successful, this method returns a `204 No Content`. It doesn't return anythin <!-- { "blockType": "request", "name": "delete-webpart", "scopes": "sites.readwrite.all" } --> ```http-DELETE https://graph.microsoft.com/beta/sites/{sitesId}/pages/{sitePageId}/microsoft.graph.sitePage/webParts/{webPartId} +DELETE https://graph.microsoft.com/beta/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/webParts/58ce69a6-bcb0-4f35-b6cd-d757d95f1a8e ``` # [C#](#tab/csharp) |
v1.0 | Webpart Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/webpart-get.md | The following example shows a request. <!-- { "blockType": "ignored" } --> ```http-GET https://graph.microsoft.com/beta/sites/{sitesId}/pages/{sitePageId}/microsoft.graph.sitePage/webParts/{webPartId} +GET https://graph.microsoft.com/beta/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/webParts/58ce69a6-bcb0-4f35-b6cd-d757d95f1a8e ``` #### Response Content-Type: application/json } ``` -### Example 2: Get a webPart object using select and expand +### Example 2: Get a webPart object using select #### Request -With `select` statement, you can retrieve selected webpart metadata in a request. +With `$select` statement, you can retrieve selected webpart metadata in a request. <!-- { "blockType": "ignored" } --> ```http-GET https://graph.microsoft.com/beta/sites/{sitesId}/pages/{sitePageId}/microsoft.graph.sitePage/webParts/{webPartId}?select=id +GET https://graph.microsoft.com/beta/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/webParts/58ce69a6-bcb0-4f35-b6cd-d757d95f1a8e?$select=id ``` #### Response |
v1.0 | Webpart Getposition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/webpart-getposition.md | The following example shows a request. <!-- { "blockType": "ignored" } --> ```http-GET https://graph.microsoft.com/beta/sites/{sitesId}/pages/{sitePageId}/microsoft.graph.sitePage/webParts/{webPartId}/getPositionOfWebPart +GET https://graph.microsoft.com/beta/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/7f50f45e-714a-4264-9c59-3bf43ea4db8f/microsoft.graph.sitePage/webParts/58ce69a6-bcb0-4f35-b6cd-d757d95f1a8e/getPositionOfWebPart ``` ### Response |
v1.0 | Webpart List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/webpart-list.md | The following example shows a request. <!-- { "blockType": "ignored" } --> ```http-GET https://graph.microsoft.com/beta/sites/{sitesId}/pages/{sitePageId}/microsoft.graph.sitePage/canvasLayout/horizontalSections/{horizontalSectionId}/columns/{horizontalSectionColumnId}/webparts +GET https://graph.microsoft.com/beta/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/horizontalSections/1/columns/1/webparts ``` ### Response |
v1.0 | Webpart Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/webpart-update.md | The following example shows how to update a webpart. <!-- { "blockType": "ignored" } --> ```http-PATCH /sites/{sitesId}/pages/{sitePageId}/microsoft.graph.sitePage/webParts/{webpartId} +PATCH /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/webParts/58ce69a6-bcb0-4f35-b6cd-d757d95f1a8e Content-Type: application/json { |
v1.0 | Windowssetting Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/windowssetting-get.md | Namespace: microsoft.graph Read the properties and relationships of a [windowsSetting](../resources/windowssetting.md) object by passing the ID of the setting in the URL. This method gets the setting for the signed-in 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). GET https://graph.microsoft.com/beta/me/settings/windows/{windowsSettingId} [!INCLUDE [sample-code](../includes/snippets/php/get-windowssetting-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-windowssetting-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Windowssetting List Instances | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/windowssetting-list-instances.md | Namespace: microsoft.graph Get a list of [windowsSettingInstance](../resources/windowssettinginstance.md) objects and their properties for the signed-in 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). GET https://graph.microsoft.com/beta/me/settings/windows/{windowsSettingId}/inst [!INCLUDE [sample-code](../includes/snippets/php/list-windowssettinginstance-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-windowssettinginstance-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Windowssettinginstance Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/windowssettinginstance-get.md | Namespace: microsoft.graph Read the properties and relationships of a [windowsSettingInstance](../resources/windowssettinginstance.md) object by passing the Windows setting ID and Windows setting instance ID in the URL. This method gets a **windowsSettingInstance** for the signed-in 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). GET https://graph.microsoft.com/beta/me/settings/windows/{windowsSettingId}/inst [!INCLUDE [sample-code](../includes/snippets/php/get-windowssettinginstance-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-windowssettinginstance-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Windowsupdates Product Findbycatalogid | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/windowsupdates-product-findbycatalogid.md | Title: "product: findByCatalogId" description: "Find the product revisions associated with a catalog ID and the known issues directly or indirectly related to the catalog ID." ms.localizationpriority: medium-+ doc_type: apiPageType Namespace: microsoft.graph.windowsUpdates Find the product revisions associated with a catalog ID and the known issues directly or indirectly related to the catalog ID. + ## 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). If successful, this method returns a `200 OK` response code and a collection of ### Request The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "windowsupdates.FindByCatalogId" The following example shows a request. GET https://graph.microsoft.com/beta/admin/windows/updates/products/FindByCatalogId(catalogID='10cb1ba292c5586e22c9991be3f12fbd39f2ebf231cb5d201c67f42fbaccc567')?expand=revisions($expand=catalogEntry,knowledgeBaseArticle),knownIssues($expand=originatingKnowledgeBaseArticle,resolvingKnowledgeBaseArticle) ``` +# [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. |
v1.0 | Windowsupdates Product Findbykbnumber | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/windowsupdates-product-findbykbnumber.md | Title: "product: findByKbNumber" description: "Find the product revisions associated with a knowledge base number and the known issues directly or indirectly related to the knowledge base number." ms.localizationpriority: medium-+ doc_type: apiPageType Namespace: microsoft.graph.windowsUpdates Find the product revisions associated with a knowledge base number and the known issues directly or indirectly related to the knowledge base number. + ## 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). If successful, this method returns a `200 OK` response code and a collection of The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "windowsupdates.findByCatalogId" The following example shows a request. GET https://graph.microsoft.com/beta/admin/windows/updates/products/FindByKbNumber(kbNumber=5029332)?expand=revisions($expand=catalogEntry,knowledgeBaseArticle),knownIssues ``` +# [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. |
v1.0 | Windowsupdates Product Getknownissuesbytimerange | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md | Title: "product: getKnownIssuesByTimeRange" description: "Get known issues related to a particular product based on a specified timeframe in the past." ms.localizationpriority: medium-+ doc_type: apiPageType If successful, this method returns a `200 OK` response code and a collection of The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "windowsupdates.GetKnownIssuesByTimeRange", The following example shows a request. GET https://graph.microsoft.com/beta/admin/windows/updates/products/1/GetKnownIssuesByTimeRange(daysInPast=70,includeAllActive=false) ``` +# [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. |
v1.0 | Workplace List Sensordevices | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workplace-list-sensordevices.md | + + Title: "List sensorDevices" +description: "Get a list of all workplace sensor devices created for a tenant." ++ms.localizationpriority: medium +++# List sensorDevices +Namespace: microsoft.graph +++Get a list of all workplace sensor devices created for a tenant. +++## 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": "workplace_list_sensordevices" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /workplace/sensorDevices +``` ++## Optional query parameters +This method supports the `$filter`, `$top`, `$select`, and `$skipToken` [OData query parameters](/graph/query-parameters) to help customize the response. You can use `$filter` on the **deviceId**, **displayName**, **description**, **macAddress**, **manufacturer**, **ipV4Address**, **ipV6Address**, and **tags** properties. ++### Supported query patterns ++| Pattern | Syntax | Notes | +| - | -- | -- | +| Server-side pagination | `@odata.nextLink` | You get a continuation token in the response, when a result set spans multiple pages. | +| Filter | `/workplace/sensorDevices?$filter=Tags/Any(x: cast(x, 'String') eq 'Building A')` | Filter devices based on the tags. | +| Filter | `/workplace/sensorDevices?$filter=cast(manufacturer, 'String') eq 'Contoso'` | Filter devices based on the manufacturer of the device. | +| Filter | `/workplace/sensorDevices?$filter=cast(deviceId, 'String') eq 'contoso_9D6816'` | Filter devices based on the user provided device identifier.| +| Page limit | `/workplace/sensorDevices?$top=20` | Get devices with a page size of 20. The default page size is 10. | +++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## 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 [workplaceSensorDevice](../resources/workplacesensordevice.md) objects in the response body. ++## Examples ++### Request +The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "list_workplacesensordevice" +} +--> +``` http +GET https://graph.microsoft.com/beta/workplace/sensorDevices +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++++### Response +The following example shows the response. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.workplaceSensorDevice)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#workplace/sensorDevices", + "@odata.nextLink": "https://graph.microsoft.com/betY3ZWEwYTYnKS9DdXJyZW50Q29sbGVjdGlvbnMoJ0RldmljZXNDb2xsZWN0aW9uJykvSXRlbXM%2fJTI0dG9wPTEmJTI0c2tpcHRva2VuPU15WlJWa1pDVVZWR1FsRlZSWFpNZVRoMlRIazRka3g1T0haUFJVcENVVlZHUWxOR1RYWldNVnB1WWpBNVFrMUZkRlZTYmxKU1pHcENXV0V6UlRCa2VqQTU%3d", + "value": [ + { + "id": "ade7078f-4bf5-4239-bfde-95a7c4225df7", + "deviceId": "contoso_9D6816", + "displayName": "Contoso 9D6816 Device", + "description": "Contoso 9D6816 Device", + "macAddress": "00:0A:95:9D:68:16", + "manufacturer": "Contoso", + "ipV4Address": "192.168.1.100", + "ipV6Address": "2001:db8::ff00:42:8329", + "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671", + "tags": [ + "Building A", + "Floor 3", + "Room 301", + "Conference Room" + ], + "sensors": [ + { + "sensorId": "Occupancy", + "displayName": null, + "sensorType": "occupancy", + "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671" + }, + { + "sensorId": "PeopleCount", + "displayName": null, + "sensorType": "peopleCount", + "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671" + } + ] + } + ] +} +``` + |
v1.0 | Workplace Post Sensordevices | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workplace-post-sensordevices.md | + + Title: "Create workplaceSensorDevice" +description: "Create a new workplace sensor device." ++ms.localizationpriority: medium +++# Create workplaceSensorDevice +Namespace: microsoft.graph +++Create a new workplace sensor device. +++## 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": "workplace_post_sensordevices" } --> ++For an app with delegated permissions to write workplace devices, the signed-in user must be a member of one of the following Microsoft Entra administrator roles: either Global Administrator or one of the Exchange Online management roles, specifically TenantPlacesManagement. ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /workplace/sensorDevices +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [workplaceSensorDevice](../resources/workplacesensordevice.md) object. ++You can specify the following properties when you create a **workplaceSensorDevice**. ++|Property|Type|Description| +|:|:|:| +|description|String|The description of the device. Optional.| +|deviceId|String|The user-defined unique identifier of the device provided at the time of creation. Required.| +|displayName|String|The display name of the device. Optional.| +|ipV4Address|String|The IPv4 address of the device. Optional.| +|ipV6Address|String|The IPv6 address of the device. Optional.| +|macAddress|String|The MAC address of the device. Optional.| +|manufacturer|String|The manufacturer of the device. Required.| +|placeId|String|The unique identifier of the place where the device is located. If the device is installed in a room equipped with a mailbox, this property should match the **ExternalDirectoryObjectId** or Microsoft Entra object ID of the room mailbox. Optional.| +|sensors|[workplaceSensor](../resources/workplacesensor.md) collection|A list of sensors associated with the device that collect and report data about physical or environmental conditions, such as occupancy, people count, inferred occupancy, temperature, and more. Required.| +|tags|String collection|A list of custom tags associated with the device. Supports `$filter`. Optional.| ++## Response ++If successful, this method returns a `201 Created` response code and a [workplaceSensorDevice](../resources/workplacesensordevice.md) object in the response body. ++## Examples ++### Request +The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_workplacesensordevice_from_" +} +--> +``` http +POST https://graph.microsoft.com/beta/workplace/sensorDevices +Content-Type: application/json ++{ + "deviceId": "contoso_9D6816", + "displayName": "Contoso 9D6816 Device", + "description": "Contoso 9D6816 Device", + "macAddress": "00:0A:95:9D:68:16", + "manufacturer": "Contoso", + "ipV4Address": "192.168.1.100", + "ipV6Address": "2001:db8::ff00:42:8329", + "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671", + "tags": [ + "Building A", + "Floor 3", + "Room 301", + "Conference Room" + ], + "sensors": [ + { + "sensorType": "occupancy" + }, + { + "sensorType": "peopleCount" + } + ] +} +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++++### Response +The following example shows the response. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.workplaceSensorDevice" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#workplace/sensorDevices/$entity", + "id": "ade7078f-4bf5-4239-bfde-95a7c4225df7", + "deviceId": "contoso_9D6816", + "displayName": "Contoso 9D6816 Device", + "description": "Contoso 9D6816 Device", + "macAddress": "00:0A:95:9D:68:16", + "manufacturer": "Contoso", + "ipV4Address": "192.168.1.100", + "ipV6Address": "2001:db8::ff00:42:8329", + "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671", + "tags": [ + "Building A", + "Floor 3", + "Room 301", + "Conference Room" + ], + "sensors": [ + { + "sensorId": "Occupancy", + "displayName": null, + "sensorType": "occupancy", + "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671" + }, + { + "sensorId": "PeopleCount", + "displayName": null, + "sensorType": "peopleCount", + "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671" + } + ] +} +``` |
v1.0 | Workplacesensordevice Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workplacesensordevice-delete.md | + + Title: "Delete workplaceSensorDevice" +description: "Delete a workplace sensor device." ++ms.localizationpriority: medium +++# Delete workplaceSensorDevice +Namespace: microsoft.graph +++Delete a workplace sensor device. +++## 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": "workplacesensordevice_delete" } --> ++For an app with delegated permissions to write workplace devices, the signed-in user must be a member of one of the following Microsoft Entra administrator roles: either Global Administrator or one of the Exchange Online management roles, specifically TenantPlacesManagement. ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /workplace/sensorDevices/{id} +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request +The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_workplacesensordevice" +} +--> +``` http +DELETE https://graph.microsoft.com/beta/workplace/sensorDevices/ade7078f-4bf5-4239-bfde-95a7c4225df7 +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++++### Response +The following example shows the response. +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Workplacesensordevice Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workplacesensordevice-get.md | + + Title: "Get workplaceSensorDevice" +description: "Get the properties of a workplace sensor device." ++ms.localizationpriority: medium +++# Get workplaceSensorDevice +Namespace: microsoft.graph +++Get the properties of a workplace sensor device, including tags, MAC address, sensors, and more. +++## 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": "workplacesensordevice_get" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /workplace/sensorDevices/{id} +``` ++## Optional query parameters +This method supports the `$select` [OData query parameter](/graph/query-parameters) to customize the response. ++## Request headers +| Name | Description | +| : | : | +| Authorization | Bearer {token}. Required. | ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [workplaceSensorDevice](../resources/workplacesensordevice.md) object in the response body. ++## Examples ++### Request +The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_workplacesensordevice" +} +--> +``` http +GET https://graph.microsoft.com/beta/workplace/sensorDevices/ade7078f-4bf5-4239-bfde-95a7c4225df7 +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++++### Response +The following example shows the response. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.workplaceSensorDevice" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#workplace/sensorDevices/$entity", + "id": "ade7078f-4bf5-4239-bfde-95a7c4225df7", + "deviceId": "contoso_9D6816", + "displayName": "Contoso 9D6816 Device", + "description": "Contoso 9D6816 Device", + "macAddress": "00:0A:95:9D:68:16", + "manufacturer": "Contoso", + "ipV4Address": "192.168.1.100", + "ipV6Address": "2001:db8::ff00:42:8329", + "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671", + "tags": [ + "Building A", + "Floor 3", + "Room 301", + "Conference Room" + ], + "sensors": [ + { + "sensorId": "Occupancy", + "displayName": null, + "sensorType": "occupancy", + "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671" + }, + { + "sensorId": "PeopleCount", + "displayName": null, + "sensorType": "peopleCount", + "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671" + } + ] +} +``` |
v1.0 | Workplacesensordevice Ingesttelemetry | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workplacesensordevice-ingesttelemetry.md | + + Title: "workplaceSensorDevice: ingestTelemetry" +description: "Ingest sensor telemetry for a workplace sensor device." ++ms.localizationpriority: medium +++# workplaceSensorDevice: ingestTelemetry +Namespace: microsoft.graph +++Ingest sensor telemetry for a workplace sensor device. +++## 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": "workplacesensordevice_ingesttelemetry" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /workplace/sensorDevices/ingestTelemetry +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the parameters. ++The **sensorId** property may be omitted within the [workplaceSensorDeviceTelemetry](../resources/workplacesensordevicetelemetry.md) object for devices with unique sensor types. When this property is omitted, the [sensorType](../resources/workplacesensor.md#workplacesensortype-values) value serves as the default identifier, consistent with the behavior when you create a device without a specified **sensorId**. ++The following table shows the parameters that you can use with this action. ++|Parameter|Type|Description| +|:|:|:| +|telemetry|[workplaceSensorDeviceTelemetry](../resources/workplacesensordevicetelemetry.md) collection|A collection of the telemetry data collected and reported by a sensor on a device, such as occupancy, people count, inferred occupancy, temperature, and more.| ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples +### Example 1: Send sensor telemetry for a device with unique sensor types ++The following example shows how to send sensor telemetry for a device with unique sensor types. ++#### Request +The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "workplacesensordevicethis.ingesttelemetry.unique.sensor.type" +} +--> +``` http +POST https://graph.microsoft.com/beta/workplace/sensorDevices/ingestTelemetry +Content-Type: application/json ++{ + "telemetry": [ + { + "deviceId": "contoso_9D6816", + "sensorType": "occupancy", + "boolValue": false, + "timestamp": "2021-03-31T09:36:05.144Z" + } + ] +} +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++++#### Response +The following example shows the response. +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` ++### Example 2: Send sensor telemetry for a device that has multiple sensors of the same type ++The following example shows how to send sensor telemetry for a device that has multiple sensors of the same type. ++#### Request +The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "workplacesensordevicethis.ingesttelemetry.same.sensor.type" +} +--> +``` http +POST https://graph.microsoft.com/beta/workplace/sensorDevices/ingestTelemetry +Content-Type: application/json ++{ + "telemetry": [ + { + "deviceId": "contoso_9D6816", + "sensorId": "occupancy_1", + "sensorType": "occupancy", + "boolValue": false, + "timestamp": "2021-03-31T09:36:05.144Z" + }, + { + "deviceId": "contoso_9D6816", + "sensorId": "occupancy_2", + "sensorType": "occupancy", + "boolValue": false, + "timestamp": "2021-03-31T09:36:05.144Z" + } + ] +} +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++++#### Response +The following example shows the response. +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` ++### Example 3: Ingest telemetry for multiple devices ++The following example shows how to ingest telemetry for multiple devices. ++#### Request +The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "workplacesensordevicethis.ingesttelemetry.multiple.devices" +} +--> +``` http +POST https://graph.microsoft.com/beta/workplace/sensorDevices/ingestTelemetry +Content-Type: application/json ++{ + "telemetry": [ + { + "deviceId": "contoso_9D6816", + "sensorType": "occupancy", + "boolValue": false, + "timestamp": "2021-03-31T09:36:05.144Z" + }, + { + "deviceId": "contoso_9D6817", + "sensorType": "occupancy", + "boolValue": false, + "timestamp": "2021-03-31T09:36:05.144Z" + } + ] +} +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++++#### Response +The following example shows the response. +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` |
v1.0 | Workplacesensordevice Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workplacesensordevice-update.md | + + Title: "Update workplaceSensorDevice" +description: "Update the properties of a workplace sensor device." ++ms.localizationpriority: medium +++# Update workplaceSensorDevice +Namespace: microsoft.graph +++Update the properties of a workplace sensor device. +++## 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": "workplacesensordevice_update" } --> ++For an app with delegated permissions to write workplace devices, the signed-in user must be a member of one of the following Microsoft Entra administrator roles: either Global Administrator or one of the Exchange Online management roles, specifically TenantPlacesManagement. ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /workplace/sensorDevices/{id} +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body ++In the request body, provide the entire JSON for the [workplaceSensorDevice](../resources/workplacesensordevice.md) object with updated fields. Partial updates aren't supported. If any optional property is excluded, it's set to null. To add new sensors, append a new sensor object to the existing sensor collection. If a sensor object is removed from the collection, it's deleted from the device. ++The following table specifies the properties that can be updated. ++|Property|Type|Description| +|:|:|:| +|description|String|The description of the device. Optional.| +|deviceId|String|The user-defined unique identifier of the device provided at the time of creation. Required. Read-only.| +|displayName|String|The display name of the device. Optional.| +|ipV4Address|String|The IPv4 address of the device. Optional.| +|ipV6Address|String|The IPv6 address of the device. Optional.| +|macAddress|String|The MAC address of the device. Optional.| +|manufacturer|String|The manufacturer of the device. Required.| +|placeId|String|The unique identifier of the place where the device is located. If the device is installed in a room equipped with a mailbox, this property should match the **ExternalDirectoryObjectId** or Microsoft Entra object ID of the room mailbox. Optional.| +|sensors|[workplaceSensor](../resources/workplacesensor.md) collection|A list of sensors associated with the device that collect and report data about physical or environmental conditions, such as occupancy, people count, inferred occupancy, temperature, and more. Required.| +|tags|String collection|A list of custom tags associated with the device. Supports `$filter`. Optional.| +++## Response ++If successful, this method returns a `200 OK` response code and an updated [workplaceSensorDevice](../resources/workplacesensordevice.md) object in the response body. ++## Examples +### Example 1: Add a new tag ++The following example shows how to add a new tag to a workplace sensor device. ++#### Request +The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_workplacesensordevice_tags" +} +--> +``` http +PATCH https://graph.microsoft.com/beta/workplace/sensorDevices/ade7078f-4bf5-4239-bfde-95a7c4225df7 +Content-Type: application/json ++{ + "deviceId": "contoso_9D6816", + "displayName": "Contoso 9D6816 Device", + "description": "Contoso 9D6816 Device", + "macAddress": "00:0A:95:9D:68:16", + "manufacturer": "Contoso", + "ipV4Address": "192.168.1.100", + "ipV6Address": "2001:db8::ff00:42:8329", + "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671", + "tags": [ + "Building A", + "Floor 3", + "Room 301", + "Conference Room", + "v1.0.7" + ], + "sensors": [ + { + "sensorType": "occupancy" + }, + { + "sensorType": "peopleCount" + } + ] +} +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++++#### Response +The following example shows the response. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.workplaceSensorDevice" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#workplace/sensorDevices/$entity", + "id": "ade7078f-4bf5-4239-bfde-95a7c4225df7", + "deviceId": "contoso_9D6816", + "displayName": "Contoso 9D6816 Device", + "description": "Contoso 9D6816 Device", + "macAddress": "00:0A:95:9D:68:16", + "manufacturer": "Contoso", + "ipV4Address": "192.168.1.100", + "ipV6Address": "2001:db8::ff00:42:8329", + "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671", + "tags": [ + "Building A", + "Floor 3", + "Room 301", + "Conference Room", + "v1.0.7" + ], + "sensors": [ + { + "sensorId": "Occupancy", + "displayName": null, + "sensorType": "occupancy", + "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671" + }, + { + "sensorId": "PeopleCount", + "displayName": null, + "sensorType": "peopleCount", + "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671" + } + ] +} +``` ++### Example 2: Add a new sensor ++The following example shows how to add a new sensor to a workplace sensor device. ++#### Request +The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_workplacesensordevice_new_sensor" +} +--> +``` http +PATCH https://graph.microsoft.com/beta/workplace/sensorDevices/ade7078f-4bf5-4239-bfde-95a7c4225df7 +Content-Type: application/json ++{ + "deviceId": "contoso_9D6816", + "displayName": "Contoso 9D6816 Device", + "description": "Contoso 9D6816 Device", + "macAddress": "00:0A:95:9D:68:16", + "manufacturer": "Contoso", + "ipV4Address": "192.168.1.100", + "ipV6Address": "2001:db8::ff00:42:8329", + "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671", + "tags": [ + "Building A", + "Floor 3", + "Room 301", + "Conference Room" + ], + "sensors": [ + { + "sensorType": "occupancy" + }, + { + "sensorType": "peopleCount" + }, + { + "sensorType": "inferredOccupancy" + } + ] +} +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++++#### Response +The following example shows the response. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.workplaceSensorDevice" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#workplace/sensorDevices/$entity", + "id": "ade7078f-4bf5-4239-bfde-95a7c4225df7", + "deviceId": "contoso_9D6816", + "displayName": "Contoso 9D6816 Device", + "description": "Contoso 9D6816 Device", + "macAddress": "00:0A:95:9D:68:16", + "manufacturer": "Contoso", + "ipV4Address": "192.168.1.100", + "ipV6Address": "2001:db8::ff00:42:8329", + "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671", + "tags": [ + "Building A", + "Floor 3", + "Room 301", + "Conference Room" + ], + "sensors": [ + { + "sensorId": "Occupancy", + "displayName": null, + "sensorType": "occupancy", + "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671" + }, + { + "sensorId": "PeopleCount", + "displayName": null, + "sensorType": "peopleCount", + "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671" + }, + { + "sensorId": "InferredOccupancy", + "displayName": null, + "sensorType": "inferredOccupancy", + "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671" + } + ] +} +``` ++### Example 3: Remove a sensor ++The following example shows how to remove a sensor from a workplace sensor device. ++#### Request +The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_workplacesensordevice_remove_sensor" +} +--> +``` http +PATCH https://graph.microsoft.com/beta/workplace/sensorDevices/ade7078f-4bf5-4239-bfde-95a7c4225df7 +Content-Type: application/json ++{ + "deviceId": "contoso_9D6816", + "displayName": "Contoso 9D6816 Device", + "description": "Contoso 9D6816 Device", + "macAddress": "00:0A:95:9D:68:16", + "manufacturer": "Contoso", + "ipV4Address": "192.168.1.100", + "ipV6Address": "2001:db8::ff00:42:8329", + "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671", + "tags": [ + "Building A", + "Floor 3", + "Room 301", + "Conference Room" + ], + "sensors": [ + { + "sensorType": "peopleCount" + } + ] +} +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++++#### Response +The following example shows the response. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.workplaceSensorDevice" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#workplace/sensorDevices/$entity", + "id": "ade7078f-4bf5-4239-bfde-95a7c4225df7", + "deviceId": "contoso_9D6816", + "displayName": "Contoso 9D6816 Device", + "description": "Contoso 9D6816 Device", + "macAddress": "00:0A:95:9D:68:16", + "manufacturer": "Contoso", + "ipV4Address": "192.168.1.100", + "ipV6Address": "2001:db8::ff00:42:8329", + "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671", + "tags": [ + "Building A", + "Floor 3", + "Room 301", + "Conference Room" + ], + "sensors": [ + { + "sensorId": "PeopleCount", + "displayName": null, + "sensorType": "peopleCount", + "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671" + } + ] +} +``` |
v1.0 | Aadsource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/aadsource.md | description: "Represents an authorization system identity sourced from Microsoft ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Accesspackage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accesspackage.md | To assign a user to an access package, [create an accessPackageAssignmentRequest ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Accesspackageassignmentrequestcallbackdata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accesspackageassignmentrequestcallbackdata.md | Inherits from [customExtensionData](../resources/customextensiondata.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.accessPackageAssignmentRequestCallbackData" |
v1.0 | Accesspackageassignmentresourcerole | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accesspackageassignmentresourcerole.md | Title: "accessPackageAssignmentResourceRole resource type" -description: "An access package assignment resource role indicates the resource-specific role that a subject has been assigned through an access package assignment." +description: "Indicates the resource-specific role that a subject is assigned through an access package assignment." ms.localizationpriority: medium Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -In [Microsoft Entra entitlement management](entitlementmanagement-overview.md), an access package assignment resource role indicates the resource-specific role that a subject has been assigned through an access package assignment. +In [Microsoft Entra entitlement management](entitlementmanagement-overview.md), an access package assignment resource role indicates the resource-specific role that a subject is assigned through an access package assignment. ## Methods In [Microsoft Entra entitlement management](entitlementmanagement-overview.md), |:-|:|:| |id|String| Read-only.| |originId|String|A unique identifier relative to the origin system, corresponding to the originId property of the [accessPackageResourceRole](accesspackageresourcerole.md). |-|originSystem|String|The system where the role assignment is to be created or has been created for an access package assignment, such as `SharePointOnline`, `AadGroup` or `AadApplication`, corresponding to the originSystem property of the [accessPackageResourceRole](accesspackageresourcerole.md).| -|status|String|The value is `PendingFulfillment` when the access package assignment hasn't yet been delivered to the origin system, and `Fulfilled` when the access package assignment has been delivered to the origin system.| +|originSystem|String|The system where the role assignment is to be created or has been created for an access package assignment, such as `SharePointOnline`, `AadGroup`, or `AadApplication`, corresponding to the originSystem property of the [accessPackageResourceRole](accesspackageresourcerole.md).| +|status|String|The value is `PendingFulfillment` before the access package assignment is delivered to the origin system, and `Fulfilled` after the access package assignment is delivered to the origin system.| ## Relationships In [Microsoft Entra entitlement management](entitlementmanagement-overview.md), ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Accesspackageassignmentworkflowextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accesspackageassignmentworkflowextension.md | Inherits from [customCalloutExtension](../resources/customcalloutextension.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Accesspackagelocalizedcontent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accesspackagelocalizedcontent.md | A complex type used to represent a text in multiple localized forms. It includes None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.accessPackageLocalizedContent" |
v1.0 | Accesspackageresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accesspackageresource.md | In [Microsoft Entra Entitlement Management](entitlementmanagement-overview.md), |displayName|String|The display name of the resource, such as the application name, group name, or site name.| |id|String| Read-only.| |isPendingOnboarding|Boolean|`True` if the resource is not yet available for assignment. Read-only. |-|originId|String|The unique identifier of the resource in the origin system. In the case of a Microsoft Entra group, originId is the identifier of the group. | -|originSystem|String|The type of the resource in the origin system, such as `SharePointOnline`, `AadApplication`, or `AadGroup`.| +|originId|String|The unique identifier of the resource in the origin system. In the case of a Microsoft Entra group, originId is the identifier of the group. Supports `$filter` (`eq`).| +|originSystem|String|The type of the resource in the origin system, such as `SharePointOnline`, `AadApplication`, or `AadGroup`. Supports `$filter` (`eq`).| |resourceType|String|The type of the resource, such as `Application` if it is a Microsoft Entra connected application, or `SharePoint Online Site` for a SharePoint Online site.| |url|String|A unique resource locator for the resource, such as the URL for signing a user into an application.| |
v1.0 | Accesspackageresourceattributesource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accesspackageresourceattributesource.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -An abstract type that exposes objects that define the properties the user configures with values that are passed to the end system or the request approver. It's used in the **attributeSource** property of an [accessPackageResourceAttribute](accesspackageresourceattribute.md). This type is inherited by [accessPackageResourceAttributeQuestion](../resources/accesspackageresourceattributequestion.md). +An abstract type that exposes objects that define the properties the user configures with values that are passed to the end system or the request approver. It's used in the **attributeSource** property of an [accessPackageResourceAttribute](accesspackageresourceattribute.md). This type is inherited by [accessPackageResourceAttributeQuestion](../resources/accesspackageresourceattributequestion.md). ## Properties None. None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.accessPackageResourceAttributeSource" |
v1.0 | Accesspackagesubject | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accesspackagesubject.md | In [Microsoft Entra entitlement management](entitlementmanagement-overview.md), ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Accesspackagetextinputquestion | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accesspackagetextinputquestion.md | Inherits from [accessPackageQuestion](../resources/accesspackagequestion.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.accessPackageTextInputQuestion" |
v1.0 | Accessreview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accessreview.md | Represents a Microsoft Entra [access review](accessreviews-root.md). |:-- |:- |:-- | | id | String | The feature-assigned unique identifier of an access review. | | displayName | String | The access review name. Required on create. |-| startDateTime | DateTimeOffset | The DateTime when the review is scheduled to be start. This could be a date in the future. Required on create. | -| endDateTime | DateTimeOffset | The DateTime when the review is scheduled to end. This must be at least one day later than the start date. Required on create. | +| startDateTime | DateTimeOffset | The date and time when the review is scheduled to be start. This date can be in the future. Required on create. | +| endDateTime | DateTimeOffset | The DateTime when the review is scheduled to end. This must be at least one day later than the start date. Required on create. | | status | String | This read-only field specifies the status of an accessReview. The typical states include `Initializing`, `NotStarted`, `Starting`,`InProgress`, `Completing`, `Completed`, `AutoReviewing`, and `AutoReviewed`. | | description | String | The description provided by the access review creator, to show to the reviewers. |-| businessFlowTemplateId | String | The business flow template identifier. Required on create. This value is case sensitive. | -| reviewerType | String | The relationship type of reviewer to the target object, one of `self`, `delegated` or `entityOwners`. Required on create. | +| businessFlowTemplateId | String | The business flow template identifier. Required on create. This value is case sensitive. | +| reviewerType | String | The relationship type of reviewer to the target object, one of: `self`, `delegated`, `entityOwners`. Required on create. | | createdBy | [userIdentity](useridentity.md) | The user who created this review. |-| reviewedEntity | [identity](identity.md) | The object for which the access reviews is reviewing the access rights assignments. This can be the group for the review of memberships of users in a group, or the app for a review of assignments of users to an application. Required on create. | +| reviewedEntity | [identity](identity.md) | The object for which the access review is reviewing the access rights assignments. This identity can be the group for the review of memberships of users in a group, or the app for a review of assignments of users to an application. Required on create. | | settings | [accessReviewSettings](accessreviewsettings.md) | The settings of an accessReview, see type definition below. | ## Relationships Represents a Microsoft Entra [access review](accessreviews-root.md). | reviewers | [userIdentity](useridentity.md) collection | The collection of reviewers for an access review, if access review reviewerType is of type `delegated`. | | decisions | [accessReviewDecision](accessreviewdecision.md) collection | The collection of decisions for this access review. | | myDecisions | [accessReviewDecision](accessreviewdecision.md) collection | The collection of decisions for the caller, if the caller is a reviewer. |-| instances | [accessReview](accessreview.md) collection | The collection of access reviews instances past, present and future, if this object is a recurring access review. | +| instances | [accessReview](accessreview.md) collection | The collection of access reviews instances past, present, and future, if this object is a recurring access review. | Whether these relationships are present on an object, depends upon whether the object is a one-time access review, the series of a recurring access review, or an instance of a recurring access review. Whether these relationships are present on an object, depends upon whether the o ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Accessreviewapplyaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accessreviewapplyaction.md | None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.accessReviewApplyAction" |
v1.0 | Accessreviewdecision | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accessreviewdecision.md | Namespace: microsoft.graph [!INCLUDE [accessreviews-disclaimer](../../includes/accessreviews-disclaimer.md)] -In the Microsoft Entra [access reviews](accessreviews-root.md) feature, the `accessReviewDecision` represents a Microsoft Entra access review decision of a particular entity's access. Within an access review, or an instance of a recurring access review, there's one `accessReviewDecision` per reviewed user. For example, if a group has two guests and one nonguest as members, and an access review of guests is performed for that group, then there will be two access review decision objects. If a reviewer changes their decision, or another reviewer overrides them, then the `accessReviewDecision` is updated. +In the Microsoft Entra [access reviews](accessreviews-root.md) feature, the `accessReviewDecision` represents a Microsoft Entra access review decision of a particular entity's access. Within an access review, or an instance of a recurring access review, there's one `accessReviewDecision` per reviewed user. For example, if a group has two guests and one nonguest as members, and an access review of guests is performed for that group, then there are two access review decision objects. If a reviewer changes their decision, or another reviewer overrides them, then the `accessReviewDecision` is updated. ## Methods -None. Objects of this type are automatically created by the feature when an access review initializes, and can't be deleted. They can be retrieved from an access review using the [decisions](../api/accessreview-listdecisions.md) and [mydecisions](../api/accessreview-listmydecisions.md) relationships. +None. Objects of this type are automatically created by the feature when an access review initializes, and can't be deleted. They can be retrieved from an access review using the [decisions](../api/accessreview-listdecisions.md) and [mydecisions](../api/accessreview-listmydecisions.md) relationships. ## Properties This table illustrates the base properties of objects of this type. | Property | Type | Description | | : | :-- | :-- |-| `id` |`String` | The ID of the decision within the access review. | -| `accessReviewId` |`String` | The feature-generated ID of the access review. | -| `reviewedBy` |[userIdentity](useridentity.md)| The identity of the reviewer. If the recommendation was used as the review, the userPrincipalName is empty. | -| `reviewedDate` |`DateTimeOffset` | The date and time the most recent review for this access right was supplied. | -| `reviewResult` |`String` | The result of the review, one of `NotReviewed`, `Deny`, `DontKnow` or `Approve`. | -| `justification` |`String` | The reviewer's business justification, if supplied. | -| `appliedBy` |[userIdentity](useridentity.md)| When the review completes, if the results were manually applied, the user identity of the user who applied the decision. If the review was autoapplied, the userPrincipalName is empty. | -| `appliedDateTime` |`DateTimeOffset` | The date and time when the review decision was applied. | -| `applyResult` |`String` | The outcome of applying the decision, one of `NotApplied`, `Success`, `Failed`, `NotFound` or `NotSupported`. | -| `accessRecommendation` |`String` | The feature- generated recommendation shown to the reviewer, one of `Approve`, `Deny` or `NotAvailable`. | +| `id` |`String` | The ID of the decision within the access review. | +| `accessReviewId` |`String` | The feature-generated ID of the access review. | +| `reviewedBy` |[userIdentity](useridentity.md)| The identity of the reviewer. If the recommendation was used as the review, the userPrincipalName is empty. | +| `reviewedDate` |`DateTimeOffset` | The date and time the most recent review for this access right was supplied. | +| `reviewResult` |`String` | The result of the review, one of `NotReviewed`, `Deny`, `DontKnow` or `Approve`. | +| `justification` |`String` | The reviewer's business justification, if supplied. | +| `appliedBy` |[userIdentity](useridentity.md)| When the review completes, if the results were manually applied, the user identity of the user who applied the decision. If the review was autoapplied, the userPrincipalName is empty. | +| `appliedDateTime` |`DateTimeOffset` | The date and time when the review decision was applied. | +| `applyResult` |`String` | The outcome of applying the decision, one of: `NotApplied`, `Success`, `Failed`, `NotFound`, `NotSupported`. | +| `accessRecommendation` |`String` | The feature- generated recommendation shown to the reviewer, one of: `Approve`, `Deny`, `NotAvailable`. | -In addition, more properties may be present depending on the object type of the object possessing the access that was decided upon. For example, if the access review decision is a particular user's group membership or application access, the user who is potentially going to have their access be removed is identified through these properties: +In addition, more properties can be present depending on the object type of the object possessing the access that was decided upon. For example, if the access review decision is a particular user's group membership or application access, the user who is potentially going to have their access be removed is identified through these properties: | Property | Type | Description | | : | :-- | :-- |-| `userId` |`String` | The ID of user whose access was reviewed. | -| `userDisplayName` |`String` | The display name of the user whose access was reviewed. | -| `userPrincipalName` |`String` | The user principal name of the user whose access was reviewed. | +| `userId` |`String` | The ID of user whose access was reviewed. | +| `userDisplayName` |`String` | The display name of the user whose access was reviewed. | +| `userPrincipalName` |`String` | The user principal name of the user whose access was reviewed. | ## Relationships -None. Objects of this type can be retrieved from an access review using the [decisions](../api/accessreview-listdecisions.md) and [mydecisions](../api/accessreview-listmydecisions.md) relationships of the [accessReview](accessreview.md) object. +None. Objects of this type can be retrieved from an access review using the [decisions](../api/accessreview-listdecisions.md) and [mydecisions](../api/accessreview-listmydecisions.md) relationships of the [accessReview](accessreview.md) object. ## Related content None. Objects of this type can be retrieved from an access review using the [de ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Accessreviewhistorydefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accessreviewhistorydefinition.md | An **accessReviewHistoryDefinition** contains a list of [accessReviewHistoryInst ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Accessreviewhistoryinstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accessreviewhistoryinstance.md | Namespace: microsoft.graph ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Accessreviewhistoryschedulesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accessreviewhistoryschedulesettings.md | Defines the settings of an [accessReviewHistoryDefinition](accessreviewhistoryde ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.accessReviewHistoryScheduleSettings" |
v1.0 | Accessreviewinstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accessreviewinstance.md | Every **accessReviewInstance** contains a list of [decisions](accessreviewinstan ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Accessreviewnotificationrecipientitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accessreviewnotificationrecipientitem.md | None. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Accessreviewnotificationrecipientscope | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accessreviewnotificationrecipientscope.md | Title: "accessreviewnotificationrecipientscope resource type" + Title: "accessReviewNotificationRecipientScope resource type" description: "Represents who will receive access review notifications." ms.localizationpriority: medium-# accessreviewnotificationrecipientscope resource type +# accessReviewNotificationRecipientScope resource type Namespace: microsoft.graph None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.accessReviewNotificationRecipientScope" |
v1.0 | Accessreviewscheduledefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accessreviewscheduledefinition.md | An accessReviewScheduleDefinition contains a list of [accessReviewInstance](acce | `instances` |[accessReviewInstance](accessreviewinstance.md) collection | If the `accessReviewScheduleDefinition` is a recurring access review, instances represent each recurrence. A review that doesn't recur will have exactly one instance. Instances also represent each unique resource under review in the `accessReviewScheduleDefinition`. If a review has multiple resources and multiple instances, each resource has a unique instance for each recurrence. | ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Accessreviewstagesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accessreviewstagesettings.md | Represents the settings of the stages associated with a [multi-stage access revi |stageId|String|Unique identifier of the **accessReviewStageSettings**. The **stageId** is used in **dependsOn** property to indicate the stage relationship. Required. | ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.accessReviewStageSettings" |
v1.0 | Accountswithaccess | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accountswithaccess.md | description: "Contains information on external AWS accounts that have access to ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Actionsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/actionsummary.md | description: "Contains information on the number of authorization system actions ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Activeusersbreakdownmetric | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/activeusersbreakdownmetric.md | - Title: "activeUsersBreakdownMetric resource type (deprecated)" -description: "Represents breakdown insights of daily and monthly user activity on apps registered in your tenant that is configured for Microsoft Entra External ID for customers." ---doc_type: resourcePageType ---# activeUsersBreakdownMetric resource type (deprecated) --Namespace: microsoft.graph ---> [!CAUTION] -> The `activeUsersBreakdown` resource type and its associated methods is deprecated and will stop returning data on March 9, 2024. Use the [activeUsersMetric](../resources/activeusersmetric.md) resource and its associated methods instead. --Represents breakdown insights of daily and monthly user activity on apps registered in your tenant that is configured for Microsoft Entra External ID for customers. --Inherits from [entity](../resources/entity.md). --## Methods -|Method|Return type|Description| -|:|:|:| -|[List daily activeUsersBreakdown](../api/dailyuserinsightmetricsroot-list-activeusersbreakdown.md)|[activeUsersBreakdownMetric](../resources/activeusersbreakdownmetric.md) collection|Get a list of daily [activeUsersBreakdown](../resources/activeusersbreakdownmetric.md) objects on apps registered in your tenant configured for Microsoft Entra External ID for customers.| -|[List monthly activeUsersBreakdown](../api/monthlyuserinsightmetricsroot-list-activeusersbreakdown.md)|[activeUsersBreakdownMetric](../resources/activeusersbreakdownmetric.md) collection|Get a list of monthly [activeUsersBreakdown](../resources/activeusersbreakdownmetric.md) objects on apps registered in your tenant configured for Microsoft Entra External ID for customers.| --## Properties -|Property|Type|Description| -|:|:|:| -|appId|String|The ID of the Microsoft Entra application.| -|appName| String|Name of the application users authenticated to.| -|count| Int64|The total number of users who made at least one authentication request within the specified time period.| -|factDate|Date| The date of the insight.| -|id|String|Unique identifier for the **activeUsersBreakdownMetric** object. Inherited from [entity](../resources/entity.md).| -|os| String|The platform for the device that the customers used. Supports `$filter` (`eq`).| --## Relationships -None. --## JSON representation -The following JSON representation shows the resource type. -<!-- { - "blockType": "resource", - "keyProperty": "id", - "@odata.type": "microsoft.graph.activeUsersBreakdownMetric", - "openType": false -} >-``` json -{ - "@odata.type": "#microsoft.graph.activeUsersBreakdownMetric", - "appId": "String", - "appName": "String", - "count": "Int64", - "factDate": "String (date)", - "id": "String (identifier)", - "os": "String" -} -``` - |
v1.0 | Activitybasedtimeoutpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/activitybasedtimeoutpolicy.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Addin | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/addin.md | Title: "addIn resource type" -description: "Here's a JSON representation of the resource." +description: "Represents a custom behavior that a consuming service can use to call an app in specific contexts." ms.localizationpriority: medium doc_type: resourcePageType Defines custom behavior that a consuming service can use to call an app in speci ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Administrativeunit | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/administrativeunit.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -An administrative unit provides a conceptual container for user, group, and device directory objects. Using administrative units, a company administrator can now delegate administrative responsibilities to manage the users, groups, and devices contained within or scoped to an administrative unit to a regional or departmental administrator. This resource is an open type that allows other properties to be passed in. +An administrative unit provides a conceptual container for user, group, and device directory objects. With administrative units, a company administrator can now delegate administrative responsibilities to manage the users, groups, and devices contained within or scoped to an administrative unit to a regional or departmental administrator. For more information about administrative units, see [Administrative units in Microsoft Entra ID](/entra/identity/role-based-access-control/administrative-units). -This resource supports using [delta query](/graph/delta-query-overview) to track incremental additions, deletions, and updates, by providing a [delta](../api/administrativeunit-delta.md) function. --Let's look at an example. Imagine that Contoso Corp is made up of two divisions - a West Coast Division and an East Coast Division. Directory roles at Contoso are scoped to the entire tenant. Lee, a Contoso company administrator, wants to delegate administrative responsibilities, but scope them to the West Coast Division or the East Coast division. Lee can create a *West Coast administrative unit* and place all West Coast users into this administrative unit. Similarly, Lee can create an *East Coast administrative unit*. Now Lee, can start delegating administrative responsibilities to others, but **scoped** to the new administrative units he's created. Lee places Jennifer in a *helpdesk administrator* role **scoped** to the *West Coast administrative unit*. This allows Jennifer to reset any user's password, but only if those users are in the *West Coast administrative unit*. Similarly, Lee places Dave in a *user account administrator* role **scoped** to the *East Coast administrative unit*. This allows Dave to update users, assign licenses and reset any user's password, but only if those users are in the *East Coast administrative unit*. For a video overview, please see [Introduction to Microsoft Entra Administrative Units](https://channel9.msdn.com/Series/Windows-Azure-Active-Directory/Introduction-to-Azure-Active-Directory-Administrative-Units). +This resource is an open type that allows other properties to be passed in. This resource supports: - Adding your own data to custom properties as [extensions](/graph/extensibility-overview). - Using [delta query](/graph/delta-query-overview) to track incremental additions, deletions, and updates, by providing a [delta](../api/user-delta.md) function. - ## Methods -| Method | Return Type | Description | +| Method | Return Type | Description | |:|:--|:-| |[Create](../api/directory-post-administrativeunits.md) | [administrativeUnit](administrativeunit.md) | Create a new administrative unit.| |[List](../api/directory-list-administrativeunits.md) | [administrativeUnit](administrativeunit.md) collection |List properties of all administrativeUnits.| |[Get](../api/administrativeunit-get.md) | [administrativeUnit](administrativeunit.md) |Read properties and relationships of a specific administrativeUnit object.|-|[Update](../api/administrativeunit-update.md) | [administrativeUnit](administrativeunit.md) |Update administrativeUnit object. | +|[Update](../api/administrativeunit-update.md) | [administrativeUnit](administrativeunit.md) |Update administrativeUnit object. | |[Delete](../api/administrativeunit-delete.md) | None |Delete administrativeUnit object. | |[Get delta](../api/administrativeunit-delta.md)|[administrativeUnit](administrativeunit.md)|Get newly created, updated, or deleted **administrativeUnits** without having to perform a full read of the entire resource collection.| |[Add a member](../api/administrativeunit-post-members.md) |[directoryObject](directoryobject.md)| Add a member (user or group).| This resource supports: > [!IMPORTANT] > Specific usage of `$filter` and the `$search` query parameter is supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on directory objects](/graph/aad-advanced-queries#administrative-unit-properties). -| Property | Type |Description| +| Property. | Type |Description| |:|:--|:-| |description|String|An optional description for the administrative unit. Supports `$filter` (`eq`, `ne`, `in`, `startsWith`), `$search`.| |displayName|String|Display name for the administrative unit. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values), `$search`, and `$orderby`.| This resource supports: > Directory extensions and associated data are returned by default while schema extensions and associated data returned only on `$select`. ## Relationships-| Relationship | Type |Description| +| Relationship | Type |Description| |:|:--|:-| |extensions|[extension](extension.md) collection|The collection of open extensions defined for this administrative unit. Nullable.| |members|[directoryObject](directoryobject.md) collection|Users and groups that are members of this administrative unit. Supports `$expand`.| This resource supports: ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Agreementfile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/agreementfile.md | Inherits from [agreementFileProperties](agreementfileproperties.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Agreementfilelocalization | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/agreementfilelocalization.md | Inherits from [agreementFileProperties](agreementfileproperties.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Agreementfileproperties | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/agreementfileproperties.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Agreementfileversion | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/agreementfileversion.md | Inherits from [agreementFileProperties](agreementfileproperties.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Alert | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/alert.md | Title: "alert resource type" + Title: "alert resource type (deprecated)" description: "Represents potential security issues within a customer's tenant that Microsoft or partner security solutions have identified." ms.localizationpriority: medium -# alert resource type +# alert resource type (deprecated) Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -This resource corresponds to the first generation of alerts in the Microsoft Graph security API, representing potential security issues within a customer's tenant that Microsoft or a partner security solution has identified. +> [!NOTE] +> The legacy alerts API is deprecated and will be removed by April 2026. We recommend that you migrate to the new [alerts and incidents](/graph/api/resources/security-alert) API. ++This resource corresponds to the first generation of alerts in the Microsoft Graph security API, representing potential security issues within a customer's tenant that Microsoft or a partner security solution identifies. This type of alerts federates calling of supported Azure and Microsoft 365 Defender security providers listed in [Use the Microsoft Graph security API](security-api-overview.md#legacy-alerts). It aggregates common alert data among the different domains to allow applications to unify and streamline management of security issues across all integrated solutions. To learn more, see the sample queries in [Graph Explorer](https://developer.micr |assignedTo|String|Name of the analyst the alert is assigned to for triage, investigation, or remediation (supports [update](../api/alert-update.md)).| |azureSubscriptionId|String|Azure subscription ID, present if this alert is related to an Azure resource.| |azureTenantId |String|Microsoft Entra tenant ID. Required. |-|category|String|Category of the alert (for example, credentialTheft, ransomware, etc.).| +|category|String|Category of the alert (for example, credentialTheft, ransomware).| |closedDateTime|DateTimeOffset|Time at which the alert was closed. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z` (supports [update](../api/alert-update.md)).| |cloudAppStates|[cloudAppSecurityState](cloudappsecuritystate.md) collection|Security-related stateful information generated by the provider about the cloud application/s related to this alert.| |comments|String collection|Customer-provided comments on alert (for customer alert management) (supports [update](../api/alert-update.md)).| To learn more, see the sample queries in [Graph Explorer](https://developer.micr |createdDateTime |DateTimeOffset|Time at which the alert was created by the alert provider. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Required.| |description|String|Alert description.| |detectionIds|String collection|Set of alerts related to this alert entity (each alert is pushed to the SIEM as a separate record).|-|eventDateTime |DateTimeOffset|Time at which the event(s) that served as the trigger(s) to generate the alert occurred. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Required.| -|feedback|alertFeedback|Analyst feedback on the alert. Possible values are: `unknown`, `truePositive`, `falsePositive`, `benignPositive`. (supports [update](../api/alert-update.md))| +|eventDateTime |DateTimeOffset|Time at which the event or events that served as the trigger to generate the alert occurred. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Required.| +|feedback|alertFeedback|Analyst feedback on the alert. Possible values are: `unknown`, `truePositive`, `falsePositive`, `benignPositive`. Supports [update](../api/alert-update.md).| |fileStates|[fileSecurityState](filesecuritystate.md) collection|Security-related stateful information generated by the provider about the file(s) related to this alert.| |historyStates|[alertHistoryState](alerthistorystate.md) collection| A collection of **alertHistoryStates** comprising an audit log of all updates made to an alert. | |hostStates|[hostSecurityState](hostsecuritystate.md) collection|Security-related stateful information generated by the provider about the host(s) related to this alert.| To learn more, see the sample queries in [Graph Explorer](https://developer.micr |registryKeyStates|[registryKeyState](registrykeystate.md) collection|Security-related stateful information generated by the provider about the registry keys related to this alert.| |securityResources|[securityResource](securityResource.md) collection|Resources related to current alert. For example, for some alerts this can have the Azure Resource value.| |severity |alertSeverity|Alert severity - set by vendor/provider. Possible values are: `unknown`, `informational`, `low`, `medium`, `high`. Required.|-|sourceMaterials|String collection|Hyperlinks (URIs) to the source material related to the alert, for example, provider's user interface for alerts or log search, etc.| +|sourceMaterials|String collection|Hyperlinks (URIs) to the source material related to the alert, for example, provider's user interface for alerts or log search.| |status |alertStatus|Alert lifecycle status (stage). Possible values are: `unknown`, `newAlert`, `inProgress`, `resolved`. (supports [update](../api/alert-update.md)). Required.|-|tags|String collection|User-definable labels that can be applied to an alert and can serve as filter conditions (for example "HVA", "SAW", etc.) (supports [update](../api/alert-update.md)).| +|tags|String collection|User-definable labels that can be applied to an alert and can serve as filter conditions (for example "HVA", "SAW") (supports [update](../api/alert-update.md)).| |title |String|Alert title. Required.| |triggers|[alertTrigger](alerttrigger.md) collection|Security-related information about the specific properties that triggered the alert (properties appearing in the alert). Alerts might contain information about multiple users, hosts, files, ip addresses. This field indicates which properties triggered the alert generation.| |userStates|[userSecurityState](usersecuritystate.md) collection|Security-related stateful information generated by the provider about the user accounts related to this alert.| None. ## JSON representation -The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Allaccountswithaccess | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/allaccountswithaccess.md | description: "Contains information on all external AWS accounts that have access ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Allinboundports | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/allinboundports.md | description: "Allows incoming traffic from all ports." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Allowedvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/allowedvalue.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Anonymousguestconversationmember | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/anonymousguestconversationmember.md | Inherits from [conversationMember](../resources/conversationmember.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Apiapplication | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/apiapplication.md | Specifies settings for an application that implements a web API. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Appidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/appidentity.md | Title: "appIdentity resource type" -description: "Indicates the identity of the application that performed the action or was changed. Includes Application Id, Name, Service Principal ID and Name. This resource is called by the directoryAudit API" +description: "Indicates the identity of the application that performed the action or was changed. This resource is called by the directoryAudit API." ms.localizationpriority: medium doc_type: resourcePageType -Indicates the identity of the application that performed the action or was changed. This resource is called by the [directoryAudit](../api/directoryaudit-get.md) API. +Indicates the identity of the application that performed the action or was changed. Includes the IDs and names for the service principal and application. This resource is called by the [directoryAudit](../api/directoryaudit-get.md) API. ## Properties | Property | Type |Description| |:|:--|:-|-|appId|String|Refers to the unique identifier representing Application Id in the Microsoft Entra ID.| +|appId|String|Refers to the unique identifier representing application ID in the Microsoft Entra ID.| |displayName|String|Refers to the application name displayed in the Microsoft Entra admin center.|-|servicePrincipalId|String|Refers to the unique identifier indicating Service Principal Id in Microsoft Entra ID for the corresponding App.| +|servicePrincipalId|String|Refers to the unique identifier indicating service principal ID in Microsoft Entra ID for the corresponding App.| |servicePrincipalName|String|Refers to the Service Principal Name is the Application name in the tenant. | ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Applemanagedidentityprovider | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/applemanagedidentityprovider.md | Retrieve the **developerId**, **serviceId**, **keyId**, and the **certificateDat ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Application | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/application.md | This resource supports: |[Remove password](../api/application-removepassword.md)|[passwordCredential](passwordcredential.md)|Remove a password or secret from an application.| |[Add key](../api/application-addkey.md)|[keyCredential](keycredential.md)|Add a key credential to an application.| |[Remove key](../api/application-removekey.md)|None|Remove a key credential from an application.|-|**Extensions**| | | -| [List extensionProperties](../api/application-list-extensionproperty.md) | [extensionProperty](extensionProperty.md) collection | List extension properties on an application object. | -| [Create extensionProperties](../api/application-post-extensionproperty.md) | [extensionProperty](extensionProperty.md) | Create an extension property on an application object. | -| [Get extensionProperty](../api/extensionproperty-delete.md) | None | Get an extension property from an application object. | -| [Delete extensionProperty](../api/extensionproperty-delete.md) | None | Delete an extension property from an application object. | -|**Federated identity credentials**| | | -| [List federatedIdentityCredential](../api/application-list-federatedidentitycredentials.md) | [federatedIdentityCredential](../resources/federatedidentitycredential.md) collection | List federated identity credentials on an application object. | -| [Create federatedIdentityCredential](../api/application-post-federatedidentitycredentials.md) | [federatedIdentityCredential](../resources/federatedidentitycredential.md) | Create a federated identity credential on an application object. | -| [Get federatedIdentityCredential](../api/federatedidentitycredential-get.md) | [federatedIdentityCredential](../resources/federatedidentitycredential.md) | Retrieve the properties of a federated identity credential. | -| [Update federatedIdentityCredential](../api/federatedidentitycredential-update.md) | None | Update a federated identity credential of an application object. | -| [Delete federatedIdentityCredential](../api/federatedidentitycredential-delete.md) | None | Delete a federated identity credential from an application object. | |**Owners**| | | |[List owners](../api/application-list-owners.md) |[directoryObject](directoryobject.md) collection| Get the owners of an application. | |[Add owner](../api/application-post-owners.md) |[directoryObject](directoryobject.md)| Assign an owner to an application. Application owners can be users or service principals. | |[Remove owner](../api/application-delete-owners.md) |None| Remove an owner from an application. As a recommended best practice, apps should have at least two owners.|-|**Policies**| | | -|[Assign tokenIssuancePolicy](../api/application-post-tokenissuancepolicies.md)| [tokenIssuancePolicy](tokenissuancepolicy.md) collection| Assign a tokenIssuancePolicy to this object.| -|[List tokenIssuancePolicies](../api/application-list-tokenissuancepolicies.md)| [tokenIssuancePolicy](tokenissuancepolicy.md) collection| Get all tokenIssuancePolicies assigned to this object.| -|[Remove tokenIssuancePolicy](../api/application-delete-tokenissuancepolicies.md)| [tokenIssuancePolicy](tokenissuancepolicy.md) collection| Remove a tokenIssuancePolicy from this object.| -|[Assign tokenLifetimePolicy](../api/application-post-tokenlifetimepolicies.md)| [tokenLifetimePolicy](tokenlifetimepolicy.md) collection| Assign a tokenLifetimePolicy to this object.| -|[List tokenLifetimePolicies](../api/application-list-tokenlifetimepolicies.md)| [tokenLifetimePolicy](tokenlifetimepolicy.md) collection| Get all tokenLifetimePolicies assigned to this object.| -|[Remove tokenLifetimePolicy](../api/application-delete-tokenlifetimepolicies.md)| [tokenLifetimePolicy](tokenlifetimepolicy.md) collection| Remove a tokenLifetimePolicy from this object.| |**Verified publisher**| | | |[Set verified publisher](../api/application-setverifiedpublisher.md)| None | Set the verified publisher of an application.| |[Unset verified publisher](../api/application-unsetverifiedpublisher.md)| None | Unset the verified publisher of an application.| This resource supports: | displayName | String | The display name for the application. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values), `$search`, and `$orderby`. | | groupMembershipClaims | String | Configures the `groups` claim issued in a user or OAuth 2.0 access token that the application expects. To set this attribute, use one of the following string values: `None`, `SecurityGroup` (for security groups and Microsoft Entra roles), `All` (this gets all security groups, distribution groups, and Microsoft Entra directory roles that the signed-in user is a member of). | | id | String | Unique identifier for the application object. This property is referred to as **Object ID** in the Microsoft Entra admin center. Inherited from [directoryObject](directoryobject.md). Key. Not nullable. Read-only. Supports `$filter` (`eq`, `ne`, `not`, `in`). |-| identifierUris | String collection | Also known as App ID URI, this value is set when an application is used as a resource app. The identifierUris acts as the prefix for the scopes you reference in your API's code, and it must be globally unique. You can use the default value provided, which is in the form `api://<application-client-id>`, or specify a more readable URI like `https://contoso.com/api`. For more information on valid identifierUris patterns and best practices, see [Microsoft Entra application registration security best practices](/azure/active-directory/develop/security-best-practices-for-app-registration#appid-uri-configuration). Not nullable. <br><br>Supports `$filter` (`eq`, `ne`, `ge`, `le`, `startsWith`). | +| identifierUris | String collection | Also known as App ID URI, this value is set when an application is used as a resource app. The identifierUris acts as the prefix for the scopes you reference in your API's code, and it must be globally unique. You can use the default value provided, which is in the form `api://<appId>`, or specify a more readable URI like `https://contoso.com/api`. For more information on valid identifierUris patterns and best practices, see [Microsoft Entra application registration security best practices](/azure/active-directory/develop/security-best-practices-for-app-registration#appid-uri-configuration). Not nullable. <br><br>Supports `$filter` (`eq`, `ne`, `ge`, `le`, `startsWith`). | | info | [informationalUrl](informationalurl.md) | Basic profile information of the application, such as it's marketing, support, terms of service, and privacy statement URLs. The terms of service and privacy statement are surfaced to users through the user consent experience. For more information, see [How to: Add Terms of service and privacy statement for registered Microsoft Entra apps](/azure/active-directory/develop/howto-add-terms-of-service-privacy-statement). <br><br>Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, and `eq` on `null` values). | | isDeviceOnlyAuthSupported | Boolean | Specifies whether this application supports device authentication without a user. The default is `false`. | | isFallbackPublicClient | Boolean | Specifies the fallback application type as public client, such as an installed application running on a mobile device. The default value is `false`, which means the fallback application type is confidential client such as a web app. There are certain scenarios where Microsoft Entra ID can't determine the client application type. For example, the [ROPC](https://tools.ietf.org/html/rfc6749#section-4.3) flow where the application is configured without specifying a redirect URI. In those cases Microsoft Entra ID interprets the application type based on the value of this property.| This resource supports: | requiredResourceAccess |[requiredResourceAccess](requiredresourceaccess.md) collection| Specifies the resources that the application needs to access. This property also specifies the set of delegated permissions and application roles that it needs for each of those resources. This configuration of access to the required resources drives the consent experience. <br/><br/>No more than 50 resource services (APIs) can be configured. Beginning mid-October 2021, the total number of required permissions must not exceed 400. For more information, see [Limits on requested permissions per app](#limits-on-requested-permissions-per-app). Not nullable. <br><br>Supports `$filter` (`eq`, `not`, `ge`, `le`).| | samlMetadataUrl | String | The URL where the service exposes SAML metadata for federation. This property is valid only for single-tenant applications. Nullable. | | serviceManagementReference | String | References application or service contact information from a Service or Asset Management database. Nullable. |-| signInAudience | String | Specifies the Microsoft accounts that are supported for the current application. The possible values are: `AzureADMyOrg`, `AzureADMultipleOrgs`, `AzureADandPersonalMicrosoftAccount` (default), and `PersonalMicrosoftAccount`. See more in the [table](#signinaudience-values). <br/><br/>The value of this object also limits the number of permissions an app can request. For more information, see [Limits on requested permissions per app](#limits-on-requested-permissions-per-app). <br><br>The value for this property has implications on other app object properties. As a result, if you change this property, you may need to change other properties first. For more information, see [Validation differences for signInAudience](/azure/active-directory/develop/supported-accounts-validation?context=graph/context).<br><br>Supports `$filter` (`eq`, `ne`, `not`).| +| signInAudience | String | Specifies the Microsoft accounts that are supported for the current application. The possible values are: `AzureADMyOrg` (default), `AzureADMultipleOrgs`, `AzureADandPersonalMicrosoftAccount`, and `PersonalMicrosoftAccount`. See more in the [table](#signinaudience-values). <br/><br/>The value of this object also limits the number of permissions an app can request. For more information, see [Limits on requested permissions per app](#limits-on-requested-permissions-per-app). <br><br>The value for this property has implications on other app object properties. As a result, if you change this property, you may need to change other properties first. For more information, see [Validation differences for signInAudience](/azure/active-directory/develop/supported-accounts-validation?context=graph/context).<br><br>Supports `$filter` (`eq`, `ne`, `not`).| | servicePrincipalLockConfiguration | [servicePrincipalLockConfiguration](servicePrincipalLockConfiguration.md) | Specifies whether sensitive properties of a multitenant application should be locked for editing after the application is provisioned in a tenant. Nullable. `null` by default. | | spa | [spaApplication](../resources/spaapplication.md) | Specifies settings for a single-page application, including sign out URLs and redirect URIs for authorization codes and access tokens. | | tags |String collection| Custom strings that can be used to categorize and identify the application. Not nullable. Strings added here also appear in the **tags** property of any associated [service principals](serviceprincipal.md).<br><br>Supports `$filter` (`eq`, `not`, `ge`, `le`, `startsWith`) and `$search`.| | tokenEncryptionKeyId |Guid|Specifies the keyId of a public key from the keyCredentials collection. When configured, Microsoft Entra ID encrypts all the tokens it emits by using the key this property points to. The application code that receives the encrypted token must use the matching private key to decrypt the token before it can be used for the signed-in user.|-| verifiedPublisher | [verifiedPublisher](verifiedPublisher.md) | Specifies the verified publisher of the application. For more information about how publisher verification helps support application security, trustworthiness, and compliance, see [Publisher verification](/azure/active-directory/develop/publisher-verification-overview).| | uniqueName | String | The unique identifier that can be assigned to an application and used as an alternate key. Immutable. Read-only. |+| verifiedPublisher | [verifiedPublisher](verifiedPublisher.md) | Specifies the verified publisher of the application. For more information about how publisher verification helps support application security, trustworthiness, and compliance, see [Publisher verification](/azure/active-directory/develop/publisher-verification-overview).| | web |[webApplication](webapplication.md)| Specifies settings for a web application. | | windows |[windowsApplication](windowsapplication.md)| Specifies settings for apps running Microsoft Windows and published in the Microsoft Store or Xbox games store.| This resource supports: | Value | Description | |:|:--|-|AzureADMyOrg|Users with a Microsoft work or school account in my organization's Microsoft Entra tenant (single-tenant).| +|AzureADMyOrg|Users with a Microsoft work or school account in my organization's Microsoft Entra tenant (single-tenant). This is the default value for the **signInAudience** property.| |AzureADMultipleOrgs|Users with a Microsoft work or school account in any organization's Microsoft Entra tenant (multitenant).|-|AzureADandPersonalMicrosoftAccount|Users with a personal Microsoft account, or a work or school account in any organization's Microsoft Entra tenant. For authenticating users with Azure AD B2C user flows, use `AzureADandPersonalMicrosoftAccount`. This value allows for the widest set of user identities including local accounts and user identities from Microsoft, Facebook, Google, Twitter, or any OpenID Connect provider. This is the default value for the **signInAudience** property.| +|AzureADandPersonalMicrosoftAccount|Users with a personal Microsoft account, or a work or school account in any organization's Microsoft Entra tenant. For authenticating users with Azure AD B2C user flows, use `AzureADandPersonalMicrosoftAccount`. This value allows for the widest set of user identities including local accounts and user identities from Microsoft, Facebook, Google, Twitter, or any OpenID Connect provider. | |PersonalMicrosoftAccount|Users with a personal Microsoft account only.| ### Limits on requested permissions per app |
v1.0 | Applicationauthenticationmethodpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/applicationauthenticationmethodpolicy.md | Depending on whether your app is a single tenant or multitenant app, you apply t ## Requirements -- Management of application authentication method policies can be performed by a global administrator, application administrator, or cloud application administrator.+- The least privileged [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) for management of application authentication method policies are Application Administrator and Cloud Application Administrator. - All app policy management operations require a [Microsoft Entra Workload ID Premium license](/azure/active-directory/workload-identities/workload-identities-faqs#what-is-the-cost-of-workload-identities-premium-plan). ## Next steps |
v1.0 | Applicationenforcedrestrictionssessioncontrol | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/applicationenforcedrestrictionssessioncontrol.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Applications Api Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/applications-api-overview.md | description: "Learn how to manage the lifecycle and settings for Microsoft Entra Last updated : 04/05/2024 ms.localizationpriority: medium |
v1.0 | Applicationsegment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/applicationsegment.md | This resource type is an abstract type that exposes properties used to configure ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.applicationSegment" |
v1.0 | Appliedauthenticationeventlistener | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/appliedauthenticationeventlistener.md | Represents the [authentication event listeners](authenticationeventlistener.md) None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.appliedAuthenticationEventListener" |
v1.0 | Appliedconditionalaccesspolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/appliedconditionalaccesspolicy.md | Indicates the attributes related to applied conditional access policy or policie ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Approle | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/approle.md | With [appRoleAssignments](approleassignment.md), app roles can be assigned to us ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Approleassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/approleassignment.md | An app role assignment where the assigned principal is a service principal is an ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Appscope | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/appscope.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Archivedprintjob | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/archivedprintjob.md | A record of a "final state" (completed, aborted, or canceled) print job that is ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Assignedcomputeinstancedetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/assignedcomputeinstancedetails.md | description: "Represents the details of a list of S3 buckets associated with thi ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Assignedlabel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/assignedlabel.md | Represents a sensitivity label assigned to a Microsoft 365 group. Sensitivity la ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Assignedlicense | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/assignedlicense.md | Title: "assignedLicense resource type" description: "Represents a license assigned to a user. The **assignedLicenses** property of the user entity is a collection of **assignedLicense**." ms.localizationpriority: medium doc_type: resourcePageType+ Represents a license assigned to a user. The **assignedLicenses** property of th ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Assignedplan | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/assignedplan.md | The following table describes the possible statuses for the **capabilityStatus** ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Assignmentreviewsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/assignmentreviewsettings.md | This type has the following properties: ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.assignmentReviewSettings" |
v1.0 | Attachment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/attachment.md | None ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Attachmentbase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/attachmentbase.md | Inherits from [entity](../resources/entity.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Attachmentinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/attachmentinfo.md | Represents the attributes of an attachment. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.attachmentInfo" |
v1.0 | Attachmentitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/attachmentitem.md | Represents attributes of an item to be attached. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Attacksimulationroot | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/attacksimulationroot.md | Title: "attackSimulationRoot resource type" -description: "Represents an abstract type that provides the ability to launch a realistic phishing attack that organizations can learn from." +description: "Represents an abstract type for launching realistic phishing attacks that organizations can learn from." ms.localizationpriority: medium Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents an abstract type that provides the ability to launch a realistic phishing attack that organizations can learn from. +Represents an abstract type for launching realistic phishing attacks that organizations can learn from. ## Methods Represents an abstract type that provides the ability to launch a realistic phis | **Training** | | | |[List trainings](../api/attacksimulationroot-list-trainings.md)|[training](../resources/training.md) collection|Get a list of the [training](../resources/training.md) objects and their properties.| |[Get training](../api/training-get.md)|[training](../resources/training.md)|Get an attack simulation [training](../resources/training.md) for a tenant. |-+|[List trainingCampaigns](../api/attacksimulationroot-list-trainingcampaigns.md)|[trainingCampaign](../resources/trainingcampaign.md) collection|Get the trainingCampaign resources from the trainingCampaigns navigation property.| +|[Create trainingCampaign](../api/attacksimulationroot-post-trainingcampaigns.md)|[trainingCampaign](../resources/trainingcampaign.md)|Create a new trainingCampaign object.| ## Properties None. None. |simulationAutomations|[simulationAutomation](../resources/simulationautomation.md) collection|Represents simulation automation created to run on a tenant.| |simulations|[simulation](../resources/simulation.md) collection|Represents an attack simulation training campaign in a tenant.| |trainings|[training](../resources/training.md) collection|Represents details about attack simulation trainings.|+|trainingCampaigns|[trainingCampaign](../resources/trainingcampaign.md) collection|Represents a training campaign in a tenant.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Attendee | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/attendee.md | Derived from [attendeeBase](attendeebase.md). ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Attendeeavailability | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/attendeeavailability.md | The availability of an attendee. ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Attendeebase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/attendeebase.md | Derived from [recipient](recipient.md). ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Authenticationattributecollectioninputconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authenticationattributecollectioninputconfiguration.md | Represents the display configuration of attributes being collected on an attribu None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.authenticationAttributeCollectionInputConfiguration" |
v1.0 | Authenticationcombinationconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authenticationcombinationconfiguration.md | Inherits from [entity](../resources/entity.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Authenticationcontext | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authenticationcontext.md | For more information about authentication context in conditional access, see the None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.authenticationContext" |
v1.0 | Authenticationcontextclassreference | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authenticationcontextclassreference.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Authenticationeventlistener | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authenticationeventlistener.md | To customize the authentication process, listeners can be registered which speci - [onAttributeCollectionStartListener](../resources/onattributecollectionstartlistener.md) resource type - [onAttributeCollectionSubmitListener](../resources/onattributecollectionsubmitlistener.md) resource type +> [!NOTE] +> +> You can have a maximum of 250 event listeners. + Inherits from [entity](../resources/entity.md). ## Methods |
v1.0 | Authenticationeventsflow | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authenticationeventsflow.md | Inherits from [entity](../resources/entity.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Authenticationeventspolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authenticationeventspolicy.md | A resource that specifies the events in the authentication experience, with each ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Authenticationflowspolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authenticationflowspolicy.md | Represents the [policy configuration of self-service sign-up experience](../reso None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Authenticationlistener | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authenticationlistener.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Authenticationmethodconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authenticationmethodconfiguration.md | Title: "authenticationMethodConfigurations" -description: "authenticationMethodConfigurations object." +description: "An abstract type that represents the settings for each authentication method." ms.localizationpriority: medium Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -This is an abstract type that represents the settings for each authentication method. It has the configuration of whether a specific authentication method is enabled or disabled for the tenant and which users and groups can register and use that method. +An abstract type that represents the settings for each authentication method. It has the configuration of whether a specific authentication method is enabled or disabled for the tenant and which users and groups can register and use that method. The following authentication methods are derived from the **authenticationMethodConfiguration** resource type: + [emailAuthenticationMethodConfiguration](emailauthenticationmethodconfiguration.md)++ [externalAuthenticationMethodConfiguration](externalauthenticationmethodconfiguration.md) + [fido2AuthenticationMethodConfiguration](fido2authenticationmethodconfiguration.md) + [hardwareOathAuthenticationMethodConfiguration](hardwareoathauthenticationmethodconfiguration.md) + [microsoftAuthenticatorAuthenticationMethodConfiguration](microsoftauthenticatorauthenticationmethodconfiguration.md) The following authentication methods are derived from the **authenticationMethod None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Authenticationmethodspolicies Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authenticationmethodspolicies-overview.md | The authentication method policies APIs are used to manage policy settings. For |Authentication method policy | Description | |:|:| |[emailauthenticationmethodconfiguration](emailauthenticationmethodconfiguration.md)|Define users who can use email OTP on the Microsoft Entra tenant.|+|[externalauthenticationmethodconfiguration](externalauthenticationmethodconfiguration.md)|Define users who can use an external authentication method to satisfy the second factor of Microsoft Entra ID multifactor authentication requirements.| |[fido2authenticationmethodconfiguration](fido2authenticationmethodconfiguration.md)| Define FIDO2 security key restrictions and users who can use them to sign in to Microsoft Entra ID.| |[hardwareOathAuthenticationMethodConfiguration](hardwareoathauthenticationmethodconfiguration.md)| Define users who can use hardware OATH tokens to sign in to Microsoft Entra ID.| |[microsoftauthenticatorauthenticationmethodconfiguration](microsoftauthenticatorauthenticationmethodconfiguration.md)|Define users who can use Microsoft Authenticator on the Microsoft Entra tenant.| |
v1.0 | Authenticationmethodspolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authenticationmethodspolicy.md | Defines authentication methods and the users that are allowed to use them to sig |authenticationMethodConfigurations|[authenticationMethodConfiguration](../resources/authenticationmethodconfiguration.md) collection|Represents the settings for each authentication method. Automatically expanded on `GET /policies/authenticationMethodsPolicy`.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Authenticationmethodsroot | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authenticationmethodsroot.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Authenticationmethodtarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authenticationmethodtarget.md | A collection of groups that are enabled to use an authentication method as part None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Authenticationrequirementpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authenticationrequirementpolicy.md | Microsoft Entra ID can require users to pass an MFA check before accessing resou |Property|Type|Description| |:|:|:| |detail|String|Provides additional detail on the feature identified in requirementProvider.|-|requirementProvider|requirementProvider|Identifies what Microsoft Entra feature requires MFA in this policy. Possible values are: `user`, `request`, `servicePrincipal`, `v1ConditionalAccess`, `multiConditionalAccess`, `tenantSessionRiskPolicy`, `accountCompromisePolicies`, `v1ConditionalAccessDependency`, `v1ConditionalAccessPolicyIdRequested`, `mfaRegistrationRequiredByIdentityProtectionPolicy`, `baselineProtection`, `mfaRegistrationRequiredByBaselineProtection`, `mfaRegistrationRequiredByMultiConditionalAccess`, `enforcedForCspAdmins`, `securityDefaults`, `mfaRegistrationRequiredBySecurityDefaults`, `proofUpCodeRequest`, `crossTenantOutboundRule`, `gpsLocationCondition`, `riskBasedPolicy`, `unknownFutureValue`.| +|requirementProvider|requirementProvider|Identifies what Microsoft Entra feature requires MFA in this policy. Possible values are: `user`, `request`, `servicePrincipal`, `v1ConditionalAccess`, `multiConditionalAccess`, `tenantSessionRiskPolicy`, `accountCompromisePolicies`, `v1ConditionalAccessDependency`, `v1ConditionalAccessPolicyIdRequested`, `mfaRegistrationRequiredByIdentityProtectionPolicy`, `baselineProtection`, `mfaRegistrationRequiredByBaselineProtection`, `mfaRegistrationRequiredByMultiConditionalAccess`, `enforcedForCspAdmins`, `securityDefaults`, `mfaRegistrationRequiredBySecurityDefaults`, `proofUpCodeRequest`, `crossTenantOutboundRule`, `gpsLocationCondition`, `riskBasedPolicy`, `unknownFutureValue`, `scopeBasedAuthRequirementPolicy`, `authenticationStrengths` . Also, note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value or values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `scopeBasedAuthRequirementPolicy`, `authenticationStrengths`.| ## Relationships None. |
v1.0 | Authenticationsourcefilter | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authenticationsourcefilter.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.authenticationSourceFilter" |
v1.0 | Authorizationinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authorizationinfo.md | Title: "authorizationInfo resource type" description: "Represents the identifiers that can be used to identify and authenticate a user in non-Azure AD environments." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Authorizationpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authorizationpolicy.md | Represents a policy that can control Microsoft Entra authorization settings. It' |enabledPreviewFeatures|String collection| List of features enabled for private preview on the tenant. | |guestUserRoleId|Guid| Represents role templateId for the role that should be granted to guests. Refer to [List unifiedRoleDefinitions](../api/rbacapplication-list-roledefinitions.md) to find the list of available role templates. Currently following roles are supported: *User* (`a0b1b346-4d3e-4e8b-98f8-753987be4970`), *Guest User* (`10dae51f-b6af-4016-8d66-8c2a99b929b3`), and *Restricted Guest User* (`2af84b1e-32c8-42b7-82bc-daa82404023b`). | |id|String| ID of the authorization policy. Required. Read-only.|-|permissionGrantPolicyIdsAssignedToDefaultUserRole|String collection|Indicates if user consent to apps is allowed, and if it is, which app consent policy (permissionGrantPolicy) governs the permission for users to grant consent. Values should be in the format `managePermissionGrantsForSelf.{id}`, where `{id}` is the **id** of a built-in or custom [app consent policy](/azure/active-directory/manage-apps/manage-app-consent-policies). An empty list indicates user consent to apps is disabled. | +|permissionGrantPolicyIdsAssignedToDefaultUserRole|String collection|Indicates if user consent to apps is allowed, and if it is, the [app consent policy](../resources/permissiongrantpolicy.md) that governs the permission for users to grant consent. Values should be in the format `managePermissionGrantsForSelf.{id}` for user consent policies or `managePermissionGrantsForOwnedResource.{id}` for resource-specific consent policies, where `{id}` is the **id** of a built-in or custom app consent policy. An empty list indicates user consent to apps is disabled. | ### allowInvitesFrom values |
v1.0 | Authorizationsystem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authorizationsystem.md | description: "Represents a Microsoft Azure subscription, Amazon Web Services (AW ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Authorizationsystemidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authorizationsystemidentity.md | description: "A container representing an identity in an authorization system." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Authorizationsystemidentitysource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authorizationsystemidentitysource.md | description: "Represents the source for an authorization system identity." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Authorizationsysteminfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authorizationsysteminfo.md | description: "Represents the authorization system's identifying information." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Authorizationsystemresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authorizationsystemresource.md | description: "Represents a resource in an authorization system onboarded to Perm ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Authorizationsystemtypeaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authorizationsystemtypeaction.md | description: "Represents an action in an authorization system onboarded to Permi ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Authorizationsystemtypeservice | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authorizationsystemtypeservice.md | description: "Represents a service in an authorization system that is onboarded ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Automaticrepliesmailtips | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/automaticrepliesmailtips.md | Namespace: microsoft.graph ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Automaticrepliessetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/automaticrepliessetting.md | respond to emails. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Availabilityitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/availabilityitem.md | Indicates the status of a [staff member](bookingstaffmember.md) for a given time ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Awsaccesskey | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awsaccesskey.md | description: "Represents AWS access keys." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awsactionspermissionsdefinitionaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awsactionspermissionsdefinitionaction.md | description: "Represents permissions for an AWS action." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awsassociatedidentities | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awsassociatedidentities.md | description: "A container for the different kinds of AWS identities." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awsauthorizationsystem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awsauthorizationsystem.md | description: "Represents an AWS authorization system onboarded to Permissions Ma ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awsauthorizationsystemresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awsauthorizationsystemresource.md | description: "Represents an AWS resource in an AWS authorization system." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awsauthorizationsystemtypeaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awsauthorizationsystemtypeaction.md | description: "Represents an action in an AWS authorization system." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awscondition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awscondition.md | description: "An open type representing a JSON with AWS conditions for an AWS st ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awsec2instance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awsec2instance.md | description: "Represents AWS EC2 instances." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awsexternalsystemaccessfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awsexternalsystemaccessfinding.md | description: "Represents findings related to external accounts that are able to ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awsexternalsystemaccessrolefinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awsexternalsystemaccessrolefinding.md | description: "Represents the findings for roles that allow for external system a ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awsgroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awsgroup.md | description: "Represents a group in AWS." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awsidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awsidentity.md | description: "Represents identities in AWS." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awsidentityaccessmanagementkeyagefinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awsidentityaccessmanagementkeyagefinding.md | description: "View the age of AWS IAM Access Keys." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awsidentityaccessmanagementkeyusagefinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awsidentityaccessmanagementkeyusagefinding.md | description: "The IAM access key age represents the number of keys that have not ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awsidentitysource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awsidentitysource.md | description: "Represents an permissionsDefinitionIdentitySource for a cross-acco ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awslambda | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awslambda.md | description: "Represents AWS lambda functions." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awspermissionsdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awspermissionsdefinition.md | description: "AWS-specific permissions request details." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awspermissionsdefinitionaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awspermissionsdefinitionaction.md | description: "An abstract complex type that represents the action to take in a p ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awspolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awspolicy.md | description: "Represents an AWS policy in an AWS authorization system." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awspolicypermissionsdefinitionaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awspolicypermissionsdefinitionaction.md | description: "Represents permissions for an AWS policy." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awsrole | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awsrole.md | description: "Represents AWS role." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awssecretinformationaccessfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awssecretinformationaccessfinding.md | description: "Represents findings for identities who can access secret informati ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awssecuritytooladministrationfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awssecuritytooladministrationfinding.md | description: "Represents findings for identities with privileges to modify setti ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awssource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awssource.md | description: "Represents an authorization system identity sourced from AWS." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awsstatement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awsstatement.md | description: "Specifies an AWS statement that includes information about a singl ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Awsuser | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/awsuser.md | description: "Represents AWS users." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Azure Ad Auditlog Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/azure-ad-auditlog-overview.md | The directory audit report provides you with access to the history of every task ### Custom security attribute audit logs -Custom security attribute audit logs provide you with the history of activities related to custom security attributes, such as adding a new definition or assigning an attribute value to a user. Custom security attribute audit logs are separate from directory audit logs and have a different endpoint. To view custom security attribute audit logs, you must be assigned the Attribute Log Reader or Attribute Log Administrator role. By default, a Global Administrator does not have access to these audit logs. +Custom security attribute audit logs provide you with the history of activities related to custom security attributes, such as adding a new definition or assigning an attribute value to a user. Custom security attribute audit logs are separate from directory audit logs and have a different endpoint. To view custom security attribute audit logs, you must be assigned the Attribute Log Reader or Attribute Log Administrator role. By default, a Global Administrator doesn't have access to these audit logs. ### Sign-ins |
v1.0 | Azure Ad Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/azure-ad-overview.md | - Title: "Working with Microsoft Entra resources in Microsoft Graph" -description: "Microsoft Graph for Microsoft Entra provides REST APIs to help manage your organization, resources, and assets." -doc_type: conceptualPageType -- Previously updated : 11/29/2022---# Working with Microsoft Entra resources in Microsoft Graph ---With Microsoft Graph, you can access [Microsoft Entra](/azure/active-directory/active-directory-whatis) resources to enable scenarios like managing administrator (directory) roles, inviting external users to an organization, and, if you are a [Cloud Solution Provider (CSP)](https://partner.microsoft.com/cloud-solution-provider), managing your customer's data. Microsoft Graph also provides methods apps can use, for example, to discover information about users' transitive group and role memberships. --> **Note**: Some Microsoft Entra resources are documented in other sections of the API reference. For more information, see [Users](users.md) and [Groups](group.md). ---## Authorization --To call the Microsoft Graph APIs on Microsoft Entra resources, your app will need the appropriate permissions. Many of the APIs exposed on Microsoft Entra resources require one of the [_Directory_ permissions](/graph/permissions-reference#directory-permissions). Directory permissions are highly privileged and always require administrator consent. --If your app is acting on behalf of a user (delegated permissions), that user will likely need to be a member of an appropriate [administrator role](/azure/active-directory/active-directory-assign-admin-roles) for your app to successfully call many of the Microsoft Entra APIs. --For more information about permissions, including delegated and application permissions, see [Permissions](/graph/permissions-reference). --## Common use cases --The following table lists some common use cases for Microsoft Entra resources. --| **Use cases** | **REST resources** | **See also** | -|:--|:--|:-| -| **Directory object and methods** | | | -| `directoryObject` is the base class that many directory resources, like users and groups, inherit from. Microsoft Graph exposes several methods that you can use to discover information about users, groups, and other directory objects. For example, you can check for transitive membership in a list of groups, return all the groups and directory roles that a directory object is a transitive member of, or get all the resources of a specified type (like user or group) from a list of generic resource IDs. | [directoryObject](../resources/directoryobject.md) | N/A | -| **Manage directory (administrator) roles, administrative units, directory settings, and policy** | | | -| Activate directory roles in a Microsoft Entra tenant and manage user memberships in directory roles. Directory roles are also known as administrator roles. | [directoryRole](../resources/directoryrole.md) <br/>[directoryRoleTemplate](../resources/directoryroletemplate.md) |[Assigning Microsoft Entra administrator roles](/azure/active-directory/active-directory-assign-admin-roles)| -| Manage administrative units. Directory roles delegate tenant-wide authority to their members. An administrator can create and manage administrative units to delegate more granularly scoped administrative authority to users. | [administrativeUnit](../resources/administrativeunit.md) | [Administrative units management in Microsoft Entra ID](/azure/active-directory/active-directory-administrative-units-management) | -| Apply predefined directory settings across a tenant or to individual resource instances. Currently, only settings for Microsoft 365 groups are supported. Directory settings control behaviors like blocked word lists for group display names, whether guest users are allowed to be group owners, and much more. | [directorySetting](../resources/directorysetting.md) <br/>[directorySettingTemplate](../resources/directorysettingtemplate.md)| [Microsoft Entra cmdlets for configuring group settings](/azure/active-directory/active-directory-accessmanagement-groups-settings-cmdlets)| -| Apply Microsoft Entra policies to applications, service principals, groups, or the entire organization. Policies for claims mapping, token issuance, token lifetime, home realm discovery and more are supported. | [Available policies](../resources/policy-overview.md) | N/A | -| **Secure privileged access in Microsoft Entra** | | | -| Manage and monitor time-bound privileged access to directory and Azure resources for administrators and IT professionals with Privileged Identity Management (PIM). | [Privileged Identity Management API](../resources/privilegedidentitymanagement-root.md) | [What is Microsoft Entra Privileged Identity Management?](/azure/active-directory/active-directory-privileged-identity-management-configure)| -| Monitor identity risk events like users signing in from malware-infected devices or from unfamiliar locations. | [Identity Protection Service API](../resources/identityprotection-overview.md) | [Microsoft Entra ID Protection](/azure/active-directory/active-directory-identityprotection)<br/><br/>[Microsoft Entra risk events](/azure/active-directory/active-directory-reporting-risk-events) | -| **Manage devices** | | | -| Manage devices registered in the organization. Devices are registered to users and include items like laptops, desktops, tablets, and mobile phones. Devices are typically created in the cloud using the Device Registration Service or by Microsoft Intune. They're used by conditional access policies for multifactor authentication. | [device](../resources/device.md) | [Getting started with Microsoft Entra device registration](/mem/intune/enrollment/).<br/><br/>[What is Intune?](/mem/intune/fundamentals/what-is-intune)<br/><br/>[Enroll devices for management in Intune](/mem/intune/enrollment/) | -| **App management** | | | -| Manage app configuration in a developer tenant. | [application](../resources/application.md) | [Application and service principal objects in Microsoft Entra ID](/azure/active-directory/develop/active-directory-application-objects) | -| Manage apps installed in a tenant. | [servicePrinicpal](../resources/serviceprincipal.md) | [Application and service principal objects in Microsoft Entra ID](/azure/active-directory/develop/active-directory-application-objects) | -| Manage permissions consented by users and administrators on apps installed in a tenant. | [oAuth2PermissionGrant](../resources/oauth2permissiongrant.md) | N/A | -| Manage user, group, and service principal role memberships on apps installed in a tenant. | [appRoleAssignment](../resources/approleassignment.md) | N/A | -| **Partner tenant management** | | | -| Get information about partnerships with customer tenants. <br/><br/>**Note:** This applies to partner tenants only. Partner tenants are Microsoft Entra tenants that belong to Microsoft partners who are either part of the [Microsoft Cloud Solution Provider](https://partnercenter.microsoft.com/partner/programs), Office 365 Syndication, or Microsoft Advisor partner programs.| [contract](../resources/contract.md) | [Call Microsoft Graph from a Cloud Solution Provider application](/graph/auth-cloudsolutionprovider) | -| Manage domains associated with a tenant. Domain operations enable registrars to automate domain association for services such as Microsoft 365. | [domain](../resources/domain.md) | [Add a custom domain name to Microsoft Entra ID](/azure/active-directory/active-directory-domains-add-azure-portal) | -| **Tenant management** | | | -| Get information about an organization, such as its business address, technical and notification contacts, the service plans that it's subscribed to, and the domains associated with it. | [organization](../resources/organization.md) | N/A | -| Get information about the service SKUs that a company is subscribed to. | [subscribedSku](../resources/subscribedsku.md) | N/A | -| Invite external (guest) users to an organization. | [invitation](../resources/invitation.md) | [What is Microsoft Entra B2B collaboration?](/azure/active-directory/active-directory-b2b-what-is-azure-ad-b2b)| -| Manage branding for the sign-in experience of an organization. | [organizationalbranding](../resources/organizationalbranding.md) | [Add branding to your organization's Microsoft Entra sign-in page](/azure/active-directory/fundamentals/customize-branding)| -| **Access reviews** | | | -| Ensure group memberships and application access rights are correct with access reviews. | [access reviews API](../resources/accessreviews-root.md) |[Microsoft Entra access reviews](/azure/active-directory/active-directory-azure-ad-controls-access-reviews-overview) | -| **Consent requests** | | | -| Manage the consent request workflow for users attempting to access apps that require admin authorization. | [Consent requests API](../resources/consentrequests-overview.md) |[Configure the admin consent workflow](/azure/active-directory/manage-apps/configure-admin-consent-workflow) | --## Next steps -Directory resources and APIs can open up new ways for you to engage with users and manage their experiences with Microsoft Graph. To learn more: --- Drill down on the methods and properties of the resources most helpful to your scenario.-- Try the API in the [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer). |
v1.0 | Azureactionpermissionsdefinitionaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/azureactionpermissionsdefinitionaction.md | description: "Represents Azure actions." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Azureassociatedidentities | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/azureassociatedidentities.md | description: "A container for the different kinds of Azure identities." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Azureauthorizationsystem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/azureauthorizationsystem.md | description: "Represents an Azure authorization system onboarded to Permissions ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Azureauthorizationsystemresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/azureauthorizationsystemresource.md | description: "Represents an Azure resource in an Azure authorization system onbo ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Azureauthorizationsystemtypeaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/azureauthorizationsystemtypeaction.md | description: "Represents an action in an Azure authorization system." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Azuregroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/azuregroup.md | description: "Represents a group in an Azure authorization system." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Azureidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/azureidentity.md | description: "Represents identities in Azure including managed identities, servi ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Azuremanagedidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/azuremanagedidentity.md | description: "Represents a managed idetity object in an Azure authorization syst ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Azurepermissionsdefinitionaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/azurepermissionsdefinitionaction.md | description: "This is an abstract type representing actions relating to permissi ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Azureroledefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/azureroledefinition.md | description: "Represents an Azure role in an Azure authorization system." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Azurerolepermissionsdefinitionaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/azurerolepermissionsdefinitionaction.md | description: "Represents permissions for an Azure role." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Azureserverlessfunction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/azureserverlessfunction.md | description: "Represents a serverless function in an Azure authorization system. ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Azureserviceprincipal | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/azureserviceprincipal.md | description: "Represents a service principal in an Azure authorization system." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Azuresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/azuresource.md | description: "Represents an authorization system identity sourced from Microsoft ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Azureuser | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/azureuser.md | description: "Represents a user in an Azure authorization system." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | B2cauthenticationmethodspolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/b2cauthenticationmethodspolicy.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | B2xidentityuserflow | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/b2xidentityuserflow.md | User flows are used to enable a [self-service sign up](/azure/active-directory/e ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Baseitemversion | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/baseitemversion.md | Represents a previous version of an item or entity. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.baseItemVersion", "@type.aka": "oneDrive.baseItemVersion" } --> |
v1.0 | Basetasklist | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/basetasklist.md | The following methods apply to any of the derived types of **baseTaskList** (**w |tasks|[baseTask](../resources/basetask.md) collection|The tasks in this task list. Read-only. Nullable.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Basicauthentication | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/basicauthentication.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.basicAuthentication" |
v1.0 | Bitlocker | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/bitlocker.md | None. | recoveryKeys | [bitlockerRecoveryKey](../resources/bitlockerrecoverykey.md) collection | The recovery keys associated with the bitlocker entity. | ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.bitlocker", |
v1.0 | Bookingcurrency | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/bookingcurrency.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Bookingnamedentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/bookingnamedentity.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Bookingperson | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/bookingperson.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Bookingquestionassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/bookingquestionassignment.md | Contains the set of custom questions associated with a particular service. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.bookingQuestionAssignment" |
v1.0 | Bookingservice | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/bookingservice.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Broadcastmeetingcaptionsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/broadcastmeetingcaptionsettings.md | The following table shows the supported language codes for translation languages ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.broadcastMeetingCaptionSettings" |
v1.0 | Broadcastmeetingsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/broadcastmeetingsettings.md | Represents settings related to a [live event](/microsoftteams/teams-live-events/ ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Bucketaggregationdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/bucketaggregationdefinition.md | Provides the details on how to generate the aggregations in the results. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Builtinidentityprovider | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/builtinidentityprovider.md | This type will inherit from [identityProviderBase](../resources/identityprovider ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Businessflowtemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/businessflowtemplate.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Calendargroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/calendargroup.md | A group of user calendars. ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Calendarpermission | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/calendarpermission.md | Once a share recipient or delegate has been set up for a calendar, you can [upda ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Call | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/call.md | myParticipantId | String ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Callrecords Feedbacktokenset | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/callrecords-feedbacktokenset.md | Explicit property names won't be documented since the feedback token names can c ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Callrecords Segment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/callrecords-segment.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Callrecords Session | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/callrecords-session.md | Represents a user-user communication or a user-meeting communication in the case ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Campaignschedule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/campaignschedule.md | + + Title: "campaignSchedule resource type" +description: "Represents a schedule for launching a campaign." ++ms.localizationpriority: medium +++# campaignSchedule resource type ++Namespace: microsoft.graph +++Represents a schedule for launching a campaign. ++## Properties +|Property|Type|Description| +|:|:|:| +|completionDateTime|DateTimeOffset|The date and time at which the campaign completed.| +|launchDateTime|DateTimeOffset|The date and time at which the campaign was launched.| +|status|campaignStatus|The current state of the campaign. The possible values are: `unknown`, `draft`, `inProgress`, `scheduled`, `completed`, `failed`, `cancelled`, `excluded`, `deleted`, `unknownFutureValue`.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.campaignSchedule" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.campaignSchedule", + "completionDateTime": "String (timestamp)", + "launchDateTime": "String (timestamp)", + "status": "String" +} +``` + |
v1.0 | Certificateauthority | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/certificateauthority.md | Title: "certificateAuthority resource type" description: "Represents a certificate authority." ms.localizationpriority: medium-+ doc_type: "resourcePageType" |
v1.0 | Certificatebasedauthconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/certificatebasedauthconfiguration.md | Title: "certificateBasedAuthConfiguration resource type" description: "Represents a collection of certificate authorities." ms.localizationpriority: medium-+ doc_type: "resourcePageType" |
v1.0 | Certification | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/certification.md | The certification property of an application is read-only, and can't be manually |lastCertificationDateTime|DateTimeOffset|The timestamp when the certification for the application was most recently added or updated.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Change Notifications Api Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/change-notifications-api-overview.md | description: "Deliver change notifications to clients." ms.localizationpriority: medium doc_type: conceptualPageType+ # Use the Microsoft Graph API to get change notifications |
v1.0 | Changenotification | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/changenotification.md | description: "Represents the change notification sent to the subscriber." ms.localizationpriority: medium doc_type: resourcePageType+ # changeNotification resource type |
v1.0 | Changenotificationencryptedcontent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/changenotificationencryptedcontent.md | description: "A changeNotificationEncryptedContent object represents the encrypt ms.localizationpriority: medium doc_type: resourcePageType+ # changeNotificationEncryptedContent resource type |
v1.0 | Channel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/channel.md | where files are shared, and where tabs are added. |[List channel members](../api/channel-list-members.md) | [conversationMember](conversationmember.md) collection | Get the list of members in a channel.| |[Add channel member](../api/channel-post-members.md) | [conversationMember](conversationmember.md) | Add a member to a channel. Only supported for channels with a **membershipType** of `private` or `shared`.| |[Get channel member](../api/channel-get-members.md) | [conversationMember](conversationmember.md) collection | Get a member in a channel.|+|[Archive channel](../api/channel-archive.md) | None | Archive a channel.| +|[Unarchive channel](../api/channel-unarchive.md) | None | Unarchive a channel.| |[Update channel member's role](../api/channel-update-members.md) | [conversationMember](conversationmember.md) | Update the properties of a member of the channel. Only supported for channels with a **membershipType** of `private` or `shared`.| |[Remove channel member](../api/channel-delete-members.md) | None | Delete a member from a channel. Only supported for channels with a **membershipType** of `private` or `shared`.| |[Complete migration](../api/channel-completemigration.md)|[channel](channel.md)| Removes the migration mode from the channel and makes the channel available to users to post and read messages.| where files are shared, and where tabs are added. |[Provision channel email address](../api/channel-provisionemail.md) |[provisionChannelEmailResult](../resources/provisionchannelemailresult.md)| Provision an email address for the channel.| |[Remove channel email address](../api/channel-removeemail.md) | None | Remove the email address of the channel.| |[Remove incoming channel](../api/team-delete-incomingchannels.md) | None| Remove an incoming [channel](../resources/channel.md) (a **channel** shared with a **team**) from a [team](../resources/team.md).|-|[List teams sharing a channel](../api/sharedwithchannelteaminfo-list.md)|[sharedWithChannelTeamInfo](../resources/sharedwithchannelteaminfo.md) collection|Get the list of teams that has been shared the specified channel.| -|[Get team sharing a channel](../api/sharedwithchannelteaminfo-get.md)|[sharedWithChannelTeamInfo](../resources/sharedwithchannelteaminfo.md)|Get a team that has been shared the specified channel.| +|[List teams sharing a channel](../api/sharedwithchannelteaminfo-list.md)|[sharedWithChannelTeamInfo](../resources/sharedwithchannelteaminfo.md) collection|Get the list of teams that share the specified channel.| +|[Get team sharing a channel](../api/sharedwithchannelteaminfo-get.md)|[sharedWithChannelTeamInfo](../resources/sharedwithchannelteaminfo.md)|Get a team that shares the specified channel.| |[Unshare channel with team](../api/sharedwithchannelteaminfo-delete.md)|None|Unshare a channel with a team.| |[List allowed members](../api/sharedwithchannelteaminfo-list-allowedmembers.md)|[conversationMember](../resources/conversationmember.md) collection|Get the list of team members who have access to the shared channel.| |[Check user access](../api/channel-doesuserhaveaccess.md)|Boolean|Check whether a user has access to a shared channel or not.| where files are shared, and where tabs are added. | Property | Type |Description| |:|:--|:-| |description|String|Optional textual description for the channel.|-|displayName|String|Channel name as it will appear to the user in Microsoft Teams. The maximum length is 50 characters.| +|displayName|String|Channel name as it appears to the user in Microsoft Teams. The maximum length is 50 characters.| |id|String|The channel's unique identifier. Read-only.| |isFavoriteByDefault|Boolean|Indicates whether the channel should automatically be marked 'favorite' for all members of the team. Can only be set programmatically with [Create team](../api/team-post.md). Default: `false`.| |email|String| The email address for sending messages to the channel. Read-only.|-|webUrl|String|A hyperlink that will go to the channel in Microsoft Teams. This is the URL that you get when you right-click a channel in Microsoft Teams and select Get link to channel. This URL should be treated as an opaque blob, and not parsed. Read-only.| -|membershipType|[channelMembershipType](../resources/channel.md#channelmembershiptype-values)|The type of the channel. Can be set during creation and can't be changed. The possible values are: `standard`, `private`, `unknownFutureValue`, `shared`. The default value is `standard`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `shared`.| +|webUrl|String|A hyperlink to the channel in Microsoft Teams. This URL is supplied when you right-click a channel in Microsoft Teams and select Get link to channel. This URL should be treated as an opaque blob, and not parsed. Read-only.| +|membershipType|[channelMembershipType](../resources/channel.md#channelmembershiptype-values)|The type of the channel. Can be set during creation and can't be changed. The possible values are: `standard`, `private`, `unknownFutureValue`, `shared`. The default value is `standard`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `shared`.| |createdDateTime|dateTimeOffset|Read only. Timestamp at which the channel was created.| |moderationSettings|[channelModerationSettings](../resources/channelmoderationsettings.md)|Settings to configure channel moderation to control who can start new posts and reply to posts in that channel.|-|summary|[channelSummary](../resources/channelsummary.md)|Contains summary information about the channel, including number of guests, members, owners, and an indicator for members from other tenants. The **summary** property will only be returned if it is specified in the `$select` clause of the [Get channel](../api/channel-get.md) method.| +|summary|[channelSummary](../resources/channelsummary.md)|Contains summary information about the channel, including number of guests, members, owners, and an indicator for members from other tenants. The **summary** property is only returned if it appears in the `$select` clause of the [Get channel](../api/channel-get.md) method.| |tenantId |string | The ID of the Microsoft Entra tenant. |+|isArchived| Boolean | Indicates whether the channel is archived. Read-only. | ### channelMembershipType values where files are shared, and where tabs are added. ### Instance attributes -Instance attributes are properties with special behaviors. These properties are temporary and either a) define behavior the service should perform or b) provide short-term property values, like a download URL for an item that expires. +Instance attributes are properties with special behaviors. These properties are temporary. They either define behavior that the service should perform, or provide short-term property values, such as a download URL for an item that expires. | Property name| Type | Description |:--|:-|:-| For a POST request example, see [Request (create channel in migration state)](/m ## JSON representation -The following is a JSON representation of the resource. +The following JSON representation shows the resource type <!-- { "blockType": "resource", The following is a JSON representation of the resource. "email": "string", "webUrl": "string", "membershipType": "String",+ "isArchived": false, "createdDateTime": "string (timestamp)", "moderationSettings": { "@odata.type": "microsoft.graph.channelModerationSettings" } } |
v1.0 | Chatmessagehostedcontent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/chatmessagehostedcontent.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Chatmessageinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/chatmessageinfo.md | Represents a preview of a [chatMessage](../resources/chatmessage.md) resource. T None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Chatmessagepolicyviolation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/chatmessagepolicyviolation.md | Represents a policy violation on a chat message. Policy violations are typically ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Chatmessagereaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/chatmessagereaction.md | An entity of type `chatMessageReaction` is returned as part of the [Get channel | Property | Type | Description | |:-|:|:|-|createdDateTime|DateTimeOffset|The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| -|reactionType|String|Supported values are `like`, `angry`, `sad`, `laugh`, `heart`, `surprised`. | +|createdDateTime|DateTimeOffset|The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| +|reactionContentUrl|String|The hosted content URL for the custom reaction type. | +|reactionType|String|Supported values are Unicode characters and `custom`. Some backward-compatible reaction types include `like`, `angry`, `sad`, `laugh`, `heart`, and `surprised`. | |user|[chatMessageReactionIdentitySet](chatmessagereactionidentityset.md)|The user who reacted to the message.| ## JSON representation -The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", The following is a JSON representation of the resource. ```json { "createdDateTime": "String (timestamp)",+ "reactionContentUrl": "String", "reactionType": "String", "user": {"@odata.type": "microsoft.graph.chatMessageReactionIdentitySet"} } The following is a JSON representation of the resource. "section": "documentation", "tocPath": "" }-->-- |
v1.0 | Chunkeduploadsessiondescriptor | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/chunkeduploadsessiondescriptor.md | Namespace: microsoft.graph ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Claimsmapping | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/claimsmapping.md | After the custom identity provider sends an ID token back to Azure AD B2C, Azure None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.claimsMapping" |
v1.0 | Claimsmappingpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/claimsmappingpolicy.md | The properties below form the JSON object that represents a claims-mapping polic ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Clientcertificateauthentication | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/clientcertificateauthentication.md | Inherits from [apiAuthenticationConfigurationBase](../resources/apiauthenticatio ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.clientCertificateAuthentication" |
v1.0 | Cloudappsecuritystate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudappsecuritystate.md | Contains stateful information about the cloud application (destinationServiceNam ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Cloudpc | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpc.md | Title: "cloudPC resource type" -description: "Cloud managed virtual desktops." +description: "Represents a cloud-managed virtual desktop." ms.localizationpriority: medium Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents a cloud-managed virtual desktop. This Cloud PC is also enrolled into Intune and managed through the Microsoft Endpoint Manager portal, so the Cloud PC also has a corresponding Intune managed device ID. +Represents a cloud-managed virtual desktop. This Cloud PC is also enrolled in Intune and managed through the Microsoft Endpoint Manager portal, so the Cloud PC also has a corresponding Intune-managed device ID. ## Methods |Method|Return type|Description| |:|:|:|-|[List cloudPCs](../api/virtualendpoint-list-cloudpcs.md)|[cloudPC](../resources/cloudpc.md) collection|List properties and relationships of the [cloudPC](../resources/cloudpc.md) objects.| -|[Get cloudPC](../api/cloudpc-get.md)|[cloudPC](../resources/cloudpc.md)|Read the properties and relationships of a [cloudPC](../resources/cloudpc.md) object.| -|[Get provisioned cloudPCs](../api/cloudpc-getprovisionedcloudpcs.md)|[cloudPC](../resources/cloudpc.md) collection|Get all provisioned Cloud PCs of a specific service plan for users under a Microsoft Entra user group.| +|[List cloudPCs](../api/virtualendpoint-list-cloudpcs.md)|[cloudPC](../resources/cloudpc.md) collection|List properties and relationships of the Cloud PC objects.| +|[Get cloudPC](../api/cloudpc-get.md)|[cloudPC](../resources/cloudpc.md)|Read the properties and relationships of a Cloud PC object.| +|[Get provisioned Cloud PCs](../api/cloudpc-getprovisionedcloudpcs.md)|[cloudPC](../resources/cloudpc.md) collection|Get all provisioned Cloud PCs of a specific service plan for users under a Microsoft Entra user group.| |[Change user account type](../api/cloudpc-changeuseraccounttype.md)|None|Change the account type of the user on a specific Cloud PC.|-|[End grace period](../api/cloudpc-endgraceperiod.md)|None|End the grace period for a [cloudPC](../resources/cloudpc.md) object.| +|[End grace period](../api/cloudpc-endgraceperiod.md)|None|End the grace period for a Cloud PC object.| |[Get remote action results](../api/manageddevice-getcloudpcremoteactionresults.md)|[cloudPcRemoteActionResult](../resources/cloudpcremoteactionresult.md)|Check the [Cloud PC-specified remote action results](../resources/cloudpcremoteactionresult.md) for a Cloud PC device.|-|[Power on](../api/cloudpc-poweron.md)|None|Power on a specific Windows Frontline [cloudPC](../resources/cloudpc.md) object. This action supports MEM admin scenarios.| -|[Power off](../api/cloudpc-poweroff.md)|None|Power off a specific Windows Frontline [cloudPC](../resources/cloudpc.md) object.This action supports MEM admin scenarios.| -|[Reboot](../api/cloudpc-reboot.md)|None|Reboot a specific [cloudPC](../resources/cloudpc.md) object.| -|[Rename](../api/cloudpc-rename.md)|None|Rename a specific [cloudPC](../resources/cloudpc.md) object. Use this API to update the **displayName** for the Cloud PC entity.| -|[Reprovision](../api/cloudpc-reprovision.md)|None|Reprovision a [cloudPC](../resources/cloudpc.md) object.| +|[Power on](../api/cloudpc-poweron.md)|None|Power on a specific Windows Frontline Cloud PC object. This action supports MEM admin scenarios.| +|[Power off](../api/cloudpc-poweroff.md)|None|Power off a specific Windows Frontline Cloud PC object. This action supports MEM admin scenarios.| +|[Reboot](../api/cloudpc-reboot.md)|None|Reboot a specific Cloud PC object.| +|[Rename](../api/cloudpc-rename.md)|None|Rename a specific Cloud PC object. Use this API to update the **displayName** for the Cloud PC entity.| +|[Reprovision](../api/cloudpc-reprovision.md)|None|Reprovision a Cloud PC object.| |[Bulk reprovision remote action](../api/manageddevice-bulkreprovisioncloudpc.md)|None|Bulk reprovision a set of Cloud PC devices with Intune managed device IDs.|-|[Resize remote action](../api/manageddevice-resizecloudpc.md)|None|Upgrade or downgrade an existing Cloud PC to another configuration with new vCPU and storage size through Intune managed device ID.| -|[Start](../api/cloudpc-start.md)|None|Start a specific [cloudPC](../resources/cloudpc.md) for a user. Currently, only Windows 365 Frontline Cloud PCs are supported. | -|[Stop](../api/cloudpc-stop.md)|None|Stop a specific [cloudPC](../resources/cloudpc.md) for a user. Currently, only Windows 365 Frontline Cloud PCs are supported. | -|[Troubleshoot](../api/cloudpc-troubleshoot.md)|None|Troubleshoot a specific [cloudPC](../resources/cloudpc.md) object. Use this API to check the health status of the Cloud PC and the session host.| -|[Restore](../api/cloudpc-restore.md)|None|Restore a [cloudPC](../resources/cloudpc.md) object to a previous state from a snapshot.| +|[Resize remote action](../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.| +|[Start](../api/cloudpc-start.md)|None|Start a specific Cloud PC for a user. Currently, only Windows 365 Frontline Cloud PCs are supported. | +|[Stop](../api/cloudpc-stop.md)|None|Stop a specific Cloud PC for a user. Currently, only Windows 365 Frontline Cloud PCs are supported. | +|[Troubleshoot](../api/cloudpc-troubleshoot.md)|None|Troubleshoot a specific Cloud PC object. Use this API to check the health status of the Cloud PC and the session host.| +|[Restore](../api/cloudpc-restore.md)|None|Restore a Cloud PC object to a previous state from a snapshot.| |[Bulk restore remote action](../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.| |[Set review status](../api/manageddevice-setcloudpcreviewstatus.md)|None|Set the review status of a specific Cloud PC device.| |[Get review status](../api/manageddevice-getcloudpcreviewstatus.md)|[cloudPcReviewStatus](../resources/cloudpcreviewstatus.md)|Get the review status of a specific Cloud PC device.| |[Bulk set review status](../api/manageddevice-bulksetcloudpcreviewstatus.md)|[cloudPcBulkRemoteActionResult](../resources/cloudpcbulkremoteactionresult.md)|Set the review status of multiple Cloud PC devices with a single request that includes the IDs of Intune managed devices.|-|[List for user](../api/user-list-cloudpcs.md)|[cloudPC](../resources/cloudpc.md) collection|List the [cloudPC](../resources/cloudpc.md) devices that are attributed to the signed-in user.| -|[Get launch info for user](../api/cloudpc-getcloudpclaunchinfo.md)|[cloudPCLaunchInfo](../resources/cloudpclaunchinfo.md)|Get the [cloudPCLaunchInfo](../resources/cloudpclaunchinfo.md) for the signed-in user.| +|[List for user](../api/user-list-cloudpcs.md)|[cloudPC](../resources/cloudpc.md) collection|List the Cloud PC devices that are attributed to the signed-in user.| +|[Get launch info for user](../api/cloudpc-getcloudpclaunchinfo.md)|[cloudPcLaunchInfo](../resources/cloudpclaunchinfo.md)|Get the [cloudPcLaunchInfo](../resources/cloudpclaunchinfo.md) for the signed-in user.| |[Get connectivity history](../api/cloudpc-getcloudpcconnectivityhistory.md)|[cloudPcConnectivityEvent](../resources/cloudpcconnectivityevent.md) collection|Get the Cloud PC connectivity history.| |[Get supported remote actions](../api/cloudpc-getsupportedcloudpcremoteactions.md)|[cloudPcRemoteActionCapability](../resources/cloudpcremoteactioncapability.md) collection|Get a list of supported Cloud PC remote actions for a specific Cloud PC device, including the action names and capabilities.|-|[Retry partner agent installation](../api/cloudpc-retrypartneragentinstallation.md)|None|Retry installation for the partner agents that failed to install on the [cloudPC](../resources/cloudpc.md).| -|[Bulk resize](../api/cloudpc-retrypartneragentinstallation.md)|[cloudPcRemoteActionResult](../resources//cloudpcremoteactionresult.md) collection|Perform a bulk resize action to resize a group of [cloudPCs](../resources/cloudpc.md) 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.| -|[Validate bulk resize](../api/cloudpc-validatebulkresize.md)|[cloudPcResizeValidateResult](../resources/cloudPcResizeValidationResult.md) collection|Validate that a set of [cloudPC](../resources/cloudpc.md) devices meet the requirements to be bulk resized.| +|[Retry partner agent installation](../api/cloudpc-retrypartneragentinstallation.md)|None|Retry installation for the partner agents that failed to install on the Cloud PC.| +|[Bulk resize](../api/cloudpc-retrypartneragentinstallation.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.| +|[Validate bulk resize](../api/cloudpc-validatebulkresize.md)|[cloudPcResizeValidateResult](../resources/cloudPcResizeValidationResult.md) collection|Validate that a set of Cloud PC devices meet the requirements to be bulk resized.| |[Get frontline access state](../api/cloudpc-getfrontlinecloudpcaccessstate.md)|[frontlineCloudPcAccessState](#frontlinecloudpcaccessstate-values)|Get the access state of the frontline Cloud PC. The possible values are: `unassigned`, `noLicensesAvailable`, `activationFailed`, `active`, `activating`, `standbyMode`, `unknownFutureValue`.| |[Get shift work access state](../api/cloudpc-getshiftworkcloudpcaccessstate.md) (deprecated)|[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.| |[Reprovision remote action](../api/manageddevice-reprovisioncloudpc.md) (deprecated)|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.| Represents a cloud-managed virtual desktop. This Cloud PC is also enrolled into |Property|Type|Description| |:|:|:| |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.| |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 happen. 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`.| +|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`.| |id|String|The unique identifier for the Cloud PC. Read-only.| |imageDisplayName|String|Name of the OS image that's on the Cloud PC.| |lastLoginResult|[cloudPcLoginResult](../resources/cloudpcloginresult.md)|The last login result of the Cloud PC. For example, `{ "time": "2014-01-01T00:00:00Z"}`.|-|lastModifiedDateTime|DateTimeOffset|The last modified date and time of the Cloud PC. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| -|lastRemoteActionResult|[cloudPcRemoteActionResult](../resources/cloudpcremoteactionresult.md)|The last remote action result of the enterprise Cloud PCs. The supported remote actions are: `Reboot`, `Rename`, `Reprovision`, `Restore`, and `Troubleshoot`.| +|lastModifiedDateTime|DateTimeOffset|The last modified date and time of the Cloud PC. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014, is `2014-01-01T00:00:00Z`.| +|lastRemoteActionResult|[cloudPcRemoteActionResult](../resources/cloudpcremoteactionresult.md)|The last remote action result of the enterprise Cloud PCs. The supported remote actions are: `Reboot`, `Rename`, `Reprovision`, `Restore`, `Troubleshoot`.| |managedDeviceId|String|The Intune device ID of the Cloud PC.| |managedDeviceName|String|The Intune device name of the Cloud PC.| |onPremisesConnectionName|String|The Azure network connection that is applied during the provisioning of Cloud PCs.|-|osVersion|[cloudPcOperatingSystem](../resources/cloudpcorganizationsettings.md#cloudpcoperatingsystem-values)|The version of the operating system (OS) to provision on Cloud PCs. Possible values are: `windows10`, `windows11`, and `unknownFutureValue`.| +|osVersion|[cloudPcOperatingSystem](../resources/cloudpcorganizationsettings.md#cloudpcoperatingsystem-values)|The version of the operating system (OS) to provision on Cloud PCs. Possible values are: `windows10`, `windows11`, `unknownFutureValue`.| |partnerAgentInstallResults|[cloudPcPartnerAgentInstallResult](../resources/cloudpcpartneragentinstallresult.md) collection|The results of every partner agent's installation status on Cloud PC.|-|powerState|[cloudPcPowerState](#cloudpcpowerstate-values)|The power state of a Cloud PC. The possible values are: `running`, `poweredOff` and `unknown`. This property only supports shift work Cloud PCs.| +|powerState|[cloudPcPowerState](#cloudpcpowerstate-values)|The power state of a Cloud PC. The possible values are: `running`, `poweredOff`, `unknown`. This property only supports shift work Cloud PCs.| |provisioningPolicyId|String|The provisioning policy ID of the Cloud PC.| |provisioningPolicyName|String|The provisioning policy that is applied during the provisioning of Cloud PCs.|-|provisioningType|[cloudPcProvisioningType](../resources/cloudpcprovisioningpolicy.md#cloudpcprovisioningtype-values)|The type of licenses to be used when provisioning Cloud PCs using this policy. Possible values are: `dedicated`, `shared`, `unknownFutureValue`. Default value is `dedicated`. | +|provisioningType|[cloudPcProvisioningType](../resources/cloudpcprovisioningpolicy.md#cloudpcprovisioningtype-values)|The type of licenses to be used when provisioning Cloud PCs using this policy. Possible values are: `dedicated`, `shared`, `unknownFutureValue`,`sharedByUser`, `sharedByUser`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `sharedByUser`, `sharedByEntraGroup`. The default value is `dedicated`. CAUTION: The `shared` member is deprecated and will stop returning on April 30, 2027; in the future, use the `sharedByUser` member. | |servicePlanId|String|The service plan ID of the Cloud PC.| |servicePlanName|String|The service plan name of the Cloud PC.| |servicePlanType|[cloudPcServicePlanType](../resources/cloudpcserviceplan.md#cloudpcserviceplantype-values)|The service plan type of the Cloud PC.|-|status|[microsoft.graph.cloudPcStatus](#cloudpcstatus-values)|The status of the Cloud PC. Possible values are: `notProvisioned`, `provisioning`, `provisioned`, `upgrading`, `inGracePeriod`, `deprovisioning`, `failed`, `restoring`.| +|status|[microsoft.graph.cloudPcStatus](#cloudpcstatus-values)|The status of the Cloud PC. Possible values are: `notProvisioned`, `provisioning`, `provisioned`, `inGracePeriod`, `deprovisioning`, `failed`, `provisionedWithWarnings`, `resizing`, `restoring`, `pendingProvision`, `unknownFutureValue`, `movingRegion`, `resizePendingLicense`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `movingRegion`, `resizePendingLicense`.| |statusDetails|[cloudPcStatusDetails](../resources/cloudpcstatusdetails.md)|The details of the Cloud PC status.|-|userAccountType|[cloudPcUserAccountType](../resources/cloudpcorganizationsettings.md#cloudpcuseraccounttype-values)|The account type of the user on provisioned Cloud PCs. Possible values are: `standardUser`, `administrator`, and `unknownFutureValue`.| +|userAccountType|[cloudPcUserAccountType](../resources/cloudpcorganizationsettings.md#cloudpcuseraccounttype-values)|The account type of the user on provisioned Cloud PCs. Possible values are: `standardUser`, `administrator`, `unknownFutureValue`.| |userPrincipalName|String|The user principal name (UPN) of the user assigned to the Cloud PC.| ### cloudPcDiskEncryptionState values |Member|Description| |:|:|-|notAvailable|The Cloud PC isn't provisioned, or is in a state where encryption isn't available.| +|notAvailable|The Cloud PC isn't provisioned or is in a state where encryption isn't available.| |notEncrypted|The Cloud PC should be encrypted, but the encryption isn't done so yet (reserved, shouldn't happen).|-|encryptedUsingPlatformManagedKey|The Cloud PC is encrypted using a platform managed key. This is the default value if the customer-managed key isn't enabled.| +|encryptedUsingPlatformManagedKey|The Cloud PC is encrypted using a platform-managed key. This member is the default value if the customer-managed key isn't enabled.| |encryptedUsingCustomerManagedKey|The Cloud PC is encrypted using the customer-managed key.| |unknownFutureValue|Evolvable enumeration sentinel value. Don't use.| Represents a cloud-managed virtual desktop. This Cloud PC is also enrolled into |Member|Description| |:|:| |running|The Cloud PC status is running.|-|poweredOff|The Cloud PC status is power off.| +|poweredOff|The Cloud PC status is powered off.| |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). 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). Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following values in this evolvable enum: `movingRegion`, `resizePendingLicense`. |Member|Description| |:|:|-|notProvisioned|The Cloud PC hasn't been provisioned.| +|notProvisioned|The Cloud PC hasn't been provisioned yet.| |provisioning|Cloud PC provisioning is in progress.|-|provisioned|The Cloud PC is provisioned and can be accessed by end users.| -|inGracePeriod|The Cloud PC is in the one week grace period before it’s deprovisioned.| +|provisioned|The Cloud PC is provisioned and users can access it.| +|inGracePeriod|The Cloud PC is in the one-week grace period before deprovision.| |deprovisioning|The Cloud PC is deprovisioning.|-|failed|The operation on Cloud PC has failed.| -|provisionedWithWarnings|The Cloud PC is provisioned and can be accessed by end users but with some warnings. The user can continue to use this Cloud PC.| +|failed|The operation on Cloud PC failed.| +|provisionedWithWarnings|The Cloud PC is provisioned and end users can access it with some warnings. The user can continue to use this Cloud PC.| |resizing|The Cloud PC is resizing.|-|pendingProvision|The provisioning is pending on the Cloud PC. In this case, the number of Cloud PCs in grace period is more than the number of total available licenses. | +|pendingProvision|The provisioning is pending on the Cloud PC. In this case, the number of Cloud PCs in the grace period is more than the number of total available licenses. | |restoring|The Cloud PC is restoring.| |unknownFutureValue|Evolvable enumeration sentinel value. Don't use.| |movingRegion|Indicates that the Cloud PC is being moved from one region to another.|-|resizePendingLicense|Indicates that the Cloud PC resize process has been initiated but can't be completed because the target license hasn't been identified. It's currently awaiting customer action to resolve the licensing issue.| +|resizePendingLicense|Indicates that the Cloud PC resize process was initiated but can't be completed because the target license hasn't been identified. It's currently awaiting customer action to resolve the licensing issue.| ### frontlineCloudPcAccessState values The following table lists the members of an [evolvable enumeration](/graph/best- |activationFailed|Indicates that the frontline Cloud PC activation failed after the user requested a frontline Cloud PC.| |active|Indicates that the frontline Cloud PC is in an active state with a shared-use license assigned, and the user can connect to the Cloud PC.| |activating|Indicates that a user requested to connect the Cloud PC and the service is starting.|-|standbyMode|Indicates that the frontline Cloud PC is in a standby state before it's shut down and deallocated. A frontline Cloud PC in standby state is still accessible by the user.| +|standbyMode|Indicates that the frontline Cloud PC is in a standby state before it's shut down and deallocated. A frontline Cloud PC in a standby state is still accessible by the user.| |unknownFutureValue|Evolvable enumeration sentinel value. Don't use.| ### shiftWorkCloudPcAccessState values (deprecated) The following table lists the members of an [evolvable enumeration](#shiftworkcl |activationFailed|Indicates that the shift work Cloud PC activation failed after the user requested a shift work Cloud PC.| |active|Indicates that the shift work Cloud PC is in an active state with a shared-use license assigned, and the user can connect to the Cloud PC.| |activating|Indicates that a user requested to connect the Cloud PC and the service is starting.|-|waitlisted (deprecated)|Indicates that the shift work Cloud PC is in waitlisted state after the user requests to connect this Cloud PC and all shared use licenses are being actively used. This value is deprecated and will stop returning on May 17, 2023. | +|waitlisted (deprecated)|Indicates that the shift work Cloud PC is in a waitlisted state after the user requests to connect this Cloud PC and all shared use licenses are being actively used. This value is deprecated and will stop returning on May 17, 2023. | |unknownFutureValue|Evolvable enumeration sentinel value. Don't use.| |standbyMode|Indicates that the shift work Cloud PC is in a standby state before it's shut down and deallocated. A shift work Cloud PC in standby state is still accessible by the user.| The following JSON representation shows the resource type. { "@odata.type": "#microsoft.graph.cloudPC", "aadDeviceId": "String",+ "allotmentDisplayName": "String", "connectivityResult": "String", "diskEncryptionState": "String", "displayName": "String", |
v1.0 | Cloudpcauditevent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcauditevent.md | The following JSON representation shows the resource type. ``` json { "@odata.type": "#microsoft.graph.cloudPcAuditEvent",- "id": "String (identifier)", - "displayName": "String", - "componentName": "String", - "actor": { - "@odata.type": "microsoft.graph.cloudPcAuditActor", - "type": "String", - "userPermissions": [ - "String" - ], - "applicationId": "String", - "applicationDisplayName": "String", - "userPrincipalName": "String", - "servicePrincipalName": "String", - "ipAddress": "String", - "userId": "String", - "userRoleScopeTags": [ - { - "@odata.type": "microsoft.graph.cloudPcUserRoleScopeTagInfo", - "displayName": "String", - "roleScopeTagId": "String" - } - ], - "remoteTenantId": "String", - "remoteUserId": "String" - }, "activity": "String", "activityDateTime": "String (timestamp)",- "activityType": "String", "activityOperationType": "String", "activityResult": "String",+ "activityType": "String", + "actor": {"@odata.type": "microsoft.graph.cloudPcAuditActor"}, + "category": "String", + "componentName": "String", "correlationId": "String",- "resources": [ - { - "@odata.type": "microsoft.graph.cloudPcAuditResource", - "displayName": "String", - "modifiedProperties": [ - { - "@odata.type": "microsoft.graph.cloudPcAuditProperty", - "displayName": "String", - "oldValue": "String", - "newValue": "String" - } - ], - "type": "String", - "resourceId": "String" - } - ], - "category": "String" + "displayName": "String", + "id": "String (identifier)", + "resources": [{"@odata.type": "microsoft.graph.cloudPcAuditResource"}] } ``` |
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 |:|:|:| |displayName|String|The resource entity display name.| |modifiedProperties|[cloudPcAuditProperty](../resources/cloudpcauditproperty.md) collection|A list of modified properties.|-|type|String|The type of the audit resource.| |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 -None +None. ## JSON Representation -The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.cloudPcAuditResource" The following is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.cloudPcAuditResource", "displayName": "String",- "modifiedProperties": [ - { - "@odata.type": "microsoft.graph.cloudPcAuditProperty", - "displayName": "String", - "oldValue": "String", - "newValue": "String" - } - ], - "type": "String", - "resourceId": "String" + "modifiedProperties": [{"@odata.type": "microsoft.graph.cloudPcAuditProperty"}], + "resourceId": "String", + "resourceType": "String", + "type": "String" } ``` |
v1.0 | Cloudpcbulkaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcbulkaction.md | + + Title: "cloudPcBulkAction resource type" +description: "An abstract type that represents the bulk action applied to Cloud PCs specified in a parameter." ++ms.localizationpriority: medium ++++# cloudPcBulkAction resource type ++Namespace: microsoft.graph +++An abstract type that represents the bulk action applied to Cloud PCs specified in a parameter. ++Base type of [cloudPcBulkPowerOff](../resources/cloudpcbulkpoweroff.md), [cloudPcBulkPowerOn](../resources/cloudpcbulkpoweron.md), [cloudPcBulkReprovision](../resources/cloudpcbulkreprovision.md), [cloudPcBulkResize](../resources/cloudpcbulkresize.md), [cloudPcBulkRestart](../resources/cloudpcbulkrestart.md), [cloudPcBulkRestore](../resources/cloudpcbulkrestore.md), and [cloudPcBulkTroubleshoot](../resources/cloudpcbulktroubleshoot.md). ++Inherits from [entity](../resources/entity.md). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List bulkActions](../api/virtualendpoint-list-bulkactions.md)|[cloudPcBulkAction](../resources/cloudpcbulkaction.md) collection|Get a list of the [cloudPcBulkAction](../resources/cloudpcbulkaction.md) objects and their properties.| +|[Create cloudPcBulkAction](../api/virtualendpoint-post-bulkactions.md)|[cloudPcBulkAction](../resources/cloudpcbulkaction.md)|Create a new [cloudPcBulkAction](../resources/cloudpcbulkaction.md) object.| +|[Get cloudPcBulkAction](../api/cloudpcbulkaction-get.md)|[cloudPcBulkAction](../resources/cloudpcbulkaction.md)|Read the properties and relationships of a [cloudPcBulkAction](../resources/cloudpcbulkaction.md) object.| ++## Properties +|Property|Type|Description| +|:|:|:| +|actionSummary|[cloudPcBulkActionSummary](../resources/cloudpcbulkactionsummary.md)|Run summary of this bulk action.| +|cloudPcIDs|String collection|IDs of the Cloud PCs the bulk action applies to. | +|createdDateTime|DateTimeOffset|The date and time when the bulk action was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| +|displayName|String|Name of the bulk action.| +|id|String|ID of the bulk action. Inherited from [entity](entity.md).| +|scheduledDuringMaintenanceWindow|Boolean|Indicates whether the bulk actions can be initiated during maintenance window. When `true`, bulk action will use maintenance window to schedule action, When `false` means bulk action will not use the maintenance window. Default value is `false`.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.cloudPcBulkAction", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.cloudPcBulkAction", + "actionSummary": {"@odata.type": "microsoft.graph.cloudPcBulkActionSummary"}, + "cloudPcIds": ["String"], + "createdDateTime": "String (timestamp)", + "displayName": "String", + "id": "String (identifier)", + "scheduledDuringMaintenanceWindow": "Boolean" +} +``` |
v1.0 | Cloudpcbulkactionsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcbulkactionsummary.md | + + Title: "cloudPcBulkActionSummary resource type" +description: "Represents a run summary of the bulk actions." ++ms.localizationpriority: medium ++++# cloudPcBulkActionSummary resource type ++Namespace: microsoft.graph +++Represents a run summary of the bulk actions. ++## Properties +|Property|Type|Description| +|:|:|:| +|failedCount|Int32|The number of Cloud PCs where the action failed.| +|inProgressCount|Int32|The number of Cloud PCs where the action is in progress.| +|notSupportedCount|Int32|The number of Cloud PCs where the action isn't supported.| +|pendingCount|Int32|The number of Cloud PCs where the action is pending.| +|successfulCount|Int32|The number of Cloud PCs where the action is successful.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.cloudPcBulkActionSummary" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.cloudPcBulkActionSummary", + "failedCount": "Int32", + "inProgressCount": "Int32", + "notSupportedCount": "Int32", + "pendingCount": "Int32", + "successfulCount": "Int32" +} +``` |
v1.0 | Cloudpcbulkpoweroff | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcbulkpoweroff.md | + + Title: "cloudPcBulkPowerOff resource type" +description: "Defines the bulk power-off action, with Cloud PC IDs as the only input parameter for the bulk power-off operation." ++ms.localizationpriority: medium ++++# cloudPcBulkPowerOff resource type ++Namespace: microsoft.graph +++Defines the bulk power-off action, with Cloud PC IDs as the only input parameter for the bulk power-off operation. ++Inherits from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). ++## Methods ++## Properties +|Property|Type|Description| +|:|:|:| +|actionSummary|[cloudPcBulkActionSummary](../resources/cloudpcbulkactionsummary.md)|Run summary of this bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|cloudPcIds|String collection|IDs of the Cloud PCs the bulk action applies to. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|createdDateTime|DateTimeOffset|The date and time when the bulk action was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|displayName|String|Name of the bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|id|String|ID of the bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.cloudPcBulkPowerOff", + "baseType": "microsoft.graph.cloudPcBulkAction", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.cloudPcBulkPowerOff", + "actionSummary": {"@odata.type": "microsoft.graph.cloudPcBulkActionSummary"}, + "cloudPcIds": ["String"], + "createdDateTime": "String (timestamp)", + "displayName": "String", + "id": "String (identifier)" +} +``` + |
v1.0 | Cloudpcbulkpoweron | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcbulkpoweron.md | + + Title: "cloudPcBulkPowerOn resource type" +description: "Defines the bulk power-on action, with Cloud PC IDs as the only input parameter for the bulk power-on operation." ++ms.localizationpriority: medium ++++# cloudPcBulkPowerOn resource type ++Namespace: microsoft.graph +++Defines the bulk power-on action, with Cloud PC IDs as the only input parameter for the bulk power-on operation. ++Inherits from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). ++## Methods ++## Properties +|Property|Type|Description| +|:|:|:| +|actionSummary|[cloudPcBulkActionSummary](../resources/cloudpcbulkactionsummary.md)|Run summary of this bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|cloudPcIds|String collection|IDs of the Cloud PCs the bulk action applies to. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|createdDateTime|DateTimeOffset|The date and time when the bulk action was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|displayName|String|Name of the bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|id|String|ID of the bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.cloudPcBulkPowerOn", + "baseType": "microsoft.graph.cloudPcBulkAction", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.cloudPcBulkPowerOn", + "actionSummary": {"@odata.type": "microsoft.graph.cloudPcBulkActionSummary"}, + "cloudPcIds": ["String"], + "createdDateTime": "String (timestamp)", + "displayName": "String", + "id": "String (identifier)" +} +``` + |
v1.0 | Cloudpcbulkreprovision | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcbulkreprovision.md | + + Title: "cloudPcBulkReprovision resource type" +description: "Represents the entity that performs a bulk reprovision action." ++ms.localizationpriority: medium ++++# cloudPcBulkReprovision resource type ++Namespace: microsoft.graph +++Represents the entity that performs a bulk reprovision action. If provisioning a Cloud PC device through the standard steps (creating a provisioning policy and assigning it to trigger Cloud PC provisioning for a new user), customers can use this API to re-create the Cloud PC by providing the Cloud PC ID. ++Inherits from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). ++## Methods ++## Properties +|Property|Type|Description| +|:|:|:| +|actionSummary|[cloudPcBulkActionSummary](../resources/cloudpcbulkactionsummary.md)|Run summary of this bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|cloudPcIds|String collection|IDs of the Cloud PCs the bulk action applies to. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|createdDateTime|DateTimeOffset|The date and time when the bulk action was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|displayName|String|Name of the bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|id|String|ID of the bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.cloudPcBulkReprovision", + "baseType": "microsoft.graph.cloudPcBulkAction", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.cloudPcBulkReprovision", + "actionSummary": {"@odata.type": "microsoft.graph.cloudPcBulkActionSummary"}, + "cloudPcIds": ["String"], + "createdDateTime": "String (timestamp)", + "displayName": "String", + "id": "String (identifier)" +} +``` |
v1.0 | Cloudpcbulkresize | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcbulkresize.md | + + Title: "cloudPcBulkResize resource type" +description: "Represents the entity that performs a bulk resize action." ++ms.localizationpriority: medium ++++# cloudPcBulkResize resource type ++Namespace: microsoft.graph +++Represents the entity that performs a bulk resize action. When IT administrators want to upgrade or downgrade Cloud PC devices, they can use this API to trigger a resize remote action for the Cloud PC. This API requires a parameter that specifies the target service plan ID that indicates the configuration to which the Cloud PC should be resized. ++Inherits from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|actionSummary|[cloudPcBulkActionSummary](../resources/cloudpcbulkactionsummary.md)|Run summary of this bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|cloudPcIds|String collection|IDs of the Cloud PCs the bulk action applies to. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|createdDateTime|DateTimeOffset|The date and time when the bulk action was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|displayName|String|Name of the bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|id|String|ID of the bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|targetServicePlanId|String|The target service plan ID of the resize configuration with new vCPU and storage size.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.cloudPcBulkResize", + "baseType": "microsoft.graph.cloudPcBulkAction", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.cloudPcBulkResize", + "actionSummary": {"@odata.type": "microsoft.graph.cloudPcBulkActionSummary"}, + "cloudPcIds": ["String"], + "createdDateTime": "String (timestamp)", + "displayName": "String", + "id": "String (identifier)", + "targetServicePlanId": "String" +} +``` |
v1.0 | Cloudpcbulkrestart | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcbulkrestart.md | + + Title: "cloudPcBulkRestart resource type" +description: "Represents the entity that performs a bulk restart action." ++ms.localizationpriority: medium ++++# cloudPcBulkRestart resource type ++Namespace: microsoft.graph +++Represents the entity that performs a bulk restart action. ++Inherits from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). ++## Methods ++## Properties +|Property|Type|Description| +|:|:|:| +|actionSummary|[cloudPcBulkActionSummary](../resources/cloudpcbulkactionsummary.md)|Run summary of this bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|cloudPcIds|String collection|IDs of the Cloud PCs the bulk action applies to. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|createdDateTime|DateTimeOffset|The date and time when the bulk action was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|displayName|String|Name of the bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|id|String|ID of the bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.cloudPcBulkRestart", + "baseType": "microsoft.graph.cloudPcBulkAction", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.cloudPcBulkRestart", + "actionSummary": {"@odata.type": "microsoft.graph.cloudPcBulkActionSummary"}, + "cloudPcIds": ["String"], + "createdDateTime": "String (timestamp)", + "displayName": "String", + "id": "String (identifier)" +} +``` |
v1.0 | Cloudpcbulkrestore | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcbulkrestore.md | + + Title: "cloudPcBulkRestore resource type" +description: "Represents the entity that performs a bulk restore action." ++ms.localizationpriority: medium ++++# cloudPcBulkRestore resource type ++Namespace: microsoft.graph +++Represents the entity that performs a bulk restore action. Perform a bulk restore for a set of Cloud PCs with associated Cloud PC ID and restore point. If some of the devices don't have any snapshots to restore, they're set as restore failed, while the others with snapshots still be triggered successfully. ++Inherits from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). ++## Methods ++## Properties +|Property|Type|Description| +|:|:|:| +|actionSummary|[cloudPcBulkActionSummary](../resources/cloudpcbulkactionsummary.md)|Run summary of this bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|cloudPcIds|String collection|IDs of the Cloud PCs the bulk action applies to. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|createdDateTime|DateTimeOffset|The date and time when the bulk action was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|displayName|String|Name of the bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|id|String|ID of the bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|restorePointDateTime|DateTimeOffset|The date and time point for the selected Cloud PCs to restore. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| +|timeRange|restoreTimeRange|The time range of the restore point. The possible values are: `before`, `after`, `beforeOrAfter`, `unknownFutureValue`. The default value is `before`.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.cloudPcBulkRestore", + "baseType": "microsoft.graph.cloudPcBulkAction", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.cloudPcBulkRestore", + "actionSummary": {"@odata.type": "microsoft.graph.cloudPcBulkActionSummary"}, + "cloudPcIds": ["String"], + "createdDateTime": "String (timestamp)", + "displayName": "String", + "id": "String (identifier)", + "restorePointDateTime": "String (timestamp)", + "timeRange": "String" +} +``` |
v1.0 | Cloudpcbulktroubleshoot | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcbulktroubleshoot.md | + + Title: "cloudPcBulkTroubleshoot resource type" +description: "Represents the entity that performs a bulk troubleshooting action." ++ms.localizationpriority: medium ++++# cloudPcBulkTroubleshoot resource type ++Namespace: microsoft.graph +++Represents the entity that performs a bulk troubleshooting action. This resource triggers an action that troubleshoots the Cloud PC and session host health status. ++Inherits from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). ++## Methods ++## Properties +|Property|Type|Description| +|:|:|:| +|actionSummary|[cloudPcBulkActionSummary](../resources/cloudpcbulkactionsummary.md)|Run summary of this bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|cloudPcIds|String collection|IDs of the Cloud PCs the bulk action applies to. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|createdDateTime|DateTimeOffset|The date and time when the bulk action was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|displayName|String|Name of the bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | +|id|String|ID of the bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md). | ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.cloudPcBulkTroubleshoot", + "baseType": "microsoft.graph.cloudPcBulkAction", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.cloudPcBulkTroubleshoot", + "actionSummary": {"@odata.type": "microsoft.graph.cloudPcBulkActionSummary"}, + "cloudPcIds": ["String"], + "createdDateTime": "String (timestamp)", + "displayName": "String", + "id": "String (identifier)" +} +``` |
v1.0 | Cloudpcexternalpartnersetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcexternalpartnersetting.md | Represents an external partner setting on Cloud PC. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Cloudpcorganizationsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcorganizationsettings.md | Represents the Cloud PC organization settings for a tenant. A tenant has only on None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Cloudpcprovisioningpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcprovisioningpolicy.md | Represents a Cloud PC provisioning policy. |[Update cloudPcProvisioningPolicy](../api/cloudpcprovisioningpolicy-update.md)|[cloudPcProvisioningPolicy](../resources/cloudpcprovisioningpolicy.md)|Update the properties of a [cloudPcProvisioningPolicy](../resources/cloudpcprovisioningpolicy.md) object.| |[Delete cloudPcProvisioningPolicy](../api/cloudpcprovisioningpolicy-delete.md)|None|Delete a [cloudPcProvisioningPolicy](../resources/cloudpcprovisioningpolicy.md) object.| |[Assign cloudPcProvisioningPolicy](../api/cloudpcprovisioningpolicy-assign.md)|None |Assign a [cloudPcProvisioningPolicy](../resources/cloudpcprovisioningpolicy.md) to user groups.|+|[Apply cloudPcProvisioningPolicy](../api/cloudpcprovisioningpolicy-apply.md)|None|Apply the current [provisioning policy](../resources/cloudpcprovisioningpolicy.md) configuration to all Cloud PC devices under a specified policy. Currently, you can only change the region.| +|[applyConfig](../api/cloudpcprovisioningpolicy-applyconfig.md)|None|Update the [provisioning policy](../resources/cloudpcprovisioningpolicy.md) configuration for a set of Cloud PC devices by their IDs.| ## Properties Represents a Cloud PC provisioning policy. |description|String|The provisioning policy description. Supports `$filter`, `$select`, and `$orderBy`. | |displayName|String|The display name for the provisioning policy.| |domainJoinConfigurations|[cloudPcDomainJoinConfiguration](../resources/cloudpcdomainjoinconfiguration.md) collection|Specifies a list ordered by priority on how Cloud PCs join Microsoft Entra ID (Azure AD). Supports `$select`.|-|enableSingleSignOn|Boolean|`True` if the provisioned Cloud PC can be accessed by single sign-on. `False` indicates that the provisioned Cloud PC doesn't support this feature. The default value is `false`. Windows 365 users can use single sign-on to authenticate to Microsoft Entra ID with passwordless options (for example, FIDO keys) to access their Cloud PC. Optional.| +|enableSingleSignOn|Boolean|`True` if single sign-on can access the provisioned Cloud PC. `False` indicates that the provisioned Cloud PC doesn't support this feature. The default value is `false`. Windows 365 users can use single sign-on to authenticate to Microsoft Entra ID with passwordless options (for example, FIDO keys) to access their Cloud PC. Optional.| |gracePeriodInHours|Int32|The number of hours to wait before reprovisioning/deprovisioning happens. Read-only.| |id|String|The unique identifier associated with the provisioning policy. This ID is auto populated during the creation of a new provisioning policy. Read-only. Supports `$filter`, `$select`, and `$orderBy`. | |imageDisplayName|String|The display name of the operating system image that is used for provisioning. For example, `Windows 11 Preview + Microsoft 365 Apps 23H2 23H2`. Supports `$filter`, `$select`, and `$orderBy`. | |imageId|String|The unique identifier that represents an operating system image that is used for provisioning new Cloud PCs. The format for a gallery type image is: {publisherName_offerName_skuName}. Supported values for each of the parameters are:<ul><li>publisher: `Microsoftwindowsdesktop`</li> <li>offer: `windows-ent-cpc`</li> <li>sku: `21h1-ent-cpc-m365`, `21h1-ent-cpc-os`, `20h2-ent-cpc-m365`, `20h2-ent-cpc-os`, `20h1-ent-cpc-m365`, `20h1-ent-cpc-os`, `19h2-ent-cpc-m365`, and `19h2-ent-cpc-os`</li></ul> Supports `$filter`, `$select`, and `$orderBy`.| |imageType|cloudPcProvisioningPolicyImageType|The type of operating system image (custom or gallery) that is used for provisioning on Cloud PCs. Possible values are: `gallery`, `custom`. The default value is `gallery`. Supports $filter, $select, and $orderBy.| |localAdminEnabled|Boolean|When `true`, the local admin is enabled for Cloud PCs; `false` indicates that the local admin isn't enabled for Cloud PCs. The default value is `false`. Supports `$filter`, `$select`, and `$orderBy`.|-|managedBy|[cloudPcManagementService](../resources/cloudpconpremisesconnection.md#cloudpcmanagementservice-values)|Indicates the service that manages the provisioning policy. Possible values are: `windows365`, `devBox`, `unknownFutureValue`, `rpaBox`. The default value is `windows365`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `rpaBox`. Supports `$filter`, `$select`, and `$orderBy`.| +|managedBy|[cloudPcManagementService](../resources/cloudpconpremisesconnection.md#cloudpcmanagementservice-values)|Indicates the service that manages the provisioning policy. Possible values are: `windows365`, `devBox`, `unknownFutureValue`, `rpaBox`. The default value is `windows365`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `rpaBox`. Supports `$filter`, `$select`, and `$orderBy`.| |microsoftManagedDesktop|[microsoftManagedDesktop](../resources/microsoftmanageddesktop.md)|The specific settings to **microsoftManagedDesktop** that enables Microsoft Managed Desktop customers to get device managed experience for Cloud PC. To enable **microsoftManagedDesktop** to provide more value, an admin needs to specify certain settings in it. Supports `$filter`, `$select`, and `$orderBy`.|-|provisioningType|[cloudPcProvisioningType](../resources/cloudpcprovisioningpolicy.md#cloudpcprovisioningtype-values)|Specifies the type of license used when provisioning Cloud PCs using this policy. By default, the license type is `dedicated` if the **provisioningType** isn't specified when you create the **cloudPcProvisioningPolicy**. You can't change this property after the **cloudPcProvisioningPolicy** was created. Possible values are: `dedicated`, `shared`, `unknownFutureValue`.| +|provisioningType|[cloudPcProvisioningType](../resources/cloudpcprovisioningpolicy.md#cloudpcprovisioningtype-values)|Specifies the type of licenses to be used when provisioning Cloud PCs using this policy. The possible values are `dedicated`, `shared`, `unknownFutureValue`, `sharedByUser`, `sharedByEntraGroup`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `sharedByUser`, `sharedByEntraGroup`. The `shared` member is deprecated and will stop returning on April 30, 2027; going forward, use the `sharedByUser` member. For example, a `dedicated` service plan can be assigned to only one user and provision only one Cloud PC. The `shared` and `sharedByUser` plans require customers to purchase a shared service plan. Each shared license purchased can enable up to three Cloud PCs, with only one user signed in at a time. The `sharedByEntraGroup` plan also requires the purchase of a shared service plan. Each shared license under this plan can enable one Cloud PC, which is shared for the group according to the assignments of this policy. By default, the license type is `dedicated` if the **provisioningType** isn't specified when you create the **cloudPcProvisioningPolicy**. You can't change this property after the **cloudPcProvisioningPolicy** is created.| |windowsSetting|[cloudPcWindowsSettings](../resources/cloudpcwindowssetting.md)|Indicates a specific Windows setting to configure during the creation of Cloud PCs for this provisioning policy. Supports `$select`. |-|domainJoinConfiguration (deprecated)|[cloudPcDomainJoinConfiguration](../resources/cloudpcdomainjoinconfiguration.md)|Specifies how Cloud PCs join Microsoft Entra ID.| -|onPremisesConnectionId (deprecated)|String|The ID of the [cloudPcOnPremisesConnection](../resources/cloudpconpremisesconnection.md). To ensure that Cloud PCs have network connectivity and that they domain join, choose a connection with a virtual network thatΓÇÖs validated by the Cloud PC service.| +|domainJoinConfiguration (deprecated)|[cloudPcDomainJoinConfiguration](../resources/cloudpcdomainjoinconfiguration.md)|Specifies how Cloud PCs join Microsoft Entra ID. The **domainJoinConfiguration** property is deprecated and will stop returning data on May 31, 2024. Going forward, use the **domainJoinConfigurations** property.| +|onPremisesConnectionId (deprecated)|String|The ID of the [cloudPcOnPremisesConnection](../resources/cloudpconpremisesconnection.md). To ensure that Cloud PCs have network connectivity and that they domain join, choose a connection with a virtual network that the Cloud PC service validated it. The **onPremisesConnectionId** property is deprecated and will stop returning data on May 31, 2024. Going forward, use the **domainJoinConfigurations** property.| |windowsSettings (deprecated)|[cloudPcWindowsSettings](../resources/cloudpcwindowssettings.md)|Specific Windows settings to configure during the creation of Cloud PCs for this provisioning policy. Supports `$select`. The **windowsSettings** property is deprecated and will stop returning data on January 31, 2024. Going forward, use the **windowsSetting** property.| ### cloudPcProvisioningType values + 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: `sharedByUser`, `sharedByEntraGroup`. + | Member | Description | |:--|:--| | dedicated | Indicates that a dedicated license is used for provisioning Cloud PCs. Default value. |-| shared | Indicates that a shared license is used for provisioning Cloud PCs. | -| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | +| shared (deprecated) | Indicates that a shared license is used for provisioning Cloud PCs. The `shared` member is deprecated and will stop returning on April 30, 2027. Going forward, use the `sharedByUser` member. +| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | +| sharedByUser | Indicates the provisioning policy when a dedicated Cloud PC is provisioned for each user in the assignment group. Users are always connected to the same Cloud PC. However, Cloud PC availability is limited by the total number of active sessions. | +| sharedByEntraGroup | Indicates the provisioning policy associated with Cloud PCs shared by a Microsoft Entra (Azure AD) group. When a shared Cloud PC is provisioned, it becomes available for any user in the Microsoft Entra ID assignment group to connect to. Users may be connected to a different Cloud PC on each connection and availability is limited by the number of provisioned Cloud PCs. | ## Relationships |
v1.0 | Cloudpcremoteactionresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcremoteactionresult.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.cloudPcRemoteActionResult" |
v1.0 | Cloudpcresizevalidationresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcresizevalidationresult.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.cloudPcResizeValidationResult" |
v1.0 | Cloudpcserviceplan | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcserviceplan.md | For examples of currently available service plans, see [Windows 365 compare plan |:|:|:| |displayName|String|The name for the service plan. Read-only.| |id|String|Unique identifier for the service plan. Read-only.|+|provisioningType|[cloudPcProvisioningType](../resources/cloudpcprovisioningpolicy.md#cloudpcprovisioningtype-values)|Specifies the type of license used when provisioning Cloud PCs. By default, the license type is `dedicated`. Possible values are: `dedicated`, `shared`, `unknownFutureValue`, `sharedByUser`, `sharedByEntraGroup`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `sharedByUser`, `sharedByEntraGroup`. The `shared` member is deprecated and will stop returning on April 30, 2027; going forward, use the `sharedByUser` member.| |ramInGB|Int32|The size of the RAM in GB. Read-only.|+|supportedSolution|[cloudPcManagementService](../resources/cloudpconpremisesconnection.md#cloudpcmanagementservice-values)|The supported service or solution for the region. The possible values are: `windows365`, `devBox`, `rpaBox`, `unknownFutureValue`. Read-only.| |storageInGB|Int32|The size of the OS Disk in GB. Read-only.| |type|[cloudPcServicePlanType](#cloudpcserviceplantype-values)|The type of the service plan. Possible values are: `enterprise`, `business`, `unknownFutureValue`. Read-only.| |userProfileInGB|Int32|The size of the user profile disk in GB. Read-only.| |vCpuCount|Int32|The number of vCPUs. Read-only.|-|supportedSolution|[cloudPcManagementService](../resources/cloudpconpremisesconnection.md#cloudpcmanagementservice-values)|The supported service or solution for the region. The possible values are: `windows365`, `devBox`, `rpaBox`, `unknownFutureValue`. Read-only.| -|provisioningType|[cloudPcProvisioningType](../resources/cloudpcprovisioningpolicy.md#cloudpcprovisioningtype-values)|Specifies the type of license used when provisioning Cloud PCs. By default, the license type is `dedicated`. Possible values are: `dedicated`, `shared`, `unknownFutureValue`.| ### cloudPcServicePlanType values For examples of currently available service plans, see [Windows 365 compare plan |:|:| |enterprise|Enterprise service plan type for enterprise customers.| |business|Business service plan type for Very Small Business (VSB) customers.|-|unknownFutureValue|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|Evolvable enumeration sentinel value. Don't use.| ## Relationships None. ## JSON representation -The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Cloudpcuserrolescopetaginfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcuserrolescopetaginfo.md | Represents the scope tag info with display name and identity. None ## JSON Representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.cloudPcUserRoleScopeTagInfo" |
v1.0 | Cloudrealtimecommunicationinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudrealtimecommunicationinfo.md | Represents a group of properties that relate to Microsoft real-time communicatio | isSipEnabled | Boolean | Indicates whether the user has a SIP-enabled client registered for them. Read-only. | ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.cloudRealtimeCommunicationInfo" |
v1.0 | Command | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/command.md | None ## Relationships None ## JSON Representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", "@odata.type": "microsoft.graph.command" |
v1.0 | Commsoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/commsoperation.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Communications Api Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/communications-api-overview.md | This API provides calling functionality as well as the ability to create and ret One of the following [permissions](/graph/permissions-reference#calls-permissions) is required to access the cloud communications API. These permissions need to be granted by the administrator. -| Scenario | Permissions | -|:-|:--| -| Calling | Calls.JoinGroupCallAsGuest.All, Calls.JoinGroupCall.All, Calls.Initiate.All, Calls.InitiateGroupCall.All, Calls.AccessMedia.All | -| Meetings | OnlineMeetings.ReadWrite.All, OnlineMeetings.Read.All | -| Presence | Presence.Read, Presence.Read.All | -| Call records | CallRecords.Read.All | +| Scenario | Permissions | +|:--|:--| +| Call records | CallRecords.Read.All | +| Calling | Calls.JoinGroupCallAsGuest.All, Calls.JoinGroupCall.All, Calls.Initiate.All, Calls.InitiateGroupCall.All, Calls.AccessMedia.All | +| Meetings | OnlineMeetings.ReadWrite.All, OnlineMeetings.Read.All | +| Presence | Presence.Read, Presence.Read.All | +| Virtual event | VirtualEvent.Read, VirtualEvent.ReadWrite | + ## Common use cases The following table lists some of the common uses for the cloud communications A | Use cases | REST resources | See also | |:|:|:-|-| Creating and joining 1-1 and group calls | [Call](/graph/api/resources/call?view=graph-rest-beta&preserve-view=true&preserve-view=true)| [Methods for calls](/graph/api/resources/call?view=graph-rest-beta&preserve-view=true#methods&preserve-view=true)| +| Creating and joining 1-1 and group calls | [call](/graph/api/resources/call?view=graph-rest-beta&preserve-view=true&preserve-view=true)| [Methods for calls](/graph/api/resources/call?view=graph-rest-beta&preserve-view=true#methods&preserve-view=true)| |IVR calls | | [Methods for IVR](/graph/api/resources/calls-api-ivr-overview?view=graph-rest-beta?&preserve-view=true&preserve-view=true)-| Call controls (participant) | [Participant](/graph/api/resources/participant?view=graph-rest-beta&preserve-view=true&preserve-view=true) || +| Call controls (participant) | [participant](/graph/api/resources/participant?view=graph-rest-beta&preserve-view=true&preserve-view=true) || |Meetings|[onlineMeeting](/graph/api/resources/onlinemeeting?view=graph-rest-beta&preserve-view=true&preserve-view=true)| [Methods for meetings](/graph/api/resources/onlinemeeting?view=graph-rest-beta&preserve-view=true#methods&preserve-view=true)| |Presence | [presence](/graph/api/resources/presence?view=graph-rest-beta&preserve-view=true) | [Methods for presence](/graph/api/resources/presence?view=graph-rest-beta&preserve-view=true#methods) | | Retrieving call records | [callRecord](/graph/api/resources/callrecords-callrecord?view=graph-rest-beta&preserve-view=true&preserve-view=true) | [Webhook subscriptions](/graph/api/resources/webhooks?view=graph-rest-beta&preserve-view=true&preserve-view=true) |+| Virtual events | [virtualEvent](/graph/api/resources/virtualevent?view=graph-rest-beta&preserve-view=true) | [Methods for virtualEventTownhall](/graph/api/resources/virtualeventtownhall#methods?view=graph-rest-beta&preserve-view=true), [Methods for virtualEventWebinar](/graph/api/resources/virtualeventwebinar#methods?view=graph-rest-beta&preserve-view=true) | ## Common properties |
v1.0 | Conditionalaccessaudience | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/conditionalaccessaudience.md | + + Title: "conditionalaccessAudience resource type" +description: "Represents the audience evaluated by Conditional Access during a sign-in event." +ms.localizationpriority: medium +++++# conditionalAccessAudience resource type ++Namespace: microsoft.graph +++Represents the audience evaluated by Conditional Access during a sign-in event. ++## Properties ++| Property | Type |Description| +|:|:--|:-| +|applicationId|String|The ID of the application.| +|audienceReasons|[conditionalAccessAudienceReason](#conditionalaccessaudiencereason-values)|Indicates the reasons this audience was included for a sign-in request.| ++## conditionalAccessAudienceReason values ++|Member| +|:--| +|resourcelessRequest| +|confidentialClientIdToken| +|confidentialClientNonIdToken| +|resourceMapping| +|resourceMappingDefault| +|scopeMapping| +|scopeMappingDefault| +|delegatedScope | +|firstPartyResourceDefault| +|thirdPartyResourceDefault| +|unknownFutureValue| ++## JSON representation ++The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.conditionalAccessAudience" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.conditionalAccessAudience", + "applicationID": "String", + "audienceReasons": "String" +} +``` |
v1.0 | Conditionalaccessguestsorexternalusers | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/conditionalaccessguestsorexternalusers.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Conditionalaccesssessioncontrols | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/conditionalaccesssessioncontrols.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Connector | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/connector.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Connectors are lightweight agents that sit on-premises and facilitate the outbound connection to the [Microsoft Entra application proxy](/azure/active-directory/app-proxy/what-is-application-proxy) service. Each connector is part of a [connectorGroup](connectorgroup.md). +Represents an Application Proxy connector. Connectors are lightweight agents that sit on-premises and facilitate the outbound connection to the [Microsoft Entra application proxy](/azure/active-directory/app-proxy/what-is-application-proxy) service. Each connector is part of a [connectorGroup](connectorgroup.md). ## Methods | Method | Return Type | Description | |:-|:|:| | [List connectors](../api/connector-list.md) | [connector](connector.md) collection | Retrieve a list of connector objects. | -| [Get connector](../api/connector-get.md) | [connector](connector.md) | Read properties and relationships of connector object. | -| [List memberOf](../api/connector-list-memberof.md) | [connectorGroup](connectorgroup.md) collection | List the connectorGroup object collection the connector is a member of. | -| [Add connector to connectorGroup](../api/connector-post-memberof.md)| [connectorGroup](connectorgroup.md) | Add a connector to a connectorGroup. | +| [Get connector](../api/connector-get.md) | [connector](connector.md) | Read the properties and relationships of a connector object. | +| [List memberOf](../api/connector-list-memberof.md) | [connectorGroup](connectorgroup.md) collection | List the **connectorGroup** object collection the connector is a member of. | +| [Add connector to connectorGroup](../api/connector-post-memberof.md)| [connectorGroup](connectorgroup.md) | Add a connector to a **connectorGroup**. | ## Properties | Property | Type | Description | |:-|:|:|-|externalIp|String| The external IP address as detected by the the connector server. Read-only. | -|id|String| Unique identifier of the connector. Read-only. | -|machineName|String| The machine name the connector is installed and running on. | -|status|connectorStatus| Indicates the status of the connector. Possible values are: `active`, `inactive`. Read-only. | +|externalIp|String| The external IP address as detected by the connector server. Read-only. | +|id|String| The unique identifier of the connector. Read-only. | +|machineName|String| The name of the computer on which the connector is installed and runs on. | +|status|connectorStatus| Indicates the status of the connector. The possible values are: `active`, `inactive`. Read-only. | +|version|String|The version of the connector.| ## Relationships | Relationship | Type |Description| |:|:--|:-|-|memberOf|[connectorGroup](connectorgroup.md) collection| The connectorGroup that the connector is a member of. Read-only. | +|memberOf|[connectorGroup](connectorgroup.md) collection| The **connectorGroup** that the connector is a member of. Read-only. | ## JSON representation -The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", The following is a JSON representation of the resource. "externalIp": "String", "id": "String (identifier)", "machineName": "String",- "status": "string" + "status": "String", + "version": "String" }- ``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 |
v1.0 | Connectors Api Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/connectors-api-overview.md | The following are current known limitations: - An application is limited to 25 concurrent operations on a connection. - Connections have a capacity limit of 5,000,000 items or ~350 GB of data. - Maximum size of an **externalItem** entity is 4 MB.-- Sorting results is not supported. ## Next steps -- See the [Microsoft Graph connectors overview](https://learn.microsoft.com/graph/connecting-external-content-connectors-overview).+- See the [Microsoft Graph connectors overview](/graph/connecting-external-content-connectors-overview). - Drill down on the methods, properties, and relationships of the [externalConnection](externalconnectors-externalconnection.md), [schema](externalconnectors-schema.md), and [externalItem](externalconnectors-externalitem.md) resources. - Check out the [Microsoft Graph postman collection](https://www.postman.com/microsoftgraph/workspace/microsoft-graph/folder/455214-66cbb476-ad94-448e-ba5a-ef58e1da7a90?ctx=documentation). - Check out the [sample search connector](https://github.com/microsoftgraph/msgraph-search-connector-sample). |
v1.0 | Consentrequests Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/consentrequests-overview.md | Before an app can be used to access any data in your organization, the admin mus The Microsoft Entra consent workflow allows users to request the tenant admins to grant consent to apps that require admin approval. The consent requests APIs in Microsoft Graph allows admin to configure the consent workflow and track consent requests for both apps and users. >[!NOTE]->The current APIs are limited to configuring the workflow and reading the list of requests. At this time, there arenΓÇÖt any methods available to programmatically approve or deny a request. However, the contents of the request can be used to recreate a URL which can be used to grant admin consent and approve a request. +>The current APIs are limited to configuring the workflow and reading the list of requests. At this time, there aren't any methods available to programmatically approve or deny a request. However, the contents of the request can be used to recreate a URL which can be used to grant admin consent and approve a request. [!INCLUDE [GDPR-related-guidance](../../includes/gdpr-msgraph-export-note.md)] The following directory roles are required for a calling application. | Operation | Delegated permissions | Required directory role of the calling user | |:|:|:--|-| Read | ConsentRequest.Read.All, ConsentRequest.ReadWrite.All | Global Reader, Cloud App Administrator, Application Administrator, or Global Administrator | +| Read | ConsentRequest.Read.All, ConsentRequest.ReadWrite.All | Global Reader, Cloud App Administrator, or Application Administrator | ## Related content |
v1.0 | Contenttypeinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/contenttypeinfo.md | Represents the SharePoint [contentType](contenttype.md) of an item. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.contentTypeInfo", "@type.aka": "oneDrive.contentTypeFacet" } --> |
v1.0 | Contract | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/contract.md | None ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Conversation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/conversation.md | This resource supports subscribing to [change notifications](/graph/webhooks). ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Conversationthread | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/conversationthread.md | A new thread is created when a recipient is removed from the thread. ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Conversionuserdetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/conversionuserdetails.md | description: "Represents information that the API returns after a user is conver ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Convertidresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/convertidresult.md | The result of an ID format conversion performed by the [translateExchangeIds](.. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Crosstenantaccesspolicyconfigurationpartner | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/crosstenantaccesspolicyconfigurationpartner.md | For any partner-specific property that is `null`, these settings will inherit th ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "tenantId", |
v1.0 | Customaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/customaction.md | Represents any custom actions that a label may provide, if configured by the adm ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Customauthenticationextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/customauthenticationextension.md | Inherits from [customCalloutExtension](../resources/customcalloutextension.md). Learn how to use this API when [Configuring a custom claim provider token issuance event (preview)](/azure/active-directory/develop/custom-extension-get-started?tabs=microsoft-graph?toc=/graph/toc.json&context=graph/context). +> [!NOTE] +> +> You can have a maximum of 100 custom extension policies. + ## Methods |Method|Return type|Description| |:|:|:| |
v1.0 | Customextensionauthenticationconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/customextensionauthenticationconfiguration.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.customExtensionAuthenticationConfiguration", |
v1.0 | Customextensionclientconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/customextensionclientconfiguration.md | Connection settings that define how long Microsoft Entra ID can wait for a respo None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.customExtensionClientConfiguration" |
v1.0 | Customextensionhandler | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/customextensionhandler.md | None. |customExtension|[customAccessPackageWorkflowExtension](../resources/customaccesspackageworkflowextension.md)|Indicates which custom workflow extension is executed at this stage. Nullable. Supports `$expand`.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Customextensionstagesetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/customextensionstagesetting.md | None |customExtension|[customCalloutExtension](../resources/customcalloutextension.md)|Indicates the custom workflow extension that is executed at this stage. Nullable. Supports `$expand`.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Customtimezone | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/customtimezone.md | Represents a time zone where the transition from standard to daylight saving tim ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Dailyuserinsightmetricsroot | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/dailyuserinsightmetricsroot.md | None. |Relationship|Type|Description| |:|:|:| |activeUsers|[activeUsersMetric](../resources/activeusersmetric.md) collection|Insights for active users on apps registered in the tenant for a specified period.|-|activeUsersBreakdown (deprecated)|[activeUsersBreakdownMetric](../resources/activeusersbreakdownmetric.md) collection| Insights for the breakdown of users who were active on apps registered in the tenant for a specified period.| |authentications|[authenticationsMetric](../resources/authenticationsmetric.md) collection|Insights for authentications on apps registered in the tenant for a specified period.| |mfaCompletions|[mfaCompletionMetric](../resources/mfacompletionmetric.md) collection|Insights for MFA usage on apps registered in the tenant for a specified period.| |signUps|[userSignUpMetric](../resources/usersignupmetric.md) collection| Total sign-ups on apps registered in the tenant for a specified period.| |
v1.0 | Datacollectioninfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/datacollectioninfo.md | description: "Represents the details and status of the data collection process f ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Datapolicyoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/datapolicyoperation.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Datetimetimezone | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/datetimetimezone.md | Describes the date, time, and time zone of a point in time. In general, the **timeZone** property _can_ be set to any of the [time zones currently supported by Windows](/windows-hardware/manufacture/desktop/default-time-zones), and the additional [time zones supported by the calendar API](#additional-time-zones). - If you use **dateTimeTimeZone** with a method (such as [creating](../api/user-post-events.md) or [updating](../api/event-update.md) an event), take note of the actual time zones supported, which can be a smaller subset.-- If you use **dateTimeTimeZone** with the [virtual event](../resources/virtualevent.md) APIs, the only supported format for the **timeZone** property is [time zones currently supported by Windows](/windows-hardware/manufacture/desktop/default-time-zones).+- If you use **dateTimeTimeZone** with the [virtual event](../resources/virtualevent.md) APIs, the only supported format for the **timeZone** property is time zones currently supported by Windows. For details on how to get all available time zones using PowerShell, see [Get-TimeZone](/powershell/module/microsoft.powershell.management/get-timezone#example-3-get-all-available-time-zones). ### Additional time zones Pacific/Kiritimati ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Daylighttimezoneoffset | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/daylighttimezoneoffset.md | daylight saving time to standard occurs at 2 AM on the fourth Sunday of May, eve ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Defaultsharinglink | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/defaultsharinglink.md | + + Title: "defaultSharingLink resource type" +description: "Represents the default sharing link a user can create." ++ms.localizationpriority: medium ++++# defaultSharingLink resource type ++Namespace: microsoft.graph +++Represents the default sharing link a user can create. ++## Properties ++|Property|Type|Description| +|:|:|:| +|defaultToExistingAccess|Boolean|Indicates whether the default link setting for this object is a direct URL rather than a sharing link.| +|role|sharingRole|The default sharing link role. The possible values are: `none`, `view`, `edit`, `manageList`, `review`, `restrictedView`, `submitOnly`, `unknownFutureValue`.| +|scope|sharingScope|The default sharing link scope. The possible values are: `anyone`, `organization`, `specificPeople`, `anonymous`, `users`, `unknownFutureValue`.| ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.defaultSharingLink" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.defaultSharingLink", + "role": "String", + "scope": "String", + "defaultToExistingAccess": "Boolean" +} +``` |
v1.0 | Delegatedadminrelationship | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/delegatedadminrelationship.md | Represents a delegated admin relationship between a partner and customer. |requests|[delegatedAdminRelationshipRequest](../resources/delegatedadminrelationshiprequest.md) collection|The requests associated with the delegated admin relationship.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Delegatedadminrelationshipoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/delegatedadminrelationshipoperation.md | Represents a long-running operation related to a delegated admin relationship. A |data|String|The data (payload) for the operation. Read-only.| |id|String|The unique identifier of the delegated admin long-running operation. Read-only. Inherited from [entity](../resources/entity.md).| |lastModifiedDateTime|DateTimeOffset|The time in ISO 8601 format and in UTC time when the long-running operation was last modified. Read-only.|-|operationType|delegatedAdminRelationshipOperationType|The type of long-running operation. The possible values are: `delegatedAdminAccessAssignmentUpdate`, `unknownFutureValue`. Read-only.| +|operationType|delegatedAdminRelationshipOperationType|The type of long-running operation. The possible values are: `delegatedAdminAccessAssignmentUpdate`, `unknownFutureValue`,`delegatedAdminRelationshipUpdate`. Read-only. You must use the `Prefer: include-unknown-enum-members` request header to get the following value from this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `delegatedAdminRelationshipUpdate`.| |status|longRunningOperationStatus|The status of the operation. Read-only. The possible values are: `notStarted`, `running`, `succeeded`, `failed`, `skipped`, `unknownFutureValue`. Read-only. Supports `$orderby`.| ## Relationships None. ## JSON representation-The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Deleted | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/deleted.md | See [view changes for an item](../api/driveitem-delta.md) for more information o ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Deleteditemcontainer | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/deleteditemcontainer.md | Inherits from [entity](../resources/entity.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Detailsinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/detailsinfo.md | The **detailsInfo** resource is a JSON string that contains other properties suc ## Relationships None ## JSON Representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", "@odata.type": "microsoft.graph.detailsInfo", |
v1.0 | Device | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/device.md | This resource is an open type that allows other properties to be passed in. You |isCompliant|Boolean|`true` if the device complies with Mobile Device Management (MDM) policies; otherwise, `false`. Read-only. This can only be updated by Intune for any device OS type or by an [approved MDM app](/windows/client-management/mdm/azure-active-directory-integration-with-mdm) for Windows OS devices. Supports `$filter` (`eq`, `ne`, `not`).| |isManaged|Boolean|`true` if the device is managed by a Mobile Device Management (MDM) app; otherwise, `false`. This can only be updated by Intune for any device OS type or by an [approved MDM app](/windows/client-management/mdm/azure-active-directory-integration-with-mdm) for Windows OS devices. Supports `$filter` (`eq`, `ne`, `not`). | |isManagementRestricted|Boolean|Indicates whether the device is a member of a restricted management administrative unit, in which case it requires a role scoped to the restricted administrative unit to manage. The default value is `false`. Read-only. <br/><br/> To manage a device that's a member of a restricted administrative unit, the calling app must be assigned the `Directory.Write.Restricted` permission. For delegated scenarios, the administrators must also be explicitly assigned supported roles at the restricted administrative unit scope.|-|isRooted|Boolean|`true` if device is rooted; `false` if device is jail-broken. This can only be updated by Intune.| +|isRooted|Boolean|`true` if the device is rooted; `false` if the device is jail-broken. This property can only be updated by Intune.| |kind| String| Form factor of the device. Only returned if the user signs in with a Microsoft account as part of Project Rome. | |managementType|String|Management channel of the device. This property is set by Intune. Possible values are: `eas`, `mdm`, `easMdm`, `intuneClient`, `easIntuneClient`, `configurationManagerClient`, `configurationManagerClientMdm`, `configurationManagerClientMdmEas`, `unknown`, `jamf`, `googleCloudDevicePolicyController`.| |manufacturer| String| Manufacturer of the device. Read-only. | |
v1.0 | Devicedetail | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/devicedetail.md | Indicates device details associated with a device used for signing in. Includes ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Devicemanagement Alertimpact | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/devicemanagement-alertimpact.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.deviceManagement.alertImpact" |
v1.0 | Diagnostic | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/diagnostic.md | Information about an error or warning for a OneNote operation. ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Directoryaudit | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/directoryaudit.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Directoryrole | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/directoryrole.md | This resource supports: ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Directoryroletemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/directoryroletemplate.md | None ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Directorysetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/directorysetting.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Directorysettingtemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/directorysettingtemplate.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Directorysizequota | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/directorysizequota.md | description: "Represents a company's used and total directory quota." ms.localizationpriority: medium doc_type: resourcePageType -+ # directorySizeQuota resource type [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents a company's used and total directory quota. +Represents a [tenant's](organization.md) used and total directory quota. ## Properties | Property | Type|Description| |
v1.0 | Directsharingabilities | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/directsharingabilities.md | + + Title: "directSharingAbilities resource type" +description: "Represents the direct sharing abilities." ++ms.localizationpriority: medium ++++# directSharingAbilities resource type ++Namespace: microsoft.graph +++Represents the direct sharing abilities. ++## Properties ++|Property|Type|Description| +|:|:|:| +|addExistingExternalUsers|[sharingOperationStatus](../resources/sharingoperationstatus.md)|Indicates whether the current user can add existing guest recipients to this item using direct sharing.| +|addInternalUsers|[sharingOperationStatus](../resources/sharingoperationstatus.md)|Indicates whether the current user can add internal recipients to this item using direct sharing.| +|addNewExternalUsers|[sharingOperationStatus](../resources/sharingoperationstatus.md)|Indicates whether the current user can add new guest recipients to this item using direct sharing.| +|requestGrantAccess|[sharingOperationStatus](../resources/sharingoperationstatus.md)|Indicates whether the user querying this endpoint can request access for the user or on behalf of other users, after which, site admins, can approve or deny the creation of a potential sharing link.| ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.directSharingAbilities" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.directSharingAbilities", + "requestGrantAccess": { + "@odata.type": "microsoft.graph.sharingOperationStatus" + }, + "addNewExternalUsers": { + "@odata.type": "microsoft.graph.sharingOperationStatus" + }, + "addExistingExternalUsers": { + "@odata.type": "microsoft.graph.sharingOperationStatus" + }, + "addInternalUsers": { + "@odata.type": "microsoft.graph.sharingOperationStatus" + } +} +``` |
v1.0 | Disableanddeleteuserapplyaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/disableanddeleteuserapplyaction.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.disableAndDeleteUserApplyAction" |
v1.0 | Domain | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/domain.md | Title: "domain resource type" description: "Represents a domain associated with the tenant."-+ ms.localizationpriority: medium doc_type: resourcePageType Namespace: microsoft.graph Represents a domain associated with the tenant. -Use domain operations to associate domains to a tenant, verify domain ownership, and configure supported services. Domain operations enable registrars to automate domain association for services such as Microsoft 365. For example, as part of domain sign up, a registrar can enable a vanity domain for email, websites, authentication, etc. +Use domain operations to associate domains to a tenant, verify domain ownership, and configure supported services. Domain operations enable registrars to automate domain association for services such as Microsoft 365. For example, as part of domain sign-up, a registrar can enable a vanity domain for email, websites, authentication, etc. To associate a domain with a tenant: To associate a domain with a tenant: 2. [Retrieve](../api/domain-list-verificationdnsrecords.md) the domain verification records. Add the verification record details to the domain's zone file using the domain registrar or DNS server configuration. -3. [Verify](../api/domain-verify.md) the ownership of the domain. This will verify the domain and set the **isVerified** property to `true`. +3. [Verify](../api/domain-verify.md) the ownership of the domain. This verifies the domain and sets the **isVerified** property to `true`. 4. [Indicate](../api/domain-update.md) the supported services you plan to use with the domain. To associate a domain with a tenant: | Property | Type | Description | |:|:--|:-|-|authenticationType|String| Indicates the configured authentication type for the domain. The value is either `Managed` or `Federated`. `Managed` indicates a cloud managed domain where Microsoft Entra ID performs user authentication. `Federated` indicates authentication is federated with an identity provider such as the tenant's on-premises Active Directory via Active Directory Federation Services. Not nullable. | +|authenticationType|String| Indicates the configured authentication type for the domain. The value is either `Managed` or `Federated`. `Managed` indicates a cloud managed domain where Microsoft Entra ID performs user authentication. `Federated` indicates authentication is federated with an identity provider such as the tenant's on-premises Active Directory via Active Directory Federation Services. Not nullable. <br/><br/>To update this property in delegated scenarios, the calling app must be assigned the *Directory.AccessAsUser.All* delegated permission. | |availabilityStatus|String| This property is always `null` except when the [verify](../api/domain-verify.md) action is used. When the [verify](../api/domain-verify.md) action is used, a **domain** entity is returned in the response. The **availabilityStatus** property of the **domain** entity in the response is either `AvailableImmediately` or `EmailVerifiedDomainTakeoverScheduled`.| |id|String| The fully qualified name of the domain. Key, immutable, not nullable, unique. |-|isAdminManaged|Boolean| The value of the property is `false` if the DNS record management of the domain has been delegated to Microsoft 365. Otherwise, the value is `true`. Not nullable | -|isDefault|Boolean| `true` if this is the default domain that is used for user creation. There is only one default domain per company. Not nullable | -|isInitial|Boolean| `true` if this is the initial domain created by Microsoft Online Services (contoso.com). There is only one initial domain per company. Not nullable | +|isAdminManaged|Boolean| The value of the property is `false` if the DNS record management of the domain is delegated to Microsoft 365. Otherwise, the value is `true`. Not nullable | +|isDefault|Boolean| `true` if this is the default domain that is used for user creation. There's only one default domain per company. Not nullable | +|isInitial|Boolean| `true` if this is the initial domain created by Microsoft Online Services (contoso.com). There's only one initial domain per company. Not nullable | |isRoot|Boolean| `true` if the domain is a verified root domain. Otherwise, `false` if the domain is a subdomain or unverified. Not nullable | |isVerified|Boolean| `true` if the domain has completed domain ownership verification. Not nullable |-|passwordNotificationWindowInDays|Int32|Specifies the number of days before a user receives notification that their password will expire. If the property is not set, a default value of 14 days will be used.| -|passwordValidityPeriodInDays|Int32| Specifies the length of time that a password is valid before it must be changed. If the property is not set, a default value of 90 days will be used. | -|supportedServices|String collection| The capabilities assigned to the domain. Can include `0`, `1` or more of following values: `Email`, `Sharepoint`, `EmailInternalRelayOnly`, `OfficeCommunicationsOnline`,`SharePointDefaultDomain`, `FullRedelegation`, `SharePointPublic`, `OrgIdAuthentication`, `Yammer`, `Intune`. The values which you can add/remove using Graph API include: `Email`, `OfficeCommunicationsOnline`, `Yammer`. Not nullable.| +|passwordNotificationWindowInDays|Int32|Specifies the number of days before a user receives notification that their password will expire. If the property isn't set, a default value of 14 days is used.| +|passwordValidityPeriodInDays|Int32| Specifies the length of time that a password is valid before it must be changed. If the property isn't set, a default value of 90 days is used. | +|supportedServices|String collection| The capabilities assigned to the domain. Can include `0`, `1` or more of following values: `Email`, `Sharepoint`, `EmailInternalRelayOnly`, `OfficeCommunicationsOnline`,`SharePointDefaultDomain`, `FullRedelegation`, `SharePointPublic`, `OrgIdAuthentication`, `Yammer`, `Intune`. The values that you can add or remove using the API include: `Email`, `OfficeCommunicationsOnline`, `Yammer`. Not nullable.| |state|[domainState](domainstate.md)| Status of asynchronous operations scheduled for the domain. | ## Relationships Relationships between a domain and other objects in the directory such as its ve | Relationship | Type |Description| |:|:--|:-|-|domainNameReferences|[directoryObject](directoryobject.md) collection| The objects such as users and groups that reference the domain ID. Read-only, Nullable. Supports `$expand` and `$filter` by the OData type of objects returned. For example `/domains/{domainId}/domainNameReferences/microsoft.graph.user` and `/domains/{domainId}/domainNameReferences/microsoft.graph.group`.| +|domainNameReferences|[directoryObject](directoryobject.md) collection| The objects such as users and groups that reference the domain ID. Read-only, Nullable. Supports `$expand` and `$filter` by the OData type of objects returned. For example, `/domains/{domainId}/domainNameReferences/microsoft.graph.user` and `/domains/{domainId}/domainNameReferences/microsoft.graph.group`.| |serviceConfigurationRecords|[domainDnsRecord](domaindnsrecord.md) collection| DNS records the customer adds to the DNS zone file of the domain before the domain can be used by Microsoft Online services. Read-only, Nullable. Supports `$expand`. | |verificationDnsRecords|[domainDnsRecord](domaindnsrecord.md) collection| DNS records that the customer adds to the DNS zone file of the domain before the customer can complete domain ownership verification with Microsoft Entra ID. Read-only, Nullable. Supports `$expand`.| |federationConfiguration|[internalDomainFederation](../resources/internaldomainfederation.md)| Domain settings configured by customer when federated with Microsoft Entra ID. Supports `$expand`.| ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Domaindnscnamerecord | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/domaindnscnamerecord.md | Title: "domainDnsCnameRecord resource type" description: "Represents a CNAME record added to the DNS zone file of a particular domain in the tenant."-+ ms.localizationpriority: medium doc_type: resourcePageType None ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Domaindnsmxrecord | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/domaindnsmxrecord.md | Title: "domainDnsMxRecord resource type" description: "Represents an MX record added to the DNS zone file of a particular domain in the tenant."-+ ms.localizationpriority: medium doc_type: resourcePageType Direct queries to this resource aren't supported. See the [domain](domain.md) ar None ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Domaindnsrecord | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/domaindnsrecord.md | Title: "domainDnsRecord resource type" description: "The domainDnsRecord entity is used to present DNS records." ms.localizationpriority: medium-+ doc_type: resourcePageType Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -For each [domain](domain.md) in the tenant, you may be required to add DNS record(s) to the DNS zone file of the domain before the domain can be used by Microsoft Online Services. The **domainDnsRecord** entity is used to present such DNS records. This resource type is the base entity for the following resources: +For each [domain](domain.md) in the tenant, you may be required to add DNS records to the DNS zone file of the domain before the domain can be used by Microsoft Online Services. The **domainDnsRecord** entity is used to present such DNS records. This resource type is the base entity for the following resources: + [domainDnsCnameRecord](domaindnscnamerecord.md) + [domainDnsMxRecord](domaindnsmxrecord.md) + [domainDnsSrvRecord](domaindnssrvrecord.md) For each [domain](domain.md) in the tenant, you may be required to add DNS recor None. ## Properties-| Property | Type |Description| +| Property | Type |Description| |:|:--|:-| |id|String| Unique identifier assigned to this entity. Not nullable, Read-only.|-|isOptional|Boolean| If false, this record must be configured by the customer at the DNS host for Microsoft Online Services to operate correctly with the domain. | +|isOptional|Boolean| If false, the customer must configure this record at the DNS host for Microsoft Online Services to operate correctly with the domain. | |label|String| Value used when configuring the name of the DNS record at the DNS host. |-|recordType|String| Indicates what type of DNS record this entity represents. The value can be one of the following: `CName`, `Mx`, `Srv`, `Txt`. | +|recordType|String| Indicates what type of DNS record this entity represents. The value can be one of the following values: `CName`, `Mx`, `Srv`, `Txt`. | |supportedService|String| Microsoft Online Service or feature that has a dependency on this DNS record. Can be one of the following values: `null`, `Email`, `Sharepoint`, `EmailInternalRelayOnly`, `OfficeCommunicationsOnline`, `SharePointDefaultDomain`, `FullRedelegation`, `SharePointPublic`, `OrgIdAuthentication`, `Yammer`, `Intune`.| |ttl|Int32| Value to use when configuring the time-to-live (ttl) property of the DNS record at the DNS host. Not nullable. | None. None ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Domaindnssrvrecord | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/domaindnssrvrecord.md | Title: "domainDnsSrvRecord resource type" description: "Represents a SRV record added to the DNS zone file of a particular domain in the tenant."-+ ms.localizationpriority: medium doc_type: resourcePageType None ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Domaindnstxtrecord | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/domaindnstxtrecord.md | Title: "domainDnsTxtRecord resource type" description: "Represents a TXT record added to the DNS zone file of a particular domain in the tenant."-+ ms.localizationpriority: medium doc_type: resourcePageType None ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Domaindnsunavailablerecord | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/domaindnsunavailablerecord.md | Title: "domainDnsUnavailableRecord resource type" description: "Indicates that serviceConfigurationRecords can't be generated." ms.localizationpriority: medium-+ doc_type: resourcePageType Direct queries to this resource aren't supported. See the [domain](domain.md) ar None ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Domainstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/domainstate.md | Title: "domainState resource type" description: "Represents the status of asynchronous operations scheduled on a domain."-+ ms.localizationpriority: medium doc_type: resourcePageType Represents the status of asynchronous operations scheduled on a domain. | Property | Type | Description | |:|:--|:-| | lastActionDateTime | DateTimeOffset | Timestamp for when the last activity occurred. The value is updated when an operation is scheduled, the asynchronous task starts, and when the operation completes. |-| operation | String | Type of asynchronous operation. The values can be *ForceDelete* or *Verification* | -| status | String | Current status of the operation. <br> *Scheduled* - Operation has been scheduled but has not started. <br> *InProgress* - Task has started and is in progress. <br> *Failed* - Operation has failed. | +| operation | String | Type of asynchronous operation. The values can be `ForceDelete` or `Verification`. | +| status | String | Current status of the operation. <br> `Scheduled` - Operation is scheduled but hasn't started. <br> `InProgress` - Task is in progress. <br> `Failed` - The operation failed. | ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Downgradejustification | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/downgradejustification.md | Represents user input on why downgrade was performed. Downgrade justification mi ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
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 | specialFolder | [specialFolder][] | If the current item is also available as a special folder, this facet is returned. Read-only. | source | [driveItemSource][]| Information about the drive item source. Read-only. Only on OneDrive for Business and SharePoint. | video | [video][] | Video metadata, if the item is a video. Read-only.+| viewpoint | [driveItemViewpoint][] | Returns information specific to the calling user for this drive item. Read-only. | webDavUrl | String | WebDAV compatible URL for the item. | webUrl | String | URL that displays the resource in the browser. Read-only. The **driveItem** resource is derived from [**baseItem**][baseItem] and inherits "source": { "@odata.type": "microsoft.graph.driveItemSource" }, "specialFolder": { "@odata.type": "microsoft.graph.specialFolder" }, "video": { "@odata.type": "microsoft.graph.video" },+ "viewpoint": { "@odata.type": "microsoft.graph.driveItemViewpoint" }, "webDavUrl": "string", /* relationships */ The **driveItem** resource is derived from [**baseItem**][baseItem] and inherits [subscription]: subscription.md [thumbnailSet]: thumbnailset.md [video]: video.md+[driveItemViewpoint]: driveitemviewpoint.md [workbook]: workbook.md [user]: /graph/api/resources/users [publicationFacet]: publicationfacet.md |
v1.0 | Driveitemaccessoperationsviewpoint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/driveitemaccessoperationsviewpoint.md | + + Title: "driveItemAccessOperationsViewpoint resource type" +description: "Indicates whether the user can carry out the described actions on this item." ++ms.localizationpriority: medium ++++# driveItemAccessOperationsViewpoint resource type ++Namespace: microsoft.graph +++Indicates whether the user can carry out the described actions on this item. ++## Properties ++|Property|Type|Description| +|:|:|:| +|canComment|Boolean|Indicates whether the user can comment on this item.| +|canCreateFile|Boolean|Indicates whether the user can create files within this object. Returned only on folders.| +|canCreateFolder|Boolean|Indicates whether the user can create folders within this object. Returned only on folders.| +|canDelete|Boolean|Indicates whether the user can delete this item.| +|canDownload|Boolean|Indicates whether the user can download this item.| +|canRead|Boolean|Indicates whether the user can read this item.| +|canUpdate|Boolean|Indicates whether the user can update this item.| ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.driveItemAccessOperationsViewpoint" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.driveItemAccessOperationsViewpoint", + "canComment": "Boolean", + "canCreateFile": "Boolean", + "canCreateFolder": "Boolean", + "canDelete": "Boolean", + "canDownload": "Boolean", + "canRead": "Boolean", + "canUpdate": "Boolean" +} +``` |
v1.0 | Driveitemviewpoint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/driveitemviewpoint.md | + + Title: "driveItemViewpoint resource type" +description: "Returns information specific to the calling user for this drive item." ++ms.localizationpriority: medium ++++# driveItemViewpoint resource type ++Namespace: microsoft.graph +++Returns information specific to the calling user for this drive item. ++## Properties ++|Property|Type|Description| +|:|:|:| +|accessOperations|[driveItemAccessOperationsViewpoint](../resources/driveitemaccessoperationsviewpoint.md)| Indicates whether the user can perform the described actions on this item.| +|sharing|[sharingViewpoint](../resources/sharingviewpoint.md)| Indicates sharing operations the current user can take on the specified item.| ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.driveItemViewpoint" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.driveItemViewpoint", + "accessOperations": { + "@odata.type": "microsoft.graph.driveItemAccessOperationsViewpoint" + }, + "sharing": { + "@odata.type": "microsoft.graph.sharingViewpoint" + } +} +``` |
v1.0 | Dynamics Account | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/dynamics-account.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. ```json |
v1.0 | Dynamics Agedaccountsreceivable | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/dynamics-agedaccountsreceivable.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. ```json |
v1.0 | Dynamics Customer | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/dynamics-customer.md | A Tax Area(taxArea) must exist in the Tax Area table. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. ```json |
v1.0 | Dynamics Customerpayment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/dynamics-customerpayment.md | An Invoice (appliesToInvoiceId) must exist in the Sales Invoices Table. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. ```json { |
v1.0 | Dynamics Customerpaymentsjournal | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/dynamics-customerpaymentsjournal.md | Represents a customer payment journal in Dynamics 365 Business Central. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. ```json |
v1.0 | Dynamics Dimension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/dynamics-dimension.md | Represents a dimension in Dynamics 365 Business Central. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. ```json |
v1.0 | Dynamics Dimensionvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/dynamics-dimensionvalue.md | Represents a dimension value in Dynamics 365 Business Central. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. ```json |
v1.0 | Dynamics Employee | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/dynamics-employee.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. ```json |
v1.0 | Dynamics Item | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/dynamics-item.md | A Tax Group(taxGroupCode) must exist in the Tax Group table. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. ```json |
v1.0 | Dynamics Itemcategories | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/dynamics-itemcategories.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. ```json { |
v1.0 | Dynamics Journal | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/dynamics-journal.md | The response has no content; the response code is 204. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. ```json |
v1.0 | Dynamics Journalline | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/dynamics-journalline.md | An Account (accountId) must exist in the Accounts table. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. ```json |
v1.0 | Dynamics Paymentmethods | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/dynamics-paymentmethods.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. ```json { |
v1.0 | Dynamics Paymentterms | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/dynamics-paymentterms.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. ```json |
v1.0 | Dynamics Shipmentmethods | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/dynamics-shipmentmethods.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. ```json { |
v1.0 | Dynamics Taxarea | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/dynamics-taxarea.md | Represents a tax area resource type in Dynamics 365 Business Central. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. ```json |
v1.0 | Edidentitysource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/edidentitysource.md | description: "Represents an permissionsDefinitionIdentitySource for a configured ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Ediscovery Caseexportoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/ediscovery-caseexportoperation.md | Inherits from [caseOperation](../resources/ediscovery-caseoperation.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Ediscovery Casesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/ediscovery-casesettings.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Ediscovery Datasource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/ediscovery-datasource.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Ediscovery Noncustodialdatasource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/ediscovery-noncustodialdatasource.md | Inherits from [dataSourceContainer](../resources/ediscovery-datasourcecontainer. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Ediscovery Sourcecollection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/ediscovery-sourcecollection.md | Represents an eDiscovery collection, commonly known as a search. For details, se ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Ediscovery Topicmodelingsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/ediscovery-topicmodelingsettings.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.ediscovery.topicModelingSettings" |
v1.0 | Ediscovery Unifiedgroupsource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/ediscovery-unifiedgroupsource.md | Types of source related to the user. Includes mailbox and site both by default. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Educationassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/educationassignment.md | Inherits from [entity](../resources/entity.md). |id|String| The unique identifier for the **assignment**. Inherited from [entity](../resources/entity.md). Read-only.| |instructions|[itemBody](itembody.md)| Instructions for the **assignment**. This property and the display name tell the student what to do. | |lastModifiedBy|[identitySet](identityset.md)| Who last modified the **assignment**. |-|lastModifiedDateTime|DateTimeOffset|Moment when the **assignment** was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| +|lastModifiedDateTime|DateTimeOffset|The date and time on which the **assignment** was modified. A student submission doesn't modify the assignment; only teachers can update assignments. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| |moduleUrl|string| The URL of the module from which to access the **assignment**.| |notificationChannelUrl|String|Optional field to specify the URL of the [channel](channel.md) to post the **assignment** publish notification. If not specified or null, defaults to the `General` channel. This field only applies to **assignments** where the **assignTo** value is [educationAssignmentClassRecipient](educationassignmentclassrecipient.md). Updating the **notificationChannelUrl** isn't allowed after the **assignment** has been published.| |resourcesFolderUrl|string| Folder URL where all the file resources for this **assignment** are stored.| |
v1.0 | Educationassignmentindividualrecipient | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/educationassignmentindividualrecipient.md | This resource is a subclass of [educationAssignmentRecipient](educationassignmen ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Educationassignmentpointsgrade | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/educationassignmentpointsgrade.md | which will add the who data to this property. The max points are stored in the * ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Educationassignmentresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/educationassignmentresource.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Educationassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/educationassignmentsettings.md | Specifies class-level assignments settings. |gradingCategories|[educationGradingCategory](educationgradingcategory.md) collection| When set, enables users to weight assignments differently when computing a class average grade.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Educationfileresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/educationfileresource.md | A subclass of [educationResource](educationresource.md) that represents a file o ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Educationlinkresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/educationlinkresource.md | A subclass of [educationResource](educationresource.md). This resource is a link ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Educationmoduleresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/educationmoduleresource.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Educationresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/educationresource.md | This resource stores the common properties across all resource types. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Educationschool | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/educationschool.md | This resource is a subtype of [educationOrganization](educationorganization.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Educationsubmission | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/educationsubmission.md | If [setUpResourcesFolder](../api/educationsubmission-setupResourcesFolder.md) ha |returnedBy|[identitySet](identityset.md)|User who moved the status of this submission to returned.| |returnedDateTime|DateTimeOffset|Moment in time when the submission was returned. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| |resourcesFolderUrl|String|Folder where all file resources for this submission need to be stored.|-|status|educationSubmissionStatus| Read-only. Possible values are: `working`, `submitted`, `returned`, `unknownFutureValue` and `reassigned`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `reassigned`.| +|status|educationSubmissionStatus| Read-only. Possible values are: `working`, `submitted`, `returned`, `unknownFutureValue`, `reassigned`, and `excused`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `reassigned`, and `excused`.| |submittedBy|[identitySet](identityset.md)|User who moved the resource into the submitted state.| |submittedDateTime|DateTimeOffset|Moment in time when the submission was moved into the submitted state. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| |unsubmittedBy|[identitySet](identityset.md)|User who moved the resource from submitted into the working state.| |
v1.0 | Educationsubmissionresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/educationsubmissionresource.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Educationterm | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/educationterm.md | A term. This represents a designated portion of the academic year. It's used wit ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Educationuser | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/educationuser.md | This object provides a targeted subset of properties from the core [user] object ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Emailaddress | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/emailaddress.md | Represents the name and SMTP address of an entity instance, for example, a messa ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Emailauthenticationmethodconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/emailauthenticationmethodconfiguration.md | Inherits from [authenticationMethodConfiguration](../resources/authenticationmet ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Emailfileassessmentrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/emailfileassessmentrequest.md | Inherits from [threatAssessmentRequest](threatassessmentrequest.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Emailidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/emailidentity.md | Inherits from [identity](../resources/identity.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.emailIdentity" |
v1.0 | Emailpayloaddetail | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/emailpayloaddetail.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.emailPayloadDetail" |
v1.0 | Employeeorgdata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/employeeorgdata.md | Title: "employeeOrgData resource type" description: "Represents organization data associated with a user." ms.localizationpriority: medium doc_type: resourcePageType+ |
v1.0 | Encryptedawsstoragebucketfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/encryptedawsstoragebucketfinding.md | description: "Represents the findings for AWS encrypted storage buckets." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Encryptedazurestorageaccountfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/encryptedazurestorageaccountfinding.md | description: "Represents the findings for Azure encrypted storage accounts." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Encryptedgcpstoragebucketfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/encryptedgcpstoragebucketfinding.md | description: "Represents the findings for GCP encrypted storage buckets." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Endpoint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/endpoint.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Entitlementmanagementsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/entitlementmanagementsettings.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Entitlementsdatacollection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/entitlementsdatacollection.md | description: "Represents the details and status of data collection about permiss ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Entitlementsdatacollectioninfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/entitlementsdatacollectioninfo.md | description: "An abstract type that defines any data collected about permissions ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Entity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/entity.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Enumeratedaccountswithaccess | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/enumeratedaccountswithaccess.md | description: "Contains information on specified external AWS accounts that have ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Enumeratedinboundports | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/enumeratedinboundports.md | description: "Allows incoming traffic from certain ports." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Enums Identitygovernance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/enums-identitygovernance.md | Namespace: microsoft.graph.identityGovernance |unknownFutureValue| +### membershipChangeType values ++++|Member| +|:| +|add| +|remove| +|unknownFutureValue| +++ <!-- { |
v1.0 | Enums Industrydata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/enums-industrydata.md | Enum values for the industry data API in Microsoft Graph. | expired | | unknownFutureValue | +### filteroptions values ++| Member | +|:-| +| orgExternalId | +| unknownFutureValue | ++### additionalUserAttributes values ++| Member | +|:-| +| userGradeLevel | +| userNumber | +| unknownFutureValue | ++### additionalClassGroupAttributes values ++| Member | +|:--| +| courseTitle | +| courseCode | +| courseSubject | +| courseGradeLevel | +| courseExternalId | +| academicSessionTitle | +| academicSessionExternalId | +| classCode | +| unknownFutureValue | + <!-- { "type": "#page.annotation", |
v1.0 | Enums Networkaccess | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/enums-networkaccess.md | Namespace: microsoft.graph.networkaccess |southAfricaWest| |southAfricaNorth| |uaeNorth|+|australiaEast| +|westCentralUS| +|centralIndia| +|southEastAsia| +|swedenCentral| +|southIndia| +|australiaSouthEast| +|koreaCentral| +|polandCentral| +|brazilSouth| +|japanEast| +|japanWest| +|koreaSouth| +|italyNorth| +|franceSouth| +|israelCentral| |unknownFutureValue| + ### status values |Member| Namespace: microsoft.graph.networkaccess "type": "#page.annotation", "namespace": "microsoft.graph.networkaccess" }>+--> |
v1.0 | Enums Partner Security | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/enums-partner-security.md | + + Title: "Partner security enum values" +description: "Microsoft Graph partner security enumeration values." ++ms.localizationpriority: medium ++++# Partner security enum values ++Namespace: microsoft.graph.partner.security ++### securityAlertConfidence values ++|Member| +|:| +|low| +|medium| +|high| +|unknownFutureValue| +++### securityAlertResolvedReason values ++|Member| +|:| +|legitimate| +|ignore| +|fraud| +|unknownFutureValue| +++### securityAlertSeverity values ++|Member| +|:| +|informational| +|high| +|medium| +|low| +|unknownFutureValue| +++### securityAlertStatus values ++|Member| +|:| +|active| +|resolved| +|investigating| +|unknownFutureValue| ++<!-- +{ + "type": "#page.annotation", + "namespace": "microsoft.graph.partner.security" +} +--> |
v1.0 | Enums | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/enums.md | Namespace: microsoft.graph | certificate | | unknownFutureValue | +### plannerTaskCompletionRequirements values ++| Member | +|:-| +| none | +| checklistCompletion| +| unknownFutureValue | +| formCompletion | +| approvalCompletion | ++### plannerApprovalStatus values ++| Member | +|:-| +| requested | +| approved | +| rejected | +| cancelled | +| unknownFutureValue | + ### applicationKeyOrigin values | Member | Namespace: microsoft.graph |generallyAvailable| |unknownFutureValue| +### requiredLicenses values ++|Member| +|:| +|notApplicable| +|microsoftEntraIdFree| +|microsoftEntraIdP1| +|microsoftEntraIdP2| +|microsoftEntraIdGovernance| +|microsoftEntraWorkloadId| +|unknownFutureValue| + ### recommendationCategory values | Member | Namespace: microsoft.graph | saml20 | | deviceCode | | unknownFutureValue |+| authenticationTransfer| +| nativeAuth | ### accessReviewInstanceDecisionItemFilterByCurrentUserOptions values Namespace: microsoft.graph | gpsLocationCondition | | riskBasedPolicy | | unknownFutureValue |+| scopeBasedAuthRequirementPolicy | +| authenticationStrengths | ### riskDetail values Namespace: microsoft.graph |returned| |unknownFutureValue| |reassigned|+|excused| ### educationFeedbackResourceOutcomeStatus values Possible values for user account types (group membership), per Windows definitio ### stagedFeatureName values -| Member | Description | -| : | :- | -| passthroughAuthentication | Passthrough Authentication | -| seamlessSso | Seamless Single Sign-on | -| passwordHashSync | Password Hash Synchronization | -| emailAsAlternateId | Email as an alternate ID | -| unknownFutureValue | A sentinel member | +| Member | +| : | +| passthroughAuthentication | +| seamlessSso | +| passwordHashSync | +| emailAsAlternateId | +| unknownFutureValue | +| certificateBasedAuthentication | ### tokenIssuerType values Possible values for user account types (group membership), per Windows definitio |unbound| |unknownFutureValue| +### conditionalAccessAudienceReason values ++| Member | +| :-- | +|none| +|resourcelessRequest| +|confidentialClientIdToken| +|confidentialClientNonIdToken| +|resourceMapping| +|resourceMappingDefault| +|scopeMapping| +|scopeMappingDefault| +|delegatedScope | +|firstPartyResourceDefault| +|thirdPartyResourceDefault| +|unknownFutureValue| + ### persistentBrowserSessionMode values | Member | Possible values for user account types (group membership), per Windows definitio | gallery | | unknownFutureValue | +### cloudPcPolicySettingType values ++|Member| +|:| +|region| +|singleSignOn| +|unknownFutureValue| + ### chatType values | Member | Value | Description | Possible values for user account types (group membership), per Windows definitio |deviceCodeFlow| |authenticationTransfer| |unknownFutureValue|++### sharingRole values ++|Member| +|:| +|none| +|view| +|edit| +|manageList| +|review| +|restrictedView| +|submitOnly| +|unknownFutureValue| ++### sharingScope values ++|Member| +|:| +|anyone| +|organization| +|specificPeople| +|anonymous| +|users| +|unknownFutureValue| ++### sharingVariant values ++|Member| +|:| +|none| +|requiresAuthentication| +|passwordProtected| +|addressBar| +|embed| +|unknownFutureValue| ++### trustFrameworkKeyStatus values ++|Member| +|:| +|enabled| +|disabled| +|unknownFutureValue| |
v1.0 | Evaluatedynamicmembershipresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/evaluatedynamicmembershipresult.md | Represents the result of membership evaluation. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Eventmessage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/eventmessage.md | Aside from a meeting request, an **eventMessage** instance can be found in an in ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Eventmessagerequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/eventmessagerequest.md | To respond to the meeting request, first, use the **event** navigation property ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Extension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/extension.md | An abstract type to support the OData v4 open type [openTypeExtension](opentypee ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Extensionproperty | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/extensionproperty.md | Title: "extensionProperty resource type (directory extensions)" description: "Represents a directory extension" ms.localizationpriority: medium + doc_type: "resourcePageType" |
v1.0 | Extensionschemaproperty | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/extensionschemaproperty.md | Title: "extensionSchemaProperty resource type" description: "Use the **extensionSchemaProperty** resource to define a property's name and its type, as part of a schemaExtension definition." ms.localizationpriority: medium doc_type: resourcePageType+ Use the **extensionSchemaProperty** resource to define a property's name and its | Property | Type |Description| |:|:--|:-| |name|String| The name of the strongly typed property defined as part of a schema extension.|-|type|String| The type of the property that is defined as part of a schema extension. Allowed values are `Binary`, `Boolean`, `DateTime`, `Integer` or `String`. See the table below for more details.| +|type|String| The type of the property that is defined as part of a schema extension. Allowed values are `Binary`, `Boolean`, `DateTime`, `Integer`, or `String`. For more information, see [Supported property data types](#supported-property-data-types).| ### Supported property data types The following data types are supported when defining a property in a schema extension: The following data types are supported when defining a property in a schema exte | Property Type | Remarks | |-|| | Binary | 256 bytes maximum. |-| Boolean | Not supported for messages, events and posts. | -| DateTime | Must be specified in ISO 8601 format. Will be stored in UTC. | -| Integer | 32-bit value. Not supported for messages, events and posts. | +| Boolean | Not supported for messages, events, and posts. | +| DateTime | Must be specified in ISO 8601 format. Is stored in UTC. | +| Integer | 32-bit value. Not supported for messages, events, and posts. | | String | 256 characters maximum. | ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Externalauthenticationmethodconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/externalauthenticationmethodconfiguration.md | + + Title: "externalAuthenticationMethodConfiguration resource type" +description: "Specifies the properties and connection information for an external authentication method." ++ms.localizationpriority: medium ++++# externalAuthenticationMethodConfiguration resource type ++Namespace: microsoft.graph +++Specifies the properties and connection information for an external authentication method. +++Inherits from [authenticationMethodConfiguration](../resources/authenticationmethodconfiguration.md). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[Get](../api/externalauthenticationmethodconfiguration-get.md)|[externalAuthenticationMethodConfiguration](../resources/externalauthenticationmethodconfiguration.md)|Read the properties and relationships of an [externalAuthenticationMethodConfiguration](../resources/externalauthenticationmethodconfiguration.md) object.| +|[Update](../api/externalauthenticationmethodconfiguration-update.md)|[externalAuthenticationMethodConfiguration](../resources/externalauthenticationmethodconfiguration.md)|Update the properties of an [externalAuthenticationMethodConfiguration](../resources/externalauthenticationmethodconfiguration.md) object.| +|[Delete](../api/externalauthenticationmethodconfiguration-delete.md)|None|Delete an [externalAuthenticationMethodConfiguration](../resources/externalauthenticationmethodconfiguration.md) object.| ++## Properties +|Property|Type|Description| +|:|:|:| +|appId|String|**appId** for the app registration in Microsoft Entra ID representing the integration with the external provider.| +|displayName|String|Display name for the external authentication method. This name is shown to users during sign-in.| +|excludeTargets|[excludeTarget](../resources/excludetarget.md) collection|Groups of users excluded from the policy. Inherited from [authenticationMethodConfiguration](../resources/authenticationmethodconfiguration.md).| +|id|String|The unique identifier for this object. Read-only. Inherited from [entity](../resources/entity.md).| +|openIdConnectSetting|[openIdConnectSetting](../resources/openidconnectsetting.md)|Open ID Connection settings used by this external authentication method.| +|state|authenticationMethodState|The state of the method in the policy. Inherited from [authenticationMethodConfiguration](../resources/authenticationmethodconfiguration.md). The possible values are: `enabled`, `disabled`.| ++## Relationships +|Relationship|Type|Description| +|:|:|:| +|includeTargets|[authenticationMethodTarget](../resources/authenticationmethodtarget.md) collection|A collection of groups that are enabled to use an authentication method as part of an authentication method policy in Microsoft Entra ID.| ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.externalAuthenticationMethodConfiguration", + "baseType": "microsoft.graph.authenticationMethodConfiguration", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.externalAuthenticationMethodConfiguration", + "id": "String (identifier)", + "state": "String", + "excludeTargets": [ + { + "@odata.type": "microsoft.graph.excludeTarget" + } + ], + "displayName": "String", + "appId": "String", + "openIdConnectSetting": { + "@odata.type": "microsoft.graph.openIdConnectSetting" + } +} +``` + |
v1.0 | Externalconnectors Acl | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/externalconnectors-acl.md | An access control entry for an item indexed by a Microsoft Search [externalConne ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Externalconnectors External | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/externalconnectors-external.md | description: "The base container for Microsoft Graph APIs such as the industry d ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Externalconnectors Externalgroupmember | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/externalconnectors-externalgroupmember.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Externalconnectors Identity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/externalconnectors-identity.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Externalconnectors Property | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/externalconnectors-property.md | A [schema](externalconnectors-schema.md) property definition for a Microsoft Sea ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Externalidentitiespolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/externalidentitiespolicy.md | Inherits from [policyBase](../resources/policybase.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Externallyaccessibleawsstoragebucketfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/externallyaccessibleawsstoragebucketfinding.md | description: "Get insight into the AWS S3 buckets accessible externally in your ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Externallyaccessibleazureblobcontainerfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/externallyaccessibleazureblobcontainerfinding.md | description: "Get insights into Azure blob containers that are accessible extern ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Externallyaccessiblegcpstoragebucketfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/externallyaccessiblegcpstoragebucketfinding.md | description: "Represents the findings for externally accessible GCP storage buck ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Externalprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/externalprofile.md | Title: "externalProfile resource type" description: "Defines an external profile." + ms.localizationpriority: medium doc_type: resourcePageType |
v1.0 | Externaluserprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/externaluserprofile.md | Title: "externalUserProfile resource type" description: "Represents the profile of an external user in a Microsoft Entra tenant." ms.localizationpriority: high + doc_type: resourcePageType |
v1.0 | Featurerolloutpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/featurerolloutpolicy.md | The following are limitations of feature rollout: - Each feature supports a maximum of 10 groups. - The **appliesTo** field only supports groups.-- Dynamic groups and nested groups are not supported.+- Dynamic groups and nested groups aren't supported. -The following are pre-requisites for each of the features that are currently supported for rollout using this rollout policy. --### Passthrough Authentication --* Identify a server running Windows Server 2012 R2 or later where you want the [PassthroughAuthentication](/azure/active-directory/hybrid/how-to-connect-pta) Agent to run. Ensure that the server is domain-joined, can authenticate selected users with Active Directory, and can communicate with Microsoft Entra ID on outbound ports / URLs. -* [Download](https://aka.ms/getauthagent) & install the Microsoft Entra Connect Authentication Agent on the server. -* To enable high availability, install additional Authentication Agents on other servers as described [here](/azure/active-directory/hybrid/how-to-connect-pta-quick-start#step-4-ensure-high-availability). -* Ensure that you have configured your [Smart Lockout](/azure/active-directory/authentication/howto-password-smart-lockout) settings appropriately. This is to ensure that your users' on-premises Active Directory accounts don't get locked out by bad actors. --### SeamlessSso --* Enable [SeamlessSso](/azure/active-directory/hybrid/how-to-connect-sso) for the AD forests based on [these](/azure/active-directory/hybrid/tshoot-connect-sso#manual-reset-of-the-feature) instructions. --### PasswordHashSync --* Enable [PasswordHashSync](/azure/active-directory/hybrid/whatis-phs) from the "Optional features" page in Microsoft Entra Connect. --### EmailAsAlternateId --* Associate alternate email with user accounts. +For more information about staged rollout, see [How to configure staged rollout in Microsoft Entra ID](https://www.youtube.com/watch?v=LFTE1epYDFQ). ## Methods The following are pre-requisites for each of the features that are currently sup |:-|:|:| |description|String|A description for this feature rollout policy.| |displayName|String|The display name for this feature rollout policy.|-|feature|stagedFeatureName| Possible values are: `passthroughAuthentication`, `seamlessSso`, `passwordHashSync`, `emailAsAlternateId`, `unknownFutureValue`.| +|feature|stagedFeatureName| Possible values are: `passthroughAuthentication`, `seamlessSso`, `passwordHashSync`, `emailAsAlternateId`, `unknownFutureValue`, `certificateBasedAuthentication`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value or values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `certificateBasedAuthentication`. For more information about the prerequisites for the enabled features, see [Prerequisites for enabled features](#prerequisites-for-enabled-features).| |id|String| Read-only.| |isAppliedToOrganization|Boolean|Indicates whether this feature rollout policy should be applied to the entire organization.| |isEnabled|Boolean|Indicates whether the feature rollout is enabled.| +### Prerequisites for enabled features ++The following are prerequisites for each of the features that are currently supported for rollout using this rollout policy. ++#### Passthrough Authentication ++* Identify a server running Windows Server 2012 R2 or later where you want the [PassthroughAuthentication](/azure/active-directory/hybrid/how-to-connect-pta) Agent to run. Ensure that the server is domain-joined, can authenticate selected users with Active Directory, and can communicate with Microsoft Entra ID on outbound ports / URLs. +* [Download](https://aka.ms/getauthagent) & install the Microsoft Entra Connect Authentication Agent on the server. +* To enable high availability, install additional Authentication Agents on other servers as described [here](/azure/active-directory/hybrid/how-to-connect-pta-quick-start#step-4-ensure-high-availability). +* Ensure that you've configured your [Smart Lockout](/azure/active-directory/authentication/howto-password-smart-lockout) settings appropriately. This is to ensure that your users' on-premises Active Directory accounts don't get locked out by bad actors. ++#### SeamlessSso ++* Enable [SeamlessSso](/azure/active-directory/hybrid/how-to-connect-sso) for the AD forests based on [these](/azure/active-directory/hybrid/tshoot-connect-sso#manual-reset-of-the-feature) instructions. ++#### PasswordHashSync ++* Enable [PasswordHashSync](/azure/active-directory/hybrid/whatis-phs) from the "Optional features" page in Microsoft Entra Connect. ++#### EmailAsAlternateId ++* Associate alternate email with user accounts. + ## Relationships | Relationship | Type | Description | |:-|:|:|-|appliesTo|[directoryObject](directoryobject.md) collection| Nullable. Specifies a list of directoryObjects that feature is enabled for.| +|appliesTo|[directoryObject](directoryobject.md) collection| Nullable. Specifies a list of directoryObject resources that feature is enabled for.| ## JSON representation -The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", The following is a JSON representation of the resource. } ``` +## Related content ++- [Migrate to cloud authentication using Staged Rollout](/entra/identity/hybrid/connect/how-to-connect-staged-rollout) + <!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98 2019-02-04 14:57:30 UTC --> <!-- { |
v1.0 | Fido2combinationconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/fido2combinationconfiguration.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | File | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/file.md | In addition to other properties, files have a **content** relationship that cont ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Fileassessmentrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/fileassessmentrequest.md | The file can be a text file or Word document or binary file received in an email ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Fileattachment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/fileattachment.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Filterdatetime | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/filterdatetime.md | Title: "FilterDatetime resource type" + Title: "filterDatetime resource type" description: "Represents how to filter a date when filtering on values." ms.localizationpriority: medium doc_type: resourcePageType-# FilterDatetime resource type +# filterDatetime resource type Namespace: microsoft.graph Represents how to filter a date when filtering on values. ## Properties | Property | Type |Description| |:|:--|:-|-|date|string|The date in ISO8601 format used to filter data.| -|specificity|string|How specific the date should be used to keep data. For example, if the date is 2005-04-02 and the specificity is set to "month," the filter operation will keep all rows with a date in the month of April 2009. Possible values are: `Year`, `Monday`, `Day`, `Hour`, `Minute`, `Second`.| +|date|String|The date in ISO 8601 format used to filter data.| +|specificity|String|Defines how specific you should use the **date** to keep data. For example, if the date is `2005-04-02` and the **specificity** property is set to `month`, the filter operation keeps all rows with a date in the month of April 2009. The possible values are: `Year`, `Month`, `Day`, `Hour`, `Minute`, `Second`.| ## Relationships-None +None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", Here's a JSON representation of the resource. ```json {- "date": "string", - "specificity": "string" + "date": "String", + "specificity": "String" }- ``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 Here's a JSON representation of the resource. "suppressions": [] } -->-- |
v1.0 | Finding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/finding.md | description: "The output of the permissions usage data analysis performed by Per ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Folder | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/folder.md | The **Folder** resource groups folder-related data on an item into a single stru ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Followupflag | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/followupflag.md | Allows setting a flag for the user to follow up on an item later. Supported item ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Formatprotection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/formatprotection.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Formssettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/formssettings.md | Company-wide settings for Microsoft Forms. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.formsSettings" |
v1.0 | Gcpactionpermissionsdefinitionaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/gcpactionpermissionsdefinitionaction.md | description: "Represents actions for permissions in GCP." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Gcpassociatedidentities | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/gcpassociatedidentities.md | description: "A container for different kinds of GCP identities." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Gcpauthorizationsystem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/gcpauthorizationsystem.md | description: "Represents a GCP authorization system onboarded to Permissions Man ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Gcpauthorizationsystemresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/gcpauthorizationsystemresource.md | description: "Represents a GCP resource in an GCP authorization system." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Gcpauthorizationsystemtypeaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/gcpauthorizationsystemtypeaction.md | description: "Represents an action in a GCP authorization system." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Gcpcloudfunction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/gcpcloudfunction.md | description: "Represents a cloud function in a GCP authorization system." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Gcpgroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/gcpgroup.md | description: "Represents a group in a GCP authorization system." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Gcpidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/gcpidentity.md | description: "Represents GCP identities." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Gcppermissionsdefinitionaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/gcppermissionsdefinitionaction.md | description: "Represents permissions for GCP." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Gcprole | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/gcprole.md | description: "Represents a GCP role in a GCP authorization system." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Gcprolepermissionsdefinitionaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/gcprolepermissionsdefinitionaction.md | description: "Represents actions for permissions for under GCP role." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Gcpscope | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/gcpscope.md | description: "Represents the service and resource type of a GCP resource" ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Gcpserviceaccount | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/gcpserviceaccount.md | description: "Represents GCP service accounts." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Gcpuser | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/gcpuser.md | description: "Represents GCP users." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Genericerror | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/genericerror.md | A general-purpose error. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", Here is a JSON representation of the resource. ```json {+ "@odata.type": "#microsoft.graph.genericError", "message": "String", "code": "String" } |
v1.0 | Geocoordinates | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/geocoordinates.md | If a [**driveItem**](driveitem.md) has a non-null **location** facet, the item r ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Governancepermission | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/governancepermission.md | Represents the access permission that a [governanceSubject](../resources/governa ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "optionalProperties": [ |
v1.0 | Governanceresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/governanceresource.md | No `POST`, `PUT`, `PATCH`, `DELETE` are supported on `roleDefinitions` entity se ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Governanceroleassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/governanceroleassignment.md | No `POST`, `PUT`, `PATCH`, or `DELETE` operations are supported on the `roleAssi ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { |
v1.0 | Governanceroleassignmentrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/governanceroleassignmentrequest.md | Represents the request for role assignment operations in Privileged Identity Man ### JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Governanceroleassignmentrequeststatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/governanceroleassignmentrequeststatus.md | Represents the status of the [governanceRoleAssignmentRequest](../resources/gove ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Governanceroledefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/governanceroledefinition.md | No `POST`, `PUT`, `PATCH`, `DELETE` is supported on `roleDefinitions` entity set ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Governancerolesetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/governancerolesetting.md | Represents a set of configurations on each role definition that needs to be eval ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Governancerulesetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/governancerulesetting.md | Represents the rules that the role settings are composed of. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Governanceschedule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/governanceschedule.md | Represents the schedule for a [governanceRoleAssignmentRequest](../resources/gov ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Governancesubject | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/governancesubject.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Grouplifecyclepolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/grouplifecyclepolicy.md | None. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Groupwritebackconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/groupwritebackconfiguration.md | Inherits from [writebackConfiguration](../resources/writebackconfiguration.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.groupWritebackConfiguration" |
v1.0 | Gsuitesource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/gsuitesource.md | description: "Represents an authorization system identity sourced from Google Wo ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Hardwareoathauthenticationmethodconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/hardwareoathauthenticationmethodconfiguration.md | Inherits from [authenticationMethodConfiguration](../resources/authenticationmet |includeTargets|[authenticationMethodTarget](../resources/authenticationmethodtarget.md) collection|A collection of groups that are enabled to use the authentication method. Expanded by default.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Hashes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/hashes.md | Groups available hashes into a single structure for an item. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Homerealmdiscoverypolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/homerealmdiscoverypolicy.md | The properties below form the JSON object that represents a token lifetime polic ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Horizontalsectioncolumn | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/horizontalsectioncolumn.md | Inherits from [entity](../resources/entity.md). |webparts|[webPart](../resources/webpart.md) collection|The collection of WebParts in this column.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Hostsecuritystate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/hostsecuritystate.md | Contains stateful information about the host (including devices, computers, and ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Hybridagentupdaterconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/hybridagentupdaterconfiguration.md | The update of the agent follows the below priority list ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Identity Network Access Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identity-network-access-overview.md | + + Title: "Manage Microsoft Entra identity and network access by using Microsoft Graph" +description: "Microsoft Graph provides REST APIs to help manage identity and network access capabilities, most of which are available through Microsoft Entra." +ms.localizationpriority: high ++++ Last updated : 04/30/2024+++# Manage Microsoft Entra identity and network access by using Microsoft Graph +++With Microsoft Graph, you can manage identity and network access capabilities, most of which are available through [Microsoft Entra](/entra/fundamentals/whatis). The APIs in Microsoft Graph help you to automate identity and network access management tasks and integrate with any application, and are the programmatic alternative to the administrator portals such as the Microsoft Entra admin center. ++Microsoft Entra is a family of identity and network access capabilities that are available in the following products. All these capabilities are available through Microsoft Graph APIs: +- Microsoft Entra ID that groups identity and access management (IAM) capabilities. +- Microsoft Entra ID Governance +- Microsoft Entra External ID +- Microsoft Entra Verified ID +- Microsoft Entra Permissions Management +- Microsoft Entra Internet Access and Network Access ++## Manage user identities ++Users are the main identities in any identity and access solution. You can manage the entire lifecycle of users in your organization, and their entitlements like licenses or group memberships, using Microsoft Graph APIs. For more information, see [Working with users in Microsoft Graph](/graph/api/resources/users). ++## Manage groups ++Groups are the containers that allow you to efficiently manage the entitlements for identities as a unit. For example, through a group, you can grant users access to a resource, such as a SharePoint site. Or you can grant them licenses to use a service. For more information, see [Working with groups in Microsoft Graph](/graph/api/resources/groups-overview). ++## Manage applications ++You can use Microsoft Graph APIs to register and manage your applications programmatically, enabling you to use Microsoft's IAM capabilities. For more information, see [Manage Microsoft Entra applications and service principals by using Microsoft Graph](/graph/api/resources/applications-api-overview). ++++## Tenant administration or directory management ++A core functionality of identity and access management is managing your tenant configuration, administrative roles, and settings. Microsoft Graph provides APIs to manage your Microsoft Entra tenant for the following scenarios: ++| Use cases | API operations | +|--|--| +| Manage administrative units including the following operations: <li>Create administrative units <li> Create and manage members and membership rules of administrative units <li> Assign administrator roles that are scoped to administrative units | [administrativeUnit resource type](administrativeunit.md) and its associated APIs | +| Retrieve BitLocker recovery keys | [bitlockerRecoveryKey resource type](bitlockerrecoverykey.md) and its associated APIs | +| Monitor licenses and subscriptions for the tenant | <li> [companySubscription resource type](companysubscription.md) and its associated APIs <li> [subscribedSku resource type](subscribedsku.md) and its associated APIs | +| Manage custom security attributes | See [Overview of custom security attributes using the Microsoft Graph API](custom-security-attributes-overview.md) | +| Manage deleted directory objects. The functionality to store deleted objects in a "recycle bin" is supported for the following objects: <li> Administrative units <li> Applications <li> External user profiles <li> Groups <li> Pending external user profiles <li> Service principals <li> Users | <li> [Get](../api/directory-deleteditems-get.md) or [List](../api/directory-deleteditems-list.md) deleted objects <li> [Permanently delete](../api/directory-deleteditems-delete.md) a deleted object <li> [Restore a deleted item](../api/directory-deleteditems-restore.md) <li> [List deleted items owned by user](../api/directory-deleteditems-getuserownedobjects.md) | +| Manage devices in the cloud | [device resource type](device.md) and its associated APIs | +| View local administrator credential information for all device objects in Microsoft Entra ID that are enabled with Local Admin Password Solution (LAPS). This feature is the cloud-based LAPS solution | [deviceLocalCredentialInfo resource type](devicelocalcredentialinfo.md) and its associated APIs | +| Directory objects are the core objects in Microsoft Entra ID, such as users, groups, and applications. You can use the directoryObject resource type and its associated APIs to check memberships of directory objects, track changes for multiple directory objects, or validate that a Microsoft 365 group's display name or mail nickname complies with naming policies | [directoryObject resource type](directoryobject.md) and its associated APIs | +| Administrator roles, including Microsoft Entra administrator roles, are one of the most sensitive resources in a tenant. You can manage the lifecycle of their assignment in the tenant, including creating custom roles, assigning roles, tracking changes to role assignments, and removing assignees from roles | [directoryRole resource type](directoryrole.md) and [directoryRoleTemplate resource type](directoryroletemplate.md)and their associated APIs <br/><br/> [roleManagement resource type](rolemanagement.md) and its associated APIs <br/><br/> These APIs allow you to make direct role assignments. Alternatively, you can use Privileged Identity Management APIs for [Microsoft Entra roles](privilegedidentitymanagementv3-overview.md) and [groups](privilegedidentitymanagement-for-groups-api-overview.md) to make just-in-time and time-bound role assignments, instead of direct forever active assignments. | +| Define the following configurations that can be used to customize the tenant-wide and object-specific restrictions and allowed behavior. <li> Settings for Microsoft 365 groups such as guest user access, classifications, and naming policies <li> Password rule settings such as banned password lists and lockout duration <li> Prohibited names for applications, reserved words, and blocking trademark violations <li> Custom conditional access policy URL <li> Consent policies such as user consent requests, group-specific consent, and consent for risky apps | [directorySetting resource type](directorysetting.md) and [directorySettingTemplate resource type](directorysettingtemplate.md) and their associated APIs <br/><br/> For more information, see [Overview of group settings](/graph/group-directory-settings). | +| Domain management operations such as: <li> associating a domain with your tenant <li> retrieving DNS records <li> verifying domain ownership <li> associating specific services with specific domains <li> deleting domains | [domain resource type](domain.md) and its associated APIs | +| Manage the profile objects for external users that you're invited to collaborate via Teams. These APIs aren't similar to the invitation APIs for Microsoft Entra External ID B2B collaboration | [externalUserProfile resource type](externaluserprofile.md) and [pendingExternalUserProfile resource type](externaluserprofile.md) and their associated APIs | +| Configure and manage staged rollout of specific Microsoft Entra ID features | [featureRolloutPolicy resource type](featurerolloutpolicy.md) and its associated APIs | +| Manage the policies for Mobile Device Management (MDM) and Mobile Application Management (MAM) autoenrollment for Microsoft Entra joined and registered devices | [mobilityManagementPolicy resource type](mobilitymanagementpolicy.md) and its associated APIs | +| Configure options that are available in Microsoft Entra Cloud Sync such as preventing accidental deletions and managing group writebacks. | [onPremisesDirectorySynchronization resource type](onpremisesdirectorysynchronization.md) and its associated APIs | +| Manage the base settings for your Microsoft Entra tenant | [organization resource type](organization.md) and its associated APIs | +| Manage the tenant-wide settings for your Microsoft Entra tenant, such as whether people and item insights are enabled for the organization | [organizationSettings resource type](organizationsettings.md) and its associated APIs | +| Retrieve the organizational contacts that might be synchronized from on-premises directories or from Exchange Online | [orgContact resource type](orgcontact.md) and its associated APIs | +| Discover the basic details of other Microsoft Entra tenants by querying using the tenant ID or the domain name | [tenantInformation resource type](tenantinformation.md) and its associated APIs | +| Configure trusted certificate authorities for certificates that can be assigned to apps and service principals in the tenant. | [certificateBasedApplicationConfiguration resource type](certificatebasedapplicationconfiguration.md) and its associated APIs | +| Manage the delegated permissions and their assignments to service principals in the tenant | [oAuth2PermissionGrant resource type](oauth2permissiongrant.md) and its associated APIs | ++++## Identity and sign-in ++| Use cases | API operations | +|--|--| +| Configure listeners that monitor events that should trigger or invoke custom logic, typically defined outside Microsoft Entra ID | [authenticationEventListener resource type](authenticationeventlistener.md) and its associated APIs | +| Manage authentication methods that are supported in Microsoft Entra ID | See [Microsoft Entra authentication methods API overview](authenticationmethods-overview.md) and [Microsoft Entra authentication methods policies API overview](authenticationmethodspolicies-overview.md) | +| Manage the authentication methods or combinations of authentication methods that you can apply as grant control in Microsoft Entra Conditional Access | See [Microsoft Entra authentication strengths API overview](authenticationstrengths-overview.md) | +|Manage tenant-wide authorization policies such as: <li> enable SSPR for administrator accounts <li>enable self-service join for guests <li> limit who can invite guests <li> whether users can consent to risky apps <li> block the use of MSOL <li> customize the default user permissions <li> identity private preview features enabled <li>Customize the guest user permissions between *User*, *Guest User*, and *Restricted Guest User*| [authorizationPolicy resource type](authorizationpolicy.md) and its associated APIs| +|Configure Continuous Access Evaluation (CAE), which allows access tokens to be revoked based on critical events and policy evaluation rather than relying on token expiry based on lifetime| [continuousAccessEvaluationPolicy resource type](continuousaccessevaluationpolicy.md) and its associated APIs| +| Manage the policies for certificate-based authentication in the tenant | [certificateBasedAuthConfiguration resource type](certificatebasedauthconfiguration.md) and its associated APIs | +| Manage Microsoft Entra conditional access policies | [conditionalAccessRoot resource type](conditionalaccessroot.md) and its associated APIs | +| Manage cross-tenant access settings and manage outbound restrictions, inbound restrictions, tenant restrictions, and cross-tenant synchronization of users in multitenant organizations | See [Cross-tenant access settings API overview](crosstenantaccesspolicy-overview.md) | +| Manage the user profiles that are shared with you or external tenants using B2B direct connect, including removing and exporting personal data | [inboundSharedUserProfile resource type](inboundshareduserprofile.md) and [outboundSharedUserProfile resource type](outboundshareduserprofile.md) and their associated APIs | +| Configure how and which external systems interact with Microsoft Entra ID during a user authentication session | [customAuthenticationExtension resource type](customauthenticationextension.md) and its associated APIs | +| Manage requests against user data in the organization, such as exporting personal data | [dataPolicyOperation resource type](datapolicyoperation.md) and its associated APIs | +|Configure the policies for managing Microsoft Entra join and Microsoft Entra register devices|[deviceRegistrationPolicy resource type](deviceregistrationpolicy.md) and its associated APIs| +| Manage the tenant-wide policy that controls whether external users can leave a Microsoft Entra tenant via self-service controls, for example, through the **organizations** menu of the **My Account** portal | [externalIdentitiesPolicy resource type](externalidentitiespolicy.md) and its associated APIs | +|Force autoacceleration sign-in to skip the username entry screen and automatically forward users to federated sign-in endpoints |[homeRealmDiscoveryPolicy resource type](homerealmdiscoverypolicy.md) resource type and its associated APIs| +| Detect, investigate, and remediate identity-based risks using Microsoft Entra ID Protection and feed the data into security information and event management (SIEM) tools for further investigation and correlation | See [Use the Microsoft Graph identity protection APIs](identityprotection-overview.md) | +| Manage identity providers for Microsoft Entra ID, Microsoft Entra External ID, and Azure AD B2C tenants. You can perform the following operations: <li> Manage identity providers for external identities, including social identity providers, OIDC, Apple, SAML/WS-Fed, and built-in providers <li> Manage configuration for federated domains and token validation | [identityProviderBase resource type](identityproviderbase.md) and its associated APIs | +| Invite external users to collaborate with your tenant by using Microsoft Entra External ID | [invitation resource type](invitation.md) and its associated APIs | +| Define a group of tenants belonging to your organization and streamline intra-organization cross-tenant collaboration | See [Multitenant organization API overview](multitenantorganization-overview.md) | +| Customize sign-in UIs to match your company branding, including applying branding that's based on the browser language | [organizationalBranding resource type](organizationalbranding.md) and its associated APIs | +| Customize the UI/UX in Azure AD B2C using the Identity Experience Framework (IEF) | [trustFrameworkKeySet resource type](trustframeworkkeyset.md) and [trustFrameworkPolicy resource type](trustframeworkpolicy.md) and their associated APIs | +| User flows for Microsoft Entra External ID for workforce | The following resource types and their associated APIs: <li>[b2xIdentityUserFlow](b2xidentityuserflow.md) to configure the base user flow and its properties such as identity providers <li> [identityUserFlowAttribute](identityuserflowattribute.md) to manage built-in and custom user flow attributes <li> [identityUserFlowAttributeAssignment](identityuserflowattributeassignment.md) to manage user flow attribute assignments <li> [userFlowLanguageConfiguration resource type](userflowlanguageconfiguration.md) to configure custom languages for user flows | +| User flows for Azure AD B2C | The following resource types and their associated APIs: <li>[b2cIdentityUserFlow ](b2cidentityuserflow.md) to configure the base user flow and its properties such as identity providers <li> [identityUserFlowAttribute](identityuserflowattribute.md) to manage built-in and custom user flow attributes <li> [identityUserFlowAttributeAssignment](identityuserflowattributeassignment.md) to manage user flow attribute assignments <li> [userFlowLanguageConfiguration resource type](userflowlanguageconfiguration.md) to configure custom languages for user flows | +| User flows for Microsoft Entra External ID for external tenants | [authenticationEventsFlow resource type](authenticationeventsflow.md) and its associated APIs | +|Manage app consent policies and condition sets|[permissionGrantPolicy resource type](permissiongrantpolicy.md)| +|Manage app consent preapproval policies|[permissionGrantPreApprovalPolicy resource type](permissiongrantpreapprovalpolicy.md)| +|Enable or disable security defaults in Microsoft Entra ID|[identitySecurityDefaultsEnforcementPolicy resource type](identitysecuritydefaultsenforcementpolicy.md)| ++++## Identity governance ++For more information, see [Overview of Microsoft Entra ID Governance using Microsoft Graph](identitygovernance-overview.md). ++## Microsoft Entra External ID for external tenants ++The following API use cases ar supported to customize how users interact with your customer-facing applications. For administrators, most of the features available in Microsoft Entra ID and also supported for Microsoft Entra External ID for external tenants. For example, domain management, application management, and conditional access. ++| Use cases | API operations | +|--|--| +| User flows for Microsoft Entra External ID for external tenants and self-service sign-up experiences | [authenticationEventsFlow resource type](authenticationeventsflow.md) and its associated APIs | +| Manage identity providers for Microsoft Entra External ID. You can identify the identity providers that are supported or configured in the tenant | See [identityProviderBase resoruce type](identityproviderbase.md) and its associated APIs | +| Customize sign-in UIs to match your company branding, including applying branding that's based on the browser language | [organizationalBranding resource type](organizationalbranding.md) and its associated APIs | +| Manage identity providers for Microsoft Entra External ID, such as social identities | [identityProviderBase resoruce type](identityproviderbase.md) and its associated APIs | +| Manage user profiles in Microsoft Entra External ID for customers | For more information, see [Default user permissions in customer tenants](/graph/api/resources/users#default-user-permissions-in-customer-tenants) | +| Add your own business logic to the authentication experiences by integrating with systems that are external to Microsoft Entra ID| [authenticationEventListener resource type](authenticationeventlistener.md) and [customAuthenticationExtension resource type](customauthenticationextension.md) and their associated APIs | ++## Multicloud permissions management ++For more information, see [Discover, remediate, and monitor permissions in multicloud infrastructures using permissions management APIs](permissions-management-api-overview.md). ++## Network access management ++For more information, see [Secure access to cloud, public, and private apps using Microsoft Graph network access APIs](networkaccess-global-secure-access-api-overview.md). ++## Partner tenant management ++With Microsoft Graph, you can access [Microsoft Entra](/entra/fundamentals/whatis) resources to enable scenarios like managing administrator (directory) roles, inviting external users to an organization, and, if you're a [Cloud Solution Provider (CSP)](https://partner.microsoft.com/cloud-solution-provider), managing your customer's data. Microsoft Graph also provides methods apps can use, for example, to discover information about users' transitive group and role memberships. +++| Use cases | API operations | +|--|| +| Manage contracts for the partner with its customers | [contract resource type](contract.md) and its associated APIs | +| Microsoft partners in the Cloud Solution Provider (CSP), Value Added Reseller (VAR), or Advisor programs can empower their customers to ensure the partners have least privileged access to their customers' tenants. This feature gives extra control to customers over their security posture while allowing them to receive support from the Microsoft resellers | See [Granular delegated admin privileges (GDAP) API overview](delegatedadminrelationships-api-overview.md) | ++++## Licensing ++Microsoft Entra licenses include Microsoft Entra ID Free, P1, P2, and Governance; Microsoft Entra Permissions Management; and Microsoft Entra Workload ID. ++For detailed information about licensing for different features, see [Microsoft Entra ID licensing](/entra/fundamentals/licensing). ++## Related content ++- [Implement identity standards with Microsoft Entra ID](/entra/standards/) +- [Microsoft Entra ID Guide for independent software developers](/entra/architecture/guide-for-independent-software-developers) |
v1.0 | Identitybuiltinuserflowattribute | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identitybuiltinuserflowattribute.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Identitycustomuserflowattribute | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identitycustomuserflowattribute.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Identitydetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identitydetails.md | description: "Represents the details for identity findings." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Identityfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identityfinding.md | description: "Represents a finding related to an identity such as a user, role, ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Identitygovernance Attributechangetrigger | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identitygovernance-attributechangetrigger.md | + + Title: "attributeChangeTrigger resource type" +description: "An abstract type representing changes in user attributes that trigger the execution of workload conditions for a user." ++ms.localizationpriority: medium ++++# attributeChangeTrigger resource type ++Namespace: microsoft.graph.identityGovernance +++An abstract type representing changes in user attributes that trigger the execution of workload conditions for a user. ++Inherits from [microsoft.graph.identityGovernance.workflowExecutionTrigger](../resources/identitygovernance-workflowexecutiontrigger.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|triggerAttributes|[microsoft.graph.identityGovernance.triggerAttribute](../resources/identitygovernance-triggerattribute.md) collection|The trigger attribute being changed that triggers the workflowexecutiontrigger of a workflow.)| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.identityGovernance.attributeChangeTrigger" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.identityGovernance.attributeChangeTrigger", + "triggerAttributes": [ + { + "@odata.type": "microsoft.graph.identityGovernance.triggerAttribute" + } + ] +} +``` + |
v1.0 | Identitygovernance Groupbasedsubjectset | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identitygovernance-groupbasedsubjectset.md | + + Title: "groupBasedSubjectSet resource type" +description: "Defines the group that is the scope of a lifecycle workflow membershipChangeTrigger configuration." ++ms.localizationpriority: medium ++++# groupBasedSubjectSet resource type ++Namespace: microsoft.graph.identityGovernance +++Defines the group that is the scope of a lifecycle workflow [membershipChangeTrigger](../resources/identitygovernance-membershipchangetrigger.md) configuration. ++Inherits from [microsoft.graph.subjectSet](../resources/subjectset.md). ++## Properties +None. ++## Relationships +|Relationship|Type|Description| +|:|:|:| +|groups|[microsoft.graph.group](../resources/group.md) collection|The specific group a user is interacting with in a [membershipChangeTrigger](identitygovernance-membershipchangetrigger.md) workflow.| ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.identityGovernance.groupBasedSubjectSet" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.identityGovernance.groupBasedSubjectSet" +} +``` + |
v1.0 | Identitygovernance Lifecycleworkflows Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identitygovernance-lifecycleworkflows-overview.md | Title: "Overview of Lifecycle Workflows APIs" description: "Use Lifecycle Workflows to manage the lifecycle of users in your organization." ms.localizationpriority: medium + doc_type: conceptualPageType Last updated 03/12/2024 Last updated 03/12/2024 Lifecycle Workflows is an Identity Governance service in Microsoft Entra ID that enables organizations to automate basic lifecycle processes for their users at three levels: -1. **Joiner**: When an individual comes into scope of needing access; for example, a new employee joining a company or organization. +1. **Joiner**: When an individual comes into the scope of needing access; for example, a new employee joining a company or organization. 2. **Mover**: When an individual moves between boundaries within an organization; for example, a user who was in marketing is now a member of the sales organization. This movement might require more access or authorization, or revocation of other privileges.-3. **Leaver**: When an individual leaves the scope of needing access, access might need to be revoked, and the user deprovisioned. For example, an employee who is retiring or has been terminated. +3. **Leaver**: When an individual leaves the scope of needing access, access might need to be revoked, and the user deprovisioned. For example, an employee who is retiring or terminated. -For this reason, Lifecycle Workflows can be referred to as the **Joiner-Mover-Leaver** (JML) workflow. Only the *joiner* and *leaver* processes are currently implemented. +For this reason, lifecycle workflows can be referred to as the **Joiner-Mover-Leaver** (JML) workflow. -The lifecycle workflows APIs in Microsoft Graph allow you to automate the Lifecycle Workflows capabilities for your organization. This article introduced the set of APIs that enable the Lifecycle Workflows service in Microsoft Entra ID. +The lifecycle workflow APIs in Microsoft Graph allow you to automate the Lifecycle workflow capabilities for your organization. This article introduced the set of APIs that enable the Lifecycle Workflows service in Microsoft Entra ID. The lifecycle workflows APIs are defined in the OData subnamespace, microsoft.graph.identityGovernance. When creating or updating a workflow, use the [workflowExecutionConditions resou ### Create and manage workflows -After identifying the tasks and execution conditions that you want to define for your workflow, use the [workflow resource type](identitygovernance-workflow.md), and its associated methods to create and manage the workflow. You can create up to 50 workflows in a tenant. The category of the task must match the category of the workflow. Each workflow can have up to 25 tasks. Therefore: +After identifying the tasks and execution conditions that you want to define for your workflow, use the [workflow resource type](identitygovernance-workflow.md), and its associated methods to create and manage the workflow. You can create up to 100 workflows in a tenant. The category of the task must match the category of the workflow. Each workflow can have up to 25 tasks. Therefore: -+ A task supported for only the "leaver" workflow category can't be specified in a "joiner" workflow scenario, and vice versa. -+ A task supported for both "leaver" and "joiner" workflow categories can be specified in either a "joiner" or "leaver" workflow scenario. ++ A task supported for only the "leaver" workflow category can't be specified in a "joiner" or "mover" workflow scenario, and vice versa.++ A task supported for "joiner", "mover", and "leaver" workflow categories can be specified in either a "joiner", "mover" or "leaver" workflow scenario. -You can schedule a workflow to run based on the [tenant-wide schedule](#settings) or run it on-demand. The tenant schedule can take care of regular new hires and terminations, while you can run a workflow on-demand to immediately terminate an employee's access if there was a sensitive event. +You can schedule a workflow to run based on the [tenant-wide schedule](#settings) or run it on-demand. The tenant schedule can take care of scheduled new hires and terminations, while you can run a workflow on-demand immediately to terminate an employee's access if there is a sensitive event. ### Workflow versions While a workflow is in use, you might need to update execution conditions and tasks for a workflow. However, Lifecycle Workflows doesn't allow you to update these properties for an existing workflow. -Instead of creating new workflows, use the [workflowVersion resource type](identitygovernance-workflowversion.md) and its associated methods to create and manage a new workflow version, based off an existing workflow object. The workflow version can have similar or a different set of tasks and execution conditions. +Instead of creating new workflows, use the [workflowVersion resource type](identitygovernance-workflowversion.md) and its associated methods to create and manage a new workflow version, based on an existing workflow object. The workflow version can have a similar or a different set of tasks and execution conditions. ## Reports |
v1.0 | Identitygovernance Lifecycleworkflows Reporting Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identitygovernance-lifecycleworkflows-reporting-overview.md | Lifecycle Workflows offers reports that enable organizations to gain insight int [!INCLUDE [GDPR-related-guidance](../../includes/gdpr-msgraph-export-note.md)] -The lifecycle workflows API is defined in the OData subnamespace, microsoft.graph.identityGovernance. +The lifecycle workflows API is defined in the OData subnamespace, microsoft.graph.identityGovernance. ## Key elements of Lifecycle Workflows reports |
v1.0 | Identitygovernance Membershipchangetrigger | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identitygovernance-membershipchangetrigger.md | + + Title: "membershipChangeTrigger resource type" +description: "An abstract type representing the change in group membership that triggers the execution conditions of a workflow for a user." ++ms.localizationpriority: medium ++++# membershipChangeTrigger resource type ++Namespace: microsoft.graph.identityGovernance +++An abstract type representing the change in group membership that triggers the execution conditions of a workflow for a user. ++Inherits from [microsoft.graph.identityGovernance.workflowExecutionTrigger](../resources/identitygovernance-workflowexecutiontrigger.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|changeType|microsoft.graph.identityGovernance.membershipChangeType|Defines what change that happens to the workflow group to trigger the [workflowExecutionTrigger](../resources/identitygovernance-workflowexecutiontrigger.md). Possible values are: `add`, `remove`, `unknownFutureValue`.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.identityGovernance.membershipChangeTrigger" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.identityGovernance.membershipChangeTrigger", + "changeType": "String" +} +``` |
v1.0 | Identitygovernance Triggerattribute | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identitygovernance-triggerattribute.md | + + Title: "triggerAttribute resource type" +description: "An abstract type that defines the trigger attribute, which is changed to activate a workflow using an attributeChangeTrigger." ++ms.localizationpriority: medium ++++# triggerAttribute resource type ++Namespace: microsoft.graph.identityGovernance +++An abstract type that defines the trigger attribute, which is changed to activate a workflow using an [attributeChangeTrigger](../resources/identitygovernance-attributechangetrigger.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|name|String|The name of the trigger attribute that is changed to trigger an [attributeChangeTrigger](../resources/identitygovernance-attributechangetrigger.md) workflow.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.identityGovernance.triggerAttribute" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.identityGovernance.triggerAttribute", + "name": "String" +} +``` + |
v1.0 | Identitygovernance Workflow | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identitygovernance-workflow.md | Namespace: microsoft.graph.identityGovernance Represents workflows created using Lifecycle Workflows. Workflows, when triggered by execution conditions, automate parts of the lifecycle management process using tasks. These tasks can either be built-in tasks, or a custom task can be called using the custom task extension which integrate with Azure Logic Apps. -You can create up to 50 workflows in a tenant. +You can create up to 100 workflows in a tenant. Inherits from [workflowBase](../resources/identitygovernance-workflowbase.md). |
v1.0 | Identitygovernance Workflowbase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identitygovernance-workflowbase.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Identitygovernance Workflowexecutionconditions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identitygovernance-workflowexecutionconditions.md | Title: "workflowExecutionConditions resource type" -description: "An abstract type that's inherited by derived types that define different conditions that trigger execution of a workflow." +description: "An abstract type inherited by derived types that define different conditions that trigger execution of a workflow." ms.localizationpriority: medium Namespace: microsoft.graph.identityGovernance [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -This is an abstract type noting the workflow execution conditions in [workflowTemplate](../resources/identitygovernance-workflowtemplate.md) and [workflowBase](../resources/identitygovernance-workflowbase.md) objects. Execution conditions define when a workflow will run and rules that identify the users that are the target of the workflow. The following types are derived from this abstract type: +This is an abstract type noting the workflow execution conditions in [workflowTemplate](../resources/identitygovernance-workflowtemplate.md) and [workflowBase](../resources/identitygovernance-workflowbase.md) objects. Execution conditions define when a workflow runs and rules that identify the users that are the target of the workflow. The following types are derived from this abstract type: + + [onDemandExecutionOnly](../resources/identitygovernance-ondemandexecutiononly.md) + [triggerAndScopeBasedConditions](../resources/identitygovernance-triggerandscopebasedconditions.md) None. ## JSON representation -The following is a JSON representation of the resource. +The following JSON representation shows the resource. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.identityGovernance.workflowExecutionConditions" |
v1.0 | Identitygovernance Workflowexecutiontrigger | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identitygovernance-workflowexecutiontrigger.md | Namespace: microsoft.graph.identityGovernance [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -This is an abstract type that represents the workflow execution trigger when the [workflow runs on schedule](../resources/identitygovernance-triggerandscopebasedconditions.md). It's inherited by the following derived types: +An abstract type that represents the workflow execution trigger when the [workflow runs on schedule](../resources/identitygovernance-triggerandscopebasedconditions.md). Inherited by the following derived types: + [timeBasedAttributeTrigger](../resources/identitygovernance-timebasedattributetrigger.md)++ [attributeChangeTrigger](../resources/identitygovernance-attributechangetrigger.md)++ [membershipChangeTrigger](../resources/identitygovernance-membershipchangetrigger.md) ## Properties None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.identityGovernance.workflowExecutionTrigger" |
v1.0 | Identitysecuritydefaultsenforcementpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identitysecuritydefaultsenforcementpolicy.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Identityset | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identityset.md | description: "Represents a keyed collection of identity resources." Title: "identitySet resource type" ms.localizationpriority: medium doc_type: resourcePageType+ # identitySet resource type |
v1.0 | Identitysource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identitysource.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.identitySource" |
v1.0 | Identityuserflow | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identityuserflow.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Identityuserflowattribute | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identityuserflowattribute.md | Configuring user flow attributes in your Microsoft Entra ID or Azure AD B2C tena ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Identityuserflowattributeassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identityuserflowattributeassignment.md | identityUserFlowAttributeAssignments are used to collect specific identityUserFl ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Implicitgrantsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/implicitgrantsettings.md | Specifies whether this web application can request tokens using the OAuth 2.0 im |enableAccessTokenIssuance| Boolean | Specifies whether this web application can request an access token using the OAuth 2.0 implicit flow.| ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Inactiveawsresourcefinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/inactiveawsresourcefinding.md | description: "Represents inactive AWS resources." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Inactiveawsrolefinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/inactiveawsrolefinding.md | description: "Represents inactive AWS roles." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Inactiveazureserviceprincipalfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/inactiveazureserviceprincipalfinding.md | description: "Represents the inactive Azure service principals." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Inactivegcpserviceaccountfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/inactivegcpserviceaccountfinding.md | description: "Represents the inactive GCP service acccounts." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Inactivegroupfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/inactivegroupfinding.md | description: "Contains analytic information for an inactive group in an authoriz ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Inactiveserverlessfunctionfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/inactiveserverlessfunctionfinding.md | description: "Represents the inactive serverless functions in AWS, Azure, and GC ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Inactiveuserfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/inactiveuserfinding.md | description: "Represents the inactive users in AWS, Azure, or GCP." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Inboundoutboundpolicyconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/inboundoutboundpolicyconfiguration.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.inboundOutboundPolicyConfiguration" |
v1.0 | Inboundports | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/inboundports.md | description: Contains information about ports that allow inbound traffic." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Inboundshareduserprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/inboundshareduserprofile.md | Title: "inboundSharedUserProfile resource type" description: "Represents a Microsoft Entra user from an external Microsoft Entra tenant whose profile data is shared with the current tenant using B2B direct connect." + ms.localizationpriority: medium doc_type: resourcePageType None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "userId", |
v1.0 | Includetarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/includetarget.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.includeTarget" |
v1.0 | Incomingcontext | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/incomingcontext.md | The context associated with an incoming call. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Industrydata Additionalclassgroupoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/industrydata-additionalclassgroupoptions.md | + + Title: "additionalClassGroupOptions resource type" +description: "The different management choices for the class groups to be provisioned." ++ms.localizationpriority: medium ++++# additionalClassGroupOptions resource type ++Namespace: microsoft.graph.industryData +++The different management choices for the class groups to be provisioned. ++## Properties ++| Property | Type | Description | +| : | : | : | +| createTeam | Boolean | Indicates whether a team should be created for the class group. | +| writeDisplayNameOnCreateOnly | Boolean | Indicates whether the class group display name should be set on create. | ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.industryData.additionalClassGroupOptions" +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.industryData.additionalClassGroupOptions", + "createTeam": "Boolean", + "writeDisplayNameOnCreateOnly": "Boolean" +} +``` |
v1.0 | Industrydata Additionaluseroptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/industrydata-additionaluseroptions.md | + + Title: "additionalUserOptions resource type" +description: "The different management choices for the users to be provisioned." ++ms.localizationpriority: medium ++++# additionalUserOptions resource type ++Namespace: microsoft.graph.industryData +++The different management choices for the users to be provisioned. ++## Properties ++| Property | Type | Description | +| :-- | : | :-- | +| allowStudentContactAssociation | Boolean | Indicates whether student contact association should be allowed. | +| markAllStudentsAsMinors | Boolean | Indicates whether all students should be marked as minors. | ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.industryData.additionalUserOptions" +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.industryData.additionalUserOptions", + "markAllStudentsAsMinors": "Boolean", + "allowStudentContactAssociation": "Boolean" +} +``` |
v1.0 | Industrydata Administrativeunitprovisioningflow | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/industrydata-administrativeunitprovisioningflow.md | + + Title: "administrativeUnitProvisioningFlow resource type" +description: "Represents the parameters that school data sync uses to create administrative units from your inbound data." ++ms.localizationpriority: medium ++++# administrativeUnitProvisioningFlow resource type ++Namespace: microsoft.graph.industryData +++Represents the parameters that school data sync uses to create administrative units from your inbound data. Administrative units provide a grouping construct for delegated IT administration and scoped role assignments. Scoped role assignments allow admins to manage a subset of the broader Microsoft 365 directory. ++administrativeUnitProvisioningFlow is defined within an [outboundProvisioningFlowSet](industrydata-outboundprovisioningflowset.md) that may specify a filter based on a subset of available organizations (schools) or may include all of the organizations in the inbound data. ++There may be multiple administrativeUnitProvisioningFlows, defined within separate outboundProvsioningFlowSets allowing different configurations for different organizations. ++Inherits from [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md). ++## Methods ++| Method | Return type | Description | +| :- | :-- | : | +| [Get administrativeUnitProvisioningFlow](../api/industrydata-administrativeunitprovisioningflow-get.md) | [microsoft.graph.industryData.administrativeUnitProvisioningFlow](industrydata-administrativeunitprovisioningflow.md) | Read the properties and relationships of an administrativeunitprovisioningflow object. | +| [Update administrativeUnitProvisioningFlow](../api/industrydata-administrativeunitprovisioningflow-update.md) | [microsoft.graph.industryData.administrativeUnitProvisioningFlow](industrydata-administrativeunitprovisioningflow.md) | Update the properties of an administrativeunitprovisioningflow object. | +| [Delete administrativeUnitProvisioningFlow](../api/industrydata-administrativeunitprovisioningflow-delete.md) | None | Delete an administrativeunitprovisioningflow object. | ++## Properties ++| Property | Type | Description | +| :- | :- | : | +| createdDateTime | DateTimeOffset | Inherited from [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md). | +| creationOptions | [microsoft.graph.industryData.adminUnitCreationOptions](industrydata-adminunitcreationoptions.md) | The different attribute choices for the administrative units to be provisioned. | +| id | String | Inherited from [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md). | +| lastModifiedDateTime | DateTimeOffset | Inherited from [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md). | +| readinessStatus | microsoft.graph.industryData.readinessStatus | Inherited from [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md). The possible values are: `notReady`, `ready`, `failed`, `disabled`, `expired`, `unknownFutureValue`. | ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.industryData.administrativeUnitProvisioningFlow", + "baseType": "microsoft.graph.industryData.provisioningFlow", + "openType": false +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.industryData.administrativeUnitProvisioningFlow", + "createdDateTime": "String (timestamp)", + "lastModifiedDateTime": "String (timestamp)", + "readinessStatus": "String", + "id": "String (identifier)", + "creationOptions": { + "@odata.type": "microsoft.graph.industryData.adminUnitCreationOptions" + } +} +``` |
v1.0 | Industrydata Adminunitcreationoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/industrydata-adminunitcreationoptions.md | + + Title: "adminUnitCreationOptions resource type" +description: "The different management choices for the administrative units to be provisioned." ++ms.localizationpriority: medium ++++# adminUnitCreationOptions resource type ++Namespace: microsoft.graph.industryData +++The different management choices for the administrative units to be provisioned. ++## Properties ++| Property | Type | Description | +| :- | : | : | +| createBasedOnOrg | Boolean | Indicates whether the administrative unit should be created based on the org. | +| createBasedOnOrgPlusRoleGroup | Boolean | Indicates whether the administrative unit should be created based on the org and role group. | ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.industryData.adminUnitCreationOptions" +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.industryData.adminUnitCreationOptions", + "createBasedOnOrg": "Boolean", + "createBasedOnOrgPlusRoleGroup": "Boolean" +} +``` |
v1.0 | Industrydata Basicfilter | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/industrydata-basicfilter.md | + + Title: "basicFilter resource type" +description: "A basic filter implementation with single condition on a single attribute" ++ms.localizationpriority: medium ++++# basicFilter resource type ++Namespace: microsoft.graph.industryData +++A basic filter implementation with single condition on a single attribute. ++Inherits from [microsoft.graph.industryData.filter](../resources/industrydata-filter.md). ++## Properties ++| Property | Type | Description | +| :-- | :-- | : | +| attribute | microsoft.graph.industryData.filteroptions | The attribute to filter on. The possible values are: `orgExternalId`, `unknownFutureValue`. | +| in | String collection | The condition to filter with. | ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.industryData.basicFilter" +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.industryData.basicFilter", + "attribute": "String", + "in": ["String"] +} +``` |
v1.0 | Industrydata Classgroupconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/industrydata-classgroupconfiguration.md | + + Title: "classGroupConfiguration resource type" +description: "The different configurations choices for the class groups to be provisioned with." ++ms.localizationpriority: medium ++++# classGroupConfiguration resource type ++Namespace: microsoft.graph.industryData +++The different configurations choices for the class groups to be provisioned with. ++## Properties ++| Property | Type | Description | +| :- | :- | : | +| additionalAttributes | microsoft.graph.industryData.additionalClassGroupAttributes collection | The different attributes to sync for the class groups. The possible values are: `courseTitle`, `courseCode`, `courseSubject`, `courseGradeLevel`, `courseExternalId`, `academicSessionTitle`, `academicSessionExternalId`, `classCode`, `unknownFutureValue`. | +| additionalOptions | [microsoft.graph.industryData.additionalClassGroupOptions](../resources/industrydata-additionalclassgroupoptions.md) | The different options for the class groups to be provisioned with. | +| enrollmentMappings | [microsoft.graph.industryData.enrollmentMappings](../resources/industrydata-enrollmentmappings.md) | The different enrollmentMappings for the class groups to be provisioned with. | ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.industryData.classGroupConfiguration" +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.industryData.classGroupConfiguration", + "additionalAttributes": ["String"], + "additionalOptions": { + "@odata.type": "microsoft.graph.industryData.additionalClassGroupOptions" + }, + "enrollmentMappings": { + "@odata.type": "microsoft.graph.industryData.enrollmentMappings" + } +} +``` |
v1.0 | Industrydata Classgroupprovisioningflow | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/industrydata-classgroupprovisioningflow.md | + + Title: "classGroupProvisioningFlow resource type" +description: "Represents the parameters that school data sync uses to create class groups and teams in Microsoft 365 from your inbound data." ++ms.localizationpriority: medium ++++# classGroupProvisioningFlow resource type ++Namespace: microsoft.graph.industryData +++Represents the parameters that school data sync uses to create class groups and teams in Microsoft 365 from your inbound data. Class groups allow users to connect, communicate, and collaborate across various Microsoft 365 applications including Teams. ++classGroupProvisioningFlow is defined within an [outboundProvisioningFlowSet](industrydata-outboundprovisioningflowset.md) that may specify a filter based on a subset of available organizations (schools) or may include all of the organizations in the inbound data. ++There may be multiple classGroupProvisioningFlows, defined within separate OutboundProvsioningFlowSets (editor note, hyperlink to related docs) allowing different configurations for different organizations. ++Inherits from [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md). ++## Methods ++| Method | Return type | Description | +| : | :- | :-- | +| [Get classGroupProvisioningFlow](../api/industrydata-classgroupprovisioningflow-get.md) | [microsoft.graph.industryData.classGroupProvisioningFlow](industrydata-classgroupprovisioningflow.md) | Read the properties and relationships of a classgroupprovisioningflow object. | +| [Update classGroupProvisioningFlow](../api/industrydata-classgroupprovisioningflow-update.md) | [microsoft.graph.industryData.classGroupProvisioningFlow](industrydata-classgroupprovisioningflow.md) | Update the properties of a classgroupprovisioningflow object. | +| [Delete classGroupProvisioningFlow](../api/industrydata-classgroupprovisioningflow-delete.md) | None. | Delete a classgroupprovisioningflow object. | ++## Properties ++| Property | Type | Description | +| :- | :-- | : | +| configuration | [microsoft.graph.industryData.classGroupConfiguration](industrydata-classgroupconfiguration.md) | The different attribute choices for the class groups to be provisioned. | +| createdDateTime | DateTimeOffset | Inherited from [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md). | +| id | String | Inherited from [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md). | +| lastModifiedDateTime | DateTimeOffset | Inherited from [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md). | +| readinessStatus | microsoft.graph.industryData.readinessStatus | Inherited from [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md). The possible values are: `notReady`, `ready`, `failed`, `disabled`, `expired`, `unknownFutureValue`. | ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.industryData.classGroupProvisioningFlow", + "baseType": "microsoft.graph.industryData.provisioningFlow", + "openType": false +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.industryData.classGroupProvisioningFlow", + "createdDateTime": "String (timestamp)", + "lastModifiedDateTime": "String (timestamp)", + "readinessStatus": "String", + "id": "String (identifier)", + "configuration": { + "@odata.type": "microsoft.graph.industryData.classGroupConfiguration" + } +} +``` |
v1.0 | Industrydata Enrollmentmappings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/industrydata-enrollmentmappings.md | + + Title: "enrollmentMappings resource type" +description: "The different management choices for the class groups to be provisioned." ++ms.localizationpriority: medium ++++# enrollmentMappings resource type ++Namespace: microsoft.graph.industryData +++The different management choices for the class groups to be provisioned. ++## Properties ++| Property | Type | Description | +| :-- | :-- | : | +| memberEnrollmentMappings | [microsoft.graph.industryData.sectionRoleReferenceValue](../resources/industrydata-sectionrolereferencevalue.md) collection | The enrollmentMappings member for the class group. | +| ownerEnrollmentMappings | [microsoft.graph.industryData.sectionRoleReferenceValue](../resources/industrydata-sectionrolereferencevalue.md) collection | The enrollmentMappings owner for the class group. | ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.industryData.enrollmentMappings" +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.industryData.enrollmentMappings", + "ownerEnrollmentMappings": [ + { + "@odata.type": "microsoft.graph.industryData.sectionRoleReferenceValue" + } + ], + "memberEnrollmentMappings": [ + { + "@odata.type": "microsoft.graph.industryData.sectionRoleReferenceValue" + } + ] +} +``` |
v1.0 | Industrydata Filter | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/industrydata-filter.md | + + Title: "filter resource type" +description: "A filter base type" ++ms.localizationpriority: medium ++++# filter resource type ++Namespace: microsoft.graph.industryData +++A filter base type. This is an abstract type. ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.industryData.filter" +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.industryData.filter" +} +``` |
v1.0 | Industrydata Outboundprovisioningflowset | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/industrydata-outboundprovisioningflowset.md | + + Title: "outboundProvisioningFlowSet resource type" +description: "Represents a collection of outbound provisioning flows used to configure how school data sync populates data in Microsoft 365 and Microsoft Entra ID." ++ms.localizationpriority: medium ++++# outboundProvisioningFlowSet resource type ++Namespace: microsoft.graph.industryData +++Represents a collection of outbound provisioning flows used to configure how school data sync populates data in Microsoft 365 and Microsoft Entra ID. A flow set may specify a filter based on a subset of available organizations (schools) or may include all of the organizations in the inbound data. There may be multiple outboundProvisioningFlowSets, allowing different configurations for different organizations. Each outbound provisioning flow set doesn't need to include every provisioning flow type. ++Outbound provisioning flow set may contain no more than one (1) of each provisioning flow configuration that is being configured: [userProvisioningFlow](industrydata-userprovisioningflow.md), [classGroupProvisioingFlow](industrydata-classgroupprovisioningflow.md), [securityGroupProvisioingFlow](industrydata-securitygroupprovisioningflow.md), [administrativeUnitProvisioingFlow](industrydata-administrativeunitprovisioningflow.md). ++## Methods ++| Method | Return type | Description | +| :-- | : | :- | +| [List outboundProvisioningFlowSet objects](../api/industrydata-industrydataroot-list-outboundprovisioningflowsets.md) | [microsoft.graph.industryData.outboundProvisioningFlowSet](industrydata-outboundprovisioningflowset.md) collection | Get a list of outboundprovisioningflowset objects and their properties. | +| [Create outboundProvisioningFlowSet](../api/industrydata-industrydataroot-post-outboundprovisioningflowsets.md) | [microsoft.graph.industryData.outboundProvisioningFlowSet](industrydata-outboundprovisioningflowset.md) | Create a new outboundprovisioningflowset object. | +| [Get outboundProvisioningFlowSet](../api/industrydata-outboundprovisioningflowset-get.md) | [microsoft.graph.industryData.outboundProvisioningFlowSet](industrydata-outboundprovisioningflowset.md) | Read the properties and relationships of an outboundprovisioningflowset object. | +| [Update outboundProvisioningFlowSet](../api/industrydata-outboundprovisioningflowset-update.md) | [microsoft.graph.industryData.outboundProvisioningFlowSet](industrydata-outboundprovisioningflowset.md) | Update the properties of an outboundprovisioningflowset object. | +| [Delete outboundProvisioningFlowSet](../api/industrydata-industrydataroot-delete-outboundprovisioningflowsets.md) | None | Delete an outboundprovisioningflowset object. | +| [List provisioningFlows](../api/industrydata-outboundprovisioningflowset-list-provisioningflows.md) | [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md) collection | Get the provisioningFlow resources from the provisioningFlows navigation property. | +| [Create provisioningFlow](../api/industrydata-outboundprovisioningflowset-post-provisioningflows.md) | [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md) | Create a new provisioningFlow object. | ++## Properties ++| Property | Type | Description | +| :- | :- | :-- | +| createdDateTime | DateTimeOffset | The date and time when the flowSet was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. | +| displayName | String | The display name of the flowSet provided by the caller. | +| filter | [microsoft.graph.industryData.filter](industrydata-filter.md) | The collection of provisioning filters applicable to all the flows under the given flowSet. | +| id | String | The unique identifier for the flowSet. Inherited from [entity](entity.md). | +| lastModifiedDateTime | DateTimeOffset | The date and time when the flowSet was most recently changed. The timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. | ++## Relationships ++| Relationship | Type | Description | +| :- | :-- | :-- | +| provisioningFlows | [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md) collection | A flow that provisions relevant records of a given entity type in the Microsoft 365 tenant. | ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.industryData.outboundProvisioningFlowSet", + "openType": false +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.industryData.outboundProvisioningFlowSet", + "displayName": "String", + "createdDateTime": "String (timestamp)", + "lastModifiedDateTime": "String (timestamp)", + "id": "String (identifier)", + "filter": { + "@odata.type": "microsoft.graph.industryData.filter" + } +} +``` |
v1.0 | Industrydata Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/industrydata-overview.md | The industry data API is defined in the OData subnamespace `microsoft.graph.indu ## Industry data API and education -The industry data API powers the [Microsoft School Data Sync](https://sds.microsoft.com) (SDS) platform to help automate the process of importing data and synchronizing organizations, users and users associations, and groups <!-- with Azure Active Directory (Azure AD) and Office 365 --> from student information systems (SIS) and student management systems (SMS) into an organization's Azure Data Lake. After normalizing the data in Azure Data Lake <!-- the API utilizes the data in multiple outbound flows, --> SDS can synchronize the data with [Insights for Education Leaders](/schooldatasync/enable-sync-with-insights), for use with the Insights app in Teams for Education, and [Education Data Lake Export](/schooldatasync/enable-education-data-lake-export), for custom analytics scenarios. +The industry data API powers the [Microsoft School Data Sync](https://sds.microsoft.com) (SDS) platform to help automate the process of importing data and synchronizing organizations, users and users associations, and groups with Microsoft Entra ID and Microsoft 365 from student information systems (SIS) and student management systems (SMS). After normalizing the data the API utilizes the data through multiple outbound provisioning flows to manage users, class groups, administrative units, and security groups. ![Illustration of the industry data ETL process](/graph/images/industrydata-overview.png) At the end of each run, [industryDataRunStatistics](industrydata-industrydatarun Errors and warnings related to **industryDataRunStatistics** are produced to help provide an initial understanding of data health. When you investigate data health, industry data provides the ability to download a log file that contains information based on the errors and warnings found to begin the data investigation process to correct the data in the source system. -After investigating and addressing any data errors or warnings, when you're comfortable with the current state of the data health, you can enable the scenarios with the data that is now in the education data lake. When you enable a scenario to use this data, the scenario creates an outbound flow. <!-- Outbound flows are defined by Microsoft 365 provisioning, Insights & Analytics. --> +After investigating and addressing any data errors or warnings, when you're comfortable with the current state of the data health, you can enable the scenarios with the data. When you enable a scenario to use this data, the scenario creates an outbound provisioning flow. -<!-- Microsoft 365 Provisioning outbound flows help with simplifying management of users and classes. Only active and matched users are included in the data that will be used to write the link to the AAD user object between the SIS/ SMS and their sections for groups and Teams classrooms. --> --Insights and analytics help provide analysis for student progress and activity within their classes. Guided by this data, educators have the information they need to ensure that their students' emotional, social, and academic needs are met. +Managing data through outbound provisioning flows simplifies the management of users and classes. Only active and matched users are included in the data that is used to write the link to the Microsoft Entra user object. This link facilitates the integration between the SIS/SMS and their sections for groups and Microsoft Teams classrooms. For more information, see the sections School Data Sync, SDS prerequisites, and SDS core concepts of the [School Data Sync overview](/schooldatasync/school-data-sync-overview). Transformation of the data is often shaped by each individual user's role within ### Industry data connectors -An [industryDataConnector](industrydata-industrydataconnector.md) acts as a bridge between a [sourceSystemDefinition](industrydata-sourcesystemdefinition.md) and an [inboundFlow](industrydata-inboundflow.md). It is responsible for acquiring data from an external source and providing the data to inbound data flows. +An [industryDataConnector](industrydata-industrydataconnector.md) acts as a bridge between a [sourceSystemDefinition](industrydata-sourcesystemdefinition.md) and an [inboundFlow](industrydata-inboundflow.md). It's responsible for acquiring data from an external source and providing the data to inbound data flows. #### Upload and validate CSV data |
v1.0 | Industrydata Passwordsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/industrydata-passwordsettings.md | + + Title: "passwordSettings resource type" +description: "The different password settings for the users to be provisioned" ++ms.localizationpriority: medium ++++# passwordSettings resource type ++Namespace: microsoft.graph.industryData +++The different password settings for the users to be provisioned. +This is an abstract type. ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.industryData.passwordSettings" +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.industryData.passwordSettings" +} +``` |
v1.0 | Industrydata Provisioningflow | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/industrydata-provisioningflow.md | + + Title: "provisioningFlow resource type" +description: "A flow that provisions relevant records of a given entity type in the Microsoft 365 tenant." ++ms.localizationpriority: medium ++++# provisioningFlow resource type ++Namespace: microsoft.graph.industryData +++A flow that provisions relevant records of a given entity type in the Microsoft 365 tenant. +This is an abstract type. ++## Methods ++| Method | Return type | Description | +| : | :-- | : | +| [List provisioningFlow objects](../api/industrydata-outboundprovisioningflowset-list-provisioningflows.md) | [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md) collection | Get a list of the provisioningflow objects and their properties. | +| [Create provisioningFlow](../api/industrydata-outboundprovisioningflowset-post-provisioningflows.md) | [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md) | Create a new provisioningflow object. | ++## Properties ++| Property | Type | Description | +| :- | :- | : | +| createdDateTime | DateTimeOffset | The date and time when the provisioning flow was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. | +| id | String | The unique identifier for the provisioning flow. Inherited from [entity](entity.md). | +| lastModifiedDateTime | DateTimeOffset | The date and time when the provisioning flow was most recently changed. The timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. | +| readinessStatus | microsoft.graph.industryData.readinessStatus | The state of the activity from creation through to ready to do work. The possible values are: `notReady`, `ready`, `failed`, `disabled`, `expired`, `unknownFutureValue`. | ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.industryData.provisioningFlow", + "openType": false +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.industryData.provisioningFlow", + "createdDateTime": "String (timestamp)", + "lastModifiedDateTime": "String (timestamp)", + "readinessStatus": "String", + "id": "String (identifier)" +} +``` |
v1.0 | Industrydata Sectionrolereferencevalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/industrydata-sectionrolereferencevalue.md | + + Title: "sectionRoleReferenceValue resource type" +description: " A reference value for a role in a section." ++ms.localizationpriority: medium ++++# sectionRoleReferenceValue resource type ++Namespace: microsoft.graph.industryData +++A reference value for a role in a section. ++Inherits from [microsoft.graph.industryData.referenceValue](../resources/industrydata-referencevalue.md). ++## Properties ++| Property | Type | Description | +| :- | :-- | : | +| code | String | Inherited from [microsoft.graph.industryData.referenceValue](../resources/industrydata-referencevalue.md). | ++## Relationships ++| Relationship | Type | Description | +| :-- | :- | :-- | +| value | [microsoft.graph.industryData.referenceDefinition](../resources/industrydata-referencedefinition.md) | Inherited from [microsoft.graph.industryData.referenceValue](../resources/industrydata-referencevalue.md). | ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.industryData.sectionRoleReferenceValue" +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.industryData.sectionRoleReferenceValue", + "code": "String" +} +``` |
v1.0 | Industrydata Securitygroupcreationoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/industrydata-securitygroupcreationoptions.md | + + Title: "securityGroupCreationOptions resource type" +description: "The different options for the security groups to be provisioned." ++ms.localizationpriority: medium ++++# securityGroupCreationOptions resource type ++Namespace: microsoft.graph.industryData +++The different options for the security groups to be provisioned. ++## Properties ++| Property | Type | Description | +| :- | : | :-- | +| createBasedOnOrgPlusRoleGroup | Boolean | Indicates whether the security group should be created based on the org and role group. | +| createBasedOnRoleGroup | Boolean | A boolean choice indicating whether the security group should be created based on the role group | ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.industryData.securityGroupCreationOptions" +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.industryData.securityGroupCreationOptions", + "createBasedOnRoleGroup": "Boolean", + "createBasedOnOrgPlusRoleGroup": "Boolean" +} +``` |
v1.0 | Industrydata Securitygroupprovisioningflow | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/industrydata-securitygroupprovisioningflow.md | + + Title: "securityGroupProvisioningFlow resource type" +description: "Represents the parameters that school data sync uses to create security groups and teams in Microsoft 365 from your inbound data." ++ms.localizationpriority: medium ++++# securityGroupProvisioningFlow resource type ++Namespace: microsoft.graph.industryData +++Represents the parameters that school data sync uses to create security groups and teams in Microsoft 365 from your inbound data. Security groups provide a grouping construct for use within various identity management, application management, and device management scenarios in Microsoft 365. ++securityGroupProvisioningFlow is defined within an [outboundProvisioningFlowSet](industrydata-outboundprovisioningflowset.md) that may specify a filter based on a subset of available organizations (schools) or may include all of the organizations in the inbound data. ++There may be multiple securityGroupProvisioningFlows, defined within separate outboundProvsioningFlowSets allowing different configurations for different organizations. ++Inherits from [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md). ++## Methods ++| Method | Return type | Description | +| : | :- | :-- | +| [Get securityGroupProvisioningFlow](../api/industrydata-securitygroupprovisioningflow-get.md) | [microsoft.graph.industryData.securityGroupProvisioningFlow](industrydata-securitygroupprovisioningflow.md) | Read the properties and relationships of a securitygroupprovisioningflow object. | +| [Update securityGroupProvisioningFlow](../api/industrydata-securitygroupprovisioningflow-update.md) | [microsoft.graph.industryData.securityGroupProvisioningFlow](industrydata-securitygroupprovisioningflow.md) | Update the properties of a securitygroupprovisioningflow object. | +| [Delete securityGroupProvisioningFlow](../api/industrydata-securitygroupprovisioningflow-delete.md) | None | Delete a securitygroupprovisioningflow object. | ++## Properties ++| Property | Type | Description | +| :- | : | : | +| createdDateTime | DateTimeOffset | Inherited from [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md). | +| creationOptions | [microsoft.graph.industryData.securityGroupCreationOptions](industrydata-securitygroupcreationoptions.md) | The different attribute choices for the class groups to be provisioned. | +| id | String | Inherited from [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md). | +| lastModifiedDateTime | DateTimeOffset | Inherited from [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md). | +| readinessStatus | microsoft.graph.industryData.readinessStatus | Inherited from [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md). The possible values are: `notReady`, `ready`, `failed`, `disabled`, `expired`, `unknownFutureValue`. | ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.industryData.securityGroupProvisioningFlow", + "baseType": "microsoft.graph.industryData.provisioningFlow", + "openType": false +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.industryData.securityGroupProvisioningFlow", + "createdDateTime": "String (timestamp)", + "lastModifiedDateTime": "String (timestamp)", + "readinessStatus": "String", + "id": "String (identifier)", + "creationOptions": { + "@odata.type": "microsoft.graph.industryData.securityGroupCreationOptions" + } +} +``` |
v1.0 | Industrydata Simplepasswordsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/industrydata-simplepasswordsettings.md | + + Title: "simplePasswordSettings resource type" +description: "The password settings for the users to be provisioned" ++ms.localizationpriority: medium ++++# simplePasswordSettings resource type ++Namespace: microsoft.graph.industryData +++The password settings for the users to be provisioned. ++Inherits from [microsoft.graph.industryData.passwordSettings](../resources/industrydata-passwordsettings.md). ++## Properties ++| Property | Type | Description | +| :- | :-- | : | +| password | String | The password for the user. | ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.industryData.simplePasswordSettings" +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.industryData.simplePasswordSettings", + "password": "String" +} +``` |
v1.0 | Industrydata Userconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/industrydata-userconfiguration.md | + + Title: "userConfiguration resource type" +description: "The different configurations choices for the users to be provisioned with." ++ms.localizationpriority: medium ++++# userConfiguration resource type ++Namespace: microsoft.graph.industryData +++The different configurations choices for the users to be provisioned with. ++## Properties ++| Property | Type | Description | +| :- | : | : | +| defaultPasswordSettings | [microsoft.graph.industryData.passwordSettings](../resources/industrydata-passwordsettings.md) | The password settings for the users to be provisioned with. | +| licenseSkus | String collection | The license skus for the users to be provisioned with. | ++## Relationships ++| Relationship | Type | Description | +| :-- | :-- | :-- | +| roleGroup | [microsoft.graph.industryData.roleGroup](../resources/industrydata-rolegroup.md) | The role for the users to be provisioned with. | ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.industryData.userConfiguration" +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.industryData.userConfiguration", + "defaultPasswordSettings": { + "@odata.type": "microsoft.graph.industryData.passwordSettings" + }, + "licenseSkus": ["String"] +} +``` |
v1.0 | Industrydata Usercreationoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/industrydata-usercreationoptions.md | + + Title: "userCreationOptions resource type" +description: "The different management choices for the users to be provisioned" ++ms.localizationpriority: medium ++++# userCreationOptions resource type ++Namespace: microsoft.graph.industryData +++The different management choices for the users to be provisioned. ++## Properties ++| Property | Type | Description | +| :- | :- | : | +| configurations | [microsoft.graph.industryData.userConfiguration](../resources/industrydata-userconfiguration.md) collection | The different management choices for the users to be provisioned. | ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.industryData.userCreationOptions" +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.industryData.userCreationOptions", + "configurations": [ + { + "@odata.type": "microsoft.graph.industryData.userConfiguration" + } + ] +} +``` |
v1.0 | Industrydata Usermanagementoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/industrydata-usermanagementoptions.md | + + Title: "userManagementOptions resource type" +description: "The different configurations choices for the users to be provisioned." ++ms.localizationpriority: medium ++++# userManagementOptions resource type ++Namespace: microsoft.graph.industryData +++The different configurations choices for the users to be provisioned. ++## Properties ++| Property | Type | Description | +| :- | :- | : | +| additionalAttributes | microsoft.graph.industryData.additionalUserAttributes collection | The different attribute choices for the users to be provisioned. The possible values are: `userGradeLevel`, `userNumber`, `unknownFutureValue`. | +| additionalOptions | [microsoft.graph.industryData.additionalUserOptions](../resources/industrydata-additionaluseroptions.md) | The different management choices for the users to be provisioned. | ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.industryData.userManagementOptions" +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.industryData.userManagementOptions", + "additionalAttributes": ["String"], + "additionalOptions": { + "@odata.type": "microsoft.graph.industryData.additionalUserOptions" + } +} +``` |
v1.0 | Industrydata Userprovisioningflow | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/industrydata-userprovisioningflow.md | + + Title: "userProvisioningFlow resource type" +description: "Represents the configuration parameters that allow you to automate creation and matching to Microsoft 365 users from your inbound data." ++ms.localizationpriority: medium ++++# userProvisioningFlow resource type ++Namespace: microsoft.graph.industryData +++Represents the configuration parameters that allow you to automate creation and matching to Microsoft 365 users from your inbound data. ++userProvisioningFlow is defined within an [outboundProvisioningFlowSet](industrydata-outboundprovisioningflowset.md) that may specify a filter based on a subset of available organizations (schools) or may include all of the organizations in the inbound data. ++There may be multiple userProvisioningFlows, defined within separate outboundProvsioningFlowSets allowing different configurations for different organizations. ++Inherits from [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md). ++## Methods ++| Method | Return type | Description | +| : | :- | :-- | +| [Get userProvisioningFlow](../api/industrydata-userprovisioningflow-get.md) | [microsoft.graph.industryData.userProvisioningFlow](industrydata-userprovisioningflow.md) | Read the properties and relationships of a userprovisioningflow object. | +| [Update userProvisioningFlow](../api/industrydata-userprovisioningflow-update.md) | [microsoft.graph.industryData.userProvisioningFlow](industrydata-userprovisioningflow.md) | Update the properties of a userprovisioningflow object. | +| [Delete userProvisioningFlow](../api/industrydata-userprovisioningflow-delete.md) | None | Delete a userprovisioningflow object. | ++## Properties ++| Property | Type | Description | +| :- | :- | : | +| createdDateTime | DateTimeOffset | Inherited from [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md). | +| createUnmatchedUsers | Boolean | A boolean choice indicating whether unmatched users should be created or ignored. | +| creationOptions | [microsoft.graph.industryData.userCreationOptions](industrydata-usercreationoptions.md) | The different management choices for the new users to be provisioned. | +| id | String | Inherited from [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md). | +| lastModifiedDateTime | DateTimeOffset | Inherited from [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md). | +| managementOptions | [microsoft.graph.industryData.userManagementOptions](industrydata-usermanagementoptions.md) | The different attribute choices for all the users to be considered. | +| readinessStatus | microsoft.graph.industryData.readinessStatus | Inherited from [microsoft.graph.industryData.provisioningFlow](industrydata-provisioningflow.md). The possible values are: `notReady`, `ready`, `failed`, `disabled`, `expired`, `unknownFutureValue`. | ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.industryData.userProvisioningFlow", + "baseType": "microsoft.graph.industryData.provisioningFlow", + "openType": false +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.industryData.userProvisioningFlow", + "createdDateTime": "String (timestamp)", + "lastModifiedDateTime": "String (timestamp)", + "readinessStatus": "String", + "id": "String (identifier)", + "createUnmatchedUsers": "Boolean", + "managementOptions": { + "@odata.type": "microsoft.graph.industryData.userManagementOptions" + }, + "creationOptions": { + "@odata.type": "microsoft.graph.industryData.userCreationOptions" + } +} +``` |
v1.0 | Inferenceclassification | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/inferenceclassification.md | For more information, see [Manage Focused Inbox](manage-focused-inbox.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Inferenceclassificationoverride | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/inferenceclassificationoverride.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Informationalurl | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/informationalurl.md | Basic profile information of the application. |termsOfServiceUrl|String| Link to the application's terms of service statement. For example, https://www.contoso.com/app/termsofservice | ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Insights Insightidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/insights-insightidentity.md | Namespace: microsoft.graph Complex type containing properties of [sharedInsight](insights-shared.md) items. ## JSON representation-Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Insights Resourcereference | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/insights-resourcereference.md | Complex type containing properties of [itemInsights](iteminsights.md) ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "optionalProperties": [ |
v1.0 | Insights Sharingdetail | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/insights-sharingdetail.md | Namespace: microsoft.graph Complex type containing properties of [sharedInsight](insights-shared.md) items. ## JSON representation-Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "optionalProperties": [ |
v1.0 | Insights Used | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/insights-used.md | An insight representing documents used by a specific user. The insights return t | resource | [entity](entity.md) collection | Used for navigating to the item that was used. For file attachments, the type is *fileAttachment*. For linked attachments, the type is *driveItem*. | ## JSON representation-Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Insightssettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/insightssettings.md | doc_type: resourcePageType [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents _settings_ to calculate and manage the display or programmatic return of a specific type of insights in an organization. The insights can be contact insights, item insights, meeting hours insights, or people insights. +Represents settings to calculate and manage the display or programmatic return of a specific type of insights in an organization. The insights can be contact insights, item insights, meeting hours insights, or people insights. Contact insights represent intelligent suggestions to organize user contacts in Microsoft 365. Programmatically, user contacts are represented by the [contact](contact.md) resource. An example of a contact insight is merge suggestions for duplicate contacts, available for end users in Outlook. Item insights and [meeting hours insights](https://support.microsoft.com/office/ People insights represent connections of people who are relevant to or work with one another based on their public relationships. Programmatically, individual people are represented by the [person](person.md) resource. You can [use the people API to get people insights](/graph/people-insights-overview). You can use **insightsSettings** to [customize the privacy settings for displaying or returning people insights](/graph/insights-customize-people-insights-privacy). -In contrast, for item insights and [meeting hours insights](https://support.microsoft.com/office/update-your-meeting-hours-using-the-profile-card-0613d113-d7c1-4faa-bb11-c8ba30a78ef1), you can also manage their calculation and visibility at a _user_ level by using the [userInsightsSettings](userinsightssettings.md) resource. +In contrast, for item insights and [meeting hours insights](https://support.microsoft.com/office/update-your-meeting-hours-using-the-profile-card-0613d113-d7c1-4faa-bb11-c8ba30a78ef1), you can also manage their calculation and visibility at a user level by using the [userInsightsSettings](userinsightssettings.md) resource. ## Methods | Method | Return Type | Description | |:-|:|:|-| [List contactInsights](../api/organizationsettings-list-contactinsights.md) | [insightsSettings](insightssettings.md) | Get the _settings_ in an [insightsSettings](insightssettings.md) object for displaying contact insights in an organization. | -| [List itemInsights](../api/organizationsettings-list-iteminsights.md) | [insightsSettings](insightssettings.md) | Get the _settings_ in an [insightsSettings](insightssettings.md) object for displaying item insights in an organization. | -| [List peopleInsights](../api/organizationsettings-list-peopleinsights.md) | [insightsSettings](insightssettings.md) | Get the _settings_ in an [insightsSettings](insightssettings.md) object for displaying people insights in an organization. | +| [List contactInsights](../api/organizationsettings-list-contactinsights.md) | [insightsSettings](insightssettings.md) | Get the properties of the [insightsSettings](insightssettings.md) resource for displaying contact insights in an organization. | +| [List itemInsights](../api/peopleadminsettings-list-iteminsights.md) | [insightsSettings](insightssettings.md) | Get the properties of the [insightsSettings](insightssettings.md) resource for displaying item insights in an organization. | +| [List peopleInsights](../api/organizationsettings-list-peopleinsights.md) | [insightsSettings](insightssettings.md) | Get the properties of the [insightsSettings](insightssettings.md) resource for displaying people insights in an organization. | | [Update insightsSettings](../api/insightssettings-update.md) | [insightsSettings](insightssettings.md) | Update the properties of an **insightsSettings** resource to manage the display or return of the specified type of insights, which can be contact insights, item insights, or people insights. | In contrast, for item insights and [meeting hours insights](https://support.micr | Property | Type|Description| |:|:--|:-|-|isEnabledInOrganization|Boolean| `true` if the specified type of insights is enabled for the organization; `false` if the specified type of insights is disabled for all users without exceptions. Default is `true`. Optional.| +|isEnabledInOrganization|Boolean| `true` if insights of the specified type are enabled for the organization; `false` if insights of the specified type are disabled for all users without exceptions. Default is `true`. Optional.| |disabledForGroup|String| The ID of a Microsoft Entra group, of which the specified type of insights are disabled for its members. Default is `empty`. Optional.| ## JSON representation |
v1.0 | Insightsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/insightsummary.md | Namespace: microsoft.graph Represents a daily or monthly summary of all usage insights on apps registered in your tenant that is configured for Microsoft Entra External ID for customers. A user (in **activeUsers**) can be counted more that once if they use multiple device platforms. This resource represents a summary of the insights. For a breakdown of each insight, see the following resources and their associated APIs:-- [activeUsersBreakdown](../resources/activeusersbreakdownmetric.md) - [activeUsers](../resources/activeusersmetric.md) - [authentications](../resources/authenticationsmetric.md) - [mfaCompletion](../resources/mfacompletionmetric.md) |
v1.0 | Internaldomainfederation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/internaldomainfederation.md | Title: "internalDomainFederation resource type" description: "Represents configurations of the domains in a tenant that are federated with Azure AD." ms.localizationpriority: medium-+ doc_type: resourcePageType Inherits from [samlOrWsFedProvider](../resources/samlorwsfedprovider.md). |signingCertificateUpdateStatus|[signingCertificateUpdateStatus](../resources/signingcertificateupdatestatus.md)|Provides status and timestamp of the last update of the signing certificate.| |signOutUri|String|URI that clients are redirected to when they sign out of Microsoft Entra services. Corresponds to the **LogOffUri** property of the [Set-MsolDomainFederationSettings MSOnline v1 PowerShell cmdlet](/powershell/module/msonline/set-msoldomainfederationsettings).| + ### federatedIdpMfaBehavior values | Member | Description | Inherits from [samlOrWsFedProvider](../resources/samlorwsfedprovider.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", Here's a JSON representation of the resource. "federatedIdpMfaBehavior": "String" } ```++<!-- +{ + "type": "#page.annotation", + "description": "", + "keywords": "", + "section": "documentation", + "tocPath": "", + "suppressions": [ + "Error: /resources/internaldomainfederation.md: + Exception processing links. + Link Definition was null. Link text: !INCLUDE Azure AD PowerShell deprecation note (Parameter 'Definition')" + ] +} +--> |
v1.0 | Internetmessageheader | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/internetmessageheader.md | For examples of an Internet message header, see ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Intune Androidforwork Androiddeviceownerenrollmentmode | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidforwork-androiddeviceownerenrollmentmode.md | The enrollment mode for an enrollment profile. |corporateOwnedFullyManaged|1|| |corporateOwnedWorkProfile|2|| |corporateOwnedAOSPUserlessDevice|3|Corporate owned, userless Android Open Source Project (AOSP) device, without Google Mobile Services.|-|corporateOwnedAOSPUserAssociatedDevice|4|Corporate owned, user-associated Android Open Source Project (AOSP) device, without Google Mobile Services.| +|corporateOwnedAOSPUserAssociatedDevice|4|Corporate owned, user-associated Android Open Source Project (AOSP) device, without Google Mobile Services.| |
v1.0 | Intune Androidforwork Androiddeviceownerenrollmentprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidforwork-androiddeviceownerenrollmentprofile.md | Here is a JSON representation of the resource. "wifiHidden": true, "isTeamsDeviceProfile": true }-``` +``` |
v1.0 | Intune Androidforwork Androiddeviceownerenrollmenttokentype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidforwork-androiddeviceownerenrollmenttokentype.md | The enrollment token type for an enrollment profile. |:|:|:| |default|0|Default token type.| |corporateOwnedDedicatedDeviceWithAzureADSharedMode|1|Token type for Azure AD shared dedicated device enrollment. It applies to CorporateOwnedDedicatedDevice enrollment mode only.|-|deviceStaging|2|Token type for Android Device Staging enrollment type. It applies to CorporateOwnedFullyManaged and CorporateOwnedWorkProfile only.| +|deviceStaging|2|Token type for Android Device Staging enrollment type. It applies to CorporateOwnedFullyManaged and CorporateOwnedWorkProfile only.| |
v1.0 | Intune Androidforwork Androidenrollmentcompanycode | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidforwork-androidenrollmentcompanycode.md | Here is a JSON representation of the resource. "value": "binary" } }-``` +``` |
v1.0 | Intune Androidforwork Androidforworkappconfigurationschema | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidforwork-androidforworkappconfigurationschema.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Androidforwork Androidforworkappconfigurationschemaitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidforwork-androidforworkappconfigurationschemaitem.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Androidforwork Androidforworkappconfigurationschemaitemdatatype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidforwork-androidforworkappconfigurationschemaitemdatatype.md | Data type for a configuration item inside an Android for Work application's cust |multiselect|4|| |bundle|5|| |bundleArray|6||-|hidden|7|| +|hidden|7|| |
v1.0 | Intune Androidforwork Androidforworkbindstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidforwork-androidforworkbindstatus.md | Bind status of the tenant with the Google EMM API |notBound|0|| |bound|1|| |boundAndValidated|2||-|unbinding|3|| +|unbinding|3|| |
v1.0 | Intune Androidforwork Androidforworkenrollmentprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidforwork-androidforworkenrollmentprofile.md | Here is a JSON representation of the resource. "value": "binary" } }-``` +``` |
v1.0 | Intune Androidforwork Androidforworkenrollmenttarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidforwork-androidforworkenrollmenttarget.md | Android for Work device management targeting type for the account |none|0|| |all|1|| |targeted|2||-|targetedAsEnrollmentRestrictions|3|| +|targetedAsEnrollmentRestrictions|3|| |
v1.0 | Intune Androidforwork Androidforworksettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidforwork-androidforworksettings.md | Here is a JSON representation of the resource. ], "deviceOwnerManagementEnabled": true }-``` +``` |
v1.0 | Intune Androidforwork Androidforworksyncstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidforwork-androidforworksyncstatus.md | Sync status of the tenant with the Google EMM API |androidForWorkApiError|2|| |managementServiceError|3|| |unknownError|4||-|none|5|| +|none|5|| |
v1.0 | Intune Androidforwork Androidmanagedstoreaccountappsyncstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidforwork-androidmanagedstoreaccountappsyncstatus.md | Sync status of the tenant with the Google EMM API |androidForWorkApiError|2|| |managementServiceError|3|| |unknownError|4||-|none|5|| +|none|5|| |
v1.0 | Intune Androidforwork Androidmanagedstoreaccountbindstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidforwork-androidmanagedstoreaccountbindstatus.md | Bind status of the tenant with the Google EMM API |notBound|0|| |bound|1|| |boundAndValidated|2||-|unbinding|3|| +|unbinding|3|| |
v1.0 | Intune Androidforwork Androidmanagedstoreaccountenrollmenttarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidforwork-androidmanagedstoreaccountenrollmenttarget.md | Android for Work device management targeting type for the account |none|0|| |all|1|| |targeted|2||-|targetedAsEnrollmentRestrictions|3|| +|targetedAsEnrollmentRestrictions|3|| |
v1.0 | Intune Androidforwork Androidmanagedstoreaccountenterprisesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidforwork-androidmanagedstoreaccountenterprisesettings.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Androidforwork Androidmanagedstoreappconfigurationschema | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidforwork-androidmanagedstoreappconfigurationschema.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Androidforwork Androidmanagedstoreappconfigurationschemaitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidforwork-androidmanagedstoreappconfigurationschemaitem.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Androidforwork Androidmanagedstoreappconfigurationschemaitemdatatype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidforwork-androidmanagedstoreappconfigurationschemaitemdatatype.md | Data type for a configuration item inside an Android application's custom config |multiselect|4|| |bundle|5|| |bundleArray|6||-|hidden|7|| +|hidden|7|| |
v1.0 | Intune Androidforwork Aospwifisecuritytype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidforwork-aospwifisecuritytype.md | This enum represents Wi-Fi Security Types for Android Device Owner AOSP Scenario |:|:|:| |none|0|No security type.| |wpa|1|WPA-Pre-shared-key|-|wep|2|WEP-Pre-shared-key| +|wep|2|WEP-Pre-shared-key| |
v1.0 | Intune Androidforwork Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidforwork-devicemanagement.md | Singleton entity that acts as a container for Android for Work settings function ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-androidforwork-devicemanagement-get.md)|[deviceManagement](../resources/intune-androidforwork-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-androidforwork-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-androidforwork-devicemanagement-update.md)|[deviceManagement](../resources/intune-androidforwork-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-androidforwork-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-androidforwork-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-androidforwork-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Androidforwork Keyvaluepair | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidforwork-keyvaluepair.md | Here is a JSON representation of the resource. "name": "String", "value": "String" }-``` +``` |
v1.0 | Intune Androidfotaservice Androidfotadeploymentassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidfotaservice-androidfotadeploymentassignment.md | Here is a JSON representation of the resource. "groupId": "String" } }-``` +``` |
v1.0 | Intune Androidfotaservice Androidfotadeploymentassignmenttarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidfotaservice-androidfotadeploymentassignmenttarget.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.androidFotaDeploymentAssignmentTarget", "groupId": "String" }-``` +``` |
v1.0 | Intune Androidfotaservice Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidfotaservice-devicemanagement.md | Singleton that acts as container for a collection of Resource Access entities. ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-androidfotaservice-devicemanagement-get.md)|[deviceManagement](../resources/intune-androidfotaservice-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-androidfotaservice-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-androidfotaservice-devicemanagement-update.md)|[deviceManagement](../resources/intune-androidfotaservice-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-androidfotaservice-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-androidfotaservice-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-androidfotaservice-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.deviceManagement" }-``` +``` |
v1.0 | Intune Androidfotaservice Devicemanagementreports | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidfotaservice-devicemanagementreports.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.deviceManagementReports" }-``` +``` |
v1.0 | Intune Androidfotaservice Zebrafotaartifact | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidfotaservice-zebrafotaartifact.md | Here is a JSON representation of the resource. "releaseNotesUrl": "String", "description": "String" }-``` +``` |
v1.0 | Intune Androidfotaservice Zebrafotaconnector | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidfotaservice-zebrafotaconnector.md | Here is a JSON representation of the resource. "lastSyncDateTime": "String (timestamp)", "fotaAppsApproved": true }-``` +``` |
v1.0 | Intune Androidfotaservice Zebrafotaconnectorstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidfotaservice-zebrafotaconnectorstate.md | Represents various states for Zebra FOTA connector. |none|0|Default value when the connector has not been setup (the feature has not been used yet).| |connected|1|Connected state indicates that Intune is linked to Zebra Update Services for the current tenant.| |disconnected|2|Disconnected state indicates that the account was connected in the past and later disconnected.|-|unknownFutureValue|99|Unknown future enum value.| +|unknownFutureValue|99|Unknown future enum value.| |
v1.0 | Intune Androidfotaservice Zebrafotadeployment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidfotaservice-zebrafotadeployment.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Androidfotaservice Zebrafotadeploymentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidfotaservice-zebrafotadeploymentsettings.md | Here is a JSON representation of the resource. "batteryRuleMinimumBatteryLevelPercentage": 1024, "batteryRuleRequireCharger": true }-``` +``` |
v1.0 | Intune Androidfotaservice Zebrafotadeploymentstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidfotaservice-zebrafotadeploymentstate.md | Represents the state of Zebra FOTA deployment. |completed|4|Deployment has completed or end date has passed.| |pendingCancel|5|Admin has requested to cancel a deployment but Zebra has not confirmed cancellation.| |canceled|6|Deployment has been successfully canceled by Zebra.|-|unknownFutureValue|99|Unknown future enum value.| +|unknownFutureValue|99|Unknown future enum value.| |
v1.0 | Intune Androidfotaservice Zebrafotadeploymentstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidfotaservice-zebrafotadeploymentstatus.md | Here is a JSON representation of the resource. "cancelRequested": true, "lastUpdatedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Androidfotaservice Zebrafotaerrorcode | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidfotaservice-zebrafotaerrorcode.md | An error code indicating the failure reason, when the deployment state is create |noZebraFotaEnrolledDevicesFoundInSelectedAadGroups|4|This error indicates that no Zebra FOTA enrolled devices were found in the selected Azure Active Directory (AAD) Groups when creating a deployment. E.g.: a user has enrolled one or more devices in Zebra FOTA, but attempts to create a deployment targeting security groups that don't include any Zebra Devices.| |noZebraFotaDevicesFoundForSelectedDeviceModel|5|This error indicates that no Zebra FOTA devices were found that match the selected device model when creating a deployment. E.g.: a user selects `TC8300` device model, but no Zebra devices with the same device model were found in the targeted Azure Active Directory (AAD) security groups.| |zebraFotaCreateDeploymentRequestFailure|6|This error indicates that an external request to Zebra APIs failed when creating a deployment. The failure can be caused by a transient issue (e.g.: Network is down) or caused by a permanent server error.|-|unknownFutureValue|7|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|7|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Androidfotaservice Zebrafotanetworktype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidfotaservice-zebrafotanetworktype.md | Represents various network types for Zebra FOTA deployment. |wifi|1|The device will install the update only when connected to WiFi network.| |cellular|2|The device will install the update only when connected a Cellular network.| |wifiAndCellular|3|The device will install the update when connected both WiFi and Cellular.|-|unknownFutureValue|99|Unknown future enum value.| +|unknownFutureValue|99|Unknown future enum value.| |
v1.0 | Intune Androidfotaservice Zebrafotaschedulemode | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidfotaservice-zebrafotaschedulemode.md | Represents various schedule modes for Zebra FOTA deployment. |:|:|:| |installNow|0|Instructs the device to install the update as soon as it is received.| |scheduled|1|Schedule an update to be installed at a specified date and time.|-|unknownFutureValue|99|Unknown future enum value.| +|unknownFutureValue|99|Unknown future enum value.| |
v1.0 | Intune Androidfotaservice Zebrafotaupdatetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-androidfotaservice-zebrafotaupdatetype.md | Represents various update types for Zebra FOTA deployment. |custom|0|Custom update where the user selects specific BSP, OS version, and patch number to update to.| |latest|1|The latest released update becomes the target OS. Latest may update the device to a new Android version.| |auto|2|The device always looks for the latest package available in the repo and tries to update whenever a new package is available. This continues until the admin cancels the auto update.|-|unknownFutureValue|99|Unknown future enum value.| +|unknownFutureValue|99|Unknown future enum value.| |
v1.0 | Intune App Conceptual | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-app-conceptual.md | Microsoft Intune app protection policies help protect your company data and prev You can use Intune app protection policies to help protect your companyΓÇÖs data. Because Intune app protection policies can be used independent of any mobile-device management (MDM) solution, you can use it to protect your companyΓÇÖs data with or without enrolling devices in a device management solution. By implementing app-level policies, you can restrict access to company resources and keep data within the purview of your IT department. -Use Graph resources to manage app protection polices in Intune. See the table of content for a list of resources. +Use Graph resources to manage app protection polices in Intune. See the table of content for a list of resources. |
v1.0 | Intune Apps Androidforworkapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-androidforworkapp.md | Here is a JSON representation of the resource. "totalLicenseCount": 1024, "appStoreUrl": "String" }-``` +``` |
v1.0 | Intune Apps Androidforworkmobileappconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-androidforworkmobileappconfiguration.md | Here is a JSON representation of the resource. "profileApplicability": "String", "connectedAppsEnabled": true }-``` +``` |
v1.0 | Intune Apps Androidlobapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-androidlobapp.md | Here is a JSON representation of the resource. "versionCode": "String", "targetedPlatforms": "String" }-``` +``` |
v1.0 | Intune Apps Androidmanagedstoreapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-androidmanagedstoreapp.md | Here is a JSON representation of the resource. ], "supportsOemConfig": true }-``` +``` |
v1.0 | Intune Apps Androidmanagedstoreappconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-androidmanagedstoreappconfiguration.md | Here is a JSON representation of the resource. "profileApplicability": "String", "connectedAppsEnabled": true }-``` +``` |
v1.0 | Intune Apps Androidmanagedstoreapptrack | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-androidmanagedstoreapptrack.md | Here is a JSON representation of the resource. "trackId": "String", "trackAlias": "String" }-``` +``` |
v1.0 | Intune Apps Androidmanagedstorewebapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-androidmanagedstorewebapp.md | Here is a JSON representation of the resource. ], "supportsOemConfig": true }-``` +``` |
v1.0 | Intune Apps Androidminimumoperatingsystem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-androidminimumoperatingsystem.md | Here is a JSON representation of the resource. "v10_0": true, "v11_0": true }-``` +``` |
v1.0 | Intune Apps Androidpermissionaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-androidpermissionaction.md | Here is a JSON representation of the resource. "permission": "String", "action": "String" }-``` +``` |
v1.0 | Intune Apps Androidpermissionactiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-androidpermissionactiontype.md | Android action taken when an app requests a dangerous permission. |:|:|:| |prompt|0|| |autoGrant|1||-|autoDeny|2|| +|autoDeny|2|| |
v1.0 | Intune Apps Androidprofileapplicability | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-androidprofileapplicability.md | Android profile applicability |:|:|:| |default|0|| |androidWorkProfile|1||-|androidDeviceOwner|2|| +|androidDeviceOwner|2|| |
v1.0 | Intune Apps Androidstoreapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-androidstoreapp.md | Here is a JSON representation of the resource. "v11_0": true } }-``` +``` |
v1.0 | Intune Apps Androidtargetedplatforms | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-androidtargetedplatforms.md | Specifies which platform(s) can be targeted for a given Android LOB application |:|:|:| |androidDeviceAdministrator|1|Indicates the Android targeted platform is Android Device Administrator.| |androidOpenSourceProject|2|Indicates the Android targeted platform is Android Open Source Project.|-|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Apps Appconfigurationsettingitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-appconfigurationsettingitem.md | Here is a JSON representation of the resource. "appConfigKeyType": "String", "appConfigKeyValue": "String" }-``` +``` |
v1.0 | Intune Apps Certificatestatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-certificatestatus.md | Namespace: microsoft.graph |Member|Value|Description| |:|:|:| |notProvisioned|0||-|provisioned|1|| +|provisioned|1|| |
v1.0 | Intune Apps Deviceappmanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-deviceappmanagement.md | + + Title: "deviceAppManagement resource type" +description: "Singleton entity that acts as a container for all device app management functionality." ++localization_priority: Normal ++++# deviceAppManagement resource type ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. ++Singleton entity that acts as a container for all device app management functionality. ++## Methods +|Method|Return Type|Description| +|:|:|:| +|[Get deviceAppManagement](../api/intune-apps-deviceappmanagement-get.md)|[deviceAppManagement](../resources/intune-shared-deviceappmanagement.md)|Read properties and relationships of the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object.| +|[Update deviceAppManagement](../api/intune-apps-deviceappmanagement-update.md)|[deviceAppManagement](../resources/intune-shared-deviceappmanagement.md)|Update the properties of a [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object.| ++## Properties +|Property|Type|Description| +|:|:|:| +|id|String|Key of the entity.| ++## Relationships +|Relationship|Type|Description| +|:|:|:| +|mobileApps|[mobileApp](../resources/intune-shared-mobileapp.md) collection|The mobile apps.| +|mobileAppCategories|[mobileAppCategory](../resources/intune-apps-mobileappcategory.md) collection|The mobile app categories.| +|enterpriseCodeSigningCertificates|[enterpriseCodeSigningCertificate](../resources/intune-apps-enterprisecodesigningcertificate.md) collection|The Windows Enterprise Code Signing Certificate.| +|iosLobAppProvisioningConfigurations|[iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) collection|The IOS Lob App Provisioning Configurations.| +|symantecCodeSigningCertificate|[symantecCodeSigningCertificate](../resources/intune-apps-symanteccodesigningcertificate.md)|The WinPhone Symantec Code Signing Certificate.| +|mobileAppConfigurations|[managedDeviceMobileAppConfiguration](../resources/intune-apps-manageddevicemobileappconfiguration.md) collection|The Managed Device Mobile Application Configurations.| ++## JSON Representation +Here is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.deviceAppManagement" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.deviceAppManagement", + "id": "String (identifier)" +} +``` |
v1.0 | Intune Apps Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-devicemanagement.md | Singleton entity that acts as a container for all device management functionalit ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-apps-devicemanagement-get.md)|[deviceManagement](../resources/intune-apps-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-apps-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-apps-devicemanagement-update.md)|[deviceManagement](../resources/intune-apps-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-apps-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-apps-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-apps-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Apps Enterprisecodesigningcertificate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-enterprisecodesigningcertificate.md | Here is a JSON representation of the resource. "expirationDateTime": "String (timestamp)", "uploadDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Apps Excludedapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-excludedapps.md | Here is a JSON representation of the resource. "visio": true, "word": true }-``` +``` |
v1.0 | Intune Apps Fileencryptioninfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-fileencryptioninfo.md | Here is a JSON representation of the resource. "fileDigest": "binary", "fileDigestAlgorithm": "String" }-``` +``` |
v1.0 | Intune Apps Iosdevicetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-iosdevicetype.md | Here is a JSON representation of the resource. "iPad": true, "iPhoneAndIPod": true }-``` +``` |
v1.0 | Intune Apps Iosipadoswebclip | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-iosipadoswebclip.md | Here is a JSON representation of the resource. "preComposedIconEnabled": true, "ignoreManifestScope": true }-``` +``` |
v1.0 | Intune Apps Ioslobapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-ioslobapp.md | Here is a JSON representation of the resource. "versionNumber": "String", "buildNumber": "String" }-``` +``` |
v1.0 | Intune Apps Ioslobappprovisioningconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-ioslobappprovisioningconfiguration.md | This topic provides descriptions of the declared methods, properties and relatio ## Methods |Method|Return Type|Description| |:|:|:|-|[List iosLobAppProvisioningConfigurations](../api/intune-apps-ioslobappprovisioningconfiguration-list.md)|[iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) collection|List properties and relationships of the [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) objects.| -|[Get iosLobAppProvisioningConfiguration](../api/intune-apps-ioslobappprovisioningconfiguration-get.md)|[iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md)|Read properties and relationships of the [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) object.| -|[Create iosLobAppProvisioningConfiguration](../api/intune-apps-ioslobappprovisioningconfiguration-create.md)|[iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md)|Create a new [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) object.| -|[Delete iosLobAppProvisioningConfiguration](../api/intune-apps-ioslobappprovisioningconfiguration-delete.md)|None|Deletes a [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md).| -|[Update iosLobAppProvisioningConfiguration](../api/intune-apps-ioslobappprovisioningconfiguration-update.md)|[iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md)|Update the properties of a [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) object.| +|[List iosLobAppProvisioningConfigurations](../api/intune-apps-ioslobappprovisioningconfiguration-list.md)|[iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) collection|List properties and relationships of the [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) objects.| +|[Get iosLobAppProvisioningConfiguration](../api/intune-apps-ioslobappprovisioningconfiguration-get.md)|[iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md)|Read properties and relationships of the [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) object.| +|[Create iosLobAppProvisioningConfiguration](../api/intune-apps-ioslobappprovisioningconfiguration-create.md)|[iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md)|Create a new [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) object.| +|[Delete iosLobAppProvisioningConfiguration](../api/intune-apps-ioslobappprovisioningconfiguration-delete.md)|None|Deletes a [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md).| +|[Update iosLobAppProvisioningConfiguration](../api/intune-apps-ioslobappprovisioningconfiguration-update.md)|[iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md)|Update the properties of a [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) object.| |[assign action](../api/intune-apps-ioslobappprovisioningconfiguration-assign.md)|None|| ## Properties Here is a JSON representation of the resource. "displayName": "String", "version": 1024 }-``` +``` |
v1.0 | Intune Apps Ioslobappprovisioningconfigurationassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-ioslobappprovisioningconfigurationassignment.md | Here is a JSON representation of the resource. "deviceAndAppManagementAssignmentFilterType": "String" } }-``` +``` |
v1.0 | Intune Apps Iosminimumoperatingsystem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-iosminimumoperatingsystem.md | Here is a JSON representation of the resource. "v16_0": true, "v17_0": true }-``` +``` |
v1.0 | Intune Apps Iosmobileappconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-iosmobileappconfiguration.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Apps Iosstoreapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-iosstoreapp.md | Here is a JSON representation of the resource. "v17_0": true } }-``` +``` |
v1.0 | Intune Apps Iosvppapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-iosvppapp.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Apps Iosvppappassigneddevicelicense | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-iosvppappassigneddevicelicense.md | Here is a JSON representation of the resource. "managedDeviceId": "String", "deviceName": "String" }-``` +``` |
v1.0 | Intune Apps Iosvppappassignedlicense | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-iosvppappassignedlicense.md | Here is a JSON representation of the resource. "userName": "String", "userPrincipalName": "String" }-``` +``` |
v1.0 | Intune Apps Iosvppappassigneduserlicense | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-iosvppappassigneduserlicense.md | Here is a JSON representation of the resource. "userName": "String", "userPrincipalName": "String" }-``` +``` |
v1.0 | Intune Apps Iosvppapprevokelicensesactionresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-iosvppapprevokelicensesactionresult.md | Here is a JSON representation of the resource. "startDateTime": "String (timestamp)", "lastUpdatedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Apps Macosappscript | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-macosappscript.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.macOSAppScript", "scriptContent": "String" }-``` +``` |
v1.0 | Intune Apps Macosdmgapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-macosdmgapp.md | Here is a JSON representation of the resource. "v14_0": true } }-``` +``` |
v1.0 | Intune Apps Macosincludedapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-macosincludedapp.md | Here is a JSON representation of the resource. "bundleId": "String", "bundleVersion": "String" }-``` +``` |
v1.0 | Intune Apps Macoslobapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-macoslobapp.md | Here is a JSON representation of the resource. "ignoreVersionDetection": true, "installAsManaged": true }-``` +``` |
v1.0 | Intune Apps Macoslobappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-macoslobappassignmentsettings.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.macOsLobAppAssignmentSettings", "uninstallOnDeviceRemoval": true }-``` +``` |
v1.0 | Intune Apps Macoslobchildapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-macoslobchildapp.md | Here is a JSON representation of the resource. "buildNumber": "String", "versionNumber": "String" }-``` +``` |
v1.0 | Intune Apps Macosmdatpapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-macosmdatpapp.md | Here is a JSON representation of the resource. "supersedingAppCount": 1024, "supersededAppCount": 1024 }-``` +``` |
v1.0 | Intune Apps Macosmicrosoftdefenderapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-macosmicrosoftdefenderapp.md | Here is a JSON representation of the resource. "supersedingAppCount": 1024, "supersededAppCount": 1024 }-``` +``` |
v1.0 | Intune Apps Macosmicrosoftedgeapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-macosmicrosoftedgeapp.md | Here is a JSON representation of the resource. "supersededAppCount": 1024, "channel": "String" }-``` +``` |
v1.0 | Intune Apps Macosminimumoperatingsystem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-macosminimumoperatingsystem.md | Here is a JSON representation of the resource. "v13_0": true, "v14_0": true }-``` +``` |
v1.0 | Intune Apps Macosofficesuiteapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-macosofficesuiteapp.md | Here is a JSON representation of the resource. "supersedingAppCount": 1024, "supersededAppCount": 1024 }-``` +``` |
v1.0 | Intune Apps Macospkgapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-macospkgapp.md | Here is a JSON representation of the resource. "scriptContent": "String" } }-``` +``` |
v1.0 | Intune Apps Macosvppapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-macosvppapp.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Apps Macosvppappassignedlicense | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-macosvppappassignedlicense.md | Here is a JSON representation of the resource. "userName": "String", "userPrincipalName": "String" }-``` +``` |
v1.0 | Intune Apps Macosvppappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-macosvppappassignmentsettings.md | Here is a JSON representation of the resource. "preventManagedAppBackup": true, "preventAutoAppUpdate": true }-``` +``` |
v1.0 | Intune Apps Macosvppapprevokelicensesactionresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-macosvppapprevokelicensesactionresult.md | Here is a JSON representation of the resource. "startDateTime": "String (timestamp)", "lastUpdatedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Apps Macoswebclip | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-macoswebclip.md | Here is a JSON representation of the resource. "fullScreenEnabled": true, "preComposedIconEnabled": true }-``` +``` |
v1.0 | Intune Apps Managedandroidlobapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-managedandroidlobapp.md | Here is a JSON representation of the resource. "versionCode": "String", "targetedPlatforms": "String" }-``` +``` |
v1.0 | Intune Apps Managedandroidstoreapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-managedandroidstoreapp.md | Here is a JSON representation of the resource. "v11_0": true } }-``` +``` |
v1.0 | Intune Apps Managedapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-managedapp.md | Here is a JSON representation of the resource. "appAvailability": "String", "version": "String" }-``` +``` |
v1.0 | Intune Apps Managedappavailability | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-managedappavailability.md | A managed (MAM) application's availability. |Member|Value|Description| |:|:|:| |global|0|A globally available app to all tenants.|-|lineOfBusiness|1|A line of business apps private to an organization.| +|lineOfBusiness|1|A line of business apps private to an organization.| |
v1.0 | Intune Apps Manageddevicemobileappconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-manageddevicemobileappconfiguration.md | Here is a JSON representation of the resource. "displayName": "String", "version": 1024 }-``` +``` |
v1.0 | Intune Apps Manageddevicemobileappconfigurationassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-manageddevicemobileappconfigurationassignment.md | Here is a JSON representation of the resource. "deviceAndAppManagementAssignmentFilterType": "String" } }-``` +``` |
v1.0 | Intune Apps Manageddevicemobileappconfigurationdevicestatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-manageddevicemobileappconfigurationdevicestatus.md | Here is a JSON representation of the resource. "lastReportedDateTime": "String (timestamp)", "userPrincipalName": "String" }-``` +``` |
v1.0 | Intune Apps Manageddevicemobileappconfigurationdevicesummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-manageddevicemobileappconfigurationdevicesummary.md | Here is a JSON representation of the resource. "lastUpdateDateTime": "String (timestamp)", "configurationVersion": 1024 }-``` +``` |
v1.0 | Intune Apps Manageddevicemobileappconfigurationuserstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-manageddevicemobileappconfigurationuserstatus.md | Here is a JSON representation of the resource. "lastReportedDateTime": "String (timestamp)", "userPrincipalName": "String" }-``` +``` |
v1.0 | Intune Apps Manageddevicemobileappconfigurationusersummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-manageddevicemobileappconfigurationusersummary.md | Here is a JSON representation of the resource. "lastUpdateDateTime": "String (timestamp)", "configurationVersion": 1024 }-``` +``` |
v1.0 | Intune Apps Managedioslobapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-managedioslobapp.md | Here is a JSON representation of the resource. "buildNumber": "String", "identityVersion": "String" }-``` +``` |
v1.0 | Intune Apps Managediosstoreapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-managediosstoreapp.md | Here is a JSON representation of the resource. "v17_0": true } }-``` +``` |
v1.0 | Intune Apps Managedmobilelobapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-managedmobilelobapp.md | Here is a JSON representation of the resource. "fileName": "String", "size": 1024 }-``` +``` |
v1.0 | Intune Apps Mdmappconfigkeytype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-mdmappconfigkeytype.md | App configuration key types. |integerType|1|| |realType|2|| |booleanType|3||-|tokenType|4|| +|tokenType|4|| |
v1.0 | Intune Apps Microsoftedgechannel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-microsoftedgechannel.md | The enum to specify the channels for Microsoft Edge apps. |dev|0|The Dev Channel is intended to help you plan and develop with the latest capabilities of Microsoft Edge.| |beta|1|The Beta Channel is intended for production deployment to a representative sample set of users. New features ship about every 4 weeks. Security and quality updates ship as needed.| |stable|2|The Stable Channel is intended for broad deployment within organizations, and it's the channel that most users should be on. New features ship about every 4 weeks. Security and quality updates ship as needed.|-|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Apps Microsoftstoreforbusinessapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-microsoftstoreforbusinessapp.md | Here is a JSON representation of the resource. "supportsDeviceLicensing": true } }-``` +``` |
v1.0 | Intune Apps Microsoftstoreforbusinesscontainedapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-microsoftstoreforbusinesscontainedapp.md | Here is a JSON representation of the resource. "id": "String (identifier)", "appUserModelId": "String" }-``` +``` |
v1.0 | Intune Apps Microsoftstoreforbusinesslicensetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-microsoftstoreforbusinesslicensetype.md | Namespace: microsoft.graph |Member|Value|Description| |:|:|:| |offline|0||-|online|1|| +|online|1|| |
v1.0 | Intune Apps Mobileapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-mobileapp.md | An abstract class containing the base properties for Intune mobile apps. Note: L ## Methods |Method|Return Type|Description| |:|:|:|-|[List mobileApps](../api/intune-apps-mobileapp-list.md)|[mobileApp](../resources/intune-apps-mobileapp.md) collection|List properties and relationships of the [mobileApp](../resources/intune-apps-mobileapp.md) objects.| -|[Get mobileApp](../api/intune-apps-mobileapp-get.md)|[mobileApp](../resources/intune-apps-mobileapp.md)|Read properties and relationships of the [mobileApp](../resources/intune-apps-mobileapp.md) object.| +|[List mobileApps](../api/intune-apps-mobileapp-list.md)|[mobileApp](../resources/intune-shared-mobileapp.md) collection|List properties and relationships of the [mobileApp](../resources/intune-shared-mobileapp.md) objects.| +|[Get mobileApp](../api/intune-apps-mobileapp-get.md)|[mobileApp](../resources/intune-shared-mobileapp.md)|Read properties and relationships of the [mobileApp](../resources/intune-shared-mobileapp.md) object.| |[assign action](../api/intune-apps-mobileapp-assign.md)|None|| |[validateXml action](../api/intune-apps-mobileapp-validatexml.md)|String||-|[convertMobileAppCatalogPackageToMobileApp function](../api/intune-apps-mobileapp-convertmobileappcatalogpackagetomobileapp.md)|[mobileApp](../resources/intune-apps-mobileapp.md)|| -|[createCatalogApp action](../api/intune-apps-mobileapp-createcatalogapp.md)|[mobileApp](../resources/intune-apps-mobileapp.md)|| -|[convertFromMobileAppCatalogPackage function](../api/intune-apps-mobileapp-convertfrommobileappcatalogpackage.md)|[mobileApp](../resources/intune-apps-mobileapp.md)|| +|[createCatalogApp action](../api/intune-apps-mobileapp-createcatalogapp.md)|[mobileApp](../resources/intune-shared-mobileapp.md)|| +|[convertFromMobileAppCatalogPackage function](../api/intune-apps-mobileapp-convertfrommobileappcatalogpackage.md)|[mobileApp](../resources/intune-shared-mobileapp.md)|| |[updateRelationships action](../api/intune-apps-mobileapp-updaterelationships.md)|None|| |[getPublishingConstraints function](../api/intune-apps-mobileapp-getpublishingconstraints.md)|[mobileAppPublishingConstraints](../resources/intune-apps-mobileapppublishingconstraints.md)|| Here is a JSON representation of the resource. "supersedingAppCount": 1024, "supersededAppCount": 1024 }-``` +``` |
v1.0 | Intune Apps Mobileappassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-mobileappassignment.md | Here is a JSON representation of the resource. "source": "String", "sourceId": "String" }-``` +``` |
v1.0 | Intune Apps Mobileappcategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-mobileappcategory.md | Here is a JSON representation of the resource. "displayName": "String", "lastModifiedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Apps Mobileappcontent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-mobileappcontent.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.mobileAppContent", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Apps Mobileappcontentfile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-mobileappcontentfile.md | Here is a JSON representation of the resource. "isFrameworkFile": true, "isDependency": true }-``` +``` |
v1.0 | Intune Apps Mobileappcontentfileuploadstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-mobileappcontentfileuploadstate.md | Contains properties for upload request states. |commitFileSuccess|300|| |commitFilePending|301|| |commitFileFailed|302||-|commitFileTimedOut|303|| +|commitFileTimedOut|303|| |
v1.0 | Intune Apps Mobileappdependency | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-mobileappdependency.md | Here is a JSON representation of the resource. "dependentAppCount": 1024, "dependsOnAppCount": 1024 }-``` +``` |
v1.0 | Intune Apps Mobileappdependencytype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-mobileappdependencytype.md | Indicates the dependency type associated with a relationship between two mobile |Member|Value|Description| |:|:|:| |detect|0|Indicates that the child app should be detected before installing the parent app.|-|autoInstall|1|Indicates that the child app should be installed before installing the parent app.| +|autoInstall|1|Indicates that the child app should be installed before installing the parent app.| |
v1.0 | Intune Apps Mobileappinstallstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-mobileappinstallstatus.md | Contains properties for the installation state of a mobile app for a device. Thi |deviceName|String|Device name| |deviceId|String|Device ID| |lastSyncDateTime|DateTimeOffset|Last sync date time|-|mobileAppInstallStatusValue|[resultantAppState](../resources/intune-apps-resultantappstate.md)|The install state of the app. Possible values are: `installed`, `failed`, `notInstalled`, `uninstallFailed`, `pendingInstall`, `unknown`, `notApplicable`.| -|installState|[resultantAppState](../resources/intune-apps-resultantappstate.md)|The install state of the app. Possible values are: `installed`, `failed`, `notInstalled`, `uninstallFailed`, `pendingInstall`, `unknown`, `notApplicable`.| +|mobileAppInstallStatusValue|[resultantAppState](../resources/intune-shared-resultantappstate.md)|The install state of the app. Possible values are: `installed`, `failed`, `notInstalled`, `uninstallFailed`, `pendingInstall`, `unknown`, `notApplicable`.| +|installState|[resultantAppState](../resources/intune-shared-resultantappstate.md)|The install state of the app. Possible values are: `installed`, `failed`, `notInstalled`, `uninstallFailed`, `pendingInstall`, `unknown`, `notApplicable`.| |installStateDetail|[resultantAppStateDetail](../resources/intune-apps-resultantappstatedetail.md)|The install state detail of the app. Possible values are: `noAdditionalDetails`, `dependencyFailedToInstall`, `dependencyWithRequirementsNotMet`, `dependencyPendingReboot`, `dependencyWithAutoInstallDisabled`, `supersededAppUninstallFailed`, `supersededAppUninstallPendingReboot`, `removingSupersededApps`, `iosAppStoreUpdateFailedToInstall`, `vppAppHasUpdateAvailable`, `userRejectedUpdate`, `uninstallPendingReboot`, `supersedingAppsDetected`, `supersededAppsDetected`, `seeInstallErrorCode`, `autoInstallDisabled`, `managedAppNoLongerPresent`, `userRejectedInstall`, `userIsNotLoggedIntoAppStore`, `untargetedSupersedingAppsDetected`, `appRemovedBySupersedence`, `seeUninstallErrorCode`, `pendingReboot`, `installingDependencies`, `contentDownloaded`, `supersedingAppsNotApplicable`, `powerShellScriptRequirementNotMet`, `registryRequirementNotMet`, `fileSystemRequirementNotMet`, `platformNotApplicable`, `minimumCpuSpeedNotMet`, `minimumLogicalProcessorCountNotMet`, `minimumPhysicalMemoryNotMet`, `minimumOsVersionNotMet`, `minimumDiskSpaceNotMet`, `processorArchitectureNotApplicable`.| |errorCode|Int32|The error code for install or uninstall failures.| |osVersion|String|OS Version| Here is a JSON representation of the resource. "userPrincipalName": "String", "displayVersion": "String" }-``` +``` |
v1.0 | Intune Apps Mobileappinstallsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-mobileappinstallsummary.md | Here is a JSON representation of the resource. "notInstalledUserCount": 1024, "pendingInstallUserCount": 1024 }-``` +``` |
v1.0 | Intune Apps Mobileappprovisioningconfiggroupassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-mobileappprovisioningconfiggroupassignment.md | Here is a JSON representation of the resource. "targetGroupId": "String", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Apps Mobileapppublishingconstraints | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-mobileapppublishingconstraints.md | Here is a JSON representation of the resource. "maxContentFileSizeInBytes": 1024 } }-``` +``` |
v1.0 | Intune Apps Mobileapppublishingstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-mobileapppublishingstate.md | Indicates the publishing state of an app. |:|:|:| |notPublished|0|The app is not yet published.| |processing|1|The app is pending service-side processing.|-|published|2|The app is published.| +|published|2|The app is published.| |
v1.0 | Intune Apps Mobileapprelationship | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-mobileapprelationship.md | Here is a JSON representation of the resource. "targetPublisher": "String", "targetType": "String" }-``` +``` |
v1.0 | Intune Apps Mobileapprelationshipstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-mobileapprelationshipstate.md | Describes the installation status details of the child app in the context of UPN |targetId|String|The related target app's id.| |targetDisplayName|String|The related target app's display name.| |deviceId|String|The corresponding device id.|-|installState|[resultantAppState](../resources/intune-apps-resultantappstate.md)|The install state of the app of target app. Possible values are: `installed`, `failed`, `notInstalled`, `uninstallFailed`, `pendingInstall`, `unknown`, `notApplicable`.| +|installState|[resultantAppState](../resources/intune-shared-resultantappstate.md)|The install state of the app of target app. Possible values are: `installed`, `failed`, `notInstalled`, `uninstallFailed`, `pendingInstall`, `unknown`, `notApplicable`.| |installStateDetail|[resultantAppStateDetail](../resources/intune-apps-resultantappstatedetail.md)|The install state detail of the app. Possible values are: `noAdditionalDetails`, `dependencyFailedToInstall`, `dependencyWithRequirementsNotMet`, `dependencyPendingReboot`, `dependencyWithAutoInstallDisabled`, `supersededAppUninstallFailed`, `supersededAppUninstallPendingReboot`, `removingSupersededApps`, `iosAppStoreUpdateFailedToInstall`, `vppAppHasUpdateAvailable`, `userRejectedUpdate`, `uninstallPendingReboot`, `supersedingAppsDetected`, `supersededAppsDetected`, `seeInstallErrorCode`, `autoInstallDisabled`, `managedAppNoLongerPresent`, `userRejectedInstall`, `userIsNotLoggedIntoAppStore`, `untargetedSupersedingAppsDetected`, `appRemovedBySupersedence`, `seeUninstallErrorCode`, `pendingReboot`, `installingDependencies`, `contentDownloaded`, `supersedingAppsNotApplicable`, `powerShellScriptRequirementNotMet`, `registryRequirementNotMet`, `fileSystemRequirementNotMet`, `platformNotApplicable`, `minimumCpuSpeedNotMet`, `minimumLogicalProcessorCountNotMet`, `minimumPhysicalMemoryNotMet`, `minimumOsVersionNotMet`, `minimumDiskSpaceNotMet`, `processorArchitectureNotApplicable`.| |errorCode|Int32|The error code for install or uninstall failures of target app.| |targetLastSyncDateTime|DateTimeOffset|The last sync time of the target app.| Here is a JSON representation of the resource. "errorCode": 1024, "targetLastSyncDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Apps Mobileapprelationshiptype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-mobileapprelationshiptype.md | Indicates whether the target of a relationship is the parent or the child in the |Member|Value|Description| |:|:|:| |child|0|Indicates that the target of a relationship is the child in the relationship.|-|parent|1|Indicates that the target of a relationship is the parent in the relationship.| +|parent|1|Indicates that the target of a relationship is the parent in the relationship.| |
v1.0 | Intune Apps Mobileappsupersedence | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-mobileappsupersedence.md | Here is a JSON representation of the resource. "supersededAppCount": 1024, "supersedingAppCount": 1024 }-``` +``` |
v1.0 | Intune Apps Mobileappsupersedencetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-mobileappsupersedencetype.md | Indicates the supersedence type associated with a relationship between two mobil |Member|Value|Description| |:|:|:| |update|0|Indicates that the child app should be updated by the internal logic of the parent app.|-|replace|1|Indicates that the child app should be uninstalled before installing the parent app.| +|replace|1|Indicates that the child app should be uninstalled before installing the parent app.| |
v1.0 | Intune Apps Mobilecontainedapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-mobilecontainedapp.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.mobileContainedApp", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Apps Mobilelobapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-mobilelobapp.md | Here is a JSON representation of the resource. "fileName": "String", "size": 1024 }-``` +``` |
v1.0 | Intune Apps Officeproductid | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-officeproductid.md | The Enum to specify the Office365 ProductIds that represent the Office365 Suite |o365ProPlusRetail|0|| |o365BusinessRetail|1|| |visioProRetail|2||-|projectProRetail|3|| +|projectProRetail|3|| |
v1.0 | Intune Apps Officesuiteapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-officesuiteapp.md | Here is a JSON representation of the resource. "updateVersion": "String", "officeConfigurationXml": "binary" }-``` +``` |
v1.0 | Intune Apps Officesuitedefaultfileformattype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-officesuitedefaultfileformattype.md | Describes the OfficeSuiteApp file format types that can be selected. |notConfigured|0|No file format selected| |officeOpenXMLFormat|1|Office Open XML Format selected| |officeOpenDocumentFormat|2|Office Open Document Format selected|-|unknownFutureValue|99|Placeholder for evolvable enum.| +|unknownFutureValue|99|Placeholder for evolvable enum.| |
v1.0 | Intune Apps Officesuiteinstallprogressdisplaylevel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-officesuiteinstallprogressdisplaylevel.md | The Enum to specify the level of display for the Installation Progress Setup UI |Member|Value|Description| |:|:|:| |none|0||-|full|1|| +|full|1|| |
v1.0 | Intune Apps Officeupdatechannel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-officeupdatechannel.md | The Enum to specify the Office365 Updates Channel. |deferred|2|| |firstReleaseCurrent|3|| |firstReleaseDeferred|4||-|monthlyEnterprise|5|| +|monthlyEnterprise|5|| |
v1.0 | Intune Apps Resultantappstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-resultantappstate.md | A list of possible states for application status on an individual device. When d |uninstallFailed|4|The application failed to uninstall.| |pendingInstall|5|The installation of the application is in progress.| |unknown|99|The status of the application is unknown.|-|notApplicable|-1|The application is not applicable.| +|notApplicable|-1|The application is not applicable.| |
v1.0 | Intune Apps Resultantappstatedetail | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-resultantappstatedetail.md | Enum indicating additional details regarding why an application has a particular |minimumPhysicalMemoryNotMet|-1003|Amount of RAM on the target device is less than the configured minimum.| |minimumOsVersionNotMet|-1002|OS version on the target device is less than the configured minimum.| |minimumDiskSpaceNotMet|-1001|Available disk space on the target device is less than the configured minimum.|-|processorArchitectureNotApplicable|-1000|Device architecture (e.g. x86/amd64) is not applicable for the application.| +|processorArchitectureNotApplicable|-1000|Device architecture (e.g. x86/amd64) is not applicable for the application.| |
v1.0 | Intune Apps Runasaccounttype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-runasaccounttype.md | Indicates the type of execution context the app runs in. |Member|Value|Description| |:|:|:| |system|0|System context|-|user|1|User context| +|user|1|User context| |
v1.0 | Intune Apps Symanteccodesigningcertificate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-symanteccodesigningcertificate.md | Here is a JSON representation of the resource. "expirationDateTime": "String (timestamp)", "uploadDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Apps Userappinstallstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-userappinstallstatus.md | Here is a JSON representation of the resource. "failedDeviceCount": 1024, "notInstalledDeviceCount": 1024 }-``` +``` |
v1.0 | Intune Apps Vpplicensingtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-vpplicensingtype.md | Here is a JSON representation of the resource. "supportsUserLicensing": true, "supportsDeviceLicensing": true }-``` +``` |
v1.0 | Intune Apps Webapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-webapp.md | Here is a JSON representation of the resource. "appUrl": "String", "useManagedBrowser": true }-``` +``` |
v1.0 | Intune Apps Win32lobapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobapp.md | Here is a JSON representation of the resource. "displayVersion": "String", "allowAvailableUninstall": true }-``` +``` |
v1.0 | Intune Apps Win32lobappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappassignmentsettings.md | Inherits from [mobileAppAssignmentSettings](../resources/intune-shared-mobileapp |restartSettings|[win32LobAppRestartSettings](../resources/intune-shared-win32lobapprestartsettings.md)|The reboot settings to apply for this app assignment.| |installTimeSettings|[mobileAppInstallTimeSettings](../resources/intune-shared-mobileappinstalltimesettings.md)|The install time settings to apply for this app assignment.| |deliveryOptimizationPriority|[win32LobAppDeliveryOptimizationPriority](../resources/intune-shared-win32lobappdeliveryoptimizationpriority.md)|The delivery optimization priority for this app assignment. This setting is not supported in National Cloud environments. Possible values are: `notConfigured`, `foreground`.|-|autoUpdateSettings|[win32LobAppAutoUpdateSettings](../resources/intune-apps-win32lobappautoupdatesettings.md)|The auto-update settings to apply for this app assignment.| +|autoUpdateSettings|[win32LobAppAutoUpdateSettings](../resources/intune-shared-win32lobappautoupdatesettings.md)|The auto-update settings to apply for this app assignment.| ## Relationships None Here is a JSON representation of the resource. "deliveryOptimizationPriority": "String", "autoUpdateSettings": { "@odata.type": "microsoft.graph.win32LobAppAutoUpdateSettings",- "autoUpdateSupersededApps": "String" + "autoUpdateSupersededApps": "String", + "autoUpdateSupersededAppsState": "String" } }-``` +``` |
v1.0 | Intune Apps Win32lobappautoupdatesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappautoupdatesettings.md | Contains properties used to perform the auto-update of an application. ## Properties |Property|Type|Description| |:|:|:|-|autoUpdateSupersededApps|[win32LobAppAutoUpdateSupersededApps](../resources/intune-apps-win32lobappautoupdatesupersededapps.md)|The auto-update superseded apps setting for the app assignment. Possible values are notConfigured and enabled. Default value is notConfigured. Possible values are: `notConfigured`, `enabled`, `unknownFutureValue`.| +|autoUpdateSupersededApps|[win32LobAppAutoUpdateSupersededApps](../resources/intune-shared-win32lobappautoupdatesupersededapps.md)|The auto-update superseded apps setting for the app assignment. Possible values are notConfigured and enabled. Default value is notConfigured. Starting from April, 2024 (Intune Release 2404), this property will no longer be supported and will be marked as deprecated. Possible values are: `notConfigured`, `enabled`, `unknownFutureValue`.| +|autoUpdateSupersededAppsState|[win32LobAutoUpdateSupersededAppsState](../resources/intune-apps-win32lobautoupdatesupersededappsstate.md)|The auto-update superseded apps state setting for the app assignment. Possible values are notConfigured and enabled. Default value is notConfigured. Possible values are: `notConfigured`, `enabled`, `unknownFutureValue`.| ## Relationships None Here is a JSON representation of the resource. ``` json { "@odata.type": "#microsoft.graph.win32LobAppAutoUpdateSettings",- "autoUpdateSupersededApps": "String" + "autoUpdateSupersededApps": "String", + "autoUpdateSupersededAppsState": "String" }-``` +``` |
v1.0 | Intune Apps Win32lobappautoupdatesupersededapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappautoupdatesupersededapps.md | Contains value for auto-update superseded apps. |:|:|:| |notConfigured|0|Indicates that the auto-update superseded apps is not configured and the app will not auto-update the superseded apps.| |enabled|1|Indicates that the auto-update superseded apps is enabled and the app will auto-update the superseded apps if the superseded apps are installed on the device.|-|unknownFutureValue|2|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|2|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Apps Win32lobappdetection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappdetection.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.win32LobAppDetection" }-``` +``` |
v1.0 | Intune Apps Win32lobappdetectionoperator | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappdetectionoperator.md | Contains properties for detection operator. |greaterThan|4|Greater than operator.| |greaterThanOrEqual|5|Greater than or equal operator.| |lessThan|8|Less than operator.|-|lessThanOrEqual|9|Less than or equal operator.| +|lessThanOrEqual|9|Less than or equal operator.| |
v1.0 | Intune Apps Win32lobappfilesystemdetection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappfilesystemdetection.md | Here is a JSON representation of the resource. "operator": "String", "detectionValue": "String" }-``` +``` |
v1.0 | Intune Apps Win32lobappfilesystemdetectiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappfilesystemdetectiontype.md | Contains all supported file system detection type. |createdDate|3|Created date.| |version|4|Version value type.| |sizeInMB|5|Size detection type.|-|doesNotExist|6|The specified file or folder does not exist.| +|doesNotExist|6|The specified file or folder does not exist.| |
v1.0 | Intune Apps Win32lobappfilesystemoperationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappfilesystemoperationtype.md | A list of possible operations for rules used to make determinations about an app |doesNotExist|6|Indicates that the rule evaluates whether the specified file or folder does not exist. It is the functional inverse of an equivalent rule that uses operation type `exists`.| |sizeInBytes|7|Indicates that the rule compares the size of the file in bytes against a provided comparison value by integer comparison.| |appVersion|8|Indicates that the rule compares the detected version of the file against a provided comparison value via version semantics (both operand values will be parsed as versions and directly compared). If the detected version of the file is not discovered to be in version-compatible format, a string comparison will be used instead. This is similar to a rule with operation type `version`, but it also collects and reports the detected version value to report as the discovered version of the app installed on the device when the rule evaluates to `true`. Only one rule with this type may be specified.|-|unknownFutureValue|9|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|9|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Apps Win32lobappfilesystemrequirement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappfilesystemrequirement.md | Here is a JSON representation of the resource. "check32BitOn64System": true, "detectionType": "String" }-``` +``` |
v1.0 | Intune Apps Win32lobappfilesystemrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappfilesystemrule.md | Here is a JSON representation of the resource. "operator": "String", "comparisonValue": "String" }-``` +``` |
v1.0 | Intune Apps Win32lobappinstallexperience | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappinstallexperience.md | Here is a JSON representation of the resource. "maxRunTimeInMinutes": 1024, "deviceRestartBehavior": "String" }-``` +``` |
v1.0 | Intune Apps Win32lobappmsiinformation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappmsiinformation.md | Here is a JSON representation of the resource. "productName": "String", "publisher": "String" }-``` +``` |
v1.0 | Intune Apps Win32lobappmsipackagetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappmsipackagetype.md | Indicates the package type of an MSI Win32LobApp. |:|:|:| |perMachine|0|Indicates a per-machine app package.| |perUser|1|Indicates a per-user app package.|-|dualPurpose|2|Indicates a dual-purpose app package.| +|dualPurpose|2|Indicates a dual-purpose app package.| |
v1.0 | Intune Apps Win32lobapppowershellscriptdetection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobapppowershellscriptdetection.md | Here is a JSON representation of the resource. "runAs32Bit": true, "scriptContent": "String" }-``` +``` |
v1.0 | Intune Apps Win32lobapppowershellscriptdetectiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobapppowershellscriptdetectiontype.md | Contains all supported Powershell Script output detection type. |integer|3|Output data type is integer.| |float|4|Output data type is float.| |version|5|Output data type is version.|-|boolean|6|Output data type is boolean.| +|boolean|6|Output data type is boolean.| |
v1.0 | Intune Apps Win32lobapppowershellscriptrequirement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobapppowershellscriptrequirement.md | Here is a JSON representation of the resource. "scriptContent": "String", "detectionType": "String" }-``` +``` |
v1.0 | Intune Apps Win32lobapppowershellscriptrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobapppowershellscriptrule.md | Here is a JSON representation of the resource. "operator": "String", "comparisonValue": "String" }-``` +``` |
v1.0 | Intune Apps Win32lobapppowershellscriptruleoperationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobapppowershellscriptruleoperationtype.md | Contains all supported Powershell Script output detection type. |integer|3|Output data type is integer.| |float|4|Output data type is float.| |version|5|Output data type is version.|-|boolean|6|Output data type is boolean.| +|boolean|6|Output data type is boolean.| |
v1.0 | Intune Apps Win32lobappproductcodedetection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappproductcodedetection.md | Here is a JSON representation of the resource. "productVersionOperator": "String", "productVersion": "String" }-``` +``` |
v1.0 | Intune Apps Win32lobappproductcoderule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappproductcoderule.md | Here is a JSON representation of the resource. "productVersionOperator": "String", "productVersion": "String" }-``` +``` |
v1.0 | Intune Apps Win32lobapppublishingconstraints | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobapppublishingconstraints.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.win32LobAppPublishingConstraints", "maxContentFileSizeInBytes": 1024 }-``` +``` |
v1.0 | Intune Apps Win32lobappregistrydetection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappregistrydetection.md | Here is a JSON representation of the resource. "operator": "String", "detectionValue": "String" }-``` +``` |
v1.0 | Intune Apps Win32lobappregistrydetectiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappregistrydetectiontype.md | Contains all supported registry data detection type. |doesNotExist|2|The specified registry key or value does not exist.| |string|3|String value type.| |integer|4|Integer value type.|-|version|5|Version value type.| +|version|5|Version value type.| |
v1.0 | Intune Apps Win32lobappregistryrequirement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappregistryrequirement.md | Here is a JSON representation of the resource. "valueName": "String", "detectionType": "String" }-``` +``` |
v1.0 | Intune Apps Win32lobappregistryrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappregistryrule.md | Here is a JSON representation of the resource. "operator": "String", "comparisonValue": "String" }-``` +``` |
v1.0 | Intune Apps Win32lobappregistryruleoperationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappregistryruleoperationtype.md | A list of possible operations for rules used to make determinations about an app |integer|4|Indicates that the rule compares the value read at the given registry value against a provided comparison value by integer comparison.| |version|5|Indicates that the rule compares the value read at the given registry value against a provided comparison value via version semantics (both operand values will be parsed as versions and directly compared). If the value read at the given registry value is not discovered to be in version-compatible format, a string comparison will be used instead.| |appVersion|7|Indicates that the rule compares the data read at the given registry value against a provided comparison value via version semantics (both operand values will be parsed as versions and directly compared). If the data read at the given registry value is not discovered to be in a version-compatible format, a string comparison will be used instead. The rule will be resolved as not detected if the given registry value does not exist. This is similar to a rule with operation type `version`, but it also collects and reports the detected version value to report as the discovered version of the app installed on the device when the rule evaluates to `true`. Only one rule with this type may be specified.|-|unknownFutureValue|8|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|8|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Apps Win32lobapprequirement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobapprequirement.md | Here is a JSON representation of the resource. "operator": "String", "detectionValue": "String" }-``` +``` |
v1.0 | Intune Apps Win32lobapprestartbehavior | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobapprestartbehavior.md | Indicates the type of restart action. |basedOnReturnCode|0|Intune will restart the device after running the app installation if the operation returns a reboot code.| |allow|1|Intune will not take any specific action on reboot codes resulting from app installations. Intune will not attempt to suppress restarts for MSI apps.| |suppress|2|Intune will attempt to suppress restarts for MSI apps.|-|force|3|Intune will force the device to restart immediately after the app installation operation.| +|force|3|Intune will force the device to restart immediately after the app installation operation.| |
v1.0 | Intune Apps Win32lobappreturncode | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappreturncode.md | Here is a JSON representation of the resource. "returnCode": 1024, "type": "String" }-``` +``` |
v1.0 | Intune Apps Win32lobappreturncodetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappreturncodetype.md | Indicates the type of return code. |success|1|Success.| |softReboot|2|Soft-reboot is required.| |hardReboot|3|Hard-reboot is required.|-|retry|4|Retry.| +|retry|4|Retry.| |
v1.0 | Intune Apps Win32lobapprule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobapprule.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.win32LobAppRule", "ruleType": "String" }-``` +``` |
v1.0 | Intune Apps Win32lobappruleoperator | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappruleoperator.md | Contains properties for detection operator. |greaterThan|4|Greater than operator.| |greaterThanOrEqual|5|Greater than or equal operator.| |lessThan|8|Less than operator.|-|lessThanOrEqual|9|Less than or equal operator.| +|lessThanOrEqual|9|Less than or equal operator.| |
v1.0 | Intune Apps Win32lobappruletype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobappruletype.md | Contains rule types for Win32 LOB apps. |Member|Value|Description| |:|:|:| |detection|0|Detection rule.|-|requirement|1|Requirement rule.| +|requirement|1|Requirement rule.| |
v1.0 | Intune Apps Win32lobautoupdatesupersededappsstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-win32lobautoupdatesupersededappsstate.md | + + Title: "win32LobAutoUpdateSupersededAppsState enum type" +description: "Contains value for auto-update superseded apps." ++localization_priority: Normal ++++# win32LobAutoUpdateSupersededAppsState enum type ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. ++Contains value for auto-update superseded apps. ++## Members +|Member|Value|Description| +|:|:|:| +|notConfigured|0|Indicates that the auto-update superseded apps state is not configured and the app will not auto-update the superseded apps.| +|enabled|1|Indicates that the auto-update superseded apps state is enabled and the app will auto-update the superseded apps if the superseded apps are installed on the device.| +|unknownFutureValue|2|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Apps Windowsappx | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-windowsappx.md | Here is a JSON representation of the resource. }, "identityVersion": "String" }-``` +``` |
v1.0 | Intune Apps Windowsappxappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-windowsappxappassignmentsettings.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.windowsAppXAppAssignmentSettings", "useDeviceContext": true }-``` +``` |
v1.0 | Intune Apps Windowsarchitecture | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-windowsarchitecture.md | Contains properties for Windows architecture. |x64|2|Whether or not the X64 Windows architecture type is supported.| |arm|4|Whether or not the Arm Windows architecture type is supported.| |neutral|8|Whether or not the Neutral Windows architecture type is supported.|-|arm64|16|Whether or not the Arm64 Windows architecture type is supported.| +|arm64|16|Whether or not the Arm64 Windows architecture type is supported.| |
v1.0 | Intune Apps Windowsdevicetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-windowsdevicetype.md | Contains properties for Windows device type. Multiple values can be selected. De |mobile|2|Indicates support for Mobile Windows device type.| |holographic|4|Indicates support for Holographic Windows device type.| |team|8|Indicates support for Team Windows device type.|-|unknownFutureValue|16|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|16|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Apps Windowsmicrosoftedgeapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-windowsmicrosoftedgeapp.md | Here is a JSON representation of the resource. "channel": "String", "displayLanguageLocale": "String" }-``` +``` |
v1.0 | Intune Apps Windowsminimumoperatingsystem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-windowsminimumoperatingsystem.md | Here is a JSON representation of the resource. "v10_2H20": true, "v10_21H1": true }-``` +``` |
v1.0 | Intune Apps Windowsmobilemsi | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-windowsmobilemsi.md | Here is a JSON representation of the resource. "identityVersion": "String", "useDeviceContext": true }-``` +``` |
v1.0 | Intune Apps Windowspackageinformation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-windowspackageinformation.md | Here is a JSON representation of the resource. "v10_21H1": true } }-``` +``` |
v1.0 | Intune Apps Windowsphone81appx | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-windowsphone81appx.md | Here is a JSON representation of the resource. "phonePublisherId": "String", "identityVersion": "String" }-``` +``` |
v1.0 | Intune Apps Windowsphone81appxbundle | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-windowsphone81appxbundle.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Apps Windowsphone81storeapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-windowsphone81storeapp.md | Here is a JSON representation of the resource. "supersededAppCount": 1024, "appStoreUrl": "String" }-``` +``` |
v1.0 | Intune Apps Windowsphonexap | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-windowsphonexap.md | Here is a JSON representation of the resource. "productIdentifier": "String", "identityVersion": "String" }-``` +``` |
v1.0 | Intune Apps Windowsstoreapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-windowsstoreapp.md | Here is a JSON representation of the resource. "supersededAppCount": 1024, "appStoreUrl": "String" }-``` +``` |
v1.0 | Intune Apps Windowsuniversalappx | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-windowsuniversalappx.md | Here is a JSON representation of the resource. }, "identityVersion": "String" }-``` +``` |
v1.0 | Intune Apps Windowsuniversalappxappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-windowsuniversalappxappassignmentsettings.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.windowsUniversalAppXAppAssignmentSettings", "useDeviceContext": true }-``` +``` |
v1.0 | Intune Apps Windowsuniversalappxcontainedapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-windowsuniversalappxcontainedapp.md | Here is a JSON representation of the resource. "id": "String (identifier)", "appUserModelId": "String" }-``` +``` |
v1.0 | Intune Apps Windowswebapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-windowswebapp.md | Here is a JSON representation of the resource. "supersededAppCount": 1024, "appUrl": "String" }-``` +``` |
v1.0 | Intune Apps Wingetapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-wingetapp.md | Here is a JSON representation of the resource. "runAsAccount": "String" } }-``` +``` |
v1.0 | Intune Apps Wingetappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-wingetappassignmentsettings.md | Inherits from [mobileAppAssignmentSettings](../resources/intune-shared-mobileapp ## Properties |Property|Type|Description| |:|:|:|-|notifications|[winGetAppNotification](../resources/intune-apps-wingetappnotification.md)|The notification status for this app assignment. Possible values are: `showAll`, `showReboot`, `hideAll`, `unknownFutureValue`.| -|restartSettings|[winGetAppRestartSettings](../resources/intune-apps-wingetapprestartsettings.md)|The reboot settings to apply for this app assignment.| -|installTimeSettings|[winGetAppInstallTimeSettings](../resources/intune-apps-wingetappinstalltimesettings.md)|The install time settings to apply for this app assignment.| +|notifications|[winGetAppNotification](../resources/intune-shared-wingetappnotification.md)|The notification status for this app assignment. Possible values are: `showAll`, `showReboot`, `hideAll`, `unknownFutureValue`.| +|restartSettings|[winGetAppRestartSettings](../resources/intune-shared-wingetapprestartsettings.md)|The reboot settings to apply for this app assignment.| +|installTimeSettings|[winGetAppInstallTimeSettings](../resources/intune-shared-wingetappinstalltimesettings.md)|The install time settings to apply for this app assignment.| ## Relationships None Here is a JSON representation of the resource. "deadlineDateTime": "String (timestamp)" } }-``` +``` |
v1.0 | Intune Apps Wingetappinstallexperience | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-wingetappinstallexperience.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.winGetAppInstallExperience", "runAsAccount": "String" }-``` +``` |
v1.0 | Intune Apps Wingetappinstalltimesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-wingetappinstalltimesettings.md | Here is a JSON representation of the resource. "useLocalTime": true, "deadlineDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Apps Wingetappnotification | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-wingetappnotification.md | Contains value for notification status. |showAll|0|Show all notifications.| |showReboot|1|Only show restart notification and suppress other notifications.| |hideAll|2|Hide all notifications.|-|unknownFutureValue|3|Unknown future value, reserved for future usage as expandable enum.| +|unknownFutureValue|3|Unknown future value, reserved for future usage as expandable enum.| |
v1.0 | Intune Apps Wingetapprestartsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-apps-wingetapprestartsettings.md | Here is a JSON representation of the resource. "countdownDisplayBeforeRestartInMinutes": 1024, "restartNotificationSnoozeDurationInMinutes": 1024 }-``` +``` |
v1.0 | Intune Auditing Auditactor | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-auditing-auditactor.md | Here is a JSON representation of the resource. "remoteTenantId": "String", "remoteUserId": "String" }-``` +``` |
v1.0 | Intune Auditing Auditevent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-auditing-auditevent.md | Here is a JSON representation of the resource. ], "category": "String" }-``` +``` |
v1.0 | Intune Auditing Auditproperty | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-auditing-auditproperty.md | Here is a JSON representation of the resource. "oldValue": "String", "newValue": "String" }-``` +``` |
v1.0 | Intune Auditing Auditresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-auditing-auditresource.md | Here is a JSON representation of the resource. "auditResourceType": "String", "resourceId": "String" }-``` +``` |
v1.0 | Intune Auditing Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-auditing-devicemanagement.md | Singleton entity that acts as a container for all device app management function ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-auditing-devicemanagement-get.md)|[deviceManagement](../resources/intune-auditing-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-auditing-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-auditing-devicemanagement-update.md)|[deviceManagement](../resources/intune-auditing-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-auditing-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-auditing-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-auditing-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Auditing Rolescopetaginfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-auditing-rolescopetaginfo.md | Here is a JSON representation of the resource. "displayName": "String", "roleScopeTagId": "String" }-``` +``` |
v1.0 | Intune Books Deviceappmanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-books-deviceappmanagement.md | Singleton entity that acts as a container for all device app management function ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceAppManagement](../api/intune-books-deviceappmanagement-get.md)|[deviceAppManagement](../resources/intune-books-deviceappmanagement.md)|Read properties and relationships of the [deviceAppManagement](../resources/intune-books-deviceappmanagement.md) object.| -|[Update deviceAppManagement](../api/intune-books-deviceappmanagement-update.md)|[deviceAppManagement](../resources/intune-books-deviceappmanagement.md)|Update the properties of a [deviceAppManagement](../resources/intune-books-deviceappmanagement.md) object.| +|[Get deviceAppManagement](../api/intune-books-deviceappmanagement-get.md)|[deviceAppManagement](../resources/intune-shared-deviceappmanagement.md)|Read properties and relationships of the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object.| +|[Update deviceAppManagement](../api/intune-books-deviceappmanagement-update.md)|[deviceAppManagement](../resources/intune-shared-deviceappmanagement.md)|Update the properties of a [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceAppManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Books Deviceinstallstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-books-deviceinstallstate.md | Here is a JSON representation of the resource. "osDescription": "String", "userName": "String" }-``` +``` |
v1.0 | Intune Books Ebookinstallsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-books-ebookinstallsummary.md | Here is a JSON representation of the resource. "failedUserCount": 1024, "notInstalledUserCount": 1024 }-``` +``` |
v1.0 | Intune Books Installstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-books-installstate.md | Possible values for install state. |failed|2|Failed.| |notInstalled|3|Not Installed.| |uninstallFailed|4|Uninstall Failed.|-|unknown|5|Unknown.| +|unknown|5|Unknown.| |
v1.0 | Intune Books Iosvppebook | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-books-iosvppebook.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Books Iosvppebookassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-books-iosvppebookassignment.md | Here is a JSON representation of the resource. }, "installIntent": "String" }-``` +``` |
v1.0 | Intune Books Managedebook | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-books-managedebook.md | Here is a JSON representation of the resource. "informationUrl": "String", "privacyInformationUrl": "String" }-``` +``` |
v1.0 | Intune Books Managedebookassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-books-managedebookassignment.md | Here is a JSON representation of the resource. }, "installIntent": "String" }-``` +``` |
v1.0 | Intune Books Managedebookcategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-books-managedebookcategory.md | Here is a JSON representation of the resource. "displayName": "String", "lastModifiedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Books Userinstallstatesummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-books-userinstallstatesummary.md | Here is a JSON representation of the resource. "failedDeviceCount": 1024, "notInstalledDeviceCount": 1024 }-``` +``` |
v1.0 | Intune Chromebooksync Chromeosonboardingsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-chromebooksync-chromeosonboardingsettings.md | Here is a JSON representation of the resource. "lastModifiedDateTime": "String (timestamp)", "lastDirectorySyncDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Chromebooksync Chromeosonboardingstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-chromebooksync-chromeosonboardingstatus.md | The onboarding status of the tenant. |onboarded|2|Onboarded| |failed|3|Failed| |offboarding|4|Offboarding|-|unknownFutureValue|99|UnknownFutureValue| +|unknownFutureValue|99|UnknownFutureValue| |
v1.0 | Intune Chromebooksync Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-chromebooksync-devicemanagement.md | Singleton that acts as container for a collection of Resource Access entities. ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-chromebooksync-devicemanagement-get.md)|[deviceManagement](../resources/intune-chromebooksync-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-chromebooksync-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-chromebooksync-devicemanagement-update.md)|[deviceManagement](../resources/intune-chromebooksync-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-chromebooksync-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-chromebooksync-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-chromebooksync-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Chromebooksync Onboardingstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-chromebooksync-onboardingstatus.md | The onboarding status of the tenant. |onboarded|2|Onboarded| |failed|3|Failed| |offboarding|4|Offboarding|-|unknownFutureValue|99|UnknownFutureValue| +|unknownFutureValue|99|UnknownFutureValue| |
v1.0 | Intune Company Conceptual | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-company-conceptual.md | You can deploy Intune terms and conditions to user groups to explain how enrollm You can create and deploy multiple policies containing different terms and conditions. You can also produce versions of the same terms and conditions in different languages and then deploy these to their appropriate groups. -Use Graph resources to manage company terms and conditions in Intune. See the table of content for a list of resources. +Use Graph resources to manage company terms and conditions in Intune. See the table of content for a list of resources. |
v1.0 | Intune Companyterms Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-companyterms-devicemanagement.md | Singleton entity that acts as a container for all device management functionalit ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-companyterms-devicemanagement-get.md)|[deviceManagement](../resources/intune-companyterms-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-companyterms-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-companyterms-devicemanagement-update.md)|[deviceManagement](../resources/intune-companyterms-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-companyterms-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-companyterms-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-companyterms-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Companyterms Termsandconditions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-companyterms-termsandconditions.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Companyterms Termsandconditionsacceptancestatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-companyterms-termsandconditionsacceptancestatus.md | Here is a JSON representation of the resource. "acceptedDateTime": "String (timestamp)", "userPrincipalName": "String" }-``` +``` |
v1.0 | Intune Companyterms Termsandconditionsassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-companyterms-termsandconditionsassignment.md | Here is a JSON representation of the resource. "entraObjectId": "String" } }-``` +``` |
v1.0 | Intune Companyterms Termsandconditionsgroupassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-companyterms-termsandconditionsgroupassignment.md | Here is a JSON representation of the resource. "id": "String (identifier)", "targetGroupId": "String" }-``` +``` |
v1.0 | Intune Device Cfg Conceptual | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-device-cfg-conceptual.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Use the Microsoft Intune Device Configuration workload to manage settings and features on all of the devices you manage. See the table of content for a list of resources. +Use the Microsoft Intune Device Configuration workload to manage settings and features on all of the devices you manage. See the table of content for a list of resources. |
v1.0 | Intune Device Mgt Conceptual | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-device-mgt-conceptual.md | Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Use the Microsoft Intune Device Management workload to manage settings and features on all of the devices you manage. See the table of content for a list of resources. +Use the Microsoft Intune Device Management workload to manage settings and features on all of the devices you manage. See the table of content for a list of resources. |
v1.0 | Intune Deviceconfig Administratorconfigureddevicecompliancestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-administratorconfigureddevicecompliancestate.md | Administrator configured device compliance state Enum |Member|Value|Description| |:|:|:| |basedOnDeviceCompliancePolicy|0|Set compliance state based on other compliance polices|-|nonCompliant|1|Set compliance to nonCompliant| +|nonCompliant|1|Set compliance to nonCompliant| |
v1.0 | Intune Deviceconfig Advancedbitlockerstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-advancedbitlockerstate.md | Advanced BitLocker State |windowsRecoveryEnvironmentNotConfigured|4096|WinRE is not configured| |tpmNotAvailable|8192|TPM is not available for BitLocker. This means TPM is not present, or TPM unavailable registry override is set or host OS is on portable/rome-able drive| |tpmNotReady|16384|TPM is not ready for BitLocker|-|networkError|32768|Network not available. This is required for recovery key backup. This is reported for Drive Encryption capable devices| +|networkError|32768|Network not available. This is required for recovery key backup. This is reported for Drive Encryption capable devices| |
v1.0 | Intune Deviceconfig Advancedthreatprotectiononboardingdevicesettingstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-advancedthreatprotectiononboardingdevicesettingstate.md | Here is a JSON representation of the resource. "state": "String", "complianceGracePeriodExpirationDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Deviceconfig Advancedthreatprotectiononboardingstatesummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-advancedthreatprotectiononboardingstatesummary.md | Here is a JSON representation of the resource. "conflictDeviceCount": 1024, "notAssignedDeviceCount": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Airprintdestination | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-airprintdestination.md | Here is a JSON representation of the resource. "port": 1024, "forceTls": true }-``` +``` |
v1.0 | Intune Deviceconfig Androidcertificateprofilebase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidcertificateprofilebase.md | Inherits from [deviceConfiguration](../resources/intune-shared-deviceconfigurati |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period.| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| ## Relationships |Relationship|Type|Description| Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Androidcompliancepolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidcompliancepolicy.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Androidcustomconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidcustomconfiguration.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownerappautoupdatepolicytype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerappautoupdatepolicytype.md | Android Device Owner possible values for states of the device's app auto update |userChoice|1|The user can control auto-updates.| |never|2|Apps are never auto-updated.| |wiFiOnly|3|Apps are auto-updated over Wi-Fi only.|-|always|4|Apps are auto-updated at any time. Data charges may apply.| +|always|4|Apps are auto-updated at any time. Data charges may apply.| |
v1.0 | Intune Deviceconfig Androiddeviceownerbatterypluggedmode | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerbatterypluggedmode.md | Android Device Owner possible values for states of the device's plugged-in power |notConfigured|0|Not configured; this value is ignored.| |ac|1|Power source is an AC charger.| |usb|2|Power source is a USB port.|-|wireless|3|Power source is wireless.| +|wireless|3|Power source is wireless.| |
v1.0 | Intune Deviceconfig Androiddeviceownercertificateaccesstype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownercertificateaccesstype.md | An enum representing possible values for cross profile data sharing. |:|:|:| |userApproval|0|Require user approval for all apps| |specificApps|1|Pre-grant certificate access for specific apps (require user approval for other apps).|-|unknownFutureValue|2|Unknown future value for evolvable enum patterns.| +|unknownFutureValue|2|Unknown future value for evolvable enum patterns.| |
v1.0 | Intune Deviceconfig Androiddeviceownercertificateprofilebase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md | Inherits from [deviceConfiguration](../resources/intune-shared-deviceconfigurati |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period.| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| ## Relationships Here is a JSON representation of the resource. ], "subjectAlternativeNameType": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownercompliancepolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownercompliancepolicy.md | Here is a JSON representation of the resource. "requireNoPendingSystemUpdates": true, "securityRequiredAndroidSafetyNetEvaluationType": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownercrossprofiledatasharing | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownercrossprofiledatasharing.md | An enum representing possible values for cross profile data sharing. |crossProfileDataSharingBlocked|1|Data cannot be shared from both the personal profile to work profile and the work profile to the personal profile.| |dataSharingFromWorkToPersonalBlocked|2|Prevents users from sharing data from the work profile to apps in the personal profile. Personal data can be shared with work apps.| |crossProfileDataSharingAllowed|3|Data from either profile can be shared with the other profile.|-|unkownFutureValue|4|Unknown future value (reserved, not used right now)| +|unkownFutureValue|4|Unknown future value (reserved, not used right now)| |
v1.0 | Intune Deviceconfig Androiddeviceownerdefaultapppermissionpolicytype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerdefaultapppermissionpolicytype.md | Android Device Owner default app permission policy type. |deviceDefault|0|Device default value, no intent.| |prompt|1|Prompt.| |autoGrant|2|Auto grant.|-|autoDeny|3|Auto deny.| +|autoDeny|3|Auto deny.| |
v1.0 | Intune Deviceconfig Androiddeviceownerdelegatedappscopetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerdelegatedappscopetype.md | An enum representing possible values for delegated app scope. |certificateInstall|1|Specifies that the admin has given app permission to install and manage certificates on device.| |captureNetworkActivityLog|2|Specifies that the admin has given app permission to capture network activity logs on device. More info on Network activity logs: https://developer.android.com/work/dpc/logging | |captureSecurityLog|3|Specified that the admin has given permission to capture security logs on device. More info on Security logs: https://developer.android.com/work/dpc/security#log_enterprise_device_activity|-|unknownFutureValue|4|Unknown future value (reserved, not used right now)| +|unknownFutureValue|4|Unknown future value (reserved, not used right now)| |
v1.0 | Intune Deviceconfig Androiddeviceownerdelegatedscopeappsetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerdelegatedscopeappsetting.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownerderivedcredentialauthenticationconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerderivedcredentialauthenticationconfiguration.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownerenrollmentprofiletype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerenrollmentprofiletype.md | Android Device Owner Enrollment Profile types. |:|:|:| |notConfigured|0|Not configured; this value is ignored.| |dedicatedDevice|1|Dedicated device.|-|fullyManaged|2|Fully managed.| +|fullyManaged|2|Fully managed.| |
v1.0 | Intune Deviceconfig Androiddeviceownerenterprisewificonfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerenterprisewificonfiguration.md | Here is a JSON representation of the resource. "innerAuthenticationProtocolForPeap": "String", "outerIdentityPrivacyTemporaryValue": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownergeneraldeviceconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownergeneraldeviceconfiguration.md | Here is a JSON representation of the resource. "shareDeviceLocationDisabled": true, "deviceLocationMode": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownerglobalproxy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerglobalproxy.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.androidDeviceOwnerGlobalProxy" }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownerglobalproxyautoconfig | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerglobalproxyautoconfig.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.androidDeviceOwnerGlobalProxyAutoConfig", "proxyAutoConfigURL": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownerglobalproxydirect | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerglobalproxydirect.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownerimportedpfxcertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerimportedpfxcertificateprofile.md | Inherits from [androidDeviceOwnerCertificateProfileBase](../resources/intune-dev |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |intendedPurpose|[intendedPurpose](../resources/intune-deviceconfig-intendedpurpose.md)|Intended Purpose of the Certificate Profile - which could be Unassigned, SmimeEncryption, SmimeSigning etc. Possible values are: `unassigned`, `smimeEncryption`, `smimeSigning`, `vpn`, `wifi`.| |certificateAccessType|[androidDeviceOwnerCertificateAccessType](../resources/intune-deviceconfig-androiddeviceownercertificateaccesstype.md)|Certificate access type. Possible values are: `userApproval`, `specificApps`, `unknownFutureValue`.| Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownerkioskcustomizationstatusbar | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerkioskcustomizationstatusbar.md | An enum representing possible values for kiosk customization system navigation. |:|:|:| |notConfigured|0|Not configured; this value defaults to STATUS_BAR_UNSPECIFIED.| |notificationsAndSystemInfoEnabled|1|System info and notifications are shown on the status bar in kiosk mode.|-|systemInfoOnly|2|Only system info is shown on the status bar in kiosk mode.| +|systemInfoOnly|2|Only system info is shown on the status bar in kiosk mode.| |
v1.0 | Intune Deviceconfig Androiddeviceownerkioskcustomizationsystemnavigation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerkioskcustomizationsystemnavigation.md | An enum representing possible values for kiosk customization system navigation. |:|:|:| |notConfigured|0|Not configured; this value defaults to NAVIGATION_DISABLED.| |navigationEnabled|1|Home and overview buttons are enabled.|-|homeButtonOnly|2| Only the home button is enabled.| +|homeButtonOnly|2| Only the home button is enabled.| |
v1.0 | Intune Deviceconfig Androiddeviceownerkioskmodeapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerkioskmodeapp.md | Here is a JSON representation of the resource. "package": "String", "className": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownerkioskmodeapppositionitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerkioskmodeapppositionitem.md | Here is a JSON representation of the resource. "link": "String" } }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownerkioskmodefoldericon | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerkioskmodefoldericon.md | Android Device Owner Kiosk Mode folder icon type. |darkSquare|1|Folder icon appears as dark square.| |darkCircle|2|Folder icon appears as dark circle.| |lightSquare|3|Folder icon appears as light square.|-|lightCircle|4|Folder icon appears as light circle .| +|lightCircle|4|Folder icon appears as light circle .| |
v1.0 | Intune Deviceconfig Androiddeviceownerkioskmodefolderitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerkioskmodefolderitem.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.androidDeviceOwnerKioskModeFolderItem" }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownerkioskmodehomescreenitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerkioskmodehomescreenitem.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.androidDeviceOwnerKioskModeHomeScreenItem" }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownerkioskmodeiconsize | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerkioskmodeiconsize.md | Android Device Owner Kiosk Mode managed home screen icon size. |small|2|Small icon size.| |regular|3|Regular icon size.| |large|4|Large icon size.|-|largest|5|Largest icon size.| +|largest|5|Largest icon size.| |
v1.0 | Intune Deviceconfig Androiddeviceownerkioskmodemanagedfolder | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerkioskmodemanagedfolder.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownerkioskmodemanagedfolderreference | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerkioskmodemanagedfolderreference.md | Here is a JSON representation of the resource. "folderName": "String", "folderIdentifier": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownerkioskmodescreenorientation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerkioskmodescreenorientation.md | Android Device Owner Kiosk Mode managed home screen orientation. |notConfigured|0|Not configured; this value is ignored.| |portrait|1|Portrait orientation.| |landscape|2|Landscape orientation.|-|autoRotate|3|Auto rotate between portrait and landscape orientations.| +|autoRotate|3|Auto rotate between portrait and landscape orientations.| |
v1.0 | Intune Deviceconfig Androiddeviceownerkioskmodeweblink | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerkioskmodeweblink.md | Here is a JSON representation of the resource. "label": "String", "link": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownerlocationmode | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerlocationmode.md | Android Device Owner Location Mode Type |:|:|:| |notConfigured|0|No restrictions on the location setting and no specific behavior is set or enforced. This is the default| |disabled|1|Location setting is disabled on the device|-|unknownFutureValue|2|Evolvable enumeration sentinel value. Do not use| +|unknownFutureValue|2|Evolvable enumeration sentinel value. Do not use| |
v1.0 | Intune Deviceconfig Androiddeviceownerpkcscertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerpkcscertificateprofile.md | Inherits from [androidDeviceOwnerCertificateProfileBase](../resources/intune-dev |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name| Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownerplaystoremode | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerplaystoremode.md | Android Device Owner Play Store mode type. |:|:|:| |notConfigured|0|Not Configured| |allowList|1|Only apps that are in the policy are available and any app not in the policy will be automatically uninstalled from the device.|-|blockList|2|All apps are available and any app that should not be on the device should be explicitly marked as 'BLOCKED' in the applications policy.| +|blockList|2|All apps are available and any app that should not be on the device should be explicitly marked as 'BLOCKED' in the applications policy.| |
v1.0 | Intune Deviceconfig Androiddeviceownerrequiredpasswordtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerrequiredpasswordtype.md | Android Device Owner policy required password type. |alphanumeric|5|At least alphanumeric password| |alphanumericWithSymbols|6|At least alphanumeric with symbols.| |lowSecurityBiometric|7|Low security biometrics based password required.|-|customPassword|8|Custom password set by the admin.| +|customPassword|8|Custom password set by the admin.| |
v1.0 | Intune Deviceconfig Androiddeviceownerrequiredpasswordunlock | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerrequiredpasswordunlock.md | An enum representing possible values for required password unlock. |:|:|:| |deviceDefault|0|Timeout period before strong authentication is required is set to the device's default.| |daily|1|Timeout period before strong authentication is required is set to 24 hours.|-|unkownFutureValue|2|Unknown future value (reserved, not used right now)| +|unkownFutureValue|2|Unknown future value (reserved, not used right now)| |
v1.0 | Intune Deviceconfig Androiddeviceownerscepcertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerscepcertificateprofile.md | Inherits from [androidDeviceOwnerCertificateProfileBase](../resources/intune-dev |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownersilentcertificateaccess | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownersilentcertificateaccess.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.androidDeviceOwnerSilentCertificateAccess", "packageId": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownersystemupdatefreezeperiod | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownersystemupdatefreezeperiod.md | Here is a JSON representation of the resource. "endMonth": 1024, "endDay": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownersystemupdateinstalltype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownersystemupdateinstalltype.md | System Update Types for Android Device Owner. |deviceDefault|0|Device default behavior, which typically prompts the user to accept system updates.| |postpone|1|Postpone automatic install of updates up to 30 days.| |windowed|2|Install automatically inside a daily maintenance window.|-|automatic|3|Automatically install updates as soon as possible.| +|automatic|3|Automatically install updates as soon as possible.| |
v1.0 | Intune Deviceconfig Androiddeviceownertrustedrootcertificate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownertrustedrootcertificate.md | Here is a JSON representation of the resource. "trustedRootCertificate": "binary", "certFileName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceowneruserfacingmessage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceowneruserfacingmessage.md | Here is a JSON representation of the resource. ], "defaultMessage": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownervirtualhomebuttontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownervirtualhomebuttontype.md | Android Device Owner Kiosk Mode managed home screen virtual home button type. |:|:|:| |notConfigured|0|Not configured; this value is ignored.| |swipeUp|1|Swipe-up for home button.|-|floating|2|Floating home button.| +|floating|2|Floating home button.| |
v1.0 | Intune Deviceconfig Androiddeviceownervpnconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownervpnconfiguration.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownerwificonfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerwificonfiguration.md | Here is a JSON representation of the resource. "proxyExclusionList": "String", "macAddressRandomizationMode": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androiddeviceownerwifisecuritytype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownerwifisecuritytype.md | Wi-Fi Security Types for Android Device Owner. |open|0|Open (No Authentication).| |wep|1|WEP Encryption.| |wpaPersonal|2|WPA-Personal/WPA2-Personal.|-|wpaEnterprise|4|WPA-Enterprise/WPA2-Enterprise. Must use AndroidDeviceOwnerEnterpriseWifiConfiguration type to configure enterprise options.| +|wpaEnterprise|4|WPA-Enterprise/WPA2-Enterprise. Must use AndroidDeviceOwnerEnterpriseWifiConfiguration type to configure enterprise options.| |
v1.0 | Intune Deviceconfig Androideaptype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androideaptype.md | Extensible Authentication Protocol (EAP) Configuration Types. |:|:|:| |eapTls|13|Extensible Authentication Protocol-Transport Layer Security (EAP-TLS).| |eapTtls|21|Extensible Authentication Protocol-Tunneled Transport Layer Security (EAP-TTLS).|-|peap|25|Protected Extensible Authentication Protocol (PEAP).| +|peap|25|Protected Extensible Authentication Protocol (PEAP).| |
v1.0 | Intune Deviceconfig Androideasemailprofileconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androideasemailprofileconfiguration.md | Here is a JSON representation of the resource. "userDomainNameSource": "String", "customDomainName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidenterprisewificonfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidenterprisewificonfiguration.md | Here is a JSON representation of the resource. "passwordFormatString": "String", "preSharedKey": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidforworkcertificateprofilebase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidforworkcertificateprofilebase.md | Inherits from [deviceConfiguration](../resources/intune-shared-deviceconfigurati |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period.| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| ## Relationships Here is a JSON representation of the resource. ], "subjectAlternativeNameType": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidforworkcompliancepolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidforworkcompliancepolicy.md | Here is a JSON representation of the resource. "securityRequireCompanyPortalAppIntegrity": true, "securityRequiredAndroidSafetyNetEvaluationType": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidforworkcrossprofiledatasharingtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidforworkcrossprofiledatasharingtype.md | Android For Work cross profile data sharing type. |deviceDefault|0|Device default value, no intent.| |preventAny|1|Prevent any sharing.| |allowPersonalToWork|2|Allow data sharing request from personal profile to work profile.|-|noRestrictions|3|No restrictions on sharing.| +|noRestrictions|3|No restrictions on sharing.| |
v1.0 | Intune Deviceconfig Androidforworkcustomconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidforworkcustomconfiguration.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Androidforworkdefaultapppermissionpolicytype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidforworkdefaultapppermissionpolicytype.md | Android For Work default app permission policy type. |deviceDefault|0|Device default value, no intent.| |prompt|1|Prompt.| |autoGrant|2|Auto grant.|-|autoDeny|3|Auto deny.| +|autoDeny|3|Auto deny.| |
v1.0 | Intune Deviceconfig Androidforworkeasemailprofilebase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidforworkeasemailprofilebase.md | Here is a JSON representation of the resource. "requireSsl": true, "usernameSource": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidforworkenterprisewificonfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidforworkenterprisewificonfiguration.md | Here is a JSON representation of the resource. "innerAuthenticationProtocolForPeap": "String", "outerIdentityPrivacyTemporaryValue": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidforworkgeneraldeviceconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidforworkgeneraldeviceconfiguration.md | Here is a JSON representation of the resource. ], "blockUnifiedPasswordForWorkProfile": true }-``` +``` |
v1.0 | Intune Deviceconfig Androidforworkgmaileasconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidforworkgmaileasconfiguration.md | Here is a JSON representation of the resource. "requireSsl": true, "usernameSource": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidforworkimportedpfxcertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidforworkimportedpfxcertificateprofile.md | Inherits from [androidCertificateProfileBase](../resources/intune-deviceconfig-a |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |intendedPurpose|[intendedPurpose](../resources/intune-deviceconfig-intendedpurpose.md)|Intended Purpose of the Certificate Profile - which could be Unassigned, SmimeEncryption, SmimeSigning etc. Possible values are: `unassigned`, `smimeEncryption`, `smimeSigning`, `vpn`, `wifi`.| ## Relationships Here is a JSON representation of the resource. ], "intendedPurpose": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidforworknineworkeasconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidforworknineworkeasconfiguration.md | Here is a JSON representation of the resource. "syncContacts": true, "syncTasks": true }-``` +``` |
v1.0 | Intune Deviceconfig Androidforworkpkcscertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidforworkpkcscertificateprofile.md | Inherits from [androidForWorkCertificateProfileBase](../resources/intune-devicec |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name| Here is a JSON representation of the resource. "certificateTemplateName": "String", "subjectAlternativeNameFormatString": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidforworkrequiredpasswordtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidforworkrequiredpasswordtype.md | Android For Work required password type. |numericComplex|4|Numeric complex password required.| |atLeastAlphabetic|5|At least alphabetic password required.| |atLeastAlphanumeric|6|At least alphanumeric password required.|-|alphanumericWithSymbols|7|At least alphanumeric with symbols password required.| +|alphanumericWithSymbols|7|At least alphanumeric with symbols password required.| |
v1.0 | Intune Deviceconfig Androidforworkscepcertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidforworkscepcertificateprofile.md | Inherits from [androidForWorkCertificateProfileBase](../resources/intune-devicec |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Androidforworktrustedrootcertificate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidforworktrustedrootcertificate.md | Here is a JSON representation of the resource. "trustedRootCertificate": "binary", "certFileName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidforworkvpnconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidforworkvpnconfiguration.md | Here is a JSON representation of the resource. ], "authenticationMethod": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidforworkvpnconnectiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidforworkvpnconnectiontype.md | Android For Work VPN connection type. |f5EdgeClient|2|F5 Edge Client.| |dellSonicWallMobileConnect|3|Dell SonicWALL Mobile Connection.| |checkPointCapsuleVpn|4|Check Point Capsule VPN.|-|citrix|5|Citrix| +|citrix|5|Citrix| |
v1.0 | Intune Deviceconfig Androidforworkwificonfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidforworkwificonfiguration.md | Here is a JSON representation of the resource. "connectWhenNetworkNameIsHidden": true, "wiFiSecurityType": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidgeneraldeviceconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidgeneraldeviceconfiguration.md | Here is a JSON representation of the resource. ], "securityRequireVerifyApps": true }-``` +``` |
v1.0 | Intune Deviceconfig Androidimportedpfxcertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidimportedpfxcertificateprofile.md | Inherits from [androidCertificateProfileBase](../resources/intune-deviceconfig-a |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |intendedPurpose|[intendedPurpose](../resources/intune-deviceconfig-intendedpurpose.md)|Intended Purpose of the Certificate Profile - which could be Unassigned, SmimeEncryption, SmimeSigning etc. Possible values are: `unassigned`, `smimeEncryption`, `smimeSigning`, `vpn`, `wifi`.| ## Relationships Here is a JSON representation of the resource. ], "intendedPurpose": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidkeyguardfeature | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidkeyguardfeature.md | Android keyguard feature. |allFeatures|7|All keyguard features when on secure keyguard screens.| |face|8|Face authentication on secure keyguard screens.| |iris|9|Iris authentication on secure keyguard screens.|-|biometrics|10|All biometric authentication on secure keyguard screens.| +|biometrics|10|All biometric authentication on secure keyguard screens.| |
v1.0 | Intune Deviceconfig Androidomacpconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidomacpconfiguration.md | Here is a JSON representation of the resource. "version": 1024, "configurationXml": "binary" }-``` +``` |
v1.0 | Intune Deviceconfig Androidpkcscertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidpkcscertificateprofile.md | Inherits from [androidCertificateProfileBase](../resources/intune-deviceconfig-a |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name| |certificateTemplateName|String|PKCS Certificate Template Name| Here is a JSON representation of the resource. "certificateTemplateName": "String", "subjectAlternativeNameFormatString": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidrequiredpasswordcomplexity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidrequiredpasswordcomplexity.md | The password complexity types that can be set on Android. One of: NONE, LOW, MED |none|0|Device default value, no password.| |low|1|The required password complexity on the device is of type low as defined by the Android documentation.| |medium|2|The required password complexity on the device is of type medium as defined by the Android documentation.|-|high|3|The required password complexity on the device is of type high as defined by the Android documentation.| +|high|3|The required password complexity on the device is of type high as defined by the Android documentation.| |
v1.0 | Intune Deviceconfig Androidrequiredpasswordtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidrequiredpasswordtype.md | Android required password type. |lowSecurityBiometric|4|Low security biometrics based password required.| |numeric|5|Numeric password required.| |numericComplex|6|Numeric complex password required.|-|any|7|A password or pattern is required, and any is acceptable.| +|any|7|A password or pattern is required, and any is acceptable.| |
v1.0 | Intune Deviceconfig Androidsafetynetevaluationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidsafetynetevaluationtype.md | An enum representing the Android Play Integrity API evaluation types. |Member|Value|Description| |:|:|:| |basic|0|Default value. Typical measurements and reference data were used.|-|hardwareBacked|1|Strong Integrity checks (such as a hardware-backed proof of boot integrity) were used.| +|hardwareBacked|1|Strong Integrity checks (such as a hardware-backed proof of boot integrity) were used.| |
v1.0 | Intune Deviceconfig Androidscepcertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidscepcertificateprofile.md | Inherits from [androidCertificateProfileBase](../resources/intune-deviceconfig-a |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |keyUsage|[keyUsages](../resources/intune-shared-keyusages.md)|SCEP Key Usage. Possible values are: `keyEncipherment`, `digitalSignature`.| Here is a JSON representation of the resource. "hashAlgorithm": "String", "subjectAlternativeNameFormatString": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidtrustedrootcertificate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidtrustedrootcertificate.md | Here is a JSON representation of the resource. "trustedRootCertificate": "binary", "certFileName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidusernamesource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidusernamesource.md | Android username source. |username|0|The username.| |userPrincipalName|1|The user principal name.| |samAccountName|2|The user sam account name.|-|primarySmtpAddress|3|Primary SMTP address.| +|primarySmtpAddress|3|Primary SMTP address.| |
v1.0 | Intune Deviceconfig Androidvpnconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidvpnconfiguration.md | Here is a JSON representation of the resource. ], "authenticationMethod": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidvpnconnectiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidvpnconnectiontype.md | Android VPN connection type. |citrix|5|Citrix| |microsoftTunnel|7|Microsoft Tunnel.| |netMotionMobility|8|NetMotion Mobility.|-|microsoftProtect|9|Microsoft Protect.| +|microsoftProtect|9|Microsoft Protect.| |
v1.0 | Intune Deviceconfig Androidwificonfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidwificonfiguration.md | Here is a JSON representation of the resource. "connectWhenNetworkNameIsHidden": true, "wiFiSecurityType": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidwifisecuritytype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidwifisecuritytype.md | Wi-Fi Security Types for Android. |:|:|:| |open|0|Open (No Authentication).| |wpaEnterprise|1|WPA-Enterprise. Must use AndroidEnterpriseWifiConfiguration type to configure enterprise options.|-|wpa2Enterprise|2|WPA2-Enterprise. Must use AndroidEnterpriseWifiConfiguration type to configure enterprise options.| +|wpa2Enterprise|2|WPA2-Enterprise. Must use AndroidEnterpriseWifiConfiguration type to configure enterprise options.| |
v1.0 | Intune Deviceconfig Androidworkprofileaccountuse | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidworkprofileaccountuse.md | An enum representing possible values for account use in work profile. |allowAllExceptGoogleAccounts|0|Allow additon of all accounts except Google accounts in Android Work Profile.| |blockAll|1|Block any account from being added in Android Work Profile. | |allowAll|2|Allow addition of all accounts (including Google accounts) in Android Work Profile.|-|unknownFutureValue|3|Unknown future value for evolvable enum patterns.| +|unknownFutureValue|3|Unknown future value for evolvable enum patterns.| |
v1.0 | Intune Deviceconfig Androidworkprofilecertificateprofilebase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md | Inherits from [deviceConfiguration](../resources/intune-shared-deviceconfigurati |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period.| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| ## Relationships Here is a JSON representation of the resource. ], "subjectAlternativeNameType": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidworkprofilecompliancepolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidworkprofilecompliancepolicy.md | Here is a JSON representation of the resource. "securityRequireCompanyPortalAppIntegrity": true, "securityRequiredAndroidSafetyNetEvaluationType": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidworkprofilecrossprofiledatasharingtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidworkprofilecrossprofiledatasharingtype.md | Android Work Profile cross profile data sharing type. |deviceDefault|0|Device default value, no intent.| |preventAny|1|Prevent any sharing.| |allowPersonalToWork|2|Allow data sharing request from personal profile to work profile.|-|noRestrictions|3|No restrictions on sharing.| +|noRestrictions|3|No restrictions on sharing.| |
v1.0 | Intune Deviceconfig Androidworkprofilecustomconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidworkprofilecustomconfiguration.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Androidworkprofiledefaultapppermissionpolicytype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidworkprofiledefaultapppermissionpolicytype.md | Android Work Profile default app permission policy type. |deviceDefault|0|Device default value, no intent.| |prompt|1|Prompt.| |autoGrant|2|Auto grant.|-|autoDeny|3|Auto deny.| +|autoDeny|3|Auto deny.| |
v1.0 | Intune Deviceconfig Androidworkprofileeasemailprofilebase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidworkprofileeasemailprofilebase.md | Here is a JSON representation of the resource. "requireSsl": true, "usernameSource": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidworkprofileenterprisewificonfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidworkprofileenterprisewificonfiguration.md | Here is a JSON representation of the resource. "proxySettings": "String", "proxyAutomaticConfigurationUrl": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidworkprofilegeneraldeviceconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidworkprofilegeneraldeviceconfiguration.md | Here is a JSON representation of the resource. ], "blockUnifiedPasswordForWorkProfile": true }-``` +``` |
v1.0 | Intune Deviceconfig Androidworkprofilegmaileasconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidworkprofilegmaileasconfiguration.md | Here is a JSON representation of the resource. "requireSsl": true, "usernameSource": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidworkprofilenineworkeasconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidworkprofilenineworkeasconfiguration.md | Here is a JSON representation of the resource. "syncContacts": true, "syncTasks": true }-``` +``` |
v1.0 | Intune Deviceconfig Androidworkprofilepkcscertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidworkprofilepkcscertificateprofile.md | Inherits from [androidWorkProfileCertificateProfileBase](../resources/intune-dev |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name| Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Androidworkprofilerequiredpasswordtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidworkprofilerequiredpasswordtype.md | Android Work Profile required password type. |numericComplex|4|Numeric complex password required.| |atLeastAlphabetic|5|At least alphabetic password required.| |atLeastAlphanumeric|6|At least alphanumeric password required.|-|alphanumericWithSymbols|7|At least alphanumeric with symbols password required.| +|alphanumericWithSymbols|7|At least alphanumeric with symbols password required.| |
v1.0 | Intune Deviceconfig Androidworkprofilescepcertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidworkprofilescepcertificateprofile.md | Inherits from [androidWorkProfileCertificateProfileBase](../resources/intune-dev |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Androidworkprofiletrustedrootcertificate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidworkprofiletrustedrootcertificate.md | Here is a JSON representation of the resource. "trustedRootCertificate": "binary", "certFileName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Androidworkprofilevpnconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidworkprofilevpnconfiguration.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceconfig Androidworkprofilevpnconnectiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidworkprofilevpnconnectiontype.md | Android Work Profile VPN connection type. |paloAltoGlobalProtect|6|Palo Alto Networks GlobalProtect.| |microsoftTunnel|7|Microsoft Tunnel.| |netMotionMobility|8|NetMotion Mobility.|-|microsoftProtect|9|Microsoft Protect.| +|microsoftProtect|9|Microsoft Protect.| |
v1.0 | Intune Deviceconfig Androidworkprofilewificonfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-androidworkprofilewificonfiguration.md | Here is a JSON representation of the resource. "connectWhenNetworkNameIsHidden": true, "wiFiSecurityType": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Aospdeviceownercertificateprofilebase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md | Inherits from [deviceConfiguration](../resources/intune-shared-deviceconfigurati |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. This collection can contain a maximum of 500 elements. Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period.| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. This collection can contain a maximum of 500 elements. Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| ## Relationships Here is a JSON representation of the resource. ], "subjectAlternativeNameType": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Aospdeviceownercompliancepolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-aospdeviceownercompliancepolicy.md | Here is a JSON representation of the resource. "passwordMinimumLength": 1024, "storageRequireEncryption": true }-``` +``` |
v1.0 | Intune Deviceconfig Aospdeviceownerdeviceconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-aospdeviceownerdeviceconfiguration.md | Here is a JSON representation of the resource. "storageBlockUsbFileTransfer": true, "wifiBlockEditConfigurations": true }-``` +``` |
v1.0 | Intune Deviceconfig Aospdeviceownerenterprisewificonfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-aospdeviceownerenterprisewificonfiguration.md | Here is a JSON representation of the resource. "innerAuthenticationProtocolForPeap": "String", "outerIdentityPrivacyTemporaryValue": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Aospdeviceownerpkcscertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-aospdeviceownerpkcscertificateprofile.md | Inherits from [aospDeviceOwnerCertificateProfileBase](../resources/intune-device |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name| Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Aospdeviceownerscepcertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-aospdeviceownerscepcertificateprofile.md | Inherits from [aospDeviceOwnerCertificateProfileBase](../resources/intune-device |subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)| |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Aospdeviceownertrustedrootcertificate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-aospdeviceownertrustedrootcertificate.md | Here is a JSON representation of the resource. "trustedRootCertificate": "binary", "certFileName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Aospdeviceownerwificonfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-aospdeviceownerwificonfiguration.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceconfig Aospdeviceownerwifisecuritytype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-aospdeviceownerwifisecuritytype.md | Wi-Fi Security Types for AOSP Device Owner. |open|0|Open (No Authentication).| |wep|1|WEP Encryption.| |wpaPersonal|2|WPA-Personal/WPA2-Personal.|-|wpaEnterprise|4|WPA-Enterprise/WPA2-Enterprise. Must use AOSPDeviceOwnerEnterpriseWifiConfiguration type to configure enterprise options.| +|wpaEnterprise|4|WPA-Enterprise/WPA2-Enterprise. Must use AOSPDeviceOwnerEnterpriseWifiConfiguration type to configure enterprise options.| |
v1.0 | Intune Deviceconfig Appinstallcontroltype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-appinstallcontroltype.md | App Install control Setting |anywhere|1|Turn off app recommendations| |storeOnly|2|Allow apps from Store only| |recommendations|3|Show me app recommendations|-|preferStore|4|Warn me before installing apps from outside the Store| +|preferStore|4|Warn me before installing apps from outside the Store| |
v1.0 | Intune Deviceconfig Appleapplistitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-appleapplistitem.md | Here is a JSON representation of the resource. "appStoreUrl": "String", "appId": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Appledeploymentchannel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-appledeploymentchannel.md | Indicates the channel used to deploy the configuration profile. Available choice |Member|Value|Description| |:|:|:| |deviceChannel|0|Send payload down over Device Channel.|-|userChannel|1|Send payload down over User Channel.| +|userChannel|1|Send payload down over User Channel.| |
v1.0 | Intune Deviceconfig Appledevicefeaturesconfigurationbase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-appledevicefeaturesconfigurationbase.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Appleexpeditedcheckinconfigurationbase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-appleexpeditedcheckinconfigurationbase.md | Here is a JSON representation of the resource. "version": 1024, "enableExpeditedCheckin": true }-``` +``` |
v1.0 | Intune Deviceconfig Applesubjectnameformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-applesubjectnameformat.md | Subject Name Format Options for Apple devices. |custom|2|Custom subject name format.| |commonNameIncludingEmail|3|Common Name Including Email.| |commonNameAsIMEI|5|Common Name As IMEI.|-|commonNameAsSerialNumber|6|Common Name As Serial Number.| +|commonNameAsSerialNumber|6|Common Name As Serial Number.| |
v1.0 | Intune Deviceconfig Applevpnalwaysonconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-applevpnalwaysonconfiguration.md | Here is a JSON representation of the resource. "natKeepAliveIntervalInSeconds": 1024, "natKeepAliveOffloadEnable": true }-``` +``` |
v1.0 | Intune Deviceconfig Applevpnconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-applevpnconfiguration.md | Here is a JSON representation of the resource. }, "optInToDeviceIdSharing": true }-``` +``` |
v1.0 | Intune Deviceconfig Applevpnconnectiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-applevpnconnectiontype.md | Apple VPN connection type. |alwaysOn|15|AlwaysOn.| |microsoftTunnel|16|Microsoft Tunnel.| |netMotionMobility|17|NetMotion Mobility.|-|microsoftProtect|18|Microsoft Protect.| +|microsoftProtect|18|Microsoft Protect.| |
v1.0 | Intune Deviceconfig Applicationguardblockclipboardsharingtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-applicationguardblockclipboardsharingtype.md | Possible values for applicationGuardBlockClipboardSharingType |blockBoth|1|Block clipboard to share data both from Host to Container and from Container to Host| |blockHostToContainer|2|Block clipboard to share data from Host to Container| |blockContainerToHost|3|Block clipboard to share data from Container to Host|-|blockNone|4|Block clipboard to share data neither from Host to Container nor from Container to Host| +|blockNone|4|Block clipboard to share data neither from Host to Container nor from Container to Host| |
v1.0 | Intune Deviceconfig Applicationguardblockfiletransfertype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-applicationguardblockfiletransfertype.md | Possible values for applicationGuardBlockFileTransfer |blockImageAndTextFile|1|Block clipboard to transfer Image and Text file| |blockImageFile|2|Block clipboard to transfer Image file| |blockNone|3|Neither of text file or image file is blocked from transferring|-|blockTextFile|4|Block clipboard to transfer Text file| +|blockTextFile|4|Block clipboard to transfer Text file| |
v1.0 | Intune Deviceconfig Applicationguardenabledoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-applicationguardenabledoptions.md | Possible values for ApplicationGuardEnabledOptions |notConfigured|0|Not Configured| |enabledForEdge|1|Enabled For Edge| |enabledForOffice|2|Enabled For Office|-|enabledForEdgeAndOffice|3|Enabled For Edge And Office| +|enabledForEdgeAndOffice|3|Enabled For Edge And Office| |
v1.0 | Intune Deviceconfig Applistitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-applistitem.md | Here is a JSON representation of the resource. "appStoreUrl": "String", "appId": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Applisttype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-applisttype.md | Possible values of the compliance app list. |:|:|:| |none|0|Default value, no intent.| |appsInListCompliant|1|The list represents the apps that will be considered compliant (only apps on the list are compliant).|-|appsNotInListCompliant|2|The list represents the apps that will be considered non compliant (all apps are compliant except apps on the list).| +|appsNotInListCompliant|2|The list represents the apps that will be considered non compliant (all apps are compliant except apps on the list).| |
v1.0 | Intune Deviceconfig Applockerapplicationcontroltype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-applockerapplicationcontroltype.md | Possible values of AppLocker Application Control Types |enforceComponentsAndStoreApps|1|Enforce Windows component and store apps.| |auditComponentsAndStoreApps|2|Audit Windows component and store apps.| |enforceComponentsStoreAppsAndSmartlocker|3|Enforce Windows components, store apps and smart locker.|-|auditComponentsStoreAppsAndSmartlocker|4|Audit Windows components, store apps and smart lockerΓÇï.| +|auditComponentsStoreAppsAndSmartlocker|4|Audit Windows components, store apps and smart lockerΓÇï.| |
v1.0 | Intune Deviceconfig Authenticationtransformconstant | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-authenticationtransformconstant.md | Authentication transform values for Windows10 VPN policies with IKEv2 connection |sha_256_128|2|SHA256128| |aes128Gcm|3|GCMAES128| |aes192Gcm|4|GCMAES192|-|aes256Gcm|5|GCMAES256| +|aes256Gcm|5|GCMAES256| |
v1.0 | Intune Deviceconfig Automaticupdatemode | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-automaticupdatemode.md | Possible values for automatic update mode. |autoInstallAndRebootAtMaintenanceTime|3|Auto-install and reboot at maintenance time.| |autoInstallAndRebootAtScheduledTime|4|Auto-install and reboot at scheduled time.| |autoInstallAndRebootWithoutEndUserControl|5|Auto-install and restart without end-user control|-|windowsDefault|6|Reset to Windows default value.| +|windowsDefault|6|Reset to Windows default value.| |
v1.0 | Intune Deviceconfig Autorestartnotificationdismissalmethod | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-autorestartnotificationdismissalmethod.md | Auto restart required notification dismissal method |notConfigured|0|Not configured| |automatic|1|Auto dismissal Indicates that the notification is automatically dismissed without user intervention| |user|2|User dismissal. Allows the user to dismiss the notification|-|unknownFutureValue|3|Evolvable enum member| +|unknownFutureValue|3|Evolvable enum member| |
v1.0 | Intune Deviceconfig Bitlockerencryptionmethod | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-bitlockerencryptionmethod.md | BitLockerEncryptionMethod types |aesCbc128|3|AES-CBC 128-bit.| |aesCbc256|4|AES-CBC 256-bit.| |xtsAes128|6|XTS-AES 128-bit.|-|xtsAes256|7|XTS-AES 256-bit.| +|xtsAes256|7|XTS-AES 256-bit.| |
v1.0 | Intune Deviceconfig Bitlockerfixeddrivepolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-bitlockerfixeddrivepolicy.md | Here is a JSON representation of the resource. "enableBitLockerAfterRecoveryInformationToStore": true } }-``` +``` |
v1.0 | Intune Deviceconfig Bitlockerrecoveryinformationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-bitlockerrecoveryinformationtype.md | BitLockerRecoveryInformationType types |Member|Value|Description| |:|:|:| |passwordAndKey|1|Store recovery passwords and key packages.|-|passwordOnly|2|Store recovery passwords only.| +|passwordOnly|2|Store recovery passwords only.| |
v1.0 | Intune Deviceconfig Bitlockerrecoveryoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-bitlockerrecoveryoptions.md | Here is a JSON representation of the resource. "recoveryInformationToStore": "String", "enableBitLockerAfterRecoveryInformationToStore": true }-``` +``` |
v1.0 | Intune Deviceconfig Bitlockerrecoverypasswordrotationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-bitlockerrecoverypasswordrotationtype.md | BitLocker recovery password rotation type |notConfigured|0|Not configured| |disabled|1|Recovery password rotation off| |enabledForAzureAd|2|Recovery password rotation on for Azure AD joined devices|-|enabledForAzureAdAndHybrid|3|Recovery password rotation on for both Azure AD joined and hybrid joined devices| +|enabledForAzureAdAndHybrid|3|Recovery password rotation on for both Azure AD joined and hybrid joined devices| |
v1.0 | Intune Deviceconfig Bitlockerremovabledrivepolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-bitlockerremovabledrivepolicy.md | Here is a JSON representation of the resource. "requireEncryptionForWriteAccess": true, "blockCrossOrganizationWriteAccess": true }-``` +``` |
v1.0 | Intune Deviceconfig Bitlockersystemdrivepolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-bitlockersystemdrivepolicy.md | Here is a JSON representation of the resource. "prebootRecoveryMessage": "String", "prebootRecoveryUrl": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Browsersyncsetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-browsersyncsetting.md | Allow(Not Configured) or prevent(Block) the syncing of Microsoft Edge Browser se |:|:|:| |notConfigured|0|Default ΓÇô Allow syncing of browser settings across devices.| |blockedWithUserOverride|1|Prevent syncing of browser settings across user devices, allow user override of setting.|-|blocked|2|Absolutely prevent syncing of browser settings across user devices.| +|blocked|2|Absolutely prevent syncing of browser settings across user devices.| |
v1.0 | Intune Deviceconfig Carttoclassassociation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-carttoclassassociation.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceconfig Certificateissuancestates | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-certificateissuancestates.md | Certificate Issuance State Options. |deleteFailed|19|| |deleted|20|| |renewalRequested|21||-|requested|22|| +|requested|22|| |
v1.0 | Intune Deviceconfig Certificaterevocationstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-certificaterevocationstatus.md | Certificate Revocation Status. |pending|1|Revocation pending.| |issued|2|Revocation command issued.| |failed|3|Revocation failed.|-|revoked|4|Revoked.| +|revoked|4|Revoked.| |
v1.0 | Intune Deviceconfig Changeuefisettingspermission | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-changeuefisettingspermission.md | Defines the permission level granted to users to enable them change Uefi setting |Member|Value|Description| |:|:|:| |notConfiguredOnly|0|Device default value, no intent.|-|none|1|Prevent change of UEFI setting permission| +|none|1|Prevent change of UEFI setting permission| |
v1.0 | Intune Deviceconfig Code | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-code.md | Error code for rule validation. |duplicateLocales|28|Duplicate locales error.| |unrecognizedLocale|29|Unrecognized locale error.| |unknown|30|Unknown error.|-|remediationStringsMissing|31|Remediation strings missing error.| +|remediationStringsMissing|31|Remediation strings missing error.| |
v1.0 | Intune Deviceconfig Configurationusage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-configurationusage.md | Possible values of the ConfigurationUsage list. |blocked|0|Disallowed.| |required|1|Required.| |allowed|2|Optional.|-|notConfigured|3|Not Configured.| +|notConfigured|3|Not Configured.| |
v1.0 | Intune Deviceconfig Credentialsinglesignonextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-credentialsinglesignonextension.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Cryptographysuite | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-cryptographysuite.md | Here is a JSON representation of the resource. "authenticationTransformConstants": "String", "pfsGroup": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Customsubjectalternativename | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-customsubjectalternativename.md | Here is a JSON representation of the resource. "sanType": "String", "name": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Customupdatetimewindow | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-customupdatetimewindow.md | Here is a JSON representation of the resource. "startTime": "String (time of day)", "endTime": "String (time of day)" }-``` +``` |
v1.0 | Intune Deviceconfig Datatype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-datatype.md | Data types for rules. |doubleArray|11|Double array data type.| |stringArray|12|String array data type.| |dateTimeArray|13|DateTime array data type.|-|versionArray|14|Version array data type.| +|versionArray|14|Version array data type.| |
v1.0 | Intune Deviceconfig Dayofweek | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-dayofweek.md | Possible values for a weekday |wednesday|3|Wednesday.| |thursday|4|Thursday.| |friday|5|Friday.|-|saturday|6|Saturday.| +|saturday|6|Saturday.| |
v1.0 | Intune Deviceconfig Defaultdevicecompliancepolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-defaultdevicecompliancepolicy.md | Here is a JSON representation of the resource. "displayName": "String", "version": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Defenderattacksurfacetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-defenderattacksurfacetype.md | Possible values of Defender Attack Surface Reduction Rules |block|1|Enable the attack surface reduction rule.| |auditMode|2|Evaluate how the ASR rule would impact your organization if enabled. Does not change functionality but generate logs.| |warn|6|Warning message to end user with ability to bypass block from attack surface reduction rule.|-|disable|99|Disable the attack surface reduction rule| +|disable|99|Disable the attack surface reduction rule| |
v1.0 | Intune Deviceconfig Defendercloudblockleveltype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-defendercloudblockleveltype.md | Possible values of Cloud Block Level |notConfigured|0|Default value, uses the default Windows Defender Antivirus blocking level and provides strong detection without increasing the risk of detecting legitimate files| |high|1|High applies a strong level of detection.| |highPlus|2|High + uses the High level and applies addition protection measures|-|zeroTolerance|3|Zero tolerance blocks all unknown executables| +|zeroTolerance|3|Zero tolerance blocks all unknown executables| |
v1.0 | Intune Deviceconfig Defenderdetectedmalwareactions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-defenderdetectedmalwareactions.md | Here is a JSON representation of the resource. "highSeverity": "String", "severeSeverity": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Defendermonitorfileactivity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-defendermonitorfileactivity.md | Possible values for monitoring file activity. |disable|1|Disable monitoring file activity.| |monitorAllFiles|2|Monitor all files.| |monitorIncomingFilesOnly|3| Monitor incoming files only.|-|monitorOutgoingFilesOnly|4|Monitor outgoing files only.| +|monitorOutgoingFilesOnly|4|Monitor outgoing files only.| |
v1.0 | Intune Deviceconfig Defenderpotentiallyunwantedappaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-defenderpotentiallyunwantedappaction.md | DefenderΓÇÖs action to take on detected Potentially Unwanted Application (PUA). |:|:|:| |deviceDefault|0|PUA Protection is off. Defender will not protect against potentially unwanted applications.| |block|1|PUA Protection is on. Detected items are blocked. They will show in history along with other threats.|-|audit|2|Audit mode. Defender will detect potentially unwanted applications, but take no actions. You can review information about applications Defender would have taken action against by searching for events created by Defender in the Event Viewer.| +|audit|2|Audit mode. Defender will detect potentially unwanted applications, but take no actions. You can review information about applications Defender would have taken action against by searching for events created by Defender in the Event Viewer.| |
v1.0 | Intune Deviceconfig Defenderpromptforsamplesubmission | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-defenderpromptforsamplesubmission.md | Possible values for prompting user for samples submission. |alwaysPrompt|1|Always prompt.| |promptBeforeSendingPersonalData|2|Send safe samples automatically.| |neverSendData|3|Never send data.|-|sendAllDataWithoutPrompting|4|Send all data without prompting.| +|sendAllDataWithoutPrompting|4|Send all data without prompting.| |
v1.0 | Intune Deviceconfig Defenderprotectiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-defenderprotectiontype.md | Possible values of Defender PUA Protection |enable|1|Block functionality.| |auditMode|2|Allow functionality but generate logs.| |warn|6|Warning message to end user with ability to bypass block from attack surface reduction rule.|-|notConfigured|99|Not configured.| +|notConfigured|99|Not configured.| |
v1.0 | Intune Deviceconfig Defenderrealtimescandirection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-defenderrealtimescandirection.md | Possible values for monitoring file activity. |:|:|:| |monitorAllFiles|0|0 (default) ΓÇô Monitor all files(bi-directional)| |monitorIncomingFilesOnly|1|Monitor incoming files only.|-|monitorOutgoingFilesOnly|2|Monitor outgoing files only.| +|monitorOutgoingFilesOnly|2|Monitor outgoing files only.| |
v1.0 | Intune Deviceconfig Defenderscantype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-defenderscantype.md | Possible values for system scan type. |userDefined|0|User Defined, default value, no intent.| |disabled|1|System scan disabled.| |quick|2|Quick system scan.|-|full|3|Full system scan.| +|full|3|Full system scan.| |
v1.0 | Intune Deviceconfig Defendersecuritycenteritcontactdisplaytype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-defendersecuritycenteritcontactdisplaytype.md | Possible values for defenderSecurityCenterITContactDisplay |notConfigured|0|Not Configured| |displayInAppAndInNotifications|1|Display in app and in notifications| |displayOnlyInApp|2|Display only in app|-|displayOnlyInNotifications|3|Display only in notifications| +|displayOnlyInNotifications|3|Display only in notifications| |
v1.0 | Intune Deviceconfig Defendersecuritycenternotificationsfromapptype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-defendersecuritycenternotificationsfromapptype.md | Possible values for defenderSecurityCenterNotificationsFromApp |:|:|:| |notConfigured|0|Not Configured| |blockNoncriticalNotifications|1|Block non-critical notifications|-|blockAllNotifications|2|Block all notifications| +|blockAllNotifications|2|Block all notifications| |
v1.0 | Intune Deviceconfig Defendersubmitsamplesconsenttype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-defendersubmitsamplesconsenttype.md | Possible values for DefenderSubmitSamplesConsentType |sendSafeSamplesAutomatically|0|Send safe samples automatically| |alwaysPrompt|1|Always prompt| |neverSend|2|Never send|-|sendAllSamplesAutomatically|3|Send all samples automatically| +|sendAllSamplesAutomatically|3|Send all samples automatically| |
v1.0 | Intune Deviceconfig Defenderthreataction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-defenderthreataction.md | DefenderΓÇÖs default action to take on detected Malware threats. |remove|3|Remove the detected threat.| |allow|4|Allow the detected threat.| |userDefined|5|Allow the user to determine the action to take with the detected threat.|-|block|6|Block the detected threat.| +|block|6|Block the detected threat.| |
v1.0 | Intune Deviceconfig Deliveryoptimizationbandwidth | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deliveryoptimizationbandwidth.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.deliveryOptimizationBandwidth" }-``` +``` |
v1.0 | Intune Deviceconfig Deliveryoptimizationbandwidthabsolute | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deliveryoptimizationbandwidthabsolute.md | Here is a JSON representation of the resource. "maximumDownloadBandwidthInKilobytesPerSecond": 1024, "maximumUploadBandwidthInKilobytesPerSecond": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Deliveryoptimizationbandwidthbusinesshourslimit | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deliveryoptimizationbandwidthbusinesshourslimit.md | Here is a JSON representation of the resource. "bandwidthPercentageDuringBusinessHours": 1024, "bandwidthPercentageOutsideBusinessHours": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Deliveryoptimizationbandwidthhourswithpercentage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deliveryoptimizationbandwidthhourswithpercentage.md | Here is a JSON representation of the resource. "bandwidthPercentageOutsideBusinessHours": 1024 } }-``` +``` |
v1.0 | Intune Deviceconfig Deliveryoptimizationbandwidthpercentage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deliveryoptimizationbandwidthpercentage.md | Here is a JSON representation of the resource. "maximumBackgroundBandwidthPercentage": 1024, "maximumForegroundBandwidthPercentage": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Deliveryoptimizationgroupidcustom | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deliveryoptimizationgroupidcustom.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deliveryOptimizationGroupIdCustom", "groupIdCustom": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Deliveryoptimizationgroupidoptionstype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deliveryoptimizationgroupidoptionstype.md | Possible values for the DeliveryOptimizationGroupIdOptionsType setting. |adSite|1|Active Directory site.| |authenticatedDomainSid|2|Authenticated domain SID.| |dhcpUserOption|3|DHCP user option.|-|dnsSuffix|4|DNS suffix.| +|dnsSuffix|4|DNS suffix.| |
v1.0 | Intune Deviceconfig Deliveryoptimizationgroupidsource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deliveryoptimizationgroupidsource.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.deliveryOptimizationGroupIdSource" }-``` +``` |
v1.0 | Intune Deviceconfig Deliveryoptimizationgroupidsourceoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deliveryoptimizationgroupidsourceoptions.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deliveryOptimizationGroupIdSourceOptions", "groupIdSourceOption": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Deliveryoptimizationmaxcachesize | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deliveryoptimizationmaxcachesize.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.deliveryOptimizationMaxCacheSize" }-``` +``` |
v1.0 | Intune Deviceconfig Deliveryoptimizationmaxcachesizeabsolute | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deliveryoptimizationmaxcachesizeabsolute.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deliveryOptimizationMaxCacheSizeAbsolute", "maximumCacheSizeInGigabytes": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Deliveryoptimizationmaxcachesizepercentage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deliveryoptimizationmaxcachesizepercentage.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deliveryOptimizationMaxCacheSizePercentage", "maximumCacheSizePercentage": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Deliveryoptimizationrestrictpeerselectionbyoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deliveryoptimizationrestrictpeerselectionbyoptions.md | Values to restrict peer selection by. |Member|Value|Description| |:|:|:| |notConfigured|0|Not configured.|-|subnetMask|1|Subnet mask.| +|subnetMask|1|Subnet mask.| |
v1.0 | Intune Deviceconfig Derivedcredentialprovidertype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-derivedcredentialprovidertype.md | Provider type for Derived Credentials. |entrustDataCard|1|Entrust.| |purebred|2|Purebred - Defense Information Systems Agency.| |xTec|3|Xtec - AuthentX.|-|intercede|4|Intercede.| +|intercede|4|Intercede.| |
v1.0 | Intune Deviceconfig Devicecomplianceactionitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicecomplianceactionitem.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceconfig Devicecomplianceactiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicecomplianceactiontype.md | Scheduled Action Type Enum |wipe|4|Wipe the device| |removeResourceAccessProfiles|5|Remove Resource Access Profiles from the device| |pushNotification|9|Send push notification to device|-|remoteLock|10|Remotely lock the device| +|remoteLock|10|Remotely lock the device| |
v1.0 | Intune Deviceconfig Devicecompliancedeviceoverview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicecompliancedeviceoverview.md | Here is a JSON representation of the resource. "lastUpdateDateTime": "String (timestamp)", "configurationVersion": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Devicecompliancedevicestatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicecompliancedevicestatus.md | Here is a JSON representation of the resource. "lastReportedDateTime": "String (timestamp)", "userPrincipalName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Devicecompliancepolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicecompliancepolicy.md | This is the base class for Compliance policy. Compliance policies are platform s ## Methods |Method|Return Type|Description| |:|:|:|-|[List deviceCompliancePolicies](../api/intune-deviceconfig-devicecompliancepolicy-list.md)|[deviceCompliancePolicy](../resources/intune-deviceconfig-devicecompliancepolicy.md) collection|List properties and relationships of the [deviceCompliancePolicy](../resources/intune-deviceconfig-devicecompliancepolicy.md) objects.| -|[Get deviceCompliancePolicy](../api/intune-deviceconfig-devicecompliancepolicy-get.md)|[deviceCompliancePolicy](../resources/intune-deviceconfig-devicecompliancepolicy.md)|Read properties and relationships of the [deviceCompliancePolicy](../resources/intune-deviceconfig-devicecompliancepolicy.md) object.| +|[List deviceCompliancePolicies](../api/intune-deviceconfig-devicecompliancepolicy-list.md)|[deviceCompliancePolicy](../resources/intune-shared-devicecompliancepolicy.md) collection|List properties and relationships of the [deviceCompliancePolicy](../resources/intune-shared-devicecompliancepolicy.md) objects.| +|[Get deviceCompliancePolicy](../api/intune-deviceconfig-devicecompliancepolicy-get.md)|[deviceCompliancePolicy](../resources/intune-shared-devicecompliancepolicy.md)|Read properties and relationships of the [deviceCompliancePolicy](../resources/intune-shared-devicecompliancepolicy.md) object.| |[assign action](../api/intune-deviceconfig-devicecompliancepolicy-assign.md)|[deviceCompliancePolicyAssignment](../resources/intune-deviceconfig-devicecompliancepolicyassignment.md) collection|| |[validateComplianceScript action](../api/intune-deviceconfig-devicecompliancepolicy-validatecompliancescript.md)|[deviceComplianceScriptValidationResult](../resources/intune-deviceconfig-devicecompliancescriptvalidationresult.md)|| |[scheduleActionsForRules action](../api/intune-deviceconfig-devicecompliancepolicy-scheduleactionsforrules.md)|None|| Here is a JSON representation of the resource. "displayName": "String", "version": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Devicecompliancepolicyassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicecompliancepolicyassignment.md | Here is a JSON representation of the resource. "source": "String", "sourceId": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Devicecompliancepolicydevicestatesummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicecompliancepolicydevicestatesummary.md | Here is a JSON representation of the resource. "errorDeviceCount": 1024, "conflictDeviceCount": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Devicecompliancepolicyscript | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicecompliancepolicyscript.md | Here is a JSON representation of the resource. "deviceComplianceScriptId": "String", "rulesContent": "binary" }-``` +``` |
v1.0 | Intune Deviceconfig Devicecompliancepolicysettingstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicecompliancepolicysettingstate.md | Here is a JSON representation of the resource. "currentValue": "String", "settingInstanceId": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Devicecompliancepolicysettingstatesummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicecompliancepolicysettingstatesummary.md | Here is a JSON representation of the resource. "errorDeviceCount": 1024, "conflictDeviceCount": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Devicecompliancescheduledactionforrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicecompliancescheduledactionforrule.md | Here is a JSON representation of the resource. "id": "String (identifier)", "ruleName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Devicecompliancescripterror | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicecompliancescripterror.md | Here is a JSON representation of the resource. "deviceComplianceScriptRulesValidationError": "String", "message": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Devicecompliancescriptrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicecompliancescriptrule.md | Here is a JSON representation of the resource. "deviceComplianceScriptRuleDataType": "String", "operand": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Devicecompliancescriptruledatatype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicecompliancescriptruledatatype.md | Data types for rules. |doubleArray|11|Double array data type.| |stringArray|12|String array data type.| |dateTimeArray|13|DateTime array data type.|-|versionArray|14|Version array data type.| +|versionArray|14|Version array data type.| |
v1.0 | Intune Deviceconfig Devicecompliancescriptruleerror | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicecompliancescriptruleerror.md | Here is a JSON representation of the resource. "message": "String", "settingName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Devicecompliancescriptrulesvalidationerror | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicecompliancescriptrulesvalidationerror.md | Error code for rule validation. |duplicateLocales|28|Duplicate locales error.| |unrecognizedLocale|29|Unrecognized locale error.| |unknown|30|Unknown error.|-|remediationStringsMissing|31|Remediation strings missing error.| +|remediationStringsMissing|31|Remediation strings missing error.| |
v1.0 | Intune Deviceconfig Devicecompliancescriptruloperator | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicecompliancescriptruloperator.md | Operator for rules. |setEquals|21|SetEquals operator.| |orderedSetEquals|22|OrderedSetEquals operator.| |subsetOf|23|SubsetOf operator.|-|excludesAll|24|ExcludesAll operator.| +|excludesAll|24|ExcludesAll operator.| |
v1.0 | Intune Deviceconfig Devicecompliancescriptvalidationresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicecompliancescriptvalidationresult.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Devicecompliancesettingstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicecompliancesettingstate.md | Here is a JSON representation of the resource. "state": "String", "complianceGracePeriodExpirationDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Deviceconfig Devicecomplianceuseroverview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicecomplianceuseroverview.md | Here is a JSON representation of the resource. "lastUpdateDateTime": "String (timestamp)", "configurationVersion": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Devicecomplianceuserstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicecomplianceuserstatus.md | Here is a JSON representation of the resource. "lastReportedDateTime": "String (timestamp)", "userPrincipalName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Deviceconfigassignmentintent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deviceconfigassignmentintent.md | The administrator intent for the assignment of the profile. |Member|Value|Description| |:|:|:| |apply|0|Ensure that the configuration profile is applied to the devices in the assignment.|-|remove|1|Ensure that the configuration profile is removed from devices that have previously installed the configuration profile.| +|remove|1|Ensure that the configuration profile is removed from devices that have previously installed the configuration profile.| |
v1.0 | Intune Deviceconfig Deviceconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deviceconfiguration.md | Device Configuration. ## Methods |Method|Return Type|Description| |:|:|:|-|[List deviceConfigurations](../api/intune-deviceconfig-deviceconfiguration-list.md)|[deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md) collection|List properties and relationships of the [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md) objects.| -|[Get deviceConfiguration](../api/intune-deviceconfig-deviceconfiguration-get.md)|[deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|Read properties and relationships of the [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md) object.| +|[List deviceConfigurations](../api/intune-deviceconfig-deviceconfiguration-list.md)|[deviceConfiguration](../resources/intune-shared-deviceconfiguration.md) collection|List properties and relationships of the [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md) objects.| +|[Get deviceConfiguration](../api/intune-deviceconfig-deviceconfiguration-get.md)|[deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|Read properties and relationships of the [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md) object.| |[assign action](../api/intune-deviceconfig-deviceconfiguration-assign.md)|[deviceConfigurationAssignment](../resources/intune-deviceconfig-deviceconfigurationassignment.md) collection|| |[getOmaSettingPlainTextValue function](../api/intune-deviceconfig-deviceconfiguration-getomasettingplaintextvalue.md)|String|| |[windowsPrivacyAccessControls action](../api/intune-deviceconfig-deviceconfiguration-windowsprivacyaccesscontrols.md)|None|| Here is a JSON representation of the resource. "displayName": "String", "version": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Deviceconfigurationassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deviceconfigurationassignment.md | Here is a JSON representation of the resource. "sourceId": "String", "intent": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Deviceconfigurationconflictsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deviceconfigurationconflictsummary.md | Here is a JSON representation of the resource. ], "deviceCheckinsImpacted": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Deviceconfigurationdeviceoverview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deviceconfigurationdeviceoverview.md | Here is a JSON representation of the resource. "lastUpdateDateTime": "String (timestamp)", "configurationVersion": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Deviceconfigurationdevicestatesummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deviceconfigurationdevicestatesummary.md | Here is a JSON representation of the resource. "errorDeviceCount": 1024, "conflictDeviceCount": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Deviceconfigurationdevicestatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deviceconfigurationdevicestatus.md | Here is a JSON representation of the resource. "lastReportedDateTime": "String (timestamp)", "userPrincipalName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Deviceconfigurationgroupassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deviceconfigurationgroupassignment.md | Here is a JSON representation of the resource. "targetGroupId": "String", "excludeGroup": true }-``` +``` |
v1.0 | Intune Deviceconfig Deviceconfigurationsettingstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deviceconfigurationsettingstate.md | Here is a JSON representation of the resource. "currentValue": "String", "settingInstanceId": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Deviceconfigurationtargeteduseranddevice | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deviceconfigurationtargeteduseranddevice.md | Here is a JSON representation of the resource. "userPrincipalName": "String", "lastCheckinDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Deviceconfig Deviceconfigurationuseroverview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deviceconfigurationuseroverview.md | Here is a JSON representation of the resource. "lastUpdateDateTime": "String (timestamp)", "configurationVersion": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Deviceconfigurationuserstatesummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deviceconfigurationuserstatesummary.md | Here is a JSON representation of the resource. "errorUserCount": 1024, "conflictUserCount": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Deviceconfigurationuserstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deviceconfigurationuserstatus.md | Here is a JSON representation of the resource. "lastReportedDateTime": "String (timestamp)", "userPrincipalName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Deviceguardlocalsystemauthoritycredentialguardtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deviceguardlocalsystemauthoritycredentialguardtype.md | Possible values of Credential Guard settings. |notConfigured|0|Turns off Credential Guard remotely if configured previously without UEFI Lock.| |enableWithUEFILock|1|Turns on Credential Guard with UEFI lock.| |enableWithoutUEFILock|2|Turns on Credential Guard without UEFI lock.|-|disable|3|Disables Credential Guard. This is the default OS value.| +|disable|3|Disables Credential Guard. This is the default OS value.| |
v1.0 | Intune Deviceconfig Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicemanagement.md | + + Title: "deviceManagement resource type" +description: "Singleton entity that acts as a container for all device management functionality." ++localization_priority: Normal ++++# deviceManagement resource type ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. ++Singleton entity that acts as a container for all device management functionality. ++## Methods +|Method|Return Type|Description| +|:|:|:| +|[Get deviceManagement](../api/intune-deviceconfig-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-deviceconfig-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[enableUnlicensedAdminstrators action](../api/intune-deviceconfig-devicemanagement-enableunlicensedadminstrators.md)|None|Upon enabling, users assigned as administrators via Role Assignment Memberships will no longer require an assigned Intune license. You are limited to 350 unlicensed direct members for each AAD security group in a role assignment, but you can assign multiple AAD security groups to a role if you need to support more than 350 unlicensed administrators. Licensed administrators will continue to function as-is in that transitive memberships apply and are not subject to the 350 member limit.| +|[enableLegacyPcManagement action](../api/intune-deviceconfig-devicemanagement-enablelegacypcmanagement.md)|None|| +|[enableAndroidDeviceAdministratorEnrollment action](../api/intune-deviceconfig-devicemanagement-enableandroiddeviceadministratorenrollment.md)|None|| +|[enableEndpointPrivilegeManagement action](../api/intune-deviceconfig-devicemanagement-enableendpointprivilegemanagement.md)|None|Triggers onboarding of tenant to Microsoft Managed Platform - Cloud (MMP-C).| ++## Properties +|Property|Type|Description| +|:|:|:| +|id|String|Unique Identifier| +|settings|[deviceManagementSettings](../resources/intune-deviceconfig-devicemanagementsettings.md)|Account level settings.| +|maximumDepTokens|Int32|Maximum number of dep tokens allowed per-tenant.| +|intuneAccountId|Guid|Intune Account Id for given tenant| +|lastReportAggregationDateTime|DateTimeOffset|The last modified time of reporting for this account. This property is read-only.| +|deviceComplianceReportSummarizationDateTime|DateTimeOffset|The last requested time of device compliance reporting for this account. This property is read-only.| +|legacyPcManangementEnabled|Boolean|The property to enable Non-MDM managed legacy PC management for this account. This property is read-only.| +|unlicensedAdminstratorsEnabled|Boolean|When enabled, users assigned as administrators via Role Assignment Memberships do not require an assigned Intune license. Prior to this, only Intune licensed users were granted permissions with an Intune role unless they were assigned a role via Azure Active Directory. You are limited to 350 unlicensed direct members for each AAD security group in a role assignment, but you can assign multiple AAD security groups to a role if you need to support more than 350 unlicensed administrators. Licensed administrators are unaffected, do not have to be direct members, nor does the 350 member limit apply. This property is read-only.| ++## Relationships +|Relationship|Type|Description| +|:|:|:| +|deviceConfigurations|[deviceConfiguration](../resources/intune-shared-deviceconfiguration.md) collection|The device configurations.| +|deviceCompliancePolicies|[deviceCompliancePolicy](../resources/intune-shared-devicecompliancepolicy.md) collection|The device compliance policies.| +|softwareUpdateStatusSummary|[softwareUpdateStatusSummary](../resources/intune-deviceconfig-softwareupdatestatussummary.md)|The software update status summary.| +|deviceCompliancePolicyDeviceStateSummary|[deviceCompliancePolicyDeviceStateSummary](../resources/intune-deviceconfig-devicecompliancepolicydevicestatesummary.md)|The device compliance state summary for this account.| +|deviceCompliancePolicySettingStateSummaries|[deviceCompliancePolicySettingStateSummary](../resources/intune-deviceconfig-devicecompliancepolicysettingstatesummary.md) collection|The summary states of compliance policy settings for this account.| +|advancedThreatProtectionOnboardingStateSummary|[advancedThreatProtectionOnboardingStateSummary](../resources/intune-deviceconfig-advancedthreatprotectiononboardingstatesummary.md)|The summary state of ATP onboarding state for this account.| +|deviceConfigurationDeviceStateSummaries|[deviceConfigurationDeviceStateSummary](../resources/intune-deviceconfig-deviceconfigurationdevicestatesummary.md)|The device configuration device state summary for this account.| +|deviceConfigurationUserStateSummaries|[deviceConfigurationUserStateSummary](../resources/intune-deviceconfig-deviceconfigurationuserstatesummary.md)|The device configuration user state summary for this account.| +|cartToClassAssociations|[cartToClassAssociation](../resources/intune-deviceconfig-carttoclassassociation.md) collection|The Cart To Class Associations.| +|iosUpdateStatuses|[iosUpdateDeviceStatus](../resources/intune-deviceconfig-iosupdatedevicestatus.md) collection|The IOS software update installation statuses for this account.| +|ndesConnectors|[ndesConnector](../resources/intune-deviceconfig-ndesconnector.md) collection|The collection of Ndes connectors for this account.| +|deviceConfigurationRestrictedAppsViolations|[restrictedAppsViolation](../resources/intune-deviceconfig-restrictedappsviolation.md) collection|Restricted apps violations for this account.| +|managedDeviceEncryptionStates|[managedDeviceEncryptionState](../resources/intune-deviceconfig-manageddeviceencryptionstate.md) collection|Encryption report for devices in this account| +|deviceConfigurationConflictSummary|[deviceConfigurationConflictSummary](../resources/intune-deviceconfig-deviceconfigurationconflictsummary.md) collection|Summary of policies in conflict state for this account.| +|deviceConfigurationsAllManagedDeviceCertificateStates|[managedAllDeviceCertificateState](../resources/intune-deviceconfig-managedalldevicecertificatestate.md) collection|Summary of all certificates for all devices.| +|macOSSoftwareUpdateAccountSummaries|[macOSSoftwareUpdateAccountSummary](../resources/intune-deviceconfig-macossoftwareupdateaccountsummary.md) collection|The MacOS software update account summaries for this account.| +|hardwareConfigurations|[hardwareConfiguration](../resources/intune-deviceconfig-hardwareconfiguration.md) collection|The hardware configurations for this account.| +|hardwarePasswordInfo|[hardwarePasswordInfo](../resources/intune-deviceconfig-hardwarepasswordinfo.md) collection|The hardware password info for this account.| ++## JSON Representation +Here is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.deviceManagement" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.deviceManagement", + "id": "String (identifier)", + "settings": { + "@odata.type": "microsoft.graph.deviceManagementSettings", + "deviceComplianceCheckinThresholdDays": 1024, + "isScheduledActionEnabled": true, + "secureByDefault": true, + "enhancedJailBreak": true, + "deviceInactivityBeforeRetirementInDay": 1024, + "derivedCredentialProvider": "String", + "derivedCredentialUrl": "String", + "androidDeviceAdministratorEnrollmentEnabled": true, + "ignoreDevicesForUnsupportedSettingsEnabled": true, + "enableLogCollection": true, + "enableAutopilotDiagnostics": true, + "enableEnhancedTroubleshootingExperience": true, + "enableDeviceGroupMembershipReport": true, + "m365AppDiagnosticsEnabled": true + }, + "maximumDepTokens": 1024, + "intuneAccountId": "Guid", + "lastReportAggregationDateTime": "String (timestamp)", + "deviceComplianceReportSummarizationDateTime": "String (timestamp)", + "legacyPcManangementEnabled": true, + "unlicensedAdminstratorsEnabled": true +} +``` |
v1.0 | Intune Deviceconfig Devicemanagementapplicabilityruledevicemode | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicemanagementapplicabilityruledevicemode.md | Here is a JSON representation of the resource. "name": "String", "ruleType": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Devicemanagementapplicabilityruleosedition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicemanagementapplicabilityruleosedition.md | Here is a JSON representation of the resource. "name": "String", "ruleType": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Devicemanagementapplicabilityruleosversion | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicemanagementapplicabilityruleosversion.md | Here is a JSON representation of the resource. "name": "String", "ruleType": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Devicemanagementapplicabilityruletype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicemanagementapplicabilityruletype.md | Supported Applicability rule types for Device Configuration |Member|Value|Description| |:|:|:| |include|0|Include|-|exclude|1|Exclude| +|exclude|1|Exclude| |
v1.0 | Intune Deviceconfig Devicemanagementcertificationauthority | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicemanagementcertificationauthority.md | Device Management Certification Authority Types. |:|:|:| |notConfigured|0|Not configured.| |microsoft|1|Microsoft Certification Authority type.|-|digiCert|2|DigiCert Certification Authority type.| +|digiCert|2|DigiCert Certification Authority type.| |
v1.0 | Intune Deviceconfig Devicemanagementderivedcredentialsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicemanagementderivedcredentialsettings.md | Namespace: microsoft.graph ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagementDerivedCredentialSettings](../api/intune-deviceconfig-devicemanagementderivedcredentialsettings-get.md)|[deviceManagementDerivedCredentialSettings](../resources/intune-deviceconfig-devicemanagementderivedcredentialsettings.md)|Read properties and relationships of the [deviceManagementDerivedCredentialSettings](../resources/intune-deviceconfig-devicemanagementderivedcredentialsettings.md) object.| -|[Update deviceManagementDerivedCredentialSettings](../api/intune-deviceconfig-devicemanagementderivedcredentialsettings-update.md)|[deviceManagementDerivedCredentialSettings](../resources/intune-deviceconfig-devicemanagementderivedcredentialsettings.md)|Update the properties of a [deviceManagementDerivedCredentialSettings](../resources/intune-deviceconfig-devicemanagementderivedcredentialsettings.md) object.| +|[Get deviceManagementDerivedCredentialSettings](../api/intune-deviceconfig-devicemanagementderivedcredentialsettings-get.md)|[deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md)|Read properties and relationships of the [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) object.| +|[Update deviceManagementDerivedCredentialSettings](../api/intune-deviceconfig-devicemanagementderivedcredentialsettings-update.md)|[deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md)|Update the properties of a [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagementDerivedCredentialSettings", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Deviceconfig Devicemanagementsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicemanagementsettings.md | Here is a JSON representation of the resource. "enableDeviceGroupMembershipReport": true, "m365AppDiagnosticsEnabled": true }-``` +``` |
v1.0 | Intune Deviceconfig Devicemanagementuserrightslocaluserorgroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicemanagementuserrightslocaluserorgroup.md | Here is a JSON representation of the resource. "description": "String", "securityIdentifier": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Devicemanagementuserrightssetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicemanagementuserrightssetting.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Deviceplatformtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-deviceplatformtype.md | Supported platform types. |androidMobileApplicationManagement|10|Indicates device platform type associated with Mobile Application Management (MAM) for android devices.| |iOSMobileApplicationManagement|11|Indicates device platform type associated with Mobile Application Management (MAM) for iOS devices.| |unknownFutureValue|12|Evolvable enumeration sentinel value. Do not use.|-|windowsMobileApplicationManagement|13|Indicates device platform type associated with Mobile Application Management (MAM) for Windows devices.| +|windowsMobileApplicationManagement|13|Indicates device platform type associated with Mobile Application Management (MAM) for Windows devices.| |
v1.0 | Intune Deviceconfig Devicethreatprotectionlevel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicethreatprotectionlevel.md | Device threat protection levels for the Device Threat Protection API. |low|2|Device Threat Protection level requirement: Low. Low represents a severity of threat that poses minimal risk to the device or device data.| |medium|3|Device Threat Protection level requirement: Medium. Medium represents a severity of threat that poses moderate risk to the device or device data.| |high|4|Device Threat Protection level requirement: High. High represents a severity of threat that poses severe risk to the device or device data.|-|notSet|10|Device Threat Protection level requirement: Not Set. Not set represents that there is no requirement for the device to meet a Threat Protection level.| +|notSet|10|Device Threat Protection level requirement: Not Set. Not set represents that there is no requirement for the device to meet a Threat Protection level.| |
v1.0 | Intune Deviceconfig Devicetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicetype.md | Device type. |blackberry|100|Blackberry.| |palm|101|Palm.| |unknown|255|Represents that the device type is unknown.|-|cloudPC|257|Cloud PC device.| +|cloudPC|257|Cloud PC device.| |
v1.0 | Intune Deviceconfig Devicetypes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-devicetypes.md | Device type. |androidEnterprise|18|Android enterprise device.| |blackberry|100|Blackberry.| |palm|101|Palm.|-|unknown|255|Represents that the device type is unknown.| +|unknown|255|Represents that the device type is unknown.| |
v1.0 | Intune Deviceconfig Diagnosticdatasubmissionmode | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-diagnosticdatasubmissionmode.md | Allow the device to send diagnostic and usage telemetry data, such as Watson. |none|1|No telemetry data is sent from OS components. Note: This value is only applicable to enterprise and server devices. Using this setting on other devices is equivalent to setting the value of 1.| |basic|2|Sends basic telemetry data.| |enhanced|3|Sends enhanced telemetry data including usage and insights data.|-|full|4|Sends full telemetry data including diagnostic data, such as system state.| +|full|4|Sends full telemetry data including diagnostic data, such as system state.| |
v1.0 | Intune Deviceconfig Diffiehellmangroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-diffiehellmangroup.md | Diffie Hellman Group values for Windows10 VPN policies with IKEv2 connection typ |group14|2|Group14| |ecp256|3|ECP256| |ecp384|4|ECP384|-|group24|5|Group24| +|group24|5|Group24| |
v1.0 | Intune Deviceconfig Dmaguarddeviceenumerationpolicytype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-dmaguarddeviceenumerationpolicytype.md | Possible values of the DmaGuardDeviceEnumerationPolicy. |:|:|:| |deviceDefault|0|Default value. Devices with DMA remapping incompatible drivers will only be enumerated after the user unlocks the screen.| |blockAll|1|Devices with DMA remapping incompatible drivers will never be allowed to start and perform DMA at any time.|-|allowAll|2|All external DMA capable PCIe devices will be enumerated at any time.| +|allowAll|2|All external DMA capable PCIe devices will be enumerated at any time.| |
v1.0 | Intune Deviceconfig Domainnamesource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-domainnamesource.md | Domainname source. |Member|Value|Description| |:|:|:| |fullDomainName|0|Full domain name.|-|netBiosDomainName|1|net bios domain name.| +|netBiosDomainName|1|net bios domain name.| |
v1.0 | Intune Deviceconfig Eapfastconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-eapfastconfiguration.md | Available settings for EAP-FAST Configuration. |noProtectedAccessCredential|0|Use EAP-FAST without Protected Access Credential (PAC).| |useProtectedAccessCredential|1|Use Protected Access Credential (PAC).| |useProtectedAccessCredentialAndProvision|2|Use Protected Access Credential (PAC) and Provision PAC.|-|useProtectedAccessCredentialAndProvisionAnonymously|3|Use Protected Access Credential (PAC), Provision PAC, and do so anonymously.| +|useProtectedAccessCredentialAndProvisionAnonymously|3|Use Protected Access Credential (PAC), Provision PAC, and do so anonymously.| |
v1.0 | Intune Deviceconfig Eaptype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-eaptype.md | Extensible Authentication Protocol (EAP) configuration types. |eapTtls|21|EAP-Tunneled Transport Layer Security (EAP-TTLS).| |peap|25|Protected Extensible Authentication Protocol (PEAP).| |eapFast|43|EAP-Flexible Authentication via Secure Tunneling (EAP-FAST).|-|teap|55|Tunnel Extensible Authentication Protocol (TEAP).| +|teap|55|Tunnel Extensible Authentication Protocol (TEAP).| |
v1.0 | Intune Deviceconfig Easauthenticationmethod | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-easauthenticationmethod.md | Exchange Active Sync authentication method. |:|:|:| |usernameAndPassword|0|Authenticate with a username and password.| |certificate|1|Authenticate with a certificate.|-|derivedCredential|2|Authenticate with derived credential.| +|derivedCredential|2|Authenticate with derived credential.| |
v1.0 | Intune Deviceconfig Easemailprofileconfigurationbase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-easemailprofileconfigurationbase.md | Here is a JSON representation of the resource. "userDomainNameSource": "String", "customDomainName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Easservices | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-easservices.md | Exchange Active Sync services. |contacts|2|Enables synchronization of contacts.| |email|4|Enables synchronization of email.| |notes|8|Enables synchronization of notes.|-|reminders|16|Enables synchronization of reminders.| +|reminders|16|Enables synchronization of reminders.| |
v1.0 | Intune Deviceconfig Edgecookiepolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-edgecookiepolicy.md | Possible values to specify which cookies are allowed in Microsoft Edge. |userDefined|0|Allow the user to set.| |allow|1|Allow.| |blockThirdParty|2|Block only third party cookies.|-|blockAll|3|Block all cookies.| +|blockAll|3|Block all cookies.| |
v1.0 | Intune Deviceconfig Edgehomebuttonconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-edgehomebuttonconfiguration.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.edgeHomeButtonConfiguration" }-``` +``` |
v1.0 | Intune Deviceconfig Edgehomebuttonhidden | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-edgehomebuttonhidden.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.edgeHomeButtonHidden" }-``` +``` |
v1.0 | Intune Deviceconfig Edgehomebuttonloadsstartpage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-edgehomebuttonloadsstartpage.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.edgeHomeButtonLoadsStartPage" }-``` +``` |
v1.0 | Intune Deviceconfig Edgehomebuttonopenscustomurl | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-edgehomebuttonopenscustomurl.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.edgeHomeButtonOpensCustomURL", "homeButtonCustomURL": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Edgehomebuttonopensnewtab | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-edgehomebuttonopensnewtab.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.edgeHomeButtonOpensNewTab" }-``` +``` |
v1.0 | Intune Deviceconfig Edgekioskmoderestrictiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-edgekioskmoderestrictiontype.md | Specify how the Microsoft Edge settings are restricted based on kiosk mode. |digitalSignage|1|Interactive/Digital signage in single-app mode.| |normalMode|2|Normal mode (full version of Microsoft Edge).| |publicBrowsingSingleApp|3|Public browsing in single-app mode.|-|publicBrowsingMultiApp|4|Public browsing (inPrivate) in multi-app mode.| +|publicBrowsingMultiApp|4|Public browsing (inPrivate) in multi-app mode.| |
v1.0 | Intune Deviceconfig Edgeopenoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-edgeopenoptions.md | Possible values for the EdgeOpensWith setting. |startPage|1|StartPage.| |newTabPage|2|NewTabPage.| |previousPages|3|PreviousPages.|-|specificPages|4|SpecificPages.| +|specificPages|4|SpecificPages.| |
v1.0 | Intune Deviceconfig Edgesearchengine | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-edgesearchengine.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.edgeSearchEngine", "edgeSearchEngineType": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Edgesearchenginebase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-edgesearchenginebase.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.edgeSearchEngineBase" }-``` +``` |
v1.0 | Intune Deviceconfig Edgesearchenginecustom | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-edgesearchenginecustom.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.edgeSearchEngineCustom", "edgeSearchEngineOpenSearchXmlUrl": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Edgesearchenginetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-edgesearchenginetype.md | Allows IT admind to set a predefined default search engine for MDM-Controlled de |Member|Value|Description| |:|:|:| |default|0|Uses factory settings of Edge to assign the default search engine as per the user market|-|bing|1|Sets Bing as the default search engine| +|bing|1|Sets Bing as the default search engine| |
v1.0 | Intune Deviceconfig Edgetelemetrymode | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-edgetelemetrymode.md | Type of browsing data sent to Microsoft 365 analytics |notConfigured|0|Default ΓÇô No telemetry data collected or sent| |intranet|1|Allow sending intranet history only: Only send browsing history data for intranet sites| |internet|2|Allow sending internet history only: Only send browsing history data for internet sites|-|intranetAndInternet|3|Allow sending both intranet and internet history: Send browsing history data for intranet and internet sites| +|intranetAndInternet|3|Allow sending both intranet and internet history: Send browsing history data for intranet and internet sites| |
v1.0 | Intune Deviceconfig Editionupgradeconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-editionupgradeconfiguration.md | Here is a JSON representation of the resource. "productKey": "String", "windowsSMode": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Editionupgradelicensetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-editionupgradelicensetype.md | Edition Upgrade License type |:|:|:| |productKey|0|Product Key Type| |licenseFile|1|License File Type|-|notConfigured|2|NotConfigured| +|notConfigured|2|NotConfigured| |
v1.0 | Intune Deviceconfig Emailcertificatetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-emailcertificatetype.md | Supported certificate sources for email signing and encryption. |:|:|:| |none|0|Do not use a certificate as a source.| |certificate|1|Use an certificate for certificate source.|-|derivedCredential|2|Use a derived credential for certificate source.| +|derivedCredential|2|Use a derived credential for certificate source.| |
v1.0 | Intune Deviceconfig Emailsyncduration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-emailsyncduration.md | Possible values for email sync duration. |oneWeek|3|Sync one week of email.| |twoWeeks|4|Sync two weeks of email.| |oneMonth|5|Sync one month of email.|-|unlimited|6|Sync an unlimited duration of email.| +|unlimited|6|Sync an unlimited duration of email.| |
v1.0 | Intune Deviceconfig Emailsyncschedule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-emailsyncschedule.md | Possible values for email sync schedule. |fifteenMinutes|3|Sync every fifteen minutes.| |thirtyMinutes|4|Sync every thirty minutes.| |sixtyMinutes|5|Sync every sixty minutes.|-|basedOnMyUsage|6|Sync based on my usage.| +|basedOnMyUsage|6|Sync based on my usage.| |
v1.0 | Intune Deviceconfig Enablement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-enablement.md | Possible values of a property |:|:|:| |notConfigured|0|Device default value, no intent.| |enabled|1|Enables the setting on the device.|-|disabled|2|Disables the setting on the device.| +|disabled|2|Disables the setting on the device.| |
v1.0 | Intune Deviceconfig Encryptionreadinessstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-encryptionreadinessstate.md | Encryption readiness state |Member|Value|Description| |:|:|:| |notReady|0|Not ready|-|ready|1|Ready| +|ready|1|Ready| |
v1.0 | Intune Deviceconfig Encryptionreportpolicydetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-encryptionreportpolicydetails.md | Here is a JSON representation of the resource. "policyId": "String", "policyName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Encryptionstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-encryptionstate.md | Encryption state |Member|Value|Description| |:|:|:| |notEncrypted|0|Not encrypted|-|encrypted|1|Encrypted| +|encrypted|1|Encrypted| |
v1.0 | Intune Deviceconfig Extendedkeyusage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-extendedkeyusage.md | Here is a JSON representation of the resource. "name": "String", "objectIdentifier": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Filevaultstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-filevaultstate.md | FileVault State |success|0|FileVault State Success| |driveEncryptedByUser|1|FileVault has been enabled by user and is not being managed by policy| |userDeferredEncryption|2|FileVault policy is successfully installed but user has not started encryption|-|escrowNotEnabled|4|FileVault recovery key escrow is not enabled| +|escrowNotEnabled|4|FileVault recovery key escrow is not enabled| |
v1.0 | Intune Deviceconfig Firewallcertificaterevocationlistcheckmethodtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-firewallcertificaterevocationlistcheckmethodtype.md | Possible values for firewallCertificateRevocationListCheckMethod |deviceDefault|0|No value configured by Intune, do not override the user-configured device default value| |none|1|Do not check certificate revocation list| |attempt|2|Attempt CRL check and allow a certificate only if the certificate is confirmed by the check|-|require|3|Require a successful CRL check before allowing a certificate| +|require|3|Require a successful CRL check before allowing a certificate| |
v1.0 | Intune Deviceconfig Firewallpacketqueueingmethodtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-firewallpacketqueueingmethodtype.md | Possible values for firewallPacketQueueingMethod |disabled|1|Disable packet queuing| |queueInbound|2|Queue inbound encrypted packets| |queueOutbound|3|Queue decrypted outbound packets for forwarding|-|queueBoth|4|Queue both inbound and outbound packets| +|queueBoth|4|Queue both inbound and outbound packets| |
v1.0 | Intune Deviceconfig Firewallpresharedkeyencodingmethodtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-firewallpresharedkeyencodingmethodtype.md | Possible values for firewallPreSharedKeyEncodingMethod |:|:|:| |deviceDefault|0|No value configured by Intune, do not override the user-configured device default value| |none|1|Preshared key is not encoded. Instead, it is kept in its wide-character format|-|utF8|2|Encode the preshared key using UTF-8| +|utF8|2|Encode the preshared key using UTF-8| |
v1.0 | Intune Deviceconfig Folderprotectiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-folderprotectiontype.md | Possible values of Folder Protection |enable|1|Block functionality.| |auditMode|2|Allow functionality but generate logs.| |blockDiskModification|3|Block untrusted apps from writing to disk sectors.|-|auditDiskModification|4|Generate logs when untrusted apps write to disk sectors.| +|auditDiskModification|4|Generate logs when untrusted apps write to disk sectors.| |
v1.0 | Intune Deviceconfig Hardwareconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-hardwareconfiguration.md | Title: "hardwareConfiguration resource type" -description: "Intune will provide customer the ability to configure hardware/bios settings on the enrolled windows 10 Azure Active Directory joined devices." +description: "BIOS configuration and other settings provides customers the ability to configure hardware/bios settings on the enrolled Windows 10/11 Entra ID joined devices by uploading a configuration file generated with their OEM tool (e.g. Dell Command tool). A BIOS configuration policy can be assigned to multiple devices, allowing admins to remotely control a device's hardware properties (e.g. enable Secure Boot) from the Intune Portal." localization_priority: Normal Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Intune will provide customer the ability to configure hardware/bios settings on the enrolled windows 10 Azure Active Directory joined devices. +BIOS configuration and other settings provides customers the ability to configure hardware/bios settings on the enrolled Windows 10/11 Entra ID joined devices by uploading a configuration file generated with their OEM tool (e.g. Dell Command tool). A BIOS configuration policy can be assigned to multiple devices, allowing admins to remotely control a device's hardware properties (e.g. enable Secure Boot) from the Intune Portal. ## Methods |Method|Return Type|Description| Intune will provide customer the ability to configure hardware/bios settings on ## Properties |Property|Type|Description| |:|:|:|-|id|String|Unique Identifier for the hardware configuration| -|version|Int32|Version of the hardware configuration (E.g. 1, 2, 3 ...)| -|displayName|String|Name of the hardware configuration| -|description|String|Description of the hardware configuration| -|createdDateTime|DateTimeOffset|Timestamp of when the hardware configuration was created. This property is read-only.| -|lastModifiedDateTime|DateTimeOffset|Timestamp of when the hardware configuration was modified. This property is read-only.| -|fileName|String|File name of the hardware configuration| -|configurationFileContent|Binary|File content of the hardware configuration| -|hardwareConfigurationFormat|[hardwareConfigurationFormat](../resources/intune-deviceconfig-hardwareconfigurationformat.md)|Oem type of the hardware configuration (E.g. DELL, HP, Surface and SurfaceDock). Possible values are: `dell`, `surface`, `surfaceDock`.| -|roleScopeTagIds|String collection|List of Scope Tag IDs for the hardware configuration| -|perDevicePasswordDisabled|Boolean|A value indicating whether per devcive pasword disabled| +|id|String|The unique identifier of the hardware BIOS configuration profile for the enrolled devices. This id is and is autogenerated and assigned when new hardware BIOS configuration profile is created. This distinguishes profiles from each other and cannot be null. Returned by default. Read-Only.| +|version|Int32|The version of the hardware configuration (E.g. 1, 2, 3 ...). This is incremented after a change to the BIOS configuration profile's settings file name (FileName property), settings file content (ConfigurationFileContent property), or the PerDevicePasswordDisabled property. Read-Only.| +|displayName|String|The name of the hardware BIOS configuration profile. It serves as user-friendly name to identify hardware BIOS configuration profiles. Max length is 150 characters. Required. Read-Only.| +|description|String|The description of the hardware configuration. Use this to provide context, purpose, applications, etc of the BIOS configuration profile for your organization's admins. Max length is 1000 characters. Optional.| +|createdDateTime|DateTimeOffset|The date and time of when the BIOS configuration profile was created. The value cannot be modified and is automatically populated when the device is enrolled. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Returned by default. Read-Only. This property is read-only.| +|lastModifiedDateTime|DateTimeOffset|The date and time of when the BIOS configuration profile was last modified. The value cannot be modified and is automatically populated when the device is enrolled. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Returned by default. Read-Only. Read-Only. This property is read-only.| +|fileName|String|The file name for the BIOS configuration profile's ConfigurationFileContent. Max length is 150 characters. Required.| +|configurationFileContent|Binary|The file content contains custom hardware settings that will be applied to the assigned devices' BIOS. Max allowed file size is 5KB. Represented as bytes. Required.| +|hardwareConfigurationFormat|[hardwareConfigurationFormat](../resources/intune-deviceconfig-hardwareconfigurationformat.md)|The OEM type associated with BIOS configuration profile's custom hardware settings. All devices that adheres to profile must be from the same selected OEM. Possible values are Dell, Surface, and Surface dock. Required. Possible values are: `dell`, `surface`, `surfaceDock`.| +|roleScopeTagIds|String collection|A list of unique Scope Tag IDs associated with the hardware configuration. Optional.| +|perDevicePasswordDisabled|Boolean|When TRUE, indicates whether the policy-assigned devices' passwords are disabled. When FALSE, indicates they are enabled. Default is FALSE. Required.| ## Relationships |Relationship|Type|Description| |:|:|:|-|assignments|[hardwareConfigurationAssignment](../resources/intune-deviceconfig-hardwareconfigurationassignment.md) collection|List of the Azure AD user group ids that hardware configuration will be applied to. Only security groups and Office 365 Groups are supported.| -|runSummary|[hardwareConfigurationRunSummary](../resources/intune-deviceconfig-hardwareconfigurationrunsummary.md)|A summary of the results from an attempt to configure hardware settings| -|deviceRunStates|[hardwareConfigurationDeviceState](../resources/intune-deviceconfig-hardwareconfigurationdevicestate.md) collection|List of run states for the hardware configuration across all devices| -|userRunStates|[hardwareConfigurationUserState](../resources/intune-deviceconfig-hardwareconfigurationuserstate.md) collection|List of run states for the hardware configuration across all users| +|assignments|[hardwareConfigurationAssignment](../resources/intune-deviceconfig-hardwareconfigurationassignment.md) collection|A list of the Entra user group ids that hardware configuration will be applied to. Only security groups and Office 365 Groups are supported. Optional.| +|runSummary|[hardwareConfigurationRunSummary](../resources/intune-deviceconfig-hardwareconfigurationrunsummary.md)|A summary of the results from an attempt to configure hardware settings. Read-Only.| +|deviceRunStates|[hardwareConfigurationDeviceState](../resources/intune-deviceconfig-hardwareconfigurationdevicestate.md) collection|List of run states for the hardware configuration across all devices. Read-Only.| +|userRunStates|[hardwareConfigurationUserState](../resources/intune-deviceconfig-hardwareconfigurationuserstate.md) collection|List of run states for the hardware configuration across all users. Read-Only.| ## JSON Representation Here is a JSON representation of the resource. Here is a JSON representation of the resource. ], "perDevicePasswordDisabled": true }-``` +``` |
v1.0 | Intune Deviceconfig Hardwareconfigurationassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-hardwareconfigurationassignment.md | Here is a JSON representation of the resource. "entraObjectId": "String" } }-``` +``` |
v1.0 | Intune Deviceconfig Hardwareconfigurationdevicestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-hardwareconfigurationdevicestate.md | Here is a JSON representation of the resource. "assignmentFilterIds": "String", "userId": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Hardwareconfigurationformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-hardwareconfigurationformat.md | Indicates the supported oems of hardware configuration |:|:|:| |dell|1|Dell| |surface|2|Surface|-|surfaceDock|3|Surface dock| +|surfaceDock|3|Surface dock| |
v1.0 | Intune Deviceconfig Hardwareconfigurationrunsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-hardwareconfigurationrunsummary.md | Here is a JSON representation of the resource. "unknownUserCount": 1024, "lastRunDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Deviceconfig Hardwareconfigurationuserstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-hardwareconfigurationuserstate.md | Here is a JSON representation of the resource. "notApplicableDeviceCount": 1024, "unknownDeviceCount": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Hardwarepasswordinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-hardwarepasswordinfo.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceconfig Inkaccesssetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-inkaccesssetting.md | Values for the InkWorkspaceAccess setting. |:|:|:| |notConfigured|0|Not configured.| |enabled|1|Enabled.|-|disabled|2|Disabled.| +|disabled|2|Disabled.| |
v1.0 | Intune Deviceconfig Intendedpurpose | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-intendedpurpose.md | PFX Import Options. |smimeEncryption|2|SmimeEncryption| |smimeSigning|3|SmimeSigning| |vpn|4|VPN|-|wifi|5|Wifi| +|wifi|5|Wifi| |
v1.0 | Intune Deviceconfig Internetexplorermessagesetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-internetexplorermessagesetting.md | What message will be displayed by Edge before switching to Internet Explorer. |notConfigured|0|Not configured.| |disabled|1|Disabled.| |enabled|2|Enabled.|-|keepGoing|3|KeepGoing.| +|keepGoing|3|KeepGoing.| |
v1.0 | Intune Deviceconfig Internetsitesecuritylevel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-internetsitesecuritylevel.md | Possible values for internet site security level. |userDefined|0|User Defined, default value, no intent.| |medium|1|Medium.| |mediumHigh|2|Medium-High.|-|high|3|High.| +|high|3|High.| |
v1.0 | Intune Deviceconfig Iosazureadsinglesignonextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iosazureadsinglesignonextension.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Iosbookmark | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iosbookmark.md | Here is a JSON representation of the resource. "bookmarkFolder": "String", "displayName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Ioscertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ioscertificateprofile.md | Here is a JSON representation of the resource. "displayName": "String", "version": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Ioscertificateprofilebase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ioscertificateprofilebase.md | Here is a JSON representation of the resource. "certificateValidityPeriodValue": 1024, "certificateValidityPeriodScale": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Ioscompliancepolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ioscompliancepolicy.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Ioscredentialsinglesignonextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ioscredentialsinglesignonextension.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Ioscustomconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ioscustomconfiguration.md | Here is a JSON representation of the resource. "payloadFileName": "String", "payload": "binary" }-``` +``` |
v1.0 | Intune Deviceconfig Iosderivedcredentialauthenticationconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iosderivedcredentialauthenticationconfiguration.md | Here is a JSON representation of the resource. "displayName": "String", "version": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Iosdevicefeaturesconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iosdevicefeaturesconfiguration.md | Here is a JSON representation of the resource. "managedAppsInBundleIdACLIncluded": true } }-``` +``` |
v1.0 | Intune Deviceconfig Ioseasemailprofileconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ioseasemailprofileconfiguration.md | Here is a JSON representation of the resource. "encryptionCertificateType": "String", "perAppVPNProfileId": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Ioseducationdeviceconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ioseducationdeviceconfiguration.md | Here is a JSON representation of the resource. "displayName": "String", "version": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Ioseducertificatesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ioseducertificatesettings.md | Here is a JSON representation of the resource. "certificateValidityPeriodValue": 1024, "certificateValidityPeriodScale": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Iosedudeviceconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iosedudeviceconfiguration.md | Here is a JSON representation of the resource. "certificateValidityPeriodScale": "String" } }-``` +``` |
v1.0 | Intune Deviceconfig Iosenterprisewificonfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iosenterprisewificonfiguration.md | Here is a JSON representation of the resource. "usernameFormatString": "String", "passwordFormatString": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Iosexpeditedcheckinconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iosexpeditedcheckinconfiguration.md | Here is a JSON representation of the resource. "version": 1024, "enableExpeditedCheckin": true }-``` +``` |
v1.0 | Intune Deviceconfig Iosgeneraldeviceconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iosgeneraldeviceconfiguration.md | Here is a JSON representation of the resource. "iCloudPrivateRelayBlocked": true, "kioskModeAppType": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Ioshomescreenapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ioshomescreenapp.md | Here is a JSON representation of the resource. "bundleID": "String", "isWebClip": true }-``` +``` |
v1.0 | Intune Deviceconfig Ioshomescreenfolder | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ioshomescreenfolder.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Ioshomescreenfolderpage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ioshomescreenfolderpage.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Ioshomescreenitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ioshomescreenitem.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.iosHomeScreenItem", "displayName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Ioshomescreenpage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ioshomescreenpage.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Iosikev2vpnconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iosikev2vpnconfiguration.md | Here is a JSON representation of the resource. "enableAlwaysOnConfiguration": true, "mtuSizeInBytes": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Iosimportedpfxcertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iosimportedpfxcertificateprofile.md | Here is a JSON representation of the resource. "version": 1024, "intendedPurpose": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Ioskerberossinglesignonextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ioskerberossinglesignonextension.md | Here is a JSON representation of the resource. "signInHelpText": "String", "managedAppsInBundleIdACLIncluded": true }-``` +``` |
v1.0 | Intune Deviceconfig Ioskioskmodeapptype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ioskioskmodeapptype.md | App source options for iOS kiosk mode. |notConfigured|0|Device default value, no intent.| |appStoreApp|1|The app to be run comes from the app store.| |managedApp|2|The app to be run is built into the device.|-|builtInApp|3|The app to be run is a managed app.| +|builtInApp|3|The app to be run is a managed app.| |
v1.0 | Intune Deviceconfig Iosnetworkusagerule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iosnetworkusagerule.md | Here is a JSON representation of the resource. "cellularDataBlockWhenRoaming": true, "cellularDataBlocked": true }-``` +``` |
v1.0 | Intune Deviceconfig Iosnotificationalerttype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iosnotificationalerttype.md | Notification Settings Alert Type. |deviceDefault|0|Device default value, no intent.| |banner|1|Banner.| |modal|2|Modal.|-|none|3|None.| +|none|3|None.| |
v1.0 | Intune Deviceconfig Iosnotificationpreviewvisibility | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iosnotificationpreviewvisibility.md | Determines when notification previews are visible on an iOS device. Previews can |notConfigured|0|Notification preview settings will not be overwritten.| |alwaysShow|1|Always show notification previews.| |hideWhenLocked|2|Only show notification previews when the device is unlocked.|-|neverShow|3|Never show notification previews.| +|neverShow|3|Never show notification previews.| |
v1.0 | Intune Deviceconfig Iosnotificationsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iosnotificationsettings.md | Here is a JSON representation of the resource. "soundsEnabled": true, "previewVisibility": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Iospkcscertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iospkcscertificateprofile.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Iosredirectsinglesignonextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iosredirectsinglesignonextension.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceconfig Iosscepcertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iosscepcertificateprofile.md | Inherits from [iosCertificateProfileBase](../resources/intune-deviceconfig-iosce |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |keyUsage|[keyUsages](../resources/intune-shared-keyusages.md)|SCEP Key Usage. Possible values are: `keyEncipherment`, `digitalSignature`.| |keySize|[keySize](../resources/intune-shared-keysize.md)|SCEP Key Size. Possible values are: `size1024`, `size2048`, `size4096`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| |subjectAlternativeNameFormatString|String|Custom String that defines the AAD Attribute.| |certificateStore|[certificateStore](../resources/intune-shared-certificatestore.md)|Target store certificate. Possible values are: `user`, `machine`.| |customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. The OnPremisesUserPrincipalName variable is support as well as others documented here: https://go.microsoft.com/fwlink/?LinkId=2027630. This collection can contain a maximum of 500 elements.| Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Iossinglesignonextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iossinglesignonextension.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.iosSingleSignOnExtension" }-``` +``` |
v1.0 | Intune Deviceconfig Iossinglesignonsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iossinglesignonsettings.md | Here is a JSON representation of the resource. "kerberosPrincipalName": "String", "kerberosRealm": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Iossoftwareupdatescheduletype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iossoftwareupdatescheduletype.md | Update schedule type for iOS software updates. |updateOutsideOfActiveHours|0|Update outside of active hours.| |alwaysUpdate|1|Always update.| |updateDuringTimeWindows|2|Update during time windows.|-|updateOutsideOfTimeWindows|3|Update outside of time windows.| +|updateOutsideOfTimeWindows|3|Update outside of time windows.| |
v1.0 | Intune Deviceconfig Iostrustedrootcertificate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iostrustedrootcertificate.md | Here is a JSON representation of the resource. "trustedRootCertificate": "binary", "certFileName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Iosupdateconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iosupdateconfiguration.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Iosupdatedevicestatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iosupdatedevicestatus.md | Here is a JSON representation of the resource. "lastReportedDateTime": "String (timestamp)", "userPrincipalName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Iosupdatesinstallstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iosupdatesinstallstatus.md | Namespace: microsoft.graph |sharedDeviceUserLoggedInError|-2016330699|| |updateError|-2016330697|| |deviceOsHigherThanDesiredOsVersion|-2016330696||-|updateScanFailed|-2016324062|| +|updateScanFailed|-2016324062|| |
v1.0 | Intune Deviceconfig Iosvpnconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iosvpnconfiguration.md | Here is a JSON representation of the resource. ], "microsoftTunnelSiteId": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Iosvpnsecurityassociationparameters | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-iosvpnsecurityassociationparameters.md | Here is a JSON representation of the resource. "securityDiffieHellmanGroup": 1024, "lifetimeInMinutes": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Ioswallpaperdisplaylocation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ioswallpaperdisplaylocation.md | An enum type for wallpaper display location specifier. |notConfigured|0|No location specified for wallpaper display.| |lockScreen|1|A configured wallpaper image is displayed on Lock screen.| |homeScreen|2|A configured wallpaper image is displayed on Home (icon list) screen.|-|lockAndHomeScreens|3|A configured wallpaper image is displayed on Lock screen and Home screen.| +|lockAndHomeScreens|3|A configured wallpaper image is displayed on Lock screen and Home screen.| |
v1.0 | Intune Deviceconfig Ioswebcontentfilterautofilter | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ioswebcontentfilterautofilter.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceconfig Ioswebcontentfilterbase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ioswebcontentfilterbase.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.iosWebContentFilterBase" }-``` +``` |
v1.0 | Intune Deviceconfig Ioswebcontentfilterspecificwebsitesaccess | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ioswebcontentfilterspecificwebsitesaccess.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Ioswificonfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ioswificonfiguration.md | Here is a JSON representation of the resource. "disableMacAddressRandomization": true, "preSharedKey": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Kerberossinglesignonextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-kerberossinglesignonextension.md | Here is a JSON representation of the resource. "blockActiveDirectorySiteAutoDiscovery": true, "passwordChangeUrl": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Keybooleanvaluepair | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-keybooleanvaluepair.md | Here is a JSON representation of the resource. "key": "String", "value": true }-``` +``` |
v1.0 | Intune Deviceconfig Keyintegervaluepair | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-keyintegervaluepair.md | Here is a JSON representation of the resource. "key": "String", "value": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Keyrealvaluepair | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-keyrealvaluepair.md | Here is a JSON representation of the resource. "key": "String", "value": "4.2" }-``` +``` |
v1.0 | Intune Deviceconfig Keystringvaluepair | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-keystringvaluepair.md | Here is a JSON representation of the resource. "key": "String", "value": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Keytypedvaluepair | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-keytypedvaluepair.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.keyTypedValuePair", "key": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Keyvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-keyvalue.md | Here is a JSON representation of the resource. "key": "String", "value": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Keyvaluepair | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-keyvaluepair.md | Here is a JSON representation of the resource. "name": "String", "value": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Kioskmodemanagedhomescreenpincomplexity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-kioskmodemanagedhomescreenpincomplexity.md | Complexity of PIN for Managed Home Screen sign-in session. |:|:|:| |notConfigured|0|Not configured.| |simple|1|Numeric values only.|-|complex|2|Alphanumerical value.| +|complex|2|Alphanumerical value.| |
v1.0 | Intune Deviceconfig Kioskmodetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-kioskmodetype.md | Possible values of Android Kiosk Mode. |:|:|:| |notConfigured|0|Not configured| |singleAppMode|1|Run in single-app mode|-|multiAppMode|2|Run in multi-app mode| +|multiAppMode|2|Run in multi-app mode| |
v1.0 | Intune Deviceconfig Lanmanagerauthenticationlevel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-lanmanagerauthenticationlevel.md | Possible values for LanManagerAuthenticationLevel |lmAndNtlmOnly|2|Send LM & NTLM responses only| |lmAndNtlmV2|3|Send LM & NTLMv2 responses only| |lmNtlmV2AndNotLm|4|Send LM & NTLMv2 responses only. Refuse LM|-|lmNtlmV2AndNotLmOrNtm|5|Send LM & NTLMv2 responses only. Refuse LM & NTLM| +|lmNtlmV2AndNotLmOrNtm|5|Send LM & NTLMv2 responses only. Refuse LM & NTLM| |
v1.0 | Intune Deviceconfig Licensetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-licensetype.md | Indicates whether tenant has a valid Intune Endpoint Privilege Management licens |notPaid|0|Indicates the tenant has neither trial or paid license.| |paid|1|Indicates the tenant has paid Endpoint Privilege Management license.| |trial|2|Indicates the tenant has trial Endpoint Privilege Management license.|-|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Deviceconfig Localsecurityoptionsadministratorelevationpromptbehaviortype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-localsecurityoptionsadministratorelevationpromptbehaviortype.md | Possible values for LocalSecurityOptionsAdministratorElevationPromptBehavior |promptForConsentOnTheSecureDesktop|3|Prompt for consent on the secure desktop| |promptForCredentials|4|Prompt for credentials| |promptForConsent|5|Prompt for consent|-|promptForConsentForNonWindowsBinaries|6|Prompt for consent for non-Windows binaries| +|promptForConsentForNonWindowsBinaries|6|Prompt for consent for non-Windows binaries| |
v1.0 | Intune Deviceconfig Localsecurityoptionsformatandejectofremovablemediaallowedusertype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-localsecurityoptionsformatandejectofremovablemediaallowedusertype.md | Possible values for LocalSecurityOptionsFormatAndEjectOfRemovableMediaAllowedUse |notConfigured|0|Not Configured| |administrators|1|Administrators| |administratorsAndPowerUsers|2|Administrators and Power Users|-|administratorsAndInteractiveUsers|3|Administrators and Interactive Users | +|administratorsAndInteractiveUsers|3|Administrators and Interactive Users | |
v1.0 | Intune Deviceconfig Localsecurityoptionsinformationdisplayedonlockscreentype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-localsecurityoptionsinformationdisplayedonlockscreentype.md | Possible values for LocalSecurityOptionsInformationDisplayedOnLockScreen |notConfigured|0|Not Configured| |administrators|1|User display name, domain and user names| |administratorsAndPowerUsers|2|User display name only|-|administratorsAndInteractiveUsers|3|Do not display user information| +|administratorsAndInteractiveUsers|3|Do not display user information| |
v1.0 | Intune Deviceconfig Localsecurityoptionsinformationshownonlockscreentype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-localsecurityoptionsinformationshownonlockscreentype.md | Possible values for LocalSecurityOptionsInformationShownOnLockScreenType |notConfigured|0|Not Configured| |userDisplayNameDomainUser|1|User display name, domain and user names| |userDisplayNameOnly|2|User display name only|-|doNotDisplayUser|3|Do not display user information| +|doNotDisplayUser|3|Do not display user information| |
v1.0 | Intune Deviceconfig Localsecurityoptionsminimumsessionsecurity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-localsecurityoptionsminimumsessionsecurity.md | Possible values for LocalSecurityOptionsMinimumSessionSecurity |none|0|Send LM & NTLM responses| |requireNtmlV2SessionSecurity|1|Send LM & NTLM-use NTLMv2 session security if negotiated| |require128BitEncryption|2|Send LM & NTLM responses only|-|ntlmV2And128BitEncryption|3|Send LM & NTLMv2 responses only| +|ntlmV2And128BitEncryption|3|Send LM & NTLMv2 responses only| |
v1.0 | Intune Deviceconfig Localsecurityoptionssmartcardremovalbehaviortype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-localsecurityoptionssmartcardremovalbehaviortype.md | Possible values for LocalSecurityOptionsSmartCardRemovalBehaviorType |noAction|0|No Action| |lockWorkstation|1|Lock Workstation| |forceLogoff|2|Force Logoff|-|disconnectRemoteDesktopSession|3|Disconnect if a remote Remote Desktop Services session| +|disconnectRemoteDesktopSession|3|Disconnect if a remote Remote Desktop Services session| |
v1.0 | Intune Deviceconfig Localsecurityoptionsstandarduserelevationpromptbehaviortype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-localsecurityoptionsstandarduserelevationpromptbehaviortype.md | Possible values for LocalSecurityOptionsStandardUserElevationPromptBehavior |notConfigured|0|Not Configured| |automaticallyDenyElevationRequests|1|Automatically deny elevation requests| |promptForCredentialsOnTheSecureDesktop|2|Prompt for credentials on the secure desktop|-|promptForCredentials|3|Prompt for credentials| +|promptForCredentials|3|Prompt for credentials| |
v1.0 | Intune Deviceconfig Macaddressrandomizationmode | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macaddressrandomizationmode.md | An enum representing the possible values of Android MAC Address Randomization Mo |:|:|:| |automatic|0|Indicates the Wi-Fi framework to automatically decide the MAC randomization strategy. This can either be persistent or non-persistent randomly generated MAC addresses which are used while connecting to the network. In case of Persistent randomization, android generates a persistent randomized MAC address based on the parameters of the network profile. This MAC address remains the same until factory reset. On the other hand under the non-persistent randomization type, which is used for some networks in Android 12 or higher, the Wi-Fi module re-randomizes the MAC address at the start of every connection or the framework uses the existing randomized MAC address to connect to the network. More info: https://source.android.com/docs/core/connect/wifi-mac-randomization-behavior#types| |hardware|1|Indicates MAC randomization is disabled and the factory MAC address is used when connecting to the internet.|-|unknownFutureValue|2|Indicates evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|2|Indicates evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Deviceconfig Macosappleeventreceiver | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macosappleeventreceiver.md | Here is a JSON representation of the resource. "identifierType": "String", "allowed": true }-``` +``` |
v1.0 | Intune Deviceconfig Macosassociateddomainsitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macosassociateddomainsitem.md | Here is a JSON representation of the resource. ], "directDownloadsEnabled": true }-``` +``` |
v1.0 | Intune Deviceconfig Macosazureadsinglesignonextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macosazureadsinglesignonextension.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Macoscertificateprofilebase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macoscertificateprofilebase.md | Here is a JSON representation of the resource. "certificateValidityPeriodValue": 1024, "certificateValidityPeriodScale": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Macoscompliancepolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macoscompliancepolicy.md | Here is a JSON representation of the resource. "firewallBlockAllIncoming": true, "firewallEnableStealthMode": true }-``` +``` |
v1.0 | Intune Deviceconfig Macoscontentcachingclientpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macoscontentcachingclientpolicy.md | Determines which clients a content cache will serve. |clientsInLocalNetwork|1|Content caches will provide content to devices only in their immediate local network.| |clientsWithSamePublicIpAddress|2|Content caches will provide content to devices that share the same public IP address.| |clientsInCustomLocalNetworks|3|Content caches will provide content to devices in contentCachingClientListenRanges.|-|clientsInCustomLocalNetworksWithFallback|4|Content caches will provide content to devices in contentCachingClientListenRanges, contentCachingPeerListenRanges, and contentCachingParents.| +|clientsInCustomLocalNetworksWithFallback|4|Content caches will provide content to devices in contentCachingClientListenRanges, contentCachingPeerListenRanges, and contentCachingParents.| |
v1.0 | Intune Deviceconfig Macoscontentcachingparentselectionpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macoscontentcachingparentselectionpolicy.md | Determines how content caches select a parent cache. |firstAvailable|2|Always use the first available parent in the Parents list. Use this policy to designate permanent primary, secondary, and subsequent parents.| |urlPathHash|3|Hash the path part of the requested URL so that the same parent is always used for the same URL. This is useful for maximizing the size of the combined caches of the parents.| |random|4|Choose a parent at random. Use this policy for load balancing.|-|stickyAvailable|5|Use the first available parent that is available in the Parents list until it becomes unavailable, then advance to the next one. Use this policy for designating floating primary, secondary, and subsequent parents.| +|stickyAvailable|5|Use the first available parent that is available in the Parents list until it becomes unavailable, then advance to the next one. Use this policy for designating floating primary, secondary, and subsequent parents.| |
v1.0 | Intune Deviceconfig Macoscontentcachingpeerpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macoscontentcachingpeerpolicy.md | Determines which content caches other content caches will peer with. |notConfigured|0|Defaults to peers in local network.| |peersInLocalNetwork|1|Content caches will only peer with caches in their immediate local network.| |peersWithSamePublicIpAddress|2|Content caches will only peer with caches that share the same public IP address.|-|peersInCustomLocalNetworks|3|Content caches will use contentCachingPeerFilterRanges and contentCachingPeerListenRanges to determine which caches to peer with.| +|peersInCustomLocalNetworks|3|Content caches will use contentCachingPeerFilterRanges and contentCachingPeerListenRanges to determine which caches to peer with.| |
v1.0 | Intune Deviceconfig Macoscontentcachingtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macoscontentcachingtype.md | Indicates the type of content allowed to be cached by Apple's content caching se |:|:|:| |notConfigured|0|Default. Both user iCloud data and non-iCloud data will be cached.| |userContentOnly|1|Allow Apple's content caching service to cache user iCloud data.|-|sharedContentOnly|2|Allow Apple's content caching service to cache non-iCloud data (e.g. app and software updates).| +|sharedContentOnly|2|Allow Apple's content caching service to cache non-iCloud data (e.g. app and software updates).| |
v1.0 | Intune Deviceconfig Macoscredentialsinglesignonextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macoscredentialsinglesignonextension.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Macoscustomappconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macoscustomappconfiguration.md | Here is a JSON representation of the resource. "fileName": "String", "configurationXml": "binary" }-``` +``` |
v1.0 | Intune Deviceconfig Macoscustomconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macoscustomconfiguration.md | Here is a JSON representation of the resource. "payload": "binary", "deploymentChannel": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Macosdevicefeaturesconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macosdevicefeaturesconfiguration.md | Here is a JSON representation of the resource. "contentCachingKeepAwake": true, "contentCachingPort": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Macosendpointprotectionconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macosendpointprotectionconfiguration.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceconfig Macosenterprisewificonfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macosenterprisewificonfiguration.md | Here is a JSON representation of the resource. "innerAuthenticationProtocolForEapTtls": "String", "outerIdentityPrivacyTemporaryValue": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Macosextensionsconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macosextensionsconfiguration.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Macosfilevaultrecoverykeytypes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macosfilevaultrecoverykeytypes.md | Recovery key types for macOS FileVault |:|:|:| |notConfigured|0|Device default value, no intent.| |institutionalRecoveryKey|1|An institutional recovery key is like a ΓÇ£masterΓÇ¥ recovery key that can be used to unlock any device whose password has been lost.|-|personalRecoveryKey|2|A personal recovery key is a unique code that can be used to unlock the userΓÇÖs device, even if the password to the device is lost.| +|personalRecoveryKey|2|A personal recovery key is a unique code that can be used to unlock the userΓÇÖs device, even if the password to the device is lost.| |
v1.0 | Intune Deviceconfig Macosfirewallapplication | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macosfirewallapplication.md | Here is a JSON representation of the resource. "bundleId": "String", "allowsIncomingConnections": true }-``` +``` |
v1.0 | Intune Deviceconfig Macosgatekeeperappsources | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macosgatekeeperappsources.md | App source options for macOS Gatekeeper. |notConfigured|0|Device default value, no intent.| |macAppStore|1|Only apps from the Mac AppStore can be run.| |macAppStoreAndIdentifiedDevelopers|2|Only apps from the Mac AppStore and identified developers can be run.|-|anywhere|3|Apps from anywhere can be run.| +|anywhere|3|Apps from anywhere can be run.| |
v1.0 | Intune Deviceconfig Macosgeneraldeviceconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macosgeneraldeviceconfiguration.md | Here is a JSON representation of the resource. "iCloudDesktopAndDocumentsBlocked": true, "activationLockWhenSupervisedAllowed": true }-``` +``` |
v1.0 | Intune Deviceconfig Macosimportedpfxcertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macosimportedpfxcertificateprofile.md | Here is a JSON representation of the resource. "certificateValidityPeriodScale": "String", "intendedPurpose": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Macoskerberossinglesignonextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macoskerberossinglesignonextension.md | Here is a JSON representation of the resource. ], "tlsForLDAPRequired": true }-``` +``` |
v1.0 | Intune Deviceconfig Macoskernelextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macoskernelextension.md | Here is a JSON representation of the resource. "teamIdentifier": "String", "bundleId": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Macoslaunchitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macoslaunchitem.md | Here is a JSON representation of the resource. "path": "String", "hide": true }-``` +``` |
v1.0 | Intune Deviceconfig Macospkcscertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macospkcscertificateprofile.md | Here is a JSON representation of the resource. ], "allowAllAppsAccess": true }-``` +``` |
v1.0 | Intune Deviceconfig Macospriority | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macospriority.md | The scheduling priority options for downloading and preparing the requested mac |:|:|:| |low|0|Indicates low scheduling priority for downloading and preparing the requested update| |high|1|Indicates high scheduling priority for downloading and preparing the requested update|-|unknownFutureValue|2|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|2|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Deviceconfig Macosprivacyaccesscontrolitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macosprivacyaccesscontrolitem.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Macosprocessidentifiertype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macosprocessidentifiertype.md | Process identifier types for MacOS Privacy Preferences |Member|Value|Description| |:|:|:| |bundleID|1|Indicates an app with a bundle ID.|-|path|2|Indicates a file path for a process.| +|path|2|Indicates a file path for a process.| |
v1.0 | Intune Deviceconfig Macosredirectsinglesignonextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macosredirectsinglesignonextension.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceconfig Macosscepcertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macosscepcertificateprofile.md | Inherits from [macOSCertificateProfileBase](../resources/intune-deviceconfig-mac |keyUsage|[keyUsages](../resources/intune-shared-keyusages.md)|SCEP Key Usage. Possible values are: `keyEncipherment`, `digitalSignature`.| |keySize|[keySize](../resources/intune-shared-keysize.md)|SCEP Key Size. Possible values are: `size1024`, `size2048`, `size4096`.| |hashAlgorithm|[hashAlgorithms](../resources/intune-shared-hashalgorithms.md)|SCEP Hash Algorithm. Possible values are: `sha1`, `sha2`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| |subjectAlternativeNameFormatString|String|Custom String that defines the AAD Attribute.| |certificateStore|[certificateStore](../resources/intune-shared-certificatestore.md)|Target store certificate. Possible values are: `user`, `machine`.| |customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. This collection can contain a maximum of 500 elements.| Here is a JSON representation of the resource. ], "allowAllAppsAccess": true }-``` +``` |
v1.0 | Intune Deviceconfig Macossinglesignonextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macossinglesignonextension.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.macOSSingleSignOnExtension" }-``` +``` |
v1.0 | Intune Deviceconfig Macossoftwareupdateaccountsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macossoftwareupdateaccountsummary.md | Here is a JSON representation of the resource. "totalUpdateCount": 1024, "lastUpdatedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Deviceconfig Macossoftwareupdatebehavior | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macossoftwareupdatebehavior.md | Update behavior options for macOS software updates. |downloadOnly|2|Download the software update without installing it.| |installASAP|3|Install an already downloaded software update.| |notifyOnly|4|Download the software update and notify the user via the App Store.|-|installLater|5|Download the software update and install it at a later time.| +|installLater|5|Download the software update and install it at a later time.| |
v1.0 | Intune Deviceconfig Macossoftwareupdatecategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macossoftwareupdatecategory.md | MacOS Software Update Category |critical|0|A critical update| |configurationDataFile|1|A configuration data file update| |firmware|2|A firmware update|-|other|3|All other update types| +|other|3|All other update types| |
v1.0 | Intune Deviceconfig Macossoftwareupdatecategorysummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macossoftwareupdatecategorysummary.md | Here is a JSON representation of the resource. "totalUpdateCount": 1024, "lastUpdatedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Deviceconfig Macossoftwareupdateconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macossoftwareupdateconfiguration.md | Here is a JSON representation of the resource. "maxUserDeferralsCount": 1024, "priority": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Macossoftwareupdatedelaypolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macossoftwareupdatedelaypolicy.md | Flag enum to determine whether to delay software updates for macOS. |delayOSUpdateVisibility|1|Force delays for OS software updates.| |delayAppUpdateVisibility|2|Force delays for app software updates.| |unknownFutureValue|4|Sentinel member for cases where the client cannot handle the new enum values.|-|delayMajorOsUpdateVisibility|8|Force delays for major OS software updates.| +|delayMajorOsUpdateVisibility|8|Force delays for major OS software updates.| |
v1.0 | Intune Deviceconfig Macossoftwareupdatescheduletype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macossoftwareupdatescheduletype.md | Update schedule type for macOS software updates. |:|:|:| |alwaysUpdate|0|Always update.| |updateDuringTimeWindows|1|Update during time windows.|-|updateOutsideOfTimeWindows|2|Update outside of time windows.| +|updateOutsideOfTimeWindows|2|Update outside of time windows.| |
v1.0 | Intune Deviceconfig Macossoftwareupdatestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macossoftwareupdatestate.md | MacOS Software Update State |installInsufficientSpace|2004|There is not enough space to install the update| |installInsufficientPower|2005|There is not enough power to install the update| |installFailed|2006|Installation has failed for an unspecified reason|-|commandFailed|2007|The schedule update command has failed for an unspecified reason| +|commandFailed|2007|The schedule update command has failed for an unspecified reason| |
v1.0 | Intune Deviceconfig Macossoftwareupdatestatesummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macossoftwareupdatestatesummary.md | Here is a JSON representation of the resource. "state": "String", "lastUpdatedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Deviceconfig Macossystemextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macossystemextension.md | Here is a JSON representation of the resource. "teamIdentifier": "String", "bundleId": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Macossystemextensiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macossystemextensiontype.md | Flag enum representing the allowed macOS system extension types. |:|:|:| |driverExtensionsAllowed|1|Enables driver extensions.| |networkExtensionsAllowed|2|Enables network extensions.|-|endpointSecurityExtensionsAllowed|4|Enables endpoint security extensions.| +|endpointSecurityExtensionsAllowed|4|Enables endpoint security extensions.| |
v1.0 | Intune Deviceconfig Macossystemextensiontypemapping | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macossystemextensiontypemapping.md | Here is a JSON representation of the resource. "teamIdentifier": "String", "allowedTypes": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Macostrustedrootcertificate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macostrustedrootcertificate.md | Here is a JSON representation of the resource. "trustedRootCertificate": "binary", "certFileName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Macosvpnconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macosvpnconfiguration.md | Here is a JSON representation of the resource. }, "optInToDeviceIdSharing": true }-``` +``` |
v1.0 | Intune Deviceconfig Macoswificonfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macoswificonfiguration.md | Here is a JSON representation of the resource. "proxyAutomaticConfigurationUrl": "String", "preSharedKey": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Macoswirednetworkconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-macoswirednetworkconfiguration.md | Here is a JSON representation of the resource. "nonEapAuthenticationMethodForEapTtls": "String", "enableOuterIdentityPrivacy": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Managedalldevicecertificatestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-managedalldevicecertificatestate.md | Here is a JSON representation of the resource. "certificateExtendedKeyUsages": "String", "certificateIssuanceDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Deviceconfig Manageddevicecertificatestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-manageddevicecertificatestate.md | Here is a JSON representation of the resource. "certificateIssuanceDateTime": "String (timestamp)", "certificateErrorCode": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Manageddeviceencryptionstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-manageddeviceencryptionstate.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Manageddevicemobileappconfigurationsettingstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-manageddevicemobileappconfigurationsettingstate.md | Here is a JSON representation of the resource. "currentValue": "String", "settingInstanceId": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Manageddevicereportedapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-manageddevicereportedapp.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.managedDeviceReportedApp", "appId": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Managementagenttype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-managementagenttype.md | Management agent type. |googleCloudDevicePolicyController|64|The device is managed by Google's CloudDPC.| |microsoft365ManagedMdm|258|This device is managed by Microsoft 365 through Intune.| |msSense|1024||-|intuneAosp|2048|This device is managed by Intune's MDM for AOSP (Android Open Source Project) devices| +|intuneAosp|2048|This device is managed by Intune's MDM for AOSP (Android Open Source Project) devices| |
v1.0 | Intune Deviceconfig Mediacontentratingaustralia | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-mediacontentratingaustralia.md | Here is a JSON representation of the resource. "movieRating": "String", "tvRating": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Mediacontentratingcanada | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-mediacontentratingcanada.md | Here is a JSON representation of the resource. "movieRating": "String", "tvRating": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Mediacontentratingfrance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-mediacontentratingfrance.md | Here is a JSON representation of the resource. "movieRating": "String", "tvRating": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Mediacontentratinggermany | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-mediacontentratinggermany.md | Here is a JSON representation of the resource. "movieRating": "String", "tvRating": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Mediacontentratingireland | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-mediacontentratingireland.md | Here is a JSON representation of the resource. "movieRating": "String", "tvRating": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Mediacontentratingjapan | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-mediacontentratingjapan.md | Here is a JSON representation of the resource. "movieRating": "String", "tvRating": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Mediacontentratingnewzealand | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-mediacontentratingnewzealand.md | Here is a JSON representation of the resource. "movieRating": "String", "tvRating": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Mediacontentratingunitedkingdom | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-mediacontentratingunitedkingdom.md | Here is a JSON representation of the resource. "movieRating": "String", "tvRating": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Mediacontentratingunitedstates | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-mediacontentratingunitedstates.md | Here is a JSON representation of the resource. "movieRating": "String", "tvRating": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Meteredconnectionlimittype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-meteredconnectionlimittype.md | Metered Connection Limit Settings. |:|:|:| |unrestricted|0|Unrestricted| |fixed|1|Fixed|-|variable|2|Variable| +|variable|2|Variable| |
v1.0 | Intune Deviceconfig Microsoftlauncherdockpresence | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-microsoftlauncherdockpresence.md | Microsoft Launcher Dock Presence selection. |notConfigured|0|Not configured; this value is ignored.| |show|1|Indicates the device's dock will be displayed on the device.| |hide|2|Indicates the device's dock will be hidden on the device, but the user can access the dock by dragging the handler on the bottom of the screen.|-|disabled|3|Indicates the device's dock will be disabled on the device.| +|disabled|3|Indicates the device's dock will be disabled on the device.| |
v1.0 | Intune Deviceconfig Microsoftlaunchersearchbarplacement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-microsoftlaunchersearchbarplacement.md | Microsoft Launcher Search Bar Placement selection. |notConfigured|0|Not configured; this value is ignored.| |top|1|Indicates that the search bar will be displayed on the top of the device.| |bottom|2|Indicates that the search bar will be displayed on the bottom of the device.|-|hide|3|Indicates that the search bar will be hidden on the device.| +|hide|3|Indicates that the search bar will be hidden on the device.| |
v1.0 | Intune Deviceconfig Miracastchannel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-miracastchannel.md | Possible values for Miracast channel. |oneHundredFiftyThree|153|OneHundredFifty-Three.| |oneHundredFiftySeven|157|OneHundredFifty-Seven.| |oneHundredSixtyOne|161|OneHundredSixty-One.|-|oneHundredSixtyFive|165|OneHundredSixty-Five.| +|oneHundredSixtyFive|165|OneHundredSixty-Five.| |
v1.0 | Intune Deviceconfig Ndesconnector | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ndesconnector.md | Here is a JSON representation of the resource. ], "connectorVersion": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Ndesconnectorstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ndesconnectorstate.md | The current status of the Ndes Connector. |:|:|:| |none|0|State not available yet for this connector.| |active|1|Ndes connector has connected recently|-|inactive|2|No recent activity for the Ndes connector| +|inactive|2|No recent activity for the Ndes connector| |
v1.0 | Intune Deviceconfig Networksinglesignontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-networksinglesignontype.md | Wi-Fi Network Single Sign On Type Settings. |:|:|:| |disabled|0|Disabled| |prelogon|1|Pre-Logon|-|postlogon|2|Post-Logon| +|postlogon|2|Post-Logon| |
v1.0 | Intune Deviceconfig Noneapauthenticationmethodforeapttlstype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-noneapauthenticationmethodforeapttlstype.md | Non-EAP methods for authentication. |unencryptedPassword|0|Unencrypted password (PAP).| |challengeHandshakeAuthenticationProtocol|1|Challenge Handshake Authentication Protocol (CHAP).| |microsoftChap|2| Microsoft CHAP (MS-CHAP).|-|microsoftChapVersionTwo|3|Microsoft CHAP Version 2 (MS-CHAP v2).| +|microsoftChapVersionTwo|3|Microsoft CHAP Version 2 (MS-CHAP v2).| |
v1.0 | Intune Deviceconfig Noneapauthenticationmethodforpeap | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-noneapauthenticationmethodforpeap.md | Non-EAP methods for authentication when PEAP is the selected EAP type. |Member|Value|Description| |:|:|:| |none|0|None.|-|microsoftChapVersionTwo|1|Microsoft CHAP Version 2 (MS-CHAP v2).| +|microsoftChapVersionTwo|1|Microsoft CHAP Version 2 (MS-CHAP v2).| |
v1.0 | Intune Deviceconfig Numberrange | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-numberrange.md | Here is a JSON representation of the resource. "lowerNumber": 1024, "upperNumber": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Omasetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-omasetting.md | Here is a JSON representation of the resource. "secretReferenceValueId": "String", "isEncrypted": true }-``` +``` |
v1.0 | Intune Deviceconfig Omasettingbase64 | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-omasettingbase64.md | Here is a JSON representation of the resource. "fileName": "String", "value": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Omasettingboolean | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-omasettingboolean.md | Here is a JSON representation of the resource. "isEncrypted": true, "value": true }-``` +``` |
v1.0 | Intune Deviceconfig Omasettingdatetime | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-omasettingdatetime.md | Here is a JSON representation of the resource. "isEncrypted": true, "value": "String (timestamp)" }-``` +``` |
v1.0 | Intune Deviceconfig Omasettingfloatingpoint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-omasettingfloatingpoint.md | Here is a JSON representation of the resource. "isEncrypted": true, "value": 4.2 }-``` +``` |
v1.0 | Intune Deviceconfig Omasettinginteger | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-omasettinginteger.md | Here is a JSON representation of the resource. "value": 1024, "isReadOnly": true }-``` +``` |
v1.0 | Intune Deviceconfig Omasettingstring | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-omasettingstring.md | Here is a JSON representation of the resource. "isEncrypted": true, "value": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Omasettingstringxml | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-omasettingstringxml.md | Here is a JSON representation of the resource. "fileName": "String", "value": "binary" }-``` +``` |
v1.0 | Intune Deviceconfig Operatingsystemversionrange | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-operatingsystemversionrange.md | Here is a JSON representation of the resource. "lowestVersion": "String", "highestVersion": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Operator | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-operator.md | Operator for rules. |setEquals|21|SetEquals operator.| |orderedSetEquals|22|OrderedSetEquals operator.| |subsetOf|23|SubsetOf operator.|-|excludesAll|24|ExcludesAll operator.| +|excludesAll|24|ExcludesAll operator.| |
v1.0 | Intune Deviceconfig Perfectforwardsecrecygroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-perfectforwardsecrecygroup.md | Forward Secrecy Group values for Windows10 VPN policies with IKEv2 connection ty |ecp256|3|ECP256| |ecp384|4|ECP384| |pfsMM|5|PFSMM|-|pfs24|6|PFS24| +|pfs24|6|PFS24| |
v1.0 | Intune Deviceconfig Personalprofilepersonalplaystoremode | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-personalprofilepersonalplaystoremode.md | Used together with personalApplications to control how apps in the personal prof |:|:|:| |notConfigured|0|Not configured.| |blockedApps|1|Blocked Apps.|-|allowedApps|2|Allowed Apps.| +|allowedApps|2|Allowed Apps.| |
v1.0 | Intune Deviceconfig Policyplatformtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-policyplatformtype.md | Supported platform types for policies. |androidWorkProfile|7|AndroidWorkProfile.| |windows10XProfile|8|Windows10XProfile.| |androidAOSP|9|AndroidAOSPProfile.|-|all|100|All platforms.| +|all|100|All platforms.| |
v1.0 | Intune Deviceconfig Poweractiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-poweractiontype.md | Power action types |noAction|1|No action| |sleep|2|Put device in sleep state| |hibernate|3|Put device in hibernate state|-|shutdown|4|Shutdown device| +|shutdown|4|Shutdown device| |
v1.0 | Intune Deviceconfig Prereleasefeatures | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-prereleasefeatures.md | Possible values for pre-release features. |userDefined|0|User Defined, default value, no intent.| |settingsOnly|1|Settings only pre-release features.| |settingsAndExperimentations|2|Settings and experimentations pre-release features.|-|notAllowed|3|Pre-release features not allowed.| +|notAllowed|3|Pre-release features not allowed.| |
v1.0 | Intune Deviceconfig Ratingappstype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ratingappstype.md | Apps rating as in media content |agesAbove4|2|4+, age 4 and above| |agesAbove9|3|9+, age 9 and above| |agesAbove12|4|12+, age 12 and above |-|agesAbove17|5|17+, age 17 and above| +|agesAbove17|5|17+, age 17 and above| |
v1.0 | Intune Deviceconfig Ratingaustraliamoviestype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ratingaustraliamoviestype.md | Movies rating labels in Australia |parentalGuidance|3|The PG recommends viewers under 15 with guidance from parents or guardians| |mature|4|The M classification is not recommended for viewers under 15| |agesAbove15|5|The MA15+ classification is not suitable for viewers under 15|-|agesAbove18|6|The R18+ classification is not suitable for viewers under 18| +|agesAbove18|6|The R18+ classification is not suitable for viewers under 18| |
v1.0 | Intune Deviceconfig Ratingaustraliatelevisiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ratingaustraliatelevisiontype.md | TV content rating labels in Australia |parentalGuidance|5|The PG classification is recommended for young viewers| |mature|6|The M classification is recommended for viewers over 15| |agesAbove15|7|The MA15+ classification is not suitable for viewers under 15|-|agesAbove15AdultViolence|8|The AV15+ classification is not suitable for viewers under 15, adult violence-specific| +|agesAbove15AdultViolence|8|The AV15+ classification is not suitable for viewers under 15, adult violence-specific| |
v1.0 | Intune Deviceconfig Ratingcanadamoviestype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ratingcanadamoviestype.md | Movies rating labels in Canada |parentalGuidance|3|The PG classification advises parental guidance| |agesAbove14|4|The 14A classification is suitable for viewers above 14 or older| |agesAbove18|5|The 18A classification is suitable for viewers above 18 or older|-|restricted|6|The R classification is restricted to 18 years and older| +|restricted|6|The R classification is restricted to 18 years and older| |
v1.0 | Intune Deviceconfig Ratingcanadatelevisiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ratingcanadatelevisiontype.md | TV content rating labels in Canada |general|4|The G classification is suitable for general audience| |parentalGuidance|5|PG, Parental Guidance| |agesAbove14|6|The 14+ classification is intended for viewers ages 14 and older|-|agesAbove18|7|The 18+ classification is intended for viewers ages 18 and older| +|agesAbove18|7|The 18+ classification is intended for viewers ages 18 and older| |
v1.0 | Intune Deviceconfig Ratingfrancemoviestype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ratingfrancemoviestype.md | Movies rating labels in France |agesAbove10|2|The 10 classification prohibits the screening of the film to minors under 10| |agesAbove12|3|The 12 classification prohibits the screening of the film to minors under 12| |agesAbove16|4|The 16 classification prohibits the screening of the film to minors under 16|-|agesAbove18|5|The 18 classification prohibits the screening to minors under 18| +|agesAbove18|5|The 18 classification prohibits the screening to minors under 18| |
v1.0 | Intune Deviceconfig Ratingfrancetelevisiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ratingfrancetelevisiontype.md | TV content rating labels in France |agesAbove10|2|The -10 classification is not recommended for children under 10| |agesAbove12|3|The -12 classification is not recommended for children under 12| |agesAbove16|4|The -16 classification is not recommended for children under 16|-|agesAbove18|5|The -18 classification is not recommended for persons under 18| +|agesAbove18|5|The -18 classification is not recommended for persons under 18| |
v1.0 | Intune Deviceconfig Ratinggermanymoviestype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ratinggermanymoviestype.md | Movies rating labels in Germany |agesAbove6|3|Ab 6 Jahren, ages 6 and older| |agesAbove12|4|Ab 12 Jahren, ages 12 and older| |agesAbove16|5|Ab 16 Jahren, ages 16 and older|-|adults|6|Ab 18 Jahren, adults only| +|adults|6|Ab 18 Jahren, adults only| |
v1.0 | Intune Deviceconfig Ratinggermanytelevisiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ratinggermanytelevisiontype.md | TV content rating labels in Germany |agesAbove6|3|Ab 6 Jahren, ages 6 and older| |agesAbove12|4|Ab 12 Jahren, ages 12 and older| |agesAbove16|5|Ab 16 Jahren, ages 16 and older|-|adults|6|Ab 18 Jahren, adults only| +|adults|6|Ab 18 Jahren, adults only| |
v1.0 | Intune Deviceconfig Ratingirelandmoviestype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ratingirelandmoviestype.md | Movies rating labels in Ireland |agesAbove12|4|The 12A classification is suitable for viewers of 12 or older| |agesAbove15|5|The 15A classification is suitable for viewers of 15 or older| |agesAbove16|6|The 16 classification is suitable for viewers of 16 or older|-|adults|7|The 18 classification, suitable only for adults| +|adults|7|The 18 classification, suitable only for adults| |
v1.0 | Intune Deviceconfig Ratingirelandtelevisiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ratingirelandtelevisiontype.md | TV content rating labels in Ireland |children|3|The CH classification is suitable for children| |youngAdults|4|The YA classification is suitable for teenage audience| |parentalSupervision|5|The PS classification invites parents and guardians to consider restriction childrenΓÇÖs access|-|mature|6|The MA classification is suitable for adults| +|mature|6|The MA classification is suitable for adults| |
v1.0 | Intune Deviceconfig Ratingjapanmoviestype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ratingjapanmoviestype.md | Movies rating labels in Japan |general|2|Suitable for all ages| |parentalGuidance|3|The PG-12 classification requests parental guidance for young people under 12| |agesAbove15|4|The R15+ classification is suitable for viewers of 15 or older|-|agesAbove18|5|The R18+ classification is suitable for viewers of 18 or older| +|agesAbove18|5|The R18+ classification is suitable for viewers of 18 or older| |
v1.0 | Intune Deviceconfig Ratingjapantelevisiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ratingjapantelevisiontype.md | TV content rating labels in Japan |:|:|:| |allAllowed|0|Default value, allow all TV shows content| |allBlocked|1|Do not allow any TV shows content|-|explicitAllowed|2|All TV content is explicitly allowed| +|explicitAllowed|2|All TV content is explicitly allowed| |
v1.0 | Intune Deviceconfig Ratingnewzealandmoviestype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ratingnewzealandmoviestype.md | Movies rating labels in New Zealand |agesAbove16|7|The R16 classification is restricted to persons 16 years and over| |agesAbove18|8|The R18 classification is restricted to persons 18 years and over| |restricted|9|The R classification is restricted to a certain audience|-|agesAbove16Restricted|10|The RP16 classification requires viewers under 16 accompanied by a parent or an adult| +|agesAbove16Restricted|10|The RP16 classification requires viewers under 16 accompanied by a parent or an adult| |
v1.0 | Intune Deviceconfig Ratingnewzealandtelevisiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ratingnewzealandtelevisiontype.md | TV content rating labels in New Zealand |allBlocked|1|Do not allow any TV shows content| |general|2|The G classification excludes materials likely to harm children under 14| |parentalGuidance|3|The PGR classification encourages parents and guardians to supervise younger viewers|-|adults|4|The AO classification is not suitable for children| +|adults|4|The AO classification is not suitable for children| |
v1.0 | Intune Deviceconfig Ratingunitedkingdommoviestype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ratingunitedkingdommoviestype.md | Movies rating labels in United Kingdom |agesAbove12Video|5|12, video release suitable for 12 years and over| |agesAbove12Cinema|6|12A, cinema release suitable for 12 years and over| |agesAbove15|7|15, suitable only for 15 years and older|-|adults|8|Suitable only for adults| +|adults|8|Suitable only for adults| |
v1.0 | Intune Deviceconfig Ratingunitedkingdomtelevisiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ratingunitedkingdomtelevisiontype.md | TV content rating labels in United Kingdom |:|:|:| |allAllowed|0|Default value, allow all TV shows content| |allBlocked|1|Do not allow any TV shows content|-|caution|2|Allowing TV contents with a warning message| +|caution|2|Allowing TV contents with a warning message| |
v1.0 | Intune Deviceconfig Ratingunitedstatesmoviestype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ratingunitedstatesmoviestype.md | Movies rating labels in United States |parentalGuidance|3|PG, some material may not be suitable for children| |parentalGuidance13|4|PG13, some material may be inappropriate for children under 13| |restricted|5|R, viewers under 17 require accompanying parent or adult guardian|-|adults|6|NC17, adults only| +|adults|6|NC17, adults only| |
v1.0 | Intune Deviceconfig Ratingunitedstatestelevisiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-ratingunitedstatestelevisiontype.md | TV content rating labels in United States |general|4|TV-G, suitable for all ages| |parentalGuidance|5|TV-PG, parental guidance| |childrenAbove14|6|TV-14, children age 14 and above|-|adults|7|TV-MA, adults only| +|adults|7|TV-MA, adults only| |
v1.0 | Intune Deviceconfig Redirectsinglesignonextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-redirectsinglesignonextension.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceconfig Report | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-report.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.report", "content": "Stream" }-``` +``` |
v1.0 | Intune Deviceconfig Reportroot | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-reportroot.md | The resource that represents an instance of History Reports. ## Methods |Method|Return Type|Description| |:|:|:|-|[Get reportRoot](../api/intune-deviceconfig-reportroot-get.md)|[reportRoot](../resources/intune-deviceconfig-reportroot.md)|Read properties and relationships of the [reportRoot](../resources/intune-deviceconfig-reportroot.md) object.| -|[Update reportRoot](../api/intune-deviceconfig-reportroot-update.md)|[reportRoot](../resources/intune-deviceconfig-reportroot.md)|Update the properties of a [reportRoot](../resources/intune-deviceconfig-reportroot.md) object.| -|[deviceConfigurationUserActivity function](../api/intune-deviceconfig-reportroot-deviceconfigurationuseractivity.md)|[report](../resources/intune-deviceconfig-report.md)|Metadata for the device configuration user activity report| -|[deviceConfigurationDeviceActivity function](../api/intune-deviceconfig-reportroot-deviceconfigurationdeviceactivity.md)|[report](../resources/intune-deviceconfig-report.md)|Metadata for the device configuration device activity report| +|[Get reportRoot](../api/intune-deviceconfig-reportroot-get.md)|[reportRoot](../resources/intune-shared-reportroot.md)|Read properties and relationships of the [reportRoot](../resources/intune-shared-reportroot.md) object.| +|[Update reportRoot](../api/intune-deviceconfig-reportroot-update.md)|[reportRoot](../resources/intune-shared-reportroot.md)|Update the properties of a [reportRoot](../resources/intune-shared-reportroot.md) object.| +|[deviceConfigurationUserActivity function](../api/intune-deviceconfig-reportroot-deviceconfigurationuseractivity.md)|[report](../resources/intune-shared-report.md)|Metadata for the device configuration user activity report| +|[deviceConfigurationDeviceActivity function](../api/intune-deviceconfig-reportroot-deviceconfigurationdeviceactivity.md)|[report](../resources/intune-shared-report.md)|Metadata for the device configuration device activity report| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.reportRoot", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Deviceconfig Requiredpasswordtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-requiredpasswordtype.md | Possible values of required passwords. |:|:|:| |deviceDefault|0|Device default value, no intent.| |alphanumeric|1|Alphanumeric password required.|-|numeric|2|Numeric password required.| +|numeric|2|Numeric password required.| |
v1.0 | Intune Deviceconfig Restrictedappsstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-restrictedappsstate.md | Restricted apps state |Member|Value|Description| |:|:|:| |prohibitedApps|0|Prohibited apps|-|notApprovedApps|1|Not approved apps| +|notApprovedApps|1|Not approved apps| |
v1.0 | Intune Deviceconfig Restrictedappsviolation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-restrictedappsviolation.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Retirescheduledmanageddevice | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-retirescheduledmanageddevice.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceconfig Runstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-runstate.md | Indicates the type of execution status of the device management script. |fail|2|Script failed to run.| |scriptError|3|Discovery script hits error.| |pending|4|Script is pending to execute.|-|notApplicable|5|Script is not applicable for this device.| +|notApplicable|5|Script is not applicable for this device.| |
v1.0 | Intune Deviceconfig Safesearchfiltertype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-safesearchfiltertype.md | Specifies what level of safe search (filtering adult content) is required |:|:|:| |userDefined|0|User Defined, default value, no intent.| |strict|1|Strict, highest filtering against adult content.|-|moderate|2|Moderate filtering against adult content (valid search results will not be filtered).| +|moderate|2|Moderate filtering against adult content (valid search results will not be filtered).| |
v1.0 | Intune Deviceconfig Scheduledretirestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-scheduledretirestate.md | Cancel or confirm scheduled retire |:|:|:| |cancelRetire|0|CancelRetire| |confirmRetire|1|ConfirmRetire|-|unknownFutureValue|2|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|2|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Deviceconfig Secureassessmentaccounttype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-secureassessmentaccounttype.md | Type of accounts that are allowed for Windows10SecureAssessment ConfigurationAcc |azureADAccount|0|Indicates an Azure AD account in format of AzureAD\username@tenant.com.| |domainAccount|1|Indicates a domain account in format of domain\user or user@domain.com.| |localAccount|2|Indicates a local account in format of username.|-|localGuestAccount|3|Indicates a local guest account in format of test name.| +|localGuestAccount|3|Indicates a local guest account in format of test name.| |
v1.0 | Intune Deviceconfig Securebootwithdmatype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-securebootwithdmatype.md | Possible values of Secure Boot with DMA |:|:|:| |notConfigured|0|Not configured, no operation| |withoutDMA|1|Turns on VBS with Secure Boot|-|withDMA|3|Turns on VBS with Secure Boot and DMA| +|withDMA|3|Turns on VBS with Secure Boot and DMA| |
v1.0 | Intune Deviceconfig Servicestarttype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-servicestarttype.md | Possible values of xbox service start type |:|:|:| |manual|0|Manual service start type(default)| |automatic|1|Automatic service start type|-|disabled|2|Service start type disabled| +|disabled|2|Service start type disabled| |
v1.0 | Intune Deviceconfig Settingsource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-settingsource.md | Here is a JSON representation of the resource. "displayName": "String", "sourceType": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Settingstatedevicesummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-settingstatedevicesummary.md | Here is a JSON representation of the resource. "errorDeviceCount": 1024, "conflictDeviceCount": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Sharedpcaccountdeletionpolicytype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-sharedpcaccountdeletionpolicytype.md | Possible values for when accounts are deleted on a shared PC. |:|:|:| |immediate|0|Delete immediately.| |diskSpaceThreshold|1|Delete at disk space threshold.|-|diskSpaceThresholdOrInactiveThreshold|2|Delete at disk space threshold or inactive threshold.| +|diskSpaceThresholdOrInactiveThreshold|2|Delete at disk space threshold or inactive threshold.| |
v1.0 | Intune Deviceconfig Sharedpcaccountmanagerpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-sharedpcaccountmanagerpolicy.md | Here is a JSON representation of the resource. "inactiveThresholdDays": 1024, "removeAccountsBelowDiskFreePercentage": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Sharedpcallowedaccounttype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-sharedpcallowedaccounttype.md | Type of accounts that are allowed to share the PC. |:|:|:| |notConfigured|0|Not configured. Default value.| |guest|1|Only guest accounts.|-|domain|2|Only domain-joined accounts.| +|domain|2|Only domain-joined accounts.| |
v1.0 | Intune Deviceconfig Sharedpcconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-sharedpcconfiguration.md | Here is a JSON representation of the resource. "maintenanceStartTime": "String (time of day)", "fastFirstSignIn": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Signinassistantoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-signinassistantoptions.md | Values for the SignInAssistantSettings. |Member|Value|Description| |:|:|:| |notConfigured|0|Not configured - wlidsvc Start will be set to SERVICE_DEMAND_START.|-|disabled|1|Disabled - wlidsvc Start will be set to SERVICE_DISABLED.| +|disabled|1|Disabled - wlidsvc Start will be set to SERVICE_DISABLED.| |
v1.0 | Intune Deviceconfig Singlesignonextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-singlesignonextension.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.singleSignOnExtension" }-``` +``` |
v1.0 | Intune Deviceconfig Sitesecuritylevel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-sitesecuritylevel.md | Possible values for site security level. |mediumLow|2|Medium-low.| |medium|3|Medium.| |mediumHigh|4|Medium-high.|-|high|5|High.| +|high|5|High.| |
v1.0 | Intune Deviceconfig Softwareupdatestatussummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-softwareupdatestatussummary.md | Here is a JSON representation of the resource. "conflictUserCount": 1024, "notApplicableUserCount": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Specifiedcaptivenetworkplugins | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-specifiedcaptivenetworkplugins.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceconfig Statemanagementsetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-statemanagementsetting.md | State Management Setting. |:|:|:| |notConfigured|0|Not configured.| |blocked|1|Blocked.|-|allowed|2|Allowed.| +|allowed|2|Allowed.| |
v1.0 | Intune Deviceconfig Subjectnameformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-subjectnameformat.md | Subject Name Format Options. |commonNameAsSerialNumber|6|Common Name As Serial Number.| |commonNameAsAadDeviceId|7|Common Name As Serial Number.| |commonNameAsIntuneDeviceId|8|Common Name As Serial Number.|-|commonNameAsDurableDeviceId|9|Common Name As Serial Number.| +|commonNameAsDurableDeviceId|9|Common Name As Serial Number.| |
v1.0 | Intune Deviceconfig Unsupporteddeviceconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-unsupporteddeviceconfiguration.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Unsupporteddeviceconfigurationdetail | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-unsupporteddeviceconfigurationdetail.md | Here is a JSON representation of the resource. "message": "String", "propertyName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Updateclassification | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-updateclassification.md | Possible values for automatic update classification. |userDefined|0|User Defined, default value, no intent.| |recommendedAndImportant|1|Recommended and important.| |important|2|Important.|-|none|3|None.| +|none|3|None.| |
v1.0 | Intune Deviceconfig Useremailsource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-useremailsource.md | Possible values for username source or email source. |Member|Value|Description| |:|:|:| |userPrincipalName|0|User principal name.|-|primarySmtpAddress|1|Primary SMTP address.| +|primarySmtpAddress|1|Primary SMTP address.| |
v1.0 | Intune Deviceconfig Usernamesource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-usernamesource.md | Username source. |:|:|:| |userPrincipalName|0|User principal name.| |primarySmtpAddress|1|Primary SMTP address.|-|samAccountName|2|The user sam account name.| +|samAccountName|2|The user sam account name.| |
v1.0 | Intune Deviceconfig Visibilitysetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-visibilitysetting.md | Generic visibility state. |:|:|:| |notConfigured|0|Not configured.| |hide|1|Hide.|-|show|2|Show.| +|show|2|Show.| |
v1.0 | Intune Deviceconfig Vpnauthenticationmethod | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpnauthenticationmethod.md | VPN Authentication Method. |usernameAndPassword|1|Use username and password for authentication.| |sharedSecret|2|Use Shared Secret for Authentication. Only valid for iOS IKEv2.| |derivedCredential|3|Use Derived Credential for Authentication.|-|azureAD|4|Use Azure AD for authentication.| +|azureAD|4|Use Azure AD for authentication.| |
v1.0 | Intune Deviceconfig Vpnclientauthenticationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpnclientauthenticationtype.md | The type of VPN client authentication type |Member|Value|Description| |:|:|:| |userAuthentication|0|User Authentication|-|deviceAuthentication|1|Device Authentication| +|deviceAuthentication|1|Device Authentication| |
v1.0 | Intune Deviceconfig Vpnconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpnconfiguration.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Vpndeadpeerdetectionrate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpndeadpeerdetectionrate.md | Determines how often to check if a peer connection is still alive |medium|0|Medium| |none|1|None| |low|2|Low|-|high|3|High| +|high|3|High| |
v1.0 | Intune Deviceconfig Vpndnsrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpndnsrule.md | Here is a JSON representation of the resource. "autoTrigger": true, "persistent": true }-``` +``` |
v1.0 | Intune Deviceconfig Vpnencryptionalgorithmtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpnencryptionalgorithmtype.md | The type of VPN security association encryption algorithm |aes256Gcm|5|AES-256-GCM| |aes192|6|AES-192| |aes192Gcm|7|AES-192-GCM|-|chaCha20Poly1305|8|ChaCha20Poly1305| +|chaCha20Poly1305|8|ChaCha20Poly1305| |
v1.0 | Intune Deviceconfig Vpnintegrityalgorithmtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpnintegrityalgorithmtype.md | The type of VPN security association integrity algorithm |sha1_160|2|SHA1-160| |sha2_384|3|SHA2-384| |sha2_512|4|SHA2-512|-|md5|5|MD5| +|md5|5|MD5| |
v1.0 | Intune Deviceconfig Vpnlocalidentifier | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpnlocalidentifier.md | The type of VPN local identifier |:|:|:| |deviceFQDN|0|Device Fully Qualified Domain Name| |empty|1|Empty|-|clientCertificateSubjectName|2|Client Certificate Subject Name| +|clientCertificateSubjectName|2|Client Certificate Subject Name| |
v1.0 | Intune Deviceconfig Vpnondemandrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpnondemandrule.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceconfig Vpnondemandruleconnectionaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpnondemandruleconnectionaction.md | VPN On-Demand Rule Connection Action. |connect|0|Connect.| |evaluateConnection|1|Evaluate Connection.| |ignore|2|Ignore.|-|disconnect|3|Disconnect.| +|disconnect|3|Disconnect.| |
v1.0 | Intune Deviceconfig Vpnondemandruleconnectiondomainaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpnondemandruleconnectiondomainaction.md | VPN On-Demand Rule Connection Domain Action. |Member|Value|Description| |:|:|:| |connectIfNeeded|0|Connect if needed.|-|neverConnect|1|Never connect.| +|neverConnect|1|Never connect.| |
v1.0 | Intune Deviceconfig Vpnondemandruleinterfacetypematch | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpnondemandruleinterfacetypematch.md | VPN On-Demand Rule Connection network interface type. |notConfigured|0|NotConfigured| |ethernet|1|Ethernet.| |wiFi|2|WiFi.|-|cellular|3|Cellular.| +|cellular|3|Cellular.| |
v1.0 | Intune Deviceconfig Vpnprovidertype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpnprovidertype.md | Provider type for per-app VPN. |:|:|:| |notConfigured|0|Tunnel traffic is not explicitly configured.| |appProxy|1|Tunnel traffic at the application layer.|-|packetTunnel|2|Tunnel traffic at the IP layer.| +|packetTunnel|2|Tunnel traffic at the IP layer.| |
v1.0 | Intune Deviceconfig Vpnproxyserver | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpnproxyserver.md | Here is a JSON representation of the resource. "address": "String", "port": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Vpnroute | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpnroute.md | Here is a JSON representation of the resource. "destinationPrefix": "String", "prefixSize": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Vpnserver | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpnserver.md | Here is a JSON representation of the resource. "address": "String", "isDefaultServer": true }-``` +``` |
v1.0 | Intune Deviceconfig Vpnservercertificatetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpnservercertificatetype.md | The type of certificate the VPN server will present to the VPN client for authen |rsa|0|RSA| |ecdsa256|1|ECDSA256| |ecdsa384|2|ECDSA384|-|ecdsa521|3|ECDSA521| +|ecdsa521|3|ECDSA521| |
v1.0 | Intune Deviceconfig Vpnserviceexceptionaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpnserviceexceptionaction.md | The VPN action to take for a specific service. |:|:|:| |forceTrafficViaVPN|0|Make all traffic from that service go through the VPN| |allowTrafficOutside|1|Allow the service outside of the VPN|-|dropTraffic|2|Drop all traffic from the service| +|dropTraffic|2|Drop all traffic from the service| |
v1.0 | Intune Deviceconfig Vpntrafficdirection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpntrafficdirection.md | Specify whether the rule applies to inbound traffic or outbound traffic. |:|:|:| |outbound|0|The rule applies to all outbound traffic.| |inbound|1|The rule applies to all inbound traffic.|-|unknownFutureValue|2|Evolvable enum member| +|unknownFutureValue|2|Evolvable enum member| |
v1.0 | Intune Deviceconfig Vpntrafficrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpntrafficrule.md | Here is a JSON representation of the resource. "claims": "String", "vpnTrafficDirection": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Vpntrafficruleapptype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpntrafficruleapptype.md | Indicates the type of app that a VPN traffic rule is associated with. |:|:|:| |none|0|The traffic rule is not associated with an app.| |desktop|1|The traffic rule is associated with a desktop app.|-|universal|2|The traffic rule is associated with a Universal app.| +|universal|2|The traffic rule is associated with a Universal app.| |
v1.0 | Intune Deviceconfig Vpntrafficruleroutingpolicytype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpntrafficruleroutingpolicytype.md | Specifies the routing policy for a VPN traffic rule. |:|:|:| |none|0|No routing policy specified.| |splitTunnel|1|Network traffic for the specified app will be routed through the VPN.|-|forceTunnel|2|All network traffic will be routed through the VPN.| +|forceTunnel|2|All network traffic will be routed through the VPN.| |
v1.0 | Intune Deviceconfig Vpntunnelconfigurationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-vpntunnelconfigurationtype.md | The type of tunnels that will be present to the VPN client for configuration |:|:|:| |wifiAndCellular|0|WiFi and Cellular Tunnels| |cellular|1|Cellular Tunnel Only|-|wifi|2|WiFi Tunnel Only| +|wifi|2|WiFi Tunnel Only| |
v1.0 | Intune Deviceconfig Webbrowsercookiesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-webbrowsercookiesettings.md | Web Browser Cookie Settings. |blockAlways|1|Always block cookies.| |allowCurrentWebSite|2|Allow cookies from current Web site.| |allowFromWebsitesVisited|3|Allow Cookies from websites visited.|-|allowAlways|4|Always allow cookies.| +|allowAlways|4|Always allow cookies.| |
v1.0 | Intune Deviceconfig Weeklyschedule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-weeklyschedule.md | Possible values for a weekly schedule. |thursday|6|Thursday.| |friday|7|Friday.| |saturday|8|Saturday.|-|noScheduledScan|9|No Scheduled Scan| +|noScheduledScan|9|No Scheduled Scan| |
v1.0 | Intune Deviceconfig Welcomescreenmeetinginformation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-welcomescreenmeetinginformation.md | Possible values for welcome screen meeting information. |:|:|:| |userDefined|0|User Defined, default value, no intent.| |showOrganizerAndTimeOnly|1|Show organizer and time only.|-|showOrganizerAndTimeAndSubject|2|Show organizer, time and subject (subject is hidden for private meetings).| +|showOrganizerAndTimeAndSubject|2|Show organizer, time and subject (subject is hidden for private meetings).| |
v1.0 | Intune Deviceconfig Wifiauthenticationmethod | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-wifiauthenticationmethod.md | Wi-Fi authentication method. |:|:|:| |certificate|0|Use an identity certificate for authentication.| |usernameAndPassword|1|Use username and password for authentication.|-|derivedCredential|2|Use Derived Credential for authentication.| +|derivedCredential|2|Use Derived Credential for authentication.| |
v1.0 | Intune Deviceconfig Wifiauthenticationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-wifiauthenticationtype.md | Wi-Fi Authentication Type Settings. |user|1|User Authentication| |machine|2|Machine Authentication| |machineOrUser|3|Machine or User Authentication|-|guest|4|Guest Authentication| +|guest|4|Guest Authentication| |
v1.0 | Intune Deviceconfig Wifiproxysetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-wifiproxysetting.md | Wi-Fi Proxy Settings. |none|0|No Proxy.| |manual|1|Manual Proxy Settings via Address and Port.| |automatic|2|Automatic Proxy Settings via URL.|-|unknownFutureValue|3|Unknown future value for evolvable enum patterns.| +|unknownFutureValue|3|Unknown future value for evolvable enum patterns.| |
v1.0 | Intune Deviceconfig Wifisecuritytype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-wifisecuritytype.md | Wi-Fi Security Types. |wpaEnterprise|2|WPA-Enterprise. Must use IOSEnterpriseWifiConfiguration type to configure enterprise options.| |wep|3|WEP Encryption.| |wpa2Personal|4|WPA2-Personal.|-|wpa2Enterprise|5|WPA2-Enterprise. Must use WindowsWifiEnterpriseEAPConfiguration type to configure enterprise options.| +|wpa2Enterprise|5|WPA2-Enterprise. Must use WindowsWifiEnterpriseEAPConfiguration type to configure enterprise options.| |
v1.0 | Intune Deviceconfig Windows10appsforceupdateschedule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10appsforceupdateschedule.md | Here is a JSON representation of the resource. "recurrence": "String", "runImmediatelyIfAfterStartDateTime": true }-``` +``` |
v1.0 | Intune Deviceconfig Windows10appsupdaterecurrence | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10appsupdaterecurrence.md | Possible values for App update on Windows10 recurrence. |none|0|Default value, specifies a single occurence.| |daily|1|Daily.| |weekly|2|Weekly.|-|monthly|3|Monthly.| +|monthly|3|Monthly.| |
v1.0 | Intune Deviceconfig Windows10apptype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10apptype.md | Windows 10 Application type. |Member|Value|Description| |:|:|:| |desktop|0|Desktop.|-|universal|1|Universal.| +|universal|1|Universal.| |
v1.0 | Intune Deviceconfig Windows10associatedapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10associatedapps.md | Here is a JSON representation of the resource. "appType": "String", "identifier": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windows10certificateprofilebase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10certificateprofilebase.md | Here is a JSON representation of the resource. "certificateValidityPeriodValue": 1024, "certificateValidityPeriodScale": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windows10compliancepolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10compliancepolicy.md | Here is a JSON representation of the resource. "rulesContent": "binary" } }-``` +``` |
v1.0 | Intune Deviceconfig Windows10customconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10customconfiguration.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Windows10devicefirmwareconfigurationinterface | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10devicefirmwareconfigurationinterface.md | Here is a JSON representation of the resource. "wakeOnLAN": "String", "wakeOnPower": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windows10devicemodetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10devicemodetype.md | Windows 10 Device Mode type. |Member|Value|Description| |:|:|:| |standardConfiguration|0|Standard Configuration|-|sModeConfiguration|1|S Mode Configuration| +|sModeConfiguration|1|S Mode Configuration| |
v1.0 | Intune Deviceconfig Windows10easemailprofileconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10easemailprofileconfiguration.md | Here is a JSON representation of the resource. "hostName": "String", "requireSsl": true }-``` +``` |
v1.0 | Intune Deviceconfig Windows10editiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10editiontype.md | Windows 10 Edition type. |windows10HomeSingleLanguage|16|Windows 10 Home Single Language| |windows10Mobile|17|Windows 10 Mobile| |windows10IoTCore|18|Windows 10 IoT Core|-|windows10IoTCoreCommercial|19|Windows 10 IoT Core Commercial| +|windows10IoTCoreCommercial|19|Windows 10 IoT Core Commercial| |
v1.0 | Intune Deviceconfig Windows10endpointprotectionconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10endpointprotectionconfiguration.md | Here is a JSON representation of the resource. "severeSeverity": "String" } }-``` +``` |
v1.0 | Intune Deviceconfig Windows10enterprisemodernappmanagementconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10enterprisemodernappmanagementconfiguration.md | Here is a JSON representation of the resource. "version": 1024, "uninstallBuiltInApps": true }-``` +``` |
v1.0 | Intune Deviceconfig Windows10generalconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10generalconfiguration.md | Here is a JSON representation of the resource. "uninstallBuiltInApps": true, "configureTimeZone": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windows10importedpfxcertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10importedpfxcertificateprofile.md | Here is a JSON representation of the resource. "certificateValidityPeriodScale": "String", "intendedPurpose": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windows10mobilecompliancepolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10mobilecompliancepolicy.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Windows10networkboundaryconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10networkboundaryconfiguration.md | Here is a JSON representation of the resource. ] } }-``` +``` |
v1.0 | Intune Deviceconfig Windows10networkproxyserver | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10networkproxyserver.md | Here is a JSON representation of the resource. ], "useForLocalAddresses": true }-``` +``` |
v1.0 | Intune Deviceconfig Windows10pfximportcertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10pfximportcertificateprofile.md | Here is a JSON representation of the resource. "version": 1024, "keyStorageProvider": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windows10pkcscertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10pkcscertificateprofile.md | Inherits from [windows10CertificateProfileBase](../resources/intune-deviceconfig |certificationAuthorityName|String|PKCS Certification Authority Name| |certificateTemplateName|String|PKCS Certificate Template Name| |subjectAlternativeNameFormatString|String|Custom String that defines the AAD Attribute.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |certificateStore|[certificateStore](../resources/intune-shared-certificatestore.md)|Target store certificate. Possible values are: `user`, `machine`.| |customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. This collection can contain a maximum of 500 elements.| Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Windows10secureassessmentconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10secureassessmentconfiguration.md | Here is a JSON representation of the resource. "localGuestAccountName": "String", "assessmentAppUserModelId": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windows10teamgeneralconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10teamgeneralconfiguration.md | Here is a JSON representation of the resource. "welcomeScreenBackgroundImageUrl": "String", "welcomeScreenMeetingInformation": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windows10vpnauthenticationmethod | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10vpnauthenticationmethod.md | Windows 10 VPN connection types. |certificate|0|Authenticate with a certificate.| |usernameAndPassword|1|Use username and password for authentication.| |customEapXml|2|Authentication method is specified in custom EAP XML.|-|derivedCredential|3|Use Derived Credential for authentication.| +|derivedCredential|3|Use Derived Credential for authentication.| |
v1.0 | Intune Deviceconfig Windows10vpnconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10vpnconfiguration.md | Inherits from [windowsVpnConfiguration](../resources/intune-deviceconfig-windows |rememberUserCredentials|Boolean|Remember user credentials.| |enableConditionalAccess|Boolean|Enable conditional access.| |enableSingleSignOnWithAlternateCertificate|Boolean|Enable single sign-on (SSO) with alternate certificate.|-|singleSignOnEku|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md)|Single sign-on Extended Key Usage (EKU).| +|singleSignOnEku|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md)|Single sign-on Extended Key Usage (EKU).| |singleSignOnIssuerHash|String|Single sign-on issuer hash.| |eapXml|Binary|Extensible Authentication Protocol (EAP) XML. (UTF8 encoded byte array)| |proxyServer|[windows10VpnProxyServer](../resources/intune-deviceconfig-windows10vpnproxyserver.md)|Proxy Server.| Here is a JSON representation of the resource. "pfsGroup": "String" } }-``` +``` |
v1.0 | Intune Deviceconfig Windows10vpnconnectiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10vpnconnectiontype.md | VPN connection types. |paloAltoGlobalProtect|9|Palo Alto Networks GlobalProtect.| |ciscoAnyConnect|10|Cisco AnyConnect| |unknownFutureValue|11|Sentinel member for cases where the client cannot handle the new enum values.|-|microsoftTunnel|12|Microsoft Tunnel connection type| +|microsoftTunnel|12|Microsoft Tunnel connection type| |
v1.0 | Intune Deviceconfig Windows10vpnprofiletarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10vpnprofiletarget.md | Windows 10 VPN profile target types. |:|:|:| |user|0|User targeted VPN profile.| |device|1|Device targeted VPN profile.|-|autoPilotDevice|2|AutoPilot Device targeted VPN profile.| +|autoPilotDevice|2|AutoPilot Device targeted VPN profile.| |
v1.0 | Intune Deviceconfig Windows10vpnproxyserver | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows10vpnproxyserver.md | Here is a JSON representation of the resource. "port": 1024, "bypassProxyServerForLocalAddress": true }-``` +``` |
v1.0 | Intune Deviceconfig Windows81certificateprofilebase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows81certificateprofilebase.md | Inherits from [windowsCertificateProfileBase](../resources/intune-deviceconfig-w |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| |customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. This collection can contain a maximum of 500 elements.| ## Relationships Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Windows81compliancepolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows81compliancepolicy.md | Here is a JSON representation of the resource. "osMaximumVersion": "String", "storageRequireEncryption": true }-``` +``` |
v1.0 | Intune Deviceconfig Windows81generalconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows81generalconfiguration.md | Here is a JSON representation of the resource. "userAccountControlSettings": "String", "workFoldersUrl": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windows81scepcertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows81scepcertificateprofile.md | Inherits from [windows81CertificateProfileBase](../resources/intune-deviceconfig |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [windows81CertificateProfileBase](../resources/intune-deviceconfig-windows81certificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [windows81CertificateProfileBase](../resources/intune-deviceconfig-windows81certificateprofilebase.md)| |customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. This collection can contain a maximum of 500 elements. Inherited from [windows81CertificateProfileBase](../resources/intune-deviceconfig-windows81certificateprofilebase.md)| |scepServerUrls|String collection|SCEP Server Url(s).| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| Here is a JSON representation of the resource. "subjectAlternativeNameFormatString": "String", "certificateStore": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windows81trustedrootcertificate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows81trustedrootcertificate.md | Here is a JSON representation of the resource. "certFileName": "String", "destinationStore": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windows81vpnconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows81vpnconfiguration.md | Here is a JSON representation of the resource. "bypassProxyServerForLocalAddress": true } }-``` +``` |
v1.0 | Intune Deviceconfig Windows81vpnproxyserver | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows81vpnproxyserver.md | Here is a JSON representation of the resource. "automaticallyDetectProxySettings": true, "bypassProxyServerForLocalAddress": true }-``` +``` |
v1.0 | Intune Deviceconfig Windows81wifiimportconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windows81wifiimportconfiguration.md | Here is a JSON representation of the resource. "profileName": "String", "payload": "binary" }-``` +``` |
v1.0 | Intune Deviceconfig Windowsappstartlayouttilesize | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsappstartlayouttilesize.md | The tile size of Windows app in the start layout. |small|1|Small 1x1.| |medium|2|Medium 2x2.| |wide|3|Wide 4x2.|-|large|4|Large 4x4.| +|large|4|Large 4x4.| |
v1.0 | Intune Deviceconfig Windowscertificateprofilebase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowscertificateprofilebase.md | Here is a JSON representation of the resource. "certificateValidityPeriodValue": 1024, "certificateValidityPeriodScale": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windowsdefenderadvancedthreatprotectionconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsdefenderadvancedthreatprotectionconfiguration.md | Here is a JSON representation of the resource. "advancedThreatProtectionOffboardingBlob": "String", "advancedThreatProtectionOffboardingFilename": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windowsdefendertamperprotectionoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsdefendertamperprotectionoptions.md | Defender TamperProtection setting options |:|:|:| |notConfigured|0|Not Configured| |enable|1|Enable windows defender tamper protection|-|disable|2|Disable windows defender tamper protection| +|disable|2|Disable windows defender tamper protection| |
v1.0 | Intune Deviceconfig Windowsdeliveryoptimizationconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsdeliveryoptimizationconfiguration.md | Here is a JSON representation of the resource. "cacheServerForegroundDownloadFallbackToHttpDelayInSeconds": 1024, "cacheServerBackgroundDownloadFallbackToHttpDelayInSeconds": 1024 }-``` +``` |
v1.0 | Intune Deviceconfig Windowsdeliveryoptimizationmode | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsdeliveryoptimizationmode.md | Delivery optimization mode for peer distribution |httpWithPeeringPrivateGroup|3|HTTP blended with peering across a private group| |httpWithInternetPeering|4|HTTP blended with Internet peering| |simpleDownload|99|Simple download mode with no peering|-|bypassMode|100|Bypass mode. Do not use Delivery Optimization and use BITS instead| +|bypassMode|100|Bypass mode. Do not use Delivery Optimization and use BITS instead| |
v1.0 | Intune Deviceconfig Windowsdomainjoinconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsdomainjoinconfiguration.md | Namespace: microsoft.graph Windows Domain Join device configuration. -Inherits from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md) +Inherits from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md) ## Methods |Method|Return Type|Description| |:|:|:|-|[List windowsDomainJoinConfigurations](../api/intune-deviceconfig-windowsdomainjoinconfiguration-list.md)|[windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) collection|List properties and relationships of the [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) objects.| -|[Get windowsDomainJoinConfiguration](../api/intune-deviceconfig-windowsdomainjoinconfiguration-get.md)|[windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md)|Read properties and relationships of the [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) object.| -|[Create windowsDomainJoinConfiguration](../api/intune-deviceconfig-windowsdomainjoinconfiguration-create.md)|[windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md)|Create a new [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) object.| -|[Delete windowsDomainJoinConfiguration](../api/intune-deviceconfig-windowsdomainjoinconfiguration-delete.md)|None|Deletes a [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md).| -|[Update windowsDomainJoinConfiguration](../api/intune-deviceconfig-windowsdomainjoinconfiguration-update.md)|[windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md)|Update the properties of a [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) object.| +|[List windowsDomainJoinConfigurations](../api/intune-deviceconfig-windowsdomainjoinconfiguration-list.md)|[windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) collection|List properties and relationships of the [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) objects.| +|[Get windowsDomainJoinConfiguration](../api/intune-deviceconfig-windowsdomainjoinconfiguration-get.md)|[windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md)|Read properties and relationships of the [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object.| +|[Create windowsDomainJoinConfiguration](../api/intune-deviceconfig-windowsdomainjoinconfiguration-create.md)|[windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md)|Create a new [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object.| +|[Delete windowsDomainJoinConfiguration](../api/intune-deviceconfig-windowsdomainjoinconfiguration-delete.md)|None|Deletes a [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md).| +|[Update windowsDomainJoinConfiguration](../api/intune-deviceconfig-windowsdomainjoinconfiguration-update.md)|[windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md)|Update the properties of a [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object.| ## Properties |Property|Type|Description| |:|:|:|-|id|String|Key of the entity. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|lastModifiedDateTime|DateTimeOffset|DateTime the object was last modified. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|roleScopeTagIds|String collection|List of Scope Tags for this Entity instance. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|supportsScopeTags|Boolean|Indicates whether or not the underlying Device Configuration supports the assignment of scope tags. Assigning to the ScopeTags property is not allowed when this value is false and entities will not be visible to scoped users. This occurs for Legacy policies created in Silverlight and can be resolved by deleting and recreating the policy in the Azure Portal. This property is read-only. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|deviceManagementApplicabilityRuleOsEdition|[deviceManagementApplicabilityRuleOsEdition](../resources/intune-deviceconfig-devicemanagementapplicabilityruleosedition.md)|The OS edition applicability for this Policy. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|deviceManagementApplicabilityRuleOsVersion|[deviceManagementApplicabilityRuleOsVersion](../resources/intune-deviceconfig-devicemanagementapplicabilityruleosversion.md)|The OS version applicability rule for this Policy. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|deviceManagementApplicabilityRuleDeviceMode|[deviceManagementApplicabilityRuleDeviceMode](../resources/intune-deviceconfig-devicemanagementapplicabilityruledevicemode.md)|The device mode applicability rule for this Policy. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|createdDateTime|DateTimeOffset|DateTime the object was created. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|description|String|Admin provided description of the Device Configuration. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| +|id|String|Key of the entity. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|lastModifiedDateTime|DateTimeOffset|DateTime the object was last modified. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|roleScopeTagIds|String collection|List of Scope Tags for this Entity instance. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|supportsScopeTags|Boolean|Indicates whether or not the underlying Device Configuration supports the assignment of scope tags. Assigning to the ScopeTags property is not allowed when this value is false and entities will not be visible to scoped users. This occurs for Legacy policies created in Silverlight and can be resolved by deleting and recreating the policy in the Azure Portal. This property is read-only. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|deviceManagementApplicabilityRuleOsEdition|[deviceManagementApplicabilityRuleOsEdition](../resources/intune-deviceconfig-devicemanagementapplicabilityruleosedition.md)|The OS edition applicability for this Policy. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|deviceManagementApplicabilityRuleOsVersion|[deviceManagementApplicabilityRuleOsVersion](../resources/intune-deviceconfig-devicemanagementapplicabilityruleosversion.md)|The OS version applicability rule for this Policy. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|deviceManagementApplicabilityRuleDeviceMode|[deviceManagementApplicabilityRuleDeviceMode](../resources/intune-deviceconfig-devicemanagementapplicabilityruledevicemode.md)|The device mode applicability rule for this Policy. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|createdDateTime|DateTimeOffset|DateTime the object was created. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|description|String|Admin provided description of the Device Configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |computerNameStaticPrefix|String|Fixed prefix to be used for computer name.| |computerNameSuffixRandomCharCount|Int32|Dynamically generated characters used as suffix for computer name. Valid values 3 to 14| |activeDirectoryDomainName|String|Active Directory domain name to join.| Inherits from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfi ## Relationships |Relationship|Type|Description| |:|:|:|-|groupAssignments|[deviceConfigurationGroupAssignment](../resources/intune-deviceconfig-deviceconfigurationgroupassignment.md) collection|The list of group assignments for the device configuration profile. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|assignments|[deviceConfigurationAssignment](../resources/intune-deviceconfig-deviceconfigurationassignment.md) collection|The list of assignments for the device configuration profile. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|deviceStatuses|[deviceConfigurationDeviceStatus](../resources/intune-deviceconfig-deviceconfigurationdevicestatus.md) collection|Device configuration installation status by device. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|userStatuses|[deviceConfigurationUserStatus](../resources/intune-deviceconfig-deviceconfigurationuserstatus.md) collection|Device configuration installation status by user. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|deviceStatusOverview|[deviceConfigurationDeviceOverview](../resources/intune-deviceconfig-deviceconfigurationdeviceoverview.md)|Device Configuration devices status overview Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|userStatusOverview|[deviceConfigurationUserOverview](../resources/intune-deviceconfig-deviceconfigurationuseroverview.md)|Device Configuration users status overview Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|deviceSettingStateSummaries|[settingStateDeviceSummary](../resources/intune-deviceconfig-settingstatedevicesummary.md) collection|Device Configuration Setting State Device Summary Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)| -|networkAccessConfigurations|[deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md) collection|Reference to device configurations required for network connectivity. This collection can contain a maximum of 2 elements.| +|groupAssignments|[deviceConfigurationGroupAssignment](../resources/intune-deviceconfig-deviceconfigurationgroupassignment.md) collection|The list of group assignments for the device configuration profile. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|assignments|[deviceConfigurationAssignment](../resources/intune-deviceconfig-deviceconfigurationassignment.md) collection|The list of assignments for the device configuration profile. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|deviceStatuses|[deviceConfigurationDeviceStatus](../resources/intune-deviceconfig-deviceconfigurationdevicestatus.md) collection|Device configuration installation status by device. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|userStatuses|[deviceConfigurationUserStatus](../resources/intune-deviceconfig-deviceconfigurationuserstatus.md) collection|Device configuration installation status by user. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|deviceStatusOverview|[deviceConfigurationDeviceOverview](../resources/intune-deviceconfig-deviceconfigurationdeviceoverview.md)|Device Configuration devices status overview Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|userStatusOverview|[deviceConfigurationUserOverview](../resources/intune-deviceconfig-deviceconfigurationuseroverview.md)|Device Configuration users status overview Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|deviceSettingStateSummaries|[settingStateDeviceSummary](../resources/intune-deviceconfig-settingstatedevicesummary.md) collection|Device Configuration Setting State Device Summary Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| +|networkAccessConfigurations|[deviceConfiguration](../resources/intune-shared-deviceconfiguration.md) collection|Reference to device configurations required for network connectivity. This collection can contain a maximum of 2 elements.| ## JSON Representation Here is a JSON representation of the resource. Here is a JSON representation of the resource. "activeDirectoryDomainName": "String", "organizationalUnit": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windowsedgekiosktype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsedgekiosktype.md | Edge kiosk type |Member|Value|Description| |:|:|:| |publicBrowsing|0|public-browsing|-|fullScreen|1|fullscreen| +|fullScreen|1|fullscreen| |
v1.0 | Intune Deviceconfig Windowsfirewallnetworkprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsfirewallnetworkprofile.md | Here is a JSON representation of the resource. "policyRulesFromGroupPolicyMerged": true, "policyRulesFromGroupPolicyNotMerged": true }-``` +``` |
v1.0 | Intune Deviceconfig Windowsfirewallrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsfirewallrule.md | Here is a JSON representation of the resource. "edgeTraversal": "String", "localUserAuthorizations": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windowsfirewallruleinterfacetypes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsfirewallruleinterfacetypes.md | Flags representing firewall rule interface types. |notConfigured|0|No flags set.| |remoteAccess|1|The Remote Access interface type.| |wireless|2|The Wireless interface type.|-|lan|4|The LAN interface type.| +|lan|4|The LAN interface type.| |
v1.0 | Intune Deviceconfig Windowsfirewallrulenetworkprofiletypes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsfirewallrulenetworkprofiletypes.md | Flags representing which network profile types apply to a firewall rule. |notConfigured|0|No flags set.| |domain|1|The profile for networks that are connected to domains.| |private|2|The profile for private networks.|-|public|4|The profile for public networks.| +|public|4|The profile for public networks.| |
v1.0 | Intune Deviceconfig Windowsfirewallruletrafficdirectiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsfirewallruletrafficdirectiontype.md | Firewall rule traffic directions. |:|:|:| |notConfigured|0|Not configured.| |out|1|The rule applies to outbound traffic.|-|in|2|The rule applies to inbound traffic.| +|in|2|The rule applies to inbound traffic.| |
v1.0 | Intune Deviceconfig Windowshealthmonitoringconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowshealthmonitoringconfiguration.md | Here is a JSON representation of the resource. "configDeviceHealthMonitoringScope": "String", "configDeviceHealthMonitoringCustomScope": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windowshealthmonitoringscope | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowshealthmonitoringscope.md | Device health monitoring scope |healthMonitoring|1|Basic events for windows device health monitoring| |bootPerformance|2|Boot performance events| |windowsUpdates|4|Windows updates events|-|privilegeManagement|8|PrivilegeManagement| +|privilegeManagement|8|PrivilegeManagement| |
v1.0 | Intune Deviceconfig Windowsidentityprotectionconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsidentityprotectionconfiguration.md | Here is a JSON representation of the resource. "useCertificatesForOnPremisesAuthEnabled": true, "windowsHelloForBusinessBlocked": true }-``` +``` |
v1.0 | Intune Deviceconfig Windowskioskactivedirectorygroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowskioskactivedirectorygroup.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.windowsKioskActiveDirectoryGroup", "groupName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windowskioskappbase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowskioskappbase.md | Here is a JSON representation of the resource. "appType": "String", "autoLaunch": true }-``` +``` |
v1.0 | Intune Deviceconfig Windowskioskappconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowskioskappconfiguration.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.windowsKioskAppConfiguration" }-``` +``` |
v1.0 | Intune Deviceconfig Windowskioskapptype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowskioskapptype.md | The type of Windows kiosk app. |unknown|0|Unknown.| |store|1|Store App.| |desktop|2|Desktop App.|-|aumId|3|Input by AUMID.| +|aumId|3|Input by AUMID.| |
v1.0 | Intune Deviceconfig Windowskioskautologon | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowskioskautologon.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.windowsKioskAutologon" }-``` +``` |
v1.0 | Intune Deviceconfig Windowskioskazureadgroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowskioskazureadgroup.md | Here is a JSON representation of the resource. "displayName": "String", "groupId": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windowskioskazureaduser | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowskioskazureaduser.md | Here is a JSON representation of the resource. "userId": "String", "userPrincipalName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windowskioskconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowskioskconfiguration.md | Here is a JSON representation of the resource. "runImmediatelyIfAfterStartDateTime": true } }-``` +``` |
v1.0 | Intune Deviceconfig Windowskioskdesktopapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowskioskdesktopapp.md | Here is a JSON representation of the resource. "desktopApplicationId": "String", "desktopApplicationLinkPath": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windowskioskforceupdateschedule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowskioskforceupdateschedule.md | Here is a JSON representation of the resource. "dayofMonth": 1024, "runImmediatelyIfAfterStartDateTime": true }-``` +``` |
v1.0 | Intune Deviceconfig Windowskiosklocalgroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowskiosklocalgroup.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.windowsKioskLocalGroup", "groupName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windowskiosklocaluser | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowskiosklocaluser.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.windowsKioskLocalUser", "userName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windowskioskmultipleapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowskioskmultipleapps.md | Here is a JSON representation of the resource. "disallowDesktopApps": true, "startMenuLayoutXml": "binary" }-``` +``` |
v1.0 | Intune Deviceconfig Windowskioskprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowskioskprofile.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Windowskiosksingleuwpapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowskiosksingleuwpapp.md | Here is a JSON representation of the resource. "containedAppId": "String" } }-``` +``` |
v1.0 | Intune Deviceconfig Windowskiosksinglewin32app | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowskiosksinglewin32app.md | Here is a JSON representation of the resource. "edgeKiosk": "String" } }-``` +``` |
v1.0 | Intune Deviceconfig Windowskioskuser | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowskioskuser.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.windowsKioskUser" }-``` +``` |
v1.0 | Intune Deviceconfig Windowskioskuwpapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowskioskuwpapp.md | Here is a JSON representation of the resource. "appId": "String", "containedAppId": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windowskioskvisitor | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowskioskvisitor.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.windowsKioskVisitor" }-``` +``` |
v1.0 | Intune Deviceconfig Windowskioskwin32app | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowskioskwin32app.md | Here is a JSON representation of the resource. "edgeKioskType": "String", "edgeKiosk": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windowsnetworkisolationpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsnetworkisolationpolicy.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceconfig Windowsphone81certificateprofilebase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsphone81certificateprofilebase.md | Inherits from [deviceConfiguration](../resources/intune-shared-deviceconfigurati |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validtiy Period.| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.| ## Relationships |Relationship|Type|Description| Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Windowsphone81compliancepolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsphone81compliancepolicy.md | Here is a JSON representation of the resource. "osMaximumVersion": "String", "storageRequireEncryption": true }-``` +``` |
v1.0 | Intune Deviceconfig Windowsphone81customconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsphone81customconfiguration.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfig Windowsphone81generalconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsphone81generalconfiguration.md | Here is a JSON representation of the resource. "wifiBlockHotspotReporting": true, "windowsStoreBlocked": true }-``` +``` |
v1.0 | Intune Deviceconfig Windowsphone81importedpfxcertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsphone81importedpfxcertificateprofile.md | Here is a JSON representation of the resource. "certificateValidityPeriodScale": "String", "intendedPurpose": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windowsphone81scepcertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsphone81scepcertificateprofile.md | Inherits from [windowsPhone81CertificateProfileBase](../resources/intune-devicec |subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validtiy Period. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md). Possible values are: `days`, `months`, `years`.|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md)| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md)| |scepServerUrls|String collection|SCEP Server Url(s).| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |keyUsage|[keyUsages](../resources/intune-shared-keyusages.md)|SCEP Key Usage. Possible values are: `keyEncipherment`, `digitalSignature`.| Here is a JSON representation of the resource. "hashAlgorithm": "String", "subjectAlternativeNameFormatString": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windowsphone81trustedrootcertificate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsphone81trustedrootcertificate.md | Here is a JSON representation of the resource. "trustedRootCertificate": "binary", "certFileName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windowsphone81vpnconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsphone81vpnconfiguration.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceconfig Windowsphoneeasemailprofileconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsphoneeasemailprofileconfiguration.md | Here is a JSON representation of the resource. "hostName": "String", "requireSsl": true }-``` +``` |
v1.0 | Intune Deviceconfig Windowsprivacydataaccesscontrolitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsprivacydataaccesscontrolitem.md | Here is a JSON representation of the resource. "appPackageFamilyName": "String", "appDisplayName": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windowsprivacydataaccesslevel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsprivacydataaccesslevel.md | Determine the access level to specific Windows privacy data category. |notConfigured|0|No access level specified, no intents. Device may behave either as in UserInControl or ForceAllow. It may depend on the privacy data been accessed, Windows versions and other factors.| |forceAllow|1|Apps will be allowed to access the specified privacy data.| |forceDeny|2|Apps will be denied to access specified privacy data.|-|userInControl|3|Users will be prompted when apps try to access specified privacy data.| +|userInControl|3|Users will be prompted when apps try to access specified privacy data.| |
v1.0 | Intune Deviceconfig Windowsprivacydatacategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsprivacydatacategory.md | Windows privacy data category specifier for privacy data access. |radios|15|Let apps use radios, including Bluetooth, to send and receive data. Added in Windows 10, version 1607.| |tasks|16|Let apps access Task Scheduler. Added in Windows 10, version 1703.| |syncWithDevices|17|Let apps automatically share and sync info with wireless devices that donΓÇÖt explicitly pair with userΓÇÖs device. Added in Windows 10, version 1607.|-|trustedDevices|18|Let apps access trusted devices. Added in Windows 10, version 1607.| +|trustedDevices|18|Let apps access trusted devices. Added in Windows 10, version 1607.| |
v1.0 | Intune Deviceconfig Windowssmodeconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowssmodeconfiguration.md | The possible options to configure S mode unlock |:|:|:| |noRestriction|0|This option will remove all restrictions to unlock S mode - default| |block|1|This option will block the user to unlock the device from S mode|-|unlock|2|This option will unlock the device from S mode| +|unlock|2|This option will unlock the device from S mode| |
v1.0 | Intune Deviceconfig Windowsspotlightenablementsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsspotlightenablementsettings.md | Allows IT admind to set a predefined default search engine for MDM-Controlled de |:|:|:| |notConfigured|0|Spotlight on lock screen is not configured| |disabled|1|Disable Windows Spotlight on lock screen|-|enabled|2|Enable Windows Spotlight on lock screen| +|enabled|2|Enable Windows Spotlight on lock screen| |
v1.0 | Intune Deviceconfig Windowsstartmenuapplistvisibilitytype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsstartmenuapplistvisibilitytype.md | Type of start menu app list visibility. |userDefined|0|User defined. Default value.| |collapse|1|Collapse the app list on the start menu.| |remove|2|Removes the app list entirely from the start menu.|-|disableSettingsApp|4|Disables the corresponding toggle (Collapse or Remove) in the Settings app.| +|disableSettingsApp|4|Disables the corresponding toggle (Collapse or Remove) in the Settings app.| |
v1.0 | Intune Deviceconfig Windowsstartmenumodetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsstartmenumodetype.md | Type of display modes for the start menu. |:|:|:| |userDefined|0|User defined. Default value.| |fullScreen|1|Full screen.|-|nonFullScreen|2|Non-full screen.| +|nonFullScreen|2|Non-full screen.| |
v1.0 | Intune Deviceconfig Windowsupdateactivehoursinstall | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsupdateactivehoursinstall.md | Here is a JSON representation of the resource. "activeHoursStart": "String (time of day)", "activeHoursEnd": "String (time of day)" }-``` +``` |
v1.0 | Intune Deviceconfig Windowsupdateforbusinessconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsupdateforbusinessconfiguration.md | Here is a JSON representation of the resource. "updateNotificationLevel": "String", "allowWindows11Upgrade": true }-``` +``` |
v1.0 | Intune Deviceconfig Windowsupdateforbusinessupdateweeks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsupdateforbusinessupdateweeks.md | Scheduled the update installation on the weeks of the month |thirdWeek|4|Scheduled the update installation on the third week of the month| |fourthWeek|8|Scheduled the update installation on the fourth week of the month| |everyWeek|15|Scheduled the update installation on every week of the month|-|unknownFutureValue|22|Evolvable enum member| +|unknownFutureValue|22|Evolvable enum member| |
v1.0 | Intune Deviceconfig Windowsupdateinstallscheduletype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsupdateinstallscheduletype.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.windowsUpdateInstallScheduleType" }-``` +``` |
v1.0 | Intune Deviceconfig Windowsupdatenotificationdisplayoption | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsupdatenotificationdisplayoption.md | Windows Update Notification Display Options |defaultNotifications|1|Use the default Windows Update notifications.| |restartWarningsOnly|2|Turn off all notifications, excluding restart warnings.| |disableAllNotifications|3|Turn off all notifications, including restart warnings.|-|unknownFutureValue|4|Evolvable enum member| +|unknownFutureValue|4|Evolvable enum member| |
v1.0 | Intune Deviceconfig Windowsupdatescheduledinstall | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsupdatescheduledinstall.md | Here is a JSON representation of the resource. "scheduledInstallDay": "String", "scheduledInstallTime": "String (time of day)" }-``` +``` |
v1.0 | Intune Deviceconfig Windowsupdatestatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsupdatestatus.md | Windows update for business configuration device states |upToDate|0|There are no pending updates, no pending reboot updates and no failed updates.| |pendingInstallation|1|There are updates thatΓÇÖs pending installation which includes updates that are not approved. There are no Pending reboot updates, no failed updates.| |pendingReboot|2|There are updates that requires reboot. There are not failed updates.|-|failed|3|There are updates failed to install on the device.| +|failed|3|There are updates failed to install on the device.| |
v1.0 | Intune Deviceconfig Windowsupdatetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsupdatetype.md | Which branch devices will receive their updates from |businessReadyOnly|2|Semi-annual Channel. Device gets feature updates from Semi-annual Channel.| |windowsInsiderBuildFast|3|Windows Insider build - Fast| |windowsInsiderBuildSlow|4|Windows Insider build - Slow|-|windowsInsiderBuildRelease|5|Release Windows Insider build| +|windowsInsiderBuildRelease|5|Release Windows Insider build| |
v1.0 | Intune Deviceconfig Windowsuseraccountcontrolsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsuseraccountcontrolsettings.md | Possible values for Windows user account control settings. |alwaysNotify|1|Always notify.| |notifyOnAppChanges|2|Notify on app changes.| |notifyOnAppChangesWithoutDimming|3|Notify on app changes without dimming desktop.|-|neverNotify|4|Never notify.| +|neverNotify|4|Never notify.| |
v1.0 | Intune Deviceconfig Windowsvpnconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsvpnconfiguration.md | Here is a JSON representation of the resource. ], "customXml": "binary" }-``` +``` |
v1.0 | Intune Deviceconfig Windowsvpnconnectiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowsvpnconnectiontype.md | Windows VPN connection type. |pulseSecure|0|Pulse Secure.| |f5EdgeClient|1|F5 Edge Client.| |dellSonicWallMobileConnect|2|Dell SonicWALL Mobile Connection.|-|checkPointCapsuleVpn|3|Check Point Capsule VPN.| +|checkPointCapsuleVpn|3|Check Point Capsule VPN.| |
v1.0 | Intune Deviceconfig Windowswificonfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowswificonfiguration.md | Here is a JSON representation of the resource. "proxyAutomaticConfigurationUrl": "String", "forceFIPSCompliance": true }-``` +``` |
v1.0 | Intune Deviceconfig Windowswifienterpriseeapconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowswifienterpriseeapconfiguration.md | Here is a JSON representation of the resource. "cacheCredentials": true, "authenticationType": "String" }-``` +``` |
v1.0 | Intune Deviceconfig Windowswirednetworkconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-windowswirednetworkconfiguration.md | Here is a JSON representation of the resource. "requireCryptographicBinding": true, "forceFIPSCompliance": true }-``` +``` |
v1.0 | Intune Deviceconfig Wirednetworkauthenticationmethod | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-wirednetworkauthenticationmethod.md | Wired Network authentication method. |certificate|0|Use an identity certificate for authentication.| |usernameAndPassword|1|Use username and password for authentication.| |derivedCredential|2|Use Derived Credential for authentication.|-|unknownFutureValue|3|Sentinel member for cases where the client cannot handle the new enum values.| +|unknownFutureValue|3|Sentinel member for cases where the client cannot handle the new enum values.| |
v1.0 | Intune Deviceconfig Wirednetworkauthenticationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-wirednetworkauthenticationtype.md | Wired Network Authentication Type Settings. |machine|2|Machine Authentication| |machineOrUser|3|Machine or User Authentication| |guest|4|Guest Authentication|-|unknownFutureValue|5|Sentinel member for cases where the client cannot handle the new enum values.| +|unknownFutureValue|5|Sentinel member for cases where the client cannot handle the new enum values.| |
v1.0 | Intune Deviceconfig Wirednetworkinterface | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfig-wirednetworkinterface.md | Apple network interface type. |thirdActiveEthernet|3|Third active Ethernet.| |firstEthernet|4|First Ethernet.| |secondEthernet|5|Second Ethernet.|-|thirdEthernet|6|Third Ethernet.| +|thirdEthernet|6|Third Ethernet.| |
v1.0 | Intune Deviceconfigv2 Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagement.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementcomplianceactionitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementcomplianceactionitem.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementcomplianceactiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementcomplianceactiontype.md | Scheduled Action Type Enum |wipe|4|Wipe the device| |removeResourceAccessProfiles|5|Remove Resource Access Profiles from the device| |pushNotification|9|Send push notification to device|-|remoteLock|10|Remotely lock the device| +|remoteLock|10|Remotely lock the device| |
v1.0 | Intune Deviceconfigv2 Devicemanagementcompliancepolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementcompliancepolicy.md | Device Management Compliance Policy |name|String|Policy name| |description|String|Policy description| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| +|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `extensibility`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| |createdDateTime|DateTimeOffset|Policy creation date and time. This property is read-only.| |lastModifiedDateTime|DateTimeOffset|Policy last modification date and time. This property is read-only.| |settingCount|Int32|Number of settings. This property is read-only.| Device Management Compliance Policy |Relationship|Type|Description| |:|:|:| |settings|[deviceManagementConfigurationSetting](../resources/intune-deviceconfigv2-devicemanagementconfigurationsetting.md) collection|Policy settings|-|assignments|[deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection|Policy assignments| |scheduledActionsForRule|[deviceManagementComplianceScheduledActionForRule](../resources/intune-deviceconfigv2-devicemanagementcompliancescheduledactionforrule.md) collection|The list of scheduled action for this rule| ## JSON Representation Here is a JSON representation of the resource. ], "isAssigned": true }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementcompliancescheduledactionforrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementcompliancescheduledactionforrule.md | Here is a JSON representation of the resource. "id": "String (identifier)", "ruleName": "String" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationapplicationsettingapplicability | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationapplicationsettingapplicability.md | Inherits from [deviceManagementConfigurationSettingApplicability](../resources/i |description|String|description of the setting Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md)| |platform|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platform setting can be applied on. Posible values are: none, android, androidEnterprise, iOs, macOs, windows10X, windows10, aosp, and linux. Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.| |deviceMode|[deviceManagementConfigurationDeviceMode](../resources/intune-deviceconfigv2-devicemanagementconfigurationdevicemode.md)|Device Mode that setting can be applied on Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `kiosk`.|-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through. Posible values are: none, mdm, configManager, intuneManagementExtension, thirdParty, documentGateway, appleRemoteManagement, microsoftSense, exchangeOnline, edgeMam, linuxMdm, extensibility, enrollment, endpointPrivilegeManagement. Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| +|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through. Posible values are: none, mdm, configManager, intuneManagementExtension, thirdParty, documentGateway, appleRemoteManagement, microsoftSense, exchangeOnline, edgeMam, linuxMdm, extensibility, enrollment, endpointPrivilegeManagement. Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `extensibility`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| ## Relationships None Here is a JSON representation of the resource. "deviceMode": "String", "technologies": "String" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationazureadtrusttype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationazureadtrusttype.md | Required AAD Trust Type |none|0|No AAD Trust Type specified| |azureAdJoined|1|AAD Joined Trust Type| |addWorkAccount|2|AddWorkAccount|-|mdmOnly|4|MDM only| +|mdmOnly|4|MDM only| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationcategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationcategory.md | Device Management Configuration Policy |name|String|Name of the item| |displayName|String|Name of the category. For example: Device Lock| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms types, which settings in the category have. Possible values are: none. android, androidEnterprise, iOs, macOs, windows10X, windows10, aosp, and linux. If this property is not set, or set to none, returns categories in all platforms. Supports: $filters, $select. Read-only. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies types, which settings in the category have. Possible values are: none, mdm, configManager, intuneManagementExtension, thirdParty, documentGateway, appleRemoteManagement, microsoftSense, exchangeOnline, edgeMam, linuxMdm, extensibility, enrollment, endpointPrivilegeManagement. If this property is not set, or set to none, returns categories in all platforms. Supports: $filters, $select. Read-only. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| -|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicates that the category contains settings that are used for compliance, configuration, or reusable settings. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Read-only. Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies types, which settings in the category have. Possible values are: none, mdm, configManager, intuneManagementExtension, thirdParty, documentGateway, appleRemoteManagement, microsoftSense, exchangeOnline, edgeMam, linuxMdm, extensibility, enrollment, endpointPrivilegeManagement. If this property is not set, or set to none, returns categories in all platforms. Supports: $filters, $select. Read-only. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `extensibility`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicates that the category contains settings that are used for compliance, configuration, or reusable settings. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Read-only. Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |parentCategoryId|String|Direct parent id of the category. If the category is the root, the parent id is same as its id.| |rootCategoryId|String|Root id of the category.| |childCategoryIds|String collection|List of child ids of the category.| Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationchoicesettingcollectiondefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationchoicesettingcollectiondefinition.md | Inherits from [deviceManagementConfigurationChoiceSettingDefinition](../resource |offsetUri|String|Offset CSP Path from Base Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |rootDefinitionId|String|Root setting definition id if the setting is a child setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |categoryId|String|Specify category in which the setting is under. Support $filters. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |id|String|Identifier for item Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |description|String|Description of the setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| Here is a JSON representation of the resource. "maximumCount": 1024, "minimumCount": 1024 }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationchoicesettingcollectioninstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationchoicesettingcollectioninstance.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationchoicesettingcollectioninstancetemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationchoicesettingcollectioninstancetemplate.md | Here is a JSON representation of the resource. ], "allowUnmanagedValues": true }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationchoicesettingdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationchoicesettingdefinition.md | Inherits from [deviceManagementConfigurationSettingDefinition](../resources/intu |offsetUri|String|Offset CSP Path from Base Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |rootDefinitionId|String|Root setting definition id if the setting is a child setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |categoryId|String|Specify category in which the setting is under. Support $filters. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |id|String|Identifier for item Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |description|String|Description of the setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| Here is a JSON representation of the resource. ], "defaultOptionId": "String" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationchoicesettinginstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationchoicesettinginstance.md | Here is a JSON representation of the resource. ] } }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationchoicesettinginstancetemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationchoicesettinginstancetemplate.md | Here is a JSON representation of the resource. "settingValueTemplateId": "String" } }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationchoicesettingvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationchoicesettingvalue.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationchoicesettingvalueconstantdefaulttemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationchoicesettingvalueconstantdefaulttemplate.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationchoicesettingvaluedefaulttemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationchoicesettingvaluedefaulttemplate.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.deviceManagementConfigurationChoiceSettingValueDefaultTemplate" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationchoicesettingvaluedefinitiontemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationchoicesettingvaluedefinitiontemplate.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationchoicesettingvaluetemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationchoicesettingvaluetemplate.md | Here is a JSON representation of the resource. }, "settingValueTemplateId": "String" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationcontroltype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md | Setting control type representation in the UX |toggle|4|Allow for toggle control type.| |multiheaderGrid|5|Allow for multiheader grid control type.| |contextPane|6|Allow for context pane control type.|-|unknownFutureValue|7|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|7|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationdependenton | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationdependenton.md | Here is a JSON representation of the resource. "dependentOn": "String", "parentSettingId": "String" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationdevicemode | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationdevicemode.md | Describes applicability for the mode the device is in |Member|Value|Description| |:|:|:| |none|0|No Device Mode specified|-|kiosk|1|Device must be in kiosk mode for this setting to apply| +|kiosk|1|Device must be in kiosk mode for this setting to apply| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationexchangeonlinesettingapplicability | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationexchangeonlinesettingapplicability.md | Inherits from [deviceManagementConfigurationSettingApplicability](../resources/i |description|String|description of the setting Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md)| |platform|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platform setting can be applied on. Posible values are: none, android, androidEnterprise, iOs, macOs, windows10X, windows10, aosp, and linux. Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.| |deviceMode|[deviceManagementConfigurationDeviceMode](../resources/intune-deviceconfigv2-devicemanagementconfigurationdevicemode.md)|Device Mode that setting can be applied on Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `kiosk`.|-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through. Posible values are: none, mdm, configManager, intuneManagementExtension, thirdParty, documentGateway, appleRemoteManagement, microsoftSense, exchangeOnline, edgeMam, linuxMdm, extensibility, enrollment, endpointPrivilegeManagement. Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| +|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through. Posible values are: none, mdm, configManager, intuneManagementExtension, thirdParty, documentGateway, appleRemoteManagement, microsoftSense, exchangeOnline, edgeMam, linuxMdm, extensibility, enrollment, endpointPrivilegeManagement. Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `extensibility`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| ## Relationships None Here is a JSON representation of the resource. "deviceMode": "String", "technologies": "String" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationgroupsettingcollectioninstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationgroupsettingcollectioninstance.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationgroupsettingcollectioninstancetemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationgroupsettingcollectioninstancetemplate.md | Here is a JSON representation of the resource. ], "allowUnmanagedValues": true }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationgroupsettinginstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationgroupsettinginstance.md | Here is a JSON representation of the resource. ] } }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationgroupsettinginstancetemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationgroupsettinginstancetemplate.md | Here is a JSON representation of the resource. "settingValueTemplateId": "String" } }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationgroupsettingvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationgroupsettingvalue.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationgroupsettingvaluetemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationgroupsettingvaluetemplate.md | Here is a JSON representation of the resource. ], "settingValueTemplateId": "String" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationintegersettingvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationintegersettingvalue.md | Here is a JSON representation of the resource. }, "value": 1024 }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationintegersettingvalueconstantdefaulttemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationintegersettingvalueconstantdefaulttemplate.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagementConfigurationIntegerSettingValueConstantDefaultTemplate", "constantValue": 1024 }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationintegersettingvaluedefaulttemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationintegersettingvaluedefaulttemplate.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.deviceManagementConfigurationIntegerSettingValueDefaultTemplate" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationintegersettingvaluedefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationintegersettingvaluedefinition.md | Here is a JSON representation of the resource. "maximumValue": 1024, "minimumValue": 1024 }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationintegersettingvaluedefinitiontemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationintegersettingvaluedefinitiontemplate.md | Here is a JSON representation of the resource. "minValue": 1024, "maxValue": 1024 }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationintegersettingvaluetemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationintegersettingvaluetemplate.md | Here is a JSON representation of the resource. "maxValue": 1024 } }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationjustintimeassignmentpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationjustintimeassignmentpolicy.md | - Title: "deviceManagementConfigurationJustInTimeAssignmentPolicy resource type" -description: "The DeviceManagementConfigurationJustInTimeAssignmentPolicy entity is used to create a just-in-time assignment of specific DeviceManagementConfigurationPolicy to an AAD group." --localization_priority: Normal --doc_type: resourcePageType ---# deviceManagementConfigurationJustInTimeAssignmentPolicy resource type --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --The DeviceManagementConfigurationJustInTimeAssignmentPolicy entity is used to create a just-in-time assignment of specific DeviceManagementConfigurationPolicy to an AAD group. --## Properties -|Property|Type|Description| -|:|:|:| -|targetType|[deviceManagementConfigurationJustInTimeAssignmentPolicyType](../resources/intune-deviceconfigv2-devicemanagementconfigurationjustintimeassignmentpolicytype.md)|Type of the target. Possible values are Entra Security Group or Organization Unit (Ou). Default value : unknown. Possible values are: `unknown`, `entraSecurityGroup`, `organizationalUnit`, `unknownFutureValue`.| -|target|String collection|A list of unique identifiers representing static Entra Security Group IDs or Organizational Units to create the just-in-time assignment for newly enrolled devices.| --## Relationships -None --## JSON Representation -Here is a JSON representation of the resource. -<!-- { - "blockType": "resource", - "@odata.type": "microsoft.graph.deviceManagementConfigurationJustInTimeAssignmentPolicy" -} >-``` json -{ - "@odata.type": "#microsoft.graph.deviceManagementConfigurationJustInTimeAssignmentPolicy", - "targetType": "String", - "target": [ - "String" - ] -} -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationjustintimeassignmentpolicytype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationjustintimeassignmentpolicytype.md | - Title: "deviceManagementConfigurationJustInTimeAssignmentPolicyType enum type" -description: "Represents the type of target (i.e. unique identifier of Entra Security Group or Organizational Unit (OU)) used to create the just-in-time assignment." --localization_priority: Normal --doc_type: enumPageType ---# deviceManagementConfigurationJustInTimeAssignmentPolicyType enum type --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Represents the type of target (i.e. unique identifier of Entra Security Group or Organizational Unit (OU)) used to create the just-in-time assignment. --## Members -|Member|Value|Description| -|:|:|:| -|unknown|0|Default value. Do not use.| -|entraSecurityGroup|1|Entra security group.| -|organizationalUnit|2|Organizational unit.| -|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationoptiondefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationoptiondefinition.md | Here is a JSON representation of the resource. "name": "String", "displayName": "String" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationoptiondefinitiontemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationoptiondefinitiontemplate.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationplatforms | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md | Supported platform types. |windows10X|16|Windows 10 X.| |windows10|32|Settings for Windows 10 platform.| |linux|128|Settings for Linux platform.|-|unknownFutureValue|256|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|256|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationpolicy.md | Device Management Configuration Policy |name|String|Policy name| |description|String|Policy description| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| +|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `extensibility`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| |createdDateTime|DateTimeOffset|Policy creation date and time| |lastModifiedDateTime|DateTimeOffset|Policy last modification date and time| |settingCount|Int32|Number of settings| Device Management Configuration Policy |Relationship|Type|Description| |:|:|:| |settings|[deviceManagementConfigurationSetting](../resources/intune-deviceconfigv2-devicemanagementconfigurationsetting.md) collection|Policy settings|-|assignments|[deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection|Policy assignments| ## JSON Representation Here is a JSON representation of the resource. Here is a JSON representation of the resource. "priority": 1024 } }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicyassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md | - Title: "deviceManagementConfigurationPolicyAssignment resource type" -description: "The DeviceManagementConfigurationPolicyAssignment entity assigns a specific DeviceManagementConfigurationPolicy to an AAD group." --localization_priority: Normal --doc_type: resourcePageType ---# deviceManagementConfigurationPolicyAssignment resource type --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --The DeviceManagementConfigurationPolicyAssignment entity assigns a specific DeviceManagementConfigurationPolicy to an AAD group. --## Methods -|Method|Return Type|Description| -|:|:|:| -|[List deviceManagementConfigurationPolicyAssignments](../api/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment-list.md)|[deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection|List properties and relationships of the [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) objects.| -|[Get deviceManagementConfigurationPolicyAssignment](../api/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment-get.md)|[deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md)|Read properties and relationships of the [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) object.| -|[Create deviceManagementConfigurationPolicyAssignment](../api/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment-create.md)|[deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md)|Create a new [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) object.| -|[Delete deviceManagementConfigurationPolicyAssignment](../api/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment-delete.md)|None|Deletes a [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md).| -|[Update deviceManagementConfigurationPolicyAssignment](../api/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment-update.md)|[deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md)|Update the properties of a [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) object.| --## Properties -|Property|Type|Description| -|:|:|:| -|id|String|The key of the assignment.| -|target|[deviceAndAppManagementAssignmentTarget](../resources/intune-shared-deviceandappmanagementassignmenttarget.md)|The assignment target for the DeviceManagementConfigurationPolicy.| -|source|[deviceAndAppManagementAssignmentSource](../resources/intune-shared-deviceandappmanagementassignmentsource.md)|The assignment source for the device compliance policy, direct or parcel/policySet. Possible values are: `direct`, `policySets`.| -|sourceId|String|The identifier of the source of the assignment.| --## Relationships -None --## JSON Representation -Here is a JSON representation of the resource. -<!-- { - "blockType": "resource", - "keyProperty": "id", - "@odata.type": "microsoft.graph.deviceManagementConfigurationPolicyAssignment" -} >-``` json -{ - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "id": "String (identifier)", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "String", - "deviceAndAppManagementAssignmentFilterType": "String", - "targetType": "String", - "entraObjectId": "String" - }, - "source": "String", - "sourceId": "String" -} -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicytemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationpolicytemplate.md | Device Management Configuration Policy Template |displayVersion|String|Description of template version| |lifecycleState|[deviceManagementTemplateLifecycleState](../resources/intune-deviceconfigv2-devicemanagementtemplatelifecyclestate.md)|Indicate current lifecycle state of template. Possible values are: `invalid`, `draft`, `active`, `superseded`, `deprecated`, `retired`.| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this template. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this template. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| +|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this template. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `extensibility`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| |templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|TemplateFamily for this template. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `endpointSecurityEndpointPrivilegeManagement`, `enrollmentConfiguration`, `appQuietTime`, `baseline`, `unknownFutureValue`, `deviceConfigurationScripts`, `deviceConfigurationPolicies`, `windowsOsRecoveryPolicies`, `companyPortal`.| |allowUnmanagedSettings|Boolean|Allow unmanaged setting templates| |settingTemplateCount|Int32|Number of setting templates. Valid values 0 to 2147483647. This property is read-only.| Here is a JSON representation of the resource. "allowUnmanagedSettings": true, "settingTemplateCount": 1024 }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicytemplatereference | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationpolicytemplatereference.md | Here is a JSON representation of the resource. "templateDisplayName": "String", "templateDisplayVersion": "String" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationredirectsettingdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationredirectsettingdefinition.md | Inherits from [deviceManagementConfigurationSettingDefinition](../resources/intu |offsetUri|String|Offset CSP Path from Base Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |rootDefinitionId|String|Root setting definition id if the setting is a child setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |categoryId|String|Specify category in which the setting is under. Support $filters. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |id|String|Identifier for item Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |description|String|Description of the setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| Here is a JSON representation of the resource. "redirectMessage": "String", "redirectReason": "String" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationreferencesettingvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationreferencesettingvalue.md | Here is a JSON representation of the resource. "value": "String", "note": "String" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationreferredsettinginformation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagementConfigurationReferredSettingInformation", "settingDefinitionId": "String" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsecretsettingvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsecretsettingvalue.md | Here is a JSON representation of the resource. "value": "String", "valueState": "String" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsecretsettingvaluestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsecretsettingvaluestate.md | type tracking the encryption state of a secret setting value |:|:|:| |invalid|0|default invalid value| |notEncrypted|1|secret value is not encrypted|-|encryptedValueToken|2|a token for the encrypted value is returned by the service| +|encryptedValueToken|2|a token for the encrypted value is returned by the service| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsetting.md | Here is a JSON representation of the resource. } } }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettingaccesstypes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsettingaccesstypes.md | Namespace: microsoft.graph |delete|4|| |get|8|| |replace|16||-|execute|32|| +|execute|32|| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettingapplicability | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md | Namespace: microsoft.graph |description|String|description of the setting| |platform|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platform setting can be applied on. Posible values are: none, android, androidEnterprise, iOs, macOs, windows10X, windows10, aosp, and linux. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.| |deviceMode|[deviceManagementConfigurationDeviceMode](../resources/intune-deviceconfigv2-devicemanagementconfigurationdevicemode.md)|Device Mode that setting can be applied on. Possible values are: `none`, `kiosk`.|-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through. Posible values are: none, mdm, configManager, intuneManagementExtension, thirdParty, documentGateway, appleRemoteManagement, microsoftSense, exchangeOnline, edgeMam, linuxMdm, extensibility, enrollment, endpointPrivilegeManagement. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| +|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through. Posible values are: none, mdm, configManager, intuneManagementExtension, thirdParty, documentGateway, appleRemoteManagement, microsoftSense, exchangeOnline, edgeMam, linuxMdm, extensibility, enrollment, endpointPrivilegeManagement. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `extensibility`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| ## Relationships None Here is a JSON representation of the resource. "deviceMode": "String", "technologies": "String" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettingdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md | Namespace: microsoft.graph |offsetUri|String|Offset CSP Path from Base| |rootDefinitionId|String|Root setting definition id if the setting is a child setting.| |categoryId|String|Specify category in which the setting is under. Support $filters.|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information.| |id|String|Identifier for item| |description|String|Description of the setting.| Here is a JSON representation of the resource. "displayName": "String", "version": "String" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettingdependedonby | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdependedonby.md | Here is a JSON representation of the resource. "dependedOnBy": "String", "required": true }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettinggroupcollectiondefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsettinggroupcollectiondefinition.md | Inherits from [deviceManagementConfigurationSettingGroupDefinition](../resources |offsetUri|String|Offset CSP Path from Base Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |rootDefinitionId|String|Root setting definition id if the setting is a child setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |categoryId|String|Specify category in which the setting is under. Support $filters. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |id|String|Identifier for item Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |description|String|Description of the setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| Here is a JSON representation of the resource. "maximumCount": 1024, "minimumCount": 1024 }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettinggroupcollectioninstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsettinggroupcollectioninstance.md | Here is a JSON representation of the resource. "settingInstanceTemplateId": "String" } }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettinggroupdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsettinggroupdefinition.md | Inherits from [deviceManagementConfigurationSettingDefinition](../resources/intu |offsetUri|String|Offset CSP Path from Base Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |rootDefinitionId|String|Root setting definition id if the setting is a child setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |categoryId|String|Specify category in which the setting is under. Support $filters. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |id|String|Identifier for item Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |description|String|Description of the setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettinggroupinstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsettinggroupinstance.md | Here is a JSON representation of the resource. "settingInstanceTemplateId": "String" } }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettinginstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsettinginstance.md | Here is a JSON representation of the resource. "settingInstanceTemplateId": "String" } }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettinginstancetemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsettinginstancetemplate.md | Here is a JSON representation of the resource. "settingDefinitionId": "String", "isRequired": true }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettinginstancetemplatereference | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsettinginstancetemplatereference.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference", "settingInstanceTemplateId": "String" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettingoccurrence | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsettingoccurrence.md | Here is a JSON representation of the resource. "minDeviceOccurrence": 1024, "maxDeviceOccurrence": 1024 }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettingtemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsettingtemplate.md | Here is a JSON representation of the resource. } } }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettingusage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md | Supported setting types |configuration|1|Configuration setting type.| |compliance|2|Compliance setting type.| |unknownFutureValue|8|Evolvable enumeration sentinel value. Do not use.|+|inventory|16|Inventory Setting type.| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettingvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvalue.md | Here is a JSON representation of the resource. "useTemplateDefault": true } }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettingvaluedefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvaluedefinition.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingValueDefinition" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettingvaluetemplatereference | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvaluetemplatereference.md | Here is a JSON representation of the resource. "settingValueTemplateId": "String", "useTemplateDefault": true }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettingvisibility | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md | Supported setting types |settingsCatalog|1|Visible to setting catalog policy type.| |template|2|Visible to template policy type.| |unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.|+|inventoryCatalog|8|Visible to inventory catalog policy type.| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsimplesettingcollectiondefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsimplesettingcollectiondefinition.md | Inherits from [deviceManagementConfigurationSimpleSettingDefinition](../resource |offsetUri|String|Offset CSP Path from Base Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |rootDefinitionId|String|Root setting definition id if the setting is a child setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |categoryId|String|Specify category in which the setting is under. Support $filters. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |id|String|Identifier for item Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |description|String|Description of the setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| Here is a JSON representation of the resource. "maximumCount": 1024, "minimumCount": 1024 }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsimplesettingcollectioninstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsimplesettingcollectioninstance.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsimplesettingcollectioninstancetemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsimplesettingcollectioninstancetemplate.md | Here is a JSON representation of the resource. ], "allowUnmanagedValues": true }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsimplesettingdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsimplesettingdefinition.md | Inherits from [deviceManagementConfigurationSettingDefinition](../resources/intu |offsetUri|String|Offset CSP Path from Base Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |rootDefinitionId|String|Root setting definition id if the setting is a child setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |categoryId|String|Specify category in which the setting is under. Support $filters. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |id|String|Identifier for item Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |description|String|Description of the setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsimplesettinginstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsimplesettinginstance.md | Here is a JSON representation of the resource. "value": "String" } }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsimplesettinginstancetemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsimplesettinginstancetemplate.md | Here is a JSON representation of the resource. } } }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsimplesettingvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsimplesettingvalue.md | Here is a JSON representation of the resource. "useTemplateDefault": true } }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsimplesettingvaluetemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsimplesettingvaluetemplate.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagementConfigurationSimpleSettingValueTemplate", "settingValueTemplateId": "String" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationstringformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationstringformat.md | Namespace: microsoft.graph |dateTime|13|Indicates a string that is expected to be a valid Datetime.| |surfaceHub|14|Indicates a Windows SKU applicability value that maps to Intune.| |bashScript|19|String whose value is a bash script|-|unknownFutureValue|20|Sentinel member for cases where the client cannot handle the new enum values.| +|unknownFutureValue|20|Sentinel member for cases where the client cannot handle the new enum values.| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationstringsettingvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationstringsettingvalue.md | Here is a JSON representation of the resource. }, "value": "String" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationstringsettingvalueconstantdefaulttemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationstringsettingvalueconstantdefaulttemplate.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagementConfigurationStringSettingValueConstantDefaultTemplate", "constantValue": "String" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationstringsettingvaluedefaulttemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationstringsettingvaluedefaulttemplate.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.deviceManagementConfigurationStringSettingValueDefaultTemplate" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationstringsettingvaluedefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationstringsettingvaluedefinition.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationstringsettingvaluetemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationstringsettingvaluetemplate.md | Here is a JSON representation of the resource. "constantValue": "String" } }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationtechnologies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md | Describes which technology this setting can be deployed with |exchangeOnline|256|Setting can be deployed through the Exchange Online agent channel.| |mobileApplicationManagement|512|Setting can be deployed through the Mobile Application Management (MAM) channel| |linuxMdm|1024|Setting can be deployed through the Linux Mdm channel.|+|extensibility|2048|Setting can be deployed through the Extensibility channel.| |enrollment|4096|Setting can be deployed through device enrollment.| |endpointPrivilegeManagement|8192|Setting can be deployed using the Endpoint privilege management channel| |unknownFutureValue|16384|Evolvable enumeration sentinel value. Do not use.|-|windowsOsRecovery|32768|Setting can be deployed using the Operating System Recovery channel| +|windowsOsRecovery|32768|Setting can be deployed using the Operating System Recovery channel| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationtemplatefamily | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md | Describes the TemplateFamily for the Template entity |deviceConfigurationScripts|22|Template Family for device configuration scripts| |deviceConfigurationPolicies|23|Template Family for device configuration policies| |windowsOsRecoveryPolicies|24|Template Family for windowsOsRecovery that can be applied during a Windows operating system recovery|-|companyPortal|25|Template Family for Company Portal settings| +|companyPortal|25|Template Family for Company Portal settings| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationwindowssettingapplicability | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationwindowssettingapplicability.md | Inherits from [deviceManagementConfigurationSettingApplicability](../resources/i |description|String|description of the setting Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md)| |platform|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platform setting can be applied on. Posible values are: none, android, androidEnterprise, iOs, macOs, windows10X, windows10, aosp, and linux. Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.| |deviceMode|[deviceManagementConfigurationDeviceMode](../resources/intune-deviceconfigv2-devicemanagementconfigurationdevicemode.md)|Device Mode that setting can be applied on Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `kiosk`.|-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through. Posible values are: none, mdm, configManager, intuneManagementExtension, thirdParty, documentGateway, appleRemoteManagement, microsoftSense, exchangeOnline, edgeMam, linuxMdm, extensibility, enrollment, endpointPrivilegeManagement. Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| +|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through. Posible values are: none, mdm, configManager, intuneManagementExtension, thirdParty, documentGateway, appleRemoteManagement, microsoftSense, exchangeOnline, edgeMam, linuxMdm, extensibility, enrollment, endpointPrivilegeManagement. Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `extensibility`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| |configurationServiceProviderVersion|String|Version of CSP setting is a part of| |maximumSupportedVersion|String|Maximum supported version of Windows| |minimumSupportedVersion|String|Minimum supported version of Windows| Here is a JSON representation of the resource. "requiresAzureAd": true, "requiredAzureAdTrustType": "String" }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationwindowsskus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationwindowsskus.md | Namespace: microsoft.graph |holoLensEnterprise|11|| |holographicForBusiness|12|| |windowsMultiSession|13||-|surfaceHub|14|| +|surfaceHub|14|| |
v1.0 | Intune Deviceconfigv2 Devicemanagementprioritymetadata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementprioritymetadata.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagementPriorityMetaData", "priority": 1024 }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementreusablepolicysetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementreusablepolicysetting.md | Here is a JSON representation of the resource. "version": 1024, "referencingConfigurationPolicyCount": 1024 }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementsettinginsightsdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementsettinginsightsdefinition.md | Here is a JSON representation of the resource. ] } }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementtemplateinsightsdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementtemplateinsightsdefinition.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementtemplatelifecyclestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementtemplatelifecyclestate.md | Describes current lifecycle state of a template |active|20|Active| |superseded|30|Superseded| |deprecated|40|Deprecated|-|retired|50|Retired| +|retired|50|Retired| |
v1.0 | Intune Deviceintent Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagement.md | Singleton entity that acts as a Container for all device management functionalit ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-deviceintent-devicemanagement-get.md)|[deviceManagement](../resources/intune-deviceintent-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-deviceintent-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-deviceintent-devicemanagement-update.md)|[deviceManagement](../resources/intune-deviceintent-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-deviceintent-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-deviceintent-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-deviceintent-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementabstractcomplexsettingdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementabstractcomplexsettingdefinition.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementabstractcomplexsettinginstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementabstractcomplexsettinginstance.md | Here is a JSON representation of the resource. "valueJson": "String", "implementationId": "String" }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementbooleansettinginstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementbooleansettinginstance.md | Here is a JSON representation of the resource. "valueJson": "String", "value": true }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementcollectionsettingdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementcollectionsettingdefinition.md | Here is a JSON representation of the resource. ], "elementDefinitionId": "String" }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementcollectionsettinginstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementcollectionsettinginstance.md | Here is a JSON representation of the resource. "definitionId": "String", "valueJson": "String" }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementcomparisonresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementcomparisonresult.md | Setting comparison result type |equal|1|The setting values are equal| |notEqual|2|The setting values are not equal| |added|3|The setting is added|-|removed|4|The setting is removed| +|removed|4|The setting is removed| |
v1.0 | Intune Deviceintent Devicemanagementcomplexsettingdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementcomplexsettingdefinition.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementcomplexsettinginstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementcomplexsettinginstance.md | Here is a JSON representation of the resource. "definitionId": "String", "valueJson": "String" }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementconstraint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementconstraint.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.deviceManagementConstraint" }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementenumconstraint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementenumconstraint.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementenumvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementenumvalue.md | Here is a JSON representation of the resource. "value": "String", "displayName": "String" }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementintegersettinginstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementintegersettinginstance.md | Here is a JSON representation of the resource. "valueJson": "String", "value": 1024 }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementintent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementintent.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementintentassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementintentassignment.md | Here is a JSON representation of the resource. "collectionId": "String" } }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementintentcustomizedsetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementintentcustomizedsetting.md | Here is a JSON representation of the resource. "defaultJson": "String", "customizedJson": "String" }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementintentdevicesettingstatesummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementintentdevicesettingstatesummary.md | Here is a JSON representation of the resource. "notApplicableCount": 1024, "remediatedCount": 1024 }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementintentdevicestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementintentdevicestate.md | Here is a JSON representation of the resource. "state": "String", "deviceId": "String" }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementintentdevicestatesummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementintentdevicestatesummary.md | Here is a JSON representation of the resource. "notApplicablePlatformCount": 1024, "successCount": 1024 }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementintentsettingcategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementintentsettingcategory.md | Here is a JSON representation of the resource. "displayName": "String", "hasRequiredSetting": true }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementintentsettingsecretconstraint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementintentsettingsecretconstraint.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.deviceManagementIntentSettingSecretConstraint" }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementintentuserstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementintentuserstate.md | Here is a JSON representation of the resource. "lastReportedDateTime": "String (timestamp)", "state": "String" }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementintentuserstatesummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementintentuserstatesummary.md | Here is a JSON representation of the resource. "notApplicableCount": 1024, "successCount": 1024 }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementsettingabstractimplementationconstraint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementsettingabstractimplementationconstraint.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementsettingappconstraint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementsettingappconstraint.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementsettingbooleanconstraint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementsettingbooleanconstraint.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagementSettingBooleanConstraint", "value": true }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementsettingcategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementsettingcategory.md | Here is a JSON representation of the resource. "displayName": "String", "hasRequiredSetting": true }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementsettingcollectionconstraint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementsettingcollectionconstraint.md | Here is a JSON representation of the resource. "minimumLength": 1024, "maximumLength": 1024 }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementsettingcomparison | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementsettingcomparison.md | Here is a JSON representation of the resource. "newValueJson": "String", "comparisonResult": "String" }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementsettingdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementsettingdefinition.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementsettingdependency | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementsettingdependency.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementsettingenrollmenttypeconstraint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementsettingenrollmenttypeconstraint.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementsettingfileconstraint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementsettingfileconstraint.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementsettinginstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementsettinginstance.md | Here is a JSON representation of the resource. "definitionId": "String", "valueJson": "String" }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementsettingintegerconstraint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementsettingintegerconstraint.md | Here is a JSON representation of the resource. "minimumValue": 1024, "maximumValue": 1024 }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementsettingprofileconstraint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementsettingprofileconstraint.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementsettingregexconstraint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementsettingregexconstraint.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagementSettingRegexConstraint", "regex": "String" }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementsettingrequiredconstraint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementsettingrequiredconstraint.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagementSettingRequiredConstraint", "notConfiguredValue": "String" }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementsettingsddlconstraint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementsettingsddlconstraint.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.deviceManagementSettingSddlConstraint" }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementsettingstringlengthconstraint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementsettingstringlengthconstraint.md | Here is a JSON representation of the resource. "minimumLength": 1024, "maximumLength": 1024 }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementsettingxmlconstraint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementsettingxmlconstraint.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.deviceManagementSettingXmlConstraint" }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementstringsettinginstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementstringsettinginstance.md | Here is a JSON representation of the resource. "valueJson": "String", "value": "String" }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementtemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementtemplate.md | Here is a JSON representation of the resource. "templateSubtype": "String", "publishedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementtemplatesettingcategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementtemplatesettingcategory.md | Here is a JSON representation of the resource. "displayName": "String", "hasRequiredSetting": true }-``` +``` |
v1.0 | Intune Deviceintent Devicemanagementtemplatesubtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementtemplatesubtype.md | Template subtype |antivirus|6|Endpoint security anitivirus subtype| |firewallSharedAppList|7|Endpoint security firewall shared app subtype| |firewallSharedIpList|8|Endpoint security firewall shared ip range list subtype|-|firewallSharedPortlist|9|Endpoint security firewall shared port range list subtype| +|firewallSharedPortlist|9|Endpoint security firewall shared port range list subtype| |
v1.0 | Intune Deviceintent Devicemanagementtemplatetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanagementtemplatetype.md | Template type |deviceCompliance|8|Device compliance template| |deviceConfigurationForOffice365|9|Device Configuration for Microsoft Office 365 settings| |cloudPC|10|Windows 365 security baseline template|-|firewallSharedSettings|11|Firewall Shared Object templates for reference settings| +|firewallSharedSettings|11|Firewall Shared Object templates for reference settings| |
v1.0 | Intune Deviceintent Devicemanangementintentvaluetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-devicemanangementintentvaluetype.md | Namespace: microsoft.graph |string|2|The setting value is a string| |complex|3|The setting value is a complex object| |collection|4|The setting value is a collection|-|abstractComplex|5|The setting value is an abstract complex object| +|abstractComplex|5|The setting value is an abstract complex object| |
v1.0 | Intune Deviceintent Policyplatformtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-policyplatformtype.md | Supported platform types for policies. |windows10AndLater|6|Windows 10 and later.| |androidWorkProfile|7|AndroidWorkProfile.| |windows10XProfile|8|Windows10XProfile.|-|all|100|All platforms.| +|all|100|All platforms.| |
v1.0 | Intune Deviceintent Securitybaselinecategorystatesummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-securitybaselinecategorystatesummary.md | Here is a JSON representation of the resource. "notApplicableCount": 1024, "displayName": "String" }-``` +``` |
v1.0 | Intune Deviceintent Securitybaselinecompliancestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-securitybaselinecompliancestate.md | Security Baseline Compliance State |notApplicable|2|Not applicable state| |notSecure|3|Not secure state| |error|4|Error state|-|conflict|5|Conflict state| +|conflict|5|Conflict state| |
v1.0 | Intune Deviceintent Securitybaselinecontributingpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-securitybaselinecontributingpolicy.md | Here is a JSON representation of the resource. "displayName": "String", "sourceType": "String" }-``` +``` |
v1.0 | Intune Deviceintent Securitybaselinedevicestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-securitybaselinedevicestate.md | Here is a JSON representation of the resource. "state": "String", "lastReportedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Deviceintent Securitybaselinepolicysourcetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-securitybaselinepolicysourcetype.md | Authoring source of a policy |Member|Value|Description| |:|:|:| |deviceConfiguration|0||-|deviceIntent|1|| +|deviceIntent|1|| |
v1.0 | Intune Deviceintent Securitybaselinestatesummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-securitybaselinestatesummary.md | Here is a JSON representation of the resource. "conflictCount": 1024, "notApplicableCount": 1024 }-``` +``` |
v1.0 | Intune Deviceintent Securitybaselinetemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-deviceintent-securitybaselinetemplate.md | Here is a JSON representation of the resource. "templateSubtype": "String", "publishedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Devices Activatedeviceesimactionresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-activatedeviceesimactionresult.md | Here is a JSON representation of the resource. "lastUpdatedDateTime": "String (timestamp)", "carrierUrl": "String" }-``` +``` |
v1.0 | Intune Devices Adminconsent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-adminconsent.md | Here is a JSON representation of the resource. "shareAPNSData": "String", "shareUserExperienceAnalyticsData": "String" }-``` +``` |
v1.0 | Intune Devices Adminconsentstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-adminconsentstate.md | Admin consent state. |:|:|:| |notConfigured|0|Admin did not configure the item| |granted|1|Admin granted item|-|notGranted|2|Admin deos not grant item| +|notGranted|2|Admin deos not grant item| |
v1.0 | Intune Devices Applepushnotificationcertificate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-applepushnotificationcertificate.md | Here is a JSON representation of the resource. "certificateSerialNumber": "String", "certificate": "String" }-``` +``` |
v1.0 | Intune Devices Applogcollectiondownloaddetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-applogcollectiondownloaddetails.md | Here is a JSON representation of the resource. "decryptionKey": "String", "appLogDecryptionAlgorithm": "String" }-``` +``` |
v1.0 | Intune Devices Applogcollectionrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-applogcollectionrequest.md | Here is a JSON representation of the resource. ], "completedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Devices Applogdecryptionalgorithm | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-applogdecryptionalgorithm.md | Namespace: microsoft.graph |Member|Value|Description| |:|:|:| |aes256|0|decrypting using Aes256.|-|unknownFutureValue|1|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|1|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Apploguploadstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-apploguploadstate.md | AppLogUploadStatus |pending|0|Default. Indicates that request is waiting to be processed or under processing.| |completed|1|Indicates that request is completed with file uploaded to Azure blob for download.| |failed|2|Indicates that request is completed with file uploaded to Azure blob for download.|-|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Azureattestationsettingstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-azureattestationsettingstatus.md | A list of possible Azure Attestation states for a device. Azure Attestation sett |notApplicable|0|Indicates that the device is not a Windows 11 device.| |enabled|1|Indicates that the device has the Azure attestation setting enabled.| |disabled|2|Indicates that the device has the Azure attestation setting disabled.|-|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Bulkmanageddeviceactionresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-bulkmanageddeviceactionresult.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Devices Chassistype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-chassistype.md | Chassis type. |phone|100|Phone.| |tablet|101|Mobile tablet.| |mobileOther|102|Other mobile.|-|mobileUnknown|103|Unknown mobile.| +|mobileUnknown|103|Unknown mobile.| |
v1.0 | Intune Devices Chromeosdeviceproperty | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-chromeosdeviceproperty.md | Here is a JSON representation of the resource. "valueType": "String", "updatable": true }-``` +``` |
v1.0 | Intune Devices Cloudpcconnectivityissue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-cloudpcconnectivityissue.md | Here is a JSON representation of the resource. "errorDescription": "String", "recommendedAction": "String" }-``` +``` |
v1.0 | Intune Devices Comanageddevicessummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-comanageddevicessummary.md | Here is a JSON representation of the resource. "officeAppsCount": 1024, "totalComanagedCount": 1024 }-``` +``` |
v1.0 | Intune Devices Comanagementeligibledevice | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-comanagementeligibledevice.md | Here is a JSON representation of the resource. "userName": "String", "status": "String" }-``` +``` |
v1.0 | Intune Devices Comanagementeligibledevicessummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-comanagementeligibledevicessummary.md | Here is a JSON representation of the resource. "needsOsUpdateCount": 1024, "ineligibleCount": 1024 }-``` +``` |
v1.0 | Intune Devices Comanagementeligibletype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-comanagementeligibletype.md | Namespace: microsoft.graph |needsOsUpdate|4|| |ineligible|5|| |scheduledForEnrollment|6|Devices scheduled for Co-Management enrollment|-|unknownFutureValue|7|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|7|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Compliancestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-compliancestate.md | Compliance state. |conflict|3|Conflict with other rules.| |error|4|Error.| |inGracePeriod|254|Device is non-compliant but still has access to corporate resources|-|configManager|255|Managed by Config Manager| +|configManager|255|Managed by Config Manager| |
v1.0 | Intune Devices Configurationmanageraction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-configurationmanageraction.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.configurationManagerAction", "action": "String" }-``` +``` |
v1.0 | Intune Devices Configurationmanageractiondeliverystatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-configurationmanageractiondeliverystatus.md | Delivery state of Configuration Manager device action |pendingDelivery|1|Pending to deliver the action to ConfigurationManager| |deliveredToConnectorService|2|Action is sent to ConfigurationManager Connector service (cloud)| |failedToDeliverToConnectorService|3|Failed to send the action to ConfigurationManager Connector service (cloud)|-|deliveredToOnPremisesServer|4|Action is delivered to ConfigurationManager on-prem server| +|deliveredToOnPremisesServer|4|Action is delivered to ConfigurationManager on-prem server| |
v1.0 | Intune Devices Configurationmanageractionresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-configurationmanageractionresult.md | Here is a JSON representation of the resource. "actionDeliveryStatus": "String", "errorCode": 1024 }-``` +``` |
v1.0 | Intune Devices Configurationmanageractiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-configurationmanageractiontype.md | Action type on Configuration Manager client |appEvaluation|3|Evaluation application policy on Configuration Manager client| |quickScan|5|Evaluation application policy on Configuration Manager client| |fullScan|6|Evaluation application policy on Configuration Manager client|-|windowsDefenderUpdateSignatures|7|Evaluation application policy on Configuration Manager client| +|windowsDefenderUpdateSignatures|7|Evaluation application policy on Configuration Manager client| |
v1.0 | Intune Devices Configurationmanagerclientenabledfeatures | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-configurationmanagerclientenabledfeatures.md | Here is a JSON representation of the resource. "endpointProtection": true, "officeApps": true }-``` +``` |
v1.0 | Intune Devices Configurationmanagerclienthealthstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-configurationmanagerclienthealthstate.md | Here is a JSON representation of the resource. "errorCode": 1024, "lastSyncDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Devices Configurationmanagerclientinformation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-configurationmanagerclientinformation.md | Here is a JSON representation of the resource. "isBlocked": true, "clientVersion": "String" }-``` +``` |
v1.0 | Intune Devices Configurationmanagerclientstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-configurationmanagerclientstate.md | Configuration manager client state |healthy|7|This device was able to check in with the configuration manager service successfully.| |installFailed|8|The configuration manager agent failed to install.| |updateFailed|11|The update from version x to version y of the configuration manager agent failed. |-|communicationError|19|The configuration manager agent was able to reach the configuration manager service in the past but is now no longer able to. | +|communicationError|19|The configuration manager agent was able to reach the configuration manager service in the past but is now no longer able to. | |
v1.0 | Intune Devices Dataprocessorserviceforwindowsfeaturesonboarding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-dataprocessorserviceforwindowsfeaturesonboarding.md | Here is a JSON representation of the resource. "hasValidWindowsLicense": true, "areDataProcessorServiceForWindowsFeaturesEnabled": true }-``` +``` |
v1.0 | Intune Devices Datasharingconsent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-datasharingconsent.md | Here is a JSON representation of the resource. "grantedByUpn": "String", "grantedByUserId": "String" }-``` +``` |
v1.0 | Intune Devices Deleteuserfromsharedappledeviceactionresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-deleteuserfromsharedappledeviceactionresult.md | Here is a JSON representation of the resource. "lastUpdatedDateTime": "String (timestamp)", "userPrincipalName": "String" }-``` +``` |
v1.0 | Intune Devices Detectedapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-detectedapp.md | Here is a JSON representation of the resource. "publisher": "String", "platform": "String" }-``` +``` |
v1.0 | Intune Devices Detectedappplatformtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-detectedappplatformtype.md | Indicates the operating system / platform of the discovered application. Some p |androidDeviceAdministrator|8|Indicates that the platform of the detected application is Android device administrator.| |androidWorkProfile|9|Indicates that the platform of the detected application is Android work profile.| |androidDedicatedAndFullyManaged|10|Indicates that the platform of the detected application is Android dedicated and fully managed.|-|unknownFutureValue|11|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|11|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Deviceactionpayload | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-deviceactionpayload.md | Here is a JSON representation of the resource. "errorCode": 1024, "lastModifiedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Devices Deviceactionpayloadintent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-deviceactionpayloadintent.md | A list of possible intent values on the policy or app when executing this action |:|:|:| |remove|0|Default. Indicates that the deployed policy or app is intended to be removed on the managed device| |restore|1|Indicates that the policy or app already intended to remove through previous actions and is now intended to be restored on the managed device|-|unknownFutureValue|2|Evolvable enumeration sentinel value. Do not use| +|unknownFutureValue|2|Evolvable enumeration sentinel value. Do not use| |
v1.0 | Intune Devices Deviceactionpayloadstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-deviceactionpayloadstatus.md | A list of possible status values for the policy or app regarding their executed |removed|1|Indicates that the policy or app has been successfully removed on the managed device| |error|2|Indicates that the policy or app has failed to be removed or restored on the managed device. The error may be retriable depending on the detail and error code| |succeeded|3|Indicates that the policy or app has been successfully restored on the managed device|-|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use| +|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use| |
v1.0 | Intune Devices Deviceactionpayloadtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-deviceactionpayloadtype.md | A list of possible payload types to execute this action on the managed device. P |application|0|Default. Indicates that the payload type for the action is graph.mobileApp. Application is uninstalled on removal and installed back on restoration| |deviceConfiguration|1|Indicates that the payload type for the action is graph.deviceConfiguration. DeviceConfiguration corresponding settings are removed on removal and added back on restoration| |deviceManagementConfigurationPolicy|2|Indicates that the payload type for the action is graph.deviceManagementConfigurationPolicy. DeviceManagementConfigurationPolicy corresponding settings are removed on removal and added back on restoration|-|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use| +|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use| |
v1.0 | Intune Devices Deviceactionresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-deviceactionresult.md | Here is a JSON representation of the resource. "startDateTime": "String (timestamp)", "lastUpdatedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Devices Deviceappmanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-deviceappmanagement.md | Singleton entity that acts as a container for all device app management function ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceAppManagement](../api/intune-devices-deviceappmanagement-get.md)|[deviceAppManagement](../resources/intune-devices-deviceappmanagement.md)|Read properties and relationships of the [deviceAppManagement](../resources/intune-devices-deviceappmanagement.md) object.| -|[Update deviceAppManagement](../api/intune-devices-deviceappmanagement-update.md)|[deviceAppManagement](../resources/intune-devices-deviceappmanagement.md)|Update the properties of a [deviceAppManagement](../resources/intune-devices-deviceappmanagement.md) object.| +|[Get deviceAppManagement](../api/intune-devices-deviceappmanagement-get.md)|[deviceAppManagement](../resources/intune-shared-deviceappmanagement.md)|Read properties and relationships of the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object.| +|[Update deviceAppManagement](../api/intune-devices-deviceappmanagement-update.md)|[deviceAppManagement](../resources/intune-shared-deviceappmanagement.md)|Update the properties of a [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceAppManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Devices Devicecategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicecategory.md | Namespace: microsoft.graph ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceCategory](../api/intune-devices-devicecategory-get.md)|[deviceCategory](../resources/intune-devices-devicecategory.md)|Read properties and relationships of the [deviceCategory](../resources/intune-devices-devicecategory.md) object.| -|[Update deviceCategory](../api/intune-devices-devicecategory-update.md)|[deviceCategory](../resources/intune-devices-devicecategory.md)|Update the properties of a [deviceCategory](../resources/intune-devices-devicecategory.md) object.| +|[Get deviceCategory](../api/intune-devices-devicecategory-get.md)|[deviceCategory](../resources/intune-shared-devicecategory.md)|Read properties and relationships of the [deviceCategory](../resources/intune-shared-devicecategory.md) object.| +|[Update deviceCategory](../api/intune-devices-devicecategory-update.md)|[deviceCategory](../resources/intune-shared-devicecategory.md)|Update the properties of a [deviceCategory](../resources/intune-shared-devicecategory.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceCategory", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Devices Devicecleanupruleplatformtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicecleanupruleplatformtype.md | Define the platform type for which the admin wants to create the device clean up |macOS|7|Indicates that clean up rule is associated with MacOS managed device platforms.| |windows|8|Indicates that clean up rule is associated with Windows managed device platforms.| |windowsHolographic|9|Indicates that clean up rule is associated with Windows Holographic managed device platforms.|-|unknownFutureValue|10|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|10|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Devicecompliancescript | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicecompliancescript.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Devices Devicecompliancescriptdevicestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicecompliancescriptdevicestate.md | Here is a JSON representation of the resource. "scriptOutput": "String", "scriptError": "String" }-``` +``` |
v1.0 | Intune Devices Devicecompliancescriptrunsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicecompliancescriptrunsummary.md | Here is a JSON representation of the resource. "detectionScriptPendingDeviceCount": 1024, "lastScriptRunDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Devices Devicecustomattributeshellscript | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicecustomattributeshellscript.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Devices Devicecustomattributevaluetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicecustomattributevaluetype.md | Represents the expected type for a macOS custom attribute script value. |:|:|:| |integer|0|Indicates the value for a custom attribute script is an integer.| |string|1|Indicates the value for a custom attribute script is a string.|-|dateTime|2|Indicates the value for a custom attribute script is a date conforming to ISO 8601.| +|dateTime|2|Indicates the value for a custom attribute script is a date conforming to ISO 8601.| |
v1.0 | Intune Devices Deviceenrollmenttype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-deviceenrollmenttype.md | Possible ways of adding a mobile device to management. |androidEnterpriseDedicatedDevice|15|Android Enterprise Dedicated Device| |androidEnterpriseFullyManaged|16|Android Enterprise Fully Managed| |androidEnterpriseCorporateWorkProfile|17|Android Enterprise Corporate Work Profile|+|androidAOSPUserOwnedDeviceEnrollment|18|Indicates the device enrollment is for android device owned by/associated with user using Android Open Source Project (AOSP) on a non-Google mobile services.| +|androidAOSPUserlessDeviceEnrollment|19|Indicates the device enrollment is for user less android device using Android Open Source Project (AOSP) on a non-Google mobile services.| |appleACMEBasicBYOD|20|Apple ACME BYOD enrollment| |appleACMEDEPUserless|21|Apple ACME DEP Userless enrollment| |appleACMEDEPUDACompanyPortal|22|Apple ACME DEP UDA enrollment at CP| |appleACMEDEPUDASetupAsstLegacy|23|Apple ACME DEP UDA enrollment at Setup Asst (legacy)|-|appleACMEDEPUDAModernAuth|24|Apple ACME DEP UDA enrollment at Setup Asst (Modern Auth)| +|appleACMEDEPUDAModernAuth|24|Apple ACME DEP UDA enrollment at Setup Asst (Modern Auth)| |
v1.0 | Intune Devices Deviceeventlevel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-deviceeventlevel.md | Indicates device event level. Possible values are: None, Verbose, Information, W |warning|3|Indicates that the device event level is warning.| |error|4|Indicates that the device event level is error.| |critical|5|Indicates that the device event level is critical.|-|unknownFutureValue|6|Placeholder value for future expansion.| +|unknownFutureValue|6|Placeholder value for future expansion.| |
v1.0 | Intune Devices Deviceexchangeaccessstatesummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-deviceexchangeaccessstatesummary.md | Here is a JSON representation of the resource. "unknownDeviceCount": 1024, "unavailableDeviceCount": 1024 }-``` +``` |
v1.0 | Intune Devices Devicegeolocation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicegeolocation.md | Here is a JSON representation of the resource. "heading": "4.2", "speed": "4.2" }-``` +``` |
v1.0 | Intune Devices Deviceguardlocalsystemauthoritycredentialguardstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-deviceguardlocalsystemauthoritycredentialguardstate.md | Namespace: microsoft.graph |rebootRequired|1|Reboot required| |notLicensed|2|Not licensed for Credential Guard| |notConfigured|3|Not configured|-|virtualizationBasedSecurityNotRunning|4|Virtualization Based security is not running| +|virtualizationBasedSecurityNotRunning|4|Virtualization Based security is not running| |
v1.0 | Intune Devices Deviceguardvirtualizationbasedsecurityhardwarerequirementstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-deviceguardvirtualizationbasedsecurityhardwarerequirementstate.md | Namespace: microsoft.graph |secureBootRequired|1|Secure boot required| |dmaProtectionRequired|2|DMA protection required| |hyperVNotSupportedForGuestVM|4|HyperV not supported for Guest VM|-|hyperVNotAvailable|8|HyperV feature is not available| +|hyperVNotAvailable|8|HyperV feature is not available| |
v1.0 | Intune Devices Deviceguardvirtualizationbasedsecuritystate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-deviceguardvirtualizationbasedsecuritystate.md | Namespace: microsoft.graph |notLicensed|3|Not licensed| |notConfigured|4|Not configured| |doesNotMeetHardwareRequirements|5|System does not meet hardware requirements|-|other|42|Other. Event logs in microsoft-Windows-DeviceGuard have more details.| +|other|42|Other. Event logs in microsoft-Windows-DeviceGuard have more details.| |
v1.0 | Intune Devices Devicehealthattestationstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicehealthattestationstate.md | Here is a JSON representation of the resource. "systemManagementMode": "String", "securedCorePC": "String" }-``` +``` |
v1.0 | Intune Devices Devicehealthscript | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicehealthscript.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Devices Devicehealthscriptassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicehealthscriptassignment.md | Here is a JSON representation of the resource. "time": "String (time of day)" } }-``` +``` |
v1.0 | Intune Devices Devicehealthscriptbooleanparameter | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicehealthscriptbooleanparameter.md | Here is a JSON representation of the resource. "applyDefaultValueWhenNotAssigned": true, "defaultValue": true }-``` +``` |
v1.0 | Intune Devices Devicehealthscriptdailyschedule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicehealthscriptdailyschedule.md | Here is a JSON representation of the resource. "useUtc": true, "time": "String (time of day)" }-``` +``` |
v1.0 | Intune Devices Devicehealthscriptdevicestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicehealthscriptdevicestate.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Devices Devicehealthscripthourlyschedule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicehealthscripthourlyschedule.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceHealthScriptHourlySchedule", "interval": 1024 }-``` +``` |
v1.0 | Intune Devices Devicehealthscriptintegerparameter | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicehealthscriptintegerparameter.md | Here is a JSON representation of the resource. "applyDefaultValueWhenNotAssigned": true, "defaultValue": 1024 }-``` +``` |
v1.0 | Intune Devices Devicehealthscriptparameter | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicehealthscriptparameter.md | Here is a JSON representation of the resource. "isRequired": true, "applyDefaultValueWhenNotAssigned": true }-``` +``` |
v1.0 | Intune Devices Devicehealthscriptpolicystate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicehealthscriptpolicystate.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Devices Devicehealthscriptremediationhistory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicehealthscriptremediationhistory.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Devices Devicehealthscriptremediationhistorydata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicehealthscriptremediationhistorydata.md | Here is a JSON representation of the resource. "noIssueDeviceCount": 1024, "detectFailedDeviceCount": 1024 }-``` +``` |
v1.0 | Intune Devices Devicehealthscriptremediationsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicehealthscriptremediationsummary.md | Here is a JSON representation of the resource. "scriptCount": 1024, "remediatedDeviceCount": 1024 }-``` +``` |
v1.0 | Intune Devices Devicehealthscriptrunonceschedule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicehealthscriptrunonceschedule.md | Here is a JSON representation of the resource. "time": "String (time of day)", "date": "String (Date)" }-``` +``` |
v1.0 | Intune Devices Devicehealthscriptrunschedule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicehealthscriptrunschedule.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceHealthScriptRunSchedule", "interval": 1024 }-``` +``` |
v1.0 | Intune Devices Devicehealthscriptrunsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicehealthscriptrunsummary.md | Here is a JSON representation of the resource. "lastScriptRunDateTime": "String (timestamp)", "issueRemediatedCumulativeDeviceCount": 1024 }-``` +``` |
v1.0 | Intune Devices Devicehealthscriptstringparameter | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicehealthscriptstringparameter.md | Here is a JSON representation of the resource. "applyDefaultValueWhenNotAssigned": true, "defaultValue": "String" }-``` +``` |
v1.0 | Intune Devices Devicehealthscripttimeschedule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicehealthscripttimeschedule.md | Here is a JSON representation of the resource. "useUtc": true, "time": "String (time of day)" }-``` +``` |
v1.0 | Intune Devices Devicehealthscripttype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicehealthscripttype.md | Indicates the type of device script. |Member|Value|Description| |:|:|:| |deviceHealthScript|0|Indicates this is a device health script.|-|managedInstallerScript|1|Indicates this is a managed installer script.| +|managedInstallerScript|1|Indicates this is a managed installer script.| |
v1.0 | Intune Devices Deviceidentityattestationdetail | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-deviceidentityattestationdetail.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceIdentityAttestationDetail", "deviceIdentityAttestationStatus": "String" }-``` +``` |
v1.0 | Intune Devices Deviceidentityattestationstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-deviceidentityattestationstatus.md | Indicates the state of the anomaly. Eg: anomaly severity can be new, active, dis |unTrusted|2|Indicates that the Device attestation is supported on the device, it was attempted on the device and the attestation has failed. The device is untrusted| |notSupported|3|Indicates that the device does not support Attestation. This could be because of missing hardware or software support.| |incompleteData|4|Indicates that the device did not provide with the data that were required to perform attestation.|-|unknownFutureValue|5|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|5|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Devicelicensingstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicelicensingstatus.md | Indicates the device licensing status after Windows device based subscription ha |deviceLicenseRemoveSucceed|12|This status is set when the device license removing succeeds.| |deviceLicenseRemoveFailed|13|This status is set when the device license removing fails.| |unknownFutureValue|14|This is put here as a place holder for future extension.|-|unknown|-1|Default. Set to unknown when status cannot be determined.| +|unknown|-1|Default. Set to unknown when status cannot be determined.| |
v1.0 | Intune Devices Devicelogcollectionrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicelogcollectionrequest.md | Here is a JSON representation of the resource. "id": "String (identifier)", "templateType": "String" }-``` +``` |
v1.0 | Intune Devices Devicelogcollectionresponse | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicelogcollectionresponse.md | Windows Log Collection request entity. |[Delete deviceLogCollectionResponse](../api/intune-devices-devicelogcollectionresponse-delete.md)|None|Deletes a [deviceLogCollectionResponse](../resources/intune-devices-devicelogcollectionresponse.md).| |[Update deviceLogCollectionResponse](../api/intune-devices-devicelogcollectionresponse-update.md)|[deviceLogCollectionResponse](../resources/intune-devices-devicelogcollectionresponse.md)|Update the properties of a [deviceLogCollectionResponse](../resources/intune-devices-devicelogcollectionresponse.md) object.| |[createDownloadUrl action](../api/intune-devices-devicelogcollectionresponse-createdownloadurl.md)|String||+|[downloadDeviceLogs action](../api/intune-devices-devicelogcollectionresponse-downloaddevicelogs.md)|String|| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "sizeInKB": "4.2", "enrolledByUser": "String" }-``` +``` |
v1.0 | Intune Devices Devicelogcollectionresponsev2 | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicelogcollectionresponsev2.md | Here is a JSON representation of the resource. "sizeInKB": "4.2", "enrolledByUserPrincipalName": "String" }-``` +``` |
v1.0 | Intune Devices Devicelogcollectiontemplatetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicelogcollectiontemplatetype.md | Enum for the template type used for collecting logs |Member|Value|Description| |:|:|:| |predefined|0|Predefined template for what will be collected|-|unknownFutureValue|1|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|1|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicemanagement.md | + + Title: "deviceManagement resource type" +description: "Singleton entity that acts as a container for all device management functionality." ++localization_priority: Normal ++++# deviceManagement resource type ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. ++Singleton entity that acts as a container for all device management functionality. ++## Methods +|Method|Return Type|Description| +|:|:|:| +|[Get deviceManagement](../api/intune-devices-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-devices-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[sendCustomNotificationToCompanyPortal action](../api/intune-devices-devicemanagement-sendcustomnotificationtocompanyportal.md)|None|| +|[userExperienceAnalyticsSummarizeWorkFromAnywhereDevices function](../api/intune-devices-devicemanagement-userexperienceanalyticssummarizeworkfromanywheredevices.md)|[userExperienceAnalyticsWorkFromAnywhereDevicesSummary](../resources/intune-devices-userexperienceanalyticsworkfromanywheredevicessummary.md)|| +|[userExperienceAnalyticsSummarizedDeviceScopes function](../api/intune-devices-devicemanagement-userexperienceanalyticssummarizeddevicescopes.md)|[userExperienceAnalyticsDeviceScopeSummary](../resources/intune-devices-userexperienceanalyticsdevicescopesummary.md)|| +|[getComanagedDevicesSummary function](../api/intune-devices-devicemanagement-getcomanageddevicessummary.md)|[comanagedDevicesSummary](../resources/intune-devices-comanageddevicessummary.md)|| +|[getComanagementEligibleDevicesSummary function](../api/intune-devices-devicemanagement-getcomanagementeligibledevicessummary.md)|[comanagementEligibleDevicesSummary](../resources/intune-devices-comanagementeligibledevicessummary.md)|| ++## Properties +|Property|Type|Description| +|:|:|:| +|id|String|Unique Identifier for the device| +|subscriptionState|[deviceManagementSubscriptionState](../resources/intune-devices-devicemanagementsubscriptionstate.md)|Tenant mobile device management subscription state. Possible values are: `pending`, `active`, `warning`, `disabled`, `deleted`, `blocked`, `lockedOut`.| +|subscriptions|[deviceManagementSubscriptions](../resources/intune-devices-devicemanagementsubscriptions.md)|Tenant's Subscription. Possible values are: `none`, `intune`, `office365`, `intunePremium`, `intune_EDU`, `intune_SMB`.| +|managedDeviceCleanupSettings|[managedDeviceCleanupSettings](../resources/intune-devices-manageddevicecleanupsettings.md)|Device cleanup rule| +|adminConsent|[adminConsent](../resources/intune-devices-adminconsent.md)|Admin consent information.| +|deviceProtectionOverview|[deviceProtectionOverview](../resources/intune-devices-deviceprotectionoverview.md)|Device protection overview.| +|windowsMalwareOverview|[windowsMalwareOverview](../resources/intune-devices-windowsmalwareoverview.md)|Malware overview for windows devices.| +|accountMoveCompletionDateTime|DateTimeOffset|The date & time when tenant data moved between scaleunits.| +|userExperienceAnalyticsSettings|[userExperienceAnalyticsSettings](../resources/intune-devices-userexperienceanalyticssettings.md)|User experience analytics device settings| +|dataProcessorServiceForWindowsFeaturesOnboarding|[dataProcessorServiceForWindowsFeaturesOnboarding](../resources/intune-devices-dataprocessorserviceforwindowsfeaturesonboarding.md)|A configuration entity for MEM features that utilize Data Processor Service for Windows (DPSW) data.| +|userExperienceAnalyticsAnomalySeverityOverview|[userExperienceAnalyticsAnomalySeverityOverview](../resources/intune-devices-userexperienceanalyticsanomalyseverityoverview.md)|The user experience analytics anomaly severity overview entity contains the count information for each severity of anomaly.| ++## Relationships +|Relationship|Type|Description| +|:|:|:| +|remoteActionAudits|[remoteActionAudit](../resources/intune-devices-remoteactionaudit.md) collection|The list of device remote action audits with the tenant.| +|applePushNotificationCertificate|[applePushNotificationCertificate](../resources/intune-devices-applepushnotificationcertificate.md)|Apple push notification certificate.| +|deviceManagementScripts|[deviceManagementScript](../resources/intune-shared-devicemanagementscript.md) collection|The list of device management scripts associated with the tenant.| +|deviceShellScripts|[deviceShellScript](../resources/intune-devices-deviceshellscript.md) collection|The list of device shell scripts associated with the tenant.| +|deviceCustomAttributeShellScripts|[deviceCustomAttributeShellScript](../resources/intune-devices-devicecustomattributeshellscript.md) collection|The list of device custom attribute shell scripts associated with the tenant.| +|deviceHealthScripts|[deviceHealthScript](../resources/intune-devices-devicehealthscript.md) collection|The list of device health scripts associated with the tenant.| +|deviceComplianceScripts|[deviceComplianceScript](../resources/intune-devices-devicecompliancescript.md) collection|The list of device compliance scripts associated with the tenant.| +|managedDeviceOverview|[managedDeviceOverview](../resources/intune-devices-manageddeviceoverview.md)|Device overview| +|managedDeviceCleanupRules|[managedDeviceCleanupRule](../resources/intune-devices-manageddevicecleanuprule.md) collection|Device cleanup rule V2| +|detectedApps|[detectedApp](../resources/intune-devices-detectedapp.md) collection|The list of detected apps associated with a device.| +|managedDevices|[managedDevice](../resources/intune-devices-manageddevice.md) collection|The list of managed devices.| +|windowsMalwareInformation|[windowsMalwareInformation](../resources/intune-devices-windowsmalwareinformation.md) collection|The list of affected malware in the tenant.| +|dataSharingConsents|[dataSharingConsent](../resources/intune-devices-datasharingconsent.md) collection|Data sharing consents.| +|mobileAppTroubleshootingEvents|[mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) collection|The collection property of MobileAppTroubleshootingEvent.| +|userExperienceAnalyticsOverview|[userExperienceAnalyticsOverview](../resources/intune-devices-userexperienceanalyticsoverview.md)|User experience analytics overview| +|userExperienceAnalyticsBaselines|[userExperienceAnalyticsBaseline](../resources/intune-devices-userexperienceanalyticsbaseline.md) collection|User experience analytics baselines| +|userExperienceAnalyticsCategories|[userExperienceAnalyticsCategory](../resources/intune-devices-userexperienceanalyticscategory.md) collection|User experience analytics categories| +|userExperienceAnalyticsDevicePerformance|[userExperienceAnalyticsDevicePerformance](../resources/intune-devices-userexperienceanalyticsdeviceperformance.md) collection|User experience analytics device performance| +|userExperienceAnalyticsDeviceStartupHistory|[userExperienceAnalyticsDeviceStartupHistory](../resources/intune-devices-userexperienceanalyticsdevicestartuphistory.md) collection|User experience analytics device Startup History| +|userExperienceAnalyticsDeviceStartupProcesses|[userExperienceAnalyticsDeviceStartupProcess](../resources/intune-devices-userexperienceanalyticsdevicestartupprocess.md) collection|User experience analytics device Startup Processes| +|userExperienceAnalyticsDeviceStartupProcessPerformance|[userExperienceAnalyticsDeviceStartupProcessPerformance](../resources/intune-devices-userexperienceanalyticsdevicestartupprocessperformance.md) collection|User experience analytics device Startup Process Performance| +|userExperienceAnalyticsScoreHistory|[userExperienceAnalyticsScoreHistory](../resources/intune-devices-userexperienceanalyticsscorehistory.md) collection|User experience analytics device Startup Score History| +|userExperienceAnalyticsMetricHistory|[userExperienceAnalyticsMetricHistory](../resources/intune-devices-userexperienceanalyticsmetrichistory.md) collection|User experience analytics metric history| +|userExperienceAnalyticsDeviceMetricHistory|[userExperienceAnalyticsMetricHistory](../resources/intune-devices-userexperienceanalyticsmetrichistory.md) collection|User experience analytics device metric history| +|userExperienceAnalyticsAppHealthApplicationPerformance|[userExperienceAnalyticsAppHealthApplicationPerformance](../resources/intune-devices-userexperienceanalyticsapphealthapplicationperformance.md) collection|User experience analytics appHealth Application Performance| +|userExperienceAnalyticsAppHealthApplicationPerformanceByAppVersion|[userExperienceAnalyticsAppHealthAppPerformanceByAppVersion](../resources/intune-devices-userexperienceanalyticsapphealthappperformancebyappversion.md) collection|User experience analytics appHealth Application Performance by App Version| +|userExperienceAnalyticsAppHealthApplicationPerformanceByAppVersionDetails|[userExperienceAnalyticsAppHealthAppPerformanceByAppVersionDetails](../resources/intune-devices-userexperienceanalyticsapphealthappperformancebyappversiondetails.md) collection|User experience analytics appHealth Application Performance by App Version details| +|userExperienceAnalyticsAppHealthApplicationPerformanceByAppVersionDeviceId|[userExperienceAnalyticsAppHealthAppPerformanceByAppVersionDeviceId](../resources/intune-devices-userexperienceanalyticsapphealthappperformancebyappversiondeviceid.md) collection|User experience analytics appHealth Application Performance by App Version Device Id| +|userExperienceAnalyticsAppHealthApplicationPerformanceByOSVersion|[userExperienceAnalyticsAppHealthAppPerformanceByOSVersion](../resources/intune-devices-userexperienceanalyticsapphealthappperformancebyosversion.md) collection|User experience analytics appHealth Application Performance by OS Version| +|userExperienceAnalyticsAppHealthDevicePerformance|[userExperienceAnalyticsAppHealthDevicePerformance](../resources/intune-devices-userexperienceanalyticsapphealthdeviceperformance.md) collection|User experience analytics appHealth Device Performance| +|userExperienceAnalyticsAppHealthDeviceModelPerformance|[userExperienceAnalyticsAppHealthDeviceModelPerformance](../resources/intune-devices-userexperienceanalyticsapphealthdevicemodelperformance.md) collection|User experience analytics appHealth Model Performance| +|userExperienceAnalyticsAppHealthOSVersionPerformance|[userExperienceAnalyticsAppHealthOSVersionPerformance](../resources/intune-devices-userexperienceanalyticsapphealthosversionperformance.md) collection|User experience analytics appHealth OS version Performance| +|userExperienceAnalyticsAppHealthOverview|[userExperienceAnalyticsCategory](../resources/intune-devices-userexperienceanalyticscategory.md)|User experience analytics appHealth overview| +|userExperienceAnalyticsAppHealthDevicePerformanceDetails|[userExperienceAnalyticsAppHealthDevicePerformanceDetails](../resources/intune-devices-userexperienceanalyticsapphealthdeviceperformancedetails.md) collection|User experience analytics device performance details| +|userExperienceAnalyticsDevicesWithoutCloudIdentity|[userExperienceAnalyticsDeviceWithoutCloudIdentity](../resources/intune-devices-userexperienceanalyticsdevicewithoutcloudidentity.md) collection|User experience analytics devices without cloud identity.| +|userExperienceAnalyticsNotAutopilotReadyDevice|[userExperienceAnalyticsNotAutopilotReadyDevice](../resources/intune-devices-userexperienceanalyticsnotautopilotreadydevice.md) collection|User experience analytics devices not Windows Autopilot ready.| +|userExperienceAnalyticsWorkFromAnywhereMetrics|[userExperienceAnalyticsWorkFromAnywhereMetric](../resources/intune-devices-userexperienceanalyticsworkfromanywheremetric.md) collection|User experience analytics work from anywhere metrics.| +|userExperienceAnalyticsWorkFromAnywhereHardwareReadinessMetric|[userExperienceAnalyticsWorkFromAnywhereHardwareReadinessMetric](../resources/intune-devices-userexperienceanalyticsworkfromanywherehardwarereadinessmetric.md)|User experience analytics work from anywhere hardware readiness metrics.| +|userExperienceAnalyticsWorkFromAnywhereModelPerformance|[userExperienceAnalyticsWorkFromAnywhereModelPerformance](../resources/intune-devices-userexperienceanalyticsworkfromanywheremodelperformance.md) collection|The user experience analytics work from anywhere model performance| +|comanagedDevices|[managedDevice](../resources/intune-devices-manageddevice.md) collection|The list of co-managed devices report| +|comanagementEligibleDevices|[comanagementEligibleDevice](../resources/intune-devices-comanagementeligibledevice.md) collection|The list of co-management eligible devices report| +|userExperienceAnalyticsResourcePerformance|[userExperienceAnalyticsResourcePerformance](../resources/intune-devices-userexperienceanalyticsresourceperformance.md) collection|User experience analytics resource performance| +|userExperienceAnalyticsRemoteConnection|[userExperienceAnalyticsRemoteConnection](../resources/intune-devices-userexperienceanalyticsremoteconnection.md) collection|User experience analytics remote connection| +|userExperienceAnalyticsImpactingProcess|[userExperienceAnalyticsImpactingProcess](../resources/intune-devices-userexperienceanalyticsimpactingprocess.md) collection|User experience analytics impacting process| +|userExperienceAnalyticsDeviceScores|[userExperienceAnalyticsDeviceScores](../resources/intune-devices-userexperienceanalyticsdevicescores.md) collection|User experience analytics device scores| +|userExperienceAnalyticsModelScores|[userExperienceAnalyticsModelScores](../resources/intune-devices-userexperienceanalyticsmodelscores.md) collection|User experience analytics model scores| +|cloudPCConnectivityIssues|[cloudPCConnectivityIssue](../resources/intune-devices-cloudpcconnectivityissue.md) collection|The list of CloudPC Connectivity Issue.| +|userExperienceAnalyticsBatteryHealthDevicePerformance|[userExperienceAnalyticsBatteryHealthDevicePerformance](../resources/intune-devices-userexperienceanalyticsbatteryhealthdeviceperformance.md) collection|User Experience Analytics Battery Health Device Performance| +|userExperienceAnalyticsBatteryHealthModelPerformance|[userExperienceAnalyticsBatteryHealthModelPerformance](../resources/intune-devices-userexperienceanalyticsbatteryhealthmodelperformance.md) collection|User Experience Analytics Battery Health Model Performance| +|userExperienceAnalyticsBatteryHealthOsPerformance|[userExperienceAnalyticsBatteryHealthOsPerformance](../resources/intune-devices-userexperienceanalyticsbatteryhealthosperformance.md) collection|User Experience Analytics Battery Health Os Performance| +|userExperienceAnalyticsBatteryHealthAppImpact|[userExperienceAnalyticsBatteryHealthAppImpact](../resources/intune-devices-userexperienceanalyticsbatteryhealthappimpact.md) collection|User Experience Analytics Battery Health App Impact| +|userExperienceAnalyticsBatteryHealthCapacityDetails|[userExperienceAnalyticsBatteryHealthCapacityDetails](../resources/intune-devices-userexperienceanalyticsbatteryhealthcapacitydetails.md)|User Experience Analytics Battery Health Capacity Details| +|userExperienceAnalyticsBatteryHealthRuntimeDetails|[userExperienceAnalyticsBatteryHealthRuntimeDetails](../resources/intune-devices-userexperienceanalyticsbatteryhealthruntimedetails.md)|User Experience Analytics Battery Health Runtime Details| +|userExperienceAnalyticsBatteryHealthDeviceAppImpact|[userExperienceAnalyticsBatteryHealthDeviceAppImpact](../resources/intune-devices-userexperienceanalyticsbatteryhealthdeviceappimpact.md) collection|User Experience Analytics Battery Health Device App Impact| +|userExperienceAnalyticsBatteryHealthDeviceRuntimeHistory|[userExperienceAnalyticsBatteryHealthDeviceRuntimeHistory](../resources/intune-devices-userexperienceanalyticsbatteryhealthdeviceruntimehistory.md) collection|User Experience Analytics Battery Health Device Runtime History| +|userExperienceAnalyticsDeviceScopes|[userExperienceAnalyticsDeviceScope](../resources/intune-devices-userexperienceanalyticsdevicescope.md) collection|The user experience analytics device scope entity contains device scope configuration use to apply filtering on the endpoint analytics reports.| +|userExperienceAnalyticsDeviceScope|[userExperienceAnalyticsDeviceScope](../resources/intune-devices-userexperienceanalyticsdevicescope.md)|The user experience analytics device scope entity endpoint to trigger on the service to either START or STOP computing metrics data based on a device scope configuration.| +|tenantAttachRBAC|[tenantAttachRBAC](../resources/intune-devices-tenantattachrbac.md)|TenantAttach RBAC Enablement| +|userExperienceAnalyticsAnomaly|[userExperienceAnalyticsAnomaly](../resources/intune-devices-userexperienceanalyticsanomaly.md) collection|The user experience analytics anomaly entity contains anomaly details.| +|userExperienceAnalyticsAnomalyDevice|[userExperienceAnalyticsAnomalyDevice](../resources/intune-devices-userexperienceanalyticsanomalydevice.md) collection|The user experience analytics anomaly entity contains device details.| +|userExperienceAnalyticsAnomalyCorrelationGroupOverview|[userExperienceAnalyticsAnomalyCorrelationGroupOverview](../resources/intune-devices-userexperienceanalyticsanomalycorrelationgroupoverview.md) collection|The user experience analytics anomaly correlation group overview entity contains the information for each correlation group of an anomaly.| +|userExperienceAnalyticsDeviceTimelineEvent|[userExperienceAnalyticsDeviceTimelineEvent](../resources/intune-devices-userexperienceanalyticsdevicetimelineevent.md) collection|The user experience analytics device events entity contains NRT device timeline event details.| +## JSON Representation +Here is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.deviceManagement" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.deviceManagement", + "id": "String (identifier)", + "subscriptionState": "String", + "subscriptions": "String", + "managedDeviceCleanupSettings": { + "@odata.type": "microsoft.graph.managedDeviceCleanupSettings", + "deviceInactivityBeforeRetirementInDays": "String" + }, + "adminConsent": { + "@odata.type": "microsoft.graph.adminConsent", + "shareAPNSData": "String", + "shareUserExperienceAnalyticsData": "String" + }, + "deviceProtectionOverview": { + "@odata.type": "microsoft.graph.deviceProtectionOverview", + "totalReportedDeviceCount": 1024, + "inactiveThreatAgentDeviceCount": 1024, + "unknownStateThreatAgentDeviceCount": 1024, + "pendingSignatureUpdateDeviceCount": 1024, + "cleanDeviceCount": 1024, + "pendingFullScanDeviceCount": 1024, + "pendingRestartDeviceCount": 1024, + "pendingManualStepsDeviceCount": 1024, + "pendingOfflineScanDeviceCount": 1024, + "criticalFailuresDeviceCount": 1024, + "pendingQuickScanDeviceCount": 1024 + }, + "windowsMalwareOverview": { + "@odata.type": "microsoft.graph.windowsMalwareOverview", + "malwareDetectedDeviceCount": 1024, + "totalMalwareCount": 1024, + "totalDistinctMalwareCount": 1024, + "malwareStateSummary": [ + { + "@odata.type": "microsoft.graph.windowsMalwareStateCount", + "state": "String", + "deviceCount": 1024, + "malwareDetectionCount": 1024, + "distinctMalwareCount": 1024, + "lastUpdateDateTime": "String (timestamp)" + } + ], + "malwareSeveritySummary": [ + { + "@odata.type": "microsoft.graph.windowsMalwareSeverityCount", + "severity": "String", + "malwareDetectionCount": 1024, + "distinctMalwareCount": 1024, + "lastUpdateDateTime": "String (timestamp)" + } + ], + "malwareExecutionStateSummary": [ + { + "@odata.type": "microsoft.graph.windowsMalwareExecutionStateCount", + "executionState": "String", + "deviceCount": 1024, + "lastUpdateDateTime": "String (timestamp)" + } + ], + "malwareCategorySummary": [ + { + "@odata.type": "microsoft.graph.windowsMalwareCategoryCount", + "category": "String", + "deviceCount": 1024, + "activeMalwareDetectionCount": 1024, + "distinctActiveMalwareCount": 1024, + "lastUpdateDateTime": "String (timestamp)" + } + ], + "malwareNameSummary": [ + { + "@odata.type": "microsoft.graph.windowsMalwareNameCount", + "malwareIdentifier": "String", + "name": "String", + "deviceCount": 1024, + "lastUpdateDateTime": "String (timestamp)" + } + ], + "osVersionsSummary": [ + { + "@odata.type": "microsoft.graph.osVersionCount", + "osVersion": "String", + "deviceCount": 1024, + "lastUpdateDateTime": "String (timestamp)" + } + ] + }, + "accountMoveCompletionDateTime": "String (timestamp)", + "userExperienceAnalyticsSettings": { + "@odata.type": "microsoft.graph.userExperienceAnalyticsSettings", + "configurationManagerDataConnectorConfigured": true + }, + "dataProcessorServiceForWindowsFeaturesOnboarding": { + "@odata.type": "microsoft.graph.dataProcessorServiceForWindowsFeaturesOnboarding", + "hasValidWindowsLicense": true, + "areDataProcessorServiceForWindowsFeaturesEnabled": true + }, + "userExperienceAnalyticsAnomalySeverityOverview": { + "@odata.type": "microsoft.graph.userExperienceAnalyticsAnomalySeverityOverview", + "lowSeverityAnomalyCount": 1024, + "mediumSeverityAnomalyCount": 1024, + "highSeverityAnomalyCount": 1024, + "informationalSeverityAnomalyCount": 1024 + } +} +``` |
v1.0 | Intune Devices Devicemanagementexchangeaccessstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicemanagementexchangeaccessstate.md | Device Exchange Access State. |unknown|1|Device access state to Exchange is unknown| |allowed|2|Device has access to Exchange| |blocked|3|Device is Blocked in Exchange|-|quarantined|4|Device is Quarantined in Exchange| +|quarantined|4|Device is Quarantined in Exchange| |
v1.0 | Intune Devices Devicemanagementexchangeaccessstatereason | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicemanagementexchangeaccessstatereason.md | Device Exchange Access State Reason. |mfaRequired|13|Access state due to MFA challenge| |azureADBlockDueToAccessPolicy|14|Access State revoked by AAD Access Policy| |compromisedPassword|15|Access State revoked by compromised password|-|deviceNotKnownWithManagedApp|16|Access state revoked by managed application challenge| +|deviceNotKnownWithManagedApp|16|Access state revoked by managed application challenge| |
v1.0 | Intune Devices Devicemanagementscript | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicemanagementscript.md | Intune will provide customer the ability to run their Powershell scripts on the ## Methods |Method|Return Type|Description| |:|:|:|-|[List deviceManagementScripts](../api/intune-devices-devicemanagementscript-list.md)|[deviceManagementScript](../resources/intune-devices-devicemanagementscript.md) collection|List properties and relationships of the [deviceManagementScript](../resources/intune-devices-devicemanagementscript.md) objects.| -|[Get deviceManagementScript](../api/intune-devices-devicemanagementscript-get.md)|[deviceManagementScript](../resources/intune-devices-devicemanagementscript.md)|Read properties and relationships of the [deviceManagementScript](../resources/intune-devices-devicemanagementscript.md) object.| -|[Create deviceManagementScript](../api/intune-devices-devicemanagementscript-create.md)|[deviceManagementScript](../resources/intune-devices-devicemanagementscript.md)|Create a new [deviceManagementScript](../resources/intune-devices-devicemanagementscript.md) object.| -|[Delete deviceManagementScript](../api/intune-devices-devicemanagementscript-delete.md)|None|Deletes a [deviceManagementScript](../resources/intune-devices-devicemanagementscript.md).| -|[Update deviceManagementScript](../api/intune-devices-devicemanagementscript-update.md)|[deviceManagementScript](../resources/intune-devices-devicemanagementscript.md)|Update the properties of a [deviceManagementScript](../resources/intune-devices-devicemanagementscript.md) object.| +|[List deviceManagementScripts](../api/intune-devices-devicemanagementscript-list.md)|[deviceManagementScript](../resources/intune-shared-devicemanagementscript.md) collection|List properties and relationships of the [deviceManagementScript](../resources/intune-shared-devicemanagementscript.md) objects.| +|[Get deviceManagementScript](../api/intune-devices-devicemanagementscript-get.md)|[deviceManagementScript](../resources/intune-shared-devicemanagementscript.md)|Read properties and relationships of the [deviceManagementScript](../resources/intune-shared-devicemanagementscript.md) object.| +|[Create deviceManagementScript](../api/intune-devices-devicemanagementscript-create.md)|[deviceManagementScript](../resources/intune-shared-devicemanagementscript.md)|Create a new [deviceManagementScript](../resources/intune-shared-devicemanagementscript.md) object.| +|[Delete deviceManagementScript](../api/intune-devices-devicemanagementscript-delete.md)|None|Deletes a [deviceManagementScript](../resources/intune-shared-devicemanagementscript.md).| +|[Update deviceManagementScript](../api/intune-devices-devicemanagementscript-update.md)|[deviceManagementScript](../resources/intune-shared-devicemanagementscript.md)|Update the properties of a [deviceManagementScript](../resources/intune-shared-devicemanagementscript.md) object.| |[assign action](../api/intune-devices-devicemanagementscript-assign.md)|None|| ## Properties Intune will provide customer the ability to run their Powershell scripts on the |scriptContent|Binary|The script content.| |createdDateTime|DateTimeOffset|The date and time the device management script was created. This property is read-only.| |lastModifiedDateTime|DateTimeOffset|The date and time the device management script was last modified. This property is read-only.|-|runAsAccount|[runAsAccountType](../resources/intune-devices-runasaccounttype.md)|Indicates the type of execution context. Possible values are: `system`, `user`.| +|runAsAccount|[runAsAccountType](../resources/intune-shared-runasaccounttype.md)|Indicates the type of execution context. Possible values are: `system`, `user`.| |fileName|String|Script file name.| |roleScopeTagIds|String collection|List of Scope Tag IDs for this PowerShellScript instance.| Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Devices Devicemanagementscriptassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicemanagementscriptassignment.md | Here is a JSON representation of the resource. "collectionId": "String" } }-``` +``` |
v1.0 | Intune Devices Devicemanagementscriptdevicestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicemanagementscriptdevicestate.md | Here is a JSON representation of the resource. "errorCode": 1024, "errorDescription": "String" }-``` +``` |
v1.0 | Intune Devices Devicemanagementscriptgroupassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicemanagementscriptgroupassignment.md | Here is a JSON representation of the resource. "id": "String (identifier)", "targetGroupId": "String" }-``` +``` |
v1.0 | Intune Devices Devicemanagementscriptrunsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicemanagementscriptrunsummary.md | Here is a JSON representation of the resource. "successUserCount": 1024, "errorUserCount": 1024 }-``` +``` |
v1.0 | Intune Devices Devicemanagementscriptuserstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicemanagementscriptuserstate.md | Here is a JSON representation of the resource. "errorDeviceCount": 1024, "userPrincipalName": "String" }-``` +``` |
v1.0 | Intune Devices Devicemanagementsubscriptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicemanagementsubscriptions.md | Tenant mobile device management subscriptions. |office365|2|Office365 Subscription| |intunePremium|4|Microsoft Intune Premium Subscription| |intune_EDU|8|Microsoft Intune for Education Subscription|-|intune_SMB|16|Microsoft Intune for Small Businesses Subscription| +|intune_SMB|16|Microsoft Intune for Small Businesses Subscription| |
v1.0 | Intune Devices Devicemanagementsubscriptionstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicemanagementsubscriptionstate.md | Tenant mobile device management subscription state. |disabled|3|Disabled| |deleted|4|Deleted| |blocked|5|Blocked|-|lockedOut|8|LockedOut| +|lockedOut|8|LockedOut| |
v1.0 | Intune Devices Deviceoperatingsystemsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-deviceoperatingsystemsummary.md | Here is a JSON representation of the resource. "linuxCount": 1024, "chromeOSCount": 1024 }-``` +``` |
v1.0 | Intune Devices Deviceprotectionoverview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-deviceprotectionoverview.md | Here is a JSON representation of the resource. "criticalFailuresDeviceCount": 1024, "pendingQuickScanDeviceCount": 1024 }-``` +``` |
v1.0 | Intune Devices Devicequeryresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicequeryresult.md | - Title: "deviceQueryResult resource type" -description: "Results of Intune Pivot device queries ran for this device." --localization_priority: Normal --doc_type: resourcePageType ---# deviceQueryResult resource type --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Results of Intune Pivot device queries ran for this device. --## Methods -|Method|Return Type|Description| -|:|:|:| -|[List deviceQueryResults](../api/intune-devices-devicequeryresult-list.md)|[deviceQueryResult](../resources/intune-devices-devicequeryresult.md) collection|List properties and relationships of the [deviceQueryResult](../resources/intune-devices-devicequeryresult.md) objects.| -|[Get deviceQueryResult](../api/intune-devices-devicequeryresult-get.md)|[deviceQueryResult](../resources/intune-devices-devicequeryresult.md)|Read properties and relationships of the [deviceQueryResult](../resources/intune-devices-devicequeryresult.md) object.| -|[Create deviceQueryResult](../api/intune-devices-devicequeryresult-create.md)|[deviceQueryResult](../resources/intune-devices-devicequeryresult.md)|Create a new [deviceQueryResult](../resources/intune-devices-devicequeryresult.md) object.| -|[Delete deviceQueryResult](../api/intune-devices-devicequeryresult-delete.md)|None|Deletes a [deviceQueryResult](../resources/intune-devices-devicequeryresult.md).| -|[Update deviceQueryResult](../api/intune-devices-devicequeryresult-update.md)|[deviceQueryResult](../resources/intune-devices-devicequeryresult.md)|Update the properties of a [deviceQueryResult](../resources/intune-devices-devicequeryresult.md) object.| --## Properties -|Property|Type|Description| -|:|:|:| -|id|String|The unique identifier (ID) of an Intune Pivot device query.| -|status|[deviceQueryResultStatus](../resources/intune-devices-devicequeryresultstatus.md)|Indicates present status of an Intune Pivot device query. This property is read-only. Possible values are: `created`, `notified`, `pending`, `timedOut`, `internalServiceError`, `successful`, `failed`, `unknownFutureValue`.| -|createdDateTime|DateTimeOffset|Indicates creation time of an Intune Pivot device query. This property is read-only.| -|lastModifiedDateTime|DateTimeOffset|Last update time of an Intune Pivot device query. This property is read-only.| -|returnCode|Int32|Returned error code captured by an Intune Pivot device query. Valid values -2147483648 to 2147483647. This property is read-only.| -|errorMessage|String|Returned error message captured by an Intune Pivot device query. This property is read-only.| -|results|String|Results of Intune Pivot device query. This property is read-only.| --## Relationships -None --## JSON Representation -Here is a JSON representation of the resource. -<!-- { - "blockType": "resource", - "keyProperty": "id", - "@odata.type": "microsoft.graph.deviceQueryResult" -} >-``` json -{ - "@odata.type": "#microsoft.graph.deviceQueryResult", - "id": "String (identifier)", - "status": "String", - "createdDateTime": "String (timestamp)", - "lastModifiedDateTime": "String (timestamp)", - "returnCode": 1024, - "errorMessage": "String", - "results": "String" -} -``` |
v1.0 | Intune Devices Devicequeryresultstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicequeryresultstatus.md | - Title: "deviceQueryResultStatus enum type" -description: "Status of Intune Pivot device query." --localization_priority: Normal --doc_type: enumPageType ---# deviceQueryResultStatus enum type --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Status of Intune Pivot device query. --## Members -|Member|Value|Description| -|:|:|:| -|created|0|Created| -|notified|1|Notified| -|pending|2|Pending| -|timedOut|3|TimedOut| -|internalServiceError|4|InternalServiceError| -|successful|5|Successful| -|failed|6|Failed| -|unknownFutureValue|7|UnknownFutureValue| |
v1.0 | Intune Devices Deviceregistrationstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-deviceregistrationstate.md | Device registration status. |approvalPending|5|The device is pending approval.| |certificateReset|6|The device certificate has been reset.| |notRegisteredPendingEnrollment|7|The device is not registered and pending enrollment.|-|unknown|8|The device registration status is unknown.| +|unknown|8|The device registration status is unknown.| |
v1.0 | Intune Devices Devicescopeaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicescopeaction.md | Trigger on the service to either START or STOP computing metrics data based on a |Member|Value|Description| |:|:|:| |stop|0|Stop computing metrics data| -|start|1|Start computing metrics data| +|start|1|Start computing metrics data| |
v1.0 | Intune Devices Devicescopeactionresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicescopeactionresult.md | Here is a JSON representation of the resource. "status": "String", "failedMessage": "String" }-``` +``` |
v1.0 | Intune Devices Devicescopeactionstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicescopeactionstatus.md | Indicates the status of the attempted device scope action |:|:|:| |failed|0|Indicates the device scope action failed to trigger.| |succeeded|1|Indicates the device scope action was successfully triggered.|-|unknownFutureValue|2|Placeholder value for future expansion.| +|unknownFutureValue|2|Placeholder value for future expansion.| |
v1.0 | Intune Devices Devicescopeoperator | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicescopeoperator.md | Device scope configuration query operator. Possible values are: equals, notEqual |:|:|:| |none|0|No operator set for the device scope configuration.| |equals|1|Operator for the device configuration query to be used (Equals).|-|unknownFutureValue|2|Placeholder value for future expansion enums such as notEquals, contains, notContains, greaterThan, lessThan.| +|unknownFutureValue|2|Placeholder value for future expansion enums such as notEquals, contains, notContains, greaterThan, lessThan.| |
v1.0 | Intune Devices Devicescopeparameter | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicescopeparameter.md | Device scope configuration parameter. It will be expend in future to add more pa |:|:|:| |none|0|Device Scope parameter is not set| |scopeTag|1|use Scope Tag as parameter for the device scope configuration.|-|unknownFutureValue|2|Placeholder value for future expansion.| +|unknownFutureValue|2|Placeholder value for future expansion.| |
v1.0 | Intune Devices Devicescopestatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicescopestatus.md | Indicates the device scope status after the device scope has been enabled. Possi |computing|1|Indicates the device scope is enabled and report metrics data are being recalculated by the service.| |insufficientData|2|Indicates the device scope is enabled but there is insufficient data to calculate results. The system requires information from at least 5 devices before calculations can occur.| |completed|3|Device scope is enabled and finished recalculating the report metric. Device scope is now ready to be used.|-|unknownFutureValue|4|Placeholder value for future expansion.| +|unknownFutureValue|4|Placeholder value for future expansion.| |
v1.0 | Intune Devices Deviceshellscript | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-deviceshellscript.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Devices Devicetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicetype.md | Device type. |blackberry|100|Blackberry.| |palm|101|Palm.| |unknown|255|Represents that the device type is unknown.|-|cloudPC|257|Cloud PC device.| +|cloudPC|257|Cloud PC device.| |
v1.0 | Intune Devices Disktype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-disktype.md | Namespace: microsoft.graph |unknown|0|Enum member for unknown or default diskType.| |hdd|1|Enum member for HDD devices.| |ssd|2|Enum member for SSD devices.|-|unknownFutureValue|3|Evolvable enumeration sentinel value.Do not use.| +|unknownFutureValue|3|Evolvable enumeration sentinel value.Do not use.| |
v1.0 | Intune Devices Firmwareprotectiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-firmwareprotectiontype.md | A list of possible Firmware protection type for a device. Firmware protection is |systemGuardSecureLaunch|1|Indicates that System Guard Secure Launch is enabled for Firmware protection.| |firmwareAttackSurfaceReduction|2|Indicates that Firmware Attack Surface Reduction is enabled for Firmware protection. This is only applicable to Surface devices.| |disabled|3|Indicates that the device has Firmware protection disabled.|-|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Globaldevicehealthscriptstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-globaldevicehealthscriptstate.md | Indicates whether global device health scripts are enabled and are in which stat |:|:|:| |notConfigured|0|Global device health scripts are not configured| |pending|1|Global device health scripts are configured but not fully enabled|-|enabled|2|Global device health scripts are enabled and ready to use| +|enabled|2|Global device health scripts are enabled and ready to use| |
v1.0 | Intune Devices Hardwareinformation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-hardwareinformation.md | Here is a JSON representation of the resource. "deviceLicensingLastErrorCode": 1024, "deviceLicensingLastErrorDescription": "String" }-``` +``` |
v1.0 | Intune Devices Healthstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-healthstate.md | Indicates health state of the Windows management app. |:|:|:| |unknown|0|Unknown state.| |healthy|1|Healthy state.|-|unhealthy|2|Unhealthy state.| +|unhealthy|2|Unhealthy state.| |
v1.0 | Intune Devices Insightvaluedouble | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-insightvaluedouble.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.insightValueDouble", "value": "4.2" }-``` +``` |
v1.0 | Intune Devices Insightvalueint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-insightvalueint.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.insightValueInt", "value": 1024 }-``` +``` |
v1.0 | Intune Devices Jointype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-jointype.md | Device enrollment join type. |unknown|0|Unknown enrollment join type.| |azureADJoined|1|The device is joined by Azure AD.| |azureADRegistered|2|The device is registered by Azure AD.|-|hybridAzureADJoined|3|The device is joined by hybrid Azure AD.| +|hybridAzureADJoined|3|The device is joined by hybrid Azure AD.| |
v1.0 | Intune Devices Locatedeviceactionresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-locatedeviceactionresult.md | Here is a JSON representation of the resource. "speed": "4.2" } }-``` +``` |
v1.0 | Intune Devices Loggedonuser | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-loggedonuser.md | Here is a JSON representation of the resource. "userId": "String", "lastLogOnDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Devices Lostmodestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-lostmodestate.md | State of lost mode, indicating if lost mode is enabled or disabled |Member|Value|Description| |:|:|:| |disabled|0|Lost mode is disabled.|-|enabled|1|Lost mode is enabled.| +|enabled|1|Lost mode is enabled.| |
v1.0 | Intune Devices Malwarestateforwindowsdevice | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-malwarestateforwindowsdevice.md | Here is a JSON representation of the resource. "lastStateChangeDateTime": "String (timestamp)", "detectionCount": 1024 }-``` +``` |
v1.0 | Intune Devices Manageddevice | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-manageddevice.md | Devices that are managed or pre-enrolled through Intune |[initiateOnDemandProactiveRemediation action](../api/intune-devices-manageddevice-initiateondemandproactiveremediation.md)|None|Perform On Demand Proactive Remediation| |[rotateLocalAdminPassword action](../api/intune-devices-manageddevice-rotatelocaladminpassword.md)|None|Initiates a manual rotation for the local admin password on the device| |[pauseConfigurationRefresh action](../api/intune-devices-manageddevice-pauseconfigurationrefresh.md)|None|Initiates a command to pause config refresh for the device.|-|[syncPayloads action](../api/intune-devices-manageddevice-syncpayloads.md)|None|| +|[changeAssignments action](../api/intune-devices-manageddevice-changeassignments.md)|None|| |[appDiagnostics function](../api/intune-devices-manageddevice-appdiagnostics.md)|[powerliftIncidentMetadata](../resources/intune-devices-powerliftincidentmetadata.md) collection|| |[downloadAppDiagnostics action](../api/intune-devices-manageddevice-downloadappdiagnostics.md)|Stream|| |[createQuery action](../api/intune-devices-manageddevice-createquery.md)|[deviceQueryResult](../resources/intune-devices-devicequeryresult.md)|Allows user to send Intune Pivot device query to a managed device| Devices that are managed or pre-enrolled through Intune |deviceType|[deviceType](../resources/intune-shared-devicetype.md)|Platform of the device. Examples: Desktop, WindowsRT, etc. Default is unknown. Supports $filter operator 'eq' and 'or'. This property is read-only. Possible values are: `desktop`, `windowsRT`, `winMO6`, `nokia`, `windowsPhone`, `mac`, `winCE`, `winEmbedded`, `iPhone`, `iPad`, `iPod`, `android`, `iSocConsumer`, `unix`, `macMDM`, `holoLens`, `surfaceHub`, `androidForWork`, `androidEnterprise`, `windows10x`, `androidnGMS`, `chromeOS`, `linux`, `blackberry`, `palm`, `unknown`, `cloudPC`.| |complianceState|[complianceState](../resources/intune-devices-compliancestate.md)|Compliance state of the device. Examples: Compliant, Conflict, Error, etc. Default is unknown. Supports $filter operator 'eq' and 'or'. This property is read-only. Possible values are: `unknown`, `compliant`, `noncompliant`, `conflict`, `error`, `inGracePeriod`, `configManager`.| |jailBroken|String|Whether the device is jail broken or rooted. Default is an empty string. Supports $filter operator 'eq' and 'or'. This property is read-only.|-|managementAgent|[managementAgentType](../resources/intune-devices-managementagenttype.md)|Management channel of the device. Examples: Intune, EAS, etc. Default is unknown. Supports $filter operator 'eq' and 'or'. This property is read-only. Possible values are: `eas`, `mdm`, `easMdm`, `intuneClient`, `easIntuneClient`, `configurationManagerClient`, `configurationManagerClientMdm`, `configurationManagerClientMdmEas`, `unknown`, `jamf`, `googleCloudDevicePolicyController`, `microsoft365ManagedMdm`, `msSense`, `intuneAosp`, `google`, `unknownFutureValue`.| +|managementAgent|[managementAgentType](../resources/intune-shared-managementagenttype.md)|Management channel of the device. Examples: Intune, EAS, etc. Default is unknown. Supports $filter operator 'eq' and 'or'. This property is read-only. Possible values are: `eas`, `mdm`, `easMdm`, `intuneClient`, `easIntuneClient`, `configurationManagerClient`, `configurationManagerClientMdm`, `configurationManagerClientMdmEas`, `unknown`, `jamf`, `googleCloudDevicePolicyController`, `microsoft365ManagedMdm`, `msSense`, `intuneAosp`, `google`, `unknownFutureValue`.| |osVersion|String|Operating system version of the device. This property is read-only.| |easActivated|Boolean|Whether the device is Exchange ActiveSync activated. This property is read-only.| |easDeviceId|String|Exchange ActiveSync Id of the device. This property is read-only.| |easActivationDateTime|DateTimeOffset|Exchange ActivationSync activation time of the device. This property is read-only.| |aadRegistered|Boolean|Whether the device is Azure Active Directory registered. This property is read-only.| |azureADRegistered|Boolean|Whether the device is Azure Active Directory registered. This property is read-only.|-|deviceEnrollmentType|[deviceEnrollmentType](../resources/intune-devices-deviceenrollmenttype.md)|Enrollment type of the device. This property is read-only. Possible values are: `unknown`, `userEnrollment`, `deviceEnrollmentManager`, `appleBulkWithUser`, `appleBulkWithoutUser`, `windowsAzureADJoin`, `windowsBulkUserless`, `windowsAutoEnrollment`, `windowsBulkAzureDomainJoin`, `windowsCoManagement`, `windowsAzureADJoinUsingDeviceAuth`, `appleUserEnrollment`, `appleUserEnrollmentWithServiceAccount`, `azureAdJoinUsingAzureVmExtension`, `androidEnterpriseDedicatedDevice`, `androidEnterpriseFullyManaged`, `androidEnterpriseCorporateWorkProfile`, `appleACMEBasicBYOD`, `appleACMEDEPUserless`, `appleACMEDEPUDACompanyPortal`, `appleACMEDEPUDASetupAsstLegacy`, `appleACMEDEPUDAModernAuth`.| +|deviceEnrollmentType|[deviceEnrollmentType](../resources/intune-devices-deviceenrollmenttype.md)|Enrollment type of the device. This property is read-only. Possible values are: `unknown`, `userEnrollment`, `deviceEnrollmentManager`, `appleBulkWithUser`, `appleBulkWithoutUser`, `windowsAzureADJoin`, `windowsBulkUserless`, `windowsAutoEnrollment`, `windowsBulkAzureDomainJoin`, `windowsCoManagement`, `windowsAzureADJoinUsingDeviceAuth`, `appleUserEnrollment`, `appleUserEnrollmentWithServiceAccount`, `azureAdJoinUsingAzureVmExtension`, `androidEnterpriseDedicatedDevice`, `androidEnterpriseFullyManaged`, `androidEnterpriseCorporateWorkProfile`, `androidAOSPUserOwnedDeviceEnrollment`, `androidAOSPUserlessDeviceEnrollment`, `appleACMEBasicBYOD`, `appleACMEDEPUserless`, `appleACMEDEPUDACompanyPortal`, `appleACMEDEPUDASetupAsstLegacy`, `appleACMEDEPUDAModernAuth`.| |lostModeState|[lostModeState](../resources/intune-devices-lostmodestate.md)|Indicates if Lost mode is enabled or disabled. This property is read-only. Possible values are: `disabled`, `enabled`.| |activationLockBypassCode|String|The code that allows the Activation Lock on managed device to be bypassed. Default, is Null (Non-Default property) for this property when returned as part of managedDevice entity in LIST call. To retrieve actual values GET call needs to be made, with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only.| |emailAddress|String|Email(s) for the user associated with the device. This property is read-only.| Devices that are managed or pre-enrolled through Intune |configurationManagerClientInformation|[configurationManagerClientInformation](../resources/intune-devices-configurationmanagerclientinformation.md)|Configuration manager client information, valid only for devices managed, duel-managed or tri-managed by ConfigMgr Agent| |ethernetMacAddress|String|Indicates Ethernet MAC Address of the device. Default, is Null (Non-Default property) for this property when returned as part of managedDevice entity. Individual get call with select query options is needed to retrieve actual values. Example: deviceManagement/managedDevices({managedDeviceId})?$select=ethernetMacAddress Supports: $select. $Search is not supported. Read-only. This property is read-only.| |physicalMemoryInBytes|Int64|Total Memory in Bytes. Default is 0. To retrieve actual values GET call needs to be made, with device id and included in select parameter. Supports: $select. Read-only. This property is read-only.|-|processorArchitecture|[managedDeviceArchitecture](../resources/intune-devices-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| +|processorArchitecture|[managedDeviceArchitecture](../resources/intune-shared-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| |specificationVersion|String|Specification version. This property is read-only.| |joinType|[joinType](../resources/intune-devices-jointype.md)|Device join type. Possible values are: `unknown`, `azureADJoined`, `azureADRegistered`, `hybridAzureADJoined`.| |skuFamily|String|Device sku family| Devices that are managed or pre-enrolled through Intune |users|[user](../resources/intune-shared-user.md) collection|The primary users associated with the managed device.| |logCollectionRequests|[deviceLogCollectionResponse](../resources/intune-devices-devicelogcollectionresponse.md) collection|List of log collection requests| |deviceHealthScriptStates|[deviceHealthScriptPolicyState](../resources/intune-devices-devicehealthscriptpolicystate.md) collection|Results of device health scripts that ran for this device. Default is empty list. This property is read-only.|-|queryResults|[deviceQueryResult](../resources/intune-devices-devicequeryresult.md) collection|Results of device query that ran for this device. Default is empty list. This property is read-only.| - ## JSON Representation Here is a JSON representation of the resource. <!-- { Here is a JSON representation of the resource. "deviceIdentityAttestationStatus": "String" } }-``` +``` |
v1.0 | Intune Devices Manageddevicearchitecture | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-manageddevicearchitecture.md | Processor architecture |x86|1|X86| |x64|2|X64| |arm|3|ARM|-|arM64|4|ARM64| +|arM64|4|ARM64| |
v1.0 | Intune Devices Manageddevicecleanuprule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-manageddevicecleanuprule.md | Here is a JSON representation of the resource. "lastModifiedDateTime": "String (timestamp)", "deviceInactivityBeforeRetirementInDays": 1024 }-``` +``` |
v1.0 | Intune Devices Manageddevicecleanupsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-manageddevicecleanupsettings.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.managedDeviceCleanupSettings", "deviceInactivityBeforeRetirementInDays": "String" }-``` +``` |
v1.0 | Intune Devices Manageddevicemanagementfeatures | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-manageddevicemanagementfeatures.md | Device management features. |Member|Value|Description| |:|:|:| |none|0|Unknown device management features.|-|microsoftManagedDesktop|1|Microsoft Managed Desktop| +|microsoftManagedDesktop|1|Microsoft Managed Desktop| |
v1.0 | Intune Devices Manageddevicemodelsandmanufacturers | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-manageddevicemodelsandmanufacturers.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Devices Manageddeviceoverview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-manageddeviceoverview.md | Here is a JSON representation of the resource. }, "lastModifiedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Devices Manageddevicepartnerreportedhealthstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-manageddevicepartnerreportedhealthstate.md | Available health states for the Device Health API |highSeverity|6|Device is considered high threat by the mobile threat defense partner.| |unresponsive|7|Device is considered unresponsive by the mobile threat defense partner. The device health is not known.| |compromised|8|Device is considered compromised by the Threat Defense partner. This means the device has an active Threat or Risk which cannot be easily remediated by the end user and the user should contact their IT Admin.|-|misconfigured|9|Device is considered misconfigured with the Threat Defense partner. This means the device is missing a required profile or configuration for the Threat Defense Partner to function properly and is thus threat or risk analysis is not able to complete.| +|misconfigured|9|Device is considered misconfigured with the Threat Defense partner. This means the device is missing a required profile or configuration for the Threat Defense Partner to function properly and is thus threat or risk analysis is not able to complete.| |
v1.0 | Intune Devices Manageddeviceremoteaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-manageddeviceremoteaction.md | Namespace: microsoft.graph |initiateMobileDeviceManagementKeyRecovery|16|Name of action to initiate MDM key recovery| |initiateOnDemandProactiveRemediation|17|Name of action to initiate On Demand Proactive Remediation| |unknownFutureValue|18|Evolvable enum member|-|initiateDeviceAttestation|19|Indicates remote device action to intiate Mobile Device Management (MDM) attestation if device is capable for it| +|initiateDeviceAttestation|19|Indicates remote device action to intiate Mobile Device Management (MDM) attestation if device is capable for it| |
v1.0 | Intune Devices Managedinstallerstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-managedinstallerstatus.md | ManagedInstallerStatus |Member|Value|Description| |:|:|:| |disabled|0|Managed Installer is Disabled|-|enabled|1|Managed Installer is Enabled| +|enabled|1|Managed Installer is Enabled| |
v1.0 | Intune Devices Managementagenttype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-managementagenttype.md | Management agent type. |msSense|1024|| |intuneAosp|2048|This device is managed by Intune's MDM for AOSP (Android Open Source Project) devices| |google|8192|Indicates the management agent to manage the device is Google.|-|unknownFutureValue|8193|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|8193|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Managementstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-managementstate.md | Management state of device in Microsoft Intune. |wipeIssued|8|A wipe command was issued for the device| |wipeCanceled|9|A wipe command for this device has been canceled| |retireCanceled|10|A retire command for this device has been canceled|-|discovered|11|The device is discovered but not fully enrolled.| +|discovered|11|The device is discovered but not fully enrolled.| |
v1.0 | Intune Devices Mobileapptroubleshootingevent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-mobileapptroubleshootingevent.md | MobileAppTroubleshootingEvent Entity. ## Methods |Method|Return Type|Description| |:|:|:|-|[List mobileAppTroubleshootingEvents](../api/intune-devices-mobileapptroubleshootingevent-list.md)|[mobileAppTroubleshootingEvent](../resources/intune-devices-mobileapptroubleshootingevent.md) collection|List properties and relationships of the [mobileAppTroubleshootingEvent](../resources/intune-devices-mobileapptroubleshootingevent.md) objects.| -|[Get mobileAppTroubleshootingEvent](../api/intune-devices-mobileapptroubleshootingevent-get.md)|[mobileAppTroubleshootingEvent](../resources/intune-devices-mobileapptroubleshootingevent.md)|Read properties and relationships of the [mobileAppTroubleshootingEvent](../resources/intune-devices-mobileapptroubleshootingevent.md) object.| -|[Create mobileAppTroubleshootingEvent](../api/intune-devices-mobileapptroubleshootingevent-create.md)|[mobileAppTroubleshootingEvent](../resources/intune-devices-mobileapptroubleshootingevent.md)|Create a new [mobileAppTroubleshootingEvent](../resources/intune-devices-mobileapptroubleshootingevent.md) object.| -|[Delete mobileAppTroubleshootingEvent](../api/intune-devices-mobileapptroubleshootingevent-delete.md)|None|Deletes a [mobileAppTroubleshootingEvent](../resources/intune-devices-mobileapptroubleshootingevent.md).| -|[Update mobileAppTroubleshootingEvent](../api/intune-devices-mobileapptroubleshootingevent-update.md)|[mobileAppTroubleshootingEvent](../resources/intune-devices-mobileapptroubleshootingevent.md)|Update the properties of a [mobileAppTroubleshootingEvent](../resources/intune-devices-mobileapptroubleshootingevent.md) object.| +|[List mobileAppTroubleshootingEvents](../api/intune-devices-mobileapptroubleshootingevent-list.md)|[mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) collection|List properties and relationships of the [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) objects.| +|[Get mobileAppTroubleshootingEvent](../api/intune-devices-mobileapptroubleshootingevent-get.md)|[mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md)|Read properties and relationships of the [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) object.| +|[Create mobileAppTroubleshootingEvent](../api/intune-devices-mobileapptroubleshootingevent-create.md)|[mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md)|Create a new [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) object.| +|[Delete mobileAppTroubleshootingEvent](../api/intune-devices-mobileapptroubleshootingevent-delete.md)|None|Deletes a [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md).| +|[Update mobileAppTroubleshootingEvent](../api/intune-devices-mobileapptroubleshootingevent-update.md)|[mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md)|Update the properties of a [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.mobileAppTroubleshootingEvent", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Devices Obliterationbehavior | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-obliterationbehavior.md | In macOS 12 and later, this command uses Erase All Content and Settings (EACS) o |doNotObliterate|1|If Erase All Content and Settings (EACS) preflight fails, the device responds to the server with an Error status and doesnΓÇÖt attempt to erase itself. If EACS preflight succeeds but EACS fails, then the device doesnΓÇÖt attempt to erase itself.| |obliterateWithWarning|2|If Erase All Content and Settings (EACS) preflight fails, the device responds with an Acknowledged status and then attempts to erase itself. If EACS preflight succeeds but EACS fails, then the device attempts to erase itself.| |always|3|The system doesnΓÇÖt attempt Erase All Content and Settings (EACS). T2 and later devices always obliterate.|-|unknownFutureValue|999|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|999|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Operatingsystemupgradeeligibility | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-operatingsystemupgradeeligibility.md | Work From Anywhere windows device upgrade eligibility status. |unknown|1|Not enough data available to compute the eligibility of device for windows upgrade.| |notCapable|2|The device is not capable for windows upgrade.| |capable|3|The device is capable for windows upgrade.|-|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Osversioncount | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-osversioncount.md | Here is a JSON representation of the resource. "deviceCount": 1024, "lastUpdateDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Devices Powerliftdownloadrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-powerliftdownloadrequest.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Devices Powerliftincidentmetadata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-powerliftincidentmetadata.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Devices Privilegemanagementendusertype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-privilegemanagementendusertype.md | The type of user account on Windows that was used to performed the elevation. |azureAd|1|The user who performed the elevation logged in using an Azure Active Directory (Azure AD) account.| |hybrid|2|The user who performed the elevation logged in using Hybrid Azure AD joined account.| |local|3|The user who performed the elevation logged in using a Windows local account.|-|unknownFutureValue|4|Evolvable emuneration sentinel value. Do not use.| +|unknownFutureValue|4|Evolvable emuneration sentinel value. Do not use.| |
v1.0 | Intune Devices Privilegemanagementprocesstype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-privilegemanagementprocesstype.md | Indicates the type of elevated process |undefined|0|Default. If the type was unknown on the client for some reasons| |parent|1|The elevated process is a parent process| |child|2|The elevated process is a child process|-|unknownFutureValue|3|Evolvable emuneration sentinel value. Do not use| +|unknownFutureValue|3|Evolvable emuneration sentinel value. Do not use| |
v1.0 | Intune Devices Remediationstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-remediationstate.md | Indicates the type of execution status of the device management script. |success|2|Remediation script executed successfully and remediated the device state| |remediationFailed|3|Remediation script executed successfully but failed to remediated the device state| |scriptError|4|Remediation script execution encountered and error or timed out|-|unknownFutureValue|5|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|5|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Remoteaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-remoteaction.md | Remote actions Intune supports. |pauseConfigurationRefresh|37|Indicates an action has been initiated to pause configuration refresh for the device.| |initiateDeviceAttestation|38|Indicates remote device action to intiate Mobile Device Management (MDM) attestation if device is capable for it.| |changeAssignments|39|Indicates remote device action to override assignments for a Device.|-|delete|40|Indicates remote device action to delete a device from Intune portal.| +|delete|40|Indicates remote device action to delete a device from Intune portal.| |
v1.0 | Intune Devices Remoteactionaudit | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-remoteactionaudit.md | Here is a JSON representation of the resource. "actionState": "String", "managedDeviceId": "String" }-``` +``` |
v1.0 | Intune Devices Remotelockactionresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-remotelockactionresult.md | Here is a JSON representation of the resource. "lastUpdatedDateTime": "String (timestamp)", "unlockPin": "String" }-``` +``` |
v1.0 | Intune Devices Resetpasscodeactionresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-resetpasscodeactionresult.md | Here is a JSON representation of the resource. "passcode": "String", "errorCode": 1024 }-``` +``` |
v1.0 | Intune Devices Revokeapplevpplicensesactionresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-revokeapplevpplicensesactionresult.md | Here is a JSON representation of the resource. "totalLicensesCount": 1024, "failedLicensesCount": 1024 }-``` +``` |
v1.0 | Intune Devices Rotatebitlockerkeysdeviceactionresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-rotatebitlockerkeysdeviceactionresult.md | Here is a JSON representation of the resource. "lastUpdatedDateTime": "String (timestamp)", "errorCode": 1024 }-``` +``` |
v1.0 | Intune Devices Runasaccounttype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-runasaccounttype.md | Indicates the type of execution context the device management script runs in. |Member|Value|Description| |:|:|:| |system|0||-|user|1|| +|user|1|| |
v1.0 | Intune Devices Runstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-runstate.md | Indicates the type of execution status of the device management script. |fail|2|Script failed to run.| |scriptError|3|Discovery script hits error.| |pending|4|Script is pending to execute.|-|notApplicable|5|Script is not applicable for this device.| +|notApplicable|5|Script is not applicable for this device.| |
v1.0 | Intune Devices Sharedappledeviceuser | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-sharedappledeviceuser.md | Here is a JSON representation of the resource. "dataQuota": 1024, "dataUsed": 1024 }-``` +``` |
v1.0 | Intune Devices Syncpayloadsactionresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-syncpayloadsactionresult.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Devices Systemmanagementmodelevel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-systemmanagementmodelevel.md | A list of possible System Management Mode levels for a device. System Management |level1|1|Indicates that deny System Management Mode (SMM) read/write access to OS and Virtualization-based security (VBS) memory. The benefit is that by design System Management Mode (SMM) cannot modify security of or exfiltrate secrets from the OS (including Virtualization-based security).| |level2|2|Indicates that in addition to the System Management Mode (SMM) Level 1 protections, this level prevents System Management Mode (SMM) from tampering with Input-Output Memory Management Unit (IOMMU) config. The benefit is that by design System Management Mode (SMM) cannot disable Virtualization-based security (VBS) and kernel Direct memory access (DMA) protections.| |level3|3|Indicates that in addition to the System Management Mode (SMM) Level 2 protections, this level reduces System Management Mode (SMM) save state capabilities. The benefit is that by design System Management Mode (SMM) cannot exploit save state to modify security of or exfiltrate secrets from the OS (including Virtualization-based security).|-|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Tenantattachrbac | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-tenantattachrbac.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.tenantAttachRBAC", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Devices Tenantattachrbacstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-tenantattachrbacstate.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.tenantAttachRBACState", "enabled": true }-``` +``` |
v1.0 | Intune Devices Updatewindowsdeviceaccountactionparameter | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-updatewindowsdeviceaccountactionparameter.md | Here is a JSON representation of the resource. "exchangeServer": "String", "sessionInitiationProtocalAddress": "String" }-``` +``` |
v1.0 | Intune Devices User | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-user.md | Namespace: microsoft.graph ## Methods |Method|Return Type|Description| |:|:|:|-|[List users](../api/intune-devices-user-list.md)|[user](../resources/intune-devices-user.md) collection|List properties and relationships of the [user](../resources/intune-devices-user.md) objects.| -|[Get user](../api/intune-devices-user-get.md)|[user](../resources/intune-devices-user.md)|Read properties and relationships of the [user](../resources/intune-devices-user.md) object.| -|[Create user](../api/intune-devices-user-create.md)|[user](../resources/intune-devices-user.md)|Create a new [user](../resources/intune-devices-user.md) object.| -|[Delete user](../api/intune-devices-user-delete.md)|None|Deletes a [user](../resources/intune-devices-user.md).| -|[Update user](../api/intune-devices-user-update.md)|[user](../resources/intune-devices-user.md)|Update the properties of a [user](../resources/intune-devices-user.md) object.| +|[List users](../api/intune-devices-user-list.md)|[user](../resources/intune-shared-user.md) collection|List properties and relationships of the [user](../resources/intune-shared-user.md) objects.| +|[Get user](../api/intune-devices-user-get.md)|[user](../resources/intune-shared-user.md)|Read properties and relationships of the [user](../resources/intune-shared-user.md) object.| +|[Create user](../api/intune-devices-user-create.md)|[user](../resources/intune-shared-user.md)|Create a new [user](../resources/intune-shared-user.md) object.| +|[Delete user](../api/intune-devices-user-delete.md)|None|Deletes a [user](../resources/intune-shared-user.md).| +|[Update user](../api/intune-devices-user-update.md)|[user](../resources/intune-shared-user.md)|Update the properties of a [user](../resources/intune-shared-user.md) object.| |[removeAllDevicesFromManagement action](../api/intune-devices-user-removealldevicesfrommanagement.md)|None|Retire all devices from management for this user| |[getLoggedOnManagedDevices function](../api/intune-devices-user-getloggedonmanageddevices.md)|[managedDevice](../resources/intune-devices-manageddevice.md) collection|| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.user", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsanomaly | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsanomaly.md | Here is a JSON representation of the resource. "assetVersion": "String", "assetPublisher": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsanomalycorrelationgroupfeature | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsanomalycorrelationgroupfeature.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsanomalycorrelationgroupoverview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsanomalycorrelationgroupoverview.md | Here is a JSON representation of the resource. "correlationGroupAnomalousDeviceCount": 1024, "correlationGroupAtRiskDeviceCount": 1024 }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsanomalycorrelationgroupprevalence | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsanomalycorrelationgroupprevalence.md | Indicates the level of prevalence of the correlation group features in the anoma |high|0|Indicates that we have a high prevalence in the correlation between the anomaly and correlation group.| |medium|1|Indicates that we have a medium prevalence in the correlation between the anomaly and correlation group.| |low|2|Indicates that we have a low prevalence in the correlation between the anomaly and correlation group.|-|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Userexperienceanalyticsanomalydevice | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsanomalydevice.md | Here is a JSON representation of the resource. "correlationGroupId": "String", "deviceStatus": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsanomalydevicefeaturetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsanomalydevicefeaturetype.md | Indicates the device's feature type. Possible values are: manufacturer, model, o |osVersion|2|Indicates the OS as a device feature type.| |application|3|Indicates the application as a device feature type.| |driver|4|Indicates the driver as a device feature type.|-|unknownFutureValue|5|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|5|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Userexperienceanalyticsanomalyseverity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsanomalyseverity.md | Indicates the severity of the anomaly. Eg: anomaly severity can be high, medium, |low|2|Indicates the anomaly is of low severity.| |informational|3|Indicates the anomaly is of informational severity.| |other|4|Indicates the severity of anomaly is undefined.|-|unknownFutureValue|5|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|5|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Userexperienceanalyticsanomalyseverityoverview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsanomalyseverityoverview.md | Here is a JSON representation of the resource. "highSeverityAnomalyCount": 1024, "informationalSeverityAnomalyCount": 1024 }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsanomalystate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsanomalystate.md | Indicates the state of the anomaly. Eg: anomaly severity can be new, active, dis |disabled|2|Indicates the state of anomaly is disabled.| |removed|3|Indicates the state of anomaly is removed.| |other|4|Indicates the state of anomaly is undefined.|-|unknownFutureValue|5|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|5|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Userexperienceanalyticsanomalytype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsanomalytype.md | Indicates the category of the anomaly. Eg: anomaly type can be device, applicati |stopError|2|Indicates the detected anomaly is due to a specific stop error.| |driver|3|Indicates the detected anomaly is due to a specific driver.| |other|4|Indicates the category of detected anomaly is undefined.|-|unknownFutureValue|5|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|5|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Userexperienceanalyticsapphealthapplicationperformance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsapphealthapplicationperformance.md | Here is a JSON representation of the resource. "appCrashCount": 1024, "meanTimeToFailureInMinutes": 1024 }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsapphealthappperformancebyappversion | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsapphealthappperformancebyappversion.md | Here is a JSON representation of the resource. "appCrashCount": 1024, "meanTimeToFailureInMinutes": 1024 }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsapphealthappperformancebyappversiondetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsapphealthappperformancebyappversiondetails.md | Here is a JSON representation of the resource. "appVersion": "String", "appCrashCount": 1024 }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsapphealthappperformancebyappversiondeviceid | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsapphealthappperformancebyappversiondeviceid.md | Here is a JSON representation of the resource. "appVersion": "String", "appCrashCount": 1024 }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsapphealthappperformancebyosversion | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsapphealthappperformancebyosversion.md | Here is a JSON representation of the resource. "appCrashCount": 1024, "meanTimeToFailureInMinutes": 1024 }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsapphealthdevicemodelperformance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsapphealthdevicemodelperformance.md | Here is a JSON representation of the resource. "modelAppHealthStatus": "String", "healthStatus": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsapphealthdeviceperformance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsapphealthdeviceperformance.md | Here is a JSON representation of the resource. "deviceId": "String", "deviceDisplayName": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsapphealthdeviceperformancedetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsapphealthdeviceperformancedetails.md | Here is a JSON representation of the resource. "deviceId": "String", "deviceDisplayName": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsapphealthosversionperformance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsapphealthosversionperformance.md | Here is a JSON representation of the resource. "osVersionAppHealthScore": "4.2", "osVersionAppHealthStatus": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsautopilotdevicessummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsautopilotdevicessummary.md | Here is a JSON representation of the resource. "devicesWithoutAutopilotProfileAssigned": 1024, "totalWindows10DevicesWithoutTenantAttached": 1024 }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsbaseline | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsbaseline.md | Here is a JSON representation of the resource. "isBuiltIn": true, "createdDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsbatteryhealthappimpact | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsbatteryhealthappimpact.md | Here is a JSON representation of the resource. "isForegroundApp": true, "batteryUsagePercentage": "4.2" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsbatteryhealthcapacitydetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsbatteryhealthcapacitydetails.md | Here is a JSON representation of the resource. "batteryCapacityPoor": 1024, "lastRefreshedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsbatteryhealthdeviceappimpact | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsbatteryhealthdeviceappimpact.md | Here is a JSON representation of the resource. "isForegroundApp": true, "batteryUsagePercentage": "4.2" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsbatteryhealthdeviceperformance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsbatteryhealthdeviceperformance.md | Here is a JSON representation of the resource. "deviceBatteryHealthScore": 1024, "healthStatus": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsbatteryhealthdeviceruntimehistory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsbatteryhealthdeviceruntimehistory.md | Here is a JSON representation of the resource. "runtimeDateTime": "String", "estimatedRuntimeInMinutes": 1024 }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsbatteryhealthmodelperformance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsbatteryhealthmodelperformance.md | Here is a JSON representation of the resource. "modelBatteryHealthScore": 1024, "modelHealthStatus": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsbatteryhealthosperformance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsbatteryhealthosperformance.md | Here is a JSON representation of the resource. "osBatteryHealthScore": 1024, "osHealthStatus": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsbatteryhealthruntimedetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsbatteryhealthruntimedetails.md | Here is a JSON representation of the resource. "batteryRuntimePoor": 1024, "lastRefreshedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticscategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticscategory.md | Here is a JSON representation of the resource. ], "state": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticscloudidentitydevicessummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticscloudidentitydevicessummary.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.userExperienceAnalyticsCloudIdentityDevicesSummary", "deviceWithoutCloudIdentityCount": 1024 }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticscloudmanagementdevicessummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticscloudmanagementdevicessummary.md | Here is a JSON representation of the resource. "intuneDeviceCount": 1024, "tenantAttachDeviceCount": 1024 }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsdevicebatterydetail | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsdevicebatterydetail.md | Here is a JSON representation of the resource. "maxCapacityPercentage": 1024, "fullBatteryDrainCount": 1024 }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsdeviceperformance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsdeviceperformance.md | Here is a JSON representation of the resource. "startupPerformanceScore": "4.2", "modelStartupPerformanceScore": "4.2" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsdevicescope | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsdevicescope.md | Here is a JSON representation of the resource. "createdDateTime": "String (timestamp)", "lastModifiedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsdevicescopesummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsdevicescopesummary.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsdevicescores | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsdevicescores.md | Here is a JSON representation of the resource. "batteryHealthScore": "4.2", "healthStatus": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsdevicestartuphistory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsdevicestartuphistory.md | Here is a JSON representation of the resource. "restartStopCode": "String", "restartFaultBucket": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsdevicestartupprocess | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsdevicestartupprocess.md | Here is a JSON representation of the resource. "publisher": "String", "startupImpactInMs": 1024 }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsdevicestartupprocessperformance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsdevicestartupprocessperformance.md | Here is a JSON representation of the resource. "medianImpactInMs": 1024, "totalImpactInMs": 1024 }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsdevicestatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsdevicestatus.md | Indicates the status of the device in the correlation group. Eg: Device status c |anomalous|0|Indicates the the device is part of the anomaly.| |affected|1|Indicates the device is affected by the anomaly and is part of the correlation group.| |atRisk|2|Indicates the device is not part of the anomaly but is part of the correlation group.|-|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Userexperienceanalyticsdevicetimelineevent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsdevicetimelineevent.md | Here is a JSON representation of the resource. "eventName": "String", "eventDetails": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsdevicetimelineevents | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsdevicetimelineevents.md | Here is a JSON representation of the resource. "eventDetails": "String", "eventAdditionalInformation": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsdevicewithoutcloudidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsdevicewithoutcloudidentity.md | Here is a JSON representation of the resource. "deviceName": "String", "azureAdDeviceId": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticshealthstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticshealthstate.md | Namespace: microsoft.graph |insufficientData|1|Indicates that the health state is insufficient data.| |needsAttention|2|Indicates that the health state needs attention.| |meetingGoals|3|Indicates that the health state is meeting goals.|-|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Userexperienceanalyticsimpactingprocess | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsimpactingprocess.md | Here is a JSON representation of the resource. "publisher": "String", "impactValue": "4.2" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsinsight | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsinsight.md | Here is a JSON representation of the resource. ], "severity": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsinsightseverity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsinsightseverity.md | Indicates severity of insights. Possible values are: None, Informational, Warnin |informational|1|Indicates that the insight severity is informational.| |warning|2|Indicates that the insight severity is warning.| |error|3|Indicates that the insight severity is error.|-|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Userexperienceanalyticsinsightvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsinsightvalue.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.userExperienceAnalyticsInsightValue" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsmachinetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsmachinetype.md | Indicates if machine is physical or virtual. Possible values are: physical or vi |unknown|0|Indicates that the type is unknown.| |physical|1|Indicates that the Machine is physical.| |virtual|2|Indicates that the machine is virtual.|-|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Userexperienceanalyticsmetric | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsmetric.md | Here is a JSON representation of the resource. "value": "4.2", "unit": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsmetrichistory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsmetrichistory.md | Here is a JSON representation of the resource. "metricDateTime": "String (timestamp)", "metricType": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsmodelscores | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsmodelscores.md | Here is a JSON representation of the resource. "meanResourceSpikeTimeScore": "4.2", "healthStatus": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsnotautopilotreadydevice | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsnotautopilotreadydevice.md | Here is a JSON representation of the resource. "azureAdRegistered": true, "azureAdJoinType": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsoperatingsystemrestartcategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsoperatingsystemrestartcategory.md | Operating System restart category. |longPowerButtonPress|6|Indicates that the device operating system restart is due to update long power-button press.| |bootError|7|Indicates that the device operating system restart is due to boot error.| |update|8|Indicates that the device operating system restarted after an update.|-|unknownFutureValue|9|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|9|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Userexperienceanalyticsoverview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsoverview.md | Here is a JSON representation of the resource. "resourcePerformanceHealthState": "String", "batteryHealthState": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsregressionsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsregressionsummary.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.userExperienceAnalyticsRegressionSummary", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsremoteconnection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsremoteconnection.md | Here is a JSON representation of the resource. "cloudPcFailurePercentage": "4.2", "userPrincipalName": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsresourceperformance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsresourceperformance.md | Here is a JSON representation of the resource. "diskType": "String", "healthStatus": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsscorehistory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsscorehistory.md | Here is a JSON representation of the resource. "batteryHealthTotalDevices": 1024, "restartScore": 1024 }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticssettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticssettings.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.userExperienceAnalyticsSettings", "configurationManagerDataConnectorConfigured": true }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticssummarizedby | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticssummarizedby.md | Indicates type of summarization. Possible values are: None, Model, AllRegression |modelRegression|4|Indicates that the summarization is by model regression.| |manufacturerRegression|5|Indicates that the summarization is by manufacturer regression.| |operatingSystemVersionRegression|6|Indicates that the summarization is by operating system version regression.|-|unknownFutureValue|7|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|7|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Devices Userexperienceanalyticswindows10devicessummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticswindows10devicessummary.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.userExperienceAnalyticsWindows10DevicesSummary", "unsupportedOSversionDeviceCount": 1024 }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsworkfromanywheredevice | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsworkfromanywheredevice.md | Here is a JSON representation of the resource. "cloudProvisioningScore": "4.2", "healthStatus": "String" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsworkfromanywheredevicessummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsworkfromanywheredevicessummary.md | Here is a JSON representation of the resource. "devicesNotAutopilotRegistered": 1024, "devicesWithoutAutopilotProfileAssigned": 1024 }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsworkfromanywherehardwarereadinessmetric | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsworkfromanywherehardwarereadinessmetric.md | Here is a JSON representation of the resource. "processor64BitCheckFailedPercentage": "4.2", "osCheckFailedPercentage": "4.2" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsworkfromanywheremetric | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsworkfromanywheremetric.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.userExperienceAnalyticsWorkFromAnywhereMetric", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Devices Userexperienceanalyticsworkfromanywheremodelperformance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsworkfromanywheremodelperformance.md | Here is a JSON representation of the resource. "cloudProvisioningScore": "4.2", "healthStatus": "String" }-``` +``` |
v1.0 | Intune Devices Windowsdefenderproductstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsdefenderproductstatus.md | Product Status of Windows Defender |platformUpdateInProgress|2097152|Platform update is in progress| |platformAboutToBeOutdated|4194304|Platform is about to be outdated| |signatureOrPlatformEndOfLifeIsPastOrIsImpending|8388608|Signature or platform end of life is past or is impending|-|windowsSModeSignaturesInUseOnNonWin10SInstall|16777216|Windows SMode signatures still in use on non-Win10S install| +|windowsSModeSignaturesInUseOnNonWin10SInstall|16777216|Windows SMode signatures still in use on non-Win10S install| |
v1.0 | Intune Devices Windowsdefenderscanactionresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsdefenderscanactionresult.md | Here is a JSON representation of the resource. "lastUpdatedDateTime": "String (timestamp)", "scanType": "String" }-``` +``` |
v1.0 | Intune Devices Windowsdeviceaccount | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsdeviceaccount.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.windowsDeviceAccount", "password": "String" }-``` +``` |
v1.0 | Intune Devices Windowsdeviceadaccount | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsdeviceadaccount.md | Here is a JSON representation of the resource. "domainName": "String", "userName": "String" }-``` +``` |
v1.0 | Intune Devices Windowsdeviceazureadaccount | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsdeviceazureadaccount.md | Here is a JSON representation of the resource. "password": "String", "userPrincipalName": "String" }-``` +``` |
v1.0 | Intune Devices Windowsdevicehealthstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsdevicehealthstate.md | Computer endpoint protection state |rebootPending|2|Computer is in pending reboot state| |manualStepsPending|4|Computer is in pending manual steps state| |offlineScanPending|8|Computer is in pending offline scan state|-|critical|16|Computer is in critical failure state| +|critical|16|Computer is in critical failure state| |
v1.0 | Intune Devices Windowsdevicemalwarestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsdevicemalwarestate.md | Here is a JSON representation of the resource. "detectionCount": 1024, "category": "String" }-``` +``` |
v1.0 | Intune Devices Windowsmalwarecategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsmalwarecategory.md | Malware category id |policy|48|Policy| |enterpriseUnwantedSoftware|49|Enterprise Unwanted Software| |ransom|50|Ransom|-|hipsRule|51|HIPS Rule| +|hipsRule|51|HIPS Rule| |
v1.0 | Intune Devices Windowsmalwarecategorycount | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsmalwarecategorycount.md | Here is a JSON representation of the resource. "distinctActiveMalwareCount": 1024, "lastUpdateDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Devices Windowsmalwareexecutionstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsmalwareexecutionstate.md | Malware execution status |blocked|1|Blocked| |allowed|2|Allowed| |running|3|Running|-|notRunning|4|Not running| +|notRunning|4|Not running| |
v1.0 | Intune Devices Windowsmalwareexecutionstatecount | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsmalwareexecutionstatecount.md | Here is a JSON representation of the resource. "deviceCount": 1024, "lastUpdateDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Devices Windowsmalwareinformation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsmalwareinformation.md | Here is a JSON representation of the resource. "category": "String", "lastDetectionDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Devices Windowsmalwarenamecount | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsmalwarenamecount.md | Here is a JSON representation of the resource. "deviceCount": 1024, "lastUpdateDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Devices Windowsmalwareoverview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsmalwareoverview.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Devices Windowsmalwareseverity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsmalwareseverity.md | Malware severity |low|1|Low| |moderate|2|Moderate| |high|4|High|-|severe|5|Severe| +|severe|5|Severe| |
v1.0 | Intune Devices Windowsmalwareseveritycount | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsmalwareseveritycount.md | Here is a JSON representation of the resource. "distinctMalwareCount": 1024, "lastUpdateDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Devices Windowsmalwarestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsmalwarestate.md | Malware current status |removeFailed|104|Remove failed| |allowFailed|105|Allow failed| |abandoned|106|Abandoned|-|blockFailed|107|Block failed| +|blockFailed|107|Block failed| |
v1.0 | Intune Devices Windowsmalwarestatecount | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsmalwarestatecount.md | Here is a JSON representation of the resource. "distinctMalwareCount": 1024, "lastUpdateDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Devices Windowsmalwarethreatstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsmalwarethreatstate.md | Malware threat status |removed|7|Removed| |cleaned|8|Cleaned| |allowed|9|Allowed|-|noStatusCleared|10|No status cleared| +|noStatusCleared|10|No status cleared| |
v1.0 | Intune Devices Windowsmanageddevice | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsmanageddevice.md | Inherits from [managedDevice](../resources/intune-devices-manageddevice.md) |deviceType|[deviceType](../resources/intune-shared-devicetype.md)|Platform of the device. Examples: Desktop, WindowsRT, etc. Default is unknown. Supports $filter operator 'eq' and 'or'. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `desktop`, `windowsRT`, `winMO6`, `nokia`, `windowsPhone`, `mac`, `winCE`, `winEmbedded`, `iPhone`, `iPad`, `iPod`, `android`, `iSocConsumer`, `unix`, `macMDM`, `holoLens`, `surfaceHub`, `androidForWork`, `androidEnterprise`, `windows10x`, `androidnGMS`, `chromeOS`, `linux`, `blackberry`, `palm`, `unknown`, `cloudPC`.| |complianceState|[complianceState](../resources/intune-devices-compliancestate.md)|Compliance state of the device. Examples: Compliant, Conflict, Error, etc. Default is unknown. Supports $filter operator 'eq' and 'or'. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `compliant`, `noncompliant`, `conflict`, `error`, `inGracePeriod`, `configManager`.| |jailBroken|String|Whether the device is jail broken or rooted. Default is an empty string. Supports $filter operator 'eq' and 'or'. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|-|managementAgent|[managementAgentType](../resources/intune-devices-managementagenttype.md)|Management channel of the device. Examples: Intune, EAS, etc. Default is unknown. Supports $filter operator 'eq' and 'or'. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `eas`, `mdm`, `easMdm`, `intuneClient`, `easIntuneClient`, `configurationManagerClient`, `configurationManagerClientMdm`, `configurationManagerClientMdmEas`, `unknown`, `jamf`, `googleCloudDevicePolicyController`, `microsoft365ManagedMdm`, `msSense`, `intuneAosp`, `google`, `unknownFutureValue`.| +|managementAgent|[managementAgentType](../resources/intune-shared-managementagenttype.md)|Management channel of the device. Examples: Intune, EAS, etc. Default is unknown. Supports $filter operator 'eq' and 'or'. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `eas`, `mdm`, `easMdm`, `intuneClient`, `easIntuneClient`, `configurationManagerClient`, `configurationManagerClientMdm`, `configurationManagerClientMdmEas`, `unknown`, `jamf`, `googleCloudDevicePolicyController`, `microsoft365ManagedMdm`, `msSense`, `intuneAosp`, `google`, `unknownFutureValue`.| |osVersion|String|Operating system version of the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |easActivated|Boolean|Whether the device is Exchange ActiveSync activated. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |easDeviceId|String|Exchange ActiveSync Id of the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| Inherits from [managedDevice](../resources/intune-devices-manageddevice.md) |configurationManagerClientInformation|[configurationManagerClientInformation](../resources/intune-devices-configurationmanagerclientinformation.md)|Configuration manager client information, valid only for devices managed, duel-managed or tri-managed by ConfigMgr Agent Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |ethernetMacAddress|String|Indicates Ethernet MAC Address of the device. Default, is Null (Non-Default property) for this property when returned as part of managedDevice entity. Individual get call with select query options is needed to retrieve actual values. Example: deviceManagement/managedDevices({managedDeviceId})?$select=ethernetMacAddress Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |physicalMemoryInBytes|Int64|Total Memory in Bytes. Default is 0. To retrieve actual values GET call needs to be made, with device id and included in select parameter. Supports: $select. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|-|processorArchitecture|[managedDeviceArchitecture](../resources/intune-devices-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| +|processorArchitecture|[managedDeviceArchitecture](../resources/intune-shared-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| |specificationVersion|String|Specification version. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |joinType|[joinType](../resources/intune-devices-jointype.md)|Device join type Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `azureADJoined`, `azureADRegistered`, `hybridAzureADJoined`.| |skuFamily|String|Device sku family Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| Inherits from [managedDevice](../resources/intune-devices-manageddevice.md) |users|[user](../resources/intune-shared-user.md) collection|The primary users associated with the managed device. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |logCollectionRequests|[deviceLogCollectionResponse](../resources/intune-devices-devicelogcollectionresponse.md) collection|List of log collection requests Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |deviceHealthScriptStates|[deviceHealthScriptPolicyState](../resources/intune-devices-devicehealthscriptpolicystate.md) collection|Results of device health scripts that ran for this device. Default is empty list. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|-|queryResults|[deviceQueryResult](../resources/intune-devices-devicequeryresult.md) collection|Results of device query that ran for this device. Default is empty list. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| ## JSON Representation Here is a JSON representation of the resource. Here is a JSON representation of the resource. "deviceIdentityAttestationStatus": "String" } }-``` +``` |
v1.0 | Intune Devices Windowsmanagementapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsmanagementapp.md | Here is a JSON representation of the resource. "managedInstaller": "String", "managedInstallerConfiguredDateTime": "String" }-``` +``` |
v1.0 | Intune Devices Windowsmanagementapphealthstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsmanagementapphealthstate.md | Here is a JSON representation of the resource. "deviceName": "String", "deviceOSVersion": "String" }-``` +``` |
v1.0 | Intune Devices Windowsprotectionstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-windowsprotectionstate.md | Here is a JSON representation of the resource. "isVirtualMachine": true, "tamperProtectionEnabled": true }-``` +``` |
v1.0 | Intune Enrollment Activedirectorywindowsautopilotdeploymentprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-activedirectorywindowsautopilotdeploymentprofile.md | Inherits from [windowsAutopilotDeploymentProfile](../resources/intune-shared-win |Property|Type|Description| |:|:|:| |id|String|Profile Key Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)|-|displayName|String|Name of the profile Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|description|String|Description of the profile Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|language|String|Language configured on the device Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|createdDateTime|DateTimeOffset|Profile creation time Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|lastModifiedDateTime|DateTimeOffset|Profile last modified time Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|outOfBoxExperienceSettings|[outOfBoxExperienceSettings](../resources/intune-enrollment-outofboxexperiencesettings.md)|Out of box experience setting Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|displayName|String|The display name of the deployment profile. Max allowed length is 200 chars. Returned by default. Supports: $select, $top, $skip, $orderby. $Search and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|description|String|A description of the deployment profile. Max allowed length is 1500 chars. Supports: $select, $top, $skip, $orderBy. $Search and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|language|String|The language code to be used when configuring the device. E.g. en-US. The default value is os-default. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use locale instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|locale|String|The locale (language) to be used when configuring the device. E.g. en-US. The default value is os-default. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|createdDateTime|DateTimeOffset|The date and time of when the deployment profile was created. The value cannot be modified and is automatically populated when the profile was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|lastModifiedDateTime|DateTimeOffset|The date and time of when the deployment profile was last modified. The value cannot be updated manually and is automatically populated when any changes are made to the profile. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported Read-Only. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|outOfBoxExperienceSettings|[outOfBoxExperienceSettings](../resources/intune-enrollment-outofboxexperiencesettings.md)|The Windows Autopilot Deployment Profile settings used by the Autopilot device for out-of-box experience. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use outOfBoxExperienceSetting instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|outOfBoxExperienceSetting|[outOfBoxExperienceSetting](../resources/intune-enrollment-outofboxexperiencesetting.md)|The Windows Autopilot Deployment Profile settings used by the device for the out-of-box experience. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| |enrollmentStatusScreenSettings|[windowsEnrollmentStatusScreenSettings](../resources/intune-enrollment-windowsenrollmentstatusscreensettings.md)|Enrollment status screen setting Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)|-|extractHardwareHash|Boolean|HardwareHash Extraction for the profile Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|deviceNameTemplate|String|The template used to name the AutoPilot Device. This can be a custom text and can also contain either the serial number of the device, or a randomly generated number. The total length of the text generated by the template can be no more than 15 characters. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|deviceType|[windowsAutopilotDeviceType](../resources/intune-enrollment-windowsautopilotdevicetype.md)|The AutoPilot device type that this profile is applicable to. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md). Possible values are: `windowsPc`, `surfaceHub2`, `holoLens`, `surfaceHub2S`, `virtualMachine`, `unknownFutureValue`.| -|enableWhiteGlove|Boolean|Enable Autopilot White Glove for the profile. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|roleScopeTagIds|String collection|Scope tags for the profile. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|managementServiceAppId|String|AzureAD management app ID used during client device-based enrollment discovery Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|extractHardwareHash|Boolean|Indicates whether the profile supports the extraction of hardware hash values and registration of the device into Windows Autopilot. When TRUE, indicates if hardware extraction and Windows Autopilot registration will happen on the next successful check-in. When FALSE, hardware hash extraction and Windows Autopilot registration will not happen. Default value is FALSE. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use hardwareHashExtractionEnabled instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|hardwareHashExtractionEnabled|Boolean|Indicates whether the profile supports the extraction of hardware hash values and registration of the device into Windows Autopilot. When TRUE, indicates if hardware extraction and Windows Autopilot registration will happen on the next successful check-in. When FALSE, hardware hash extraction and Windows Autopilot registration will not happen. Default value is FALSE. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|deviceNameTemplate|String|The template used to name the Autopilot device. This can be a custom text and can also contain either the serial number of the device, or a randomly generated number. The total length of the text generated by the template can be no more than 15 characters. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|deviceType|[windowsAutopilotDeviceType](../resources/intune-enrollment-windowsautopilotdevicetype.md)|The Windows device type that this profile is applicable to. Possible values include windowsPc, holoLens, and virtualMachine. The default is windowsPc. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md). Possible values are: `windowsPc`, `surfaceHub2`, `holoLens`, `surfaceHub2S`, `virtualMachine`, `unknownFutureValue`.| +|enableWhiteGlove|Boolean|Indicates whether the user is allowed to use Windows Autopilot for pre-provisioned deployment mode during Out of Box experience (OOBE). When TRUE, indicates that Windows Autopilot for pre-provisioned deployment mode is allowed. When false, Windows Autopilot for pre-provisioned deployment mode is not allowed. The default is FALSE. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use preprovisioningAllowed instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|preprovisioningAllowed|Boolean|Indicates whether the user is allowed to use Windows Autopilot for pre-provisioned deployment mode during Out of Box experience (OOBE). When TRUE, indicates that Windows Autopilot for pre-provisioned deployment mode for OOBE is allowed to be used. When false, Windows Autopilot for pre-provisioned deployment mode for OOBE is not allowed. The default is FALSE. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|roleScopeTagIds|String collection|List of role scope tags for the deployment profile. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|managementServiceAppId|String|The Entra management service App ID which gets used during client device-based enrollment discovery. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| |hybridAzureADJoinSkipConnectivityCheck|Boolean|The Autopilot Hybrid Azure AD join flow will continue even if it does not establish domain controller connectivity during OOBE.| ## Relationships Here is a JSON representation of the resource. "displayName": "String", "description": "String", "language": "String",+ "locale": "String", "createdDateTime": "String (timestamp)", "lastModifiedDateTime": "String (timestamp)", "outOfBoxExperienceSettings": { Here is a JSON representation of the resource. "skipKeyboardSelectionPage": true, "hideEscapeLink": true },+ "outOfBoxExperienceSetting": { + "@odata.type": "microsoft.graph.outOfBoxExperienceSetting", + "privacySettingsHidden": true, + "eulaHidden": true, + "userType": "String", + "deviceUsageType": "String", + "keyboardSelectionPageSkipped": true, + "escapeLinkHidden": true + }, "enrollmentStatusScreenSettings": { "@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings", "hideInstallationProgress": true, Here is a JSON representation of the resource. "allowDeviceUseOnInstallFailure": true }, "extractHardwareHash": true,+ "hardwareHashExtractionEnabled": true, "deviceNameTemplate": "String", "deviceType": "String", "enableWhiteGlove": true,+ "preprovisioningAllowed": true, "roleScopeTagIds": [ "String" ], "managementServiceAppId": "String", "hybridAzureADJoinSkipConnectivityCheck": true }-``` +``` |
v1.0 | Intune Enrollment Appleenrollmentprofileassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-appleenrollmentprofileassignment.md | Here is a JSON representation of the resource. "entraObjectId": "String" } }-``` +``` |
v1.0 | Intune Enrollment Appleownertypeenrollmenttype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-appleownertypeenrollmenttype.md | Here is a JSON representation of the resource. "ownerType": "String", "enrollmentType": "String" }-``` +``` |
v1.0 | Intune Enrollment Appleuserinitiatedenrollmentprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-appleuserinitiatedenrollmentprofile.md | Here is a JSON representation of the resource. "createdDateTime": "String (timestamp)", "lastModifiedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Enrollment Appleuserinitiatedenrollmenttype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-appleuserinitiatedenrollmenttype.md | Namespace: microsoft.graph |user|2|Profile-driven user enrollment via the iOS Company Portal. An enrollment type that segregates corportate and personal data. Supported on devices running iOS/iPadOS 13 and higher.| |accountDrivenUserEnrollment|3|Account-driven user enrollment. Users will enroll from the iOS Settings app without using the iOS Company Portal. This enrollment type segregates corporate and personal data. Supported on devices running iOS/iPadOS 15 and higher.| |webDeviceEnrollment|4|Device enrollment via the web. Users will enroll without using the iOS Company Portal. This enrollment type does not segregate corporate and personal data. Supported on all Intune-supported iOS/iPadOS versions.|-|unknownFutureValue|5|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|5|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Enrollment Azureadwindowsautopilotdeploymentprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-azureadwindowsautopilotdeploymentprofile.md | Inherits from [windowsAutopilotDeploymentProfile](../resources/intune-shared-win |Property|Type|Description| |:|:|:| |id|String|Profile Key Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)|-|displayName|String|Name of the profile Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|description|String|Description of the profile Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|language|String|Language configured on the device Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|createdDateTime|DateTimeOffset|Profile creation time Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|lastModifiedDateTime|DateTimeOffset|Profile last modified time Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|outOfBoxExperienceSettings|[outOfBoxExperienceSettings](../resources/intune-enrollment-outofboxexperiencesettings.md)|Out of box experience setting Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|displayName|String|The display name of the deployment profile. Max allowed length is 200 chars. Returned by default. Supports: $select, $top, $skip, $orderby. $Search and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|description|String|A description of the deployment profile. Max allowed length is 1500 chars. Supports: $select, $top, $skip, $orderBy. $Search and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|language|String|The language code to be used when configuring the device. E.g. en-US. The default value is os-default. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use locale instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|locale|String|The locale (language) to be used when configuring the device. E.g. en-US. The default value is os-default. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|createdDateTime|DateTimeOffset|The date and time of when the deployment profile was created. The value cannot be modified and is automatically populated when the profile was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|lastModifiedDateTime|DateTimeOffset|The date and time of when the deployment profile was last modified. The value cannot be updated manually and is automatically populated when any changes are made to the profile. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported Read-Only. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|outOfBoxExperienceSettings|[outOfBoxExperienceSettings](../resources/intune-enrollment-outofboxexperiencesettings.md)|The Windows Autopilot Deployment Profile settings used by the Autopilot device for out-of-box experience. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use outOfBoxExperienceSetting instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|outOfBoxExperienceSetting|[outOfBoxExperienceSetting](../resources/intune-enrollment-outofboxexperiencesetting.md)|The Windows Autopilot Deployment Profile settings used by the device for the out-of-box experience. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| |enrollmentStatusScreenSettings|[windowsEnrollmentStatusScreenSettings](../resources/intune-enrollment-windowsenrollmentstatusscreensettings.md)|Enrollment status screen setting Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)|-|extractHardwareHash|Boolean|HardwareHash Extraction for the profile Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|deviceNameTemplate|String|The template used to name the AutoPilot Device. This can be a custom text and can also contain either the serial number of the device, or a randomly generated number. The total length of the text generated by the template can be no more than 15 characters. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|deviceType|[windowsAutopilotDeviceType](../resources/intune-enrollment-windowsautopilotdevicetype.md)|The AutoPilot device type that this profile is applicable to. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md). Possible values are: `windowsPc`, `surfaceHub2`, `holoLens`, `surfaceHub2S`, `virtualMachine`, `unknownFutureValue`.| -|enableWhiteGlove|Boolean|Enable Autopilot White Glove for the profile. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|roleScopeTagIds|String collection|Scope tags for the profile. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| -|managementServiceAppId|String|AzureAD management app ID used during client device-based enrollment discovery Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|extractHardwareHash|Boolean|Indicates whether the profile supports the extraction of hardware hash values and registration of the device into Windows Autopilot. When TRUE, indicates if hardware extraction and Windows Autopilot registration will happen on the next successful check-in. When FALSE, hardware hash extraction and Windows Autopilot registration will not happen. Default value is FALSE. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use hardwareHashExtractionEnabled instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|hardwareHashExtractionEnabled|Boolean|Indicates whether the profile supports the extraction of hardware hash values and registration of the device into Windows Autopilot. When TRUE, indicates if hardware extraction and Windows Autopilot registration will happen on the next successful check-in. When FALSE, hardware hash extraction and Windows Autopilot registration will not happen. Default value is FALSE. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|deviceNameTemplate|String|The template used to name the Autopilot device. This can be a custom text and can also contain either the serial number of the device, or a randomly generated number. The total length of the text generated by the template can be no more than 15 characters. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|deviceType|[windowsAutopilotDeviceType](../resources/intune-enrollment-windowsautopilotdevicetype.md)|The Windows device type that this profile is applicable to. Possible values include windowsPc, holoLens, and virtualMachine. The default is windowsPc. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md). Possible values are: `windowsPc`, `surfaceHub2`, `holoLens`, `surfaceHub2S`, `virtualMachine`, `unknownFutureValue`.| +|enableWhiteGlove|Boolean|Indicates whether the user is allowed to use Windows Autopilot for pre-provisioned deployment mode during Out of Box experience (OOBE). When TRUE, indicates that Windows Autopilot for pre-provisioned deployment mode is allowed. When false, Windows Autopilot for pre-provisioned deployment mode is not allowed. The default is FALSE. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use preprovisioningAllowed instead. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|preprovisioningAllowed|Boolean|Indicates whether the user is allowed to use Windows Autopilot for pre-provisioned deployment mode during Out of Box experience (OOBE). When TRUE, indicates that Windows Autopilot for pre-provisioned deployment mode for OOBE is allowed to be used. When false, Windows Autopilot for pre-provisioned deployment mode for OOBE is not allowed. The default is FALSE. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|roleScopeTagIds|String collection|List of role scope tags for the deployment profile. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| +|managementServiceAppId|String|The Entra management service App ID which gets used during client device-based enrollment discovery. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Inherited from [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)| ## Relationships |Relationship|Type|Description| Here is a JSON representation of the resource. "displayName": "String", "description": "String", "language": "String",+ "locale": "String", "createdDateTime": "String (timestamp)", "lastModifiedDateTime": "String (timestamp)", "outOfBoxExperienceSettings": { Here is a JSON representation of the resource. "skipKeyboardSelectionPage": true, "hideEscapeLink": true },+ "outOfBoxExperienceSetting": { + "@odata.type": "microsoft.graph.outOfBoxExperienceSetting", + "privacySettingsHidden": true, + "eulaHidden": true, + "userType": "String", + "deviceUsageType": "String", + "keyboardSelectionPageSkipped": true, + "escapeLinkHidden": true + }, "enrollmentStatusScreenSettings": { "@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings", "hideInstallationProgress": true, Here is a JSON representation of the resource. "allowDeviceUseOnInstallFailure": true }, "extractHardwareHash": true,+ "hardwareHashExtractionEnabled": true, "deviceNameTemplate": "String", "deviceType": "String", "enableWhiteGlove": true,+ "preprovisioningAllowed": true, "roleScopeTagIds": [ "String" ], "managementServiceAppId": "String" }-``` +``` |
v1.0 | Intune Enrollment Conceptual | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-conceptual.md | Namespace: microsoft.graph You can enroll organization-owned or corporate-owned devices to manage with Intune in a variety of ways, depending on the type of device, how the device was purchased, and the needs of the organization. You also can install the Company Portal app to enroll and manage corporate-owned devices, like in a "bring your own device" (BYOD) scenario. -Use Graph resources to enroll corporate-owned devices in Intune. See the table of content for a list of resources. +Use Graph resources to enroll corporate-owned devices in Intune. See the table of content for a list of resources. |
v1.0 | Intune Enrollment Deletedwindowsautopilotdevicestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-deletedwindowsautopilotdevicestate.md | Here is a JSON representation of the resource. "deletionState": "String", "errorMessage": "String" }-``` +``` |
v1.0 | Intune Enrollment Depenrollmentbaseprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-depenrollmentbaseprofile.md | Here is a JSON representation of the resource. ], "waitForDeviceConfiguredConfirmation": true }-``` +``` |
v1.0 | Intune Enrollment Depenrollmentprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-depenrollmentprofile.md | Here is a JSON representation of the resource. "sharedIPadMaximumUserCount": 1024, "enableSharedIPad": true }-``` +``` |
v1.0 | Intune Enrollment Depiosenrollmentprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-depiosenrollmentprofile.md | Here is a JSON representation of the resource. "carrierActivationUrl": "String", "userlessSharedAadModeEnabled": true }-``` +``` |
v1.0 | Intune Enrollment Depmacosenrollmentprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-depmacosenrollmentprofile.md | Here is a JSON representation of the resource. "requestRequiresNetworkTether": true, "autoAdvanceSetupEnabled": true }-``` +``` |
v1.0 | Intune Enrollment Deponboardingsetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-deponboardingsetting.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Enrollment Deptokentype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-deptokentype.md | Namespace: microsoft.graph |:|:|:| |none|0|Token Type is None| |dep|1|Token Type is Dep.|-|appleSchoolManager|2|Token Type is Apple School Manager| +|appleSchoolManager|2|Token Type is Apple School Manager| |
v1.0 | Intune Enrollment Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-devicemanagement.md | The deviceManagement resource represents a tenant's collection device identities ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-enrollment-devicemanagement-get.md)|[deviceManagement](../resources/intune-enrollment-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-enrollment-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-enrollment-devicemanagement-update.md)|[deviceManagement](../resources/intune-enrollment-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-enrollment-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-enrollment-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-enrollment-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| |[getSuggestedEnrollmentLimit function](../api/intune-enrollment-devicemanagement-getsuggestedenrollmentlimit.md)|[suggestedEnrollmentLimit](../resources/intune-enrollment-suggestedenrollmentlimit.md)|| ## Properties The deviceManagement resource represents a tenant's collection device identities |:|:|:| |windowsAutopilotSettings|[windowsAutopilotSettings](../resources/intune-enrollment-windowsautopilotsettings.md)|The Windows autopilot account settings.| |windowsAutopilotDeviceIdentities|[windowsAutopilotDeviceIdentity](../resources/intune-enrollment-windowsautopilotdeviceidentity.md) collection|The Windows autopilot device identities contained collection.|-|windowsAutopilotDeploymentProfiles|[windowsAutopilotDeploymentProfile](../resources/intune-enrollment-windowsautopilotdeploymentprofile.md) collection|Windows auto pilot deployment profiles| +|windowsAutopilotDeploymentProfiles|[windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md) collection|Windows auto pilot deployment profiles| |importedDeviceIdentities|[importedDeviceIdentity](../resources/intune-enrollment-importeddeviceidentity.md) collection|The imported device identities.| |depOnboardingSettings|[depOnboardingSetting](../resources/intune-enrollment-deponboardingsetting.md) collection|This collections of multiple DEP tokens per-tenant.| |importedWindowsAutopilotDeviceIdentities|[importedWindowsAutopilotDeviceIdentity](../resources/intune-enrollment-importedwindowsautopilotdeviceidentity.md) collection|Collection of imported Windows autopilot devices.| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Enrollment Deviceplatformtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-deviceplatformtype.md | Supported platform types. |androidAOSP|9|Indicates device platform type is Android AOSP.| |androidMobileApplicationManagement|10|Indicates Mobile Application Management (MAM) for android devices.| |iOSMobileApplicationManagement|11|Indicates Mobile Application Management (MAM) for iOS devices.|-|unknownFutureValue|12|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|12|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Enrollment Discoverysource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-discoverysource.md | Namespace: microsoft.graph |:|:|:| |unknown|0|DiscoverySource is Unknown.| |adminImport|2|Device is imported by admin.|-|deviceEnrollmentProgram|4|Device is added by Apple device enrollment program (Dep).| +|deviceEnrollmentProgram|4|Device is added by Apple device enrollment program (Dep).| |
v1.0 | Intune Enrollment Enrollmentprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-enrollmentprofile.md | Here is a JSON representation of the resource. "enableAuthenticationViaCompanyPortal": true, "requireCompanyPortalOnSetupAssistantEnrolledDevices": true }-``` +``` |
v1.0 | Intune Enrollment Enrollmentstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-enrollmentstate.md | Namespace: microsoft.graph |pendingReset|2|Enrolled but it's enrolled via enrollment profile and the enrolled profile is different from the assigned profile.| |failed|3|Not enrolled and there is enrollment failure record.| |notContacted|4|Device is imported but not enrolled.|-|blocked|5|Device is enrolled as userless, but is blocked from moving to user enrollment because the app failed to install.| +|blocked|5|Device is enrolled as userless, but is blocked from moving to user enrollment because the app failed to install.| |
v1.0 | Intune Enrollment Importedappledeviceidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-importedappledeviceidentity.md | Here is a JSON representation of the resource. "enrollmentState": "String", "platform": "String" }-``` +``` |
v1.0 | Intune Enrollment Importedappledeviceidentityresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-importedappledeviceidentityresult.md | Here is a JSON representation of the resource. "platform": "String", "status": true }-``` +``` |
v1.0 | Intune Enrollment Importeddeviceidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-importeddeviceidentity.md | Here is a JSON representation of the resource. "enrollmentState": "String", "platform": "String" }-``` +``` |
v1.0 | Intune Enrollment Importeddeviceidentityresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-importeddeviceidentityresult.md | Here is a JSON representation of the resource. "platform": "String", "status": true }-``` +``` |
v1.0 | Intune Enrollment Importeddeviceidentitytype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-importeddeviceidentitytype.md | Namespace: microsoft.graph |unknown|0|Unknown value of importedDeviceIdentityType.| |imei|1|Device Identity is of type imei.| |serialNumber|2|Device Identity is of type serial number.|-|manufacturerModelSerial|3|Device Identity is of type manufacturer + model + serial number semi-colon delimited tuple with enforced order.| +|manufacturerModelSerial|3|Device Identity is of type manufacturer + model + serial number semi-colon delimited tuple with enforced order.| |
v1.0 | Intune Enrollment Importedwindowsautopilotdeviceidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-importedwindowsautopilotdeviceidentity.md | Here is a JSON representation of the resource. }, "assignedUserPrincipalName": "String" }-``` +``` |
v1.0 | Intune Enrollment Importedwindowsautopilotdeviceidentityimportstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-importedwindowsautopilotdeviceidentityimportstatus.md | Namespace: microsoft.graph |pending|1|Pending status.| |partial|2|Partial status.| |complete|3|Complete status.|-|error|4|Error status.| +|error|4|Error status.| |
v1.0 | Intune Enrollment Importedwindowsautopilotdeviceidentitystate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-importedwindowsautopilotdeviceidentitystate.md | Here is a JSON representation of the resource. "deviceErrorCode": 1024, "deviceErrorName": "String" }-``` +``` |
v1.0 | Intune Enrollment Importedwindowsautopilotdeviceidentityuploadstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-importedwindowsautopilotdeviceidentityuploadstatus.md | Namespace: microsoft.graph |noUpload|0|No upload status.| |pending|1|Pending status.| |complete|2|Complete status.|-|error|3|Error status.| +|error|3|Error status.| |
v1.0 | Intune Enrollment Itunespairingmode | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-itunespairingmode.md | Namespace: microsoft.graph |:|:|:| |disallow|0|Pairing is not allowed| |allow|1|Pairing allowed|-|requiresCertificate|2|Certificate required to pair with iTunes| +|requiresCertificate|2|Certificate required to pair with iTunes| |
v1.0 | Intune Enrollment Managementcertificatewiththumbprint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-managementcertificatewiththumbprint.md | Here is a JSON representation of the resource. "thumbprint": "String", "certificate": "String" }-``` +``` |
v1.0 | Intune Enrollment Outofboxexperiencesetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-outofboxexperiencesetting.md | + + Title: "outOfBoxExperienceSetting resource type" +description: "The Windows Autopilot Deployment Profile settings used by the device for the out-of-box experience. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported." ++localization_priority: Normal ++++# outOfBoxExperienceSetting resource type ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. ++The Windows Autopilot Deployment Profile settings used by the device for the out-of-box experience. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. ++## Properties +|Property|Type|Description| +|:|:|:| +|privacySettingsHidden|Boolean|When TRUE, privacy settings is hidden to the end user during OOBE. When FALSE, privacy settings is shown to the end user during OOBE. Default value is FALSE.| +|eulaHidden|Boolean|When TRUE, EULA is hidden to the end user during OOBE. When FALSE, EULA is shown to the end user during OOBE. Default value is FALSE.| +|userType|[windowsUserType](../resources/intune-enrollment-windowsusertype.md)|The type of user. Possible values are administrator and standard. Default value is administrator. Yes No +. Possible values are: `administrator`, `standard`.| +|deviceUsageType|[windowsDeviceUsageType](../resources/intune-enrollment-windowsdeviceusagetype.md)|The Entra join authentication type. Possible values are singleUser and shared. The default is singleUser. Possible values are: `singleUser`, `shared`.| +|keyboardSelectionPageSkipped|Boolean|When TRUE, the keyboard selection page is hidden to the end user during OOBE if Language and Region are set. When FALSE, the keyboard selection page is skipped during OOBE.| +|escapeLinkHidden|Boolean|When TRUE, the link that allows user to start over with a different account on company sign-in is hidden. When false, the link that allows user to start over with a different account on company sign-in is available. Default value is FALSE.| ++## Relationships +None ++## JSON Representation +Here is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.outOfBoxExperienceSetting" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.outOfBoxExperienceSetting", + "privacySettingsHidden": true, + "eulaHidden": true, + "userType": "String", + "deviceUsageType": "String", + "keyboardSelectionPageSkipped": true, + "escapeLinkHidden": true +} +``` |
v1.0 | Intune Enrollment Outofboxexperiencesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-outofboxexperiencesettings.md | Title: "outOfBoxExperienceSettings resource type" -description: "Out of box experience setting" +description: "The Windows Autopilot Deployment Profile settings used by the Autopilot device for out-of-box experience. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use outOfBoxExperienceSetting instead." localization_priority: Normal Namespace: microsoft.graph > **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -Out of box experience setting +The Windows Autopilot Deployment Profile settings used by the Autopilot device for out-of-box experience. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use outOfBoxExperienceSetting instead. ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "skipKeyboardSelectionPage": true, "hideEscapeLink": true }-``` +``` |
v1.0 | Intune Enrollment Platform | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-platform.md | Namespace: microsoft.graph |android|2|Android device platform| |windows|3|Windows device platform| |windowsMobile|4|WindowsMobile device platform|-|macOS|5|Mac device platform| +|macOS|5|Mac device platform| |
v1.0 | Intune Enrollment Suggestedenrollmentlimit | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-suggestedenrollmentlimit.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.suggestedEnrollmentLimit", "suggestedDailyLimit": 1024 }-``` +``` |
v1.0 | Intune Enrollment Windowsautopilotdeploymentprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-windowsautopilotdeploymentprofile.md | Windows Autopilot Deployment Profile ## Methods |Method|Return Type|Description| |:|:|:|-|[Get windowsAutopilotDeploymentProfile](../api/intune-enrollment-windowsautopilotdeploymentprofile-get.md)|[windowsAutopilotDeploymentProfile](../resources/intune-enrollment-windowsautopilotdeploymentprofile.md)|Read properties and relationships of the [windowsAutopilotDeploymentProfile](../resources/intune-enrollment-windowsautopilotdeploymentprofile.md) object.| +|[Get windowsAutopilotDeploymentProfile](../api/intune-enrollment-windowsautopilotdeploymentprofile-get.md)|[windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md)|Read properties and relationships of the [windowsAutopilotDeploymentProfile](../resources/intune-shared-windowsautopilotdeploymentprofile.md) object.| |[assign action](../api/intune-enrollment-windowsautopilotdeploymentprofile-assign.md)|None|| ## Properties |Property|Type|Description| |:|:|:| |id|String|Profile Key|-|displayName|String|Name of the profile| -|description|String|Description of the profile| -|language|String|Language configured on the device| -|createdDateTime|DateTimeOffset|Profile creation time| -|lastModifiedDateTime|DateTimeOffset|Profile last modified time| -|outOfBoxExperienceSettings|[outOfBoxExperienceSettings](../resources/intune-enrollment-outofboxexperiencesettings.md)|Out of box experience setting| +|displayName|String|The display name of the deployment profile. Max allowed length is 200 chars. Returned by default. Supports: $select, $top, $skip, $orderby. $Search and $filter are not supported.| +|description|String|A description of the deployment profile. Max allowed length is 1500 chars. Supports: $select, $top, $skip, $orderBy. $Search and $filter are not supported.| +|language|String|The language code to be used when configuring the device. E.g. en-US. The default value is os-default. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use locale instead.| +|locale|String|The locale (language) to be used when configuring the device. E.g. en-US. The default value is os-default. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported.| +|createdDateTime|DateTimeOffset|The date and time of when the deployment profile was created. The value cannot be modified and is automatically populated when the profile was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only.| +|lastModifiedDateTime|DateTimeOffset|The date and time of when the deployment profile was last modified. The value cannot be updated manually and is automatically populated when any changes are made to the profile. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported Read-Only.| +|outOfBoxExperienceSettings|[outOfBoxExperienceSettings](../resources/intune-enrollment-outofboxexperiencesettings.md)|The Windows Autopilot Deployment Profile settings used by the Autopilot device for out-of-box experience. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use outOfBoxExperienceSetting instead.| +|outOfBoxExperienceSetting|[outOfBoxExperienceSetting](../resources/intune-enrollment-outofboxexperiencesetting.md)|The Windows Autopilot Deployment Profile settings used by the device for the out-of-box experience. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported.| |enrollmentStatusScreenSettings|[windowsEnrollmentStatusScreenSettings](../resources/intune-enrollment-windowsenrollmentstatusscreensettings.md)|Enrollment status screen setting|-|extractHardwareHash|Boolean|HardwareHash Extraction for the profile| -|deviceNameTemplate|String|The template used to name the AutoPilot Device. This can be a custom text and can also contain either the serial number of the device, or a randomly generated number. The total length of the text generated by the template can be no more than 15 characters.| -|deviceType|[windowsAutopilotDeviceType](../resources/intune-enrollment-windowsautopilotdevicetype.md)|The AutoPilot device type that this profile is applicable to. Possible values are: `windowsPc`, `surfaceHub2`, `holoLens`, `surfaceHub2S`, `virtualMachine`, `unknownFutureValue`.| -|enableWhiteGlove|Boolean|Enable Autopilot White Glove for the profile.| -|roleScopeTagIds|String collection|Scope tags for the profile.| -|managementServiceAppId|String|AzureAD management app ID used during client device-based enrollment discovery| +|extractHardwareHash|Boolean|Indicates whether the profile supports the extraction of hardware hash values and registration of the device into Windows Autopilot. When TRUE, indicates if hardware extraction and Windows Autopilot registration will happen on the next successful check-in. When FALSE, hardware hash extraction and Windows Autopilot registration will not happen. Default value is FALSE. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use hardwareHashExtractionEnabled instead.| +|hardwareHashExtractionEnabled|Boolean|Indicates whether the profile supports the extraction of hardware hash values and registration of the device into Windows Autopilot. When TRUE, indicates if hardware extraction and Windows Autopilot registration will happen on the next successful check-in. When FALSE, hardware hash extraction and Windows Autopilot registration will not happen. Default value is FALSE. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported.| +|deviceNameTemplate|String|The template used to name the Autopilot device. This can be a custom text and can also contain either the serial number of the device, or a randomly generated number. The total length of the text generated by the template can be no more than 15 characters. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported.| +|deviceType|[windowsAutopilotDeviceType](../resources/intune-enrollment-windowsautopilotdevicetype.md)|The Windows device type that this profile is applicable to. Possible values include windowsPc, holoLens, and virtualMachine. The default is windowsPc. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported. Possible values are: `windowsPc`, `surfaceHub2`, `holoLens`, `surfaceHub2S`, `virtualMachine`, `unknownFutureValue`.| +|enableWhiteGlove|Boolean|Indicates whether the user is allowed to use Windows Autopilot for pre-provisioned deployment mode during Out of Box experience (OOBE). When TRUE, indicates that Windows Autopilot for pre-provisioned deployment mode is allowed. When false, Windows Autopilot for pre-provisioned deployment mode is not allowed. The default is FALSE. Read-Only. Starting from May 2024 this property will no longer be supported and will be marked as deprecated. Use preprovisioningAllowed instead.| +|preprovisioningAllowed|Boolean|Indicates whether the user is allowed to use Windows Autopilot for pre-provisioned deployment mode during Out of Box experience (OOBE). When TRUE, indicates that Windows Autopilot for pre-provisioned deployment mode for OOBE is allowed to be used. When false, Windows Autopilot for pre-provisioned deployment mode for OOBE is not allowed. The default is FALSE.| +|roleScopeTagIds|String collection|List of role scope tags for the deployment profile. | +|managementServiceAppId|String|The Entra management service App ID which gets used during client device-based enrollment discovery. Supports: $select, $top, $skip. $Search, $orderBy and $filter are not supported.| ## Relationships |Relationship|Type|Description| Here is a JSON representation of the resource. "displayName": "String", "description": "String", "language": "String",+ "locale": "String", "createdDateTime": "String (timestamp)", "lastModifiedDateTime": "String (timestamp)", "outOfBoxExperienceSettings": { Here is a JSON representation of the resource. "skipKeyboardSelectionPage": true, "hideEscapeLink": true },+ "outOfBoxExperienceSetting": { + "@odata.type": "microsoft.graph.outOfBoxExperienceSetting", + "privacySettingsHidden": true, + "eulaHidden": true, + "userType": "String", + "deviceUsageType": "String", + "keyboardSelectionPageSkipped": true, + "escapeLinkHidden": true + }, "enrollmentStatusScreenSettings": { "@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings", "hideInstallationProgress": true, Here is a JSON representation of the resource. "allowDeviceUseOnInstallFailure": true }, "extractHardwareHash": true,+ "hardwareHashExtractionEnabled": true, "deviceNameTemplate": "String", "deviceType": "String", "enableWhiteGlove": true,+ "preprovisioningAllowed": true, "roleScopeTagIds": [ "String" ], "managementServiceAppId": "String" }-``` +``` |
v1.0 | Intune Enrollment Windowsautopilotdeploymentprofileassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-windowsautopilotdeploymentprofileassignment.md | Here is a JSON representation of the resource. "source": "String", "sourceId": "String" }-``` +``` |
v1.0 | Intune Enrollment Windowsautopilotdevicedeletionstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-windowsautopilotdevicedeletionstate.md | Namespace: microsoft.graph |unknown|0|Unknown status.| |failed|1|Request failed status.| |accepted|2|Request accepted status.|-|error|3|Error status.| +|error|3|Error status.| |
v1.0 | Intune Enrollment Windowsautopilotdeviceidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-windowsautopilotdeviceidentity.md | Here is a JSON representation of the resource. "remediationStateLastModifiedDateTime": "String (timestamp)", "userlessEnrollmentStatus": "String" }-``` +``` |
v1.0 | Intune Enrollment Windowsautopilotdeviceremediationstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-windowsautopilotdeviceremediationstate.md | Device remediation status, indicating whether or not hardware has been changed f |noRemediationRequired|1|No hardware change has been detected.| |automaticRemediationRequired|2|Hardware change detected on client. Additional remediation is required.| |manualRemediationRequired|3|Hardware change detected on client that could not resolved automatically. Additional remediation is required.|-|unknownFutureValue|4|Marks the end of known enum values, and allows for additional values in the future.| +|unknownFutureValue|4|Marks the end of known enum values, and allows for additional values in the future.| |
v1.0 | Intune Enrollment Windowsautopilotdevicetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-windowsautopilotdevicetype.md | Namespace: microsoft.graph |holoLens|2|HoloLens| |surfaceHub2S|3|SurfaceHub2S| |virtualMachine|4|VirtualMachine|-|unknownFutureValue|99|Placeholder for evolvable enum, but this enum is never returned to the caller, so it shouldn't be necessary. | +|unknownFutureValue|99|Placeholder for evolvable enum, but this enum is never returned to the caller, so it shouldn't be necessary. | |
v1.0 | Intune Enrollment Windowsautopilotprofileassignmentdetailedstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-windowsautopilotprofileassignmentdetailedstatus.md | Namespace: microsoft.graph |holoLensProfileNotSupported|3|Indicates that a HoloLens AutoPilot Profile is assigned to a device that is not HoloLens.| |windowsPcProfileNotSupported|4|Indicates that a Windows PC AutoPilot Profile is assigned to a device that is not Windows PC.| |surfaceHub2SProfileNotSupported|5|Indicates that a surface Hub 2S AutoPilot Profile is assigned to a device that is not surface Hub 2S.|-|unknownFutureValue|99|Placeholder for evolvable enum, but this enum is never returned to the caller, so it shouldn't be necessary.| +|unknownFutureValue|99|Placeholder for evolvable enum, but this enum is never returned to the caller, so it shouldn't be necessary.| |
v1.0 | Intune Enrollment Windowsautopilotprofileassignmentstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-windowsautopilotprofileassignmentstatus.md | Namespace: microsoft.graph |assignedUnkownSyncState|3|Assigned successfully in Intune and either in-sync or out of sync with Windows auto pilot program| |notAssigned|4|Not assigned| |pending|5|Pending assignment|-|failed|6| Assignment failed| +|failed|6| Assignment failed| |
v1.0 | Intune Enrollment Windowsautopilotsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-windowsautopilotsettings.md | Here is a JSON representation of the resource. "lastManualSyncTriggerDateTime": "String (timestamp)", "syncStatus": "String" }-``` +``` |
v1.0 | Intune Enrollment Windowsautopilotsyncstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-windowsautopilotsyncstatus.md | Namespace: microsoft.graph |unknown|0|Unknown sync status| |inProgress|1|Sync is in progress| |completed|2|Sync completed.|-|failed|3|Sync failed.| +|failed|3|Sync failed.| |
v1.0 | Intune Enrollment Windowsautopilotuserlessenrollmentstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-windowsautopilotuserlessenrollmentstatus.md | Userless enrollment block status, indicating whether the next device enrollment |unknown|0|Unknown userless enrollment block status. Next userless enrollment may fail. This is the default value.| |allowed|1|Indicates next userless enrollment can proceed.| |blocked|2|Indicates next userless enrollment cannot proceed without resetting the windowsAutopilotUserlessEnrollmentStatus.|-|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Enrollment Windowsdeviceusagetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-windowsdeviceusagetype.md | Namespace: microsoft.graph |Member|Value|Description| |:|:|:| |singleUser|0|Single User Device Type|-|shared|1|Shared Device Type| +|shared|1|Shared Device Type| |
v1.0 | Intune Enrollment Windowsdomainjoinconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-windowsdomainjoinconfiguration.md | Namespace: microsoft.graph ## Methods |Method|Return Type|Description| |:|:|:|-|[Get windowsDomainJoinConfiguration](../api/intune-enrollment-windowsdomainjoinconfiguration-get.md)|[windowsDomainJoinConfiguration](../resources/intune-enrollment-windowsdomainjoinconfiguration.md)|Read properties and relationships of the [windowsDomainJoinConfiguration](../resources/intune-enrollment-windowsdomainjoinconfiguration.md) object.| -|[Update windowsDomainJoinConfiguration](../api/intune-enrollment-windowsdomainjoinconfiguration-update.md)|[windowsDomainJoinConfiguration](../resources/intune-enrollment-windowsdomainjoinconfiguration.md)|Update the properties of a [windowsDomainJoinConfiguration](../resources/intune-enrollment-windowsdomainjoinconfiguration.md) object.| +|[Get windowsDomainJoinConfiguration](../api/intune-enrollment-windowsdomainjoinconfiguration-get.md)|[windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md)|Read properties and relationships of the [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object.| +|[Update windowsDomainJoinConfiguration](../api/intune-enrollment-windowsdomainjoinconfiguration-update.md)|[windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md)|Update the properties of a [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.windowsDomainJoinConfiguration" }-``` +``` |
v1.0 | Intune Enrollment Windowsenrollmentstatusscreensettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-windowsenrollmentstatusscreensettings.md | Here is a JSON representation of the resource. "installProgressTimeoutInMinutes": 1024, "allowDeviceUseOnInstallFailure": true }-``` +``` |
v1.0 | Intune Enrollment Windowsusertype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-enrollment-windowsusertype.md | Namespace: microsoft.graph |Member|Value|Description| |:|:|:| |administrator|0||-|standard|1|| +|standard|1|| |
v1.0 | Intune Epmgraphapiservice Applicationdetail | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-epmgraphapiservice-applicationdetail.md | Here is a JSON representation of the resource. "productInternalName": "String", "productVersion": "String" }-``` +``` |
v1.0 | Intune Epmgraphapiservice Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-epmgraphapiservice-devicemanagement.md | Singleton entity that acts as a container for all device management functionalit ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-epmgraphapiservice-devicemanagement-get.md)|[deviceManagement](../resources/intune-epmgraphapiservice-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-epmgraphapiservice-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-epmgraphapiservice-devicemanagement-update.md)|[deviceManagement](../resources/intune-epmgraphapiservice-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-epmgraphapiservice-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-epmgraphapiservice-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-epmgraphapiservice-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Epmgraphapiservice Elevationrequeststate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-epmgraphapiservice-elevationrequeststate.md | Indicates state of elevation request |denied|3|Indicates elevation request has been denied by IT Admin.| |expired|4|Set to expire when Approved for is elapsed or ExpireDate is elapsed, whichever is sooner.| |unknownFutureValue|5|Evolvable enumeration sentinel value. Do not use.|-|revoked|6|Set to expire when Approved for is elapsed or ExpireDate is elapsed, whichever is sooner.| +|revoked|6|Set to expire when Approved for is elapsed or ExpireDate is elapsed, whichever is sooner.| |
v1.0 | Intune Epmgraphapiservice Privilegemanagementelevationrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-epmgraphapiservice-privilegemanagementelevationrequest.md | These are elevation approval requests for EPM support arbitrated scenario initia |[getAllElevationRequests action](../api/intune-epmgraphapiservice-privilegemanagementelevationrequest-getallelevationrequests.md)|[privilegeManagementElevationRequest](../resources/intune-epmgraphapiservice-privilegemanagementelevationrequest.md) collection|| |[approve action](../api/intune-epmgraphapiservice-privilegemanagementelevationrequest-approve.md)|[privilegeManagementElevationRequest](../resources/intune-epmgraphapiservice-privilegemanagementelevationrequest.md)|| |[deny action](../api/intune-epmgraphapiservice-privilegemanagementelevationrequest-deny.md)|[privilegeManagementElevationRequest](../resources/intune-epmgraphapiservice-privilegemanagementelevationrequest.md)||+|[revoke action](../api/intune-epmgraphapiservice-privilegemanagementelevationrequest-revoke.md)|[privilegeManagementElevationRequest](../resources/intune-epmgraphapiservice-privilegemanagementelevationrequest.md)|| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "requestExpiryDateTime": "String (timestamp)", "reviewerJustification": "String" }-``` +``` |
v1.0 | Intune Esim Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-esim-devicemanagement.md | Singleton entity that acts as a container for all device management functionalit ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-esim-devicemanagement-get.md)|[deviceManagement](../resources/intune-esim-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-esim-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-esim-devicemanagement-update.md)|[deviceManagement](../resources/intune-esim-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-esim-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-esim-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-esim-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Esim Embeddedsimactivationcode | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-esim-embeddedsimactivationcode.md | Here is a JSON representation of the resource. "matchingIdentifier": "String", "smdpPlusServerAddress": "String" }-``` +``` |
v1.0 | Intune Esim Embeddedsimactivationcodepool | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-esim-embeddedsimactivationcodepool.md | Here is a JSON representation of the resource. ], "activationCodeCount": 1024 }-``` +``` |
v1.0 | Intune Esim Embeddedsimactivationcodepoolassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-esim-embeddedsimactivationcodepoolassignment.md | Here is a JSON representation of the resource. "deviceAndAppManagementAssignmentFilterType": "String" } }-``` +``` |
v1.0 | Intune Esim Embeddedsimdevicestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-esim-embeddedsimdevicestate.md | Here is a JSON representation of the resource. "state": "String", "stateDetails": "String" }-``` +``` |
v1.0 | Intune Esim Embeddedsimdevicestatevalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-esim-embeddedsimdevicestatevalue.md | Describes the various states for an embedded SIM activation code. |deleting|4|Designates that Intune Service is trying to delete the profile from the device.| |error|5|Designates that there is error with this profile.| |deleted|6|Designates that the profile is deleted from the device.|-|removedByUser|7|Designates that the profile is removed from the device by the user| +|removedByUser|7|Designates that the profile is removed from the device by the user| |
v1.0 | Intune Esim Platformtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-esim-platformtype.md | Namespace: microsoft.graph |windowsPhone81|5|| |windows81AndLater|6|| |windows10AndLater|7||-|androidWorkProfile|8|| +|androidWorkProfile|8|| |
v1.0 | Intune Esim Tuple_2Ofexecutiontype_Icollection_1Ofoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-esim-tuple_2ofexecutiontype_icollection_1ofoperation.md | Here is a JSON representation of the resource. "<Unknown None>" ] }-``` +``` |
v1.0 | Intune Gpanalyticsservice Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-gpanalyticsservice-devicemanagement.md | Singleton entity that acts as a container for all device management functionalit ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-gpanalyticsservice-devicemanagement-get.md)|[deviceManagement](../resources/intune-gpanalyticsservice-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-gpanalyticsservice-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-gpanalyticsservice-devicemanagement-update.md)|[deviceManagement](../resources/intune-gpanalyticsservice-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-gpanalyticsservice-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-gpanalyticsservice-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-gpanalyticsservice-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Gpanalyticsservice Grouppolicymigrationreadiness | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-gpanalyticsservice-grouppolicymigrationreadiness.md | Indicates if the Group Policy Object file is covered and ready for Intune migrat |partial|2|Partial Intune coverage| |complete|3|Complete Intune coverage| |error|4|Error when analyzing coverage|-|notApplicable|5|No Group Policy settings in GPO| +|notApplicable|5|No Group Policy settings in GPO| |
v1.0 | Intune Gpanalyticsservice Grouppolicymigrationreport | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-gpanalyticsservice-grouppolicymigrationreport.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Gpanalyticsservice Grouppolicyobjectfile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-gpanalyticsservice-grouppolicyobjectfile.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Gpanalyticsservice Grouppolicysettingmapping | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-gpanalyticsservice-grouppolicysettingmapping.md | Here is a JSON representation of the resource. "intuneSettingDefinitionId": "String", "admxSettingDefinitionId": "String" }-``` +``` |
v1.0 | Intune Gpanalyticsservice Grouppolicysettingscope | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-gpanalyticsservice-grouppolicysettingscope.md | Scope of the group policy setting. |:|:|:| |unknown|0|Device scope unknown| |device|1|Device scope|-|user|2|User scope| +|user|2|User scope| |
v1.0 | Intune Gpanalyticsservice Grouppolicysettingtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-gpanalyticsservice-grouppolicysettingtype.md | Setting type of the group policy. |registrySettings|24|RegistrySettings setting type| |scheduledTasks|25|ScheduledTasks setting type| |shortcutSettings|26|ShortcutSettings setting type|-|startMenuSettings|27|StartMenuSettings setting type| +|startMenuSettings|27|StartMenuSettings setting type| |
v1.0 | Intune Gpanalyticsservice Mdmsupportedstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-gpanalyticsservice-mdmsupportedstate.md | Mdm Support Status of the setting. |unknown|0|Mdm support status of the setting is not known.| |supported|1|Setting is supported.| |unsupported|2|Setting is unsupported.|-|deprecated|3|Setting is depcrecated.| +|deprecated|3|Setting is depcrecated.| |
v1.0 | Intune Gpanalyticsservice Unsupportedgrouppolicyextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-gpanalyticsservice-unsupportedgrouppolicyextension.md | Here is a JSON representation of the resource. "extensionType": "String", "nodeName": "String" }-``` +``` |
v1.0 | Intune Graph Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-graph-overview.md | You can use either API to manage Windows updates; however, these two APIs are no ## Next Steps - Learn [how to use Azure AD](/intune/intune-graph-apis) to access the Microsoft Graph API for Intune.-- Explore the [PowerShell Intune samples](https://github.com/microsoftgraph/powershell-intune-samples), which show how to use the Microsoft Graph API for Intune in context of working examples.+- Explore the [PowerShell Intune samples](https://github.com/microsoftgraph/powershell-intune-samples), which show how to use the Microsoft Graph API for Intune in context of working examples. |
v1.0 | Intune Grouppolicy Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-devicemanagement.md | Singleton entity that acts as a container for all device management functionalit ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-grouppolicy-devicemanagement-get.md)|[deviceManagement](../resources/intune-grouppolicy-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-grouppolicy-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-grouppolicy-devicemanagement-update.md)|[deviceManagement](../resources/intune-grouppolicy-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-grouppolicy-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-grouppolicy-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-grouppolicy-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Grouppolicy Devicemanagementreports | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-devicemanagementreports.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagementReports", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicycategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicycategory.md | Here is a JSON representation of the resource. "id": "String (identifier)", "lastModifiedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicyconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicyconfiguration.md | Here is a JSON representation of the resource. "id": "String (identifier)", "lastModifiedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicyconfigurationassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicyconfigurationassignment.md | Here is a JSON representation of the resource. "entraObjectId": "String" } }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicyconfigurationingestiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicyconfigurationingestiontype.md | Group Policy Configuration Ingestion Type |custom|1|Indicates policy created have definitions ingested by IT admin with sufficient permissions through custom ingestion process| |builtIn|2|Indicates policy created have definitions ingested through system ingestion process| |mixed|3|Indicated atleast 1 tenant admin & system ingested definitions configured for this policy|-|unknownFutureValue|4|Unknown future enum value| +|unknownFutureValue|4|Unknown future enum value| |
v1.0 | Intune Grouppolicy Grouppolicyconfigurationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicyconfigurationtype.md | Group Policy Configuration Type |Member|Value|Description| |:|:|:| |policy|0|The policy type does not tattoo the value, which means the value is removed allowing the original configuration value to be used. The policy type supercedes application configuration setting so the application is always aware of the value. The policy type prevents the user from modifying the value through the application's user interface.|-|preference|1|The preference type does tattoo the value, which means the value is not removed from the registry. The preference type will overwrite the user configured-value and does not retain the previous value. The preference type does not prevent the user from modifying the value through the application's user interface.| +|preference|1|The preference type does tattoo the value, which means the value is not removed from the registry. The preference type will overwrite the user configured-value and does not retain the previous value. The preference type does not prevent the user from modifying the value through the application's user interface.| |
v1.0 | Intune Grouppolicy Grouppolicydefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicydefinition.md | Here is a JSON representation of the resource. "id": "String (identifier)", "lastModifiedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicydefinitionclasstype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicydefinitionclasstype.md | Group Policy Definition Class Type. |Member|Value|Description| |:|:|:| |user|0|Identifies placement of the policy setting under the user configuration node.|-|machine|1|Identifies placement of the policy setting under the computer configuration node.| +|machine|1|Identifies placement of the policy setting under the computer configuration node.| |
v1.0 | Intune Grouppolicy Grouppolicydefinitionfile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicydefinitionfile.md | Here is a JSON representation of the resource. "id": "String (identifier)", "lastModifiedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicydefinitionvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicydefinitionvalue.md | Here is a JSON representation of the resource. "id": "String (identifier)", "lastModifiedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicyoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicyoperation.md | Here is a JSON representation of the resource. "id": "String (identifier)", "lastModifiedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicyoperationstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicyoperationstatus.md | Type of Group Policy operation status. |unknown|0|Group Policy unknown operation status.| |inProgress|1|Group Policy in progress operation status.| |success|2|Group Policy successful operation status.|-|failed|3|Group Policy failed operation status.| +|failed|3|Group Policy failed operation status.| |
v1.0 | Intune Grouppolicy Grouppolicyoperationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicyoperationtype.md | Type of Group Policy operation. |addLanguageFiles|3|Group Policy add new language(ADML) files operation type.| |removeLanguageFiles|4|Group Policy remove language(ADML) files operation type.| |updateLanguageFiles|5|Group Policy update language(ADML) files operation type.|-|remove|6|Group Policy remove uploaded file operation type.| +|remove|6|Group Policy remove uploaded file operation type.| |
v1.0 | Intune Grouppolicy Grouppolicypresentation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicypresentation.md | Here is a JSON representation of the resource. "id": "String (identifier)", "lastModifiedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationcheckbox | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicypresentationcheckbox.md | Here is a JSON representation of the resource. "lastModifiedDateTime": "String (timestamp)", "defaultChecked": true }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationcombobox | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicypresentationcombobox.md | Here is a JSON representation of the resource. "required": true, "maxLength": 1024 }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationdecimaltextbox | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicypresentationdecimaltextbox.md | Here is a JSON representation of the resource. "minValue": 1024, "maxValue": 1024 }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationdropdownlist | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicypresentationdropdownlist.md | Here is a JSON representation of the resource. ], "required": true }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationdropdownlistitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicypresentationdropdownlistitem.md | Here is a JSON representation of the resource. "displayName": "String", "value": "String" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationlistbox | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicypresentationlistbox.md | Here is a JSON representation of the resource. "explicitValue": true, "valuePrefix": "String" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationlongdecimaltextbox | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicypresentationlongdecimaltextbox.md | Here is a JSON representation of the resource. "minValue": 1024, "maxValue": 1024 }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationmultitextbox | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicypresentationmultitextbox.md | Here is a JSON representation of the resource. "maxLength": 1024, "maxStrings": 1024 }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationtext | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicypresentationtext.md | Here is a JSON representation of the resource. "id": "String (identifier)", "lastModifiedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationtextbox | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicypresentationtextbox.md | Here is a JSON representation of the resource. "required": true, "maxLength": 1024 }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicypresentationvalue.md | Here is a JSON representation of the resource. "createdDateTime": "String (timestamp)", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationvalueboolean | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicypresentationvalueboolean.md | Here is a JSON representation of the resource. "id": "String (identifier)", "value": true }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationvaluedecimal | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicypresentationvaluedecimal.md | Here is a JSON representation of the resource. "id": "String (identifier)", "value": 1024 }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationvaluelist | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicypresentationvaluelist.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationvaluelongdecimal | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicypresentationvaluelongdecimal.md | Here is a JSON representation of the resource. "id": "String (identifier)", "value": 1024 }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationvaluemultitext | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicypresentationvaluemultitext.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicypresentationvaluetext | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicypresentationvaluetext.md | Here is a JSON representation of the resource. "id": "String (identifier)", "value": "String" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicytype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicytype.md | Type of Group Policy File or Definition. |Member|Value|Description| |:|:|:| |admxBacked|0|Group Policy administrative templates built-in to the Policy configuration service provider (CSP).|-|admxIngested|1|Group Policy administrative templates installed using the Policy configuration service provider (CSP).| +|admxIngested|1|Group Policy administrative templates installed using the Policy configuration service provider (CSP).| |
v1.0 | Intune Grouppolicy Grouppolicyuploadedcategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicyuploadedcategory.md | Here is a JSON representation of the resource. "id": "String (identifier)", "lastModifiedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicyuploadeddefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicyuploadeddefinition.md | Here is a JSON representation of the resource. "id": "String (identifier)", "lastModifiedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicyuploadeddefinitionfile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicyuploadeddefinitionfile.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicyuploadeddefinitionfilestatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicyuploadeddefinitionfilestatus.md | Type of Group Policy uploaded definition file status. |assigned|3|Group Policy uploaded definition file assigned to policy.| |removalInProgress|4|Group Policy uploaded definition file removal in progress.| |uploadFailed|5|Group Policy uploaded definition file upload failed.|-|removalFailed|6|Group Policy uploaded definition file removal failed.| +|removalFailed|6|Group Policy uploaded definition file removal failed.| |
v1.0 | Intune Grouppolicy Grouppolicyuploadedlanguagefile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicyuploadedlanguagefile.md | Here is a JSON representation of the resource. "id": "String (identifier)", "lastModifiedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Grouppolicy Grouppolicyuploadedpresentation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-grouppolicyuploadedpresentation.md | Here is a JSON representation of the resource. "id": "String (identifier)", "lastModifiedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Grouppolicy Ingestionsource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-ingestionsource.md | Category Ingestion source |unknown|0|Indicates unknown category| |custom|1|Indicates the category is ingested by IT admin with sufficient permissions through custom ingestion process| |builtIn|2|Indicates the category is ingested through system ingestion process|-|unknownFutureValue|3|Unknown future enum value| +|unknownFutureValue|3|Unknown future enum value| |
v1.0 | Intune Grouppolicy Keyvaluepair | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-grouppolicy-keyvaluepair.md | Here is a JSON representation of the resource. "name": "String", "value": "String" }-``` +``` |
v1.0 | Intune Mam Androidmanagedappprotection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-androidmanagedappprotection.md | Inherits from [targetedManagedAppProtection](../resources/intune-mam-targetedman ## Methods |Method|Return Type|Description| |:|:|:|-|[List androidManagedAppProtections](../api/intune-mam-androidmanagedappprotection-list.md)|[androidManagedAppProtection](../resources/intune-mam-androidmanagedappprotection.md) collection|List properties and relationships of the [androidManagedAppProtection](../resources/intune-mam-androidmanagedappprotection.md) objects.| -|[Get androidManagedAppProtection](../api/intune-mam-androidmanagedappprotection-get.md)|[androidManagedAppProtection](../resources/intune-mam-androidmanagedappprotection.md)|Read properties and relationships of the [androidManagedAppProtection](../resources/intune-mam-androidmanagedappprotection.md) object.| -|[Create androidManagedAppProtection](../api/intune-mam-androidmanagedappprotection-create.md)|[androidManagedAppProtection](../resources/intune-mam-androidmanagedappprotection.md)|Create a new [androidManagedAppProtection](../resources/intune-mam-androidmanagedappprotection.md) object.| -|[Delete androidManagedAppProtection](../api/intune-mam-androidmanagedappprotection-delete.md)|None|Deletes a [androidManagedAppProtection](../resources/intune-mam-androidmanagedappprotection.md).| -|[Update androidManagedAppProtection](../api/intune-mam-androidmanagedappprotection-update.md)|[androidManagedAppProtection](../resources/intune-mam-androidmanagedappprotection.md)|Update the properties of a [androidManagedAppProtection](../resources/intune-mam-androidmanagedappprotection.md) object.| +|[List androidManagedAppProtections](../api/intune-mam-androidmanagedappprotection-list.md)|[androidManagedAppProtection](../resources/intune-shared-androidmanagedappprotection.md) collection|List properties and relationships of the [androidManagedAppProtection](../resources/intune-shared-androidmanagedappprotection.md) objects.| +|[Get androidManagedAppProtection](../api/intune-mam-androidmanagedappprotection-get.md)|[androidManagedAppProtection](../resources/intune-shared-androidmanagedappprotection.md)|Read properties and relationships of the [androidManagedAppProtection](../resources/intune-shared-androidmanagedappprotection.md) object.| +|[Create androidManagedAppProtection](../api/intune-mam-androidmanagedappprotection-create.md)|[androidManagedAppProtection](../resources/intune-shared-androidmanagedappprotection.md)|Create a new [androidManagedAppProtection](../resources/intune-shared-androidmanagedappprotection.md) object.| +|[Delete androidManagedAppProtection](../api/intune-mam-androidmanagedappprotection-delete.md)|None|Deletes a [androidManagedAppProtection](../resources/intune-shared-androidmanagedappprotection.md).| +|[Update androidManagedAppProtection](../api/intune-mam-androidmanagedappprotection-update.md)|[androidManagedAppProtection](../resources/intune-shared-androidmanagedappprotection.md)|Update the properties of a [androidManagedAppProtection](../resources/intune-shared-androidmanagedappprotection.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "messagingRedirectAppPackageId": "String", "messagingRedirectAppDisplayName": "String" }-``` +``` |
v1.0 | Intune Mam Androidmanagedappregistration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-androidmanagedappregistration.md | Here is a JSON representation of the resource. "version": "String", "patchVersion": "String" }-``` +``` |
v1.0 | Intune Mam Androidmanagedappsafetynetappsverificationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-androidmanagedappsafetynetappsverificationtype.md | An admin enforced Android SafetyNet Device Attestation requirement on a managed |Member|Value|Description| |:|:|:| |none|0|no requirement set|-|enabled|1|require that Android device has SafetyNet Apps Verification enabled| +|enabled|1|require that Android device has SafetyNet Apps Verification enabled| |
v1.0 | Intune Mam Androidmanagedappsafetynetdeviceattestationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-androidmanagedappsafetynetdeviceattestationtype.md | An admin enforced Android SafetyNet Device Attestation requirement on a managed |:|:|:| |none|0|no requirement set| |basicIntegrity|1|require that Android device passes SafetyNet Basic Integrity validation|-|basicIntegrityAndDeviceCertification|2|require that Android device passes SafetyNet Basic Integrity and Device Certification validations| +|basicIntegrityAndDeviceCertification|2|require that Android device passes SafetyNet Basic Integrity and Device Certification validations| |
v1.0 | Intune Mam Androidmanagedappsafetynetevaluationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-androidmanagedappsafetynetevaluationtype.md | An admin enforced Android SafetyNet evaluation type requirement on a managed app |Member|Value|Description| |:|:|:| |basic|0|Require basic evaluation|-|hardwareBacked|1|Require hardware backed evaluation| +|hardwareBacked|1|Require hardware backed evaluation| |
v1.0 | Intune Mam Androidmobileappidentifier | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-androidmobileappidentifier.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.androidMobileAppIdentifier", "packageId": "String" }-``` +``` |
v1.0 | Intune Mam Appmanagementlevel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-appmanagementlevel.md | Management levels for apps |androidEnterpriseDedicatedDevicesWithAzureAdSharedMode|8|Android Enterprise dedicated devices with Azure AD Shared mode| |androidOpenSourceProjectUserAssociated|16|Android Open Source Project (AOSP) devices| |androidOpenSourceProjectUserless|32|Android Open Source Project (AOSP) userless devices|-|unknownFutureValue|64|Place holder for evolvable enum| +|unknownFutureValue|64|Place holder for evolvable enum| |
v1.0 | Intune Mam Conceptual | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-conceptual.md | Microsoft Intune app protection policies help protect your company data and prev You can use Intune app protection policies to help protect your companyΓÇÖs data. Because Intune app protection policies can be used independent of any mobile-device management (MDM) solution, you can use it to protect your companyΓÇÖs data with or without enrolling devices in a device management solution. By implementing app-level policies, you can restrict access to company resources and keep data within the purview of your IT department. -Use Graph resources to manage app protection polices in Intune. See the table of content for a list of resources. +Use Graph resources to manage app protection polices in Intune. See the table of content for a list of resources. |
v1.0 | Intune Mam Defaultmanagedappprotection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-defaultmanagedappprotection.md | Here is a JSON representation of the resource. "messagingRedirectAppDisplayName": "String", "messagingRedirectAppPackageId": "String" }-``` +``` |
v1.0 | Intune Mam Deviceappmanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-deviceappmanagement.md | Device app management singleton entity. |Relationship|Type|Description| |:|:|:| |managedAppPolicies|[managedAppPolicy](../resources/intune-mam-managedapppolicy.md) collection|Managed app policies.|-|iosManagedAppProtections|[iosManagedAppProtection](../resources/intune-mam-iosmanagedappprotection.md) collection|iOS managed app policies.| -|androidManagedAppProtections|[androidManagedAppProtection](../resources/intune-mam-androidmanagedappprotection.md) collection|Android managed app policies.| +|iosManagedAppProtections|[iosManagedAppProtection](../resources/intune-shared-iosmanagedappprotection.md) collection|iOS managed app policies.| +|androidManagedAppProtections|[androidManagedAppProtection](../resources/intune-shared-androidmanagedappprotection.md) collection|Android managed app policies.| |windowsManagedAppProtections|[windowsManagedAppProtection](../resources/intune-mam-windowsmanagedappprotection.md) collection|Windows managed app policies.| |defaultManagedAppProtections|[defaultManagedAppProtection](../resources/intune-mam-defaultmanagedappprotection.md) collection|Default managed app policies.|-|targetedManagedAppConfigurations|[targetedManagedAppConfiguration](../resources/intune-mam-targetedmanagedappconfiguration.md) collection|Targeted managed app configurations.| -|mdmWindowsInformationProtectionPolicies|[mdmWindowsInformationProtectionPolicy](../resources/intune-mam-mdmwindowsinformationprotectionpolicy.md) collection|Windows information protection for apps running on devices which are MDM enrolled.| +|targetedManagedAppConfigurations|[targetedManagedAppConfiguration](../resources/intune-shared-targetedmanagedappconfiguration.md) collection|Targeted managed app configurations.| +|mdmWindowsInformationProtectionPolicies|[mdmWindowsInformationProtectionPolicy](../resources/intune-shared-mdmwindowsinformationprotectionpolicy.md) collection|Windows information protection for apps running on devices which are MDM enrolled.| |windowsInformationProtectionPolicies|[windowsInformationProtectionPolicy](../resources/intune-mam-windowsinformationprotectionpolicy.md) collection|Windows information protection for apps running on devices which are not MDM enrolled.| |managedAppRegistrations|[managedAppRegistration](../resources/intune-mam-managedappregistration.md) collection|The managed app registrations.| |managedAppStatuses|[managedAppStatus](../resources/intune-mam-managedappstatus.md) collection|The managed app statuses.| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceAppManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Mam Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-devicemanagement.md | Singleton entity that acts as a container for all device management functionalit ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-mam-devicemanagement-get.md)|[deviceManagement](../resources/intune-mam-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-mam-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-mam-devicemanagement-update.md)|[deviceManagement](../resources/intune-mam-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-mam-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-mam-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-mam-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationchoicesettingcollectiondefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-devicemanagementconfigurationchoicesettingcollectiondefinition.md | Here is a JSON representation of the resource. "maximumCount": 1024, "minimumCount": 1024 }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationchoicesettingcollectioninstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-devicemanagementconfigurationchoicesettingcollectioninstance.md | Inherits from [deviceManagementConfigurationSettingInstance](../resources/intune |:|:|:| |settingDefinitionId|String|Setting Definition Id Inherited from [deviceManagementConfigurationSettingInstance](../resources/intune-shared-devicemanagementconfigurationsettinginstance.md)| |settingInstanceTemplateReference|[deviceManagementConfigurationSettingInstanceTemplateReference](../resources/intune-shared-devicemanagementconfigurationsettinginstancetemplatereference.md)|Setting Instance Template Reference Inherited from [deviceManagementConfigurationSettingInstance](../resources/intune-shared-devicemanagementconfigurationsettinginstance.md)|-|choiceSettingCollectionValue|[deviceManagementConfigurationChoiceSettingValue](../resources/intune-mam-devicemanagementconfigurationchoicesettingvalue.md) collection|Choice setting collection value| +|choiceSettingCollectionValue|[deviceManagementConfigurationChoiceSettingValue](../resources/intune-shared-devicemanagementconfigurationchoicesettingvalue.md) collection|Choice setting collection value| ## Relationships None Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationchoicesettinginstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-devicemanagementconfigurationchoicesettinginstance.md | Inherits from [deviceManagementConfigurationSettingInstance](../resources/intune |:|:|:| |settingDefinitionId|String|Setting Definition Id Inherited from [deviceManagementConfigurationSettingInstance](../resources/intune-shared-devicemanagementconfigurationsettinginstance.md)| |settingInstanceTemplateReference|[deviceManagementConfigurationSettingInstanceTemplateReference](../resources/intune-shared-devicemanagementconfigurationsettinginstancetemplatereference.md)|Setting Instance Template Reference Inherited from [deviceManagementConfigurationSettingInstance](../resources/intune-shared-devicemanagementconfigurationsettinginstance.md)|-|choiceSettingValue|[deviceManagementConfigurationChoiceSettingValue](../resources/intune-mam-devicemanagementconfigurationchoicesettingvalue.md)|Choice setting value| +|choiceSettingValue|[deviceManagementConfigurationChoiceSettingValue](../resources/intune-shared-devicemanagementconfigurationchoicesettingvalue.md)|Choice setting value| ## Relationships None Here is a JSON representation of the resource. ] } }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationchoicesettingvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-devicemanagementconfigurationchoicesettingvalue.md | Namespace: microsoft.graph Setting value -Inherits from [deviceManagementConfigurationSettingValue](../resources/intune-mam-devicemanagementconfigurationsettingvalue.md) +Inherits from [deviceManagementConfigurationSettingValue](../resources/intune-shared-devicemanagementconfigurationsettingvalue.md) ## Properties |Property|Type|Description| Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationexchangeonlinesettingapplicability | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-devicemanagementconfigurationexchangeonlinesettingapplicability.md | Namespace: microsoft.graph Applicability for an Exchange Online Setting -Inherits from [deviceManagementConfigurationSettingApplicability](../resources/intune-mam-devicemanagementconfigurationsettingapplicability.md) +Inherits from [deviceManagementConfigurationSettingApplicability](../resources/intune-shared-devicemanagementconfigurationsettingapplicability.md) ## Properties |Property|Type|Description| |:|:|:|-|description|String|description of the setting Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-mam-devicemanagementconfigurationsettingapplicability.md)| -|platform|[deviceManagementConfigurationPlatforms](../resources/intune-shared-devicemanagementconfigurationplatforms.md)|Platform setting can be applied on Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-mam-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.| -|deviceMode|[deviceManagementConfigurationDeviceMode](../resources/intune-shared-devicemanagementconfigurationdevicemode.md)|Device Mode that setting can be applied on Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-mam-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `kiosk`.| -|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-mam-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-mam-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `unknownFutureValue`.| +|description|String|description of the setting Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-shared-devicemanagementconfigurationsettingapplicability.md)| +|platform|[deviceManagementConfigurationPlatforms](../resources/intune-shared-devicemanagementconfigurationplatforms.md)|Platform setting can be applied on Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-shared-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.| +|deviceMode|[deviceManagementConfigurationDeviceMode](../resources/intune-shared-devicemanagementconfigurationdevicemode.md)|Device Mode that setting can be applied on Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-shared-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `kiosk`.| +|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-shared-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-shared-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `unknownFutureValue`.| ## Relationships None Here is a JSON representation of the resource. "deviceMode": "String", "technologies": "String" }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationgroupsettingcollectioninstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-devicemanagementconfigurationgroupsettingcollectioninstance.md | Inherits from [deviceManagementConfigurationSettingInstance](../resources/intune |:|:|:| |settingDefinitionId|String|Setting Definition Id Inherited from [deviceManagementConfigurationSettingInstance](../resources/intune-shared-devicemanagementconfigurationsettinginstance.md)| |settingInstanceTemplateReference|[deviceManagementConfigurationSettingInstanceTemplateReference](../resources/intune-shared-devicemanagementconfigurationsettinginstancetemplatereference.md)|Setting Instance Template Reference Inherited from [deviceManagementConfigurationSettingInstance](../resources/intune-shared-devicemanagementconfigurationsettinginstance.md)|-|groupSettingCollectionValue|[deviceManagementConfigurationGroupSettingValue](../resources/intune-mam-devicemanagementconfigurationgroupsettingvalue.md) collection|A collection of GroupSetting values| +|groupSettingCollectionValue|[deviceManagementConfigurationGroupSettingValue](../resources/intune-shared-devicemanagementconfigurationgroupsettingvalue.md) collection|A collection of GroupSetting values| ## Relationships None Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationgroupsettinginstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-devicemanagementconfigurationgroupsettinginstance.md | Inherits from [deviceManagementConfigurationSettingInstance](../resources/intune |:|:|:| |settingDefinitionId|String|Setting Definition Id Inherited from [deviceManagementConfigurationSettingInstance](../resources/intune-shared-devicemanagementconfigurationsettinginstance.md)| |settingInstanceTemplateReference|[deviceManagementConfigurationSettingInstanceTemplateReference](../resources/intune-shared-devicemanagementconfigurationsettinginstancetemplatereference.md)|Setting Instance Template Reference Inherited from [deviceManagementConfigurationSettingInstance](../resources/intune-shared-devicemanagementconfigurationsettinginstance.md)|-|groupSettingValue|[deviceManagementConfigurationGroupSettingValue](../resources/intune-mam-devicemanagementconfigurationgroupsettingvalue.md)|GroupSetting value| +|groupSettingValue|[deviceManagementConfigurationGroupSettingValue](../resources/intune-shared-devicemanagementconfigurationgroupsettingvalue.md)|GroupSetting value| ## Relationships None Here is a JSON representation of the resource. ] } }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationgroupsettingvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-devicemanagementconfigurationgroupsettingvalue.md | Namespace: microsoft.graph Value of the GroupSetting -Inherits from [deviceManagementConfigurationSettingValue](../resources/intune-mam-devicemanagementconfigurationsettingvalue.md) +Inherits from [deviceManagementConfigurationSettingValue](../resources/intune-shared-devicemanagementconfigurationsettingvalue.md) ## Properties |Property|Type|Description| Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationsetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-devicemanagementconfigurationsetting.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.deviceManagementConfigurationSetting" }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationsettingapplicability | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-devicemanagementconfigurationsettingapplicability.md | Not yet documented |description|String|description of the setting| |platform|[deviceManagementConfigurationPlatforms](../resources/intune-shared-devicemanagementconfigurationplatforms.md)|Platform setting can be applied on. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.| |deviceMode|[deviceManagementConfigurationDeviceMode](../resources/intune-shared-devicemanagementconfigurationdevicemode.md)|Device Mode that setting can be applied on. Possible values are: `none`, `kiosk`.|-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-mam-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `unknownFutureValue`.| +|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-shared-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `unknownFutureValue`.| ## Relationships None Here is a JSON representation of the resource. "deviceMode": "String", "technologies": "String" }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationsettinggroupcollectiondefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-devicemanagementconfigurationsettinggroupcollectiondefinition.md | Here is a JSON representation of the resource. "maximumCount": 1024, "minimumCount": 1024 }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationsimplesettingcollectiondefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-devicemanagementconfigurationsimplesettingcollectiondefinition.md | Here is a JSON representation of the resource. "maximumCount": 1024, "minimumCount": 1024 }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationsimplesettingcollectioninstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-devicemanagementconfigurationsimplesettingcollectioninstance.md | Inherits from [deviceManagementConfigurationSettingInstance](../resources/intune |:|:|:| |settingDefinitionId|String|Setting Definition Id Inherited from [deviceManagementConfigurationSettingInstance](../resources/intune-shared-devicemanagementconfigurationsettinginstance.md)| |settingInstanceTemplateReference|[deviceManagementConfigurationSettingInstanceTemplateReference](../resources/intune-shared-devicemanagementconfigurationsettinginstancetemplatereference.md)|Setting Instance Template Reference Inherited from [deviceManagementConfigurationSettingInstance](../resources/intune-shared-devicemanagementconfigurationsettinginstance.md)|-|simpleSettingCollectionValue|[deviceManagementConfigurationSimpleSettingValue](../resources/intune-mam-devicemanagementconfigurationsimplesettingvalue.md) collection|Simple setting collection instance value| +|simpleSettingCollectionValue|[deviceManagementConfigurationSimpleSettingValue](../resources/intune-shared-devicemanagementconfigurationsimplesettingvalue.md) collection|Simple setting collection instance value| ## Relationships None Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationsimplesettinginstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-devicemanagementconfigurationsimplesettinginstance.md | Inherits from [deviceManagementConfigurationSettingInstance](../resources/intune |:|:|:| |settingDefinitionId|String|Setting Definition Id Inherited from [deviceManagementConfigurationSettingInstance](../resources/intune-shared-devicemanagementconfigurationsettinginstance.md)| |settingInstanceTemplateReference|[deviceManagementConfigurationSettingInstanceTemplateReference](../resources/intune-shared-devicemanagementconfigurationsettinginstancetemplatereference.md)|Setting Instance Template Reference Inherited from [deviceManagementConfigurationSettingInstance](../resources/intune-shared-devicemanagementconfigurationsettinginstance.md)|-|simpleSettingValue|[deviceManagementConfigurationSimpleSettingValue](../resources/intune-mam-devicemanagementconfigurationsimplesettingvalue.md)|Simple setting instance value| +|simpleSettingValue|[deviceManagementConfigurationSimpleSettingValue](../resources/intune-shared-devicemanagementconfigurationsimplesettingvalue.md)|Simple setting instance value| ## Relationships None Here is a JSON representation of the resource. "@odata.type": "microsoft.graph.deviceManagementConfigurationSimpleSettingValue" } }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationsimplesettingvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-devicemanagementconfigurationsimplesettingvalue.md | Namespace: microsoft.graph Simple setting value -Inherits from [deviceManagementConfigurationSettingValue](../resources/intune-mam-devicemanagementconfigurationsettingvalue.md) +Inherits from [deviceManagementConfigurationSettingValue](../resources/intune-shared-devicemanagementconfigurationsettingvalue.md) ## Properties |Property|Type|Description| Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.deviceManagementConfigurationSimpleSettingValue" }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationstringformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-devicemanagementconfigurationstringformat.md | Not yet documented |regEx|11|Not yet documented| |json|12|Not yet documented| |dateTime|13|Not yet documented|-|surfaceHub|14|Not yet documented| +|surfaceHub|14|Not yet documented| |
v1.0 | Intune Mam Devicemanagementconfigurationstringsettingvaluedefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-devicemanagementconfigurationstringsettingvaluedefinition.md | Inherits from [deviceManagementConfigurationSettingValueDefinition](../resources ## Properties |Property|Type|Description| |:|:|:|-|format|[deviceManagementConfigurationStringFormat](../resources/intune-mam-devicemanagementconfigurationstringformat.md)|Pre-defined format of the string. Possible values are: `none`, `email`, `guid`, `ip`, `base64`, `url`, `version`, `xml`, `date`, `time`, `binary`, `regEx`, `json`, `dateTime`, `surfaceHub`.| +|format|[deviceManagementConfigurationStringFormat](../resources/intune-shared-devicemanagementconfigurationstringformat.md)|Pre-defined format of the string. Possible values are: `none`, `email`, `guid`, `ip`, `base64`, `url`, `version`, `xml`, `date`, `time`, `binary`, `regEx`, `json`, `dateTime`, `surfaceHub`.| |inputValidationSchema|String|Regular expression or any xml or json schema that the input string should match| |maximumLength|Int64|Maximum length of string| |minimumLength|Int64|Minimum length of string| Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Mam Devicemanagementconfigurationtechnologies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-devicemanagementconfigurationtechnologies.md | Describes which technology this setting can be deployed with |microsoftSense|128|Setting can be deployed through the SENSE agent channel| |exchangeOnline|256|Setting can be deployed through the Exchange Online agent channel| |linuxMdm|1024|Setting can be deployed through the Linux Mdm channel|-|unknownFutureValue|1073741824|Sentinel member for cases where the client cannot handle the new enum values.| +|unknownFutureValue|1073741824|Sentinel member for cases where the client cannot handle the new enum values.| |
v1.0 | Intune Mam Devicemanagementconfigurationwindowssettingapplicability | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-devicemanagementconfigurationwindowssettingapplicability.md | Namespace: microsoft.graph Not yet documented -Inherits from [deviceManagementConfigurationSettingApplicability](../resources/intune-mam-devicemanagementconfigurationsettingapplicability.md) +Inherits from [deviceManagementConfigurationSettingApplicability](../resources/intune-shared-devicemanagementconfigurationsettingapplicability.md) ## Properties |Property|Type|Description| |:|:|:|-|description|String|description of the setting Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-mam-devicemanagementconfigurationsettingapplicability.md)| -|platform|[deviceManagementConfigurationPlatforms](../resources/intune-shared-devicemanagementconfigurationplatforms.md)|Platform setting can be applied on Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-mam-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.| -|deviceMode|[deviceManagementConfigurationDeviceMode](../resources/intune-shared-devicemanagementconfigurationdevicemode.md)|Device Mode that setting can be applied on Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-mam-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `kiosk`.| -|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-mam-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-mam-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `unknownFutureValue`.| +|description|String|description of the setting Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-shared-devicemanagementconfigurationsettingapplicability.md)| +|platform|[deviceManagementConfigurationPlatforms](../resources/intune-shared-devicemanagementconfigurationplatforms.md)|Platform setting can be applied on Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-shared-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.| +|deviceMode|[deviceManagementConfigurationDeviceMode](../resources/intune-shared-devicemanagementconfigurationdevicemode.md)|Device Mode that setting can be applied on Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-shared-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `kiosk`.| +|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-shared-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-shared-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `unknownFutureValue`.| |configurationServiceProviderVersion|String|Version of CSP setting is a part of| |maximumSupportedVersion|String|Maximum supported version of Windows| |minimumSupportedVersion|String|Minimum supported version of Windows| Here is a JSON representation of the resource. "requiresAzureAd": true, "requiredAzureAdTrustType": "String" }-``` +``` |
v1.0 | Intune Mam Devicemanagementreports | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-devicemanagementreports.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagementReports", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Mam Iosmanagedappprotection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-iosmanagedappprotection.md | Inherits from [targetedManagedAppProtection](../resources/intune-mam-targetedman ## Methods |Method|Return Type|Description| |:|:|:|-|[List iosManagedAppProtections](../api/intune-mam-iosmanagedappprotection-list.md)|[iosManagedAppProtection](../resources/intune-mam-iosmanagedappprotection.md) collection|List properties and relationships of the [iosManagedAppProtection](../resources/intune-mam-iosmanagedappprotection.md) objects.| -|[Get iosManagedAppProtection](../api/intune-mam-iosmanagedappprotection-get.md)|[iosManagedAppProtection](../resources/intune-mam-iosmanagedappprotection.md)|Read properties and relationships of the [iosManagedAppProtection](../resources/intune-mam-iosmanagedappprotection.md) object.| -|[Create iosManagedAppProtection](../api/intune-mam-iosmanagedappprotection-create.md)|[iosManagedAppProtection](../resources/intune-mam-iosmanagedappprotection.md)|Create a new [iosManagedAppProtection](../resources/intune-mam-iosmanagedappprotection.md) object.| -|[Delete iosManagedAppProtection](../api/intune-mam-iosmanagedappprotection-delete.md)|None|Deletes a [iosManagedAppProtection](../resources/intune-mam-iosmanagedappprotection.md).| -|[Update iosManagedAppProtection](../api/intune-mam-iosmanagedappprotection-update.md)|[iosManagedAppProtection](../resources/intune-mam-iosmanagedappprotection.md)|Update the properties of a [iosManagedAppProtection](../resources/intune-mam-iosmanagedappprotection.md) object.| +|[List iosManagedAppProtections](../api/intune-mam-iosmanagedappprotection-list.md)|[iosManagedAppProtection](../resources/intune-shared-iosmanagedappprotection.md) collection|List properties and relationships of the [iosManagedAppProtection](../resources/intune-shared-iosmanagedappprotection.md) objects.| +|[Get iosManagedAppProtection](../api/intune-mam-iosmanagedappprotection-get.md)|[iosManagedAppProtection](../resources/intune-shared-iosmanagedappprotection.md)|Read properties and relationships of the [iosManagedAppProtection](../resources/intune-shared-iosmanagedappprotection.md) object.| +|[Create iosManagedAppProtection](../api/intune-mam-iosmanagedappprotection-create.md)|[iosManagedAppProtection](../resources/intune-shared-iosmanagedappprotection.md)|Create a new [iosManagedAppProtection](../resources/intune-shared-iosmanagedappprotection.md) object.| +|[Delete iosManagedAppProtection](../api/intune-mam-iosmanagedappprotection-delete.md)|None|Deletes a [iosManagedAppProtection](../resources/intune-shared-iosmanagedappprotection.md).| +|[Update iosManagedAppProtection](../api/intune-mam-iosmanagedappprotection-update.md)|[iosManagedAppProtection](../resources/intune-shared-iosmanagedappprotection.md)|Update the properties of a [iosManagedAppProtection](../resources/intune-shared-iosmanagedappprotection.md) object.| ## Properties |Property|Type|Description| Inherits from [targetedManagedAppProtection](../resources/intune-mam-targetedman |minimumWipeSdkVersion|String|Versions less than the specified version will block the managed app from accessing company data.| |allowedIosDeviceModels|String|Semicolon seperated list of device models allowed, as a string, for the managed app to work.| |appActionIfIosDeviceModelNotAllowed|[managedAppRemediationAction](../resources/intune-mam-managedappremediationaction.md)|Defines a managed app behavior, either block or wipe, if the specified device model is not allowed. Possible values are: `block`, `wipe`, `warn`.|+|appActionIfAccountIsClockedOut|[managedAppRemediationAction](../resources/intune-mam-managedappremediationaction.md)|Defines a managed app behavior, either block or warn, if the user is clocked out (non-working time). Possible values are: `block`, `wipe`, `warn`.| |thirdPartyKeyboardsBlocked|Boolean|Defines if third party keyboards are allowed while accessing a managed app| |filterOpenInToOnlyManagedApps|Boolean|Defines if open-in operation is supported from the managed app to the filesharing locations selected. This setting only applies when AllowedOutboundDataTransferDestinations is set to ManagedApps and DisableProtectionOfManagedOutboundOpenInData is set to False.| |disableProtectionOfManagedOutboundOpenInData|Boolean|Disable protection of data transferred to other apps through IOS OpenIn option. This setting is only allowed to be True when AllowedOutboundDataTransferDestinations is set to ManagedApps.| Here is a JSON representation of the resource. "minimumWipeSdkVersion": "String", "allowedIosDeviceModels": "String", "appActionIfIosDeviceModelNotAllowed": "String",+ "appActionIfAccountIsClockedOut": "String", "thirdPartyKeyboardsBlocked": true, "filterOpenInToOnlyManagedApps": true, "disableProtectionOfManagedOutboundOpenInData": true, Here is a JSON representation of the resource. "minimumWarningSdkVersion": "String", "messagingRedirectAppUrlScheme": "String" }-``` +``` |
v1.0 | Intune Mam Iosmanagedappregistration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-iosmanagedappregistration.md | Here is a JSON representation of the resource. "id": "String (identifier)", "version": "String" }-``` +``` |
v1.0 | Intune Mam Iosmobileappidentifier | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-iosmobileappidentifier.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.iosMobileAppIdentifier", "bundleId": "String" }-``` +``` |
v1.0 | Intune Mam Json | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-json.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.Json" }-``` +``` |
v1.0 | Intune Mam Keyvaluepair | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-keyvaluepair.md | Here is a JSON representation of the resource. "name": "String", "value": "String" }-``` +``` |
v1.0 | Intune Mam Macappidentifier | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-macappidentifier.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.macAppIdentifier", "bundleId": "String" }-``` +``` |
v1.0 | Intune Mam Managedappclipboardsharinglevel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedappclipboardsharinglevel.md | Represents the level to which the device's clipboard may be shared between apps |allApps|0|Sharing is allowed between all apps, managed or not| |managedAppsWithPasteIn|1|Sharing is allowed between all managed apps with paste in enabled| |managedApps|2|Sharing is allowed between all managed apps|-|blocked|3|Sharing between apps is disabled| +|blocked|3|Sharing between apps is disabled| |
v1.0 | Intune Mam Managedappconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedappconfiguration.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Mam Managedappdataencryptiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedappdataencryptiontype.md | Represents the level to which app data is encrypted for managed apps |useDeviceSettings|0|App data is encrypted based on the default settings on the device.| |afterDeviceRestart|1|App data is encrypted when the device is restarted.| |whenDeviceLockedExceptOpenFiles|2|App data associated with this policy is encrypted when the device is locked, except data in files that are open|-|whenDeviceLocked|3|App data associated with this policy is encrypted when the device is locked| +|whenDeviceLocked|3|App data associated with this policy is encrypted when the device is locked| |
v1.0 | Intune Mam Managedappdataingestionlocation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedappdataingestionlocation.md | Locations which can be used to bring data into organization documents |oneDriveForBusiness|1|OneDrive for business| |sharePoint|2|SharePoint Online| |camera|3|The device's camera|-|photoLibrary|4|The device's photo library| +|photoLibrary|4|The device's photo library| |
v1.0 | Intune Mam Managedappdatastoragelocation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedappdatastoragelocation.md | Storage locations where managed apps can potentially store their data |sharePoint|2|SharePoint| |box|3|Box| |localStorage|6|Local storage on the device|-|photoLibrary|7|The device's photo library| +|photoLibrary|7|The device's photo library| |
v1.0 | Intune Mam Managedappdatatransferlevel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedappdatatransferlevel.md | Data can be transferred from/to these classes of apps |:|:|:| |allApps|0|All apps.| |managedApps|1|Managed apps.|-|none|2|No apps.| +|none|2|No apps.| |
v1.0 | Intune Mam Managedappdevicethreatlevel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedappdevicethreatlevel.md | The maxium threat level allowed for an app to be compliant. |secured|1|Device needs to have no threat| |low|2|Device needs to have a low threat.| |medium|3|Device needs to have not more than medium threat.|-|high|4|Device needs to have not more than high threat| +|high|4|Device needs to have not more than high threat| |
v1.0 | Intune Mam Managedappdiagnosticstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedappdiagnosticstatus.md | Here is a JSON representation of the resource. "state": "String", "mitigationInstruction": "String" }-``` +``` |
v1.0 | Intune Mam Managedappflaggedreason | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedappflaggedreason.md | The reason for which a user has been flagged |none|0|No issue.| |rootedDevice|1|The app registration is running on a rooted/unlocked device.| |androidBootloaderUnlocked|2|The app registration is running on an Android device on which the bootloader is unlocked.|-|androidFactoryRomModified|3|The app registration is running on an Android device on which the factory ROM has been modified.| +|androidFactoryRomModified|3|The app registration is running on an Android device on which the factory ROM has been modified.| |
v1.0 | Intune Mam Managedapplogcollectionrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedapplogcollectionrequest.md | The Managed App log collection response |Property|Type|Description| |:|:|:| |id|String|The unique identifier of the managed app log collection request. This id is assigned during request creation time. Read-only.|-|managedAppRegistrationId|String|The unique identifier of the app instance for which diagnostic was collected.| +|managedAppRegistrationId|String|The unique identifier of the app instance for which diagnostic logs were collected. Read-only.| |status|String|Indicates the status for the app log collection request - pending, completed or failed. Default is pending.|-|requestedBy|String|The user principal name associated with the request for the managed application log collection.| +|requestedBy|String|The user principal name associated with the request for the managed application log collection. Read-only.| +|requestedByUserPrincipalName|String|The user principal name associated with the request for the managed application log collection. Read-only.| |requestedDateTime|DateTimeOffset|DateTime of when the log upload request was received. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Returned by default. Read-only.| |completedDateTime|DateTimeOffset|DateTime of when the log upload request was completed. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Returned by default. Read-only.|-|userLogUploadConsent|[managedAppLogUploadConsent](../resources/intune-mam-managedapploguploadconsent.md)|Indicates whether the user associated with the device provided consent for the log collection. Possible values are: `default`, `declined`, `accepted`, `unknownFutureValue`.| -|uploadedLogs|[managedAppLogUpload](../resources/intune-mam-managedapplogupload.md) collection|The collection of log upload results as reported by each component on the device. Such components can be the application itself, the Mobile Application Management (MAM) SDK, and other on-device components that are requested to upload diagnostic logs.| +|userLogUploadConsent|[managedAppLogUploadConsent](../resources/intune-mam-managedapploguploadconsent.md)|Indicates whether the user associated with the device provided consent for the log collection. The user must consent before the diagnostic logs can be collected. accepted means the user consented. declined means the user declined. unknown is the default value. The Log Collection Request must be completed within 24 hours or it will be abandoned and deleted. Read-only. Possible values are: `unknown`, `declined`, `accepted`, `unknownFutureValue`.| +|uploadedLogs|[managedAppLogUpload](../resources/intune-mam-managedapplogupload.md) collection|The collection of log upload results as reported by each component on the device. Such components can be the application itself, the Mobile Application Management (MAM) SDK, and other on-device components that are requested to upload diagnostic logs. Read-only.| |version|String|Version of the entity.| ## Relationships Here is a JSON representation of the resource. "managedAppRegistrationId": "String", "status": "String", "requestedBy": "String",+ "requestedByUserPrincipalName": "String", "requestedDateTime": "String (timestamp)", "completedDateTime": "String (timestamp)", "userLogUploadConsent": "String", Here is a JSON representation of the resource. { "@odata.type": "microsoft.graph.managedAppLogUpload", "managedAppComponent": "String",+ "managedAppComponentDescription": "String", "status": "String", "referenceId": "String" } ], "version": "String" }-``` +``` |
v1.0 | Intune Mam Managedapplogupload | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedapplogupload.md | A `managedAppLogUpload` represents the log upload result for a given Mobile Appl ## Properties |Property|Type|Description| |:|:|:|-|managedAppComponent|String|The Mobile Application Management (MAM) Logs Uploading Component.| -|status|[managedAppLogUploadState](../resources/intune-mam-managedapploguploadstate.md)|The status of the log upload. Possible values are: `pending`, `partiallyCompleted`, `completed`, `cancelled`, `cancelledByUser`, `timedOut`, `failed`, `unknownFutureValue`.| -|referenceId|String|A provider-specific reference id for the uploaded logs.| +|managedAppComponent|String|The Mobile Application Management (MAM) Logs Uploading Component. Such components can be the application itself, the MAM SDK, and other on-device components that are capable of uploading diagnostic logs. Read-only.| +|managedAppComponentDescription|String|The Mobile Application Management (MAM) Logs Uploading Component. Such components can be the application itself, the MAM SDK, and other on-device components that are capable of uploading diagnostic logs. Read-only.| +|status|[managedAppLogUploadState](../resources/intune-mam-managedapploguploadstate.md)|The status of the log upload. If a result is present, the log collection is complete and the upload status for the component is final. completed is the default value. Read-only. Possible values are: `pending`, `inProgress`, `completed`, `declinedByUser`, `timedOut`, `failed`, `unknownFutureValue`.| +|referenceId|String|A provider-specific reference id for the uploaded logs. Read-only.| ## Relationships None Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.managedAppLogUpload", "managedAppComponent": "String",+ "managedAppComponentDescription": "String", "status": "String", "referenceId": "String" }-``` +``` |
v1.0 | Intune Mam Managedapploguploadconsent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedapploguploadconsent.md | Represents the current consent status of the associated `managedAppLogCollection ## Members |Member|Value|Description| |:|:|:|-|default|0|The Default state. This state is automatically assigned at request creation time, and is updated when the User Accepts or Declines the log collection request.| -|declined|1|The User has Declined the Log Collection Request. Log uploads will not occur and the request will be abandoned.| -|accepted|2|The User has Accepted the Log Collection Request. Log uploads will occur.| -|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| +|unknown|0|Default. Indicates app log consent state is 'Unknown'. This state is automatically assigned at request creation time and is updated when the log collection completes.| +|declined|1|The User has Declined the Log Collection Request. The Log collection and uploads will not be initiated/triggered, and the log collection request will be abandoned.| +|accepted|2|The User has Accepted the Log Collection Request. The log collection and upload will be initiated.| +|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Mam Managedapploguploadstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedapploguploadstate.md | Represents the current status of the associated `managedAppLogCollectionRequest` ## Members |Member|Value|Description| |:|:|:|-|pending|0|The log upload request has been successfully created, and is pending delivery to the Mobile Application Management (MAM) application.| -|partiallyCompleted|1|One or more log upload components have uploaded their logs.| -|completed|2|All log upload successfully components have uploaded their logs| -|cancelled|3|The log upload request was cancelled by the requestor| -|cancelledByUser|4|The log upload request was cancelled by the user on the device| -|timedOut|5|The log upload request was not acknowledged by the user within the allowed time window| -|failed|6|The log upload request encountered an error| -|unknownFutureValue|7|Evolvable enumeration sentinel value. Do not use| +|pending|0|Default. The log upload request has been successfully created, and is pending delivery to the Mobile Application Management (MAM) application.| +|inProgress|1|One or more log upload components have uploaded their logs.| +|completed|2|All log upload successfully components have uploaded their logs.| +|declinedByUser|4|The log upload request was declined by the user on the device.| +|timedOut|5|The log upload request was not acknowledged by the user within the allowed time window.| +|failed|6|The log upload request encountered an error.| +|unknownFutureValue|7|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Mam Managedappnotificationrestriction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedappnotificationrestriction.md | Restrict managed app notification |:|:|:| |allow|0|Share all notifications.| |blockOrganizationalData|1|Do not share Orgnizational data in notifications.|-|block|2|Do not share notifications.| +|block|2|Do not share notifications.| |
v1.0 | Intune Mam Managedappoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedappoperation.md | Here is a JSON representation of the resource. "id": "String (identifier)", "version": "String" }-``` +``` |
v1.0 | Intune Mam Managedappphonenumberredirectlevel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedappphonenumberredirectlevel.md | The classes of apps that are allowed to click-to-open a phone number, for making |allApps|0|Sharing is allowed to all apps.| |managedApps|1|Sharing is allowed to all managed apps.| |customApp|2|Sharing is allowed to a custom app.|-|blocked|3|Sharing between apps is blocked.| +|blocked|3|Sharing between apps is blocked.| |
v1.0 | Intune Mam Managedapppincharacterset | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedapppincharacterset.md | Character set which is to be used for a user's app PIN |Member|Value|Description| |:|:|:| |numeric|0|Numeric characters|-|alphanumericAndSymbol|1|Alphanumeric and symbolic characters| +|alphanumericAndSymbol|1|Alphanumeric and symbolic characters| |
v1.0 | Intune Mam Managedapppolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedapppolicy.md | Here is a JSON representation of the resource. "id": "String (identifier)", "version": "String" }-``` +``` |
v1.0 | Intune Mam Managedapppolicydeploymentsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedapppolicydeploymentsummary.md | Here is a JSON representation of the resource. "id": "String (identifier)", "version": "String" }-``` +``` |
v1.0 | Intune Mam Managedapppolicydeploymentsummaryperapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedapppolicydeploymentsummaryperapp.md | Here is a JSON representation of the resource. }, "configurationAppliedUserCount": 1024 }-``` +``` |
v1.0 | Intune Mam Managedappprotection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedappprotection.md | Here is a JSON representation of the resource. "gracePeriodToBlockAppsDuringOffClockHours": "String (duration)", "protectedMessagingRedirectAppType": "String" }-``` +``` |
v1.0 | Intune Mam Managedappregistration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedappregistration.md | Here is a JSON representation of the resource. "id": "String (identifier)", "version": "String" }-``` +``` |
v1.0 | Intune Mam Managedappremediationaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedappremediationaction.md | An admin initiated action to be applied on a managed app. |:|:|:| |block|0|app and the corresponding company data to be blocked| |wipe|1|app and the corresponding company data to be wiped|-|warn|2|app and the corresponding user to be warned| +|warn|2|app and the corresponding user to be warned| |
v1.0 | Intune Mam Managedappstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedappstatus.md | Here is a JSON representation of the resource. "id": "String (identifier)", "version": "String" }-``` +``` |
v1.0 | Intune Mam Managedappstatusraw | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedappstatusraw.md | Here is a JSON representation of the resource. "@odata.type": "microsoft.graph.Json" } }-``` +``` |
v1.0 | Intune Mam Managedbrowsertype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedbrowsertype.md | Type of managed browser |Member|Value|Description| |:|:|:| |notConfigured|0|Not configured|-|microsoftEdge|1|Microsoft Edge| +|microsoftEdge|1|Microsoft Edge| |
v1.0 | Intune Mam Managedmobileapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-managedmobileapp.md | Here is a JSON representation of the resource. "id": "String (identifier)", "version": "String" }-``` +``` |
v1.0 | Intune Mam Mdmwindowsinformationprotectionpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-mdmwindowsinformationprotectionpolicy.md | Inherits from [windowsInformationProtection](../resources/intune-mam-windowsinfo ## Methods |Method|Return Type|Description| |:|:|:|-|[List mdmWindowsInformationProtectionPolicies](../api/intune-mam-mdmwindowsinformationprotectionpolicy-list.md)|[mdmWindowsInformationProtectionPolicy](../resources/intune-mam-mdmwindowsinformationprotectionpolicy.md) collection|List properties and relationships of the [mdmWindowsInformationProtectionPolicy](../resources/intune-mam-mdmwindowsinformationprotectionpolicy.md) objects.| -|[Get mdmWindowsInformationProtectionPolicy](../api/intune-mam-mdmwindowsinformationprotectionpolicy-get.md)|[mdmWindowsInformationProtectionPolicy](../resources/intune-mam-mdmwindowsinformationprotectionpolicy.md)|Read properties and relationships of the [mdmWindowsInformationProtectionPolicy](../resources/intune-mam-mdmwindowsinformationprotectionpolicy.md) object.| -|[Create mdmWindowsInformationProtectionPolicy](../api/intune-mam-mdmwindowsinformationprotectionpolicy-create.md)|[mdmWindowsInformationProtectionPolicy](../resources/intune-mam-mdmwindowsinformationprotectionpolicy.md)|Create a new [mdmWindowsInformationProtectionPolicy](../resources/intune-mam-mdmwindowsinformationprotectionpolicy.md) object.| -|[Delete mdmWindowsInformationProtectionPolicy](../api/intune-mam-mdmwindowsinformationprotectionpolicy-delete.md)|None|Deletes a [mdmWindowsInformationProtectionPolicy](../resources/intune-mam-mdmwindowsinformationprotectionpolicy.md).| -|[Update mdmWindowsInformationProtectionPolicy](../api/intune-mam-mdmwindowsinformationprotectionpolicy-update.md)|[mdmWindowsInformationProtectionPolicy](../resources/intune-mam-mdmwindowsinformationprotectionpolicy.md)|Update the properties of a [mdmWindowsInformationProtectionPolicy](../resources/intune-mam-mdmwindowsinformationprotectionpolicy.md) object.| +|[List mdmWindowsInformationProtectionPolicies](../api/intune-mam-mdmwindowsinformationprotectionpolicy-list.md)|[mdmWindowsInformationProtectionPolicy](../resources/intune-shared-mdmwindowsinformationprotectionpolicy.md) collection|List properties and relationships of the [mdmWindowsInformationProtectionPolicy](../resources/intune-shared-mdmwindowsinformationprotectionpolicy.md) objects.| +|[Get mdmWindowsInformationProtectionPolicy](../api/intune-mam-mdmwindowsinformationprotectionpolicy-get.md)|[mdmWindowsInformationProtectionPolicy](../resources/intune-shared-mdmwindowsinformationprotectionpolicy.md)|Read properties and relationships of the [mdmWindowsInformationProtectionPolicy](../resources/intune-shared-mdmwindowsinformationprotectionpolicy.md) object.| +|[Create mdmWindowsInformationProtectionPolicy](../api/intune-mam-mdmwindowsinformationprotectionpolicy-create.md)|[mdmWindowsInformationProtectionPolicy](../resources/intune-shared-mdmwindowsinformationprotectionpolicy.md)|Create a new [mdmWindowsInformationProtectionPolicy](../resources/intune-shared-mdmwindowsinformationprotectionpolicy.md) object.| +|[Delete mdmWindowsInformationProtectionPolicy](../api/intune-mam-mdmwindowsinformationprotectionpolicy-delete.md)|None|Deletes a [mdmWindowsInformationProtectionPolicy](../resources/intune-shared-mdmwindowsinformationprotectionpolicy.md).| +|[Update mdmWindowsInformationProtectionPolicy](../api/intune-mam-mdmwindowsinformationprotectionpolicy-update.md)|[mdmWindowsInformationProtectionPolicy](../resources/intune-shared-mdmwindowsinformationprotectionpolicy.md)|Update the properties of a [mdmWindowsInformationProtectionPolicy](../resources/intune-shared-mdmwindowsinformationprotectionpolicy.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. ], "isAssigned": true }-``` +``` |
v1.0 | Intune Mam Messagingredirectapptype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-messagingredirectapptype.md | Defines how app messaging redirection is protected by an App Protection Policy. |anyApp|0|App protection policy will allow messaging redirection to any app.| |anyManagedApp|1|App protection policy will allow messaging redirection to any managed application.| |specificApps|2|App protection policy will allow messaging redirection only to specified applications in related App protection policy settings. See related settings `messagingRedirectAppDisplayName`, `messagingRedirectAppPackageId` and `messagingRedirectAppUrlScheme`.|-|blocked|3|App protection policy will block messaging redirection to any app.| +|blocked|3|App protection policy will block messaging redirection to any app.| |
v1.0 | Intune Mam Mobileappidentifier | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-mobileappidentifier.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.mobileAppIdentifier" }-``` +``` |
v1.0 | Intune Mam Mobilethreatdefensepartnerpriority | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-mobilethreatdefensepartnerpriority.md | Determines the conflict resolution strategy, when more than one Mobile Threat De |:|:|:| |defenderOverThirdPartyPartner|0|Indicates use of Microsoft Defender Endpoint over 3rd party MTD connectors| |thirdPartyPartnerOverDefender|1|Indicates use of a 3rd party MTD connector over Microsoft Defender Endpoint|-|unknownFutureValue|2|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|2|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Mam Targetedmanagedappconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-targetedmanagedappconfiguration.md | Inherits from [managedAppConfiguration](../resources/intune-mam-managedappconfig ## Methods |Method|Return Type|Description| |:|:|:|-|[List targetedManagedAppConfigurations](../api/intune-mam-targetedmanagedappconfiguration-list.md)|[targetedManagedAppConfiguration](../resources/intune-mam-targetedmanagedappconfiguration.md) collection|List properties and relationships of the [targetedManagedAppConfiguration](../resources/intune-mam-targetedmanagedappconfiguration.md) objects.| -|[Get targetedManagedAppConfiguration](../api/intune-mam-targetedmanagedappconfiguration-get.md)|[targetedManagedAppConfiguration](../resources/intune-mam-targetedmanagedappconfiguration.md)|Read properties and relationships of the [targetedManagedAppConfiguration](../resources/intune-mam-targetedmanagedappconfiguration.md) object.| -|[Create targetedManagedAppConfiguration](../api/intune-mam-targetedmanagedappconfiguration-create.md)|[targetedManagedAppConfiguration](../resources/intune-mam-targetedmanagedappconfiguration.md)|Create a new [targetedManagedAppConfiguration](../resources/intune-mam-targetedmanagedappconfiguration.md) object.| -|[Delete targetedManagedAppConfiguration](../api/intune-mam-targetedmanagedappconfiguration-delete.md)|None|Deletes a [targetedManagedAppConfiguration](../resources/intune-mam-targetedmanagedappconfiguration.md).| -|[Update targetedManagedAppConfiguration](../api/intune-mam-targetedmanagedappconfiguration-update.md)|[targetedManagedAppConfiguration](../resources/intune-mam-targetedmanagedappconfiguration.md)|Update the properties of a [targetedManagedAppConfiguration](../resources/intune-mam-targetedmanagedappconfiguration.md) object.| +|[List targetedManagedAppConfigurations](../api/intune-mam-targetedmanagedappconfiguration-list.md)|[targetedManagedAppConfiguration](../resources/intune-shared-targetedmanagedappconfiguration.md) collection|List properties and relationships of the [targetedManagedAppConfiguration](../resources/intune-shared-targetedmanagedappconfiguration.md) objects.| +|[Get targetedManagedAppConfiguration](../api/intune-mam-targetedmanagedappconfiguration-get.md)|[targetedManagedAppConfiguration](../resources/intune-shared-targetedmanagedappconfiguration.md)|Read properties and relationships of the [targetedManagedAppConfiguration](../resources/intune-shared-targetedmanagedappconfiguration.md) object.| +|[Create targetedManagedAppConfiguration](../api/intune-mam-targetedmanagedappconfiguration-create.md)|[targetedManagedAppConfiguration](../resources/intune-shared-targetedmanagedappconfiguration.md)|Create a new [targetedManagedAppConfiguration](../resources/intune-shared-targetedmanagedappconfiguration.md) object.| +|[Delete targetedManagedAppConfiguration](../api/intune-mam-targetedmanagedappconfiguration-delete.md)|None|Deletes a [targetedManagedAppConfiguration](../resources/intune-shared-targetedmanagedappconfiguration.md).| +|[Update targetedManagedAppConfiguration](../api/intune-mam-targetedmanagedappconfiguration-update.md)|[targetedManagedAppConfiguration](../resources/intune-shared-targetedmanagedappconfiguration.md)|Update the properties of a [targetedManagedAppConfiguration](../resources/intune-shared-targetedmanagedappconfiguration.md) object.| |[assign action](../api/intune-mam-targetedmanagedappconfiguration-assign.md)|None|| |[changeSettings action](../api/intune-mam-targetedmanagedappconfiguration-changesettings.md)|None|| |[targetApps action](../api/intune-mam-targetedmanagedappconfiguration-targetapps.md)|None|| Here is a JSON representation of the resource. "targetedAppManagementLevels": "String", "appGroupType": "String" }-``` +``` |
v1.0 | Intune Mam Targetedmanagedappgrouptype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-targetedmanagedappgrouptype.md | Indicates a collection of apps to target which can be one of several pre-defined |selectedPublicApps|0|Target the collection of apps manually selected by the admin.| |allCoreMicrosoftApps|1|Target the core set of Microsoft apps (Office, Edge, etc).| |allMicrosoftApps|2|Target all apps with Microsoft as publisher.|-|allApps|4|Target all apps with an available assignment.| +|allApps|4|Target all apps with an available assignment.| |
v1.0 | Intune Mam Targetedmanagedapppolicyassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-targetedmanagedapppolicyassignment.md | Here is a JSON representation of the resource. "source": "String", "sourceId": "String" }-``` +``` |
v1.0 | Intune Mam Targetedmanagedappprotection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-targetedmanagedappprotection.md | Here is a JSON representation of the resource. "targetedAppManagementLevels": "String", "appGroupType": "String" }-``` +``` |
v1.0 | Intune Mam User | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-user.md | Represents an Azure Active Directory user object. ## Methods |Method|Return Type|Description| |:|:|:|-|[List users](../api/intune-mam-user-list.md)|[user](../resources/intune-mam-user.md) collection|List properties and relationships of the [user](../resources/intune-mam-user.md) objects.| -|[Get user](../api/intune-mam-user-get.md)|[user](../resources/intune-mam-user.md)|Read properties and relationships of the [user](../resources/intune-mam-user.md) object.| -|[Create user](../api/intune-mam-user-create.md)|[user](../resources/intune-mam-user.md)|Create a new [user](../resources/intune-mam-user.md) object.| -|[Delete user](../api/intune-mam-user-delete.md)|None|Deletes a [user](../resources/intune-mam-user.md).| -|[Update user](../api/intune-mam-user-update.md)|[user](../resources/intune-mam-user.md)|Update the properties of a [user](../resources/intune-mam-user.md) object.| +|[List users](../api/intune-mam-user-list.md)|[user](../resources/intune-shared-user.md) collection|List properties and relationships of the [user](../resources/intune-shared-user.md) objects.| +|[Get user](../api/intune-mam-user-get.md)|[user](../resources/intune-shared-user.md)|Read properties and relationships of the [user](../resources/intune-shared-user.md) object.| +|[Create user](../api/intune-mam-user-create.md)|[user](../resources/intune-shared-user.md)|Create a new [user](../resources/intune-shared-user.md) object.| +|[Delete user](../api/intune-mam-user-delete.md)|None|Deletes a [user](../resources/intune-shared-user.md).| +|[Update user](../api/intune-mam-user-update.md)|[user](../resources/intune-shared-user.md)|Update the properties of a [user](../resources/intune-shared-user.md) object.| |[getManagedAppDiagnosticStatuses function](../api/intune-mam-user-getmanagedappdiagnosticstatuses.md)|[managedAppDiagnosticStatus](../resources/intune-mam-managedappdiagnosticstatus.md) collection|Gets diagnostics validation status for a given user.| |[getManagedAppPolicies function](../api/intune-mam-user-getmanagedapppolicies.md)|[managedAppPolicy](../resources/intune-mam-managedapppolicy.md) collection|Gets app restrictions for a given user.| |[wipeManagedAppRegistrationByDeviceTag action](../api/intune-mam-user-wipemanagedappregistrationbydevicetag.md)|None|Issues a wipe operation on an app registration with specified device tag.| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.user", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Mam Windowsappidentifier | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-windowsappidentifier.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.windowsAppIdentifier", "windowsAppId": "String" }-``` +``` |
v1.0 | Intune Mam Windowsinformationprotection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-windowsinformationprotection.md | Here is a JSON representation of the resource. ], "isAssigned": true }-``` +``` |
v1.0 | Intune Mam Windowsinformationprotectionapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-windowsinformationprotectionapp.md | Here is a JSON representation of the resource. "productName": "String", "denied": true }-``` +``` |
v1.0 | Intune Mam Windowsinformationprotectionapplockerfile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-windowsinformationprotectionapplockerfile.md | Here is a JSON representation of the resource. "id": "String (identifier)", "version": "String" }-``` +``` |
v1.0 | Intune Mam Windowsinformationprotectiondatarecoverycertificate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-windowsinformationprotectiondatarecoverycertificate.md | Here is a JSON representation of the resource. "expirationDateTime": "String (timestamp)", "certificate": "binary" }-``` +``` |
v1.0 | Intune Mam Windowsinformationprotectiondesktopapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-windowsinformationprotectiondesktopapp.md | Here is a JSON representation of the resource. "binaryVersionLow": "String", "binaryVersionHigh": "String" }-``` +``` |
v1.0 | Intune Mam Windowsinformationprotectiondeviceregistration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-windowsinformationprotectiondeviceregistration.md | Here is a JSON representation of the resource. "deviceMacAddress": "String", "lastCheckInDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Mam Windowsinformationprotectionenforcementlevel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-windowsinformationprotectionenforcementlevel.md | Possible values for WIP Protection enforcement levels |noProtection|0|No protection enforcement| |encryptAndAuditOnly|1|Encrypt and Audit only| |encryptAuditAndPrompt|2|Encrypt, Audit and Prompt|-|encryptAuditAndBlock|3|Encrypt, Audit and Block| +|encryptAuditAndBlock|3|Encrypt, Audit and Block| |
v1.0 | Intune Mam Windowsinformationprotectioniprangecollection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-windowsinformationprotectioniprangecollection.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Mam Windowsinformationprotectionpincharacterrequirements | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-windowsinformationprotectionpincharacterrequirements.md | Pin Character Requirements |:|:|:| |notAllow|0|Not allow| |requireAtLeastOne|1|Require atleast one|-|allow|2|Allow any number| +|allow|2|Allow any number| |
v1.0 | Intune Mam Windowsinformationprotectionpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-windowsinformationprotectionpolicy.md | Here is a JSON representation of the resource. "minutesOfInactivityBeforeDeviceLock": 1024, "daysWithoutContactBeforeUnenroll": 1024 }-``` +``` |
v1.0 | Intune Mam Windowsinformationprotectionproxieddomaincollection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-windowsinformationprotectionproxieddomaincollection.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Mam Windowsinformationprotectionresourcecollection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-windowsinformationprotectionresourcecollection.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Mam Windowsinformationprotectionstoreapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-windowsinformationprotectionstoreapp.md | Here is a JSON representation of the resource. "productName": "String", "denied": true }-``` +``` |
v1.0 | Intune Mam Windowsinformationprotectionwipeaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-windowsinformationprotectionwipeaction.md | Here is a JSON representation of the resource. "targetedDeviceMacAddress": "String", "lastCheckInDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Mam Windowsmanagedappclipboardsharinglevel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-windowsmanagedappclipboardsharinglevel.md | Represents the level to which the device's clipboard may be shared between apps |Member|Value|Description| |:|:|:| |anyDestinationAnySource|0|Org users can paste data from and cut/copy data to any account, document, location or application.|-|none|1|Org users cannot cut, copy or paste data to or from external accounts, documents, locations or applications from or into the org context.| +|none|1|Org users cannot cut, copy or paste data to or from external accounts, documents, locations or applications from or into the org context.| |
v1.0 | Intune Mam Windowsmanagedappdatatransferlevel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-windowsmanagedappdatatransferlevel.md | Data can be transferred from/to these classes of apps |Member|Value|Description| |:|:|:| |allApps|0|All apps.|-|none|1|No apps.| +|none|1|No apps.| |
v1.0 | Intune Mam Windowsmanagedappprotection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-windowsmanagedappprotection.md | Inherits from [managedAppPolicy](../resources/intune-mam-managedapppolicy.md) |:|:|:| |assignments|[targetedManagedAppPolicyAssignment](../resources/intune-mam-targetedmanagedapppolicyassignment.md) collection|Navigation property to list of inclusion and exclusion groups to which the policy is deployed.| |apps|[managedMobileApp](../resources/intune-mam-managedmobileapp.md) collection|List of apps to which the policy is deployed.|+|deploymentSummary|[managedAppPolicyDeploymentSummary](../resources/intune-mam-managedapppolicydeploymentsummary.md)|Navigation property to deployment summary of the configuration.| ## JSON Representation Here is a JSON representation of the resource. Here is a JSON representation of the resource. "periodOfflineBeforeWipeIsEnforced": "String (duration)", "periodOfflineBeforeAccessCheck": "String (duration)" }-``` +``` |
v1.0 | Intune Mam Windowsmanagedappregistration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mam-windowsmanagedappregistration.md | Here is a JSON representation of the resource. "id": "String (identifier)", "version": "String" }-``` +``` |
v1.0 | Intune Mstunnel Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mstunnel-devicemanagement.md | Singleton that acts as container for a collection of Resource Access entities. ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-mstunnel-devicemanagement-get.md)|[deviceManagement](../resources/intune-mstunnel-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-mstunnel-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-mstunnel-devicemanagement-update.md)|[deviceManagement](../resources/intune-mstunnel-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-mstunnel-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-mstunnel-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-mstunnel-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Mstunnel Keyvaluepair | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mstunnel-keyvaluepair.md | Here is a JSON representation of the resource. "name": "String", "value": "String" }-``` +``` |
v1.0 | Intune Mstunnel Metrictimeseriesdatapoint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mstunnel-metrictimeseriesdatapoint.md | Here is a JSON representation of the resource. "dateTime": "String (timestamp)", "value": 1024 }-``` +``` |
v1.0 | Intune Mstunnel Microsofttunnelconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mstunnel-microsofttunnelconfiguration.md | Here is a JSON representation of the resource. ], "disableUdpConnections": true }-``` +``` |
v1.0 | Intune Mstunnel Microsofttunnelhealththreshold | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mstunnel-microsofttunnelhealththreshold.md | Here is a JSON representation of the resource. "defaultHealthyThreshold": 1024, "defaultUnhealthyThreshold": 1024 }-``` +``` |
v1.0 | Intune Mstunnel Microsofttunnellogcollectionstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mstunnel-microsofttunnellogcollectionstatus.md | Enum type that represent the status of log collection |pending|0|Indicates that the log collection is in progress| |completed|1|Indicates that the log collection is completed| |failed|2|Indicates that the log collection has failed|-|unknownFutureValue|3|Placeholder value for future expansion enums| +|unknownFutureValue|3|Placeholder value for future expansion enums| |
v1.0 | Intune Mstunnel Microsofttunnelserver | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mstunnel-microsofttunnelserver.md | Here is a JSON representation of the resource. "agentImageDigest": "String", "serverImageDigest": "String" }-``` +``` |
v1.0 | Intune Mstunnel Microsofttunnelserverhealthstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mstunnel-microsofttunnelserverhealthstatus.md | Enum of possible MicrosoftTunnelServer health status types |offline|4|Indicates the server state is offline| |upgradeInProgress|5|Indicates the upgrade in progress during the upgrade cycle of when Intune begins upgrading servers, one server at a time| |upgradeFailed|6|Indicates the failure of the upgrade during the upgrade cycle of when Intune begins upgrading servers, one server at a time|-|unknownFutureValue|7|Evolvable enumeration sentinel value. Do not use enums.| +|unknownFutureValue|7|Evolvable enumeration sentinel value. Do not use enums.| |
v1.0 | Intune Mstunnel Microsofttunnelserverlogcollectionresponse | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md | Here is a JSON representation of the resource. "requestDateTime": "String (timestamp)", "expiryDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Mstunnel Microsofttunnelsite | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-mstunnel-microsofttunnelsite.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Notification Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-notification-devicemanagement.md | Singleton entity that acts as a container for all device management functionalit ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-notification-devicemanagement-get.md)|[deviceManagement](../resources/intune-notification-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-notification-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-notification-devicemanagement-update.md)|[deviceManagement](../resources/intune-notification-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-notification-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-notification-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-notification-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Notification Localizednotificationmessage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-notification-localizednotificationmessage.md | Here is a JSON representation of the resource. "messageTemplate": "String", "isDefault": true }-``` +``` |
v1.0 | Intune Notification Notificationmessagetemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-notification-notificationmessagetemplate.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Notification Notificationtemplatebrandingoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-notification-notificationtemplatebrandingoptions.md | Branding Options for the Message Template. Branding is defined in the Intune Adm |includeContactInformation|4|Indicates to include contact information in the message template.| |includeCompanyPortalLink|8|Indicates to include company portal website link in the message template.| |includeDeviceDetails|16|Indicates to include device details in the message template.|-|unknownFutureValue|32|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|32|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Odj Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-odj-devicemanagement.md | Singleton entity that acts as a container for all domain join connector entities ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-odj-devicemanagement-get.md)|[deviceManagement](../resources/intune-odj-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-odj-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-odj-devicemanagement-update.md)|[deviceManagement](../resources/intune-odj-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-odj-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-odj-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-odj-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Odj Devicemanagementdomainjoinconnector | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-odj-devicemanagementdomainjoinconnector.md | Here is a JSON representation of the resource. "state": "String", "version": "String" }-``` +``` |
v1.0 | Intune Odj Devicemanagementdomainjoinconnectorstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-odj-devicemanagementdomainjoinconnectorstate.md | The ODJ request states. |:|:|:| |active|0|Connector is actively pinging Intune.| |error|1|There is no heart-beat from connector from last one hour.|-|inactive|2|There is no heart-beat from connector from last 5 days.| +|inactive|2|There is no heart-beat from connector from last 5 days.| |
v1.0 | Intune Onboarding Certificateconnectorsetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-certificateconnectorsetting.md | Here is a JSON representation of the resource. "connectorVersion": "String", "lastUploadVersion": 1024 }-``` +``` |
v1.0 | Intune Onboarding Compliancemanagementpartner | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-compliancemanagementpartner.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Onboarding Compliancemanagementpartnerassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-compliancemanagementpartnerassignment.md | Here is a JSON representation of the resource. "entraObjectId": "String" } }-``` +``` |
v1.0 | Intune Onboarding Conceptual | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-conceptual.md | Namespace: microsoft.graph You can enroll devices, including Windows PCs, to enable mobile device management (MDM) with Microsoft Intune. This topic describes different ways to enroll mobile devices in Intune management. The way you enroll your devices depends on the device type, ownership, and the level of management that's needed. "Bring your own device" (BYOD) enrollment lets users enroll their personal phones, tablets, or PCs. Corporate-owned device (COD) enrollment enables management scenarios like remote wipe, shared devices, or user affinity for a device. -Use Graph resources to manage enrollment in Intune. See the table of content for a list of resources. +Use Graph resources to manage enrollment in Intune. See the table of content for a list of resources. |
v1.0 | Intune Onboarding Deviceandappmanagementdata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-deviceandappmanagementdata.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceAndAppManagementData", "content": "Stream" }-``` +``` |
v1.0 | Intune Onboarding Deviceappmanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-deviceappmanagement.md | Singleton entity that acts as a container for all device app management function ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceAppManagement](../api/intune-onboarding-deviceappmanagement-get.md)|[deviceAppManagement](../resources/intune-onboarding-deviceappmanagement.md)|Read properties and relationships of the [deviceAppManagement](../resources/intune-onboarding-deviceappmanagement.md) object.| -|[Update deviceAppManagement](../api/intune-onboarding-deviceappmanagement-update.md)|[deviceAppManagement](../resources/intune-onboarding-deviceappmanagement.md)|Update the properties of a [deviceAppManagement](../resources/intune-onboarding-deviceappmanagement.md) object.| +|[Get deviceAppManagement](../api/intune-onboarding-deviceappmanagement-get.md)|[deviceAppManagement](../resources/intune-shared-deviceappmanagement.md)|Read properties and relationships of the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object.| +|[Update deviceAppManagement](../api/intune-onboarding-deviceappmanagement-update.md)|[deviceAppManagement](../resources/intune-shared-deviceappmanagement.md)|Update the properties of a [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object.| |[syncMicrosoftStoreForBusinessApps action](../api/intune-onboarding-deviceappmanagement-syncmicrosoftstoreforbusinessapps.md)|None|Syncs Intune account with Microsoft Store For Business| ## Properties Here is a JSON representation of the resource. "microsoftStoreForBusinessLastCompletedApplicationSyncTime": "String (timestamp)", "microsoftStoreForBusinessPortalSelection": "String" }-``` +``` |
v1.0 | Intune Onboarding Devicecategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-devicecategory.md | Device categories provides a way to organize your devices. Using device categori ## Methods |Method|Return Type|Description| |:|:|:|-|[List deviceCategories](../api/intune-onboarding-devicecategory-list.md)|[deviceCategory](../resources/intune-onboarding-devicecategory.md) collection|List properties and relationships of the [deviceCategory](../resources/intune-onboarding-devicecategory.md) objects.| -|[Get deviceCategory](../api/intune-onboarding-devicecategory-get.md)|[deviceCategory](../resources/intune-onboarding-devicecategory.md)|Read properties and relationships of the [deviceCategory](../resources/intune-onboarding-devicecategory.md) object.| -|[Create deviceCategory](../api/intune-onboarding-devicecategory-create.md)|[deviceCategory](../resources/intune-onboarding-devicecategory.md)|Create a new [deviceCategory](../resources/intune-onboarding-devicecategory.md) object.| -|[Delete deviceCategory](../api/intune-onboarding-devicecategory-delete.md)|None|Deletes a [deviceCategory](../resources/intune-onboarding-devicecategory.md).| -|[Update deviceCategory](../api/intune-onboarding-devicecategory-update.md)|[deviceCategory](../resources/intune-onboarding-devicecategory.md)|Update the properties of a [deviceCategory](../resources/intune-onboarding-devicecategory.md) object.| +|[List deviceCategories](../api/intune-onboarding-devicecategory-list.md)|[deviceCategory](../resources/intune-shared-devicecategory.md) collection|List properties and relationships of the [deviceCategory](../resources/intune-shared-devicecategory.md) objects.| +|[Get deviceCategory](../api/intune-onboarding-devicecategory-get.md)|[deviceCategory](../resources/intune-shared-devicecategory.md)|Read properties and relationships of the [deviceCategory](../resources/intune-shared-devicecategory.md) object.| +|[Create deviceCategory](../api/intune-onboarding-devicecategory-create.md)|[deviceCategory](../resources/intune-shared-devicecategory.md)|Create a new [deviceCategory](../resources/intune-shared-devicecategory.md) object.| +|[Delete deviceCategory](../api/intune-onboarding-devicecategory-delete.md)|None|Deletes a [deviceCategory](../resources/intune-shared-devicecategory.md).| +|[Update deviceCategory](../api/intune-onboarding-devicecategory-update.md)|[deviceCategory](../resources/intune-shared-devicecategory.md)|Update the properties of a [deviceCategory](../resources/intune-shared-devicecategory.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Onboarding Devicecomanagementauthorityconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-devicecomanagementauthorityconfiguration.md | Here is a JSON representation of the resource. "installConfigurationManagerAgent": true, "configurationManagerAgentCommandLineArgument": "String" }-``` +``` |
v1.0 | Intune Onboarding Deviceenrollmentconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-deviceenrollmentconfiguration.md | The Base Class of Device Enrollment Configuration ## Methods |Method|Return Type|Description| |:|:|:|-|[List deviceEnrollmentConfigurations](../api/intune-onboarding-deviceenrollmentconfiguration-list.md)|[deviceEnrollmentConfiguration](../resources/intune-onboarding-deviceenrollmentconfiguration.md) collection|List properties and relationships of the [deviceEnrollmentConfiguration](../resources/intune-onboarding-deviceenrollmentconfiguration.md) objects.| -|[Get deviceEnrollmentConfiguration](../api/intune-onboarding-deviceenrollmentconfiguration-get.md)|[deviceEnrollmentConfiguration](../resources/intune-onboarding-deviceenrollmentconfiguration.md)|Read properties and relationships of the [deviceEnrollmentConfiguration](../resources/intune-onboarding-deviceenrollmentconfiguration.md) object.| +|[List deviceEnrollmentConfigurations](../api/intune-onboarding-deviceenrollmentconfiguration-list.md)|[deviceEnrollmentConfiguration](../resources/intune-shared-deviceenrollmentconfiguration.md) collection|List properties and relationships of the [deviceEnrollmentConfiguration](../resources/intune-shared-deviceenrollmentconfiguration.md) objects.| +|[Get deviceEnrollmentConfiguration](../api/intune-onboarding-deviceenrollmentconfiguration-get.md)|[deviceEnrollmentConfiguration](../resources/intune-shared-deviceenrollmentconfiguration.md)|Read properties and relationships of the [deviceEnrollmentConfiguration](../resources/intune-shared-deviceenrollmentconfiguration.md) object.| |[setPriority action](../api/intune-onboarding-deviceenrollmentconfiguration-setpriority.md)|None|| |[assign action](../api/intune-onboarding-deviceenrollmentconfiguration-assign.md)|None|| |[createEnrollmentNotificationConfiguration action](../api/intune-onboarding-deviceenrollmentconfiguration-createenrollmentnotificationconfiguration.md)|None|| Here is a JSON representation of the resource. ], "deviceEnrollmentConfigurationType": "String" }-``` +``` |
v1.0 | Intune Onboarding Deviceenrollmentconfigurationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-deviceenrollmentconfigurationtype.md | Describes the TemplateFamily for the Template entity |deviceComanagementAuthorityConfiguration|9|Indicates that configuration is of type Comanagement Authority which refers to policies applied to Co-Managed devices.| |singlePlatformRestriction|10|Indicates that configuration is of type single platform restriction which refers to types of devices a user is allowed to enroll.| |unknownFutureValue|11|Unknown future value|-|enrollmentNotificationsConfiguration|12|Indicates that configuration is of type Enrollment Notification which refers to types of notification a user receives during enrollment.| +|enrollmentNotificationsConfiguration|12|Indicates that configuration is of type Enrollment Notification which refers to types of notification a user receives during enrollment.| |
v1.0 | Intune Onboarding Deviceenrollmentlimitconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-deviceenrollmentlimitconfiguration.md | Here is a JSON representation of the resource. "deviceEnrollmentConfigurationType": "String", "limit": 1024 }-``` +``` |
v1.0 | Intune Onboarding Deviceenrollmentnotificationconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-deviceenrollmentnotificationconfiguration.md | Here is a JSON representation of the resource. "brandingOptions": "String", "defaultLocale": "String" }-``` +``` |
v1.0 | Intune Onboarding Deviceenrollmentplatformrestriction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-deviceenrollmentplatformrestriction.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Onboarding Deviceenrollmentplatformrestrictionconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-deviceenrollmentplatformrestrictionconfiguration.md | Here is a JSON representation of the resource. }, "platformType": "String" }-``` +``` |
v1.0 | Intune Onboarding Deviceenrollmentplatformrestrictionsconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-deviceenrollmentplatformrestrictionsconfiguration.md | Here is a JSON representation of the resource. ] } }-``` +``` |
v1.0 | Intune Onboarding Deviceenrollmentwindowshelloforbusinessconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-deviceenrollmentwindowshelloforbusinessconfiguration.md | Here is a JSON representation of the resource. "securityKeyForSignIn": "String", "enhancedSignInSecurity": 1024 }-``` +``` |
v1.0 | Intune Onboarding Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-devicemanagement.md | Singleton entity that acts as a container for all device management functionalit ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-onboarding-devicemanagement-get.md)|[deviceManagement](../resources/intune-onboarding-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-onboarding-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-onboarding-devicemanagement-update.md)|[deviceManagement](../resources/intune-onboarding-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-onboarding-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-onboarding-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-onboarding-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| |[verifyWindowsEnrollmentAutoDiscovery function](../api/intune-onboarding-devicemanagement-verifywindowsenrollmentautodiscovery.md)|Boolean|| ## Properties Singleton entity that acts as a container for all device management functionalit ## Relationships |Relationship|Type|Description| |:|:|:|-|deviceCategories|[deviceCategory](../resources/intune-onboarding-devicecategory.md) collection|The list of device categories with the tenant.| +|deviceCategories|[deviceCategory](../resources/intune-shared-devicecategory.md) collection|The list of device categories with the tenant.| |exchangeConnectors|[deviceManagementExchangeConnector](../resources/intune-onboarding-devicemanagementexchangeconnector.md) collection|The list of Exchange Connectors configured by the tenant.|-|deviceEnrollmentConfigurations|[deviceEnrollmentConfiguration](../resources/intune-onboarding-deviceenrollmentconfiguration.md) collection|The list of device enrollment configurations| +|deviceEnrollmentConfigurations|[deviceEnrollmentConfiguration](../resources/intune-shared-deviceenrollmentconfiguration.md) collection|The list of device enrollment configurations| |exchangeOnPremisesPolicy|[deviceManagementExchangeOnPremisesPolicy](../resources/intune-onboarding-devicemanagementexchangeonpremisespolicy.md)|The policy which controls mobile device access to Exchange On Premises| |exchangeOnPremisesPolicies|[deviceManagementExchangeOnPremisesPolicy](../resources/intune-onboarding-devicemanagementexchangeonpremisespolicy.md) collection|The list of Exchange On Premisis policies configured by the tenant.| |conditionalAccessSettings|[onPremisesConditionalAccessSettings](../resources/intune-onboarding-onpremisesconditionalaccesssettings.md)|The Exchange on premises conditional access settings. On premises conditional access will require devices to be both enrolled and compliant for mail access| Here is a JSON representation of the resource. "disableClientTelemetry": true } }-``` +``` |
v1.0 | Intune Onboarding Devicemanagementexchangeaccesslevel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-devicemanagementexchangeaccesslevel.md | Access Level in Exchange. |none|0|No device access rule has been configured in Exchange.| |allow|1|Allow the device access to Exchange.| |block|2|Block the device from accessing Exchange.|-|quarantine|3|Quarantine the device in Exchange.| +|quarantine|3|Quarantine the device in Exchange.| |
v1.0 | Intune Onboarding Devicemanagementexchangeaccessrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-devicemanagementexchangeaccessrule.md | Here is a JSON representation of the resource. }, "accessLevel": "String" }-``` +``` |
v1.0 | Intune Onboarding Devicemanagementexchangeaccessruletype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-devicemanagementexchangeaccessruletype.md | Criteria which defines the type of device this access rule will apply to |Member|Value|Description| |:|:|:| |family|0|Family of devices|-|model|1|Specific model of device| +|model|1|Specific model of device| |
v1.0 | Intune Onboarding Devicemanagementexchangeconnector | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-devicemanagementexchangeconnector.md | Here is a JSON representation of the resource. "exchangeAlias": "String", "exchangeOrganization": "String" }-``` +``` |
v1.0 | Intune Onboarding Devicemanagementexchangeconnectorstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-devicemanagementexchangeconnectorstatus.md | The current status of the Exchange Connector. |connectionPending|1|Pending Connection to the Exchange Environment.| |connected|2|Connected to the Exchange Environment| |disconnected|3|Disconnected from the Exchange Environment|-|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Onboarding Devicemanagementexchangeconnectorsynctype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-devicemanagementexchangeconnectorsynctype.md | The type of Exchange Connector sync requested. |Member|Value|Description| |:|:|:| |fullSync|0|Discover all the device in Exchange.|-|deltaSync|1|Discover only the device in Exchange which have updated during the delta sync window.| +|deltaSync|1|Discover only the device in Exchange which have updated during the delta sync window.| |
v1.0 | Intune Onboarding Devicemanagementexchangeconnectortype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-devicemanagementexchangeconnectortype.md | The type of Exchange Connector. |hosted|1|Connects to O365 multi-tenant Exchange environment| |serviceToService|2|Intune Service connects directly to O365 multi-tenant Exchange environment| |dedicated|3|Connects to O365 Dedicated Exchange environment.|-|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Onboarding Devicemanagementexchangedeviceclass | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-devicemanagementexchangedeviceclass.md | Here is a JSON representation of the resource. "name": "String", "type": "String" }-``` +``` |
v1.0 | Intune Onboarding Devicemanagementexchangeonpremisespolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-devicemanagementexchangeonpremisespolicy.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Onboarding Devicemanagementpartner | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-devicemanagementpartner.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Onboarding Devicemanagementpartnerapptype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-devicemanagementpartnerapptype.md | Partner App Type. |:|:|:| |unknown|0|Partner App type is unknown.| |singleTenantApp|1|Partner App is Single tenant in AAD.|-|multiTenantApp|2|Partner App is Multi tenant in AAD.| +|multiTenantApp|2|Partner App is Multi tenant in AAD.| |
v1.0 | Intune Onboarding Devicemanagementpartnerassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-devicemanagementpartnerassignment.md | Here is a JSON representation of the resource. "entraObjectId": "String" } }-``` +``` |
v1.0 | Intune Onboarding Devicemanagementpartnertenantstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-devicemanagementpartnertenantstate.md | Partner state of this tenant. |enabled|2|Partner is enabled.| |terminated|3|Partner connection is terminated.| |rejected|4|Partner messages are rejected.|-|unresponsive|5|Partner is unresponsive.| +|unresponsive|5|Partner is unresponsive.| |
v1.0 | Intune Onboarding Deviceplatformtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-deviceplatformtype.md | Supported platform types. |windows81AndLater|5|Windows 8.1 and later| |windows10AndLater|6|Windows 10 and later.| |androidWorkProfile|7|Android Work Profile.|-|unknown|8|Unknown.| +|unknown|8|Unknown.| |
v1.0 | Intune Onboarding Enablement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-enablement.md | Namespace: microsoft.graph |:|:|:| |notConfigured|0|Device default value, no intent.| |enabled|1|Enables the setting on the device.|-|disabled|2|Disables the setting on the device.| +|disabled|2|Disables the setting on the device.| |
v1.0 | Intune Onboarding Enrollmentconfigurationassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-enrollmentconfigurationassignment.md | Here is a JSON representation of the resource. "source": "String", "sourceId": "String" }-``` +``` |
v1.0 | Intune Onboarding Enrollmentnotificationbrandingoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-enrollmentnotificationbrandingoptions.md | Branding Options for the Message Template. Branding is defined in the Intune Adm |includeContactInformation|4|Indicates that the Contact Information is included in the notification.| |includeCompanyPortalLink|8|Indicates that the Company Portal Link is included in the notification.| |includeDeviceDetails|16|Indicates that the DeviceDetails is included in the notification.|-|unknownFutureValue|32|unknownFutureValue for evolvable enums pattern.| +|unknownFutureValue|32|unknownFutureValue for evolvable enums pattern.| |
v1.0 | Intune Onboarding Enrollmentnotificationtemplatetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-enrollmentnotificationtemplatetype.md | This enum indicates the Template type for which the enrollment notification appl |:|:|:| |email|1|Email Notification| |push|2|Push Notification|-|unknownFutureValue|99|Unknown Type| +|unknownFutureValue|99|Unknown Type| |
v1.0 | Intune Onboarding Enrollmentrestrictionplatformtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-enrollmentrestrictionplatformtype.md | This enum indicates the platform type for which the enrollment restriction appli |androidForWork|5|Indicates that the enrollment configuration applies only to Android for Work devices| |mac|7|Indicates that the enrollment configuration applies only to macOS devices| |linux|8|Indicates that the enrollment configuration applies only to Linux devices|-|unknownFutureValue|9|Evolvable enumeration sentinel value. Do not use| +|unknownFutureValue|9|Evolvable enumeration sentinel value. Do not use| |
v1.0 | Intune Onboarding Intunebrand | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-intunebrand.md | Here is a JSON representation of the resource. "enrollmentAvailability": "String", "disableClientTelemetry": true }-``` +``` |
v1.0 | Intune Onboarding Mdmauthority | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-mdmauthority.md | Mobile device management authority. |unknown|0|Unknown| |intune|1|Intune| |sccm|2|SCCM|-|office365|3|Office365| +|office365|3|Office365| |
v1.0 | Intune Onboarding Microsoftstoreforbusinessportalselectionoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-microsoftstoreforbusinessportalselectionoptions.md | Portal to which admin syncs available Microsoft Store for Business apps. This is |:|:|:| |none|0|This option is not available for the account| |companyPortal|1|Intune Company Portal only.|-|privateStore|2|MSFB Private store only.| +|privateStore|2|MSFB Private store only.| |
v1.0 | Intune Onboarding Mobilethreatdefenseconnector | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-mobilethreatdefenseconnector.md | Here is a JSON representation of the resource. "allowPartnerToCollectIOSPersonalApplicationMetadata": true, "microsoftDefenderForEndpointAttachEnabled": true }-``` +``` |
v1.0 | Intune Onboarding Mobilethreatpartnertenantstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-mobilethreatpartnertenantstate.md | Partner state of this tenant. |unresponsive|3|Partner is unresponsive.| |notSetUp|4|Indicates that the partner connector is not set up. This can occur when the connector is not provisioned and Intune has not received a heartbeat for the connector. Please see https://go.microsoft.com/fwlink/?linkid=2239039 for more information on connector states.| |error|5|Indicates that the partner connector is in an error state. This can occur when the connector has a non-zero error code set due to an internal error in processing. Please see https://go.microsoft.com/fwlink/?linkid=2239039 for more information on connector states.|-|unknownFutureValue|6|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|6|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Onboarding Onpremisesconditionalaccesssettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-onpremisesconditionalaccesssettings.md | Here is a JSON representation of the resource. ], "overrideDefaultRule": true }-``` +``` |
v1.0 | Intune Onboarding Organization | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-organization.md | Here is a JSON representation of the resource. "lastUploadVersion": 1024 } }-``` +``` |
v1.0 | Intune Onboarding Sideloadingkey | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-sideloadingkey.md | Here is a JSON representation of the resource. "totalActivation": 1024, "lastUpdatedDateTime": "String" }-``` +``` |
v1.0 | Intune Onboarding User | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-user.md | Namespace: microsoft.graph ## Methods |Method|Return Type|Description| |:|:|:|-|[List users](../api/intune-onboarding-user-list.md)|[user](../resources/intune-onboarding-user.md) collection|List properties and relationships of the [user](../resources/intune-onboarding-user.md) objects.| -|[Get user](../api/intune-onboarding-user-get.md)|[user](../resources/intune-onboarding-user.md)|Read properties and relationships of the [user](../resources/intune-onboarding-user.md) object.| -|[Create user](../api/intune-onboarding-user-create.md)|[user](../resources/intune-onboarding-user.md)|Create a new [user](../resources/intune-onboarding-user.md) object.| -|[Delete user](../api/intune-onboarding-user-delete.md)|None|Deletes a [user](../resources/intune-onboarding-user.md).| -|[Update user](../api/intune-onboarding-user-update.md)|[user](../resources/intune-onboarding-user.md)|Update the properties of a [user](../resources/intune-onboarding-user.md) object.| +|[List users](../api/intune-onboarding-user-list.md)|[user](../resources/intune-shared-user.md) collection|List properties and relationships of the [user](../resources/intune-shared-user.md) objects.| +|[Get user](../api/intune-onboarding-user-get.md)|[user](../resources/intune-shared-user.md)|Read properties and relationships of the [user](../resources/intune-shared-user.md) object.| +|[Create user](../api/intune-onboarding-user-create.md)|[user](../resources/intune-shared-user.md)|Create a new [user](../resources/intune-shared-user.md) object.| +|[Delete user](../api/intune-onboarding-user-delete.md)|None|Deletes a [user](../resources/intune-shared-user.md).| +|[Update user](../api/intune-onboarding-user-update.md)|[user](../resources/intune-shared-user.md)|Update the properties of a [user](../resources/intune-shared-user.md) object.| |[exportDeviceAndAppManagementData function](../api/intune-onboarding-user-exportdeviceandappmanagementdata.md)|[deviceAndAppManagementData](../resources/intune-onboarding-deviceandappmanagementdata.md)|| |[exportDeviceAndAppManagementData function](../api/intune-onboarding-user-exportdeviceandappmanagementdata.md)|[deviceAndAppManagementData](../resources/intune-onboarding-deviceandappmanagementdata.md)||-|[getEffectiveDeviceEnrollmentConfigurations function](../api/intune-onboarding-user-geteffectivedeviceenrollmentconfigurations.md)|[deviceEnrollmentConfiguration](../resources/intune-onboarding-deviceenrollmentconfiguration.md) collection|| +|[getEffectiveDeviceEnrollmentConfigurations function](../api/intune-onboarding-user-geteffectivedeviceenrollmentconfigurations.md)|[deviceEnrollmentConfiguration](../resources/intune-shared-deviceenrollmentconfiguration.md) collection|| ## Properties |Property|Type|Description| Namespace: microsoft.graph ## Relationships |Relationship|Type|Description| |:|:|:|-|deviceEnrollmentConfigurations|[deviceEnrollmentConfiguration](../resources/intune-onboarding-deviceenrollmentconfiguration.md) collection|Get enrollment configurations targeted to the user| +|deviceEnrollmentConfigurations|[deviceEnrollmentConfiguration](../resources/intune-shared-deviceenrollmentconfiguration.md) collection|Get enrollment configurations targeted to the user| ## JSON Representation Here is a JSON representation of the resource. Here is a JSON representation of the resource. "id": "String (identifier)", "deviceEnrollmentLimit": 1024 }-``` +``` |
v1.0 | Intune Onboarding Vpptokenlicensesummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-vppTokenLicenseSummary.md | Here is a JSON representation of the resource. "availableLicenseCount": 1024, "usedLicenseCount": 1024 }-``` +``` |
v1.0 | Intune Onboarding Vpptoken | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-vpptoken.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Onboarding Vpptokenactionresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-vpptokenactionresult.md | Here is a JSON representation of the resource. "startDateTime": "String (timestamp)", "lastUpdatedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Onboarding Vpptokenrevokelicensesactionresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-vpptokenrevokelicensesactionresult.md | Here is a JSON representation of the resource. "failedLicensesCount": 1024, "actionFailureReason": "String" }-``` +``` |
v1.0 | Intune Onboarding Vpptokenstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-vpptokenstate.md | Possible states associated with an Apple Volume Purchase Program token. |expired|2|Token is expired.| |invalid|3|Token is invalid.| |assignedToExternalMDM|4|Token is managed by another MDM Service.|-|duplicateLocationId|5|Token is associated with the same location as another token on the account.| +|duplicateLocationId|5|Token is associated with the same location as another token on the account.| |
v1.0 | Intune Onboarding Vpptokensyncstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-vpptokensyncstatus.md | Possible sync statuses associated with an Apple Volume Purchase Program token. |none|0|Default status.| |inProgress|1|Last Sync in progress.| |completed|2|Last Sync completed successfully.|-|failed|3|Last Sync failed.| +|failed|3|Last Sync failed.| |
v1.0 | Intune Onboarding Windows10enrollmentcompletionpageconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-windows10enrollmentcompletionpageconfiguration.md | Here is a JSON representation of the resource. "trackInstallProgressForAutopilotOnly": true, "disableUserStatusTrackingAfterFirstUser": true }-``` +``` |
v1.0 | Intune Onboarding Windowshelloforbusinesspinusage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-onboarding-windowshelloforbusinesspinusage.md | Windows Hello for Business pin usage options |:|:|:| |allowed|0|Allowed the usage of certain pin rule| |required|1|Enforce the usage of certain pin rule|-|disallowed|2|Forbit the usage of certain pin rule| +|disallowed|2|Forbit the usage of certain pin rule| |
v1.0 | Intune Osprovisioninggraphservice Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-osprovisioninggraphservice-devicemanagement.md | Singleton that acts as container for a collection of Resource Access entities. ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-osprovisioninggraphservice-devicemanagement-get.md)|[deviceManagement](../resources/intune-osprovisioninggraphservice-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-osprovisioninggraphservice-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-osprovisioninggraphservice-devicemanagement-update.md)|[deviceManagement](../resources/intune-osprovisioninggraphservice-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-osprovisioninggraphservice-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-osprovisioninggraphservice-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-osprovisioninggraphservice-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Osprovisioninggraphservice Manageddevicewindowsoperatingsystemedition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemedition.md | Here is a JSON representation of the resource. "editionType": "String", "supportEndDate": "String (Date)" }-``` +``` |
v1.0 | Intune Osprovisioninggraphservice Manageddevicewindowsoperatingsystemeditiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemeditiontype.md | Windows Operating System is available in different editions, which have a specif |proEducationN|7|Indicates Pro Education N Operating System edition used for the managed device.| |proWorkstation|8|Indicates Pro Workstation Operating System edition used for the managed device.| |proWorkstationN|9|Indicates Pro Workstation N Operating System edition used for the managed device.|-|unknownFutureValue|10|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|10|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Osprovisioninggraphservice Manageddevicewindowsoperatingsystemimage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Osprovisioninggraphservice Manageddevicewindowsoperatingsystemupdate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemupdate.md | Here is a JSON representation of the resource. "releaseMonth": 1024, "releaseYear": 1024 }-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitymanageddevice | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-partnerintegration-appvulnerabilitymanageddevice.md | Here is a JSON representation of the resource. "displayName": "String", "lastSyncDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitymobileapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-partnerintegration-appvulnerabilitymobileapp.md | Here is a JSON representation of the resource. "mobileAppType": "String", "version": "String" }-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitytask | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-partnerintegration-appvulnerabilitytask.md | Here is a JSON representation of the resource. "mobileAppCount": 1024, "remediation": "String" }-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitytaskmitigationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-partnerintegration-appvulnerabilitytaskmitigationtype.md | Device app management task mitigation type. |unknown|0|Mitigation steps are unknown.| |update|1|The app needs to be updated.| |uninstall|2|The app needs to be uninstalled.|-|securityConfiguration|3|The security configuration needs to be changed.| +|securityConfiguration|3|The security configuration needs to be changed.| |
v1.0 | Intune Partnerintegration Configmanagercollection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-partnerintegration-configmanagercollection.md | Here is a JSON representation of the resource. "createdDateTime": "String (timestamp)", "lastModifiedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Partnerintegration Configmanagerpolicysummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-partnerintegration-configmanagerpolicysummary.md | Here is a JSON representation of the resource. "pendingDeviceCount": 1024, "enforcedDeviceCount": 1024 }-``` +``` |
v1.0 | Intune Partnerintegration Deviceappmanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-partnerintegration-deviceappmanagement.md | Device app management singleton entity. ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceAppManagement](../api/intune-partnerintegration-deviceappmanagement-get.md)|[deviceAppManagement](../resources/intune-partnerintegration-deviceappmanagement.md)|Read properties and relationships of the [deviceAppManagement](../resources/intune-partnerintegration-deviceappmanagement.md) object.| -|[Update deviceAppManagement](../api/intune-partnerintegration-deviceappmanagement-update.md)|[deviceAppManagement](../resources/intune-partnerintegration-deviceappmanagement.md)|Update the properties of a [deviceAppManagement](../resources/intune-partnerintegration-deviceappmanagement.md) object.| +|[Get deviceAppManagement](../api/intune-partnerintegration-deviceappmanagement-get.md)|[deviceAppManagement](../resources/intune-shared-deviceappmanagement.md)|Read properties and relationships of the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object.| +|[Update deviceAppManagement](../api/intune-partnerintegration-deviceappmanagement-update.md)|[deviceAppManagement](../resources/intune-shared-deviceappmanagement.md)|Update the properties of a [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceAppManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Partnerintegration Deviceappmanagementtask | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-partnerintegration-deviceappmanagementtask.md | Here is a JSON representation of the resource. "assignedTo": "String", "status": "String" }-``` +``` |
v1.0 | Intune Partnerintegration Deviceappmanagementtaskcategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-partnerintegration-deviceappmanagementtaskcategory.md | Device app management task category. |Member|Value|Description| |:|:|:| |unknown|0|Unknown source.|-|advancedThreatProtection|1|Windows Defender ATP Threat & Vulnerability Management.| +|advancedThreatProtection|1|Windows Defender ATP Threat & Vulnerability Management.| |
v1.0 | Intune Partnerintegration Deviceappmanagementtaskpriority | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-partnerintegration-deviceappmanagementtaskpriority.md | Device app management task priority. |:|:|:| |none|0|No priority set.| |high|1|High priority.|-|low|2|Low priority.| +|low|2|Low priority.| |
v1.0 | Intune Partnerintegration Deviceappmanagementtaskstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-partnerintegration-deviceappmanagementtaskstatus.md | Device app management task status. |pending|1|The task is ready for review.| |active|2|The task has been accepted and is being worked on.| |completed|3|The work is complete.|-|rejected|4|The task was rejected.| +|rejected|4|The task was rejected.| |
v1.0 | Intune Partnerintegration Endpointsecurityconfigurationapplicableplatform | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-partnerintegration-endpointsecurityconfigurationapplicableplatform.md | The endpoint security configuration applicable platform. |unknown|0|Unknown.| |macOS|1|MacOS.| |windows10AndLater|2|Windows 10 and later.|-|windows10AndWindowsServer|3|Windows 10 and Windows Server.| +|windows10AndWindowsServer|3|Windows 10 and Windows Server.| |
v1.0 | Intune Partnerintegration Endpointsecurityconfigurationprofiletype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-partnerintegration-endpointsecurityconfigurationprofiletype.md | The endpoint security policy profile type. |webProtection|11|Web protection.| |applicationControl|12|Application control.| |attackSurfaceReductionRules|13|Attack surface reduction rules.|-|accountProtection|14|Account protection.| +|accountProtection|14|Account protection.| |
v1.0 | Intune Partnerintegration Endpointsecurityconfigurationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-partnerintegration-endpointsecurityconfigurationtype.md | The endpoint security policy type. |firewall|3|Firewall.| |endpointDetectionAndResponse|4|Endpoint detection and response.| |attackSurfaceReduction|5|Attack surface reduction.|-|accountProtection|6|Account protection.| +|accountProtection|6|Account protection.| |
v1.0 | Intune Partnerintegration Keyvaluepair | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-partnerintegration-keyvaluepair.md | Here is a JSON representation of the resource. "name": "String", "value": "String" }-``` +``` |
v1.0 | Intune Partnerintegration Securityconfigurationtask | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-partnerintegration-securityconfigurationtask.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Partnerintegration Unmanageddevice | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-partnerintegration-unmanageddevice.md | Here is a JSON representation of the resource. "lastLoggedOnUser": "String", "lastSeenDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Partnerintegration Unmanageddevicediscoverytask | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-partnerintegration-unmanageddevicediscoverytask.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Partnerintegration Vulnerablemanageddevice | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-partnerintegration-vulnerablemanageddevice.md | Here is a JSON representation of the resource. "displayName": "String", "lastSyncDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Policylistingservice Deviceconfigurationprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policylistingservice-deviceconfigurationprofile.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Policylistingservice Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policylistingservice-devicemanagement.md | Singleton entity that acts as a container for all device management functionalit ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-policylistingservice-devicemanagement-get.md)|[deviceManagement](../resources/intune-policylistingservice-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-policylistingservice-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-policylistingservice-devicemanagement-update.md)|[deviceManagement](../resources/intune-policylistingservice-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-policylistingservice-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-policylistingservice-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-policylistingservice-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.deviceManagement" }-``` +``` |
v1.0 | Intune Policylistingservice Platformtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policylistingservice-platformtype.md | Platform Type |iOS|4|iOS Platform Type| |macOS|8|MacOS Platform Type| |windows10X|16|Windows 10X Platform Type|-|windows10|32|Windows 10 Platform Type| +|windows10|32|Windows 10 Platform Type| |
v1.0 | Intune Policylistingservice Profiletype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policylistingservice-profiletype.md | Profile Type |oemAppConfig|3|OEM Device related App Config Profile Type| |hardwareConfig|4|Hardware Configuration Profile Type| |dcV1EndpointProtection|5|DCV1 Endpoint Protection Profile Type|-|dcV1DeviceRestrictions|6|DCV1 Device Restrictions Profile Type| +|dcV1DeviceRestrictions|6|DCV1 Device Restrictions Profile Type| |
v1.0 | Intune Policyset Assignmentfilterevaluaterequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-assignmentfilterevaluaterequest.md | Here is a JSON representation of the resource. ], "search": "String" }-``` +``` |
v1.0 | Intune Policyset Assignmentfilterevaluationresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-assignmentfilterevaluationresult.md | Supported evaluation results for filter. |notMatch|2|NotMatch.| |inconclusive|3|Inconclusive.| |failure|4|Failure.|-|notEvaluated|5|NotEvaluated.| +|notEvaluated|5|NotEvaluated.| |
v1.0 | Intune Policyset Assignmentfilterevaluationsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-assignmentfilterevaluationsummary.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Policyset Assignmentfiltermanagementtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-assignmentfiltermanagementtype.md | Supported filter management types whether its devices or apps. |:|:|:| |devices|0|Indicates when filter is supported based on device properties. This is the default value when management type resolution fails.| |apps|1|Indicates when filter is supported based on app properties.|-|unknownFutureValue|2|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|2|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Policyset Assignmentfilteroperator | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-assignmentfilteroperator.md | Represents the different type of operators which can be used to craft the Assign |in|7|In.| |notIn|8|NotIn.| |endsWith|9|EndsWith.|-|notEndsWith|10|NotEndsWith.| +|notEndsWith|10|NotEndsWith.| |
v1.0 | Intune Policyset Assignmentfilterpayloadtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-assignmentfilterpayloadtype.md | Represents the payload type AssignmentFilter is being assigned to. |Member|Value|Description| |:|:|:| |notSet|0|NotSet|-|enrollmentRestrictions|1|EnrollmentRestrictions| +|enrollmentRestrictions|1|EnrollmentRestrictions| |
v1.0 | Intune Policyset Assignmentfilterstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-assignmentfilterstate.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.assignmentFilterState", "enabled": true }-``` +``` |
v1.0 | Intune Policyset Assignmentfilterstatusdetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-assignmentfilterstatusdetails.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Policyset Assignmentfiltersupportedproperty | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-assignmentfiltersupportedproperty.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Policyset Assignmentfiltertypeandevaluationresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-assignmentfiltertypeandevaluationresult.md | Here is a JSON representation of the resource. "assignmentFilterType": "String", "evaluationResult": "String" }-``` +``` |
v1.0 | Intune Policyset Assignmentfiltervalidationresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-assignmentfiltervalidationresult.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.assignmentFilterValidationResult", "isValidRule": true }-``` +``` |
v1.0 | Intune Policyset Associatedassignmentpayloadtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-associatedassignmentpayloadtype.md | This enum represents associated assignment payload type |deviceFirmwareConfigurationInterfacePolicy|20|Indicates that this assignment filter is associated with Device Firmware Configuration Interface(DCFI) payload type| |resourceAccessPolicy|23|Indicates that this filter is associated with a resource access policy (Wifi, VPN, Certificate) payload type| |win32app|24|Indicates that this filter is associated with a Win32 app payload type|-|deviceManagmentConfigurationAndCompliancePolicy|29|Indicates that this filter is associated with a configuration or compliance policy on Device Configuration v2 Infrastructure payload type| +|deviceManagmentConfigurationAndCompliancePolicy|29|Indicates that this filter is associated with a configuration or compliance policy on Device Configuration v2 Infrastructure payload type| |
v1.0 | Intune Policyset Deviceandappmanagementassignmentfilter | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-deviceandappmanagementassignmentfilter.md | Here is a JSON representation of the resource. ], "assignmentFilterManagementType": "String" }-``` +``` |
v1.0 | Intune Policyset Deviceappmanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-deviceappmanagement.md | Singleton entity that acts as a container for all device and app management func ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceAppManagement](../api/intune-policyset-deviceappmanagement-get.md)|[deviceAppManagement](../resources/intune-policyset-deviceappmanagement.md)|Read properties and relationships of the [deviceAppManagement](../resources/intune-policyset-deviceappmanagement.md) object.| -|[Update deviceAppManagement](../api/intune-policyset-deviceappmanagement-update.md)|[deviceAppManagement](../resources/intune-policyset-deviceappmanagement.md)|Update the properties of a [deviceAppManagement](../resources/intune-policyset-deviceappmanagement.md) object.| +|[Get deviceAppManagement](../api/intune-policyset-deviceappmanagement-get.md)|[deviceAppManagement](../resources/intune-shared-deviceappmanagement.md)|Read properties and relationships of the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object.| +|[Update deviceAppManagement](../api/intune-policyset-deviceappmanagement-update.md)|[deviceAppManagement](../resources/intune-shared-deviceappmanagement.md)|Update the properties of a [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceAppManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Policyset Devicecompliancepolicypolicysetitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-devicecompliancepolicypolicysetitem.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Policyset Deviceconfigurationpolicysetitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-deviceconfigurationpolicysetitem.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Policyset Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-devicemanagement.md | Singleton entity that acts as a container for all device and app management func ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-policyset-devicemanagement-get.md)|[deviceManagement](../resources/intune-policyset-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-policyset-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-policyset-devicemanagement-update.md)|[deviceManagement](../resources/intune-policyset-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-policyset-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-policyset-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-policyset-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| |[getAssignmentFiltersStatusDetails action](../api/intune-policyset-devicemanagement-getassignmentfiltersstatusdetails.md)|[assignmentFilterStatusDetails](../resources/intune-policyset-assignmentfilterstatusdetails.md)|| |[evaluateAssignmentFilter action](../api/intune-policyset-devicemanagement-evaluateassignmentfilter.md)|Stream|| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Policyset Devicemanagementconfigurationpolicypolicysetitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-devicemanagementconfigurationpolicypolicysetitem.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Policyset Devicemanagementscriptpolicysetitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-devicemanagementscriptpolicysetitem.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Policyset Deviceplatformtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-deviceplatformtype.md | Supported platform types. |androidMobileApplicationManagement|10|Indicates device platform type associated with Mobile Application Management (MAM) for android devices.| |iOSMobileApplicationManagement|11|Indicates device platform type associated with Mobile Application Management (MAM) for iOS devices.| |unknownFutureValue|12|Evolvable enumeration sentinel value. Do not use.|-|windowsMobileApplicationManagement|13|Indicates device platform type associated with Mobile Application Management (MAM) for Windows devices.| +|windowsMobileApplicationManagement|13|Indicates device platform type associated with Mobile Application Management (MAM) for Windows devices.| |
v1.0 | Intune Policyset Enrollmentrestrictionsconfigurationpolicysetitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-enrollmentrestrictionsconfigurationpolicysetitem.md | Here is a JSON representation of the resource. "priority": 1024, "limit": 1024 }-``` +``` |
v1.0 | Intune Policyset Errorcode | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-errorcode.md | Namespace: microsoft.graph |noError|0|Default Value to indicate no error.| |unauthorized|1|The current user does not have access due to lack of RBAC permissions on the resource.| |notFound|2|The current user does not have access due to lack of RBAC Scope Tags on the resource.|-|deleted|3|The resource has been deleted.| +|deleted|3|The resource has been deleted.| |
v1.0 | Intune Policyset Haspayloadlinkresultitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-haspayloadlinkresultitem.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Policyset Ioslobappprovisioningconfigurationpolicysetitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-ioslobappprovisioningconfigurationpolicysetitem.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Policyset Keyvaluepair | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-keyvaluepair.md | Here is a JSON representation of the resource. "name": "String", "value": "String" }-``` +``` |
v1.0 | Intune Policyset Macoslobappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-macoslobappassignmentsettings.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.macOsLobAppAssignmentSettings", "uninstallOnDeviceRemoval": true }-``` +``` |
v1.0 | Intune Policyset Macosvppappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-macosvppappassignmentsettings.md | Here is a JSON representation of the resource. "useDeviceLicensing": true, "uninstallOnDeviceRemoval": true }-``` +``` |
v1.0 | Intune Policyset Managedappprotectionpolicysetitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-managedappprotectionpolicysetitem.md | Here is a JSON representation of the resource. ], "targetedAppManagementLevels": "String" }-``` +``` |
v1.0 | Intune Policyset Manageddevicemobileappconfigurationpolicysetitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-manageddevicemobileappconfigurationpolicysetitem.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Policyset Mdmwindowsinformationprotectionpolicypolicysetitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-mdmwindowsinformationprotectionpolicypolicysetitem.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Policyset Mobileapppolicysetitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-mobileapppolicysetitem.md | Here is a JSON representation of the resource. } } }-``` +``` |
v1.0 | Intune Policyset Payloadbyfilter | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-payloadbyfilter.md | Here is a JSON representation of the resource. "groupId": "String", "assignmentFilterType": "String" }-``` +``` |
v1.0 | Intune Policyset Payloadcompatibleassignmentfilter | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-payloadcompatibleassignmentfilter.md | Here is a JSON representation of the resource. "assignmentFilterManagementType": "String", "payloadType": "String" }-``` +``` |
v1.0 | Intune Policyset Policyset | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-policyset.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Policyset Policysetassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-policysetassignment.md | Here is a JSON representation of the resource. "entraObjectId": "String" } }-``` +``` |
v1.0 | Intune Policyset Policysetitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-policysetitem.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Policyset Policysetstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-policysetstatus.md | The enum to specify the status of PolicySet. |partialSuccess|2|Post process complete for all PolicySet items but there are failures.| |success|3|All PolicySet items are deployed. DoesnΓÇÖt mean that all deployment succeeded. | |error|4|PolicySet processing completely failed.|-|notAssigned|5|PolicySet/PolicySetItem is not assigned to any group.| +|notAssigned|5|PolicySet/PolicySetItem is not assigned to any group.| |
v1.0 | Intune Policyset Targetedmanagedappconfigurationpolicysetitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-targetedmanagedappconfigurationpolicysetitem.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Policyset Win32lobappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-win32lobappassignmentsettings.md | Inherits from [mobileAppAssignmentSettings](../resources/intune-shared-mobileapp |restartSettings|[win32LobAppRestartSettings](../resources/intune-shared-win32lobapprestartsettings.md)|The reboot settings to apply for this app assignment.| |installTimeSettings|[mobileAppInstallTimeSettings](../resources/intune-shared-mobileappinstalltimesettings.md)|The install time settings to apply for this app assignment.| |deliveryOptimizationPriority|[win32LobAppDeliveryOptimizationPriority](../resources/intune-shared-win32lobappdeliveryoptimizationpriority.md)|The delivery optimization priority for this app assignment. This setting is not supported in National Cloud environments. Possible values are: `notConfigured`, `foreground`.|+|autoUpdateSettings|[win32LobAppAutoUpdateSettings](../resources/intune-shared-win32lobappautoupdatesettings.md)|The auto-update settings to apply for this app assignment.| ## Relationships None Here is a JSON representation of the resource. "startDateTime": "String (timestamp)", "deadlineDateTime": "String (timestamp)" },- "deliveryOptimizationPriority": "String" + "deliveryOptimizationPriority": "String", + "autoUpdateSettings": { + "@odata.type": "microsoft.graph.win32LobAppAutoUpdateSettings", + "autoUpdateSupersededApps": "String" + } }-``` +``` |
v1.0 | Intune Policyset Win32lobappautoupdatesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-win32lobappautoupdatesettings.md | + + Title: "win32LobAppAutoUpdateSettings resource type" +description: "Contains properties used to perform the auto-update of an application." ++localization_priority: Normal ++++# win32LobAppAutoUpdateSettings resource type ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. ++Contains properties used to perform the auto-update of an application. ++## Properties +|Property|Type|Description| +|:|:|:| +|autoUpdateSupersededApps|[win32LobAppAutoUpdateSupersededApps](../resources/intune-shared-win32lobappautoupdatesupersededapps.md)|The auto-update superseded apps setting for the app assignment. Possible values are notConfigured and enabled. Default value is notConfigured. Possible values are: `notConfigured`, `enabled`, `unknownFutureValue`.| ++## Relationships +None ++## JSON Representation +Here is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.win32LobAppAutoUpdateSettings" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.win32LobAppAutoUpdateSettings", + "autoUpdateSupersededApps": "String" +} +``` |
v1.0 | Intune Policyset Windows10enrollmentcompletionpageconfigurationpolicysetitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-windows10enrollmentcompletionpageconfigurationpolicysetitem.md | Here is a JSON representation of the resource. ], "priority": 1024 }-``` +``` |
v1.0 | Intune Policyset Windowsappxappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-windowsappxappassignmentsettings.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.windowsAppXAppAssignmentSettings", "useDeviceContext": true }-``` +``` |
v1.0 | Intune Policyset Windowsautopilotdeploymentprofilepolicysetitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-windowsautopilotdeploymentprofilepolicysetitem.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Policyset Windowsuniversalappxappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-policyset-windowsuniversalappxappassignmentsettings.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.windowsUniversalAppXAppAssignmentSettings", "useDeviceContext": true }-``` +``` |
v1.0 | Intune Raimportcerts Certificateconnectordetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-raimportcerts-certificateconnectordetails.md | Here is a JSON representation of the resource. "lastCheckinDateTime": "String (timestamp)", "connectorVersion": "String" }-``` +``` |
v1.0 | Intune Raimportcerts Certificateconnectorhealthmetricvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-raimportcerts-certificateconnectorhealthmetricvalue.md | Here is a JSON representation of the resource. "successCount": 1024, "failureCount": 1024 }-``` +``` |
v1.0 | Intune Raimportcerts Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-raimportcerts-devicemanagement.md | Singleton that acts as container for a collection of UserPFXCertificate entities ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-raimportcerts-devicemanagement-get.md)|[deviceManagement](../resources/intune-raimportcerts-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-raimportcerts-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-raimportcerts-devicemanagement-update.md)|[deviceManagement](../resources/intune-raimportcerts-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-raimportcerts-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-raimportcerts-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-raimportcerts-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Raimportcerts Onpremencryptedpayload | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-raimportcerts-onpremencryptedpayload.md | Here is a JSON representation of the resource. "eTag": "String", "isDeleted": true }-``` +``` |
v1.0 | Intune Raimportcerts Pfxrecryptionrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-raimportcerts-pfxrecryptionrequest.md | Here is a JSON representation of the resource. "isDeleted": true, "eTag": "String" }-``` +``` |
v1.0 | Intune Raimportcerts Pfxusercertificate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-raimportcerts-pfxusercertificate.md | Here is a JSON representation of the resource. "lastModifiedTime": "String (timestamp)", "eTag": "String" }-``` +``` |
v1.0 | Intune Raimportcerts Timeseriesparameter | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-raimportcerts-timeseriesparameter.md | Here is a JSON representation of the resource. "startDateTime": "String (timestamp)", "endDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Raimportcerts Userpfxcertificate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-raimportcerts-userpfxcertificate.md | Here is a JSON representation of the resource. "createdDateTime": "String (timestamp)", "lastModifiedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Raimportcerts Userpfxintendedpurpose | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-raimportcerts-userpfxintendedpurpose.md | Supported values for the intended purpose of a user PFX certificate. |smimeEncryption|1|Valid for S/MIME encryption.| |smimeSigning|2|Valid for S/MIME signing.| |vpn|4|Valid for use in VPN.|-|wifi|8|Valid for use in WiFi.| +|wifi|8|Valid for use in WiFi.| |
v1.0 | Intune Raimportcerts Userpfxpaddingscheme | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-raimportcerts-userpfxpaddingscheme.md | Supported values for the padding scheme used by encryption provider. |oaepSha1|2|OaepSha1 is no longer supported| |oaepSha256|3|Use OAEP SHA-256 padding.| |oaepSha384|4|Use OAEP SHA-384 padding.|-|oaepSha512|5|Use OAEP SHA-512 padding.| +|oaepSha512|5|Use OAEP SHA-512 padding.| |
v1.0 | Intune Rapolicy Applicabilityrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rapolicy-applicabilityrule.md | + + Title: "applicabilityRule resource type" +description: "Intune Rapolicy Applicabilityrule Resources ." ++localization_priority: Normal ++++# applicabilityRule resource type ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. ++++## Properties +|Property|Type|Description| +|:|:|:| +|filterType|[filterAssociationType](../resources/intune-rapolicy-filterassociationtype.md)|. Possible values are: `unknown`, `include`, `exclude`.| ++## Relationships +None ++## JSON Representation +Here is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.applicabilityRule" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.applicabilityRule", + "filterType": "String" +} +``` |
v1.0 | Intune Rapolicy Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rapolicy-devicemanagement.md | Singleton that acts as container for a collection of Resource Access entities. ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-rapolicy-devicemanagement-get.md)|[deviceManagement](../resources/intune-rapolicy-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-rapolicy-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-rapolicy-devicemanagement-update.md)|[deviceManagement](../resources/intune-rapolicy-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-rapolicy-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-rapolicy-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-rapolicy-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Singleton that acts as container for a collection of Resource Access entities. ## Relationships |Relationship|Type|Description| |:|:|:|-|derivedCredentials|[deviceManagementDerivedCredentialSettings](../resources/intune-rapolicy-devicemanagementderivedcredentialsettings.md) collection|Collection of Derived credential settings associated with account.| +|derivedCredentials|[deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) collection|Collection of Derived credential settings associated with account.| |resourceAccessProfiles|[deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md) collection|Collection of resource access settings associated with account.| ## JSON Representation Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Rapolicy Devicemanagementderivedcredentialissuer | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rapolicy-devicemanagementderivedcredentialissuer.md | Supported values for the derived credential issuer. |intercede|0|Intercede| |entrustDatacard|1|Entrust| |purebred|2|Purebred|-|xTec|3|XTec| +|xTec|3|XTec| |
v1.0 | Intune Rapolicy Devicemanagementderivedcredentialnotificationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rapolicy-devicemanagementderivedcredentialnotificationtype.md | Supported values for the notification type to use. |:|:|:| |none|0|None| |companyPortal|1|Company Portal|-|email|2|Email| +|email|2|Email| |
v1.0 | Intune Rapolicy Devicemanagementderivedcredentialsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rapolicy-devicemanagementderivedcredentialsettings.md | Entity that describes tenant level settings for derived credentials ## Methods |Method|Return Type|Description| |:|:|:|-|[List deviceManagementDerivedCredentialSettingses](../api/intune-rapolicy-devicemanagementderivedcredentialsettings-list.md)|[deviceManagementDerivedCredentialSettings](../resources/intune-rapolicy-devicemanagementderivedcredentialsettings.md) collection|List properties and relationships of the [deviceManagementDerivedCredentialSettings](../resources/intune-rapolicy-devicemanagementderivedcredentialsettings.md) objects.| -|[Get deviceManagementDerivedCredentialSettings](../api/intune-rapolicy-devicemanagementderivedcredentialsettings-get.md)|[deviceManagementDerivedCredentialSettings](../resources/intune-rapolicy-devicemanagementderivedcredentialsettings.md)|Read properties and relationships of the [deviceManagementDerivedCredentialSettings](../resources/intune-rapolicy-devicemanagementderivedcredentialsettings.md) object.| -|[Create deviceManagementDerivedCredentialSettings](../api/intune-rapolicy-devicemanagementderivedcredentialsettings-create.md)|[deviceManagementDerivedCredentialSettings](../resources/intune-rapolicy-devicemanagementderivedcredentialsettings.md)|Create a new [deviceManagementDerivedCredentialSettings](../resources/intune-rapolicy-devicemanagementderivedcredentialsettings.md) object.| -|[Delete deviceManagementDerivedCredentialSettings](../api/intune-rapolicy-devicemanagementderivedcredentialsettings-delete.md)|None|Deletes a [deviceManagementDerivedCredentialSettings](../resources/intune-rapolicy-devicemanagementderivedcredentialsettings.md).| -|[Update deviceManagementDerivedCredentialSettings](../api/intune-rapolicy-devicemanagementderivedcredentialsettings-update.md)|[deviceManagementDerivedCredentialSettings](../resources/intune-rapolicy-devicemanagementderivedcredentialsettings.md)|Update the properties of a [deviceManagementDerivedCredentialSettings](../resources/intune-rapolicy-devicemanagementderivedcredentialsettings.md) object.| +|[List deviceManagementDerivedCredentialSettingses](../api/intune-rapolicy-devicemanagementderivedcredentialsettings-list.md)|[deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) collection|List properties and relationships of the [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) objects.| +|[Get deviceManagementDerivedCredentialSettings](../api/intune-rapolicy-devicemanagementderivedcredentialsettings-get.md)|[deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md)|Read properties and relationships of the [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) object.| +|[Create deviceManagementDerivedCredentialSettings](../api/intune-rapolicy-devicemanagementderivedcredentialsettings-create.md)|[deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md)|Create a new [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) object.| +|[Delete deviceManagementDerivedCredentialSettings](../api/intune-rapolicy-devicemanagementderivedcredentialsettings-delete.md)|None|Deletes a [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md).| +|[Update deviceManagementDerivedCredentialSettings](../api/intune-rapolicy-devicemanagementderivedcredentialsettings-update.md)|[deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md)|Update the properties of a [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "notificationType": "String", "renewalThresholdPercentage": 1024 }-``` +``` |
v1.0 | Intune Rapolicy Devicemanagementresourceaccessprofileassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rapolicy-devicemanagementresourceaccessprofileassignment.md | Here is a JSON representation of the resource. }, "sourceId": "String" }-``` +``` |
v1.0 | Intune Rapolicy Devicemanagementresourceaccessprofilebase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md | Base Profile Type for Resource Access |creationDateTime|DateTimeOffset|DateTime profile was created| |lastModifiedDateTime|DateTimeOffset|DateTime profile was last modified| |roleScopeTagIds|String collection|Scope Tags|+|serverApplicabilityRules|[applicabilityRule](../resources/intune-rapolicy-applicabilityrule.md) collection|The list of Applicability Rules for a Device Configuration Profile| ## Relationships |Relationship|Type|Description| Here is a JSON representation of the resource. "lastModifiedDateTime": "String (timestamp)", "roleScopeTagIds": [ "String"+ ], + "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.osVersionApplicabilityRule", + "filterType": "String", + "minOSVersion": "String", + "maxOSVersion": "String" + } ] }-``` +``` |
v1.0 | Intune Rapolicy Devicemanagementresourceaccessprofileintent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rapolicy-devicemanagementresourceaccessprofileintent.md | The administrator intent for the assignment of the profile. |Member|Value|Description| |:|:|:| |apply|0|Apply the profile.|-|remove|1|Remove the profile from devices that have installed the profile.| +|remove|1|Remove the profile from devices that have installed the profile.| |
v1.0 | Intune Rapolicy Deviceplatformtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rapolicy-deviceplatformtype.md | Supported platform types. |windows10AndLater|6|Indicates device platform type is Windows 10 and later.| |androidWorkProfile|7|Indicates device platform type is Android Work Profile.| |unknown|8|This is the default value when device platform type resolution fails|-|androidAOSP|9|Indicates device platform type is Android AOSP.| +|androidAOSP|9|Indicates device platform type is Android AOSP.| |
v1.0 | Intune Rapolicy Extendedkeyusage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rapolicy-extendedkeyusage.md | Here is a JSON representation of the resource. "name": "String", "objectIdentifier": "String" }-``` +``` |
v1.0 | Intune Rapolicy Filterassociationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rapolicy-filterassociationtype.md | + + Title: "filterAssociationType enum type" +description: "Intune Rapolicy Filterassociationtype Resources ." ++localization_priority: Normal ++++# filterAssociationType enum type ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. ++++## Members +|Member|Value|Description| +|:|:|:| +|unknown|0|| +|include|1|| +|exclude|2|| |
v1.0 | Intune Rapolicy Oseditionapplicabilityrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rapolicy-oseditionapplicabilityrule.md | + + Title: "osEditionApplicabilityRule resource type" +description: "Intune Rapolicy Oseditionapplicabilityrule Resources ." ++localization_priority: Normal ++++# osEditionApplicabilityRule resource type ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. +++++Inherits from [applicabilityRule](../resources/intune-rapolicy-applicabilityrule.md) ++## Properties +|Property|Type|Description| +|:|:|:| +|filterType|[filterAssociationType](../resources/intune-rapolicy-filterassociationtype.md)| Inherited from [applicabilityRule](../resources/intune-rapolicy-applicabilityrule.md). Possible values are: `unknown`, `include`, `exclude`.| +|osEditions|Int32 collection|| ++## Relationships +None ++## JSON Representation +Here is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.osEditionApplicabilityRule" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.osEditionApplicabilityRule", + "filterType": "String", + "osEditions": [ + 1024 + ] +} +``` |
v1.0 | Intune Rapolicy Osversionapplicabilityrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rapolicy-osversionapplicabilityrule.md | + + Title: "osVersionApplicabilityRule resource type" +description: "Intune Rapolicy Osversionapplicabilityrule Resources ." ++localization_priority: Normal ++++# osVersionApplicabilityRule resource type ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. +++++Inherits from [applicabilityRule](../resources/intune-rapolicy-applicabilityrule.md) ++## Properties +|Property|Type|Description| +|:|:|:| +|filterType|[filterAssociationType](../resources/intune-rapolicy-filterassociationtype.md)| Inherited from [applicabilityRule](../resources/intune-rapolicy-applicabilityrule.md). Possible values are: `unknown`, `include`, `exclude`.| +|minOSVersion|String|| +|maxOSVersion|String|| ++## Relationships +None ++## JSON Representation +Here is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.osVersionApplicabilityRule" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.osVersionApplicabilityRule", + "filterType": "String", + "minOSVersion": "String", + "maxOSVersion": "String" +} +``` |
v1.0 | Intune Rapolicy Policyplatformtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rapolicy-policyplatformtype.md | Supported platform types for policies. |androidWorkProfile|7|AndroidWorkProfile.| |windows10XProfile|8|Windows10XProfile.| |androidAOSP|9|AndroidAOSPProfile.|-|all|100|All platforms.| +|all|100|All platforms.| |
v1.0 | Intune Rapolicy Windows10xcertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rapolicy-windows10xcertificateprofile.md | Inherits from [deviceManagementResourceAccessProfileBase](../resources/intune-ra |creationDateTime|DateTimeOffset|DateTime profile was created Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |lastModifiedDateTime|DateTimeOffset|DateTime profile was last modified Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |roleScopeTagIds|String collection|Scope Tags Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)|+|serverApplicabilityRules|[applicabilityRule](../resources/intune-rapolicy-applicabilityrule.md) collection|The list of Applicability Rules for a Device Configuration Profile Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| ## Relationships |Relationship|Type|Description| Here is a JSON representation of the resource. "lastModifiedDateTime": "String (timestamp)", "roleScopeTagIds": [ "String"+ ], + "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "String" + } ] }-``` +``` |
v1.0 | Intune Rapolicy Windows10xcustomsubjectalternativename | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rapolicy-windows10xcustomsubjectalternativename.md | Here is a JSON representation of the resource. "sanType": "String", "name": "String" }-``` +``` |
v1.0 | Intune Rapolicy Windows10xscepcertificateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rapolicy-windows10xscepcertificateprofile.md | Inherits from [windows10XCertificateProfile](../resources/intune-rapolicy-window |creationDateTime|DateTimeOffset|DateTime profile was created Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |lastModifiedDateTime|DateTimeOffset|DateTime profile was last modified Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |roleScopeTagIds|String collection|Scope Tags Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)|+|serverApplicabilityRules|[applicabilityRule](../resources/intune-rapolicy-applicabilityrule.md) collection|The list of Applicability Rules for a Device Configuration Profile Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |certificateStore|[certificateStore](../resources/intune-shared-certificatestore.md)|Target store certificate. Possible values are: `user`, `machine`.| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Possible values are: `days`, `months`, `years`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period|-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-rapolicy-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings.| +|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings.| |hashAlgorithm|[hashAlgorithms](../resources/intune-shared-hashalgorithms.md) collection|SCEP Hash Algorithm.| |keySize|[keySize](../resources/intune-shared-keysize.md)|SCEP Key Size. Possible values are: `size1024`, `size2048`, `size4096`.| |keyStorageProvider|[keyStorageProviderOption](../resources/intune-shared-keystorageprovideroption.md)|Key Storage Provider (KSP). Possible values are: `useTpmKspOtherwiseUseSoftwareKsp`, `useTpmKspOtherwiseFail`, `usePassportForWorkKspOtherwiseFail`, `useSoftwareKsp`.| Here is a JSON representation of the resource. "roleScopeTagIds": [ "String" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "String" + } + ], "certificateStore": "String", "certificateValidityPeriodScale": "String", "certificateValidityPeriodValue": 1024, Here is a JSON representation of the resource. ], "subjectNameFormatString": "String" }-``` +``` |
v1.0 | Intune Rapolicy Windows10xtrustedrootcertificate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rapolicy-windows10xtrustedrootcertificate.md | Inherits from [deviceManagementResourceAccessProfileBase](../resources/intune-ra |creationDateTime|DateTimeOffset|DateTime profile was created Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |lastModifiedDateTime|DateTimeOffset|DateTime profile was last modified Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |roleScopeTagIds|String collection|Scope Tags Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)|+|serverApplicabilityRules|[applicabilityRule](../resources/intune-rapolicy-applicabilityrule.md) collection|The list of Applicability Rules for a Device Configuration Profile Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |trustedRootCertificate|Binary|Trusted Root Certificate| |certFileName|String|File name to display in UI.| |destinationStore|[certificateDestinationStore](../resources/intune-shared-certificatedestinationstore.md)|Destination store location for the Trusted Root Certificate. Possible values are: `computerCertStoreRoot`, `computerCertStoreIntermediate`, `userCertStoreIntermediate`.| Here is a JSON representation of the resource. "roleScopeTagIds": [ "String" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "String" + } + ], "trustedRootCertificate": "binary", "certFileName": "String", "destinationStore": "String" }-``` +``` |
v1.0 | Intune Rapolicy Windows10xvpnconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rapolicy-windows10xvpnconfiguration.md | Inherits from [deviceManagementResourceAccessProfileBase](../resources/intune-ra |creationDateTime|DateTimeOffset|DateTime profile was created Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |lastModifiedDateTime|DateTimeOffset|DateTime profile was last modified Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |roleScopeTagIds|String collection|Scope Tags Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)|+|serverApplicabilityRules|[applicabilityRule](../resources/intune-rapolicy-applicabilityrule.md) collection|The list of Applicability Rules for a Device Configuration Profile Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |authenticationCertificateId|Guid|ID to the Authentication Certificate| |customXmlFileName|String|Custom Xml file name.| |customXml|Binary|Custom XML commands that configures the VPN connection. (UTF8 byte encoding)| Here is a JSON representation of the resource. "roleScopeTagIds": [ "String" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "String" + } + ], "authenticationCertificateId": "Guid", "customXmlFileName": "String", "customXml": "binary" }-``` +``` |
v1.0 | Intune Rapolicy Windows10xwificonfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rapolicy-windows10xwificonfiguration.md | Inherits from [deviceManagementResourceAccessProfileBase](../resources/intune-ra |creationDateTime|DateTimeOffset|DateTime profile was created Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |lastModifiedDateTime|DateTimeOffset|DateTime profile was last modified Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |roleScopeTagIds|String collection|Scope Tags Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)|+|serverApplicabilityRules|[applicabilityRule](../resources/intune-rapolicy-applicabilityrule.md) collection|The list of Applicability Rules for a Device Configuration Profile Inherited from [deviceManagementResourceAccessProfileBase](../resources/intune-rapolicy-devicemanagementresourceaccessprofilebase.md)| |authenticationCertificateId|Guid|ID to the Authentication Certificate| |customXmlFileName|String|Custom Xml file name.| |customXml|Binary|Custom XML commands that configures the VPN connection. (UTF8 byte encoding)| Here is a JSON representation of the resource. "roleScopeTagIds": [ "String" ],+ "serverApplicabilityRules": [ + { + "@odata.type": "microsoft.graph.applicabilityRule", + "filterType": "String" + } + ], "authenticationCertificateId": "Guid", "customXmlFileName": "String", "customXml": "binary" }-``` +``` |
v1.0 | Intune Rbac Conceptual | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-conceptual.md | Namespace: microsoft.graph Intune's role-based access control determines who can perform actions on Intune objects and make changes for managed applications, users and devices. -Graph resources are available to manage role-based access control in Intune. See the table of content for a list of resources. +Graph resources are available to manage role-based access control in Intune. See the table of content for a list of resources. |
v1.0 | Intune Rbac Deviceandappmanagementassignedroledetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-deviceandappmanagementassignedroledetails.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Rbac Deviceandappmanagementroleassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-deviceandappmanagementroleassignment.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Rbac Deviceandappmanagementroledefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-deviceandappmanagementroledefinition.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Rbac Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-devicemanagement.md | Singleton entity that acts as a container for all device management functionalit ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-rbac-devicemanagement-get.md)|[deviceManagement](../resources/intune-rbac-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-rbac-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-rbac-devicemanagement-update.md)|[deviceManagement](../resources/intune-rbac-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-rbac-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-rbac-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-rbac-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| |[getEffectivePermissions function](../api/intune-rbac-devicemanagement-geteffectivepermissions.md)|String collection|| |[getEffectivePermissions function](../api/intune-rbac-devicemanagement-geteffectivepermissions.md)|[rolePermission](../resources/intune-rbac-rolepermission.md) collection|| |[getRoleScopeTagsByResource function](../api/intune-rbac-devicemanagement-getrolescopetagsbyresource.md)|[roleScopeTag](../resources/intune-rbac-rolescopetag.md) collection|| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Rbac Identity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-identity.md | Here is a JSON representation of the resource. "id": "String (identifier)", "displayName": "String" }-``` +``` |
v1.0 | Intune Rbac Identityset | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-identityset.md | Here is a JSON representation of the resource. "displayName": "String" } }-``` +``` |
v1.0 | Intune Rbac Operationapprovalpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-operationapprovalpolicy.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Rbac Operationapprovalpolicyplatform | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-operationapprovalpolicyplatform.md | The set of available platforms for the OperationApprovalPolicy. Allows configura |windows10AndLater|16|Indicates that the configured policy platform is for Windows 10 and later.| |windows81AndLater|32|Indicates that the configured policy platform is for Windows 8.1 and later.| |windows10X|64|Indicates that the configured policy platform is for Windows 10X.|-|unknownFutureValue|128|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|128|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Rbac Operationapprovalpolicyset | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-operationapprovalpolicyset.md | Here is a JSON representation of the resource. "policyType": "String", "policyPlatform": "String" }-``` +``` |
v1.0 | Intune Rbac Operationapprovalpolicytype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-operationapprovalpolicytype.md | The set of available policy types that can be configured for approval. There is |role|18|Indicates that the configured policy type is for a Role.| |deviceResetPasscode|19|Indicates that the configured policy type is for a Device Reset Passcode Action.| |customOrganizationalMessage|20|Indicates that the configured policy type is for a Custom Organizational Message.|-|unknownFutureValue|21|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|21|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Rbac Operationapprovalrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-operationapprovalrequest.md | The OperationApprovalRequest entity encompasses the operation an admin wishes to |status|[operationApprovalRequestStatus](../resources/intune-rbac-operationapprovalrequeststatus.md)|The current approval status of the request. Possible values are: `unknown`, `needsApproval`, `approved`, `rejected`, `cancelled`, `completed`, `expired`. Default value is `unknown`. Read-only. This property is read-only. Possible values are: `unknown`, `needsApproval`, `approved`, `rejected`, `cancelled`, `completed`, `expired`, `unknownFutureValue`.| |requestJustification|String|Indicates the justification for creating the request. Maximum length of justification is 1024 characters. For example: 'Needed for Feb 2023 application baseline updates.' Read-only. This property is read-only.| |approvalJustification|String|Indicates the justification for approving or rejecting the request. Maximum length of justification is 1024 characters. For example: 'Approved per Change 23423 - needed for Feb 2023 application baseline updates.' Read-only. This property is read-only.|-|operationApprovalPolicies|String|The operational approval policies used in the request. Indicates the policy and platform combinations that are required for this request to be approved or rejected. Read-only. This property is read-only.| |requiredOperationApprovalPolicyTypes|[operationApprovalPolicyType](../resources/intune-rbac-operationapprovalpolicytype.md) collection|Indicates the approval policy types required by the request in order for the request to be approved or rejected. Read-only. This property is read-only.| ## Relationships Here is a JSON representation of the resource. "status": "String", "requestJustification": "String", "approvalJustification": "String",- "operationApprovalPolicies": "String", "requiredOperationApprovalPolicyTypes": [ "String" ] }-``` +``` |
v1.0 | Intune Rbac Operationapprovalrequestentitystatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-operationapprovalrequestentitystatus.md | Here is a JSON representation of the resource. "requestStatus": "String", "entityLocked": true }-``` +``` |
v1.0 | Intune Rbac Operationapprovalrequeststatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-operationapprovalrequeststatus.md | Indicates the status of the Approval Request. The status of a request will chang |cancelled|4|Indicates that the approval request has been cancelled by the request's requestor. No further action can be taken to complete the operation or to modify the request.| |completed|5|Indicates that the approval request has been completed. This status is feature agnostic and does not indicate success or failure of the operation. No further action is necessary for the operation or to modify the request.| |expired|6|Indicates that the approval request has expired. No further action can be taken to complete the operation or to modify the request. A new approval request must be made and approved in order to complete the operation.|-|unknownFutureValue|7|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|7|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Rbac Operationapprovalsource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-operationapprovalsource.md | Source of the action on the approval request. |unknown|0|Default. Indicates the source of the action on the approval request is unknown.| |adminConsole|1|Indicates the source of the action on the approval request is from an interactive session using the Intune Admin Console.| |email|2|Indicates the source of the action on the approval request is from an email based form.|-|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Rbac Rbacapplicationmultiple | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-rbacapplicationmultiple.md | Namespace: microsoft.graph ## Properties |Property|Type|Description| |:|:|:|-|id|String|| ## Relationships None Here is a JSON representation of the resource. --> ``` json {- "@odata.type": "#microsoft.graph.rbacApplicationMultiple", - "id": "String (identifier)" + "@odata.type": "#microsoft.graph.rbacApplicationMultiple" }-``` +``` |
v1.0 | Intune Rbac Resourceaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-resourceaction.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Rbac Resourceoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-resourceoperation.md | Here is a JSON representation of the resource. "description": "String", "enabledForScopeValidation": true }-``` +``` |
v1.0 | Intune Rbac Roleassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-roleassignment.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Rbac Roleassignmentscopetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-roleassignmentscopetype.md | Specifies the type of scope for a Role Assignment. |resourceScope|0|Allow assignments to the specified ResourceScopes.| |allDevices|1|Allow assignments to all Intune devices.| |allLicensedUsers|2|Allow assignments to all Intune licensed users.|-|allDevicesAndLicensedUsers|3|Allow assignments to all Intune devices and licensed users.| +|allDevicesAndLicensedUsers|3|Allow assignments to all Intune devices and licensed users.| |
v1.0 | Intune Rbac Roledefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-roledefinition.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Rbac Rolemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-rolemanagement.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.roleManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Rbac Rolepermission | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-rolepermission.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Rbac Rolescopetag | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-rolescopetag.md | Here is a JSON representation of the resource. "description": "String", "isBuiltIn": true }-``` +``` |
v1.0 | Intune Rbac Rolescopetagautoassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-rbac-rolescopetagautoassignment.md | Here is a JSON representation of the resource. "entraObjectId": "String" } }-``` +``` |
v1.0 | Intune Remoteassistance Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-remoteassistance-devicemanagement.md | Singleton entity that acts as a container for all device management functionalit ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-remoteassistance-devicemanagement-get.md)|[deviceManagement](../resources/intune-remoteassistance-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-remoteassistance-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-remoteassistance-devicemanagement-update.md)|[deviceManagement](../resources/intune-remoteassistance-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-remoteassistance-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-remoteassistance-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-remoteassistance-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| |[getAllowedRemoteAssistanceActions function](../api/intune-remoteassistance-devicemanagement-getallowedremoteassistanceactions.md)|[allowedRemoteAssistanceActions](../resources/intune-remoteassistance-allowedremoteassistanceactions.md)|| |[reportRemoteAssistance action](../api/intune-remoteassistance-devicemanagement-reportremoteassistance.md)|None|A post call to submit the reporting payload| |[reportRemoteHelpSessionStartTime action](../api/intune-remoteassistance-devicemanagement-reportremotehelpsessionstarttime.md)|None|| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Remoteassistance Devicemanagementreports | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-remoteassistance-devicemanagementreports.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagementReports", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Remoteassistance Enrollmentstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-remoteassistance-enrollmentstate.md | This status denotes the current enrollent state of the device |pendingReset|2|Enrolled but it's enrolled via enrollment profile and the enrolled profile is different from the assigned profile.| |failed|3|Not enrolled and there is enrollment failure record.| |notContacted|4|Device is imported but not enrolled.|-|blocked|5|Device is enrolled as userless, but is blocked from moving to user enrollment because the app failed to install.| +|blocked|5|Device is enrolled as userless, but is blocked from moving to user enrollment because the app failed to install.| |
v1.0 | Intune Remoteassistance Remoteassistanceonboardingstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-remoteassistance-remoteassistanceonboardingstatus.md | The current TeamViewer connector status |:|:|:| |notOnboarded|0|The status reported when there is no active TeamViewer connector configured or active| |onboarding|1|The status reported when the system has initiated a TeamViewer connection, but the service has not yet completed the confirmation of a connector|-|onboarded|2|The status reported when the system has successfully exchanged account information with TeamViewer and can now initiate remote assistance sessions with clients| +|onboarded|2|The status reported when the system has successfully exchanged account information with TeamViewer and can now initiate remote assistance sessions with clients| |
v1.0 | Intune Remoteassistance Remoteassistancepartner | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-remoteassistance-remoteassistancepartner.md | Here is a JSON representation of the resource. "lastConnectionDateTime": "String (timestamp)", "onboardingRequestExpiryDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Remoteassistance Remoteassistancesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-remoteassistance-remoteassistancesettings.md | Here is a JSON representation of the resource. "allowSessionsToUnenrolledDevices": true, "blockChat": true }-``` +``` |
v1.0 | Intune Remoteassistance Remoteassistancestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-remoteassistance-remoteassistancestate.md | State of remote assistance for the account |Member|Value|Description| |:|:|:| |disabled|1|Remote assistance is disabled for the account. With this value, Quick Assist remote assistance sessions are not allowed for the account.|-|enabled|2|Remote assistance is enabled for the account. With this value, enterprise Quick Assist remote assistance features are provided.| +|enabled|2|Remote assistance is enabled for the account. With this value, enterprise Quick Assist remote assistance features are provided.| |
v1.0 | Intune Reporting Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-reporting-devicemanagement.md | Singleton entity that acts as a container for all device management functionalit ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-reporting-devicemanagement-get.md)|[deviceManagement](../resources/intune-reporting-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-reporting-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-reporting-devicemanagement-update.md)|[deviceManagement](../resources/intune-reporting-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-reporting-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-reporting-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-reporting-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Reporting Devicemanagementcachedreportconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-reporting-devicemanagementcachedreportconfiguration.md | Here is a JSON representation of the resource. "lastRefreshDateTime": "String (timestamp)", "expirationDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Reporting Devicemanagementexportjob | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-reporting-devicemanagementexportjob.md | Here is a JSON representation of the resource. "requestDateTime": "String (timestamp)", "expirationDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Reporting Devicemanagementexportjoblocalizationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-reporting-devicemanagementexportjoblocalizationtype.md | Configures how the requested export job is localized. |Member|Value|Description| |:|:|:| |localizedValuesAsAdditionalColumn|0|Configures the export job to expose localized values as an additional column.|-|replaceLocalizableValues|1|Configures the export job to replace enumerable values with their localized values.| +|replaceLocalizableValues|1|Configures the export job to replace enumerable values with their localized values.| |
v1.0 | Intune Reporting Devicemanagementreportfileformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-reporting-devicemanagementreportfileformat.md | Possible values for the file format of a report. |csv|0|CSV Format.| |pdf|1|PDF Format (Deprecate later).| |json|2|JSON Format.|-|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Reporting Devicemanagementreports | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-reporting-devicemanagementreports.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagementReports", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Reporting Devicemanagementreportschedule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-reporting-devicemanagementreportschedule.md | Here is a JSON representation of the resource. ], "format": "String" }-``` +``` |
v1.0 | Intune Reporting Devicemanagementreportstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-reporting-devicemanagementreportstatus.md | Possible statuses associated with a generated report. |notStarted|1|Report generation has not started.| |inProgress|2|Report generation is in progress.| |completed|3|Report generation is completed.|-|failed|4|Report generation has failed.| +|failed|4|Report generation has failed.| |
v1.0 | Intune Reporting Devicemanagementscheduledreportrecurrence | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-reporting-devicemanagementscheduledreportrecurrence.md | Possible values for the recurrence of a scheduled report |none|0|Default value, specifies a single occurence| |daily|1|Daily| |weekly|2|Weekly|-|monthly|3|Monthly| +|monthly|3|Monthly| |
v1.0 | Intune Resaccess Conceptual | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-resaccess-conceptual.md | Namespace: microsoft.graph You can import PFX certificates using Microsoft Graph API for Intune. -Use Graph resources to manage certificates in Intune. See the table of content for a list of resources. +Use Graph resources to manage certificates in Intune. See the table of content for a list of resources. |
v1.0 | Intune Servicenowconnectorservice Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-servicenowconnectorservice-devicemanagement.md | Singleton that acts as container for a collection of Resource Access entities. ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-servicenowconnectorservice-devicemanagement-get.md)|[deviceManagement](../resources/intune-servicenowconnectorservice-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-servicenowconnectorservice-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-servicenowconnectorservice-devicemanagement-update.md)|[deviceManagement](../resources/intune-servicenowconnectorservice-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-servicenowconnectorservice-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-servicenowconnectorservice-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-servicenowconnectorservice-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Servicenowconnectorservice Servicenowauthenticationmethod | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-servicenowconnectorservice-servicenowauthenticationmethod.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.serviceNowAuthenticationMethod" }-``` +``` |
v1.0 | Intune Servicenowconnectorservice Servicenowconnection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-servicenowconnectorservice-servicenowconnection.md | Here is a JSON representation of the resource. "lastModifiedDateTime": "String (timestamp)", "lastQueriedDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Servicenowconnectorservice Servicenowconnectionstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-servicenowconnectorservice-servicenowconnectionstatus.md | Status of ServiceNow Connection |:|:|:| |disabled|0|Tenant has disabled the connection| |enabled|1|Tenant has enabled the connection|-|unknownFutureValue|2|Future authentication method to be added here.| +|unknownFutureValue|2|Future authentication method to be added here.| |
v1.0 | Intune Servicenowconnectorservice Servicenowoauthsecretauthentication | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-servicenowconnectorservice-servicenowoauthsecretauthentication.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.serviceNowOauthSecretAuthentication", "appId": "String" }-``` +``` |
v1.0 | Intune Shared Actionstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-actionstate.md | State of the action on the device |active|3|Action is active.| |done|4|Action completed without errors.| |failed|5|Action failed|-|notSupported|6|Action is not supported.| +|notSupported|6|Action is not supported.| |
v1.0 | Intune Shared Alldevicesassignmenttarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-alldevicesassignmenttarget.md | Here is a JSON representation of the resource. "deviceAndAppManagementAssignmentFilterId": "String", "deviceAndAppManagementAssignmentFilterType": "String" }-``` +``` |
v1.0 | Intune Shared Alllicensedusersassignmenttarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-alllicensedusersassignmenttarget.md | Here is a JSON representation of the resource. "deviceAndAppManagementAssignmentFilterId": "String", "deviceAndAppManagementAssignmentFilterType": "String" }-``` +``` |
v1.0 | Intune Shared Androidenterprisealwaysonvpnpackagetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-androidenterprisealwaysonvpnpackagetype.md | Namespace: microsoft.graph |ciscoAnyConnect|2|Cisco AnyConnect.| |f5Access|3|F5 Access.| |paloAltoNetworksGlobalProtect|4|Palo Alto Networks GlobalProtect.|-|pulseSecure|5|Pulse Secure.| +|pulseSecure|5|Pulse Secure.| |
v1.0 | Intune Shared Androidmanagedappprotection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-androidmanagedappprotection.md | Here is a JSON representation of the resource. "minimumWarningCompanyPortalVersion": "String", "minimumWipeCompanyPortalVersion": "String" }-``` +``` |
v1.0 | Intune Shared Androidmanagedstoreappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-androidmanagedstoreappassignmentsettings.md | Here is a JSON representation of the resource. ], "autoUpdateMode": "String" }-``` +``` |
v1.0 | Intune Shared Androidmanagedstoreautoupdatemode | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-androidmanagedstoreautoupdatemode.md | Prioritization for automatic updates of Android Managed Store apps set on assign |default|0|Default update behavior (device must be connected to Wifi, charging and not actively used).| |postponed|1|Updates are postponed for a maximum of 90 days after the app becomes out of date.| |priority|2|The app is updated as soon as possible by the developer. If device is online, it will be updated within minutes.|-|unknownFutureValue|3|Unknown future mode (reserved, not used right now).| +|unknownFutureValue|3|Unknown future mode (reserved, not used right now).| |
v1.0 | Intune Shared Certificatedestinationstore | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-certificatedestinationstore.md | Possible values for the Certificate Destination Store. |:|:|:| |computerCertStoreRoot|0|Computer Certificate Store - Root.| |computerCertStoreIntermediate|1|Computer Certificate Store - Intermediate.|-|userCertStoreIntermediate|2|User Certificate Store - Intermediate.| +|userCertStoreIntermediate|2|User Certificate Store - Intermediate.| |
v1.0 | Intune Shared Certificateissuancestates | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-certificateissuancestates.md | Certificate Issuance State Options. |deleteFailed|19|| |deleted|20|| |renewalRequested|21||-|requested|22|| +|requested|22|| |
v1.0 | Intune Shared Certificaterevocationstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-certificaterevocationstatus.md | Certificate Revocation Status. |pending|1|Revocation pending.| |issued|2|Revocation command issued.| |failed|3|Revocation failed.|-|revoked|4|Revoked.| +|revoked|4|Revoked.| |
v1.0 | Intune Shared Certificatestore | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-certificatestore.md | CertificateStore types |Member|Value|Description| |:|:|:| |user|1||-|machine|2|| +|machine|2|| |
v1.0 | Intune Shared Certificatevalidityperiodscale | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-certificatevalidityperiodscale.md | Certificate Validity Period Options. |:|:|:| |days|0|Days.| |months|1|Months.|-|years|2|Years.| +|years|2|Years.| |
v1.0 | Intune Shared Companyportalaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-companyportalaction.md | Action on a device that can be executed in the Company Portal |:|:|:| |unknown|0|Unknown device action| |remove|1|Remove device from Company Portal|-|reset|2|Reset device enrolled in Company Portal| +|reset|2|Reset device enrolled in Company Portal| |
v1.0 | Intune Shared Companyportalblockedaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-companyportalblockedaction.md | Here is a JSON representation of the resource. "ownerType": "String", "action": "String" }-``` +``` |
v1.0 | Intune Shared Compliancestatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-compliancestatus.md | Namespace: microsoft.graph |nonCompliant|4|| |error|5|| |conflict|6||-|notAssigned|7|| +|notAssigned|7|| |
v1.0 | Intune Shared Conceptual | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-conceptual.md | Namespace: microsoft.graph These endpoints are used in multiple Microsoft Graph API for Intune workflows. The intent, purpose, and permissions required to use a given resource varies according to the specific workflow and context of the underlying call. In addition, certain methods, properties, and actions are supported only for specific workflows. -Graph resources are shared between Intune workflows. See the table of content for a list of resources. +Graph resources are shared between Intune workflows. See the table of content for a list of resources. |
v1.0 | Intune Shared Configurationmanagercollectionassignmenttarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-configurationmanagercollectionassignmenttarget.md | Here is a JSON representation of the resource. "deviceAndAppManagementAssignmentFilterType": "String", "collectionId": "String" }-``` +``` |
v1.0 | Intune Shared Deviceandappmanagementassignmentfiltertype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-deviceandappmanagementassignmentfiltertype.md | Represents type of the assignment filter. |:|:|:| |none|0|Default value. Do not use.| |include|1|Indicates in-filter, rule matching will offer the payload to devices.|-|exclude|2|Indicates out-filter, rule matching will not offer the payload to devices.| +|exclude|2|Indicates out-filter, rule matching will not offer the payload to devices.| |
v1.0 | Intune Shared Deviceandappmanagementassignmentsource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-deviceandappmanagementassignmentsource.md | Represents source of assignment. |Member|Value|Description| |:|:|:| |direct|0|Direct indicates a direct assignment.|-|policySets|1|PolicySets indicates assignment was made via PolicySet assignment.| +|policySets|1|PolicySets indicates assignment was made via PolicySet assignment.| |
v1.0 | Intune Shared Deviceandappmanagementassignmenttarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-deviceandappmanagementassignmenttarget.md | Here is a JSON representation of the resource. "deviceAndAppManagementAssignmentFilterId": "String", "deviceAndAppManagementAssignmentFilterType": "String" }-``` +``` |
v1.0 | Intune Shared Deviceappmanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-deviceappmanagement.md | Here is a JSON representation of the resource. Note that this is only an exampl "microsoftStoreForBusinessLanguage": "String", "microsoftStoreForBusinessLastCompletedApplicationSyncTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Shared Devicecategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicecategory.md | Here is a JSON representation of the resource. "displayName": "String", "description": "String" }-``` +``` |
v1.0 | Intune Shared Devicecompliancepolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicecompliancepolicy.md | Here is a JSON representation of the resource. "displayName": "String", "version": 1024 }-``` +``` |
v1.0 | Intune Shared Deviceconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-deviceconfiguration.md | Here is a JSON representation of the resource. "displayName": "String", "version": 1024 }-``` +``` |
v1.0 | Intune Shared Deviceenrollmentconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-deviceenrollmentconfiguration.md | Here is a JSON representation of the resource. "lastModifiedDateTime": "String (timestamp)", "version": 1024 }-``` +``` |
v1.0 | Intune Shared Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagement.md | Here is a JSON representation of the resource. "id": "String (identifier)", "subscriptionState": "String" }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationazureadtrusttype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationazureadtrusttype.md | Required AAD Trust Type |none|0|No AAD Trust Type specified| |azureAdJoined|1|AAD Joined Trust Type| |addWorkAccount|2|AddWorkAccount|-|mdmOnly|4|MDM only| +|mdmOnly|4|MDM only| |
v1.0 | Intune Shared Devicemanagementconfigurationchoicesettingcollectioninstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationchoicesettingcollectioninstance.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationchoicesettingdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationchoicesettingdefinition.md | Here is a JSON representation of the resource. ], "defaultOptionId": "String" }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationchoicesettinginstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationchoicesettinginstance.md | Here is a JSON representation of the resource. ] } }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationchoicesettingvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationchoicesettingvalue.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationcontroltype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationcontroltype.md | Setting control type representation in the UX |largeTextBox|3|Display text input in large text input| |toggle|4|Allow for toggle control type| |multiheaderGrid|5|Allow for multiheader grid control type|-|contextPane|6|Allow for context pane control type| +|contextPane|6|Allow for context pane control type| |
v1.0 | Intune Shared Devicemanagementconfigurationdependenton | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationdependenton.md | Here is a JSON representation of the resource. "dependentOn": "String", "parentSettingId": "String" }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationdevicemode | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationdevicemode.md | Describes applicability for the mode the device is in |Member|Value|Description| |:|:|:| |none|0|No Device Mode specified|-|kiosk|1|Device must be in kiosk mode for this setting to apply| +|kiosk|1|Device must be in kiosk mode for this setting to apply| |
v1.0 | Intune Shared Devicemanagementconfigurationexchangeonlinesettingapplicability | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationexchangeonlinesettingapplicability.md | Here is a JSON representation of the resource. "deviceMode": "String", "technologies": "String" }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationgroupsettingcollectioninstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationgroupsettingcollectioninstance.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationgroupsettinginstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationgroupsettinginstance.md | Here is a JSON representation of the resource. ] } }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationgroupsettingvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationgroupsettingvalue.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationintegersettingvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationintegersettingvalue.md | Here is a JSON representation of the resource. }, "value": 1024 }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationintegersettingvaluedefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationintegersettingvaluedefinition.md | Here is a JSON representation of the resource. "maximumValue": 1024, "minimumValue": 1024 }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationoptiondefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationoptiondefinition.md | Here is a JSON representation of the resource. "name": "String", "displayName": "String" }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationplatforms | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationplatforms.md | Supported platform types. |windows10X|16|Windows 10 X.| |windows10|32|Windows 10.| |linux|128|Linux.|-|unknownFutureValue|1073741824|Sentinel member for cases where the client cannot handle the new enum values.| +|unknownFutureValue|1073741824|Sentinel member for cases where the client cannot handle the new enum values.| |
v1.0 | Intune Shared Devicemanagementconfigurationredirectsettingdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationredirectsettingdefinition.md | Here is a JSON representation of the resource. "redirectMessage": "String", "redirectReason": "String" }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationreferencesettingvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationreferencesettingvalue.md | Here is a JSON representation of the resource. "value": "String", "note": "String" }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationreferredsettinginformation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationreferredsettinginformation.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagementConfigurationReferredSettingInformation", "settingDefinitionId": "String" }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationsecretsettingvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationsecretsettingvalue.md | Here is a JSON representation of the resource. "value": "String", "valueState": "String" }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationsecretsettingvaluestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationsecretsettingvaluestate.md | type tracking the encryption state of a secret setting value |:|:|:| |invalid|0|default invalid value| |notEncrypted|1|secret value is not encrypted|-|encryptedValueToken|2|a token for the encrypted value is returned by the service| +|encryptedValueToken|2|a token for the encrypted value is returned by the service| |
v1.0 | Intune Shared Devicemanagementconfigurationsettingaccesstypes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationsettingaccesstypes.md | Not yet documented |delete|4|Not yet documented| |get|8|Not yet documented| |replace|16|Not yet documented|-|execute|32|Not yet documented| +|execute|32|Not yet documented| |
v1.0 | Intune Shared Devicemanagementconfigurationsettingapplicability | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationsettingapplicability.md | Here is a JSON representation of the resource. "deviceMode": "String", "technologies": "String" }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationsettingdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationsettingdefinition.md | Here is a JSON representation of the resource. "displayName": "String", "version": "String" }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationsettingdependedonby | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationsettingdependedonby.md | Here is a JSON representation of the resource. "dependedOnBy": "String", "required": true }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationsettinggroupcollectioninstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationsettinggroupcollectioninstance.md | Here is a JSON representation of the resource. "settingInstanceTemplateId": "String" } }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationsettinggroupdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationsettinggroupdefinition.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationsettinggroupinstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationsettinggroupinstance.md | Here is a JSON representation of the resource. "settingInstanceTemplateId": "String" } }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationsettinginstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationsettinginstance.md | Here is a JSON representation of the resource. "settingInstanceTemplateId": "String" } }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationsettinginstancetemplatereference | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationsettinginstancetemplatereference.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference", "settingInstanceTemplateId": "String" }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationsettingoccurrence | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationsettingoccurrence.md | Here is a JSON representation of the resource. "minDeviceOccurrence": 1024, "maxDeviceOccurrence": 1024 }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationsettingusage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationsettingusage.md | Supported setting types |:|:|:| |none|0|No setting type specified| |configuration|1|Configuration setting|-|compliance|2|Compliance setting| +|compliance|2|Compliance setting| |
v1.0 | Intune Shared Devicemanagementconfigurationsettingvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationsettingvalue.md | Here is a JSON representation of the resource. "useTemplateDefault": true } }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationsettingvaluedefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationsettingvaluedefinition.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingValueDefinition" }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationsettingvaluetemplatereference | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationsettingvaluetemplatereference.md | Here is a JSON representation of the resource. "settingValueTemplateId": "String", "useTemplateDefault": true }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationsettingvisibility | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationsettingvisibility.md | Supported setting types |:|:|:| |none|0|Not visible| |settingsCatalog|1|Visible to setting catalog UX|-|template|2|Visible to template| +|template|2|Visible to template| |
v1.0 | Intune Shared Devicemanagementconfigurationsimplesettingcollectioninstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationsimplesettingcollectioninstance.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationsimplesettingdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationsimplesettingdefinition.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationsimplesettinginstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationsimplesettinginstance.md | Here is a JSON representation of the resource. "value": "String" } }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationsimplesettingvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationsimplesettingvalue.md | Here is a JSON representation of the resource. "useTemplateDefault": true } }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationstringformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationstringformat.md | Not yet documented |regEx|11|Not yet documented| |json|12|Not yet documented| |dateTime|13|Not yet documented|-|surfaceHub|14|Not yet documented| +|surfaceHub|14|Not yet documented| |
v1.0 | Intune Shared Devicemanagementconfigurationstringsettingvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationstringsettingvalue.md | Here is a JSON representation of the resource. }, "value": "String" }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationtechnologies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationtechnologies.md | Describes which technology this setting can be deployed with |linuxMdm|1024|Setting can be deployed through the Linux Mdm channel| |enrollment|4096|Setting can be deployed through device enrollment.| |endpointPrivilegeManagement|8192|Setting can be deployed using the Endpoint privilege management channel|-|unknownFutureValue|16384|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|16384|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Shared Devicemanagementconfigurationwindowssettingapplicability | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationwindowssettingapplicability.md | Here is a JSON representation of the resource. "requiresAzureAd": true, "requiredAzureAdTrustType": "String" }-``` +``` |
v1.0 | Intune Shared Devicemanagementconfigurationwindowsskus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementconfigurationwindowsskus.md | Not yet documented |holoLensEnterprise|11|Not yet documented| |holographicForBusiness|12|Not yet documented| |windowsMultiSession|13|Not yet documented|-|surfaceHub|14|Not yet documented| +|surfaceHub|14|Not yet documented| |
v1.0 | Intune Shared Devicemanagementderivedcredentialsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementderivedcredentialsettings.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagementDerivedCredentialSettings", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Shared Devicemanagementscript | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicemanagementscript.md | Here is a JSON representation of the resource. ], "runAs32Bit": true }-``` +``` |
v1.0 | Intune Shared Devicetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-devicetype.md | Device type. |blackberry|100|Blackberry.| |palm|101|Palm.| |unknown|255|Represents that the device type is unknown.|-|cloudPC|257|Cloud PC device.| +|cloudPC|257|Cloud PC device.| |
v1.0 | Intune Shared Enablement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-enablement.md | Possible values of a property |:|:|:| |notConfigured|0|Device default value, no intent.| |enabled|1|Enables the setting on the device.|-|disabled|2|Disables the setting on the device.| +|disabled|2|Disables the setting on the device.| |
v1.0 | Intune Shared Enrollmentavailabilityoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-enrollmentavailabilityoptions.md | Options available for enrollment flow customization |:|:|:| |availableWithPrompts|0|Device enrollment flow is shown to the end user with guided enrollment prompts| |availableWithoutPrompts|1|Device enrollment flow is available to the end user without guided enrollment prompts|-|unavailable|2|Device enrollment flow is unavailable to the enduser| +|unavailable|2|Device enrollment flow is unavailable to the enduser| |
v1.0 | Intune Shared Enrollmentstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-enrollmentstate.md | Namespace: microsoft.graph |pendingReset|2|Enrolled but it's enrolled via enrollment profile and the enrolled profile is different from the assigned profile.| |failed|3|Not enrolled and there is enrollment failure record.| |notContacted|4|Device is imported but not enrolled.|-|blocked|5|Device is enrolled as userless, but is blocked from moving to user enrollment because the app failed to install.| +|blocked|5|Device is enrolled as userless, but is blocked from moving to user enrollment because the app failed to install.| |
v1.0 | Intune Shared Exclusiongroupassignmenttarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-exclusiongroupassignmenttarget.md | Here is a JSON representation of the resource. "deviceAndAppManagementAssignmentFilterType": "String", "groupId": "String" }-``` +``` |
v1.0 | Intune Shared Extendedkeyusage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-extendedkeyusage.md | Here is a JSON representation of the resource. "name": "String", "objectIdentifier": "String" }-``` +``` |
v1.0 | Intune Shared Groupassignmenttarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-groupassignmenttarget.md | Here is a JSON representation of the resource. "deviceAndAppManagementAssignmentFilterType": "String", "groupId": "String" }-``` +``` |
v1.0 | Intune Shared Hashalgorithms | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-hashalgorithms.md | Hash Algorithm Options. |Member|Value|Description| |:|:|:| |sha1|1|SHA-1 Hash Algorithm.|-|sha2|2|SHA-2 Hash Algorithm.| +|sha2|2|SHA-2 Hash Algorithm.| |
v1.0 | Intune Shared Installintent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-installintent.md | Possible values for the install intent chosen by the admin. |available|0|Available install intent.| |required|1|Required install intent.| |uninstall|2|Uninstall install intent.|-|availableWithoutEnrollment|3|Available without enrollment install intent.| +|availableWithoutEnrollment|3|Available without enrollment install intent.| |
v1.0 | Intune Shared Ioslobappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-ioslobappassignmentsettings.md | Here is a JSON representation of the resource. "isRemovable": true, "preventManagedAppBackup": true }-``` +``` |
v1.0 | Intune Shared Ioslobappprovisioningconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-ioslobappprovisioningconfiguration.md | Here is a JSON representation of the resource. "displayName": "String", "version": 1024 }-``` +``` |
v1.0 | Intune Shared Iosmanagedappprotection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-iosmanagedappprotection.md | Here is a JSON representation of the resource. "protectInboundDataFromUnknownSources": true, "customBrowserProtocol": "String" }-``` +``` |
v1.0 | Intune Shared Iosstoreappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-iosstoreappassignmentsettings.md | Here is a JSON representation of the resource. "isRemovable": true, "preventManagedAppBackup": true }-``` +``` |
v1.0 | Intune Shared Iosvppappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-iosvppappassignmentsettings.md | Here is a JSON representation of the resource. "preventManagedAppBackup": true, "preventAutoAppUpdate": true }-``` +``` |
v1.0 | Intune Shared Iprange | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-iprange.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.ipRange" }-``` +``` |
v1.0 | Intune Shared Ipv4range | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-ipv4range.md | Here is a JSON representation of the resource. "lowerAddress": "String", "upperAddress": "String" }-``` +``` |
v1.0 | Intune Shared Ipv6range | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-ipv6range.md | Here is a JSON representation of the resource. "lowerAddress": "String", "upperAddress": "String" }-``` +``` |
v1.0 | Intune Shared Keylongvaluepair | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-keylongvaluepair.md | Here is a JSON representation of the resource. "name": "String", "value": 1024 }-``` +``` |
v1.0 | Intune Shared Keysize | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-keysize.md | Key Size Options. |:|:|:| |size1024|0|1024 Bits.| |size2048|1|2048 Bits.|-|size4096|2|4096 Bits.| +|size4096|2|4096 Bits.| |
v1.0 | Intune Shared Keystorageprovideroption | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-keystorageprovideroption.md | Key Storage Provider (KSP) Import Options. |useTpmKspOtherwiseUseSoftwareKsp|0|Import to Trusted Platform Module (TPM) KSP if present, otherwise import to Software KSP.| |useTpmKspOtherwiseFail|1|Import to Trusted Platform Module (TPM) KSP if present, otherwise fail.| |usePassportForWorkKspOtherwiseFail|2|Import to Passport for work KSP if available, otherwise fail.|-|useSoftwareKsp|3|Import to Software KSP.| +|useSoftwareKsp|3|Import to Software KSP.| |
v1.0 | Intune Shared Keyusages | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-keyusages.md | Key Usage Options. |Member|Value|Description| |:|:|:| |keyEncipherment|1|Key Encipherment Usage.|-|digitalSignature|2|Digital Signature Usage.| +|digitalSignature|2|Digital Signature Usage.| |
v1.0 | Intune Shared Keyvaluepair | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-keyvaluepair.md | Here is a JSON representation of the resource. "name": "String", "value": "String" }-``` +``` |
v1.0 | Intune Shared Macoslobappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-macoslobappassignmentsettings.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.macOsLobAppAssignmentSettings", "uninstallOnDeviceRemoval": true }-``` +``` |
v1.0 | Intune Shared Macosvppappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-macosvppappassignmentsettings.md | Here is a JSON representation of the resource. "preventManagedAppBackup": true, "preventAutoAppUpdate": true }-``` +``` |
v1.0 | Intune Shared Manageddevicearchitecture | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-manageddevicearchitecture.md | Processor architecture |x86|1|X86| |x64|2|X64| |arm|3|ARM|-|arM64|4|ARM64| +|arM64|4|ARM64| |
v1.0 | Intune Shared Manageddeviceownertype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-manageddeviceownertype.md | Owner type of device. |:|:|:| |unknown|0|Unknown.| |company|1|Owned by company.|-|personal|2|Owned by person.| +|personal|2|Owned by person.| |
v1.0 | Intune Shared Managementagenttype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-managementagenttype.md | Management agent type. |msSense|1024|| |intuneAosp|2048|This device is managed by Intune's MDM for AOSP (Android Open Source Project) devices| |google|8192|Indicates the management agent to manage the device is Google.|-|unknownFutureValue|8193|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|8193|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Shared Mdmwindowsinformationprotectionpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-mdmwindowsinformationprotectionpolicy.md | Here is a JSON representation of the resource. ], "isAssigned": true }-``` +``` |
v1.0 | Intune Shared Microsoftstoreforbusinessappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-microsoftstoreforbusinessappassignmentsettings.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.microsoftStoreForBusinessAppAssignmentSettings", "useDeviceContext": true }-``` +``` |
v1.0 | Intune Shared Mimecontent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-mimecontent.md | Here is a JSON representation of the resource. "type": "String", "value": "binary" }-``` +``` |
v1.0 | Intune Shared Mobileapp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-mobileapp.md | Here is a JSON representation of the resource. ], "dependentAppCount": 1024 }-``` +``` |
v1.0 | Intune Shared Mobileappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-mobileappassignmentsettings.md | Here is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.mobileAppAssignmentSettings" }-``` +``` |
v1.0 | Intune Shared Mobileappinstalltimesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-mobileappinstalltimesettings.md | Here is a JSON representation of the resource. "startDateTime": "String (timestamp)", "deadlineDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Shared Mobileapptroubleshootingevent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-mobileapptroubleshootingevent.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Shared Ownertype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-ownertype.md | Owner type of device. |:|:|:| |unknown|0|Unknown.| |company|1|Owned by company.|-|personal|2|Owned by person.| +|personal|2|Owned by person.| |
v1.0 | Intune Shared Proxieddomain | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-proxieddomain.md | Here is a JSON representation of the resource. "ipAddressOrFQDN": "String", "proxy": "String" }-``` +``` |
v1.0 | Intune Shared Report | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-report.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.report", "content": "<Unknown Primitive Type Edm.Stream>" }-``` +``` |
v1.0 | Intune Shared Reportroot | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-reportroot.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.reportRoot", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Shared Resultantappstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-resultantappstate.md | A list of possible states for application status on an individual device. When d |uninstallFailed|4|The application failed to uninstall.| |pendingInstall|5|The installation of the application is in progress.| |unknown|99|The status of the application is unknown.|-|notApplicable|-1|The application is not applicable.| +|notApplicable|-1|The application is not applicable.| |
v1.0 | Intune Shared Rgbcolor | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-rgbcolor.md | Here is a JSON representation of the resource. "g": 1024, "b": 1024 }-``` +``` |
v1.0 | Intune Shared Runasaccounttype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-runasaccounttype.md | Indicates the type of execution context the app runs in. |Member|Value|Description| |:|:|:| |system|0|System context|-|user|1|User context| +|user|1|User context| |
v1.0 | Intune Shared Runstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-runstate.md | Indicates the type of execution status of the device management script. |fail|2|Script failed to run.| |scriptError|3|Discovery script hits error.| |pending|4|Script is pending to execute.|-|notApplicable|5|Script is not applicable for this device.| +|notApplicable|5|Script is not applicable for this device.| |
v1.0 | Intune Shared Saveduistategenerationoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-saveduistategenerationoptions.md | Namespace: microsoft.graph |Member|Value|Description| |:|:|:| |none|0||-|omitSilverlightPolicyReferences|1|| +|omitSilverlightPolicyReferences|1|| |
v1.0 | Intune Shared Scopetaggroupassignmenttarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-scopetaggroupassignmenttarget.md | Here is a JSON representation of the resource. "targetType": "String", "entraObjectId": "String" }-``` +``` |
v1.0 | Intune Shared Scopetagtargettype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-scopetagtargettype.md | Specifies which type of Entra object to target in the Group for a given ScopeTag |none|0|Unused value. Do not use.| |user|1|Indicates the ScopeTag assignment will Target Users in the Group Ids provided.| |device|2|Indicates the ScopeTag assignment will Target Devices in the Group Ids provided.|-|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Shared Settingsourcetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-settingsourcetype.md | Namespace: microsoft.graph |Member|Value|Description| |:|:|:| |deviceConfiguration|0||-|deviceIntent|1|| +|deviceIntent|1|| |
v1.0 | Intune Shared Subjectalternativenametype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-subjectalternativenametype.md | Subject Alternative Name Options. |userPrincipalName|2|User Principal Name (UPN).| |customAzureADAttribute|4|Custom Azure AD Attribute.| |domainNameService|8|Domain Name Service (DNS).|-|universalResourceIdentifier|16|Universal Resource Identifier (URI).| +|universalResourceIdentifier|16|Universal Resource Identifier (URI).| |
v1.0 | Intune Shared Subjectnameformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-subjectnameformat.md | Subject Name Format Options. |commonNameAsSerialNumber|6|Common Name As Serial Number.| |commonNameAsAadDeviceId|7|Common Name As Serial Number.| |commonNameAsIntuneDeviceId|8|Common Name As Serial Number.|-|commonNameAsDurableDeviceId|9|Common Name As Serial Number.| +|commonNameAsDurableDeviceId|9|Common Name As Serial Number.| |
v1.0 | Intune Shared Targetedmanagedappconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-targetedmanagedappconfiguration.md | Here is a JSON representation of the resource. "deployedAppCount": 1024, "isAssigned": true }-``` +``` |
v1.0 | Intune Shared Uri | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-uri.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Shared User | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-user.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.user", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Shared Vpptokenaccounttype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-vpptokenaccounttype.md | Possible types of an Apple Volume Purchase Program token. |Member|Value|Description| |:|:|:| |business|0|Apple Volume Purchase Program token associated with an business program.|-|education|1|Apple Volume Purchase Program token associated with an education program.| +|education|1|Apple Volume Purchase Program token associated with an education program.| |
v1.0 | Intune Shared Vpptokenactionfailurereason | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-vpptokenactionfailurereason.md | Possible types of reasons for an Apple Volume Purchase Program token action fail |appleFailure|1|There was an error on Apple's service.| |internalError|2|There was an internal error.| |expiredVppToken|3|There was an error because the Apple Volume Purchase Program token was expired.|-|expiredApplePushNotificationCertificate|4|There was an error because the Apple Volume Purchase Program Push Notification certificate expired.| +|expiredApplePushNotificationCertificate|4|There was an error because the Apple Volume Purchase Program Push Notification certificate expired.| |
v1.0 | Intune Shared Win32lobappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-win32lobappassignmentsettings.md | Here is a JSON representation of the resource. "autoUpdateSupersededApps": "String" } }-``` +``` |
v1.0 | Intune Shared Win32lobappautoupdatesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-win32lobappautoupdatesettings.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.win32LobAppAutoUpdateSettings", "autoUpdateSupersededApps": "String" }-``` +``` |
v1.0 | Intune Shared Win32lobappautoupdatesupersededapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-win32lobappautoupdatesupersededapps.md | Contains value for auto-update superseded apps. |:|:|:| |notConfigured|0|Indicates that the auto-update superseded apps is not configured and the app will not auto-update the superseded apps.| |enabled|1|Indicates that the auto-update superseded apps is enabled and the app will auto-update the superseded apps if the superseded apps are installed on the device.|-|unknownFutureValue|2|Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue|2|Evolvable enumeration sentinel value. Do not use.| |
v1.0 | Intune Shared Win32lobappdeliveryoptimizationpriority | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-win32lobappdeliveryoptimizationpriority.md | Contains value for delivery optimization priority. |Member|Value|Description| |:|:|:| |notConfigured|0|Not configured or background normal delivery optimization priority.|-|foreground|1|Foreground delivery optimization priority.| +|foreground|1|Foreground delivery optimization priority.| |
v1.0 | Intune Shared Win32lobappnotification | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-win32lobappnotification.md | Contains value for notification status. |:|:|:| |showAll|0|Show all notifications.| |showReboot|1|Only show restart notification and suppress other notifications.|-|hideAll|2|Hide all notifications.| +|hideAll|2|Hide all notifications.| |
v1.0 | Intune Shared Win32lobapprestartsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-win32lobapprestartsettings.md | Here is a JSON representation of the resource. "countdownDisplayBeforeRestartInMinutes": 1024, "restartNotificationSnoozeDurationInMinutes": 1024 }-``` +``` |
v1.0 | Intune Shared Windowsappxappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-windowsappxappassignmentsettings.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.windowsAppXAppAssignmentSettings", "useDeviceContext": true }-``` +``` |
v1.0 | Intune Shared Windowsautopilotdeploymentprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-windowsautopilotdeploymentprofile.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Shared Windowsdomainjoinconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-windowsdomainjoinconfiguration.md | Here is a JSON representation of the resource. Note: The response object shown "computerNameSuffixRandomCharCount": 1024, "activeDirectoryDomainName": "String" }-``` +``` |
v1.0 | Intune Shared Windowsuniversalappxappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-windowsuniversalappxappassignmentsettings.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.windowsUniversalAppXAppAssignmentSettings", "useDeviceContext": true }-``` +``` |
v1.0 | Intune Shared Windowsupdatestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-windowsupdatestate.md | Here is a JSON representation of the resource. "lastScanDateTime": "String (timestamp)", "lastSyncDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Shared Wingetappassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-wingetappassignmentsettings.md | Here is a JSON representation of the resource. "deadlineDateTime": "String (timestamp)" } }-``` +``` |
v1.0 | Intune Shared Wingetappinstalltimesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-wingetappinstalltimesettings.md | Here is a JSON representation of the resource. "useLocalTime": true, "deadlineDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Shared Wingetappnotification | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-wingetappnotification.md | Contains value for notification status. |showAll|0|Show all notifications.| |showReboot|1|Only show restart notification and suppress other notifications.| |hideAll|2|Hide all notifications.|-|unknownFutureValue|3|Unknown future value, reserved for future usage as expandable enum.| +|unknownFutureValue|3|Unknown future value, reserved for future usage as expandable enum.| |
v1.0 | Intune Shared Wingetapprestartsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-shared-wingetapprestartsettings.md | Here is a JSON representation of the resource. "countdownDisplayBeforeRestartInMinutes": 1024, "restartNotificationSnoozeDurationInMinutes": 1024 }-``` +``` |
v1.0 | Intune Softwareupdate Bulkdriveractionresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-softwareupdate-bulkdriveractionresult.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Softwareupdate Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-softwareupdate-devicemanagement.md | Singleton entity that acts as a container for all device management functionalit ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-softwareupdate-devicemanagement-get.md)|[deviceManagement](../resources/intune-softwareupdate-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-softwareupdate-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-softwareupdate-devicemanagement-update.md)|[deviceManagement](../resources/intune-softwareupdate-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-softwareupdate-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-softwareupdate-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-softwareupdate-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Softwareupdate Driverapprovalaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-softwareupdate-driverapprovalaction.md | An enum type to represent approval actions of single or list of drivers. |:|:|:| |approve|0|This indicates the action to approve single or list of drivers.| |decline|1|This indicates the action to approve single or list of drivers.|-|suspend|2|This indicates the action to suspend single or list of drivers.| +|suspend|2|This indicates the action to suspend single or list of drivers.| |
v1.0 | Intune Softwareupdate Driverapprovalstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-softwareupdate-driverapprovalstatus.md | An enum type to represent approval status of a driver. |needsReview|0|This indicates a driver needs IT admin's review.| |declined|1|This indicates IT admin has declined a driver.| |approved|2|This indicates IT admin has approved a driver.|-|suspended|3|This indicates IT admin has suspended a driver.| +|suspended|3|This indicates IT admin has suspended a driver.| |
v1.0 | Intune Softwareupdate Drivercategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-softwareupdate-drivercategory.md | An enum type to represent which category a driver belongs to. |:|:|:| |recommended|0|This indicates a driver is recommended by Microsoft.| |previouslyApproved|1|This indicates a driver was recommended by Microsoft and IT admin has taken some approval action on it.|-|other|2|This indicates a driver is never recommended by Microsoft.| +|other|2|This indicates a driver is never recommended by Microsoft.| |
v1.0 | Intune Softwareupdate Driverupdateprofileapprovaltype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-softwareupdate-driverupdateprofileapprovaltype.md | An enum type to represent approval type of a driver update profile. |Member|Value|Description| |:|:|:| |manual|0|This indicates a driver and firmware profile needs to be approved manually.|-|automatic|1|This indicates a driver and firmware profile is approved automatically.| +|automatic|1|This indicates a driver and firmware profile is approved automatically.| |
v1.0 | Intune Softwareupdate Expeditedwindowsqualityupdatesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-softwareupdate-expeditedwindowsqualityupdatesettings.md | Here is a JSON representation of the resource. "qualityUpdateRelease": "String", "daysUntilForcedReboot": 1024 }-``` +``` |
v1.0 | Intune Softwareupdate Iosavailableupdateversion | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-softwareupdate-iosavailableupdateversion.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Softwareupdate Windowsdriverupdateinventory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-softwareupdate-windowsdriverupdateinventory.md | Here is a JSON representation of the resource. "category": "String", "deployDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Softwareupdate Windowsdriverupdateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-softwareupdate-windowsdriverupdateprofile.md | Here is a JSON representation of the resource. "driverInventorySyncState": "String" } }-``` +``` |
v1.0 | Intune Softwareupdate Windowsdriverupdateprofileassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-softwareupdate-windowsdriverupdateprofileassignment.md | Here is a JSON representation of the resource. "deviceAndAppManagementAssignmentFilterType": "String" } }-``` +``` |
v1.0 | Intune Softwareupdate Windowsdriverupdateprofileinventorysyncstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-softwareupdate-windowsdriverupdateprofileinventorysyncstate.md | Windows DnF update inventory sync state. |:|:|:| |pending|0|Pending sync.| |success|1|Successful sync.|-|failure|2|Failed sync.| +|failure|2|Failed sync.| |
v1.0 | Intune Softwareupdate Windowsdriverupdateprofileinventorysyncstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-softwareupdate-windowsdriverupdateprofileinventorysyncstatus.md | Here is a JSON representation of the resource. "lastSuccessfulSyncDateTime": "String (timestamp)", "driverInventorySyncState": "String" }-``` +``` |
v1.0 | Intune Softwareupdate Windowsfeatureupdatecatalogitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-softwareupdate-windowsfeatureupdatecatalogitem.md | Here is a JSON representation of the resource. "endOfSupportDate": "String (timestamp)", "version": "String" }-``` +``` |
v1.0 | Intune Softwareupdate Windowsfeatureupdateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-softwareupdate-windowsfeatureupdateprofile.md | Here is a JSON representation of the resource. "endOfSupportDate": "String (timestamp)", "installLatestWindows10OnWindows11IneligibleDevice": true }-``` +``` |
v1.0 | Intune Softwareupdate Windowsfeatureupdateprofileassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-softwareupdate-windowsfeatureupdateprofileassignment.md | Here is a JSON representation of the resource. "deviceAndAppManagementAssignmentFilterType": "String" } }-``` +``` |
v1.0 | Intune Softwareupdate Windowsqualityupdatecatalogitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-softwareupdate-windowsqualityupdatecatalogitem.md | Here is a JSON representation of the resource. "classification": "String", "isExpeditable": true }-``` +``` |
v1.0 | Intune Softwareupdate Windowsqualityupdateclassification | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-softwareupdate-windowsqualityupdateclassification.md | Windows quality update classification |:|:|:| |all|0|All update type| |security|1|Security only update type|-|nonSecurity|2|Non security only update type| +|nonSecurity|2|Non security only update type| |
v1.0 | Intune Softwareupdate Windowsqualityupdateprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-softwareupdate-windowsqualityupdateprofile.md | Here is a JSON representation of the resource. "releaseDateDisplayName": "String", "deployableContentDisplayName": "String" }-``` +``` |
v1.0 | Intune Softwareupdate Windowsqualityupdateprofileassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-softwareupdate-windowsqualityupdateprofileassignment.md | Here is a JSON representation of the resource. "deviceAndAppManagementAssignmentFilterType": "String" } }-``` +``` |
v1.0 | Intune Softwareupdate Windowsupdatecatalogitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-softwareupdate-windowsupdatecatalogitem.md | Here is a JSON representation of the resource. "releaseDateTime": "String (timestamp)", "endOfSupportDate": "String (timestamp)" }-``` +``` |
v1.0 | Intune Softwareupdate Windowsupdaterolloutsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-softwareupdate-windowsupdaterolloutsettings.md | Here is a JSON representation of the resource. "offerEndDateTimeInUTC": "String (timestamp)", "offerIntervalInDays": 1024 }-``` +``` |
v1.0 | Intune Troubleshooting Applevpptokentroubleshootingevent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-applevpptokentroubleshootingevent.md | Here is a JSON representation of the resource. ], "tokenId": "String" }-``` +``` |
v1.0 | Intune Troubleshooting Connectorhealthstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-connectorhealthstate.md | Connector health state for connector status |healthy|0|Indicates a healthy connector status and no action required.| |warning|1|Indicates that a connector needs attention.| |unhealthy|2|Indicates that a connector needs immediate attention to retain functionality.|-|unknown|3|unknown| +|unknown|3|unknown| |
v1.0 | Intune Troubleshooting Connectorname | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-connectorname.md | Connectors name for connector status |windowsDefenderATPConnectorLastHeartbeatDateTime|12|Indicates the last heartbeat date/time that the Windows Defender ATP connector was contacted.| |mobileThreatDefenceConnectorLastHeartbeatDateTime|13|Indicates the last heartbeat date/time that the Mobile Threat Defence connector was contacted.| |chromebookLastDirectorySyncDateTime|14|Indicates the last sync date/time that the Chrombook Last Directory performed a sync.|-|futureValue|15|Future use| +|futureValue|15|Future use| |
v1.0 | Intune Troubleshooting Connectorstatusdetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-connectorstatusdetails.md | Here is a JSON representation of the resource. "status": "String", "eventDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Intune Troubleshooting Deviceenrollmentfailurereason | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-deviceenrollmentfailurereason.md | Top level failure categories for enrollment. |featureNotSupported|8|Feature(s) used by this enrollment are not supported for this account.| |enrollmentRestrictionsEnforced|9|Enrollment restrictions configured by admin blocked this enrollment.| |clientDisconnected|10|Client timed out or enrollment was aborted by enduser.|-|userAbandonment|11|Enrollment was abandoned by enduser. (Enduser started onboarding but failed to complete it in timely manner)| +|userAbandonment|11|Enrollment was abandoned by enduser. (Enduser started onboarding but failed to complete it in timely manner)| |
v1.0 | Intune Troubleshooting Deviceenrollmenttype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-deviceenrollmenttype.md | Possible ways of adding a mobile device to management. |azureAdJoinUsingAzureVmExtension|14|Azure AD Join enrollment when an Azure VM is provisioned| |androidEnterpriseDedicatedDevice|15|Android Enterprise Dedicated Device| |androidEnterpriseFullyManaged|16|Android Enterprise Fully Managed|-|androidEnterpriseCorporateWorkProfile|17|Android Enterprise Corporate Work Profile| +|androidEnterpriseCorporateWorkProfile|17|Android Enterprise Corporate Work Profile| |
v1.0 | Intune Troubleshooting Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-devicemanagement.md | Singleton entity that acts as a container for all device management functionalit ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-troubleshooting-devicemanagement-get.md)|[deviceManagement](../resources/intune-troubleshooting-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-troubleshooting-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-troubleshooting-devicemanagement-update.md)|[deviceManagement](../resources/intune-troubleshooting-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-troubleshooting-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-troubleshooting-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-troubleshooting-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Troubleshooting Devicemanagementautopilotevent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-devicemanagementautopilotevent.md | Here is a JSON representation of the resource. "targetedPolicyCount": 1024, "enrollmentFailureDetails": "String" }-``` +``` |
v1.0 | Intune Troubleshooting Devicemanagementautopilotpolicycompliancestatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-devicemanagementautopilotpolicycompliancestatus.md | Namespace: microsoft.graph |installed|2|| |notCompliant|3|| |notInstalled|4||-|error|5|| +|error|5|| |
v1.0 | Intune Troubleshooting Devicemanagementautopilotpolicystatusdetail | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-devicemanagementautopilotpolicystatusdetail.md | Here is a JSON representation of the resource. "lastReportedDateTime": "String (timestamp)", "errorCode": 1024 }-``` +``` |
v1.0 | Intune Troubleshooting Devicemanagementautopilotpolicytype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-devicemanagementautopilotpolicytype.md | Namespace: microsoft.graph |unknown|0|| |application|3|| |appModel|7||-|configurationPolicy|12|| +|configurationPolicy|12|| |
v1.0 | Intune Troubleshooting Devicemanagementtroubleshootingerrordetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-devicemanagementtroubleshootingerrordetails.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Troubleshooting Devicemanagementtroubleshootingerrorresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-devicemanagementtroubleshootingerrorresource.md | Here is a JSON representation of the resource. "text": "String", "link": "String" }-``` +``` |
v1.0 | Intune Troubleshooting Devicemanagementtroubleshootingevent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-devicemanagementtroubleshootingevent.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Troubleshooting Devicetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-devicetype.md | Device type. |blackberry|100|Blackberry.| |palm|101|Palm.| |unknown|255|Represents that the device type is unknown.|-|cloudPC|257|Cloud PC device.| +|cloudPC|257|Cloud PC device.| |
v1.0 | Intune Troubleshooting Enrollmentstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-enrollmentstate.md | Namespace: microsoft.graph |pendingReset|2|| |failed|3|| |notContacted|4||-|blocked|5|| +|blocked|5|| |
v1.0 | Intune Troubleshooting Enrollmenttroubleshootingevent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-enrollmenttroubleshootingevent.md | Here is a JSON representation of the resource. "failureCategory": "String", "failureReason": "String" }-``` +``` |
v1.0 | Intune Troubleshooting Keyvaluepair | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-keyvaluepair.md | Here is a JSON representation of the resource. "name": "String", "value": "String" }-``` +``` |
v1.0 | Intune Troubleshooting Manageddevicesummarizedappstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-manageddevicesummarizedappstate.md | Here is a JSON representation of the resource. "summarizedAppState": "String", "deviceId": "String" }-``` +``` |
v1.0 | Intune Troubleshooting Mobileappactiontype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-mobileappactiontype.md | Defines the Action Types for an Intune Application. |installCommandSent|1|Application install command was sent.| |installed|3|Application installed.| |uninstalled|4|Application uninstalled.|-|userRequestedInstall|5|User requested installation| +|userRequestedInstall|5|User requested installation| |
v1.0 | Intune Troubleshooting Mobileappintent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-mobileappintent.md | Indicates the status of the mobile app on the device. |requiredUninstall|3|Required Uninstall| |requiredAndAvailableInstall|4|RequiredAndAvailableInstall| |availableInstallWithoutEnrollment|5|AvailableInstallWithoutEnrollment|-|exclude|6|Exclude| +|exclude|6|Exclude| |
v1.0 | Intune Troubleshooting Mobileappintentandstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-mobileappintentandstate.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Troubleshooting Mobileappintentandstatedetail | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-mobileappintentandstatedetail.md | Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Troubleshooting Mobileappsupporteddevicetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-mobileappsupporteddevicetype.md | Here is a JSON representation of the resource. "minimumOperatingSystemVersion": "String", "maximumOperatingSystemVersion": "String" }-``` +``` |
v1.0 | Intune Troubleshooting Mobileapptroubleshootingapppolicycreationhistory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-mobileapptroubleshootingapppolicycreationhistory.md | Here is a JSON representation of the resource. "runState": "String", "errorCode": "String" }-``` +``` |
v1.0 | Intune Troubleshooting Mobileapptroubleshootingappstatehistory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-mobileapptroubleshootingappstatehistory.md | Here is a JSON representation of the resource. "runState": "String", "errorCode": "String" }-``` +``` |
v1.0 | Intune Troubleshooting Mobileapptroubleshootingapptargethistory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-mobileapptroubleshootingapptargethistory.md | Here is a JSON representation of the resource. "runState": "String", "errorCode": "String" }-``` +``` |
v1.0 | Intune Troubleshooting Mobileapptroubleshootingappupdatehistory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-mobileapptroubleshootingappupdatehistory.md | Here is a JSON representation of the resource. ] } }-``` +``` |
v1.0 | Intune Troubleshooting Mobileapptroubleshootingdevicecheckinhistory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-mobileapptroubleshootingdevicecheckinhistory.md | Here is a JSON representation of the resource. ] } }-``` +``` |
v1.0 | Intune Troubleshooting Mobileapptroubleshootingevent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-mobileapptroubleshootingevent.md | Inherits from [deviceManagementTroubleshootingEvent](../resources/intune-trouble ## Methods |Method|Return Type|Description| |:|:|:|-|[List mobileAppTroubleshootingEvents](../api/intune-troubleshooting-mobileapptroubleshootingevent-list.md)|[mobileAppTroubleshootingEvent](../resources/intune-troubleshooting-mobileapptroubleshootingevent.md) collection|List properties and relationships of the [mobileAppTroubleshootingEvent](../resources/intune-troubleshooting-mobileapptroubleshootingevent.md) objects.| -|[Get mobileAppTroubleshootingEvent](../api/intune-troubleshooting-mobileapptroubleshootingevent-get.md)|[mobileAppTroubleshootingEvent](../resources/intune-troubleshooting-mobileapptroubleshootingevent.md)|Read properties and relationships of the [mobileAppTroubleshootingEvent](../resources/intune-troubleshooting-mobileapptroubleshootingevent.md) object.| -|[Create mobileAppTroubleshootingEvent](../api/intune-troubleshooting-mobileapptroubleshootingevent-create.md)|[mobileAppTroubleshootingEvent](../resources/intune-troubleshooting-mobileapptroubleshootingevent.md)|Create a new [mobileAppTroubleshootingEvent](../resources/intune-troubleshooting-mobileapptroubleshootingevent.md) object.| -|[Delete mobileAppTroubleshootingEvent](../api/intune-troubleshooting-mobileapptroubleshootingevent-delete.md)|None|Deletes a [mobileAppTroubleshootingEvent](../resources/intune-troubleshooting-mobileapptroubleshootingevent.md).| -|[Update mobileAppTroubleshootingEvent](../api/intune-troubleshooting-mobileapptroubleshootingevent-update.md)|[mobileAppTroubleshootingEvent](../resources/intune-troubleshooting-mobileapptroubleshootingevent.md)|Update the properties of a [mobileAppTroubleshootingEvent](../resources/intune-troubleshooting-mobileapptroubleshootingevent.md) object.| +|[List mobileAppTroubleshootingEvents](../api/intune-troubleshooting-mobileapptroubleshootingevent-list.md)|[mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) collection|List properties and relationships of the [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) objects.| +|[Get mobileAppTroubleshootingEvent](../api/intune-troubleshooting-mobileapptroubleshootingevent-get.md)|[mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md)|Read properties and relationships of the [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) object.| +|[Create mobileAppTroubleshootingEvent](../api/intune-troubleshooting-mobileapptroubleshootingevent-create.md)|[mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md)|Create a new [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) object.| +|[Delete mobileAppTroubleshootingEvent](../api/intune-troubleshooting-mobileapptroubleshootingevent-delete.md)|None|Deletes a [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md).| +|[Update mobileAppTroubleshootingEvent](../api/intune-troubleshooting-mobileapptroubleshootingevent-update.md)|[mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md)|Update the properties of a [mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. } ] }-``` +``` |
v1.0 | Intune Troubleshooting Mobileapptroubleshootinghistoryitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-mobileapptroubleshootinghistoryitem.md | Here is a JSON representation of the resource. ] } }-``` +``` |
v1.0 | Intune Troubleshooting Report | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-report.md | Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.report", "content": "Stream" }-``` +``` |
v1.0 | Intune Troubleshooting Reportroot | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-reportroot.md | The resource that represents an instance of Enrollment Failure Reports. ## Methods |Method|Return Type|Description| |:|:|:|-|[Get reportRoot](../api/intune-troubleshooting-reportroot-get.md)|[reportRoot](../resources/intune-troubleshooting-reportroot.md)|Read properties and relationships of the [reportRoot](../resources/intune-troubleshooting-reportroot.md) object.| -|[Update reportRoot](../api/intune-troubleshooting-reportroot-update.md)|[reportRoot](../resources/intune-troubleshooting-reportroot.md)|Update the properties of a [reportRoot](../resources/intune-troubleshooting-reportroot.md) object.| -|[managedDeviceEnrollmentFailureDetails function](../api/intune-troubleshooting-reportroot-manageddeviceenrollmentfailuredetails.md)|[report](../resources/intune-troubleshooting-report.md)|| -|[managedDeviceEnrollmentFailureDetails function](../api/intune-troubleshooting-reportroot-manageddeviceenrollmentfailuredetails.md)|[report](../resources/intune-troubleshooting-report.md)|| -|[managedDeviceEnrollmentFailureTrends function](../api/intune-troubleshooting-reportroot-manageddeviceenrollmentfailuretrends.md)|[report](../resources/intune-troubleshooting-report.md)|Metadata for the enrollment failure trends report| -|[managedDeviceEnrollmentTopFailures function](../api/intune-troubleshooting-reportroot-manageddeviceenrollmenttopfailures.md)|[report](../resources/intune-troubleshooting-report.md)|| -|[managedDeviceEnrollmentTopFailures function](../api/intune-troubleshooting-reportroot-manageddeviceenrollmenttopfailures.md)|[report](../resources/intune-troubleshooting-report.md)|| -|[managedDeviceEnrollmentAbandonmentSummary function](../api/intune-troubleshooting-reportroot-manageddeviceenrollmentabandonmentsummary.md)|[report](../resources/intune-troubleshooting-report.md)|Metadata for Enrollment abandonment summary report| -|[managedDeviceEnrollmentAbandonmentDetails function](../api/intune-troubleshooting-reportroot-manageddeviceenrollmentabandonmentdetails.md)|[report](../resources/intune-troubleshooting-report.md)|Metadata for Enrollment abandonment details report| +|[Get reportRoot](../api/intune-troubleshooting-reportroot-get.md)|[reportRoot](../resources/intune-shared-reportroot.md)|Read properties and relationships of the [reportRoot](../resources/intune-shared-reportroot.md) object.| +|[Update reportRoot](../api/intune-troubleshooting-reportroot-update.md)|[reportRoot](../resources/intune-shared-reportroot.md)|Update the properties of a [reportRoot](../resources/intune-shared-reportroot.md) object.| +|[managedDeviceEnrollmentFailureDetails function](../api/intune-troubleshooting-reportroot-manageddeviceenrollmentfailuredetails.md)|[report](../resources/intune-shared-report.md)|| +|[managedDeviceEnrollmentFailureDetails function](../api/intune-troubleshooting-reportroot-manageddeviceenrollmentfailuredetails.md)|[report](../resources/intune-shared-report.md)|| +|[managedDeviceEnrollmentFailureTrends function](../api/intune-troubleshooting-reportroot-manageddeviceenrollmentfailuretrends.md)|[report](../resources/intune-shared-report.md)|Metadata for the enrollment failure trends report| +|[managedDeviceEnrollmentTopFailures function](../api/intune-troubleshooting-reportroot-manageddeviceenrollmenttopfailures.md)|[report](../resources/intune-shared-report.md)|| +|[managedDeviceEnrollmentTopFailures function](../api/intune-troubleshooting-reportroot-manageddeviceenrollmenttopfailures.md)|[report](../resources/intune-shared-report.md)|| +|[managedDeviceEnrollmentAbandonmentSummary function](../api/intune-troubleshooting-reportroot-manageddeviceenrollmentabandonmentsummary.md)|[report](../resources/intune-shared-report.md)|Metadata for Enrollment abandonment summary report| +|[managedDeviceEnrollmentAbandonmentDetails function](../api/intune-troubleshooting-reportroot-manageddeviceenrollmentabandonmentdetails.md)|[report](../resources/intune-shared-report.md)|Metadata for Enrollment abandonment details report| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.reportRoot", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Troubleshooting Resultantappstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-resultantappstate.md | Not yet documented |uninstallFailed|4|The application failed to uninstall.| |pendingInstall|5|The installation of the application is in progress.| |unknown|99|The status of the application is unknown.|-|notApplicable|-1|The application is not applicable.| +|notApplicable|-1|The application is not applicable.| |
v1.0 | Intune Troubleshooting Runstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-runstate.md | Indicates the type of execution status of the device management script. |fail|2|Script failed to run.| |scriptError|3|Discovery script hits error.| |pending|4|Script is pending to execute.|-|notApplicable|5|Script is not applicable for this device.| +|notApplicable|5|Script is not applicable for this device.| |
v1.0 | Intune Troubleshooting User | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-user.md | Namespace: microsoft.graph ## Methods |Method|Return Type|Description| |:|:|:|-|[List users](../api/intune-troubleshooting-user-list.md)|[user](../resources/intune-troubleshooting-user.md) collection|List properties and relationships of the [user](../resources/intune-troubleshooting-user.md) objects.| -|[Get user](../api/intune-troubleshooting-user-get.md)|[user](../resources/intune-troubleshooting-user.md)|Read properties and relationships of the [user](../resources/intune-troubleshooting-user.md) object.| -|[Create user](../api/intune-troubleshooting-user-create.md)|[user](../resources/intune-troubleshooting-user.md)|Create a new [user](../resources/intune-troubleshooting-user.md) object.| -|[Delete user](../api/intune-troubleshooting-user-delete.md)|None|Deletes a [user](../resources/intune-troubleshooting-user.md).| -|[Update user](../api/intune-troubleshooting-user-update.md)|[user](../resources/intune-troubleshooting-user.md)|Update the properties of a [user](../resources/intune-troubleshooting-user.md) object.| +|[List users](../api/intune-troubleshooting-user-list.md)|[user](../resources/intune-shared-user.md) collection|List properties and relationships of the [user](../resources/intune-shared-user.md) objects.| +|[Get user](../api/intune-troubleshooting-user-get.md)|[user](../resources/intune-shared-user.md)|Read properties and relationships of the [user](../resources/intune-shared-user.md) object.| +|[Create user](../api/intune-troubleshooting-user-create.md)|[user](../resources/intune-shared-user.md)|Create a new [user](../resources/intune-shared-user.md) object.| +|[Delete user](../api/intune-troubleshooting-user-delete.md)|None|Deletes a [user](../resources/intune-shared-user.md).| +|[Update user](../api/intune-troubleshooting-user-update.md)|[user](../resources/intune-shared-user.md)|Update the properties of a [user](../resources/intune-shared-user.md) object.| |[getManagedDevicesWithAppFailures function](../api/intune-troubleshooting-user-getmanageddeviceswithappfailures.md)|String collection|Retrieves the list of devices with failed apps| |[getManagedDevicesWithFailedOrPendingApps function](../api/intune-troubleshooting-user-getmanageddeviceswithfailedorpendingapps.md)|[managedDeviceSummarizedAppState](../resources/intune-troubleshooting-manageddevicesummarizedappstate.md) collection|Retrieves the list of devices with failed or pending apps| Namespace: microsoft.graph |:|:|:| |deviceManagementTroubleshootingEvents|[deviceManagementTroubleshootingEvent](../resources/intune-troubleshooting-devicemanagementtroubleshootingevent.md) collection|The list of troubleshooting events for this user.| |mobileAppIntentAndStates|[mobileAppIntentAndState](../resources/intune-troubleshooting-mobileappintentandstate.md) collection|The list of troubleshooting events for this user.|-|mobileAppTroubleshootingEvents|[mobileAppTroubleshootingEvent](../resources/intune-troubleshooting-mobileapptroubleshootingevent.md) collection|The list of mobile app troubleshooting events for this user.| +|mobileAppTroubleshootingEvents|[mobileAppTroubleshootingEvent](../resources/intune-shared-mobileapptroubleshootingevent.md) collection|The list of mobile app troubleshooting events for this user.| ## JSON Representation Here is a JSON representation of the resource. Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.user", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Troubleshooting Windowsautopilotdeploymentstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-windowsautopilotdeploymentstate.md | Deployment states for Autopilot devices |successWithTimeout|4|The deployment timed out but user clicked past failure.| |notAttempted|5|The deployment was not run.| |disabled|6|The deployment is disabled.|-|successOnRetry|7|The deployment succeeded after hitting an initial timeout failure.| +|successOnRetry|7|The deployment succeeded after hitting an initial timeout failure.| |
v1.0 | Intune Troubleshooting Windowsautopilotenrollmenttype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-troubleshooting-windowsautopilotenrollmenttype.md | Namespace: microsoft.graph |azureADJoinedWithOfflineAutopilotProfile|5|| |azureADJoinedWithWhiteGlove|6|| |offlineDomainJoinedWithWhiteGlove|7||-|offlineDomainJoinedWithOfflineAutopilotProfile|8|| +|offlineDomainJoinedWithOfflineAutopilotProfile|8|| |
v1.0 | Intune Unlock Deviceappmanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-unlock-deviceappmanagement.md | Singleton entity that acts as a container for all device and app management func ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceAppManagement](../api/intune-unlock-deviceappmanagement-get.md)|[deviceAppManagement](../resources/intune-unlock-deviceappmanagement.md)|Read properties and relationships of the [deviceAppManagement](../resources/intune-unlock-deviceappmanagement.md) object.| -|[Update deviceAppManagement](../api/intune-unlock-deviceappmanagement-update.md)|[deviceAppManagement](../resources/intune-unlock-deviceappmanagement.md)|Update the properties of a [deviceAppManagement](../resources/intune-unlock-deviceappmanagement.md) object.| +|[Get deviceAppManagement](../api/intune-unlock-deviceappmanagement-get.md)|[deviceAppManagement](../resources/intune-shared-deviceappmanagement.md)|Read properties and relationships of the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object.| +|[Update deviceAppManagement](../api/intune-unlock-deviceappmanagement-update.md)|[deviceAppManagement](../resources/intune-shared-deviceappmanagement.md)|Update the properties of a [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceAppManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicyassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicyassignment.md | Here is a JSON representation of the resource. "deviceAndAppManagementAssignmentFilterType": "String" } }-``` +``` |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus.md | Here is a JSON representation of the resource. "userPrincipalName": "String", "policyVersion": "String" }-``` +``` |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicydeploymentsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentsummary.md | Here is a JSON representation of the resource. "deployedDeviceCount": 1024, "failedDeviceCount": 1024 }-``` +``` |
v1.0 | Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicystatuses | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicystatuses.md | Enum values for the various WindowsDefenderApplicationControl supplemental polic |success|1|The WindowsDefenderApplicationControl supplemental policy is in effect.| |tokenError|2|The WindowsDefenderApplicationControl supplemental policy is structurally okay but there is an error with authorizing the token.| |notAuthorizedByToken|3|The token does not authorize this WindowsDefenderApplicationControl supplemental policy.|-|policyNotFound|4|The WindowsDefenderApplicationControl supplemental policy is not found.| +|policyNotFound|4|The WindowsDefenderApplicationControl supplemental policy is not found.| |
v1.0 | Intune Wip Applicationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-wip-applicationtype.md | Possible types of Application |Member|Value|Description| |:|:|:| |universal|1|The windows universal application|-|desktop|2|The windows desktop application| +|desktop|2|The windows desktop application| |
v1.0 | Intune Wip Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-wip-devicemanagement.md | Singleton entity that acts as a container for all device management functionalit ## Methods |Method|Return Type|Description| |:|:|:|-|[Get deviceManagement](../api/intune-wip-devicemanagement-get.md)|[deviceManagement](../resources/intune-wip-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-wip-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-wip-devicemanagement-update.md)|[deviceManagement](../resources/intune-wip-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-wip-devicemanagement.md) object.| +|[Get deviceManagement](../api/intune-wip-devicemanagement-get.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| +|[Update deviceManagement](../api/intune-wip-devicemanagement-update.md)|[deviceManagement](../resources/intune-shared-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.| ## Properties |Property|Type|Description| Here is a JSON representation of the resource. "@odata.type": "#microsoft.graph.deviceManagement", "id": "String (identifier)" }-``` +``` |
v1.0 | Intune Wip Deviceplatformtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-wip-deviceplatformtype.md | Supported platform types. |windows81AndLater|5|Windows 8.1 and later| |windows10AndLater|6|Windows 10 and later.| |androidWorkProfile|7|Android Work Profile.|-|unknown|8|Unknown.| +|unknown|8|Unknown.| |
v1.0 | Intune Wip Intunebrandingprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-wip-intunebrandingprofile.md | Here is a JSON representation of the resource. "String" ] }-``` +``` |
v1.0 | Intune Wip Intunebrandingprofileassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-wip-intunebrandingprofileassignment.md | Here is a JSON representation of the resource. "entraObjectId": "String" } }-``` +``` |
v1.0 | Intune Wip Windowsinformationprotectionapplearningsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-wip-windowsinformationprotectionapplearningsummary.md | Here is a JSON representation of the resource. "applicationType": "String", "deviceCount": 1024 }-``` +``` |
v1.0 | Intune Wip Windowsinformationprotectionnetworklearningsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-wip-windowsinformationprotectionnetworklearningsummary.md | Here is a JSON representation of the resource. "url": "String", "deviceCount": 1024 }-``` +``` |
v1.0 | Invalidlicensealertincident | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/invalidlicensealertincident.md | Inherits from [unifiedRoleManagementAlertIncident](../resources/unifiedrolemanag None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Invitation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/invitation.md | Creating an invitation returns a redemption URL in the response (*inviteRedeemUr |invitedUserSponsors|[directoryObject](../resources/directoryobject.md) collection|The users or groups who are sponsors of the invited user. Sponsors are users and groups that are responsible for guest users' privileges in the tenant and for keeping the guest users' information and access up to date. | ## JSON representation-Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { |
v1.0 | Invitedusermessageinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/invitedusermessageinfo.md | The invitedUserMessageInfo object allows you to configure the [invitation](invit |messageLanguage|String|The language you want to send the default message in. If the customizedMessageBody is specified, this property is ignored, and the message is sent using the customizedMessageBody. The language format should be in ISO 639. The default is en-US.| ## JSON representation-Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- {"blockType": "resource", "@odata.type": "microsoft.graph.invitedUserMessageInfo"} --> ```json |
v1.0 | Invitenewbotresponse | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/invitenewbotresponse.md | Contains a response to a request to have a participant joining notification sent ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Inviteparticipantsoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/inviteparticipantsoperation.md | Represents the status of a long-running participant invitation operation, trigge ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Invokeuserflowlistener | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/invokeuserflowlistener.md | Inherits from the abstract base type [authenticationListener](../resources/authe ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Ipnamedlocation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/ipnamedlocation.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Iprange | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/iprange.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Ipv4cidrrange | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/ipv4cidrrange.md | Inherits from [ipRange](../resources/iprange.md) ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Ipv6cidrrange | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/ipv6cidrrange.md | Inherits from [ipRange](../resources/iprange.md) ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Itemattachment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/itemattachment.md | Derived from [attachment](attachment.md). ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Itembody | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/itembody.md | Represents properties of the body of an item, such as a message, event or group ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Itemfacet | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/itemfacet.md | Represents the abstract base type that all resource types in the [profile](profi None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Json | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/json.md | None. None. ## JSON Representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", "@odata.type": "microsoft.graph.Json" |
v1.0 | Keyvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/keyvalue.md | The configuration of this resource is shared by the following objects: ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Learningcontent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/learningcontent.md | Inherits from [entity](../resources/entity.md). |duration|Duration|The duration of the learning content in seconds. The value is represented in ISO 8601 format for durations. Optional.| |externalId|String|Unique external content ID for the learning content. Required.| |format|String|The format of the learning content. For example, `Course`, `Video`, `Book`, `Book Summary`, `Audiobook Summary`. Optional.|+|level|Level|The difficulty level of the learning content. Possible values are: `Beginner`, `Intermediate`, `Advanced`, `unknownFutureValue`. Optional.| |id|String|The unique identifier for the learning content. Not nullable. Read-only. Inherited from [entity](../resources/entity.md).| |isActive|Boolean|Indicates whether the content is active or not. Inactive content doesn't show up in the UI. The default value is `true`. Optional.| |isPremium|Boolean|Indicates whether the learning content requires the user to sign-in on the learning provider platform or not. The default value is `false`. Optional.| Inherits from [entity](../resources/entity.md). |thumbnailWebUrl|String|The URL of learning content thumbnail image. Optional.| |title|String|The title of the learning content. Required.| +## Level values +|Member|Description| +|:|:| +|Beginner|For learning content at a beginner level.| +|Intermediate|For learning content at an intermediate level.| +|Advanced|For learning content at an advanced level.| +|UnknownFutureValue|Evolvable enumeration sentinel value. Do not use.| + ## Relationships None. The following is a JSON representation of the resource. "duration": "String (duration)", "externalId": "String", "format": "String",+ "level": "String", "id": "String (identifier)", "isActive": "Boolean", "isPremium": "Boolean", |
v1.0 | Licenseassignmentstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/licenseAssignmentState.md | Title: "licenseAssignmentState resource type" description: "The **licenseAssignmentStates** property of the user entity is a collection of **licenseAssignmentState**. It provides details about license assignments to a user. The details include information like: " ms.localizationpriority: medium doc_type: resourcePageType+ The **licenseAssignmentStates** property of the [user](user.md) entity is a coll ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Licensedetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/licensedetails.md | Title: "licenseDetails resource type" description: "Contains information about a license assigned to a user." ms.localizationpriority: medium doc_type: resourcePageType+ |
v1.0 | Licenseunitsdetail | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/licenseunitsdetail.md | The **prepaidUnits** property of the [subscribedSku](subscribedsku.md) entity is ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Linkedresource_V2 | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/linkedresource_v2.md | Some **linkedResource** objects aren't associated with any web URLs, in which ca None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Linkroleabilities | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/linkroleabilities.md | + + Title: "linkRoleAbilities resource type" +description: "Represents the sharing link operations for a link of a specified role." ++ms.localizationpriority: medium ++++# linkRoleAbilities resource type ++Namespace: microsoft.graph +++Represents the sharing link operations for a link of a specified role. ++## Properties ++|Property|Type|Description| +|:|:|:| +|addExistingExternalUsers|[sharingOperationStatus](../resources/sharingoperationstatus.md)|Indicates if the current user can add existing external user recipients to this sharing link.| +|addNewExternalUsers|[sharingOperationStatus](../resources/sharingoperationstatus.md)|Indicates if the current user can add new external user recipients to this sharing link.| +|applyVariants|[sharingLinkVariants](../resources/sharinglinkvariants.md)|Indicates the status of the potential sharing link variants. If selected, it generates a separate sharing link from the sharing link that would otherwise be generated without the variant, yet with an identical role and scope.| +|createLink|[sharingOperationStatus](../resources/sharingoperationstatus.md)|Indicates if links of this role can be created.| +|deleteLink|[sharingOperationStatus](../resources/sharingoperationstatus.md)|Indicates if links of this role can be deleted.| +|linkAllowsExternalUsers|[sharingOperationStatus](../resources/sharingoperationstatus.md)|Indicates if this link can include external users.| +|linkExpiration|[sharingLinkExpirationStatus](../resources/sharinglinkexpirationstatus.md)|Indicates if links must expire, meaning the link is no longer usable after a specified time. If link expiration is enabled, a default link expiration time is provided.| +|retrieveLink|[sharingOperationStatus](../resources/sharingoperationstatus.md)|Indicates if links of this role can be retrieved.| +|updateLink|[sharingOperationStatus](../resources/sharingoperationstatus.md)|Indicates if links of this role can be updated.| ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.linkRoleAbilities" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.linkRoleAbilities", + "createLink": { + "@odata.type": "microsoft.graph.sharingOperationStatus" + }, + "retrieveLink": { + "@odata.type": "microsoft.graph.sharingOperationStatus" + }, + "updateLink": { + "@odata.type": "microsoft.graph.sharingOperationStatus" + }, + "deleteLink": { + "@odata.type": "microsoft.graph.sharingOperationStatus" + }, + "applyVariants": { + "@odata.type": "microsoft.graph.sharingLinkVariants" + }, + "linkExpiration": { + "@odata.type": "microsoft.graph.sharingLinkExpirationStatus" + }, + "addNewExternalUsers": { + "@odata.type": "microsoft.graph.sharingOperationStatus" + }, + "addExistingExternalUsers": { + "@odata.type": "microsoft.graph.sharingOperationStatus" + }, + "linkAllowsExternalUsers": { + "@odata.type": "microsoft.graph.sharingOperationStatus" + } +} +``` |
v1.0 | Linkscopeabilities | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/linkscopeabilities.md | + + Title: "linkScopeAbilities resource type" +description: "Represents the sharing abilities for each possible sharingRole within a particular sharing link scope." ++ms.localizationpriority: medium ++++# linkScopeAbilities resource type ++Namespace: microsoft.graph +++Represents the sharing abilities for each possible sharingRole within a particular sharing link scope. ++## Properties ++|Property|Type|Description| +|:|:|:| +|blockDownloadLinkAbilities|[linkRoleAbilities](../resources/linkroleabilities.md)|The blockDownload link abilities.| +|editLinkAbilities|[linkRoleAbilities](../resources/linkroleabilities.md)|The edit link abilities.| +|manageListLinkAbilities|[linkRoleAbilities](../resources/linkroleabilities.md)|The manageList link abilities.| +|readLinkAbilities|[linkRoleAbilities](../resources/linkroleabilities.md)|The read link abilities.| +|reviewLinkAbilities|[linkRoleAbilities](../resources/linkroleabilities.md)|The review link abilities.| +|submitOnlyLinkAbilities|[linkRoleAbilities](../resources/linkroleabilities.md)|The submitOnly link abilities.| ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.linkScopeAbilities" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.linkScopeAbilities", + "readLinkAbilities": { + "@odata.type": "microsoft.graph.linkRoleAbilities" + }, + "editLinkAbilities": { + "@odata.type": "microsoft.graph.linkRoleAbilities" + }, + "reviewLinkAbilities": { + "@odata.type": "microsoft.graph.linkRoleAbilities" + }, + "manageListLinkAbilities": { + "@odata.type": "microsoft.graph.linkRoleAbilities" + }, + "blockDownloadLinkAbilities": { + "@odata.type": "microsoft.graph.linkRoleAbilities" + }, + "submitOnlyLinkAbilities": { + "@odata.type": "microsoft.graph.linkRoleAbilities" + } +} +``` |
v1.0 | Listinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/listinfo.md | The **listInfo** complex type provides additional information about a [list][]. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Localeinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/localeinfo.md | Information about the locale, including the preferred language and country/regio ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Localidentitysource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/localidentitysource.md | description: "Represents local source of identity." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Locationconstraint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/locationconstraint.md | The conditions stated by a client for the location of a meeting. ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Locationconstraintitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/locationconstraintitem.md | Derived from [location](location.md). ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Loginpagelayoutconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/loginPageLayoutConfiguration.md | Contains details of the layout of the sign-in page for a tenant. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.loginPageLayoutConfiguration" |
v1.0 | Mailassessmentrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/mailassessmentrequest.md | When you create a mail threat assessment request, the mail should be received by ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Mailboxsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/mailboxsettings.md | You can [get](../api/user-get-mailboxsettings.md) or [update](../api/user-update ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Mailfolder | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/mailfolder.md | By default, [listing mailFolders](../api/user-list-mailfolders.md) returns only ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Mailtips | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/mailtips.md | as an automatic reply for a message recipient. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Mailtipserror | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/mailtipserror.md | An error that occurs during an action. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Malwarestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/malwarestate.md | Contains stateful information about the malware entity. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Managedtenants Aggregatedpolicycompliance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/managedtenants-aggregatedpolicycompliance.md | Represents an aggregate view of device compliance for a managed tenant. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Managedtenants Auditevent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/managedtenants-auditevent.md | Represents an audit event for managed tenants in Microsoft 365 Lighthouse. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Managedtenants Cloudpcconnection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/managedtenants-cloudpcconnection.md | Represents a cloud PC connection for a given managed tenant. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Managedtenants Cloudpcdevice | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/managedtenants-cloudpcdevice.md | Represents a cloud PC device that belongs to a given managed tenant. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Managedtenants Cloudpcoverview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/managedtenants-cloudpcoverview.md | Represents an overview of cloud PCs for a given managed tenant. ## Properties |Property|Type|Description| |:|:|:|+|frontlineLicensesCount|Int32|The total number of cloud PC devices that have the `Frontline` SKU. Optional. Read-only.| |id|String|The unique identifier for the cloud PC overview. Required. Read-only.| |lastRefreshedDateTime|DateTimeOffset|Date and time the entity was last updated in the multi-tenant management platform. Optional. Read-only.| |numberOfCloudPcConnectionStatusFailed|Int32|The number of cloud PC connections that have a status of `failed`. Optional. Read-only.| The following is a JSON representation of the resource. ``` json { "@odata.type": "#microsoft.graph.managedTenants.cloudPcOverview",+ "frontlineLicensesCount": "Integer", "id": "String (identifier)", "lastRefreshedDateTime": "String (timestamp)", "numberOfCloudPcConnectionStatusFailed": "Integer", |
v1.0 | Managedtenants Manageddevicecompliancetrend | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/managedtenants-manageddevicecompliancetrend.md | Represents a trend of compliant and non-compliant devices for a given managed te None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Managedtenants Tenantcustomizedinformation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/managedtenants-tenantcustomizedinformation.md | Namespace: microsoft.graph.managedTenants Represents customizable information for a managed tenant. ## Methods-|Method|Return type|Description| -|:|:|:| -|[List tenantCustomizedInformations](../api/managedtenants-managedtenant-list-tenantscustomizedinformation.md)|[microsoft.graph.managedTenants.tenantCustomizedInformation](../resources/managedtenants-tenantcustomizedinformation.md) collection|Get a list of the [tenantCustomizedInformation](../resources/managedtenants-tenantcustomizedinformation.md) objects and their properties.| -|[Get tenantCustomizedInformation](../api/managedtenants-tenantcustomizedinformation-get.md)|[microsoft.graph.managedTenants.tenantCustomizedInformation](../resources/managedtenants-tenantcustomizedinformation.md)|Read the properties and relationships of a [tenantCustomizedInformation](../resources/managedtenants-tenantcustomizedinformation.md) object.| -|[Update tenantCustomizedInformation](../api/managedtenants-tenantcustomizedinformation-update.md)|[microsoft.graph.managedTenants.tenantCustomizedInformation](../resources/managedtenants-tenantcustomizedinformation.md)|Update the properties of a [tenantCustomizedInformation](../resources/managedtenants-tenantcustomizedinformation.md) object.| +| Method | Return type | Description | +| : | :- | :- | +| [List tenantCustomizedInformations](../api/managedtenants-managedtenant-list-tenantscustomizedinformation.md) | [microsoft.graph.managedTenants.tenantCustomizedInformation](../resources/managedtenants-tenantcustomizedinformation.md) collection | Get a list of the [tenantCustomizedInformation](../resources/managedtenants-tenantcustomizedinformation.md) objects and their properties. | +| [Get tenantCustomizedInformation](../api/managedtenants-tenantcustomizedinformation-get.md) | [microsoft.graph.managedTenants.tenantCustomizedInformation](../resources/managedtenants-tenantcustomizedinformation.md) | Read the properties and relationships of a [tenantCustomizedInformation](../resources/managedtenants-tenantcustomizedinformation.md) object. | +| [Update tenantCustomizedInformation](../api/managedtenants-tenantcustomizedinformation-update.md) | [microsoft.graph.managedTenants.tenantCustomizedInformation](../resources/managedtenants-tenantcustomizedinformation.md) | Update the properties of a [tenantCustomizedInformation](../resources/managedtenants-tenantcustomizedinformation.md) object. | ## Properties-|Property|Type|Description| -|:|:|:| -|contacts|[microsoft.graph.managedTenants.tenantContactInformation](../resources/managedtenants-tenantcontactinformation.md) collection|The collection of contacts for the managed tenant. Optional.| -|displayName|String|The display name for the managed tenant. Required. Read-only.| -|id|String|The Microsoft Entra tenant identifier for the managed tenant. Required. Read-only.| -|tenantId|String|The Microsoft Entra tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md). Optional. Read-only.| -|website|String|The website for the managed tenant. Required.| +| Property | Type | Description | +| :-- | :- | :-- | +| contacts | [microsoft.graph.managedTenants.tenantContactInformation](../resources/managedtenants-tenantcontactinformation.md) collection | The collection of contacts for the managed tenant. Optional. | +| displayName | String | The display name for the managed tenant. Required. Read-only. | +| id | String | The Microsoft Entra tenant identifier for the managed tenant. Required. Read-only. | +| tenantId | String | The Microsoft Entra tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md). Optional. Read-only. | +| website | String | The website for the managed tenant. Required. | +| businessRelationship | String | Describes the relationship between the Managed Services Provider and the managed tenant; for example, Managed, Co-managed, Licensing. The maximum length is 250 characters. Optional. | +| complianceRequirements | String collection | Contains the compliance requirements for the customer tenant; for example, HIPPA, NIST, CMMC. The maximum length is 250 characters per compliance requirement. Optional. | +| managedServicesPlans | String collection | This is the Managed Services Plans for the customer tenant that the Managed Services Provider manages. The maximum length is 250 characters per managed service plan. Optional. | +| note | String | A field for the Managed Services Provider technician to input custom text to share notes between technicians within the Managed Service Providers. The maximum length is 5000 characters. Optional. | +| noteLastModifiedDateTime | DateTimeOffset | The date on which the note field of this entity was last modified. Optional. | +| partnerRelationshipManagerUserIds | String collection | The list of Entra user IDs for users in the Managed Services Provider that manage the relationship with the managed tenant. Optional. | ## Relationships None. ## JSON representation-The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", The following is a JSON representation of the resource. } --> ``` json-{ - "@odata.type": "#microsoft.graph.managedTenants.tenantCustomizedInformation", - "id": "String (identifier)", - "displayName": "String", - "tenantId": "String", - "contacts": [ {- "@odata.type": "microsoft.graph.managedTenants.tenantContactInformation" + "id": "34298981-4fc8-4974-9486-c8909ed1521b", + "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b", + "website": "https://www.fourthcoffee.com", + "contacts": [ + { + "name": "Sally", + "email": "sally@fourthcoffee.com", + "phone": "5558009731" + }, + { + "name": "Hector", + "email": "hector@fourthcoffee.com", + "phone": "5558009732" + } + ], + "businessRelationship": "Managed", + "complianceRequirements": [ + "NIST", + "HIPPA" + ], + "managedServicesPlans": [ + "Microsoft Entra ID P1" + ], + "note": "This is a test note.", + "noteLastModifiedDateTime": "2024-04-03 00:10:21.1989208", + "partnerRelationshipManagerUserIds": [ + "3c23994c-711b-46f6-ab1e-0aeef19413f3" + ] }- ], - "website": "String" -} ``` |
v1.0 | Managedtenants Tenantstatusinformation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/managedtenants-tenantstatusinformation.md | Represents onboarding status information for a managed tenant. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.managedTenants.tenantStatusInformation" |
v1.0 | Mediainfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/mediainfo.md | The media information used in actions for prompts. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Mediastream | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/mediastream.md | Contains information about the media channel. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Meetingattendancereport | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/meetingattendancereport.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Contains information associated with a meeting attendance report. +Contains information associated with a meeting attendance report for an [onlineMeeting](../resources/onlinemeeting.md) or a [virtualEvent](../resources/virtualevent.md). Meeting attendance reports are online meeting artifacts. For details, see [Online meeting artifacts and permissions](/graph/cloud-communications-online-meeting-artifacts). |
v1.0 | Meetingtimesuggestion | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/meetingtimesuggestion.md | availability, and available meeting locations. ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Meetingtimesuggestionsresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/meetingtimesuggestionsresult.md | The following are the possible reasons that [findMeetingTimes](../api/user-findm ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Mentionspreview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/mentionspreview.md | Represents information about [mention](../resources/mention.md) objects in a res ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Messagerule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/messagerule.md | Title: "messageRule resource type" -description: "A rule that applies to messages in the Inbox of a user." +description: "Represents a rule that applies to messages in the Inbox of a user." ms.localizationpriority: medium Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -A rule that applies to messages in the Inbox of a user. +Represents a rule that applies to messages in the Inbox of a user. In Outlook, you can set up rules for incoming messages in the Inbox to carry out specific actions upon certain conditions. and available rule conditions and exceptions are represented by the [messageRule | Property | Type |Description| |:|:--|:-| | actions | [messageRuleActions](messageruleactions.md) | Actions to be taken on a message when the corresponding conditions are fulfilled. |-| conditions | [messageRulePredicates](messagerulepredicates.md) | Conditions that when fulfilled, will trigger the corresponding actions for that rule. | +| conditions | [messageRulePredicates](messagerulepredicates.md) | Conditions that when fulfilled trigger the corresponding actions for that rule. | | displayName | String | The display name of the rule. | | exceptions | [messageRulePredicates](messagerulepredicates.md) | Exception conditions for the rule. | | hasError | Boolean | Indicates whether the rule is in an error condition. Read-only. | and available rule conditions and exceptions are represented by the [messageRule ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Messageruleactions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/messageruleactions.md | Represents the set of actions that are available to a rule. ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Messagerulepredicates | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/messagerulepredicates.md | Represents the set of conditions and exceptions that are available for a rule. | withinSizeRange | [sizeRange](sizerange.md) | Represents the minimum and maximum sizes (in kilobytes) that an incoming message must fall in between in order for the condition or exception to apply. | ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Mfadetail | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/mfadetail.md | Indicates MFA details for a specific sign-in. It includes the authentication met ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Microsoftauthenticatorauthenticationmethod | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/microsoftauthenticatorauthenticationmethod.md | This is a derived type that inherits from the [authenticationMethod](authenticat |device|[device](../resources/device.md)|The registered device on which Microsoft Authenticator resides. This property is null if the device is not registered for passwordless Phone Sign-In.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Microsoftauthenticatorfeaturesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/microsoftauthenticatorfeaturesettings.md | Represents Microsoft Authenticator settings such as number matching and location None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.microsoftAuthenticatorFeatureSettings" |
v1.0 | Mobilitymanagementpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/mobilitymanagementpolicy.md | In Microsoft Entra ID, a mobility management policy represents an autoenrollment ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Monthlyuserinsightmetricsroot | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/monthlyuserinsightmetricsroot.md | None. |Property|Type|Description| |:|:|:| |activeUsers|[activeUsersMetric](../resources/activeusersmetric.md) collection|Insights for active users on apps registered in the tenant for a specified period.|-|activeUsersBreakdown (deprecated)|[activeUsersBreakdownMetric](../resources/activeusersbreakdownmetric.md) collection|Insights for the breakdown of users who were active on apps registered in the tenant for a specified period.| |authentications|[authenticationsMetric](../resources/authenticationsmetric.md) collection|Insights for authentications on apps registered in the tenant for a specified period.| |mfaCompletions|[mfaCompletionMetric](../resources/mfacompletionmetric.md) collection|Insights for MFA usage on apps registered in the tenant for a specified period.| |requests|[userRequestsMetric](../resources/userrequestsmetric.md) collection| Insights for all user requests on apps registered in the tenant for a specified period.| |
v1.0 | Multitenantorganization Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/multitenantorganization-overview.md | Last updated 07/30/2023 # Multitenant organization API overview -Namespace: microsoft.graph - [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] The multitenant organization feature allows you to define an organization with more than one instance of Microsoft Entra ID. A multitenant organization enables multiple tenants to collaborate like a single entity. Also, at the time of joining, multitenant organization tenants can have a defaul If you need to increase these limits, you can submit a support request using the Azure portal or Microsoft Entra admin center. In your request, include the tenant ID of one owner tenant and a list of all tenant IDs that are intended to be part of the finalized multitenant organization. -## Next steps +## Related content + [What is a multitenant organization in Microsoft Entra ID?](/azure/active-directory/multi-tenant-organizations/overview) + [multiTenantOrganization resource type](../resources/multitenantorganization.md) |
v1.0 | Multitenantorganization | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/multitenantorganization.md | There can only be one multitenant organization per active tenant. It is not poss |tenants|[multiTenantOrganizationMember](../resources/multitenantorganizationmember.md) collection|Defines tenants added to a multitenant organization.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Multitenantorganizationidentitysyncpolicytemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/multitenantorganizationidentitysyncpolicytemplate.md | In its default and unconfigured state, where all template properties (other than None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Multitenantorganizationjoinrequestrecord | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/multitenantorganizationjoinrequestrecord.md | Defines the status of a tenant joining a multi-tenant organization. Before a ten None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Multitenantorganizationjoinrequesttransitiondetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/multitenantorganizationjoinrequesttransitiondetails.md | Details of the processing status for a tenant joining a multitenant organization None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.multiTenantOrganizationJoinRequestTransitionDetails" |
v1.0 | Multitenantorganizationmembertransitiondetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/multitenantorganizationmembertransitiondetails.md | Details of the processing status for a tenant in a multitenant organization. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.multiTenantOrganizationMemberTransitionDetails" |
v1.0 | Multitenantorganizationpartnerconfigurationtemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/multitenantorganizationpartnerconfigurationtemplate.md | In its default and unconfigured state, where all template properties (other than None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Multivaluelegacyextendedproperty | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/multivaluelegacyextendedproperty.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Networkaccess Branchconnectivityconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/networkaccess-branchconnectivityconfiguration.md | Title: "branchConnectivityConfiguration resource type" + Title: "branchConnectivityConfiguration resource type (deprecated)" description: "Specifies the connectivity details of all device links associated with a branch." ms.localizationpriority: medium-# branchConnectivityConfiguration resource type +# branchConnectivityConfiguration resource type (deprecated) Namespace: microsoft.graph.networkaccess Namespace: microsoft.graph.networkaccess Specifies the connectivity details of all device links associated with a branch. +> [!IMPORTANT] +> Deprecated and to be retired soon. Use the [remoteNetworkConnectivityConfiguration resource type](../resources/networkaccess-remotenetworkconnectivityconfiguration.md) and its associated methods instead. + ## Methods |Method|Return type|Description| |:|:|:| |
v1.0 | Networkaccess Branchsite | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/networkaccess-branchsite.md | Title: "branch resource type" + Title: "branch resource type (deprecated)" description: "A branch connects the Customer Premises Equipment (CPE) to the Global Secure Access services edge network." ms.localizationpriority: medium-# branchSite resource type +# branchSite resource type (deprecated) Namespace: microsoft.graph.networkaccess [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] +> [!IMPORTANT] +> Deprecated and to be retired soon. Use the [remoteNetwork resource type](../resources/networkaccess-remotenetwork.md) and its associated methods instead. + A branch connects the Customer Premises Equipment (CPE) to the Global Secure Access services edge network. Inherits from [microsoft.graph.entity](../resources/entity.md). Inherits from [microsoft.graph.entity](../resources/entity.md). |[Get branchSite](../api/networkaccess-branchsite-get.md)|[microsoft.graph.networkaccess.branchSite](../resources/networkaccess-branchsite.md)|Read the properties and relationships of a [microsoft.graph.networkaccess.branchSite](../resources/networkaccess-branchsite.md) object.| |[Update branchSite](../api/networkaccess-branchsite-update.md)|[microsoft.graph.networkaccess.branchSite](../resources/networkaccess-branchsite.md)|Update the properties of a [microsoft.graph.networkaccess.branchSite](../resources/networkaccess-branchsite.md) object.| |[Delete branchSite](../api/networkaccess-branchsite-delete.md)|None|Delete a [microsoft.graph.networkaccess.branchSite](../resources/networkaccess-branchsite.md) object.|-|[List deviceLinks](../api/networkaccess-branchsite-list-devicelinks.md)|[microsoft.graph.networkaccess.deviceLink](../resources/networkaccess-devicelink.md) collection|Get the deviceLink resources from the deviceLinks navigation property.| -|[Create deviceLink](../api/networkaccess-branchsite-post-devicelinks.md)|[microsoft.graph.networkaccess.deviceLink](../resources/networkaccess-devicelink.md)|Create a new deviceLink object.| -|[List forwardingProfiles](../api/networkaccess-branchsite-list-forwardingprofiles.md)|[microsoft.graph.networkaccess.forwardingProfile](../resources/networkaccess-forwardingprofile.md) collection|Get the forwardingProfile resources linked to this branchSite.| -[Create forwardingProfile](../api/networkaccess-branchsite-post-forwardingprofiles.md)|[microsoft.graph.networkaccess.forwardingProfile](../resources/networkaccess-forwardingprofile.md)|Create a new forwardingProfile object.| ## Properties |Property|Type|Description| Inherits from [microsoft.graph.entity](../resources/entity.md). |id|String|Identifier for the branch. Inherited from [microsoft.graph.entity](../resources/entity.md).| |lastModifiedDateTime|DateTimeOffset|last modified time.| |name|String|Name.|-|region|String|The branch site is created in the specified location. The possible value are: `eastUS`, `eastUS2`, `westUS`, `westUS2`, `westUS3`, `centralUS`, `northCentralUS`, `southCentralUS`, `northEurope`, `westEurope`, `franceCentral`, `germanyWestCentral`, `switzerlandNorth`, `ukSouth`, `canadaEast`, `canadaCentral`, `southAfricaWest`, `southAfricaNorth`, `uaeNorth`, `australiaEast`, `westCentralUS`, `centralIndia`, `southEastAsia`, `swedenCentral`, `southIndia`, `australiaSouthEast`, `koreaCentral`, `polandCentral`, `brazilSouth`, `japanEast`, `japanWest`, `unknownFutureValue`.| +|region|microsoft.graph.networkaccess.region|Specify the region closest to your remote network. The possible value are: `eastUS`, `eastUS2`, `westUS`, `westUS2`, `westUS3`, `centralUS`, `northCentralUS`, `southCentralUS`, `northEurope`, `westEurope`, `franceCentral`, `germanyWestCentral`, `switzerlandNorth`, `ukSouth`, `canadaEast`, `canadaCentral`, `southAfricaWest`, `southAfricaNorth`, `uaeNorth`, `australiaEast`, `westCentralUS`, `centralIndia`, `southEastAsia`, `swedenCentral`, `southIndia`, `australiaSouthEast`, `koreaCentral`, `koreaSouth`, `polandCentral`, `brazilSouth`, `japanEast`, `japanWest`, `koreaSouth`, `italyNorth`, `franceSouth`, `israelCentral`, `unknownFutureValue`.| |version|String|The branch version.| |country (deprecated)|String|The branch site is created in the specified country. **DO NOT USE.**| |
v1.0 | Networkaccess Conditionalaccesssettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/networkaccess-conditionalaccesssettings.md | Inherits from [microsoft.graph.entity](../resources/entity.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Networkaccess Connectivity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/networkaccess-connectivity.md | None. ## Relationships |Relationship|Type|Description| |:|:|:|-|branches|[microsoft.graph.networkaccess.branchSite](../resources/networkaccess-branchsite.md) collection|Branches represent locations for connectivity.| +|branches|[microsoft.graph.networkaccess.branchSite](../resources/networkaccess-branchsite.md) collection|Branches represent locations for connectivity. **DEPRECATED AND TO BE RETIRED SOON. Use the remoteNetwork relationship and its associated APIs instead.**| +|remoteNetworks|[microsoft.graph.networkaccess.remoteNetwork](../resources/networkaccess-remotenetwork.md) collection|Represent locations, such as branches, that are connected to Global Secure Access services through an IPsec tunnel.| ## JSON representation Here's is a JSON representation of the resource. |
v1.0 | Networkaccess Devicelink | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/networkaccess-devicelink.md | Title: "deviceLink resource type" -description: "A device link represents a single customer-premises equipment (CPE) at a physical branch site location that's connected to the Global Secure Access services." +description: "A device link represents a single customer-premises equipment (CPE) at a remote network that's connected to the Global Secure Access services." ms.localizationpriority: medium Namespace: microsoft.graph.networkaccess [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -A device link represents a single customer-premises equipment (CPE) at a physical branch site location that's connected to the Global Secure Access services. +A device link represents a single customer-premises equipment (CPE) at a remote network that's connected to the Global Secure Access services. Inherits from [microsoft.graph.entity](../resources/entity.md). ## Methods |Method|Return type|Description| |:|:|:|-|[List deviceLinks](../api/networkaccess-branchsite-list-devicelinks.md)|[microsoft.graph.networkaccess.deviceLink](../resources/networkaccess-devicelink.md) collection|Get a list of the [microsoft.graph.networkaccess.deviceLink](../resources/networkaccess-devicelink.md) objects and their properties.| -|[Create deviceLink](../api/networkaccess-branchsite-post-devicelinks.md)|None|Create a new [microsoft.graph.networkaccess.deviceLink](../resources/networkaccess-devicelink.md) object.| +|[List deviceLinks](../api/networkaccess-remotenetwork-list-devicelinks.md)|[microsoft.graph.networkaccess.deviceLink](../resources/networkaccess-devicelink.md) collection|Get a list of the [microsoft.graph.networkaccess.deviceLink](../resources/networkaccess-devicelink.md) objects and their properties.| +|[Create deviceLink](../api/networkaccess-remotenetwork-post-devicelinks.md)|None|Create a new [microsoft.graph.networkaccess.deviceLink](../resources/networkaccess-devicelink.md) object.| |[Get deviceLink](../api/networkaccess-devicelink-get.md)|[microsoft.graph.networkaccess.deviceLink](../resources/networkaccess-devicelink.md)|Read the properties and relationships of a [microsoft.graph.networkaccess.deviceLink](../resources/networkaccess-devicelink.md) object.|-|[Update deviceLink](../api/networkaccess-devicelink-update.md)|[microsoft.graph.networkaccess.deviceLink](../resources/networkaccess-devicelink.md)|Update the properties of a [microsoft.graph.networkaccess.deviceLink](../resources/networkaccess-devicelink.md) object.| -|[Delete deviceLink](../api/networkaccess-branchsite-delete-devicelinks.md)|None|Delete a [microsoft.graph.networkaccess.deviceLink](../resources/networkaccess-devicelink.md) object.| +|[Delete deviceLink](../api/networkaccess-devicelink-delete.md)|None|Delete a [microsoft.graph.networkaccess.deviceLink](../resources/networkaccess-devicelink.md) object.| +|[List deviceLinks for a branchSite (deprecated)](../api/networkaccess-branchsite-list-devicelinks.md)|[microsoft.graph.networkaccess.deviceLink](../resources/networkaccess-devicelink.md) collection|Get a list of the [microsoft.graph.networkaccess.deviceLink](../resources/networkaccess-devicelink.md) objects and their properties.| +|[Create deviceLink for a branchSite (deprecated)](../api/networkaccess-branchsite-post-devicelinks.md)|None|Create a new [microsoft.graph.networkaccess.deviceLink](../resources/networkaccess-devicelink.md) object.| ## Properties |Property|Type|Description| |:|:|:|-|bgpConfiguration|[microsoft.graph.networkaccess.bgpConfiguration](../resources/networkaccess-bgpconfiguration.md)|The border gateway protocol specifies the IP address and ASN for directing traffic from a link to the edge.| -|bandwidthCapacityInMbps|Int64|Determines the maximum allowed Mbps (megabits per second) bandwidth from a branch site. The possible values are:`250`,`500`,`750`,`1000`.| -|deviceVendor|microsoft.graph.networkaccess.deviceVendor|Specifies the manufacturer of the deviceLink. The possible values are: `barracudaNetworks`, `checkPoint`, `ciscoMeraki`, `citrix`, `fortinet`, `hpeAruba`, `netFoundry`, `nuage`, `openSystems`, `paloAltoNetworks`, `riverbedTechnology`, `silverPeak`, `vmWareSdWan`, `versa`, `other`, `unknownFutureValue`.| +|bgpConfiguration|[microsoft.graph.networkaccess.bgpConfiguration](../resources/networkaccess-bgpconfiguration.md)|The border gateway protocol specifies the Border Gateway Protocol (BGP) IP address and ASN for directing traffic from a link to the edge.| +|bandwidthCapacityInMbps|Int64|Determines the maximum allowed Mbps (megabits per second) bandwidth from a device link. The possible values are:`250`,`500`,`750`,`1000`.| +|deviceVendor|microsoft.graph.networkaccess.deviceVendor|Specifies the manufacturer of the deviceLink. The possible values are: `barracudaNetworks`, `checkPoint`, `ciscoMeraki`, `citrix`, `fortinet`, `hpeAruba`, `netFoundry`, `nuage`, `openSystems`, `paloAltoNetworks`, `riverbedTechnology`, `silverPeak`, `vmWareSdWan`, `versa`, `other`.| |id|String|Identifier. Inherited from [microsoft.graph.entity](../resources/entity.md).|-|ipAddress|String|Specifies the client IPv4 of the link | +|ipAddress|String|The public IP address of your CPE (customer premise equipment) device. | |lastModifiedDateTime|DateTimeOffset|last modified time.| |name|String|Name.| |tunnelConfiguration|[microsoft.graph.networkaccess.tunnelConfiguration](../resources/networkaccess-tunnelconfiguration.md)|The connectivity settings, including the protocol, IPSec policy, and preshared key, are specified for establishing connectivity.| |
v1.0 | Networkaccess Enrichedauditlogssettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/networkaccess-enrichedauditlogssettings.md | Represents a configuration object that centralizes enriched audit logs settings None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.networkaccess.enrichedAuditLogsSettings" |
v1.0 | Networkaccess Forwardingpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/networkaccess-forwardingpolicy.md | Inherits from [microsoft.graph.networkaccess.policy](../resources/networkaccess- |policyRules|[microsoft.graph.networkaccess.policyRule](../resources/networkaccess-policyrule.md) collection| Represents the definition of the policy ruleset that makes up the core definition of a policy. Inherited from [microsoft.graph.networkaccess.policy](../resources/networkaccess-policy.md). Supports `$expand`.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Networkaccess Forwardingprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/networkaccess-forwardingprofile.md | Inherits from [microsoft.graph.networkaccess.profile](../resources/networkaccess ## Properties |Property|Type|Description| |:|:|:|-|associations|[microsoft.graph.networkaccess.association](../resources/networkaccess-association.md) collection|Specifies the users, groups, devices, and branch locations whose traffic is associated with the given traffic forwarding profile.| +|associations|[microsoft.graph.networkaccess.association](../resources/networkaccess-association.md) collection|Specifies the users, groups, devices, and remote networks whose traffic is associated with the given traffic forwarding profile.| |description|String|Profile description. Inherited from [microsoft.graph.networkaccess.profile](../resources/networkaccess-profile.md).| |id|String|Identifier for the profile. Inherited from [microsoft.graph.entity](../resources/entity.md).| |lastModifiedDateTime|DateTimeOffset|Profile last modified time. Inherited from [microsoft.graph.networkaccess.profile](../resources/networkaccess-profile.md).| The following is a JSON representation of the resource. "trafficForwardingType": "String", "associations": [ {- "@odata.type": "microsoft.graph.networkaccess.associatedBranch" + "@odata.type": "microsoft.graph.networkaccess.association" } ], "priority": "Integer" |
v1.0 | Networkaccess Global Secure Access Api Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/networkaccess-global-secure-access-api-overview.md | The network access APIs provide a framework to configure how you want to forward | [forwardingPolicy](../resources/networkaccess-forwardingpolicy.md) | Defines the rules for routing or bypassing specific traffic type through the Global Secure Access services. Each policy is tried to one traffic type that can be Microsoft 365, Internet, or Private traffic. A forwarding policy can have only forwarding policy rules. | | [forwardingPolicyLink](../resources/networkaccess-forwardingpolicylink.md) | Represents the relationship between a forwarding profile and a forwarding policy, and maintains the current state of the connection.| | [policyRule](../resources/networkaccess-policyrule.md) | Maintains the core definition of a policy ruleset. |-| [branchSite](../resources/networkaccess-branchsite.md) | Represents the physical branch office locations from where users and devices connect to access the cloud, public, or private apps. Each branch comprises devices and the connection of devices in a branch is maintained via customer-premises equipment (CPE).| --<!-- -| Filtering profiles | Groups filtering policies, which are then associated with Conditional Access policies in Azure AD to leverage a rich set of user-context conditions.| -| Filtering policies | Encapsulates various policies configured by administrators, such as network filtering policies, data loss prevention, and threat protection.| -| [Filtering policy links](../resources/networkaccess-filteringpolicylink.md) | Represents the relationship between a filtering profile and a filtering policy, and maintains the current state of the connection.| >+| [remoteNetwork](../resources/networkaccess-remotenetwork.md) | Represents the physical location from where users and devices connect to access the cloud, public, or private apps. Each remote network comprises devices and the connection of devices in a remote network is maintained via customer-premises equipment (CPE).| +| [filteringProfile](../resources/networkaccess-filteringprofile.md) | Groups filtering policies, which are then associated with Conditional Access policies in Microsoft Entra to leverage a rich set of user-context conditions.| +| [filteringPolicy](../resources/networkaccess-filteringpolicy.md) | Encapsulates various policies configured by administrators, such as network filtering policies, data loss prevention, and threat protection.| +| [filteringPolicLink](../resources/networkaccess-filteringpolicylink.md) | Represents the relationship between a filtering profile and a filtering policy, and maintains the current state of the connection.| ## Onboard to the service process The following APIs allow an admin to manage and configure forwarding profiles. T | Sample operations | Description | |--|--| | [List forwarding profiles](../api/networkaccess-networkaccessroot-list-forwardingprofiles.md) | List the forwarding profiles configured for the tenant. You can also retrieve the associated policies using the `$expand` query parameter.|-| [Update forwardingProfile](../api/networkaccess-forwardingprofile-update.md) | Enable or disable a forwarding profile or configure associations such as the branch. | +| [Update forwardingProfile](../api/networkaccess-forwardingprofile-update.md) | Enable or disable a forwarding profile or configure associations such as the remote network. | | [List forwarding policies](../api/networkaccess-networkaccessroot-list-forwardingpolicies.md) | List the forwarding policies configured for the tenant. You can also retrieve the associated forwarding policy rules using the `$expand` query parameter.| | [List forwarding policy links](../api/networkaccess-forwardingprofile-list-policies.md) | List the policy links associated with a forwarding profile. You can also retrieve the associated forwarding policy rules using the `$expand` query parameter.| -## Branches +## Remote networks -A branch or remote network scenario involves user devices or user-less devices like printers establishing connectivity via customer-premises equipment (CPE), also known as device links, at the physical branch office location. +A remote network scenario involves user devices or user-less devices like printers establishing connectivity via customer-premises equipment (CPE), also known as device links, at a physical office location. -Use the following APIs to manage the branch details once a branch is onboarded to the service. +Use the following APIs to manage the details of a remote network that you've onboarded to the service. | Sample operations | Description | |--|--|-| [Create a branch](../api/networkaccess-connectivity-post-branches.md) <br/>[Create device links for a branch](../api/networkaccess-branchsite-post-devicelinks.md) <br/>[Create forwarding profiles for a branch](../api/networkaccess-branchsite-post-forwardingprofiles.md)| Create branches and their associated device links and forwarding profiles.| -| [List branches](../api/networkaccess-connectivity-list-branches.md) <br/>[List device links for a branch](../api/networkaccess-branchsite-list-devicelinks.md) <br/>[List forwarding profiles for a branch](../api/networkaccess-branchsite-list-forwardingprofiles.md)| List branches and their associated device links and forwarding profiles.| +| [Create a remote network](../api/networkaccess-connectivity-post-remotenetworks.md) <br/>[Create device links for a remote network](../api/networkaccess-remotenetwork-post-devicelinks.md) <br/>[Create forwarding profiles for a remote network](../api/networkaccess-remotenetwork-post-forwardingprofiles.md)| Create remote networks and their associated device links and forwarding profiles.| +| [List remote networks](../api/networkaccess-connectivity-list-remotenetworks.md) <br/>[List device links for a remote network](../api/networkaccess-remotenetwork-list-devicelinks.md) <br/>[List forwarding profiles for a remote network](../api/networkaccess-remotenetwork-list-forwardingprofiles.md)| List remote networks and their associated device links and forwarding profiles.| ## Access controls Forwarding options allows administrators to enable or disable the ability to ski ## Audit logs -Monitoring and auditing of events within your environment is crucial for maintaining security, compliance, and operational efficiency. The Global Secure Access events are logged in the [directory logs](../resources/directoryaudit.md) and can be retrieved using associated APIs. --<!-- -```msgraph-interactive -GET https://graph.microsoft.com/beta/auditLogs/directoryAudits?$filter= -``` >+Monitoring and auditing of events within your environment is crucial for maintaining security, compliance, and operational efficiency. The Global Secure Access events are logged in the [directory logs](../resources/directoryaudit.md) and [sign-in logs](../resources/signin.md) can be retrieved using associated APIs. ## Traffic logs and reports |
v1.0 | Networkaccess Localconnectivityconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/networkaccess-localconnectivityconfiguration.md | Specifies the Microsoft end of the tunnel configuration for a device link. |asn|Int32|Specifies ASN of one end of IPSec tunnel (local or peer).| |bgpAddress|String|Specifies BGP IPv4 address of one end of IPSec tunnel (local or peer).| |endpoint|String|Specifies public IPv4 address of one end of IPSec tunnel (local or peer).|-|region|microsoft.graph.networkaccess.region| Specifies the region in which the Microsoft end of the tunnel exists. Not applicable for peer configuration. The possible values are: `eastUS`, `eastUS2`, `westUS`, `westUS2`, `westUS3`, `centralUS`, `northCentralUS`, `southCentralUS`, `northEurope`, `westEurope`, `franceCentral`, `germanyWestCentral`, `switzerlandNorth`, `ukSouth`, `canadaEast`, `canadaCentral`, `southAfricaWest`, `southAfricaNorth`, `uaeNorth`,`unknownFutureValue`.| +|region|microsoft.graph.networkaccess.region|Specify the region closest to your remote network. Not applicable for peer configuration. The possible value are: `eastUS`, `eastUS2`, `westUS`, `westUS2`, `westUS3`, `centralUS`, `northCentralUS`, `southCentralUS`, `northEurope`, `westEurope`, `franceCentral`, `germanyWestCentral`, `switzerlandNorth`, `ukSouth`, `canadaEast`, `canadaCentral`, `southAfricaWest`, `southAfricaNorth`, `uaeNorth`, `australiaEast`, `westCentralUS`, `centralIndia`, `southEastAsia`, `swedenCentral`, `southIndia`, `australiaSouthEast`, `koreaCentral`, `koreaSouth`, `polandCentral`, `brazilSouth`, `japanEast`, `japanWest`, `koreaSouth`, `italyNorth`, `franceSouth`, `israelCentral`, `unknownFutureValue`.| ## Relationships None. |
v1.0 | Networkaccess M365forwardingrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/networkaccess-m365forwardingrule.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Networkaccess Networkaccessroot | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/networkaccess-networkaccessroot.md | None. |tenantStatus|[microsoft.graph.networkaccess.tenantStatus](../resources/networkaccess-tenantstatus.md)|Represents the status of the Global Secure Access services for the tenant.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Networkaccess Policylink | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/networkaccess-policylink.md | None. |policy|[microsoft.graph.networkaccess.policy](../resources/networkaccess-policy.md)|Policy. | ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Networkaccess Privateaccessforwardingrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/networkaccess-privateaccessforwardingrule.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Networkaccess Profile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/networkaccess-profile.md | Inherits from [microsoft.graph.entity](../resources/entity.md). |policies|[microsoft.graph.networkaccess.policyLink](../resources/networkaccess-policylink.md) collection|Traffic forwarding policies associated with this profile.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Networkaccess Remotenetwork | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/networkaccess-remotenetwork.md | + + Title: "remoteNetwork resource type" +description: "A remote network represents a location such as a branch office where customer premises equipment (CPE) is connected to the nearest deployment of Global Secure Access service though IPsec tunnels." ++ms.localizationpriority: medium ++++# remoteNetwork resource type ++Namespace: microsoft.graph.networkaccess +++A remote network represents a location such as a branch office where customer premises equipment (CPE) is connected to the nearest deployment of Global Secure Access service though IPsec tunnels. ++Inherits from [microsoft.graph.entity](../resources/entity.md). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List remoteNetworks](../api/networkaccess-connectivity-list-remotenetworks.md)|[microsoft.graph.networkaccess.remoteNetwork](../resources/networkaccess-remotenetwork.md) collection|Get a list of the [microsoft.graph.networkaccess.remoteNetwork](../resources/networkaccess-remotenetwork.md) objects and their properties.| +|[Create remoteNetwork](../api/networkaccess-connectivity-post-remotenetworks.md)|[microsoft.graph.networkaccess.remoteNetwork](../resources/networkaccess-remotenetwork.md)|Create a new [microsoft.graph.networkaccess.remoteNetwork](../resources/networkaccess-remotenetwork.md) object.| +|[Get remoteNetwork](../api/networkaccess-remotenetwork-get.md)|[microsoft.graph.networkaccess.remoteNetwork](../resources/networkaccess-remotenetwork.md)|Read the properties and relationships of a [microsoft.graph.networkaccess.remoteNetwork](../resources/networkaccess-remotenetwork.md) object.| +|[Update remoteNetwork](../api/networkaccess-remotenetwork-update.md)|[microsoft.graph.networkaccess.remoteNetwork](../resources/networkaccess-remotenetwork.md)|Update the properties of a [microsoft.graph.networkaccess.remoteNetwork](../resources/networkaccess-remotenetwork.md) object.| +|[Delete remoteNetwork](../api/networkaccess-connectivity-delete-remotenetworks.md)|None|Delete a [microsoft.graph.networkaccess.remoteNetwork](../resources/networkaccess-remotenetwork.md) object.| ++## Properties +|Property|Type|Description| +|:|:|:| +|id|String|Identifier for the remote network. Inherited from [microsoft.graph.entity](../resources/entity.md).| +|lastModifiedDateTime|DateTimeOffset|last modified time.| +|name|String|Name.| +|region|microsoft.graph.networkaccess.region|Specify the region closest to your remote network. The possible value are: `eastUS`, `eastUS2`, `westUS`, `westUS2`, `westUS3`, `centralUS`, `northCentralUS`, `southCentralUS`, `northEurope`, `westEurope`, `franceCentral`, `germanyWestCentral`, `switzerlandNorth`, `ukSouth`, `canadaEast`, `canadaCentral`, `southAfricaWest`, `southAfricaNorth`, `uaeNorth`, `australiaEast`, `westCentralUS`, `centralIndia`, `southEastAsia`, `swedenCentral`, `southIndia`, `australiaSouthEast`, `koreaCentral`, `koreaSouth`, `polandCentral`, `brazilSouth`, `japanEast`, `japanWest`, `koreaSouth`, `italyNorth`, `franceSouth`, `israelCentral`, `unknownFutureValue`.| +|version|String|Remote network version.| ++## Relationships +|Relationship|Type|Description| +|:|:|:| +|connectivityConfiguration|[microsoft.graph.networkaccess.remoteNetworkConnectivityConfiguration](../resources/networkaccess-remotenetworkconnectivityconfiguration.md) collection|Specifies the connectivity details of all device links associated with a remote network.| +|deviceLinks|[microsoft.graph.networkaccess.deviceLink](../resources/networkaccess-devicelink.md) collection|Each unique CPE device associated with a remote network is specified. Supports `$expand`.| +|forwardingProfiles|[microsoft.graph.networkaccess.forwardingProfile](../resources/networkaccess-forwardingprofile.md) collection|Each forwarding profile associated with a remote network is specified. Supports `$expand` and `$select`.| ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.networkaccess.remoteNetwork", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.networkaccess.remoteNetwork", + "id": "String (identifier)", + "lastModifiedDateTime": "String (timestamp)", + "name": "String", + "region": "microsoft.graph.networkaccess.region", + "version": "String", +} +``` + |
v1.0 | Networkaccess Remotenetworkconnectivityconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/networkaccess-remotenetworkconnectivityconfiguration.md | + + Title: "remoteNetworkConnectivityConfiguration resource type" +description: "Specifies the connectivity details of all device links associated with a remote network." ++ms.localizationpriority: medium ++++# remoteNetworkConnectivityConfiguration resource type ++Namespace: microsoft.graph.networkaccess +++Specifies the connectivity details of all device links associated with a remote network. ++## Methods +|Method|Return type|Description| +|:|:|:| +|[Get remoteNetworkConnectivityConfiguration](../api/networkaccess-remotenetworkconnectivityconfiguration-get.md)|[microsoft.graph.networkaccess.remoteNetworkConnectivityConfiguration](../resources/networkaccess-remotenetworkconnectivityconfiguration.md)|Read the properties and relationships of a [microsoft.graph.networkaccess.remoteNetworkConnectivityConfiguration](../resources/networkaccess-remotenetworkconnectivityconfiguration.md) object.| ++## Properties +|Property|Type|Description| +|:|:|:| +|remoteNetworkId|String|Unique identifier or a specific reference assigned to a branchSite. Key.| +|remoteNetworkName|String|Display name assigned to a branchSite.| ++## Relationships +|Relationship|Type|Description| +|:|:|:| +|links|[microsoft.graph.networkaccess.connectivityConfigurationLink](../resources/networkaccess-connectivityconfigurationlink.md) collection|List of connectivity configurations for [deviceLink](../resources/networkaccess-devicelink.md) objects.| ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "remoteNetworkId", + "@odata.type": "microsoft.graph.networkaccess.remoteNetworkConnectivityConfiguration", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.networkaccess.remoteNetworkConnectivityConfiguration", + "remoteNetworkId": "String (identifier)", + "remoteNetworkName": "String" +} +``` + |
v1.0 | Networkaccess Tenantstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/networkaccess-tenantstatus.md | Inherits from [microsoft.graph.entity](../resources/entity.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Networkaccess Tunnelconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/networkaccess-tunnelconfiguration.md | This is an abstract type from which the [microsoft.graph.networkaccess.tunnelCon |Property|Type|Description| |:|:|:| |preSharedKey|String|A key to establish secure connection between the link and VPN tunnel on the edge.|+|zoneRedundancyPreSharedKey|String|Another key for zone redundant tunnel. Required only when you select `zoneRedundancy` redindancyTier when creating a deviceLink.| ## Relationships None. The following is a JSON representation of the resource. ``` json { "@odata.type": "#microsoft.graph.networkaccess.tunnelConfiguration",- "preSharedKey": "String" + "preSharedKey": "String", + "zoneRedundancyPreSharedKey": "String" } ``` |
v1.0 | Networkaccess Tunnelconfigurationikev2default | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/networkaccess-tunnelconfigurationikev2default.md | Inherits from [microsoft.graph.networkaccess.tunnelConfiguration](../resources/n None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.networkaccess.tunnelConfigurationIKEv2Default" |
v1.0 | Networkinterface | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/networkinterface.md | Represents a Network Interface Card (NIC) associated with this host. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Noentitlementsdatacollection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/noentitlementsdatacollection.md | description: "Represents the details and status of data collection about permiss ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Nomfaonroleactivationalertconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/nomfaonroleactivationalertconfiguration.md | Inherits from [unifiedRoleManagementAlertConfiguration](../resources/unifiedrole |alertDefinition|[unifiedRoleManagementAlertDefinition](../resources/unifiedrolemanagementalertdefinition.md)| The definition of the alert that contains its description, impact, and measures to mitigate or prevent it. Supports `$expand`.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Nomfaonroleactivationalertincident | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/nomfaonroleactivationalertincident.md | Inherits from [unifiedRoleManagementAlertIncident](../resources/unifiedrolemanag None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Notebook | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/notebook.md | A OneNote notebook. ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Notebooklinks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/notebooklinks.md | Links for opening a OneNote notebook. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Objectidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/objectidentity.md | Title: "objectIdentity resource type" description: "Represents an identity used to sign in to a user account." ms.localizationpriority: medium doc_type: resourcePageType+ |
v1.0 | Office365activeuserdetail | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/office365activeuserdetail.md | Title: "office365ActiveUserDetail resource type" -description: "Here's a JSON representation of the resource." +description: "The following JSON representation shows the resource type." ms.localizationpriority: medium Namespace: microsoft.graph ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Office365groupsactivitydetail | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/office365groupsactivitydetail.md | Title: "office365GroupsActivityDetail resource type" -description: "Here's a JSON representation of the resource." +description: "The following JSON representation shows the resource type." ms.localizationpriority: medium Namespace: microsoft.graph ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Office365groupsactivityfilecounts | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/office365groupsactivityfilecounts.md | Title: "office365GroupsActivityFileCounts resource type" -description: "Here's a JSON representation of the resource." +description: "The following JSON representation shows the resource type." ms.localizationpriority: medium Namespace: microsoft.graph ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { |
v1.0 | Office365groupsactivitygroupcounts | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/office365groupsactivitygroupcounts.md | Title: "office365GroupsActivityGroupCounts resource type" -description: "Here's a JSON representation of the resource." +description: "The following JSON representation shows the resource type." ms.localizationpriority: medium Namespace: microsoft.graph ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Officegraphinsights | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/officegraphinsights.md | Each insight is returned with a **resourceVisualization** and **resourceReferenc ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty":"id", |
v1.0 | Onenoteidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/onenoteidentity.md | In future, this type is merged with [identity](identity.md) ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Onenoteidentityset | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/onenoteidentityset.md | In future, this type will be merged with [IdentitySet](identityset.md) ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Onenoteoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/onenoteoperation.md | The status of certain long-running OneNote operations. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Onenoteoperationerror | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/onenoteoperationerror.md | An error from a failed OneNote operation. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Onenotepage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/onenotepage.md | A page in a OneNote notebook. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Onenotesection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/onenotesection.md | A section in a OneNote notebook. Sections can contain pages. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Oninteractiveauthflowstartexternalusersselfservicesignup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/oninteractiveauthflowstartexternalusersselfservicesignup.md | Inherits from [onInteractiveAuthFlowStartHandler](../resources/oninteractiveauth None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.onInteractiveAuthFlowStartExternalUsersSelfServiceSignUp" |
v1.0 | Onlinemeetinginfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/onlinemeetinginfo.md | Details for an attendee to join the meeting online. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Onpremisesagent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/onpremisesagent.md | Represents on-premises agent. On-premises agents installed by a tenant administr ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Onpremisescurrentexportdata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/onpremisescurrentexportdata.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.onPremisesCurrentExportData" |
v1.0 | Onpremisesdirectorysynchronization | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/onpremisesdirectorysynchronization.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Onpremisesextensionattributes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/onpremisesextensionattributes.md | Title: "onPremisesExtensionAttributes resource type" description: "The **onPremisesExtensionAttributes** property of the user entity contains fifteen custom extension attribute properties." ms.localizationpriority: medium doc_type: resourcePageType+ |
v1.0 | Onpremisesprovisioningerror | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/onpremisesprovisioningerror.md | Represents directory synchronization errors for the [user](user.md), [group](gro |value|String| Value of the property causing the error. | ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Onpremisespublishing | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/onpremisespublishing.md | For a tutorial about configuring Application Proxy, see [Automate the configurat ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Onpremisespublishingprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/onpremisespublishingprofile.md | Various Azure services (for example, Microsoft Entra Connect [Passthrough Authen |:-|:|:| |hybridAgentUpdaterConfiguration|[hybridAgentUpdaterConfiguration](hybridagentupdaterconfiguration.md)| Represents a **hybridAgentUpdaterConfiguration** object.| |id|String| Represents a publishing type. Possible values are: `applicationProxy`, `exchangeOnline`, `authentication`, `provisioning`, `adAdministration`. Read-only.|-|isEnabled|Boolean| Represents if [Microsoft Entra application proxy](/azure/active-directory/app-proxy/what-is-application-proxy) is enabled for the tenant. | +|isEnabled|Boolean| Represents if [Microsoft Entra application proxy](/entra/identity/app-proxy/) is enabled for the tenant. | ## Relationships |
v1.0 | Onpremisessipinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/onpremisessipinfo.md | Title: "onPremisesSipInfo resource type" description: "onPremisesSipInfo resource type" ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Onusercreatestartexternalusersselfservicesignup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/onusercreatestartexternalusersselfservicesignup.md | Inherits from [onUserCreateStartHandler](../resources/onusercreatestarthandler.m None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.onUserCreateStartExternalUsersSelfServiceSignUp" |
v1.0 | Openawssecuritygroupfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/openawssecuritygroupfinding.md | description: "View AWS open security groups." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Openidconnectidentityprovider | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/openidconnectidentityprovider.md | Inherits from [identityProviderBase](../resources/identityproviderbase.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Openidconnectprovider | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/openidconnectprovider.md | Inherits from [identityProvider](../resources/identityprovider.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Openidconnectsetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/openidconnectsetting.md | + + Title: "openIdConnectSetting resource type" +description: "Specifies the OpenID connection properties used for an external authentication method." ++ms.localizationpriority: medium ++++# openIdConnectSetting resource type ++Namespace: microsoft.graph +++A complex type that contains the settings required to perform the OIDC request to the external authentication provider for an external authentication method. External authentication methods enable Microsoft Entra ID users to satisfy the second factor of multifactor authentication requirements using an external provider. ++## Properties +|Property|Type|Description| +|:|:|:| +|clientId|String|The Microsoft Entra ID's client ID as generated by the provider or admin to identify Microsoft Entra ID. In OIDC parlance, this is the client_id that external identity provider assigns to Microsoft Entra ID, which is also a recipient of a token from the external identity provider.| +|discoveryUrl|String|The host URL of the external identity provider's OIDC discovery endpoint. This endpoint must support the OIDC discovery process.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.openIdConnectSetting" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.openIdConnectSetting", + "clientId": "String", + "discoveryUrl": "String" +} +``` + |
v1.0 | Opennetworkazuresecuritygroupfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/opennetworkazuresecuritygroupfinding.md | description: "View Azure open security groups." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Opentypeextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/opentypeextension.md | description: "Open extensions (formerly known as Office 365 data extensions) pro ms.localizationpriority: medium doc_type: resourcePageType+ # openTypeExtension resource type (open extensions) Namespace: microsoft.graph Represents open extensions (also known as open type extensions, and formerly known as Office 365 data extensions), an [extensibility option](/graph/extensibility-overview) that provides an easy way to directly add untyped properties to a resource in Microsoft Graph. -Any open extension added to a resource shows up in the **extensions** navigation property. Each extension has an **extensionName** property which is the only pre-defined, writable property for all extensions, along with your custom data. One way to help make sure extension names are unique is to use a reverse domain name system (DNS) format that is dependent on _your own domain_, for example, `com.contoso.ContactInfo`. **Do not use** the Microsoft domain (`com.microsoft` or `com.onmicrosoft`) in an extension name. +Any open extension added to a resource shows up in the **extensions** navigation property. Each extension has an **extensionName** property, which is the only predefined, writable property for all extensions, along with your custom data. One way to help make sure extension names are unique is to use a reverse domain name system (DNS) format that is dependent on _your own domain_, for example, `com.contoso.ContactInfo`. **Do not use** the Microsoft domain (`com.microsoft` or `com.onmicrosoft`) in an extension name. Derives from the [extension](extension.md) abstract type. -Open extensions are supported by the following resources. +The following resource support open extensions: + [user](/graph/api/resources/user) + [group](/graph/api/resources/group) For more information about Microsoft Graph extensibility including limits for op ### Outlook-specific considerations -Each open extension present on an Outlook resource (event, message, or personal contact) is stored in a [MAPI named property](/office/client-developer/outlook/mapi/mapi-named-properties). When you create open extensions for Outlook, consider that MAPI named properties are a finite resource in a user's mailbox. When a user's named property quota is exhausted, you can't create any more named properties for that user. This can result in unexpected behavior from clients that rely on named properties to function. +Each open extension on an Outlook resource (event, message, or personal contact) is stored in a [MAPI named property](/office/client-developer/outlook/mapi/mapi-named-properties). When you create open extensions for Outlook, consider that MAPI named properties are a finite resource in a user's mailbox. When a user's named property quota is exhausted, you can't create anymore named properties for that user. This can result in unexpected behavior from clients that rely on named properties to function. Apply the following guidelines when you create open extensions on Outlook resources: -- Create the minimum number of extensions required. Most applications should require no more than one extension. Extensions have no set defined properties or structure, so you can store multiple values in a single extension.-- Avoid naming extensions in a variable manner (such as based on user input, etc.). Each time an open extension is created with a new name that has not been used in a user's mailbox before, a new MAPI named property is created. Removing the extension does not remove the named property.+- Create the minimum number of extensions required. Most applications should require no more than one extension. Extensions have no defined properties or structure, so you can store multiple values in a single extension. +- Avoid naming extensions in a variable manner (such as based on user input, etc.). Each time an open extension is created with a new name that hasn't been used in a user's mailbox before, a new MAPI named property is created. Removing the extension doesn't remove the named property. ### Use open extensions (for Outlook resources) or extended properties -Open extensions are the recommended solution for most scenarios involving storing and accessing custom data. If, however, you need to access custom data for Outlook MAPI properties that are not already exposed through the [Microsoft Graph API metadata](/graph/traverse-the-graph#microsoft-graph-api-metadata), you can use [extended properties and its REST API](extended-properties-overview.md). You can verify which properties the metadata +Open extensions are the recommended solution for most scenarios involving storing and accessing custom data. If, however, you need to access custom data for Outlook MAPI properties that aren't already exposed through the [Microsoft Graph API metadata](/graph/traverse-the-graph#microsoft-graph-api-metadata), you can use [extended properties and its REST API](extended-properties-overview.md). You can verify which properties the metadata exposes at https://graph.microsoft.com/v1.0/$metadata. ## Methods exposes at https://graph.microsoft.com/v1.0/$metadata. | Property | Type | Description | |:|:--|:-| |extensionName|String|A unique text identifier for an open type data extension. Required.|-|id|String| A fully qualified identifier that concatenates the extension type with the **extensionName**. Read-only. <br/><br/> The **id** must be defined during the Create operation via one of the following ways: <ul><li> Explicitly define the **id** property in the request body. <li> Define an **extensionName** property in the request body, and Microsoft Graph automatically assigns the same value to the **id** property. <ul><li> In subsequent updates, you can change the **extensionName** property value to one that's different from the **id** value. <li>In subsequent updates, specifying only the **id** property in the request body automatically deletes the **extensionName** property from the open extension.</ul></ul>| +|id|String| A fully qualified identifier that concatenates the extension type with the **extensionName**. Read-only. <br/><br/> The **id** must be defined during the *Create* operation via one of the following ways: <ul><li> Explicitly define the **id** property in the request body. <li> Define an **extensionName** property in the request body, and Microsoft Graph automatically assigns the same value to the **id** property. <ul><li> In subsequent updates, you can change the **extensionName** property value to one that's different from the **id** value. <li>In subsequent updates, specifying only the **id** property in the request body automatically deletes the **extensionName** property from the open extension.</ul></ul>| ## Relationships None ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Optionalclaims | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/optionalclaims.md | Application developers can configure optional claims in their Microsoft Entra ap |saml2Token|[optionalClaim](optionalclaim.md) collection| The optional claims returned in the SAML token.| ## JSON Representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", "@odata.type": "microsoft.graph.optionalClaims" |
v1.0 | Organizationsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/organizationsettings.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + Contains settings that are applicable to the [organization](organization.md) or that should be applied to [user](user.md) objects within an organization. Inherits from [entity](entity.md). Inherits from [entity](entity.md). | Method | Return Type | Description | |:-|:|:| | [List contactInsights](../api/organizationsettings-list-contactinsights.md) | [insightsSettings](insightssettings.md) | Get the properties of an [insightsSettings](insightssettings.md) object for displaying or returning insights for the contacts of users in an organization. |-| [List itemInsights](../api/organizationsettings-list-iteminsights.md) | [insightsSettings](insightssettings.md) | Get the properties of an [insightsSettings](insightssettings.md) object for displaying or returning item insights in an organization. | | [List microsoftApplicationDataAccessSettings](../api/organizationsettings-list-microsoftapplicationdataaccess.md) | [microsoftApplicationDataAccessSettings](microsoftapplicationdataaccesssettings.md) | Get the properties of a [microsoftApplicationDataAccessSettings](microsoftapplicationdataaccesssettings.md) object that specify access from Microsoft applications to Microsoft 365 user data in an organization. | | [List peopleInsights](../api/organizationsettings-list-peopleinsights.md) | [insightsSettings](insightssettings.md) | Get the properties of an [insightsSettings](insightssettings.md) object for displaying or returning people insights in an organization. |+| [List itemInsights](../api/organizationsettings-list-iteminsights.md) (deprecated) | [insightsSettings](insightssettings.md) | Get the properties of an [insightsSettings](insightssettings.md) object for displaying or returning item insights in an organization. | ## Properties Inherits from [entity](entity.md). |:-|:|:| |id |String| Id of the settings object for the organization. | |contactInsights|[insightsSettings](insightssettings.md)|Contains the properties that are configured by an administrator as a tenant-level privacy control whether to identify duplicate contacts among a user's contacts list and suggest the user to merge those contacts to have a cleaner contacts list. [List contactInsights](../api/organizationsettings-list-contactinsights.md) returns the _settings_ to display or return contact insights in an organization.|-|itemInsights|[insightsSettings](insightssettings.md)| Contains the properties that are configured by an administrator for the visibility of Microsoft Graph-derived insights, between a user and other items in Microsoft 365, such as documents or sites. [List itemInsights](../api/organizationsettings-list-iteminsights.md) returns the _settings_ to display or return item insights in an organization.| |microsoftApplicationDataAccessSettings|[microsoftApplicationDataAccessSettings](../resources/microsoftapplicationdataaccesssettings.md)| Contains the properties that are configured by an administrator to specify access from Microsoft applications to Microsoft 365 data belonging to users in an organization. [List microsoftApplicationDataAccessSettings](../api/organizationsettings-list-microsoftapplicationdataaccess.md) returns the _settings_ that specify the access. | |peopleInsights|[insightsSettings](insightssettings.md)| Contains the properties that are configured by an administrator for the visibility of a list of people [relevant and working with](/graph/people-insights-overview#including-a-person-as-relevant-or-working-with) a user in Microsoft 365. [List peopleInsights](../api/organizationsettings-list-peopleinsights.md) returns the _settings_ to display or return people insights in an organization.|+|itemInsights|[insightsSettings](insightssettings.md) (deprecated)| Contains the properties that are configured by an administrator for the visibility of Microsoft Graph-derived insights, between a user and other items in Microsoft 365, such as documents or sites. [List itemInsights](../api/organizationsettings-list-iteminsights.md) returns the _settings_ to display or return item insights in an organization.| ## JSON representation |
v1.0 | Orgcontact | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/orgcontact.md | Title: "orgContact resource type" -description: "Here is a JSON representation of the resource" +description: "The following JSON representation shows the resource type." ms.localizationpriority: medium This resource supports using [delta query](/graph/delta-query-overview) to track ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Outboundshareduserprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/outboundshareduserprofile.md | Title: "outboundSharedUserProfile resource type" description: "Represents a Microsoft Entra user that has shared their profile data with an external Microsoft Entra tenant using B2B direct connect." + ms.localizationpriority: medium doc_type: resourcePageType |
v1.0 | Outlookgeocoordinates | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/outlookgeocoordinates.md | The geographic coordinates, elevation, and their degree of accuracy for a physic ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Outlookitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/outlookitem.md | Title: "outlookItem resource type" -description: "Here's a JSON representation of the resource" +description: "The following JSON representation shows the resource type." ms.localizationpriority: medium Namespace: microsoft.graph ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Outlooktask | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/outlooktask.md | Prefer: outlook.timezone="Eastern Standard Time" |singleValueExtendedProperties|[singleValueLegacyExtendedProperty](singlevaluelegacyextendedproperty.md) collection|The collection of single-value extended properties defined for the task. Read-only. Nullable.| ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Outlooktaskfolder | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/outlooktaskfolder.md | You cannot rename or delete these default task group and folder, but you can cre |tasks|[outlookTask](outlooktask.md) collection|The tasks in this task folder. Read-only. Nullable.| ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Outlooktaskgroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/outlooktaskgroup.md | In Outlook, there's a default task group `My Tasks` which you can't rename or de |taskFolders|[outlookTaskFolder](outlooktaskfolder.md) collection| The collection of task folders in the task group. Read-only. Nullable.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Outlookuser | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/outlookuser.md | None ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Overprovisionedawsresourcefinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/overprovisionedawsresourcefinding.md | description: "Represents over-provisioned AWS resources." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Overprovisionedawsrolefinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/overprovisionedawsrolefinding.md | description: "Represents over-provisioned AWS roles." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Overprovisionedazureserviceprincipalfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/overprovisionedazureserviceprincipalfinding.md | description: "Represents over-provisioned Azure service prinicipals." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Overprovisionedgcpserviceaccountfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/overprovisionedgcpserviceaccountfinding.md | description: "Represents over-provisioned GCP service accounts." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Overprovisionedserverlessfunctionfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/overprovisionedserverlessfunctionfinding.md | description: "Represents over-provisioned serverless functions in AWS, Azure, or ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Overprovisioneduserfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/overprovisioneduserfinding.md | description: "Represents over-provisioned users in AWS, Azure, or GCP." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Pagelinks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/pagelinks.md | Links for opening a OneNote page. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Parentalcontrolsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/parentalcontrolsettings.md | Specifies parental control settings for an application. These settings control t |legalAgeGroupRule| String | Specifies the legal age group rule that applies to users of the app. Can be set to one of the following values: <table><tr><th>Value</th><th>Description</th></tr><tr><td>Allow</td><td>Default. Enforces the legal minimum. This means parental consent is required for minors in the European Union and Korea.</td></tr><tr><td>RequireConsentForPrivacyServices</td><td>Enforces the user to specify date of birth to comply with COPPA rules. </td></tr><tr><td>RequireConsentForMinors</td><td>Requires parental consent for ages below 18, regardless of country minor rules.</td></tr><tr><td>RequireConsentForKids</td><td>Requires parental consent for ages below 14, regardless of country minor rules.</td></tr><tr><td>BlockMinors</td><td>Blocks minors from using the app.</td></tr></table> | ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Participantinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/participantinfo.md | Contains additional properties about the participant identity ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Partner Security Activitylog | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/partner-security-activitylog.md | + + Title: "activityLog resource type" +description: "Represents the activity undertaken by a partner and includes details of state transitions, who performed them, and when they occurred." ++ms.localizationpriority: medium ++++# activityLog resource type ++Namespace: microsoft.graph.partner.security +++Represents the activity undertaken by a partner and includes details of state transitions, who performed them, and when they occurred. ++## Properties +|Property|Type|Description| +|:|:|:| +|statusFrom|microsoft.graph.partner.security.securityAlertStatus|The status of the alert before the status update activity by the partner. The possible values are: `active`, `resolved`, `investigating`, `unknownFutureValue`.| +|statusTo|microsoft.graph.partner.security.securityAlertStatus|The status of the alert after the status update activity by the partner. The possible values are: `active`, `resolved`, `investigating`, `unknownFutureValue`.| +|updatedBy|String|The UPN of the partner user who did the status update activity. This attribute is set by the system.| +|updatedDateTime|DateTimeOffset|The date and time for the status update activity. This attribute is set by the system. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.partner.security.activityLog" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.partner.security.activityLog", + "statusFrom": "String", + "statusTo": "String", + "updatedBy": "String", + "updatedDateTime": "String (timestamp)" +} +``` + |
v1.0 | Partner Security Additionaldatadictionary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/partner-security-additionaldatadictionary.md | + + Title: "additionalDataDictionary resource type" +description: "Represents a bag of name-value pairs that contain additional details about an alert." ++ms.localizationpriority: medium ++++# additionalDataDictionary resource type ++Namespace: microsoft.graph.partner.security +++Represents a bag of name-value pairs that contain additional details about an alert. ++## Properties +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.partner.security.additionalDataDictionary" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.partner.security.additionalDataDictionary" +} +``` |
v1.0 | Partner Security Affectedresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/partner-security-affectedresource.md | + + Title: "affectedResource resource type" +description: "Contains details of the resources that are affected by a security alert." ++ms.localizationpriority: medium ++++# affectedResource resource type ++Namespace: microsoft.graph.partner.security +++Contains details of the resources that are affected by a security alert. ++## Properties +|Property|Type|Description| +|:|:|:| +|resourceId|String|The resource path of the resource affected by the security alert.| +|resourceType|String|The type of resource.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.partner.security.affectedResource" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.partner.security.affectedResource", + "resourceId": "String", + "resourceType": "String" +} +``` + |
v1.0 | Partner Security Partnersecurity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/partner-security-partnersecurity.md | + + Title: "partnerSecurity resource type" +description: "Represents the root for various types of partner security entities." ++ms.localizationpriority: medium ++++# partnerSecurity resource type ++Namespace: microsoft.graph.partner.security +++Represents the root for various types of partner security entities. ++Inherits from [entity](../resources/entity.md). ++## Methods ++None. ++## Properties ++None. ++## Relationships +|Relationship|Type|Description| +|:|:|:| +|securityAlerts|[microsoft.graph.partner.security.partnerSecurityAlert](../resources/partner-security-partnersecurityalert.md) collection|The security alerts or a vulnerability of a CSP partner's customer that the partner must be made aware of for further action.| ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.partner.security.partnerSecurity", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.partner.security.partnerSecurity" +} +``` + |
v1.0 | Partner Security Partnersecurityalert Api Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/partner-security-partnersecurityalert-api-overview.md | + + Title: "Use the partner security alert API in Microsoft Graph (preview)" +description: "The partner security alert API can help CSP partners detect patterns of fraudulent activities and misuse in Azure resources of their customers." ++ms.localizationpriority: medium ++++# Use the partner security alert API in Microsoft Graph (preview) ++Namespace: microsoft.graph.partner.security +++As a partner in the Cloud Solution Provider (CSP) program, you're responsible for your customer's Azure consumption; therefore, it's important that you're aware of any anomalous usage in your customer's Azure subscriptions. Use Microsoft Graph [partner security alert](../resources/partner-security-partnersecurityalert.md) API to detect patterns of fraudulent activities and misuse in Azure resources to help reduce your exposure to online transaction risks. Mitigating and responding to the alerts within 24 hours can significantly minimize the financial loss that your customers might incur during the compromise. ++For information about how to contain a compromise on your customer's tenant or Azure subscriptions, see [What additional steps can you take to lower the risk of compromise](/partner-center/azure-fraud-notification#what-additional-steps-can-you-take-to-lower-the-risk-of-compromise). ++The partner security alert API is defined in the OData subnamespace `microsoft.graph.partners.security`. ++## Common use cases ++The following are requests for working with the partner security alert API in Microsoft Graph. ++| Use cases | REST operations | Try it in Graph Explorer | +|:|:--|:-| +|List partner security alerts| [List](../api/partner-security-partnersecurityalert-list-securityalerts.md) | [https://graph.microsoft.com/beta/security/partner/securityAlerts](https://developer.microsoft.com/graph/graph-explorer?request=security/partner/securityAlerts&method=GET&version=beta&GraphUrl=https://graph.microsoft.com) | +|Get a partner security alert |[Get](../api/partner-security-partnersecurityalert-get.md)| [https://graph.microsoft.com/beta/security/partner/securityAlerts/{id}](https://developer.microsoft.com/graph/graph-explorer?request=security/partner/securityAlerts/{id}&method=GET&version=beta&GraphUrl=https://graph.microsoft.com) | +|Update a partner security alert |[Update](../api/partner-security-partnersecurityalert-update.md)| [https://graph.microsoft.com/beta/security/partner/securityAlerts/{id}](https://developer.microsoft.com/graph/graph-explorer?request=security/partner/securityAlerts/{id}&method=PATCH&version=beta&GraphUrl=https://graph.microsoft.com) | ++## Next steps ++The partner security alert API in Microsoft Graph enables detection of fraudulent activities and misuse in Azure resources, which helps reduce your exposure to online transaction risks. Follow these steps to get started: ++- Drill down on the methods and properties of the [partnerSecurityAlert](../resources/partner-security-partnersecurityalert.md) resource. +- Try the API in the [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer). |
v1.0 | Partner Security Partnersecurityalert | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/partner-security-partnersecurityalert.md | + + Title: "partnerSecurityAlert resource type" +description: "Represents a security alert or a vulnerability of a CSP partner's customer that the partner must be made aware of for further action." ++ms.localizationpriority: medium ++++# partnerSecurityAlert resource type ++Namespace: microsoft.graph.partner.security +++Represents a security alert or a vulnerability of a CSP partner's customer that the partner must be made aware of for further action. ++Inherits from [entity](../resources/entity.md). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List](../api/partner-security-partnersecurityalert-list-securityalerts.md)|[microsoft.graph.partner.security.partnerSecurityAlert](../resources/partner-security-partnersecurityalert.md) collection|Get a list of the [partnerSecurityAlert](../resources/partner-security-partnersecurityalert.md) objects and their properties.| +|[Get](../api/partner-security-partnersecurityalert-get.md)|[microsoft.graph.partner.security.partnerSecurityAlert](../resources/partner-security-partnersecurityalert.md)|Read the properties and relationships of a [partnerSecurityAlert](../resources/partner-security-partnersecurityalert.md) object.| +|[Update](../api/partner-security-partnersecurityalert-update.md)|[microsoft.graph.partner.security.partnerSecurityAlert](../resources/partner-security-partnersecurityalert.md)|Update the properties of a [partnerSecurityAlert](../resources/partner-security-partnersecurityalert.md) object.| +++## Properties +|Property|Type|Description| +|:|:|:| +|activityLogs|[microsoft.graph.partner.security.activityLog](../resources/partner-security-activitylog.md) collection|Represents the activity by a partner and includes details of state transitions, who performed them, and when they occurred.| +|additionalDetails|[microsoft.graph.partner.security.additionalDataDictionary](../resources/partner-security-additionaldatadictionary.md)|A bag of name-value pairs that contain additional details about an alert.| +|affectedResources|[microsoft.graph.partner.security.affectedResource](../resources/partner-security-affectedresource.md) collection|Contains details of the resources affected by the security alert.| +|alertType|String|The type of vulnerability that impacts the customer due to this alert.| +|catalogOfferId|String|The modern offer category ID of the subscription.| +|confidenceLevel|microsoft.graph.partner.security.securityAlertConfidence|Specifies the confidence in the alert. The possible values are: `low`, `medium`, `high`, `unknownFutureValue`.| +|customerTenantId|String|The impacted customer tenant associated with the alert.| +|description|String|The description for each alert.| +|detectedDateTime|DateTimeOffset|Time when the alert was detected or created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| +|displayName|String|The display name of the alert.| +|firstObservedDateTime|DateTimeOffset|Time of the first activity associated with the alert. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. subscription.| +|id|String|Unique identifier to represent the alert. Inherited from [microsoft.graph.entity](../resources/entity.md).| +|isTest|Boolean|Indicates whehter an alert is a test alert.| +|lastObservedDateTime|DateTimeOffset|Time of the latest activity associated with the alert. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| +|resolvedBy|String|The UPN of the partner user who resolved the alert.| +|resolvedOnDateTime|DateTimeOffset|Time when the alert was resolved. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| +|resolvedReason|microsoft.graph.partner.security.securityAlertResolvedReason|The reason provided by the partner for addressing the alert. The possible values are: `legitimate`, `ignore`, `fraud`, `unknownFutureValue`.| +|severity|microsoft.graph.partner.security.securityAlertSeverity|Indicates the possible impact on assets. The higher the severity the bigger the impact. Typically higher severity items require the most immediate attention. The possible values are: `informational`, `high`, `medium`, `low`, `unknownFutureValue`.| +|status|microsoft.graph.partner.security.securityAlertStatus|The status of the alert. The possible values are: `active`, `resolved`, `investigating`, `unknownFutureValue`.| +|subscriptionId|String|The subscription associated with the alert for the customer.| +|valueAddedResellerTenantId|String|The value-added reseller tenant associated with the partner tenant and customer tenant.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.partner.security.partnerSecurityAlert", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.partner.security.partnerSecurityAlert", + "activityLogs": [{"@odata.type": "microsoft.graph.partner.security.activityLog"}], + "additionalDetails": {"@odata.type": "microsoft.graph.partner.security.additionalDataDictionary"}, + "affectedResources": [{"@odata.type": "microsoft.graph.partner.security.affectedResource"}], + "alertType": "String", + "catalogOfferId": "String", + "confidenceLevel": "String", + "customerTenantId": "String", + "description": "String", + "detectedDateTime": "String (timestamp)", + "displayName": "String", + "firstObservedDateTime": "String (timestamp)", + "id": "String (identifier)", + "isTest": "Boolean", + "lastObservedDateTime": "String (timestamp)", + "resolvedBy": "String", + "resolvedOnDateTime": "String (timestamp)", + "resolvedReason": "String", + "severity": "String", + "status": "String", + "subscriptionId": "String", + "valueAddedResellerTenantId": "String" +} +``` + |
v1.0 | Passwordprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/passwordprofile.md | Title: "passwordProfile resource type" description: "Contains the password profile associated with a user. The **passwordProfile** property of the user entity is a **passwordProfile** object." ms.localizationpriority: medium doc_type: resourcePageType+ |
v1.0 | Passwordsinglesignonfield | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/passwordsinglesignonfield.md | Contains the fields to capture to fill the use credentials for Password-based si ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Passwordvalidationinformation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/passwordvalidationinformation.md | description: "Exposes the properties that specify whether a user's password is v ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Patchcontentcommand | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/patchcontentcommand.md | The changes to make to a OneNote page in a PATCH request. ## JSON representation -Here is a JSON representation of the resource, which is sent in the body of the [PATCH pages/{id}`](../api/page-update.md) request. +The following JSON representation shows the resource type., which is sent in the body of the [PATCH pages/{id}`](../api/page-update.md) request. <!-- { "blockType": "resource", |
v1.0 | Patternedrecurrence | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/patternedrecurrence.md | The recurrence pattern and range. This shared object is used to define the recur ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Payloadcoachmark | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/payloadcoachmark.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.payloadCoachmark" |
v1.0 | Payloaddetail | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/payloaddetail.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.payloadDetail" |
v1.0 | Pendingexternaluserprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/pendingexternaluserprofile.md | Title: "pendingExternalUserProfile resource type" description: "Represents an external user profile in the Microsoft Entra tenant that hasn't consented to share data with the tenant." ms.localizationpriority: high + doc_type: resourcePageType |
v1.0 | Peopleadminsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/peopleadminsettings.md | Inherits from [entity](../resources/entity.md). |Method|Return type|Description| |:|:|:| |[Get peopleAdminSettings](../api/peopleadminsettings-get.md) | [peopleAdminSettings](../resources/peopleadminsettings.md) | Retrieve the properties and relationships of a [peopleAdminSettings](../resources/peopleadminsettings.md) object. |+|[List itemInsights](../api/peopleadminsettings-list-iteminsights.md) | [insightsSettings](insightssettings.md) | Get the properties of an [insightsSettings](insightssettings.md) object. | |[List pronounsSettings](../api/peopleadminsettings-list-pronouns.md)|[pronounsSettings](../resources/pronounssettings.md) collection|Get the properties of the [pronounsSettings](../resources/pronounssettings.md) resource for an organization.| |[List profileCardProperties](../api/peopleadminsettings-list-profilecardproperties.md) | [profileCardProperty](profilecardproperty.md) collection | Get a collection of [profileCardProperty](../resources/profilecardproperty.md) resources for an organization. | |[Create profileCardProperty](../api/peopleadminsettings-post-profilecardproperties.md) | [profileCardProperty](profilecardproperty.md) | Create a new [profileCardProperty](../resources/profilecardproperty.md) for an organization. | Inherits from [entity](../resources/entity.md). |Relationship|Type|Description| |:|:|:|-|profileCardProperties|[profileCardProperty](profilecardproperty.md) collection| Contains a collection of the properties an administrator has defined as visible on the Microsoft 365 profile card.| +|itemInsights|[insightsSettings](../resources/insightssettings.md)|Represents administrator settings that manage the support for item insights in an organization.| +|profileCardProperties|[profileCardProperty](profilecardproperty.md) collection| Contains a collection of the properties an administrator defined as visible on the Microsoft 365 profile card.| |pronouns|[pronounsSettings](../resources/pronounssettings.md)|Represents administrator settings that manage the support of pronouns in an organization.| ## JSON representation |
v1.0 | Permission | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/permission.md | OneDrive for Business and SharePoint document libraries don't return the **inher ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Permissiongrantpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/permissiongrantpolicy.md | A permission grant policy is used to specify the conditions under which consent A permission grant policy consists of a list of **includes** condition sets, and a list of **excludes** condition sets. For an event to match a permission grant policy, it must match *at least one* of the **includes** conditions sets, and *none* of the **excludes** condition sets. +For more information, see [Manage app consent policies](/entra/identity/enterprise-apps/manage-app-consent-policies). + ## Methods | Method | Return Type | Description | A permission grant policy consists of a list of **includes** condition sets, and | includes | [permissionGrantConditionSet](permissiongrantconditionset.md) collection| Condition sets that are *included* in this permission grant policy. Automatically expanded on `GET`.| | excludes |[permissionGrantConditionSet](permissiongrantconditionset.md) collection| Condition sets that are *excluded* in this permission grant policy. Automatically expanded on `GET`.| | includeAllPreApprovedApplications | Boolean | Set to `true` to create all pre-approval policies in the tenant. Set to `false` to disable all pre-approval policies in the tenant. The default is `false`.|-| resourceScopeType |String| The resource type the pre-approval policy applies to. Possible values: `group` for [groups](../resources/group.md) and [teams](../resources/team.md), `chat` for [chats](../resources/chat.md), `tenant` for all supported resources in the tenant. Required.| +| resourceScopeType |String| The resource type the pre-approval policy applies to. Possible values: `team` for [groups](../resources/group.md) and [teams](../resources/team.md), `chat` for [chats](../resources/chat.md), `tenant` for all supported resources in the tenant. Required.| ## Relationships |
v1.0 | Permissions Management Api Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/permissions-management-api-overview.md | description: "Use Microsoft Entra Permissions Management to discover, remediate, ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Permissionsanalytics | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/permissionsanalytics.md | description: "Container for permissions analytics findings in Microsoft Entra Pe ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Permissionsanalyticsaggregatediamkeysummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/permissionsanalyticsaggregatediamkeysummary.md | description: "Represents the total number of IAM keys and the number of a specif ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Permissionsanalyticsaggregatedidentitysummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/permissionsanalyticsaggregatedidentitysummary.md | description: "Represents the total number of identities of a specific kind and t ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Permissionsanalyticsaggregation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/permissionsanalyticsaggregation.md | description: "Represents permissions analytics findings for authorization system ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Permissionscope | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/permissionscope.md | Delegated permissions can be requested by client applications needing an access ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Permissionscreepindex | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/permissionscreepindex.md | description: "Assigns a score based on an identities excessive permissions that ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Permissionscreepindexdistribution | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/permissionscreepindexdistribution.md | description: "Represents the Permissions Creep Index Distribution for the author ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Permissionsdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/permissionsdefinition.md | description: "An abstract type that represents information about the permissions ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Permissionsdefinitionaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/permissionsdefinitionaction.md | description: "An abstract complex type that represents the action to take in a p ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Permissionsdefinitionauthorizationsystem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/permissionsdefinitionauthorizationsystem.md | description: "Represents the authorization system that the permissions will be r ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Permissionsdefinitionauthorizationsystemidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/permissionsdefinitionauthorizationsystemidentity.md | description: "Represents an identity that's requesting permissions in an authori ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Permissionsdefinitionawspolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/permissionsdefinitionawspolicy.md | description: "Represents an AWS policy." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Permissionsdefinitionazurerole | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/permissionsdefinitionazurerole.md | description: "Represents permissions defined for an Azure role." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Permissionsdefinitiongcprole | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/permissionsdefinitiongcprole.md | description: "Represents permissions in a GCP role." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Permissionsdefinitionidentitysource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/permissionsdefinitionidentitysource.md | description: "An abstract type that defines the source of an identity that's req ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Permissionsmanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/permissionsmanagement.md | description: "The base container for the relationships that define the requests ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Permissionsrequestchange | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/permissionsrequestchange.md | description: "Represents a change event relating to requests for permissions by ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Persondatasource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/persondatasource.md | Represents the sources the user data comes from, such as Directory and Outlook C ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Phone | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/phone.md | Represents a phone number. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Phoneauthenticationmethod | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/phoneauthenticationmethod.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Physicaladdress | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/physicaladdress.md | Represents the street address of a resource such as a contact or event. ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Physicalofficeaddress | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/physicalofficeaddress.md | Represents the business address of a resource such as an organizational contact. ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Pkcs12certificateinformation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/pkcs12CertificateInformation.md | Represents the public information of a Pkcs12 certificate. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.pkcs12CertificateInformation" |
v1.0 | Pkcs12certificate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/pkcs12certificate.md | Inherits from [apiAuthenticationConfigurationBase](../resources/apiauthenticatio ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.pkcs12Certificate" |
v1.0 | Planner | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/planner.md | The **planner** resource is the entry point for the Planner object model. It ret |tasks|[plannerTask](plannertask.md) collection| Read-only. Nullable. Returns a collection of the specified tasks| ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannerappliedcategories | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerappliedcategories.md | Properties of an open type can be defined by the client. In this case, the clien ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannerapprovalrequirement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerapprovalrequirement.md | + + Title: "plannerApprovalRequirement resource type" +description: "Represents whether a plannerTask must have an approval completion requirement created for it." ++ms.localizationpriority: medium ++++# plannerApprovalRequirement resource type ++Namespace: microsoft.graph +++Represents whether a [plannerTask](plannertask.md) must have an approval completion requirement created for it. ++## Properties +|Property|Type|Description| +|:|:|:| +|isApprovalRequired|Boolean|Specifies whether [approval](plannerbaseapprovalattachment.md) is required to complete the [plannerTask](plannertask.md). When this property is set to true, the task can only be marked complete if an approval is created for the task and approved.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.plannerApprovalRequirement" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.plannerApprovalRequirement", + "isApprovalRequired": "Boolean" +} +``` + |
v1.0 | Plannerassignedtotaskboardtaskformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerassignedtotaskboardtaskformat.md | Represents the information used to render a task correctly in the **AssignedTo** None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannerassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerassignment.md | The **plannerAssignment** resource represents the assignment of a task to a user |orderHint|String|Hint used to order assignees in a task. The format is defined as outlined [here](planner-order-hint-format.md).| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannerbaseapprovalattachment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerbaseapprovalattachment.md | + + Title: "plannerBaseApprovalAttachment resource type" +description: "Represents the base approval attachment that is added to a plannerTask, which contains the common properties that are required for an approval." ++ms.localizationpriority: medium ++++# plannerBaseApprovalAttachment resource type ++Namespace: microsoft.graph +++Represents the base approval attachment, which contains the common properties that are required for an approval, that is added to a [plannerTask](plannertask.md). The derived types, such as [plannerBasicApprovalAttachment](plannerbasicapprovalattachment.md), have details corresponding to the type of approval. ++This type is abstract. ++## Properties +|Property|Type|Description| +|:|:|:| +|status|[plannerApprovalStatus](../resources/plannerbaseapprovalattachment.md#plannerapprovalstatus-values)|Status of the approval. The possible values are: `requested`, `approved`, `rejected`, `cancelled`, `unknownFutureValue`. Read-only. ++### plannerApprovalStatus values ++| Member | +|:-| +| requested | +| approved | +| rejected | +| cancelled | +| unknownFutureValue | ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.plannerBaseApprovalAttachment" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.plannerBaseApprovalAttachment", + "status": "String" +} +``` + |
v1.0 | Plannerbasicapprovalattachment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerbasicapprovalattachment.md | + + Title: "plannerBasicApprovalAttachment resource type" +description: "Represents the approval attachment that is added to a plannerTask." ++ms.localizationpriority: medium ++++# plannerBasicApprovalAttachment resource type ++Namespace: microsoft.graph +++Represents the approval attachment, of type basic, that is created by the approval extensibility service and is added to a [plannerTask](plannertask.md). ++Inherits from [plannerBaseApprovalAttachment](../resources/plannerbaseapprovalattachment.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|approvalId|String|Read-only. The identifier of the approval in the approval service.| +|status|[plannerApprovalStatus](../resources/plannerbaseapprovalattachment.md#plannerapprovalstatus-values)|The status of the approval. Inherited from [plannerBaseApprovalAttachment](../resources/plannerbaseapprovalattachment.md). The possible values are: `requested`, `approved`, `rejected`, `cancelled`, `unknownFutureValue`. Read-only.| ++### plannerApprovalStatus values ++|Member|Description| +|:--|:-| +|requested|Default. Approval is requested.| +|approved|The plannerTask is approved.| +|rejected|The plannerTask is rejected.| +|cancelled|The requestor canceled the approval.| +|unknownFutureValue|Evolvable enumeration sentinel value. Don't use.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.plannerBasicApprovalAttachment" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.plannerBasicApprovalAttachment", + "status": "String", + "approvalId": "String" +} +``` + |
v1.0 | Plannerbuckettaskboardtaskformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerbuckettaskboardtaskformat.md | None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannerchecklistitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerchecklistitem.md | The **plannerChecklistItem** resource represents an item in the checklist of a t |title|String|Title of the checklist item| ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannerchecklistitems | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerchecklistitems.md | Properties of an Open Type can be defined by the client. In this case, the clien ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannerexternalbucketsource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerexternalbucketsource.md | This type is derived from [plannerBucketCreation](plannerBucketCreation.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.plannerExternalBucketSource" |
v1.0 | Plannerexternalplansource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerexternalplansource.md | This type is derived from [plannerPlanCreation](plannerPlanCreation.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.plannerExternalPlanSource" |
v1.0 | Plannerexternalreference | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerexternalreference.md | The **plannerExternalReference** resource represents the metadata of a reference |type|String|Used to describe the type of the reference. Types include: `PowerPoint`, `Word`, `Excel`, `Other`.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannerexternalreferences | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerexternalreferences.md | Properties of an Open Type can be defined by the client. In this case, the clien ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannerexternaltasksource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerexternaltasksource.md | This type is derived from [plannerTaskCreation](plannerTaskCreation.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.plannerExternalTaskSource" |
v1.0 | Plannerformreference | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerformreference.md | + + Title: "plannerFormReference resource type" +description: "Represents complete information about a form, including the form's display name, URL, and the response data." +ms.localizationpriority: medium ++++# plannerFormReference resource type ++Namespace: microsoft.graph +++Represents complete details about a form, including the form's display name, URL, and the response data. This object is typically used as a value in the [plannerFormsDictionary](plannerFormsDictionary.md) object. ++## Properties +| Property | Type |Description| +|:|:--|:-| +|displayName|String|The display name of the form.| +|formWebUrl|String|The URL of the form associated with the **plannerFormReference** object.| +|formResponse|String|The unique identifier of the response.| ++## JSON representation +The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.plannerFormReference" +}--> ++```json +{ + "displayName": "String-value", + "formWebUrl": "String-value", + "formResponse": "String-value" +} ++``` |
v1.0 | Plannerformsdictionary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerformsdictionary.md | + + Title: "plannerFormsDictionary resource type" +description: "Represents a dictionary of planner form reference objects for a task." +ms.localizationpriority: medium ++++# plannerFormsDictionary resource type ++Namespace: microsoft.graph +++An open type that represents a dictionary of data about the forms associated with a task. This resource is a part of the [plannerTaskDetails](plannertaskdetails.md) object. Each entry in the dictionary is a key-value pair, where the value is a [plannerFormReference](plannerformreference.md) object. +++## Properties +You can add and remove values from open type properties. Provide GUID values as keys, and [plannerFormReference](plannerformreference.md) objects as values. To remove an item in the forms, set its value to `null`. ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.plannerFormsDictionary" +}--> ++```json +{ + "String-value": + { + "displayName": "String-value", + "formWebUrl": "String-value", + "formResponse": "String-value" + } +} ++``` |
v1.0 | Plannerformsrequirement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerformsrequirement.md | + + Title: "plannerFormsRequirement resource type" +description: "Represents the criteria of form requirements that must be met to complete a Planner task." ++ms.localizationpriority: medium +++# plannerFormsRequirement resource type ++Namespace: microsoft.graph +++Represents a form completion requirement on a [plannerTask](plannertask.md). ++## Properties ++|Property|Type|Description| +|:|:|:| +|requiredForms|String collection|Read-only. A collection of keys from the [plannerFormsDictionary](plannerformsdictionary.md) that identify the [plannerFormReference](plannerformreference.md) objects that specify the requirements to complete the [plannerTask](plannertask.md).| ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. ++<!--{ + "blockType": "resource", + "@odata.type": "microsoft.graph.plannerFormsRequirement" +}--> +``` json +{ + "@odata.type": "#microsoft.graph.plannerFormsRequirement", + "requiredForms": ["String"] +} +``` |
v1.0 | Plannergroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannergroup.md | The **plannerGroup** resource provides access to Planner resources for a [group] |plans|[plannerPlan](plannerplan.md) collection| Read-only. Nullable. Returns the [plannerPlans](plannerplan.md) owned by the group.| ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannerplan | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerplan.md | Represents a plan in Microsoft 365. Either a [group](group.md) or a [user](user. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannerplandetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerplandetails.md | Represents the additional information about a plan. Each [plan](plannerplan.md) None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannerprogresstaskboardtaskformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerprogresstaskboardtaskformat.md | None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannersharedwithcontainer | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannersharedwithcontainer.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.plannerSharedWithContainer" |
v1.0 | Plannertask | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannertask.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents a Planner task in Microsoft 365. A Planner task is contained in a [plan](plannerplan.md) and can be assigned to a [bucket](plannerbucket.md) in a plan. Each task object has a [details](plannertaskdetails.md) object that can contain more information about the task. For more information about relationships between group, plan, and task, see [Use the Planner REST API](planner-overview.md) +Represents a Planner task in Microsoft 365. A Planner task is contained in a [plan](plannerplan.md) and can be assigned to a [bucket](plannerbucket.md) in a plan. Each task object has a [details](plannertaskdetails.md) object that can contain more information about the task. For more information about relationships between group, plan, and task, see [Use the Planner REST API](planner-overview.md). ## Methods | Method | Return Type |Description| |:|:--|:-|-|[Get plannerTask](../api/plannertask-get.md) | [plannerTask](plannertask.md) |Read properties and relationships of **plannerTask** object.| -|[Update](../api/plannertask-update.md) | [plannerTask](plannertask.md) |Update **plannerTask** object. | -|[Delete](../api/plannertask-delete.md) | None |Delete **plannerTask** object. | +|[Get plannerTask](../api/plannertask-get.md) | [plannerTask](plannertask.md) |Read the properties and relationships of **plannerTask** object.| +|[Update](../api/plannertask-update.md) | [plannerTask](plannertask.md) |Update a **plannerTask** object. | +|[Delete](../api/plannertask-delete.md) | None |Delete a **plannerTask** object. | |[Get delta](../api/plannertask-delta.md)|[plannerTask](../resources/plannertask.md) collection| Get newly created, updated, or deleted **plannerTask** objects in either a **plannerPlan** or assigned to the signed-in user without having to perform a full read of the entire resource collection. | ## Properties | Property | Type |Description| |:|:--|:-|-|activeChecklistItemCount|Int32|Number of checklist items with value set to `false`, representing incomplete items.| -|appliedCategories|[plannerAppliedCategories](plannerappliedcategories.md)|The categories to which the task has been applied. See [applied Categories](plannerappliedcategories.md) for possible values.| -|assigneePriority|String|Hint used to order items of this type in a list view. The format is defined as outlined [here](planner-order-hint-format.md).| +|activeChecklistItemCount|Int32|The number of checklist items with value set to `false`, representing incomplete items.| +|appliedCategories|[plannerAppliedCategories](plannerappliedcategories.md)|The categories to which the task is applied. See [plannerAppliedCategories resource type](plannerappliedcategories.md) for possible values.| +|assigneePriority|String|A hint that is used to order items of this type in a list view. For more information, see [Using order hints in Planner](planner-order-hint-format.md).| |assignments|[plannerAssignments](plannerassignments.md)|The set of assignees the task is assigned to.|-|bucketId|String|Bucket ID to which the task belongs. The bucket needs to be in the plan that the task is in. It is 28 characters long and case-sensitive. [Format validation](tasks-identifiers-disclaimer.md) is done on the service. | -|checklistItemCount|Int32|Number of checklist items that are present on the task.| -|completedBy|[identitySet](identityset.md)|Identity of the user that completed the task.| -|completedDateTime|DateTimeOffset|Read-only. Date and time at which the `'percentComplete'` of the task is set to `'100'`. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| -|conversationThreadId|String|Thread ID of the conversation on the task. This is the ID of the conversation thread object created in the group.| -|createdBy|[identitySet](identityset.md)|Identity of the user that created the task.| -|createdDateTime|DateTimeOffset|Read-only. Date and time at which the task is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| -|creationSource|[plannerTaskCreation](../resources/plannertaskcreation.md)|Contains information about the origin of the task.| -|dueDateTime|DateTimeOffset|Date and time at which the task is due. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| -|hasDescription|Boolean|Read-only. Value is `true` if the details object of the task has a nonempty description and `false` otherwise.| -|id|String|Read-only. ID of the task. It is 28 characters long and case-sensitive. [Format validation](tasks-identifiers-disclaimer.md) is done on the service.| -|orderHint|String|Hint used to order items of this type in a list view. The format is defined as outlined [here](planner-order-hint-format.md).| -|percentComplete|Int32|Percentage of task completion. When set to `100`, the task is considered completed. | -|priority|Int32|Priority of the task. Valid range of values is between `0` and `10` (inclusive), with increasing value being lower priority (`0` has the highest priority and `10` has the lowest priority). Currently, Planner interprets values `0` and `1` as "urgent", `2` and `3` and `4` as "important", `5`, `6`, and `7` as "medium", and `8`, `9`, and `10` as "low". Currently, Planner sets the value `1` for "urgent", `3` for "important", `5` for "medium", and `9` for "low".| +|bucketId|String|Bucket ID to which the task belongs. The bucket needs to be in the same plan as the task. The value of the bucketId property is 28 characters long and case-sensitive. [Format validation](tasks-identifiers-disclaimer.md) is done on the service. | +|checklistItemCount|Int32|The number of checklist items that are present on the task.| +|completedBy|[identitySet](identityset.md)|The identity of the user that completed the task.| +|completedDateTime|DateTimeOffset|Read-only. The date and time at which the `'percentComplete'` of the task is set to `'100'`. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| +|conversationThreadId|String|The thread ID of the conversation on the task. This is the ID of the conversation thread object created in the group.| +|createdBy|[identitySet](identityset.md)|The identity of the user who created the task.| +|createdDateTime|DateTimeOffset|Read-only. The date and time at which the task is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| +|creationSource|[plannerTaskCreation](../resources/plannertaskcreation.md)|Information about the origin of the task.| +|dueDateTime|DateTimeOffset|The date and time at which the task is due. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| +|hasDescription|Boolean|Read-only. This value is `true` if the details object of the task has a nonempty description. Otherwise,`false`.| +|id|String|Read-only. The unique identifier of the task. The value of this property is 28 characters long and case-sensitive. [Format validation](tasks-identifiers-disclaimer.md) is done on the service.| +|isOnMyDay|Boolean|A Boolean value that indicates whether to show this task in the MyDay view. `true` to show the task. Otherwise, `false`.| +|isOnMyDayLastModifiedDate|Date|Read-only. The date on which task is added to or removed from MyDay.| +|orderHint|String|The hint used to order items of this type in a list view. For more information, see [Using order hints in Planner](planner-order-hint-format.md)n.| +|percentComplete|Int32|The percentage of task completion. When set to `100`, the task is completed. | +|priority|Int32|The priority of the task. Valid values are between `0` and `10`, inclusive. Larger values indicate lower priority. For example, `0` has the highest priority and `10` has the lowest priority. Currently, Planner interprets values `0` and `1` as "urgent", `2` and `3` and `4` as "important", `5`, `6`, and `7` as "medium", and `8`, `9`, and `10` as "low". Currently, Planner sets the value `1` for "urgent", `3` for "important", `5` for "medium", and `9` for "low".| |planId|String|Plan ID to which the task belongs.|-|previewType|String|This sets the type of preview that shows up on the task. Possible values are: `automatic`, `noPreview`, `checklist`, `description`, `reference`.| +|previewType|String|The type of preview that shows up on the task. Possible values are: `automatic`, `noPreview`, `checklist`, `description`, `reference`.| |recurrence|[plannerTaskRecurrence](../resources/plannertaskrecurrence.md)|Defines active or inactive recurrence for the task. `null` when the recurrence has never been defined for the task.| |referenceCount|Int32|Number of external references that exist on the task.|-|specifiedCompletionRequirements|[plannerTaskCompletionRequirements](../resources/plannertask.md#plannertaskcompletionrequirements-values)|Indicates all the requirements specified on the **plannerTask**. Possible values are: `none`, `checklistCompletion`, `unknownFutureValue`. Read-only. The [plannerTaskCompletionRequirementDetails](plannertaskcompletionrequirementdetails.md) in [plannerTaskDetails](plannertaskdetails.md) has details of the requirements specified, if any. | +|specifiedCompletionRequirements|[plannerTaskCompletionRequirements](../resources/plannertask.md#plannertaskcompletionrequirements-values)|Indicates all the requirements specified on the **plannerTask**. Possible values are: `none`, `checklistCompletion`, `unknownFutureValue`, `formCompletion`, `approvalCompletion`. Read-only. You must use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `formCompletion`, `approvalCompletion`. The [plannerTaskCompletionRequirementDetails](plannertaskcompletionrequirementdetails.md) in [plannerTaskDetails](plannertaskdetails.md) has details of the requirements specified, if any. | |startDateTime|DateTimeOffset|Date and time at which the task starts. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| |title|String|Title of the task.| ### plannerTaskCompletionRequirements values -| Member | Description | -|:--|:| -| none | No requirement. | -| checklistCompletion | Some or all of the checklist items are required to be checked. | -| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | +| Member | Description | +|:--|:| +| none | No requirement. | +| checklistCompletion | Some or all of the checklist items are required to be checked. | +| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | +| formCompletion | Some or all of the forms must be submitted to complete the planner task.| +| approvalCompletion | Approval is required. | ## Relationships Represents a Planner task in Microsoft 365. A Planner task is contained in a [pl |:|:--|:-| |assignedToTaskBoardFormat|[plannerAssignedToTaskBoardTaskFormat](plannerassignedtotaskboardtaskformat.md)| Read-only. Nullable. Used to render the task correctly in the task board view when grouped by assignedTo.| |bucketTaskBoardFormat|[plannerBucketTaskBoardTaskFormat](plannerbuckettaskboardtaskformat.md)| Read-only. Nullable. Used to render the task correctly in the task board view when grouped by bucket.|-|details|[plannerTaskDetails](plannertaskdetails.md)| Read-only. Nullable. Additional details about the task.| +|details|[plannerTaskDetails](plannertaskdetails.md)| Read-only. Nullable. More details about the task.| |progressTaskBoardFormat|[plannerProgressTaskBoardTaskFormat](plannerprogresstaskboardtaskformat.md)| Read-only. Nullable. Used to render the task correctly in the task board view when grouped by progress.| ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", Here's a JSON representation of the resource. "dueDateTime": "String (timestamp)", "hasDescription": "Boolean", "id": "String (identifier)",+ "isOnMyDay": "Boolean", + "isOnMyDayLastModifiedDate": "Date", "orderHint": "String", "percentComplete": "Int32", "planId": "String", |
v1.0 | Plannertaskcompletionrequirementdetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannertaskcompletionrequirementdetails.md | Represents detailed information about [completionRequirements](plannertask.md#pl |Property|Type|Description| |:|:|:|+|approvalRequirement |[plannerApprovalRequirement](plannerapprovalrequirement.md) |Information about the requirements of an approval.| |checklistRequirement|[plannerChecklistRequirement](plannerchecklistrequirement.md)|Information about the requirements for completing the checklist.|+|formsRequirement|[plannerFormsRequirement](plannerformsrequirement.md)|Information about the requirements for completing the forms.| ## Relationships None. ## JSON representation -The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", The following is a JSON representation of the resource. ``` json { "@odata.type": "#microsoft.graph.plannerTaskCompletionRequirementDetails",- "checklistRequirement": {"@odata.type": "microsoft.graph.plannerChecklistRequirement"} + "checklistRequirement": {"@odata.type": "microsoft.graph.plannerChecklistRequirement"}, + "formsRequirement": {"@odata.type": "microsoft.graph.plannerFormsRequirement"}, + "approvalRequirement": {"@odata.type": "microsoft.graph.plannerApprovalRequirement" } } ``` |
v1.0 | Plannertaskconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannertaskconfiguration.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Plannertaskdetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannertaskdetails.md | Represents the additional information about a task. Each [task](plannertask.md) ## Properties | Property | Type |Description| |:|:--|:-|+|approvalAttachment|[plannerBaseApprovalAttachment](../resources/plannerbaseapprovalattachment.md)|Detailed information about the approval that is attached to the task.| |checklist|[plannerChecklistItems](plannerchecklistitems.md)|The collection of checklist items on the task.|+|forms|[plannerFormsDictionary](plannerformsdictionary.md)| Read-only. Represents a dictionary of data about the forms associated with a task. Each entry in the dictionary is a key-value pair, and the value is a [plannerFormReference](plannerformreference.md) object.| |completionRequirements|[plannerTaskCompletionRequirementDetails](plannertaskcompletionrequirementdetails.md)|Contains detailed information about requirements on the task.| |description|String|Description of the task.| |id|String| Read-only. ID of the task details. It's 28 characters long and case-sensitive. [Format validation](tasks-identifiers-disclaimer.md) is done on the service.| None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", Here's a JSON representation of the resource. ```json { "checklist": {"@odata.type": "microsoft.graph.plannerChecklistItems"},+ "forms": {"@odata.type": "microsoft.graph.plannerFormsDictionary"}, "completionRequirements": {"@odata.type": "microsoft.graph.plannerTaskCompletionRequirementDetails"}, "description": "String", "id": "String (identifier)", "notes": {"@odata.type": "microsoft.graph.itemBody"}, "previewType": "String",- "references": {"@odata.type": "microsoft.graph.plannerExternalReferences"} + "references": {"@odata.type": "microsoft.graph.plannerExternalReferences"}, + "approvalAttachment": {"@odata.type": "microsoft.graph.plannerBaseApprovalAttachment"} } ``` |
v1.0 | Plannertaskpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannertaskpolicy.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.plannerTaskPolicy" |
v1.0 | Plannertaskpropertyrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannertaskpropertyrule.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents specific restrictions that apply to editing a [plannerTask](../resources/plannertask.md). For more details, see [Configuring task rules in Planner](/graph/planner-task-rules-overview). +Represents specific restrictions that apply to editing a [plannerTask](../resources/plannertask.md). For more information, see [Configuring task rules in Planner](/graph/planner-task-rules-overview). Inherits from [plannerPropertyRule](../resources/plannerpropertyrule.md). Inherits from [plannerPropertyRule](../resources/plannerpropertyrule.md). |Property|Type|Description| |:|:|:|-|appliedCategories|[plannerFieldRules](../resources/plannerfieldrules.md)|Rules and restrictions for applied categories. This value does not currently support overrides. Accepted values for the default rule and individual overrides are `allow`, `block`.| +|appliedCategories|[plannerFieldRules](../resources/plannerfieldrules.md)|Rules and restrictions for applied categories. This value doesn't currently support overrides. Accepted values for the default rule and individual overrides are `allow`, `block`.| +|approvalAttachment|[plannerFieldRules](../resources/plannerfieldrules.md)|Rules and restrictions for approval. Allowed overrides are `userCreated` and `applicationCreated`. Accepted values for the default rule and individual overrides are: `allow`, `add`, `remove`, `block`.| |assignments|[plannerFieldRules](../resources/plannerfieldrules.md)|Rules and restrictions for assignments. Allowed overrides are `userCreated` and `applicationCreated`. Accepted values for the default rule and individual overrides are `allow`, `add`, `addSelf`, `addOther`, `remove`, `removeSelf`, `removeOther`, `block`.| |checkLists|[plannerFieldRules](../resources/plannerfieldrules.md)|Rules and restrictions for checklist. Allowed overrides are `userCreated` and `applicationCreated`. Accepted values for the default rule and individual overrides are `allow`, `add`, `remove`, `update`, `check`, `reorder`, `block`.| |completionRequirements|String collection|Rules and restrictions for completion requirements of the task. Accepted values are `allow`, `add`, `remove`, `edit`, and `block`. | |delete|String collection|Rules and restrictions for deleting the task. Accepted values are `allow` and `block`.| |dueDate|String collection|Rules and restrictions for changing the due date of the task. Accepted values are `allow` and `block`.|+|forms|[plannerFieldRules](../resources/plannerfieldrules.md)|Rules and restrictions for forms. Allowed overrides are `userCreated` and `applicationCreated`. The following are the accepted values for the default rule and individual overrides: `allow`, `add`, `addResponse`, `remove`, `update`, `block`.| |move|String collection|Rules and restrictions for moving the task between buckets or plans. Accepted values are `allow`, `moveBetweenPlans`, `moveBetweenBuckets`, and `block`.| |notes|String collection|Rules and restrictions for changing the notes of the task. Accepted values are `allow` and `block`.| |order|String collection|Rules and restrictions for changing the order of the task. Accepted values are `allow` and `block`.| Inherits from [plannerPropertyRule](../resources/plannerpropertyrule.md). |previewType|String collection|Rules and restrictions for changing the preview type of the task. Accepted values are `allow` and `block`.| |priority|String collection|Rules and restrictions for changing the priority of the task. Accepted values are `allow` and `block`.| |references|[plannerFieldRules](../resources/plannerfieldrules.md)|Rules and restrictions for references. Allowed overrides are `userCreated` and `applicationCreated`. Accepted values for the default rule and individual overrides are `allow`, `add`, `remove`, `block`.|-|ruleKind|plannerRuleKind|Identifies which type of property rules is represented by this instance. Must be set to `taskRule`. The possible values are: `taskRule`, `bucketRule`, `planRule`, `unknownFutureValue`. Inherited from [plannerPropertyRule](../resources/plannerpropertyrule.md).| +|ruleKind|plannerRuleKind|Identifies which type of property rules this instance represents. Must be set to `taskRule`. The possible values are: `taskRule`, `bucketRule`, `planRule`, `unknownFutureValue`. Inherited from [plannerPropertyRule](../resources/plannerpropertyrule.md).| |startDate|String collection|Rules and restrictions for changing the start date of the task. Accepted values are `allow` and `block`.| |title|String collection|Rules and restrictions for changing the title of the task. Accepted values are `allow` and `block`.| None. ## JSON representation -The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.plannerTaskPropertyRule" The following is a JSON representation of the resource. "appliedCategories": {"@odata.type": "microsoft.graph.plannerFieldRules"}, "assignments": {"@odata.type": "microsoft.graph.plannerFieldRules"}, "checkLists": {"@odata.type": "microsoft.graph.plannerFieldRules"},+ "approvalAttachment": {"@odata.type": "microsoft.graph.plannerFieldRules"}, "completionRequirements": ["String"], "delete": ["String"], "dueDate": ["String"], |
v1.0 | Planneruser | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/planneruser.md | Provides access to Planner resources for a [user](user.md). | Method | Return Type |Description| |:|:--|:-| |[List tasks](../api/planneruser-list-tasks.md) |[plannerTask](plannertask.md) collection| Get the [plannerTasks](plannertask.md) assigned to the user.|+|[List myDayTasks](../api/planneruser-list-mydaytasks.md) |[plannerTask](plannertask.md) collection| Get the [plannerTasks](plannertask.md) to be shown in the user's MyDay view.| |[List favoritePlans](../api/planneruser-list-favoriteplans.md) |[plannerPlan](plannerplan.md) collection| Get the [plannerPlans](plannerplan.md) marked as favorite by the user.| |[List recentPlans](../api/planneruser-list-recentplans.md) |[plannerPlan](plannerplan.md) collection| Get the [plannerPlans](plannerplan.md) recently viewed by the user.| |[List rosterPlans](../api/planneruser-list-rosterplans.md)|[plannerPlan](plannerplan.md) collection| Get the [plannerPlans](plannerplan.md) contained by the [plannerRosters](plannerroster.md) that the user is a member.| Provides access to Planner resources for a [user](user.md). | Property | Type |Description| |:|:--|:-| |id|String| Read-only. Unique identifier for the **plannerUser** object.|-|favoritePlanReferences|[plannerFavoritePlanReferenceCollection](plannerfavoriteplanreferencecollection.md)| A collection that contains the references to the plans that the user has marked as favorites.| -|recentPlanReferences|[plannerRecentPlanReferenceCollection](plannerrecentplanreferencecollection.md)| A collection that contains references to the plans that were viewed recently by the user in apps that support recent plans.| +|favoritePlanReferences|[plannerFavoritePlanReferenceCollection](plannerfavoriteplanreferencecollection.md)| A collection that contains the references to the plans that the user marked as favorites.| +|recentPlanReferences|[plannerRecentPlanReferenceCollection](plannerrecentplanreferencecollection.md)| A collection that contains references to the plans that the user recently viewed in apps that support recent plans.| ## Relationships | Relationship | Type |Description| |:|:--|:-| |favoritePlans|[plannerPlan](plannerplan.md) collection| Read-only. Nullable. Returns the [plannerPlans](plannerplan.md) that the user marked as favorites.|-|recentPlans|[plannerPlan](plannerplan.md) collection| Read-only. Nullable. Returns the [plannerPlans](plannerplan.md) that have been recently viewed by the user in apps that support recent plans. | +|recentPlans|[plannerPlan](plannerplan.md) collection| Read-only. Nullable. Returns the [plannerPlans](plannerplan.md) that the user recently viewed in apps that support recent plans. | |rosterPlans|[plannerPlan](../resources/plannerplan.md) collection|Read-only. Nullable. Returns the [plannerPlans](plannerplan.md) contained by the [plannerRosters](plannerroster.md) the user is a member.| |tasks|[plannerTask](plannertask.md) collection| Read-only. Nullable. Returns the [plannerTasks](plannertask.md) assigned to the user.|+|myDayTasks|[plannerTask](plannertask.md) collection| Read-only. Nullable. Returns the [plannerTasks](plannertask.md) to be shown in the My Day view of the user.| ## JSON representation-The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Planneruserids | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/planneruserids.md | Properties of an Open Type can be defined by the client. In this case, the clien ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Policyroot | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/policyroot.md | Title: "policyRoot resource type" description: "Resource type exposing navigation properties for the policies singleton."-+ ms.localizationpriority: medium-+ doc_type: resourcePageType None | tokenLifetimePolicies | [tokenLifetimePolicy](tokenlifetimepolicy.md) collection | The policy that controls the lifetime of a JWT access token, an ID token, or a SAML 1.1/2.0 token issued by Microsoft Entra ID. | ## JSON representation-The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Policytemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/policytemplate.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Post | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/post.md | This resource lets you add your own data to custom properties using [extensions] ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Preapprovedpermissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/preapprovedpermissions.md | A **preApprovedPermissions** type describes the set of permissions that are pre- None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.preApprovedPermissions" |
v1.0 | Preauthorizedapplication | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/preauthorizedapplication.md | In some rare cases, an identifier listed in the `permissionIds` property may ref |permissionIds|String collection| The unique identifier for the [scopes](permissionscope.md) the client application is granted. | ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Presence | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/presence.md | Contains information about a user's presence, including their availability and u > **Note:** This resource is currently only supported for Microsoft Teams users. -This resource supports subscribing to [change notifications](/graph/webhooks). +This resource supports subscribing to [change notifications](/graph/changenotifications-for-presence). ## Methods |
v1.0 | Presencestatusmessage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/presencestatusmessage.md | Represents a presence status message related to the [presence](presence.md) of a ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Principalresourcemembershipsscope | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/principalresourcemembershipsscope.md | You must also specify the **@odata.type** type property with the value `#microso None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.principalResourceMembershipsScope" |
v1.0 | Printdocumentuploadproperties | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/printdocumentuploadproperties.md | Describes the document that is being uploaded ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Printercapabilities | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/printercapabilities.md | Represents the capabilities reported by a printer. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Printerstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/printerstatus.md | Represents the processing status of the printer, including any errors. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Printidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/printidentity.md | Represents an identity within the Universal Print service. Maps to an [Microsoft ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Printjobconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/printjobconfiguration.md | A group of settings that a printer should use to print a job. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Printjobstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/printjobstatus.md | Represents the current status of a print job. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Printservice | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/printservice.md | Represents a Microsoft Entra tenant-specific description of a print service inst ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Printtasktrigger | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/printtasktrigger.md | For details about how to use this resource to add pull printing support to Unive ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Privacyprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/privacyprofile.md | description: "Represents a company's privacy profile, which includes a privacy s ms.localizationpriority: medium doc_type: resourcePageType -+ # privacyProfile resource type Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents a company's privacy profile, which includes a privacy statement URL and a contact person for questions regarding the privacy statement. +Represents a [company's](organization.md) privacy profile, which includes a privacy statement URL and a contact person for questions regarding the privacy statement. ## Properties | Property | Type|Description| Represents a company's privacy profile, which includes a privacy statement URL a ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Privilegedaccess | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/privilegedaccess.md | Represents a group of functionalities provided by the Privileged Identity Manage ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Privilegedaccessgroupassignmentschedule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/privilegedaccessgroupassignmentschedule.md | Inherits from [privilegedAccessSchedule](../resources/privilegedaccessschedule.m |principal|[directoryObject](../resources/directoryobject.md)|References the principal that's in the scope of this membership or ownership assignment request to the group that's governed by PIM. Supports `$expand` and `$select` nested in `$expand` for **id** only.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Privilegedaccessgroupassignmentscheduleinstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/privilegedaccessgroupassignmentscheduleinstance.md | Inherits from [privilegedAccessScheduleInstance](../resources/privilegedaccesssc |principal|[directoryObject](../resources/directoryobject.md)|References the principal that's in the scope of the membership or ownership assignment request through the group that's governed by PIM. Supports `$expand`.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Privilegedaccessgroupeligibilityschedule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/privilegedaccessgroupeligibilityschedule.md | Inherits from [privilegedAccessSchedule](../resources/privilegedaccessschedule.m |principal|[directoryObject](../resources/directoryobject.md)|References the principal that's in the scope of this membership or ownership eligibility request to the group that's governed by PIM. Supports `$expand`.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Privilegedaccessschedule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/privilegedaccessschedule.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Privilegedaccessscheduleinstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/privilegedaccessscheduleinstance.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Privilegedidentitymanagementv3 Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/privilegedidentitymanagementv3-overview.md | Last updated 10/12/2023 The PIM for Microsoft Entra roles APIs allow you to govern privileged access and limit excessive access to Microsoft Entra roles. This article introduces the governance capabilities of PIM for Microsoft Entra roles APIs in Microsoft Graph. > [!NOTE]-> To manage Azure resource roles use the [PIM APIs for Azure Resource Manager (ARM)](/rest/api/authorization/privileged-role-eligibility-rest-sample). +> To manage Azure resource roles use the [PIM APIs for Azure Resource Manager](/rest/api/authorization/privileged-role-eligibility-rest-sample). ## PIM APIs for managing active role assignments |
v1.0 | Privilegeescalation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/privilegeescalation.md | description: "A container for privilege escalation events." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Privilegeescalationawsresourcefinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/privilegeescalationawsresourcefinding.md | description: "AWS resources with privilege escalation." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Privilegeescalationawsrolefinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/privilegeescalationawsrolefinding.md | description: "AWS roles with privilege escalation." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Privilegeescalationfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/privilegeescalationfinding.md | description: "Represents findings for a list of privilege escalations in AWS or ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Privilegeescalationgcpserviceaccountfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/privilegeescalationgcpserviceaccountfinding.md | description: "GCP service accounts with privilege escalation" ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Privilegeescalationuserfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/privilegeescalationuserfinding.md | description: "Represents findings for a list of users who can escalate privilege ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Program | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/program.md | Each tenant that has on-boarded Microsoft Entra access reviews has one program, ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Programcontrol | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/programcontrol.md | In the Microsoft Entra [access reviews](accessreviews-root.md) feature, the prog ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Programcontroltype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/programcontroltype.md | None. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Project Rome Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/project-rome-overview.md | -Three key Project Rome capabilities are exposed via Microsoft Graph to help you enable great cross-device experiences: activities, devices, and notifications. +The following key capabilities are exposed via Microsoft Graph to help you enable cross-device experiences. ## Activities You can use the following Microsoft Graph APIs to communicate with other Windows - [Send a command to a device](../api/send-device-command.md) - [Get command status](../api/get-device-command-status.md) +## Roaming data ++Access Windows data stored in the cloud via the cloud clipboard and Windows settings APIs. ++The Cloud Clipboard feature in Windows enables users to copy and paste items such as text, images, and links across their applications and devices. You can use the cloud clipboard APIs in Microsoft Graph to: ++- [List cloud clipboard items for the signed-in user](/graph//api/cloudclipboardroot-list-items) +- [Get a cloud clipboard item for a user](/graph/api/cloudclipboarditem-get) ++The Windows setting API in Microsoft Graph enables users and authorized third parties acting on behalf of users to retrieve their Windows operating system settings data stored in the Microsoft cloud. For details about using the Windows setting API, see [Use the Windows settings API](/graph/api/resources/windows-setting-api-overview). |
v1.0 | Projectrome Activity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/projectrome-activity.md | Your user activities will be showcased in Cortana and Windows Timeline user expe ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Projectrome Imageinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/projectrome-imageinfo.md | A complex type for representing the **attribution** property in the [visualInfo] ## JSON Representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Projectrome Notification | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/projectrome-notification.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Protectdonotforwardaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/protectdonotforwardaction.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Provisionedidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/provisionedidentity.md | Describes the identity associated with the provisioning object summary event. In ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Provisionedplan | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/provisionedplan.md | Title: "provisionedPlan resource type" -description: "The **provisionedPlans** property of the user entity and the organization entity is a collection of **provisionedPlan**." +description: "The provisionedPlans property of the user entity and the organization entity is a collection of provisionedPlan objects." ms.localizationpriority: medium doc_type: resourcePageType -+ # provisionedPlan resource type Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -The **provisionedPlans** property of the [user](user.md) entity and the [organization](organization.md) entity is a collection of **provisionedPlan**. +Used by the **provisionedPlans** property of the [user](user.md) entity and the [organization](organization.md) entity. ## Properties The **provisionedPlans** property of the [user](user.md) entity and the [organiz ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Provisioningerrorinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/provisioningerrorinfo.md | Describes the status of the provisioning event and the associated errors. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Provisioningserviceprincipal | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/provisioningserviceprincipal.md | Represents the service principal used for provisioning. Inherits from [identity] ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Provisioningstatusinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/provisioningstatusinfo.md | Describes the status of the provisioning summary event. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Publicclientapplication | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/publicclientapplication.md | Specifies settings for nonweb app or nonweb API (for example, mobile or other pu |redirectUris|String collection| Specifies the URLs where user tokens are sent for sign-in, or the redirect URIs where OAuth 2.0 authorization codes and access tokens are sent. | ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Quota | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/quota.md | The **quota** resource provides details about space constraints on a [drive](dri ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Rankedemailaddress | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/rankedemailaddress.md | Represents a ranked email address. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Recipient | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/recipient.md | Represents information about a user in the sending or receiving end of an event, ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Recommendationbase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/recommendationbase.md | None. |recommendationType|recommendationType|Friendly shortname to identify the [recommendation](../resources/recommendation.md). The possible values are: `adfsAppsMigration`, `enableDesktopSSO`, `enablePHS`, `enableProvisioning`, `switchFromPerUserMFA`, `tenantMFA`, `thirdPartyApps`, `turnOffPerUserMFA`, `useAuthenticatorApp`, `useMyApps`, `staleApps`, `staleAppCreds`, `applicationCredentialExpiry`, `servicePrincipalKeyExpiry`, `adminMFAV2`, `blockLegacyAuthentication`, `integratedApps`, `mfaRegistrationV2`, `pwagePolicyNew`, `passwordHashSync`, `oneAdmin`, `roleOverlap`, `selfServicePasswordReset`, `signinRiskPolicy`, `userRiskPolicy`, `verifyAppPublisher`, `privateLinkForAAD`, `appRoleAssignmentsGroups`, `appRoleAssignmentsUsers`, `managedIdentity`, `overprivilegedApps`, `unknownFutureValue`, `longLivedCredentials`, `aadConnectDeprecated`, `adalToMsalMigration`, `ownerlessApps`, `inactiveGuests`, `aadGraphDeprecationApplication`, `aadGraphDeprecationServicePrincipal`, `mfaServerDeprecation`. Also, please note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `longLivedCredentials`, `aadConnectDeprecated`, `adalToMsalMigration`, `ownerlessApps`, `inactiveGuests`. | |releaseType|releaseType|The current release type of the recommendation. The possible values are: `preview`, `generallyAvailable`, `unknownFutureValue`. | |remediationImpact|String|Description of the impact on users of the remediation. Only applies to [recommendations](../resources/recommendation.md) with **category** set to `identitySecureScore`.|+|requiredLicenses|requiredLicenses|The required licenses to view the recommendation. The possible values are: `notApplicable`, `microsoftEntraIdFree`, `microsoftEntraIdP1`, `microsoftEntraIdP2`, `microsoftEntraIdGovernance`, `microsoftEntraWorkloadId`, `unknownFutureValue`.| |status|recommendationStatus| Indicates the status of the [recommendation](../resources/recommendation.md) based on user or system action. The possible values are: `active`, `completedBySystem`, `completedByUser`, `dismissed`, `postponed`, `unknownFutureValue`. By default, a recommendation's **status** is set to `active` when the recommendation is first generated. **Status** is set to `completedBySystem` when our service detects that a recommendation which was previously active no longer applies. | ## Relationships The following JSON representation shows the resource type. "String" ], "releaseType": "String",+ "requiredLicenses": "String", "impactType": "String", "impactStartDateTime": "String (timestamp)", "insights": "String", |
v1.0 | Recurrencerange | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/recurrencerange.md | Use the **type** property to specify the different types of **recurrenceRange**. ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Redirecturisettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/redirecturisettings.md | Specifies the index of the URLs where user tokens are sent for sign-in. This is ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Redundantassignmentalertconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/redundantassignmentalertconfiguration.md | Inherits from [unifiedRoleManagementAlertConfiguration](../resources/unifiedrole |alertDefinition|[unifiedRoleManagementAlertDefinition](../resources/unifiedrolemanagementalertdefinition.md)| The definition of the alert that contains its description, impact, and measures to mitigate or prevent it. Supports `$expand`.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Referenceattachment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/referenceattachment.md | None ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Regionalandlanguagesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/regionalandlanguagesettings.md | Title: "regionalAndLanguageSettings resource type" description: "A resource representing a users regional and language preferences" ms.localizationpriority: medium + doc_type: resourcePageType |
v1.0 | Regionalformatoverrides | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/regionalformatoverrides.md | Title: "regionalFormatOverrides resource type" description: "A resource representing regional formatting overrides for calendars, dates, and times." ms.localizationpriority: medium + doc_type: resourcePageType # regionalFormatOverrides resource type |
v1.0 | Registrationenforcement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/registrationenforcement.md | Enforce registration at sign-in time. This can currently only be used to remind None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.registrationEnforcement" |
v1.0 | Reminder | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/reminder.md | A reminder for an [event](event.md) in a user [calendar](calendar.md). ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Removeaccessapplyaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/removeaccessapplyaction.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.removeAccessApplyAction" |
v1.0 | Reportsuspiciousactivitysettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/reportsuspiciousactivitysettings.md | Defines the report suspicious activity settings for the tenant, whether it's ena None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.reportSuspiciousActivitySettings" |
v1.0 | Requiredresourceaccess | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/requiredresourceaccess.md | Specifies the set of OAuth 2.0 permission scopes and app roles under the specifi ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Resourcedata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/resourcedata.md | description: "Represents the resource data attached to the change notification s ms.localizationpriority: medium doc_type: resourcePageType+ # resourceData resource type None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Responsestatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/responsestatus.md | You can get the response status of an attendee or organizer through the **respon ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Riskdetection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/riskdetection.md | Title: "riskDetection resource type" -description: "Represents all risk detections in AzureAD tenants." +description: "Represents all risk detections in a Microsoft Entra tenant." ms.localizationpriority: medium doc_type: resourcePageType + # riskDetection resource type Namespace: microsoft.graph For more information about risk detection, see [Microsoft Entra ID Protection](/ |lastUpdatedDateTime|DateTimeOffset|Date and time that the risk detection was last updated. | |location|[signInLocation](signinlocation.md)|Location of the sign-in. | |requestId|string|Request ID of the sign-in associated with the risk detection. This property is null if the risk detection is not associated with a sign-in.|-|riskEventType|String|The type of risk event detected. The possible values are `adminConfirmedUserCompromised`, `anomalousUserActivity`, `anonymizedIPAddress`, `generic`, `investigationsThreatIntelligence`, `investigationsThreatIntelligenceSigninLinked`,`leakedCredentials`, `maliciousIPAddress`, `maliciousIPAddressValidCredentialsBlockedIP`, `malwareInfectedIPAddress`, `mcasImpossibleTravel`, `mcasSuspiciousInboxManipulationRules`, `suspiciousAPITraffic`, `suspiciousIPAddress`, `unfamiliarFeatures`, `unlikelyTravel`, `userReportedSuspiciousActivity`. <br/> For more information about each value, see [Risk types and detection](/entra/id-protection/concept-identity-protection-risks#risk-types-and-detection).| +|riskEventType|String|The type of risk event detected. The possible values are `adminConfirmedUserCompromised`, `anomalousUserActivity`, `anonymizedIPAddress`,`attackerinTheMiddle`,`attemptedPRTAccess`, `generic`, `investigationsThreatIntelligence`, `investigationsThreatIntelligenceSigninLinked`,`leakedCredentials`, `maliciousIPAddress`, `maliciousIPAddressValidCredentialsBlockedIP`, `malwareInfectedIPAddress`, `mcasImpossibleTravel`,`mcasFinSuspiciousFileAccess`, `mcasSuspiciousInboxManipulationRules`,`nationStateIP`, `suspiciousAPITraffic`, `suspiciousIPAddress`,`suspiciousSendingPatterns`, `unfamiliarFeatures`, `unlikelyTravel`, `userReportedSuspiciousActivity`. <br/> For more information about each value, see [Risk types and detection](/entra/id-protection/concept-identity-protection-risks#risk-types-and-detection).| |riskDetail|riskDetail|Details of the detected risk. The possible values are: `none`, `adminGeneratedTemporaryPassword`, `userPerformedSecuredPasswordChange`, `userPerformedSecuredPasswordReset`, `adminConfirmedSigninSafe`, `aiConfirmedSigninSafe`, `userPassedMFADrivenByRiskBasedPolicy`, `adminDismissedAllRiskForUser`, `adminConfirmedSigninCompromised`, `hidden`, `adminConfirmedUserCompromised`, `unknownFutureValue`, `adminConfirmedServicePrincipalCompromised`, `adminDismissedAllRiskForServicePrincipal`, `m365DAdminDismissedDetection`. Note that you must use the `Prefer: include - unknown -enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `adminConfirmedServicePrincipalCompromised` , `adminDismissedAllRiskForServicePrincipal` , `m365DAdminDismissedDetection`. <br/><br />**Note:** Details for this property are only available for Microsoft Entra ID P2 customers. P1 customers will be returned `hidden`.| |riskLevel|riskLevel|Level of the detected risk. The possible values are `low`, `medium`, `high`, `hidden`, `none`, `unknownFutureValue`. <br />**Note:** Details for this property are only available for Microsoft Entra ID P2 customers. P1 customers will be returned `hidden`.| |riskState|riskState|The state of a detected risky user or sign-in. The possible values are `none`, `confirmedSafe`, `remediated`, `dismissed`, `atRisk`, `confirmedCompromised`, and `unknownFutureValue`. | |
v1.0 | Riskprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/riskprofile.md | description: "Contains information for human and workload identity counts in a s ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Rolemanagementalert | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/rolemanagementalert.md | None. |operations|[longRunningOperation](../resources/longrunningoperation.md) collection|Represents operations on resources that take a long time to complete and can run in the background until completion. | ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Rubriclevel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/rubriclevel.md | A level of a rubric. See [educationRubric](educationrubric.md) for a description ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Samlidentitysource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/samlidentitysource.md | description: "Represents source for SAML identities." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Samlsinglesignonsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/samlsinglesignonsettings.md | Represents a container for settings related to SAML single sign-on. ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Scheduledpermissionsrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/scheduledpermissionsrequest.md | description: "Represents a request for permissions on resources in a target auth ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Schedulinggroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/schedulinggroup.md | A logical grouping of users in a [schedule](schedule.md) (usually by role). ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Schemaextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/schemaextension.md | description: "Schema extensions allow you to define a schema to extend and add s ms.localizationpriority: medium doc_type: resourcePageType+ # schemaExtension resource type (schema extensions) The owner app can move the extension through different states of a lifecycle, us ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Scopedrolemembership | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/scopedrolemembership.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Secretinformationaccessawsresourcefinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/secretinformationaccessawsresourcefinding.md | description: "View AWS resources that have privileges to read, modify, or delete ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Secretinformationaccessawsrolefinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/secretinformationaccessawsrolefinding.md | description: "*View AWS identities that have privileges to read, modify, or dele ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Secretinformationaccessawsserverlessfunctionfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/secretinformationaccessawsserverlessfunctionfinding.md | description: "View AWS serverless functions that have privileges to read, modify ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Secretinformationaccessawsuserfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/secretinformationaccessawsuserfinding.md | description: "View AWS users that have privileges to read, modify, or delete sec ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Sectiongroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/sectiongroup.md | A section group in a OneNote notebook. Section groups can contain sections and s ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Sectionlinks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/sectionlinks.md | Links for opening a OneNote section. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Security Alert | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-alert.md | Security providers create an alert in the system when they detect a threat. Micr None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Alertevidence | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-alertevidence.md | This resource is the base type for the following evidence types: None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.security.alertEvidence" |
v1.0 | Security Analyzedemail | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-analyzedemail.md | Contains metadata for email messages that are analyzed for security threats. |phishConfidenceLevel|String|The phish confidence level associated with the email| |policy|String|The action policy that took effect.| |policyAction|String|The action taken on the email based on the configured policy.|-|recipientEmailAddresses|String collection|Contains the email addresses of the recipients.| +|recipientEmailAddress|String|Contains the email address of the recipient.| |returnPath|String|A field that indicates where and how bounced emails are processed.| |senderDetail|[microsoft.graph.security.analyzedEmailSenderDetail](../resources/security-analyzedemailsenderdetail.md)|Sender details of the email.| |sizeInBytes|Int32| Size of the email in bytes.| |spamConfidenceLevel|String|Spam confidence of the email.| |subject|String|Subject of the email.|-|threatType|[microsoft.graph.security.threatType](#threattype-values)|Indicates the threat types. The possible values are: `unknown`, `spam`, `malware`, `phishing`, `none`, `unknownFutureValue`.| +|threatTypes|[microsoft.graph.security.threatType](#threattype-values) collection|Indicates the threat types. The possible values are: `unknown`, `spam`, `malware`, `phish`, `none`, `unknownFutureValue`.| |urls|[microsoft.graph.security.analyzedEmailUrl](../resources/security-analyzedemailurl.md) collection|A collection of the URLs in the email.| |urlsCount|Int32|The number of URLs in the email.| Contains metadata for email messages that are analyzed for security threats. |unknown| |spam| |malware|-|phishing| +|phish| |none| |unknownFutureValue| The following JSON representation shows the resource type. "senderDetail": { "@odata.type": "microsoft.graph.security.analyzedEmailSenderDetail" },- "recipientEmailAddresses": [ - "String" - ], + "recipientEmailAddress": "String", "distributionList": "String", "subject": "String", "returnPath": "String",- "directionality": "String", + "directionality": "microsoft.graph.security.antispamDirectionality", "originalDelivery": { "@odata.type": "microsoft.graph.security.analyzedEmailDeliveryDetail" }, The following JSON representation shows the resource type. "overrideSources": [ "String" ],- "threatType": "String", + "threatTypes": [ + "microsoft.graph.security.threatType" + ], "detectionMethods": [ "String" ], The following JSON representation shows the resource type. "policy": "String" } ```- |
v1.0 | Security Api Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-api-overview.md | You can create advanced hunting [Custom detection rules](/microsoft-365/security ### Quotas -1. [Get multiple rules](../api/security-detectionrule-list.md): 10 rules per minute per application, 300 rules per hour per application, 600 rules per hour per tenant -2. [Get a single rule](../api/security-detectionrule-get.md): 100 rules per minute per application, 1,500 rules per hour per application, 1,800 rules per hour per tenant -3. [Create rule](../api/security-detectionrule-post-detectionRules.md): 10 rules per minute per application, 1,500 rules per hour per application, 1,800 rules per hour per tenant -4. [Update rule](../api/security-detectionrule-update.md): 100 rules per minute per application, 1,500 rules per hour per application, 1,800 rules per hour per tenant +1. [Get multiple rules](../api/security-detectionrule-list.md): 10 rules per minute per application, 300 rules per hour per application, 600 rules per hour per tenant +2. [Get a single rule](../api/security-detectionrule-get.md): 100 rules per minute per application, 1,500 rules per hour per application, 1,800 rules per hour per tenant +3. [Create rule](../api/security-detectionrule-post-detectionRules.md): 10 rules per minute per application, 1,500 rules per hour per application, 1,800 rules per hour per tenant +4. [Update rule](../api/security-detectionrule-update.md): 100 rules per minute per application, 1,500 rules per hour per application, 1,800 rules per hour per tenant 5. [Delete rule](../api/security-detectionrule-delete.md): 100 rules per minute per application, 1,500 rules per hour per application, 1,800 rules per hour per tenant ## Alerts Alerts are detailed warnings about suspicious activities in a customer's tenant that Microsoft or partner security providers have identified and flagged for action. Attacks typically employ various techniques against different types of entities, such as devices, users, and mailboxes. The result is alerts from multiple security providers for multiple entities in the tenant. Piecing the individual alerts together to gain insight into an attack can be challenging and time-consuming. -The beta version of the security API offers two types of alerts that aggregate other alerts from security providers and make analyzing attacks and determining responses easier: +The beta version of the security API offers two types of alerts that aggregate other alerts from security providers and make analyzing attacks and determining responses easier: - [Alerts and incidents](#alerts-and-incidents) - the latest generation of alerts in the Microsoft Graph security API. They are represented by the [alert](security-alert.md) resource and its collection, [incident](security-incident.md) resource, defined in the `microsoft.graph.security` namespace. - [Legacy alerts](#legacy-alerts) - the first generation of alerts in the Microsoft Graph security API. They are represented by the [alert](alert.md) resource defined in the `microsoft.graph` namespace. These [alert](security-alert.md) resources first pull alert data from security p Alerts from the following security providers are available via these rich alerts and incidents: - [Microsoft Entra ID Protection](/azure/active-directory/identity-protection/overview-identity-protection) - [Microsoft 365 Defender](/microsoft-365/security/defender/microsoft-365-defender?view=o365-worldwide&preserve-view=true)-- [Microsoft Defender for Cloud Apps](/cloud-app-security/monitor-alerts) +- [Microsoft Defender for Cloud Apps](/cloud-app-security/monitor-alerts) - [Microsoft Defender for Endpoint](/microsoft-365/security/defender-endpoint/microsoft-defender-endpoint?view=o365-worldwide&preserve-view=true)-- [Microsoft Defender for Identity](/defender-for-identity/alerts-overview) +- [Microsoft Defender for Identity](/defender-for-identity/alerts-overview) - [Microsoft Defender for Office 365](/microsoft-365/security/office-365-security/overview?view=o365-worldwide&preserve-view=true) - [Microsoft Purview Data Loss Prevention](/microsoft-365/compliance/dlp-learn-about-dlp?view=o365-worldwide&preserve-view=true) ### Legacy alerts -These [alert](alert.md) resources federate calling of supported Azure and Microsoft 365 Defender security providers. They aggregate common alert data among the different domains to allow applications to unify and streamline the management of security issues across all integrated solutions. They enable applications to correlate alerts and context to improve threat protection and response. +> [!NOTE] +> The legacy alerts API is deprecated and will be removed by April 2026. We recommend that you migrate to the new [alerts and incidents](/graph/api/resources/security-alert) API. ++The legacy [alert](alert.md) resources federate calling of supported Azure and Microsoft 365 Defender security providers. They aggregate common alert data among the different domains to allow applications to unify and streamline the management of security issues across all integrated solutions. They enable applications to correlate alerts and context to improve threat protection and response. With the alert update capability, you can sync the status of specific alerts across different security products and services that are integrated with the Microsoft Graph security API by updating your **alert** entity. -Alerts from the following security providers are available via this legacy **alert** resource. Support for GET alerts, PATCH alerts, and subscribe (via webhooks) is indicated in the following table. +Alerts from the following security providers are available via the legacy **alert** resource. Support for GET alerts, PATCH alerts, and subscribe (via webhooks) is indicated in the following table. | Security provider | <p align="center">GET alert</p>| <p align="center">PATCH alert</p>| <p align="center">Subscribe to alert</p>| |:|:|:--|:| Alerts from the following security providers are available via this legacy **ale \*\* Microsoft Defender for Endpoint requires additional [user roles](/windows/security/threat-protection/microsoft-defender-atp/user-roles) to those required by the Microsoft Graph security API. Only the users in both Microsoft Defender for Endpoint and Microsoft Graph security API roles can have access to the Microsoft Defender for Endpoint data. Because application-only authentication is not limited by this, we recommend that you use an application-only authentication token. -\*\*\* Microsoft Defender for Identity alerts are available via the Microsoft Defender for Cloud Apps integration. This means you will get Microsoft Defender for Identity alerts only if you have joined Unified SecOps and connected Microsoft Defender for Identity into Microsoft Defender for Cloud Apps. Learn more about [how to integrate Microsoft Defender for Identity and Microsoft Defender for Cloud Apps](/azure-advanced-threat-protection/atp-mcas-integration). +\*\*\* Microsoft Defender for Identity alerts are available via the Microsoft Defender for Cloud Apps integration. This means you get Microsoft Defender for Identity alerts only if you have joined Unified SecOps and connected Microsoft Defender for Identity into Microsoft Defender for Cloud Apps. Learn more about [how to integrate Microsoft Defender for Identity and Microsoft Defender for Cloud Apps](/azure-advanced-threat-protection/atp-mcas-integration). ## Attack simulation and training Alerts from the following security providers are available via this legacy **ale ## Incidents -An [incident](security-incident.md) is a collection of correlated  [alerts](security-alert.md) and associated data that make up the story of an attack. Incident management is part of Microsoft 365 Defender and is available in the Microsoft 365 Defender portal (https://security.microsoft.com/). +An [incident](security-incident.md) is a collection of correlated  [alerts](security-alert.md) and associated data that make up the story of an attack. Incident management is part of Microsoft 365 Defender and is available in the Microsoft 365 Defender portal (https://security.microsoft.com/). -Microsoft 365 services and apps create  alerts  when they detect a suspicious or malicious event or activity. Individual alerts provide valuable clues about a completed or ongoing attack. However, attacks typically employ various techniques against different types of entities, such as devices, users, and mailboxes. The result is multiple  alerts for multiple entities in your tenant. +Microsoft 365 services and apps create  alerts  when they detect a suspicious or malicious event or activity. Individual alerts provide valuable clues about a completed or ongoing attack. However, attacks typically employ various techniques against different types of entities, such as devices, users, and mailboxes. The result is multiple  alerts for multiple entities in your tenant. -Because piecing the individual alerts together to gain insight into an attack can be challenging and time-consuming, Microsoft 365 Defender automatically aggregates the alerts and their associated information into an [incident](security-incident.md). +Because piecing the individual alerts together to gain insight into an attack can be challenging and time-consuming, Microsoft 365 Defender automatically aggregates the alerts and their associated information into an [incident](security-incident.md). -Grouping related alerts into an incident gives you a comprehensive view of an attack. For example, you can see: +Grouping related alerts into an incident gives you a comprehensive view of an attack. For example, you can see: -- Where the attack started. -- What tactics were used. -- How far the attack has gone into your tenant. -- The scope of the attack, such as how many devices, users, and mailboxes were impacted. -- All of the data associated with the attack. +- Where the attack started. +- What tactics were used. +- How far the attack has gone into your tenant. +- The scope of the attack, such as how many devices, users, and mailboxes were impacted. +- All of the data associated with the attack. -The  [incident](security-incident.md) resource and its APIs allow you to sort through incidents to create an informed cyber security response. It exposes a collection of incidents, with their related  [alerts](security-alert.md), that were flagged in your network, within the time range you specified in your environment retention policy. +The  [incident](security-incident.md) resource and its APIs allow you to sort through incidents to create an informed cyber security response. It exposes a collection of incidents, with their related  [alerts](security-alert.md), that were flagged in your network, within the time range you specified in your environment retention policy. ## Information protection The  [incident](security-incident.md) resource and its APIs allow you to sort > **Note:** We recommend that you use the [threat submission](https://github.com/microsoftgraph/microsoft-graph-docs/pull/16242/files#threat-submission) API instead. ++## Records management ++Most organizations need to manage data to proactively comply with industry regulations and internal policies, reduce risk in the event of litigation or a security breach, and let their employees effectively and agiley share knowledge that is current and relevant to them. You can use the [records management APIs](../resources/security-recordsmanagement-overview.md) to systematically apply [retention labels](security-retentionlabel.md) to different types of content that require different retention settings. For example, you can configure the start of retention period from when the content was created, last modified, labeled or when an event occurs for a particular event type. Further, you can use [file plan descriptors](security-fileplandescriptor.md) to improve the manageability of these retention labels. + ## Secure Score [Microsoft Secure Score](https://techcommunity.microsoft.com/t5/Security-Privacy-and-Compliance/Office-365-Secure-Score-is-now-Microsoft-Secure-Score/ba-p/182358) is a security analytics solution that gives you visibility into your security portfolio and how to improve it. With a single score, you can better understand what you have done to reduce your risk in Microsoft solutions. You can also compare your score with other organizations and see how your score has been trending over time. The [secureScore](securescores.md) and [secureScoreControlProfile](securescorecontrolprofiles.md) entities help you balance your organization's security and productivity needs while enabling the appropriate mix of security features. You can also project what your score will be after you adopt security features. The threat intelligence APIs (preview) allow you to operationalize intelligence ## Threat intelligence indicators (preview) +> [!NOTE] +> The [tiIndicator](tiindicator.md) entity is deprecated and will be removed by April 2026. + Threat indicators also referred to as indicators of compromise (IoCs), represent data about known threats, such as malicious files, URLs, domains, and IP addresses. Customers can generate indicators through internal threat intelligence gathering or acquire indicators from threat intelligence communities, licensed feeds, and other sources. These indicators are then used in various security tools to defend against related threats. The [tiIndicator](tiindicator.md) entity allows customers to feed threat indicators to Microsoft security solutions to take a block or alert action on a malicious activity, or to allow the activity that has been determined to be irrelevant to the organization and suppress actions for the indicator. To send an indicator, specify the Microsoft security solution intended to utilize the indicator and the action to take for that indicator. Threat indicators sent via the Microsoft Graph security API are available today The Microsoft Graph threat submission API helps organizations to submit a threat received by any user in a tenant. This empowers customers to report spam or suspicious emails, phishing URLs, or malware attachments they receive to Microsoft. Microsoft checks the submission against the organizational policies in effect and sends it to human graders for analysis. The result then helps tenant administrators understand the threat scanning verdict and adjust their organizational policy. Admins can also use the results to report legitimate emails to prevent them from getting blocked. -> **Note:** We recommend that you use this API instead of the deprecated Information Protection threat assessment API. The threat submission API provides unified security threat submission functionality and adds unified result support, user submission query support, tenant allow block list support, admin review support and app-only mode support. +> **Note:** We recommend that you use the threat submission API instead of the deprecated Information Protection threat assessment API. The threat submission API provides unified security threat submission functionality and adds unified result support, user submission query support, tenant allow block list support, admin review support and app-only mode support. ## Email and collaboration protection (preview) [Microsoft Defender for Office 365](/microsoft-365/security/office-365-security/defender-for-office-365?view=o365-worldwide&preserve-view=true) is a cloud-based email filtering service that helps protect your organization against advanced threats to email and collaboration tools, like phishing, business email compromise, and malware attacks. You can use the Microsoft Graph **analyzedemails** and **remediate** APIs to retrieve email metadata and perform response actions (soft delete, hard delete, move to junk, move to Inbox) on analyzed messages. -> **Note:** These APIs are only availbe for Defender for Office 365 Plan 2 or Microsoft 365 A5/E5/F5/G5 Security service plans. For the most up-to-date list of service plans, see [Microsoft Defender for Office 365 service description](/office365/servicedescriptions/office-365-advanced-threat-protection-service-description). +> **Note:** These APIs are only available for Defender for Office 365 Plan 2 or Microsoft 365 A5/E5/F5/G5 Security service plans. For the most up-to-date list of service plans, see [Microsoft Defender for Office 365 service description](/office365/servicedescriptions/office-365-advanced-threat-protection-service-description). ++## Identities ++### Health Issues +The Defender for Identity health issues API allows you to monitor the health status of your sensors and agents across your hybrid identity infrastructure. You can use the health issues API to retrieve information about the current health issues of your sensors, such as the issue type, status, configuration, and severity. You can also use the API to identify and resolve any issues that may affect the functionality or security of your sensors and agents. ## Common use cases The following are some of the most popular requests for working with the Microso | **Email analysis and remediation**||| |Query email metadata|[LIST analyzedemails](../api/security-collaborationroot-list-analyzedemails.md)|[https://graph.microsoft.com/beta/security/collaboration/analyzedemails?startTime={startTime}&endTime={endTime}](https://developer.microsoft.com/graph/graph-explorer?request=security/collaboration/analyzedemails?startTime={startTime}&endTime={endTime}&method=GET&version=beta&GraphUrl=https://graph.microsoft.com)| |Get details of a single message instance|[GET analyzedemails/Id](../api/security-analyzedemail-get.md)|[https://graph.microsoft.com/beta/security/collaboration/analyzedemails/{Id}](https://developer.microsoft.com/graph/graph-explorer?request=security/collaboration/analyzedemails/Id&method=GET&version=beta&GraphUrl=https://graph.microsoft.com)|-|Remediate analyzed email|[analyzedEmai: remediate](../api/security-analyzedemail-remediate.md )|[https://graph.microsoft.com/beta/security/collaboration/analyzedemails/remediate](https://developer.microsoft.com/graph/graph-explorer?request=security/collaboration/analyzedemails/remediate&method=POST&version=beta&GraphUrl=https://graph.microsoft.com)| +|Remediate analyzed email|[analyzedEmail: remediate](../api/security-analyzedemail-remediate.md )|[https://graph.microsoft.com/beta/security/collaboration/analyzedemails/remediate](https://developer.microsoft.com/graph/graph-explorer?request=security/collaboration/analyzedemails/remediate&method=POST&version=beta&GraphUrl=https://graph.microsoft.com)| +| **Identities**||| +| List health issues | [List health issues](../api/security-identityContainer-list-healthIssues.md) | [https://graph.microsoft.com/beta/security/identities/healthIssues](https://developer.microsoft.com/graph/graph-explorer?request=security/identities/healthIssues&method=GET&version=beta&GraphUrl=https://graph.microsoft.com) | + You can use Microsoft Graph [webhooks](/graph/webhooks) to subscribe to and receive notifications about updates to Microsoft Graph security API entities. |
v1.0 | Security Appliedcategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-appliedcategory.md | - Title: "appliedCategory resource type" -description: "Represents the file plan descriptor of type category applied to a particular retention label." ---doc_type: resourcePageType ---# appliedCategory resource type --Namespace: microsoft.graph.security ---Represents the file plan descriptor of type category applied to a particular retention label. ---Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). --## Properties -|Property|Type|Description| -|:|:|:| -|displayName|String|Unique string that defines a category name applied to the label. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| -|subCategory|[microsoft.graph.security.subCategory](../resources/security-subcategory.md)|Represents the file plan descriptor for a subcategory under a specific category, which has been assigned to a particular retention label.| --## Relationships -None. --## JSON representation -The following is a JSON representation of the resource. -<!-- { - "blockType": "resource", - "@odata.type": "microsoft.graph.security.appliedCategory" -} >-``` json -{ - "@odata.type": "#microsoft.graph.security.appliedCategory", - "displayName": "String", - "subCategory": { - "@odata.type": "microsoft.graph.security.subCategory" - } -} -``` - |
v1.0 | Security Authority | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-authority.md | - Title: "authority resource type" -description: "Represents the file plan descriptor of type authority applied to a particular retention label." ---doc_type: resourcePageType ---# authority resource type --Namespace: microsoft.graph.security ---Represents the file plan descriptor of type authority applied to a particular retention label. ---Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). --## Properties -|Property|Type|Description| -|:|:|:| -|displayName|String|Unique string that defines an authority name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| --## Relationships -None. --## JSON representation -The following is a JSON representation of the resource. -<!-- { - "blockType": "resource", - "@odata.type": "microsoft.graph.security.authority" -} >-``` json -{ - "@odata.type": "#microsoft.graph.security.authority", - "displayName": "String" -} -``` - |
v1.0 | Security Authoritytemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-authoritytemplate.md | Namespace: microsoft.graph.security [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Specifies the underlying authority that describes the type of content to be retained and its retention schedule. +Specifies the underlying authority that describes the type of content to be retained and its retention schedule. Supports CRUD operations to apply and manage the [filePlanAuthority](security-fileplanauthority.md) descriptor for a [retentionLabel](security-retentionlabel.md). The **authority** file plan descriptor supplements a retention label to improve the manageability and organization of Microsoft 365 content. Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources ## Properties |Property|Type|Description| |:|:|:|-|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the authority. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| -|createdDateTime|DateTimeOffset|Represents the date and time in which the authority is created. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| -|displayName|String|Unique string that defines an authority name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| -|id|String|Unique ID of the authority. Inherited from [microsoft.graph.entity](../resources/entity.md).| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the authority descriptor. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only. | +|createdDateTime|DateTimeOffset|Represents the date and time in which the authority descriptor is created. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|displayName|String|Unique string that defines an authority name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md).| +|id|String|Unique ID of the authority. Inherited from [microsoft.graph.entity](../resources/entity.md). Read-only.| ## Relationships None. |
v1.0 | Security Categorytemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-categorytemplate.md | Namespace: microsoft.graph.security [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Specifies a group of similar types of content in a particular department. -+Specifies a group of similar types of content in a particular department. This resource supports CRUD operations to apply and manage the [filePlanAppliedCategory](security-fileplanappliedcategory.md) descriptor, and any [filePlanSubcategory](security-fileplansubcategory.md) descriptor for a [retentionLabel](security-retentionlabel.md). These file plan descriptors supplement a retention label to improve the manageability and organization of Microsoft 365 content. Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources |[Create categories](../api/security-labelsroot-post-categories.md)|[microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md)|Create a new [microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) object.| |[Get categories](../api/security-categorytemplate-get.md)|[microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md)|Read the properties and relationships of a [microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) object.| |[Delete categories](../api/security-labelsroot-delete-categories.md)|None|Delete a [microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) object.|-|[List subCategories](../api/security-categorytemplate-list-subcategories.md)|[microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) collection|Get the subCategoryTemplate resources from the subCategories navigation property.| -|[Create subCategories](../api/security-categorytemplate-post-subcategories.md)|[microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md)|Create a new subCategoryTemplate object.| +|[List subcategories](../api/security-categorytemplate-list-subcategories.md)|[microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md) collection|Get the subcategoryTemplate resources from the subcategories navigation property.| +|[Create subcategories](../api/security-categorytemplate-post-subcategories.md)|[microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md)|Create a new subcategoryTemplate object.| ## Properties |Property|Type|Description| |:|:|:|-|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the category. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| -|createdDateTime|DateTimeOffset|Represents the date and time in which the category is created. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| -|displayName|String|Unique string that defines a category name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| -|id|String|Unique ID of the category. Inherited from [microsoft.graph.entity](../resources/entity.md).| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the category descriptor. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|createdDateTime|DateTimeOffset|Represents the date and time in which the category descriptor is created. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|displayName|String|Unique string that defines a category name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md).| +|id|String|Unique ID of the category. Inherited from [microsoft.graph.entity](../resources/entity.md). Read-only.| ## Relationships |Relationship|Type|Description| |:|:|:|-|subCategories|[microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) collection|Represents all subcategories under a particular category.| +|subcategories|[microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md) collection|Represents all subcategories under a particular category.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Citation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-citation.md | - Title: "citation resource type" -description: "Represents the file plan descriptor of type citation applied to a particular retention label." ---doc_type: resourcePageType ---# citation resource type --Namespace: microsoft.graph.security ---Represents the file plan descriptor of type citation applied to a particular retention label. ---Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). --## Properties -|Property|Type|Description| -|:|:|:| -|citationJurisdiction|String|Represents the jurisdiction or agency that published the citation.| -|citationUrl|String|Represents the URL to the published citation.| -|displayName|String|Unique string that defines a citation name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| --## Relationships -None. --## JSON representation -The following is a JSON representation of the resource. -<!-- { - "blockType": "resource", - "@odata.type": "microsoft.graph.security.citation" -} >-``` json -{ - "@odata.type": "#microsoft.graph.security.citation", - "displayName": "String", - "citationUrl": "String", - "citationJurisdiction": "String" -} -``` - |
v1.0 | Security Citationtemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-citationtemplate.md | Title: "citationTemplate resource type" -description: "The specific rule or regulation created by a jurisdiction used to determine whether certain labels and content should be retained or deleted." +description: "Represents the specific rule or regulation created by a jurisdiction used to determine whether certain labels and content should be retained or deleted." ms.localizationpriority: medium Namespace: microsoft.graph.security [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -The specific rule or regulation created by a jurisdiction used to determine whether certain labels and content should be retained or deleted. -+Represents the specific rule or regulation created by a jurisdiction used to determine whether certain labels and content should be retained or deleted. This resource supports CRUD operations to apply and manage the [filePlanCitation](security-fileplancitation.md) descriptor for a [retentionLabel](security-retentionlabel.md). The **citation** file plan descriptor supplements a retention label to improve the manageability and organization of Microsoft 365 content. Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources |:|:|:| |citationJurisdiction|String|Represents the jurisdiction or agency that published the citation.| |citationUrl|String|Represents the URL to the published citation.|-|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the citation. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| -|createdDateTime|DateTimeOffset|Represents the date and time in which the citation is created. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| -|displayName|String|Unique string that defines a citation name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| -|id|String|Unique ID of the citation. Inherited from [microsoft.graph.entity](../resources/entity.md).| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the citation descriptor. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|createdDateTime|DateTimeOffset|Represents the date and time in which the citation descriptor is created. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|displayName|String|Unique string that defines a citation name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md).| +|id|String|Unique ID of the citation. Inherited from [microsoft.graph.entity](../resources/entity.md). Read-only.| ## Relationships None. ## JSON representation-The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Datasource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-datasource.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Datasourcecontainer | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-datasourcecontainer.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Department | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-department.md | - Title: "department resource type" -description: "Represents the file plan descriptor of type department applied to a particular retention label." ---doc_type: resourcePageType ---# department resource type --Namespace: microsoft.graph.security ---Represents the file plan descriptor of type department applied to a particular retention label. ---Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). --## Properties -|Property|Type|Description| -|:|:|:| -|displayName|String|Unique string that defines a department name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| --## Relationships -None. --## JSON representation -The following is a JSON representation of the resource. -<!-- { - "blockType": "resource", - "@odata.type": "microsoft.graph.security.department" -} >-``` json -{ - "@odata.type": "#microsoft.graph.security.department", - "displayName": "String" -} -``` - |
v1.0 | Security Departmenttemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-departmenttemplate.md | Namespace: microsoft.graph.security [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Specifies the department or business unit of an organization to which a label belongs. -+Specifies the department or business unit of an organization to which a label belongs. This resource supports CRUD operations to apply and manage the [filePlanDepartment](security-fileplandepartment.md) descriptor for a [retentionLabel](security-retentionlabel.md). The **department** file plan descriptor supplements a retention label to improve the manageability and organization of Microsoft 365 content. Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources ## Properties |Property|Type|Description| |:|:|:|-|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the department. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| -|createdDateTime|DateTimeOffset|Represents the date and time in which the department is created. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| -|displayName|String|Unique string that defines a department name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| -|id|String|Unique ID of the department. Inherited from [microsoft.graph.entity](../resources/entity.md).| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the department descriptor. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|createdDateTime|DateTimeOffset|Represents the date and time in which the department descriptor is created. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|displayName|String|Unique string that defines a department name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md).| +|id|String|Unique ID of the department. Inherited from [microsoft.graph.entity](../resources/entity.md). Read-only.| ## Relationships None. |
v1.0 | Security Detectionrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-detectionrule.md | Title: "detectionRule resource type" -description: "Represents a custom detection rule written in **Advanced hunting** to automatically recognize security events when they occur, and to trigger alerts and response actions." +description: "Represents a custom detection rule written in Advanced hunting to automatically recognize security events when they occur, and to trigger alerts and response actions." ms.localizationpriority: medium Namespace: microsoft.graph.security [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Custom detection rules are types of protection rules you can design and tweak using [advanced hunting](../api/security-security-runhuntingquery.md) queries. +Represents a custom detection rule written in **Advanced hunting** to automatically recognize security events when they occur, and to trigger alerts and response actions. ++Custom detection rules are types of protection rules that you can design and tweak by using [advanced hunting](../api/security-security-runhuntingquery.md) queries. These rules let you proactively monitor various events and system states, including suspected breach activity and misconfigured endpoints. A custom detection rule automatically recognizes security events when they occur, and triggers alerts and response actions.-You can set them to run at regular intervals, generating alerts and taking response actions whenever there are matches. +You can set them to run at regular intervals, generating alerts and taking response actions whenever matches occur. Inherits from [microsoft.graph.security.protectionRule](../resources/security-protectionrule.md). ## Methods | Method | Return type | Description | |:--|:--|:|-| [List detectionRules](../api/security-detectionrule-list.md) | [microsoft.graph.security.detectionRule](../resources/security-detectionrule.md) collection | Get a list of the [microsoft.graph.security.detectionRule](../resources/security-detectionrule.md) objects and their properties. | -| [Get detectionRule](../api/security-detectionrule-get.md) | [microsoft.graph.security.detectionRule](../resources/security-detectionrule.md) | Read the properties and relationships of a [microsoft.graph.security.detectionRule](../resources/security-detectionrule.md) object. | -| [Create detectionRule](../api/security-detectionrule-post-detectionRules.md) | [microsoft.graph.security.detectionRule](../resources/security-detectionrule.md) | Create a [microsoft.graph.security.detectionRule](../resources/security-detectionrule.md). | -| [Update detectionRule](../api/security-detectionrule-update.md) | [microsoft.graph.security.detectionRule](../resources/security-detectionrule.md) | Update the properties of a [microsoft.graph.security.detectionRule](../resources/security-detectionrule.md) object. | -| [Delete detectionRule](../api/security-detectionrule-delete.md) | None | Delete a [microsoft.graph.security.detectionRule](../resources/security-detectionrule.md) object. | +| [List](../api/security-detectionrule-list.md) | [microsoft.graph.security.detectionRule](../resources/security-detectionrule.md) collection | Get a list of the [microsoft.graph.security.detectionRule](../resources/security-detectionrule.md) objects and their properties. | +| [Get](../api/security-detectionrule-get.md) | [microsoft.graph.security.detectionRule](../resources/security-detectionrule.md) | Read the properties and relationships of a [microsoft.graph.security.detectionRule](../resources/security-detectionrule.md) object. | +| [Create](../api/security-detectionrule-post-detectionRules.md) | [microsoft.graph.security.detectionRule](../resources/security-detectionrule.md) | Create a [microsoft.graph.security.detectionRule](../resources/security-detectionrule.md). | +| [Update](../api/security-detectionrule-update.md) | [microsoft.graph.security.detectionRule](../resources/security-detectionrule.md) | Update the properties of a [microsoft.graph.security.detectionRule](../resources/security-detectionrule.md) object. | +| [Delete](../api/security-detectionrule-delete.md) | None | Delete a [microsoft.graph.security.detectionRule](../resources/security-detectionrule.md) object. | ## Properties | Property | Type | Description | |
v1.0 | Security Deviceevidence | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-deviceevidence.md | Inherits from [alertEvidence](../resources/security-alertevidence.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.security.deviceEvidence" |
v1.0 | Security Dispositionreviewstage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-dispositionreviewstage.md | For details, see [Disposition of content](/microsoft-365/compliance/disposition) |id|String|Unique ID for each stage. | |name|String|Name representing each stage within a collection. | |reviewersEmailAddresses|String collection|A collection of reviewers at each stage. |-|stageNumber|Int32|The sequence number for each stage of the disposition review. | +|stageNumber|String|The unique sequence number for each stage of the disposition review. | ## Relationships None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", Here's a JSON representation of the resource. { "@odata.type": "#microsoft.graph.security.dispositionReviewStage", "id": "String (identifier)",- "stageNumber": "Integer", + "stageNumber": "String", "name": "String", "reviewersEmailAddresses": [ "String" |
v1.0 | Security Downgradejustification | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-downgradejustification.md | Represents the user input on why downgrade was performed. The downgrade justific None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.security.downgradeJustification" |
v1.0 | Security Ediscoverycasesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-ediscoverycasesettings.md | Inherits from [entity](../resources/entity.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Ediscoveryexportoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-ediscoveryexportoperation.md | Inherits from [caseOperation](../resources/security-caseoperation.md). ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Ediscoveryfile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-ediscoveryfile.md | IM |Sent date. |tags|[microsoft.graph.security.ediscoveryReviewTag](../resources/security-ediscoveryreviewtag.md) collection|Tags associated with the file.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Ediscoveryholdoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-ediscoveryholdoperation.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Ediscoveryindexoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-ediscoveryindexoperation.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Ediscoverynoncustodialdatasource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-ediscoverynoncustodialdatasource.md | Inherits from [dataSourceContainer](../resources/security-datasourcecontainer.md |lastIndexOperation|[microsoft.graph.security.ediscoveryIndexOperation](../resources/security-ediscoveryindexoperation.md)|Operation entity that represents the latest indexing for the non-custodial data source.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Ediscoveryreviewtag | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-ediscoveryreviewtag.md | Represents an eDiscovery tag, which is used to mark documents during review to s |childTags|[microsoft.graph.security.ediscoveryReviewTag](../resources/security-ediscoveryreviewtag.md) collection|Returns the tags that are a child of a tag.| |parent|[microsoft.graph.security.ediscoveryReviewTag](../resources/security-ediscoveryreviewtag.md)|Returns the parent tag of the specified tag.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Emailcontentthreatsubmission | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-emailcontentthreatsubmission.md | Inherits from [emailThreatSubmission](../resources/security-emailthreatsubmissio None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Emailthreatsubmission | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-emailthreatsubmission.md | Inherits from [threatSubmission](../resources/security-threatsubmission.md). Bas None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Emailthreatsubmissionpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-emailthreatsubmissionpolicy.md | Inherits from [entity](../resources/entity.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Eventqueries | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-eventqueries.md | - Title: "eventQuery resource type" -description: "Represents the workload (SharePoint Online, OneDrive for Business, Exchange Online) and identification information associated with a retention event." --doc_type: resourcePageType ---# eventQuery resource type --Namespace: microsoft.graph.security ---Represents the workload (SharePoint Online, OneDrive for Business, Exchange Online) and identification information associated with a retention event. --## Properties -|Property|Type|Description| -|:|:|:| -|queryType|microsoft.graph.security.queryType|Represents the type of query associated with an event. 'files' for SPO and ODB and 'messages' for EXO.The possible values are: `files`, `messages`, `unknownFutureValue`.| -|query|String|Represents unique identification for the query. 'Asset ID' for SharePoint Online and OneDrive for Business, 'keywords' for Exchange Online.| --## Relationships -None. --## JSON representation -The following is a JSON representation of the resource. -<!-- { - "blockType": "resource", - "@odata.type": "microsoft.graph.security.eventQueries" -} >-``` json -{ - "@odata.type": "#microsoft.graph.security.eventQueries", - "queryType": "String", - "query": "String" -} -``` -- |
v1.0 | Security Eventquery | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-eventquery.md | + + Title: "eventQuery resource type" +description: "Represents the workload (SharePoint Online, OneDrive for Business, Exchange Online) and identification information associated with a retention event." ++ms.localizationpriority: medium +++# eventQuery resource type ++Namespace: microsoft.graph.security +++Represents the workload (SharePoint Online, OneDrive for Business, Exchange Online) and identification information associated with a retention event. ++## Properties +|Property|Type|Description| +|:|:|:| +|queryType|microsoft.graph.security.queryType|Represents the type of query associated with an event. 'files' for SPO and ODB and 'messages' for EXO.The possible values are: `files`, `messages`, `unknownFutureValue`.| +|query|String|Represents unique identification for the query. 'Asset ID' for SharePoint Online and OneDrive for Business, 'keywords' for Exchange Online.| ++## Relationships +None. ++## JSON representation +Here's a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.security.eventQuery" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.eventQuery", + "queryType": "String", + "query": "String" +} +``` ++ |
v1.0 | Security Filehash | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-filehash.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.security.fileHash" |
v1.0 | Security Fileplanappliedcategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-fileplanappliedcategory.md | + + Title: "filePlanAppliedCategory resource type" +description: "Represents the file plan descriptor of type category applied to a particular retention label." ++ms.localizationpriority: medium ++++# filePlanAppliedCategory resource type ++Namespace: microsoft.graph.security +++Represents a file plan descriptor that specifies a group of similar types of content in a department. Used to supplement a [retention label](security-retentionlabel.md) for [record management purposes](security-recordsmanagement-overview.md). ++To create, get, or delete an **filePlanAppliedCategory** descriptor, use the [categoryTemplate](security-categorytemplate.md) resource. ++This resource is one of a set of file plan descriptors that an administrator can choose to supplement a retention label. To find out more about these optional descriptors, and how to get the descriptors that have been chosen for a retention label, see [file plan descriptor](security-fileplandescriptor.md). ++Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|displayName|String|Unique string that defines a file plan category name applied to the label. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| +|subcategory|[microsoft.graph.security.filePlanSubcategory](../resources/security-fileplansubcategory.md)|Represents the file plan descriptor for a subcategory under a specific category, which has been assigned to a particular retention label.| ++## Relationships +None. ++## JSON representation +The following is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.security.filePlanAppliedCategory" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.filePlanAppliedCategory", + "displayName": "String", + "subCategory": { + "@odata.type": "microsoft.graph.security.filePlanSubcategory" + } +} +``` + |
v1.0 | Security Fileplanauthority | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-fileplanauthority.md | + + Title: "filePlanAuthority resource type" +description: "Represents the file plan descriptor of type authority applied to a particular retention label." ++ms.localizationpriority: medium ++++# filePlanAuthority resource type ++Namespace: microsoft.graph.security +++Represents a file plan descriptor that specifies the type of the underlying authority which determines the content to be retained and its retention schedule. Used to supplement a [retention label](security-retentionlabel.md) for [record management purposes](security-recordsmanagement-overview.md). ++To create, get, or delete a **filePlanAuthority** descriptor, use the [authorityTemplate](security-authoritytemplate.md) resource. ++This resource is one of a set of file plan descriptors that an administrator can choose to supplement a retention label. To find out more about these optional descriptors, and how to get the descriptors that have been chosen for a retention label, see [file plan descriptor](security-fileplandescriptor.md). ++Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|displayName|String|Unique string that defines a **filePlanAuthority** name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.security.filePlanAuthority" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.filePlanAuthority", + "displayName": "String" +} +``` + |
v1.0 | Security Fileplancitation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-fileplancitation.md | + + Title: "filePlanCitation resource type" +description: "Represents the file plan descriptor of type citation applied to a particular retention label." ++ms.localizationpriority: medium ++++# filePlanCitation resource type ++Namespace: microsoft.graph.security +++Represents a file plan descriptor that specifies a rule or regulation created by a jurisdiction to determine whether certain content should be retained or deleted. Used to supplement a [retention label](security-retentionlabel.md) for [record management purposes](security-recordsmanagement-overview.md). ++To create, get, or delete a **filePlanCitation** descriptor, use the [citationTemplate](security-citationtemplate.md) resource. ++This resource is one of a set of file plan descriptors that an administrator can choose to supplement a retention label. To find out more about these optional descriptors, and how to get the descriptors that have been chosen for a retention label, see [file plan descriptor](security-fileplandescriptor.md). ++Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|citationJurisdiction|String|Represents the jurisdiction or agency that published the filePlanCitation.| +|citationUrl|String|Represents the URL to the published filePlanCitation.| +|displayName|String|Unique string that defines a filePlanCitation name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| ++## Relationships +None. ++## JSON representation +The following is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.security.filePlanCitation" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.filePlanCitation", + "displayName": "String", + "citationUrl": "String", + "citationJurisdiction": "String" +} +``` + |
v1.0 | Security Fileplandepartment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-fileplandepartment.md | + + Title: "filePlanDepartment resource type" +description: "Represents the file plan descriptor of type department applied to a particular retention label." ++ms.localizationpriority: medium ++++# filePlanDepartment resource type ++Namespace: microsoft.graph.security +++Represents a file plan descriptor that specifies the department or business unit of an organization to which a [retention label](security-retentionlabel.md) applies. Used to supplement a retention label for [record management purposes](security-recordsmanagement-overview.md). ++To create, get, or delete a **filePlanDepartment** descriptor, use the [departmentTemplate](security-departmenttemplate.md) resource. ++This resource is one of a set of file plan descriptors that an administrator can choose to supplement a retention label. To find out more about these optional descriptors, and how to get the descriptors that have been chosen for a retention label, see [file plan descriptor](security-fileplandescriptor.md). ++Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|displayName|String|Unique string that defines a filePlanDepartment name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| ++## Relationships +None. ++## JSON representation +The following is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.security.filePlanDepartment" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.filePlanDepartment", + "displayName": "String" +} +``` + |
v1.0 | Security Fileplandescriptor | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-fileplandescriptor.md | Title: "filePlanDescriptor resource type" -description: "Represents a group of columns associated with a particular retention label, to improve the manageability and organization of the content you need to label." +description: "Represents a set of optional descriptors to supplement a retention label and improve the manageability and organization of content in Microsoft 365 for an organization." ms.localizationpriority: medium Namespace: microsoft.graph.security [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents a group of columns to improve the manageability and organization of the content you need to label. +Represents a _set_ of optional file plan descriptors to supplement a [retention label](security-retentionlabel.md) and improve the manageability and organization of Microsoft 365 content. +You can add a descriptor by using the POST operation of the corresponding file plan descriptor _template_, and specifying data for the descriptor. For example, to include a [filePlanCitation](security-fileplancitation.md) descriptor, use the [create citationTemplate](../api/security-labelsroot-post-citations.md) operation. Similarly, you can use the GET or DELETE operations on the template resource for the descriptor. ++To list the descriptors that supplement a retention label, use the [GET](../api/security-retentionlabel-get.md) operation on that [retentionLabel](security-retentionlabel.md) resource and apply `$expand` on the **descriptors** relationship. ++For information on how retention labels and file plan descriptors work in the [Microsoft Purview compliance portal](https://compliance.microsoft.com/), see [Use file plan to create and manage retention labels](/purview/file-plan-manager). Inherits from [microsoft.graph.entity](../resources/entity.md). None. ## Properties |Property|Type|Description| |:|:|:|-|authority|[microsoft.graph.security.authority](../resources/security-authority.md)|Represents the file plan descriptor of type authority applied to a particular retention label.| -|appliedcategory|[microsoft.graph.security.appliedCategory](../resources/security-appliedcategory.md)|Represents the file plan descriptor of type category applied to a particular retention label.| -|citation|[microsoft.graph.security.citation](../resources/security-citation.md)|Represents the file plan descriptor of type citation applied to a particular retention label.| -|department|[microsoft.graph.security.department](../resources/security-department.md)|Represents the file plan descriptor of type department applied to a particular retention label.| +|authority|[microsoft.graph.security.filePlanAuthority](../resources/security-fileplanauthority.md)|Represents the file plan descriptor of type authority applied to a particular retention label.| +|appliedCategory|[microsoft.graph.security.filePlanAppliedCategory](../resources/security-fileplanappliedcategory.md)|Represents the file plan descriptor of type category applied to a particular retention label.| +|citation|[microsoft.graph.security.filePlanCitation](../resources/security-fileplancitation.md)|Represents the file plan descriptor of type citation applied to a particular retention label.| +|department|[microsoft.graph.security.filePlanDepartment](../resources/security-fileplandepartment.md)|Represents the file plan descriptor of type department applied to a particular retention label.| |filePlanReference|[microsoft.graph.security.filePlanReference](../resources/security-fileplanreference.md)|Represents the file plan descriptor of type filePlanReference applied to a particular retention label. ΓÇ»| None. |filePlanReferenceTemplate|[microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md)|Specifies a unique alpha-numeric identifier for an organizationΓÇÖs retention schedule.| ## JSON representation-The following is a JSON representation of the resource. +Here's a JSON representation of the resource. <!-- { "blockType": "resource", "keyProperty": "id", The following is a JSON representation of the resource. "@odata.type": "#microsoft.graph.security.filePlanDescriptor", "id": "String (identifier)", "authority": {- "@odata.type": "microsoft.graph.security.authority" + "@odata.type": "microsoft.graph.security.filePlanAuthority" }, "category": {- "@odata.type": "microsoft.graph.security.appliedCategory" + "@odata.type": "microsoft.graph.security.filePlanAppliedCategory" }, "citation": {- "@odata.type": "microsoft.graph.security.citation" + "@odata.type": "microsoft.graph.security.filePlanCitation" }, "department": {- "@odata.type": "microsoft.graph.security.department" + "@odata.type": "microsoft.graph.security.filePlanDepartment" }, "filePlanReference": { "@odata.type": "microsoft.graph.security.filePlanReference" |
v1.0 | Security Fileplandescriptorbase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-fileplandescriptorbase.md | Title: "filePlanDescriptorBase resource type" -description: "Represents the name for each file plan descriptor column associated with a particular label." +description: "Specifies properties common to file plan descriptor resources." ms.localizationpriority: medium Namespace: microsoft.graph.security [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents the name for each [file plan descriptor](../resources/security-fileplandescriptor.md) column associated with a particular label. +Specifies properties common to file plan descriptor resources. Base type for each of the descriptors: [filePlanAppliedCategory](security-fileplanappliedcategory.md), [filePlanAuthority](security-fileplanauthority.md), [filePlanCitation](security-fileplancitation.md), [filePlanDepartment](security-fileplandepartment.md), [filePlanReference](security-fileplanreference.md), and [filePlanSubcategory](security-fileplansubcategory.md). ## Properties |Property|Type|Description| |:|:|:|-|displayName|String|Unique string that defines the name for each [file plan descriptor](../resources/security-fileplandescriptor.md) associated with a particular retention label.| +|displayName|String|Unique string that defines the name for the file plan descriptor associated with a particular retention label.| ## Relationships None. |
v1.0 | Security Fileplandescriptortemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-fileplandescriptortemplate.md | Title: "filePlanDescriptorTemplate resource type" -description: "Represents a group of columns to improve the manageability and organization of the content you need to label." +description: "Specifies the properties common to the template resources for file plan descriptors." ms.localizationpriority: medium Namespace: microsoft.graph.security [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents a group of columns to improve the manageability and organization of the content you need to label. +Specifies the properties common to the template resources for file plan descriptors. Base type for each of the template resources: [authorityTemplate](security-authoritytemplate.md), [categoryTemplate](security-categorytemplate.md), [citationTemplate](security-citationtemplate.md), [departmentTemplate](security-departmenttemplate.md), [filePlanReferenceTemplate](security-fileplanreferencetemplate.md), and [subcategoryTemplate](security-subcategorytemplate.md). Inherits from [microsoft.graph.entity](../resources/entity.md). ## Methods-|Method|Return type|Description| -|:|:|:| -|[List authorities](../api/security-labelsroot-list-authorities.md)|[microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) collection|Get the authorityTemplate resources from the authorityTemplate navigation property.| -|[Add authorities](../api/security-labelsroot-post-authorities.md)|[microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md)|Add authorityTemplate by posting to the authorityTemplate collection.| -|[Remove authorities](../api/security-labelsroot-delete-authorities.md)|None|Remove a [microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) object.| -|[List categories](../api/security-labelsroot-list-categories.md)|[microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) collection|Get the categoryTemplate resources from the categoryTemplate navigation property.| -|[Add categories](../api/security-labelsroot-post-categories.md)|[microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md)|Add categoryTemplate by posting to the categoryTemplate collection.| -|[Remove categories](../api/security-labelsroot-delete-categories.md)|None|Remove a [microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) object.| -|[List citations](../api/security-labelsroot-list-citations.md)|[microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) collection|Get the citationTemplate resources from the citationTemplate navigation property.| -|[Add citations](../api/security-labelsroot-post-citations.md)|[microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md)|Add citationTemplate by posting to the citationTemplate collection.| -|[Remove citations](../api/security-labelsroot-delete-citations.md)|None|Remove a [microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) object.| -|[List departments](../api/security-labelsroot-list-departments.md)|[microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) collection|Get the departmentTemplate resources from the departmentTemplate navigation property.| -|[Add departments](../api/security-labelsroot-post-departments.md)|[microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md)|Add departmentTemplate by posting to the departmentTemplate collection.| -|[Remove departments](../api/security-labelsroot-delete-departments.md)|None|Remove a [microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) object.| -|[List filePlanReferences](../api/security-labelsroot-list-fileplanreferences.md)|[microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) collection|Get the filePlanReferenceTemplate resources from the filePlanReferenceTemplate navigation property.| -|[Add filePlanReferences](../api/security-labelsroot-post-fileplanreferences.md)|[microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md)|Add filePlanReferenceTemplate by posting to the filePlanReferenceTemplate collection.| -|[Remove filePlanReferences](../api/security-labelsroot-delete-fileplanreferences.md)|None|Remove a [microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) object.| +None. ## Properties |Property|Type|Description| |:|:|:|-|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the filePlanDescriptorTemplate column.| -|createdDateTime|DateTimeOffset|Represents the date and time in which the filePlanDescriptorTemplate is created.| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the filePlanDescriptorTemplate column. Read-only.| +|createdDateTime|DateTimeOffset|Represents the date and time in which the filePlanDescriptorTemplate is created. Read-only.| |displayName|String|Unique string that defines a filePlanDescriptorTemplate name.|-|id|String|Unique ID of the filePlanDecriptorTemplate column. Inherited from [microsoft.graph.entity](../resources/entity.md).| +|id|String|Unique ID of the filePlanDecriptorTemplate column. Read-only.| ## Relationships None. |
v1.0 | Security Fileplanreference | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-fileplanreference.md | Title: "filePlanReference resource type" -description: "Represents the file plan descriptor of type filePlanReference applied to a particular retention label." +description: "Represents the file plan descriptor of a reference ID, supplementing a specified retention label." ms.localizationpriority: medium Namespace: microsoft.graph.security [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents the file plan descriptor of type filePlanReference applied to a particular retention label. +Represents a file plan descriptor that specifies a unique alpha-numeric identifier for an organizationΓÇÖs retention schedule. Used to supplement a [retention label](security-retentionlabel.md) for [record management purposes](security-recordsmanagement-overview.md). +To create, get, or delete a **filePlanReference** descriptor, use the [filePlanReferenceTemplate](security-fileplanreferencetemplate.md) resource. ++This resource is one of a set of file plan descriptors that an administrator can choose to supplement a retention label. To find out more about these optional descriptors, and how to get the descriptors that have been chosen for a retention label, see [file plan descriptor](security-fileplandescriptor.md). Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). ## Properties |Property|Type|Description| |:|:|:|-|displayName|String|Unique string that defines a filePlanReference name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| +|displayName|String|Unique string that defines a reference ID. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| ## Relationships None. |
v1.0 | Security Fileplanreferencetemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-fileplanreferencetemplate.md | Namespace: microsoft.graph.security [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Specifies a unique alpha-numeric identifier for an organizationΓÇÖs retention schedule. -+Supports CRUD operations to apply and manage the [filePlanReference](security-fileplanreference.md) descriptor for a [retentionLabel](security-retentionlabel.md). The **filePlanReference** descriptor supplements a retention label to improve the manageability and organization of Microsoft 365 content. Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources ## Properties |Property|Type|Description| |:|:|:|-|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the file plan reference. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| -|createdDateTime|DateTimeOffset|Represents the date and time in which the filePlanReference is created. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| -|displayName|String|Unique string that defines a filePlanReference name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the file plan reference descriptor. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md).| +|createdDateTime|DateTimeOffset|Represents the date and time in which the filePlanReference descriptor is created. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md).| +|displayName|String|Unique string that defines a filePlanReference name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md).| |id|String|Unique ID of the filePlanReference. Inherited from [microsoft.graph.entity](../resources/entity.md).| ## Relationships |
v1.0 | Security Fileplansubcategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-fileplansubcategory.md | + + Title: "filePlanSubcategory resource type" +description: "Represents a unique filePlanSubcategory applied to a retention label." ++ms.localizationpriority: medium ++++# filePlanSubcategory resource type ++Namespace: microsoft.graph.security +++Represents a unique filePlanSubcategory applied to a [retention label](security-retentionlabel.md). Used to supplement a retention label for [record management purposes](security-recordsmanagement-overview.md). ++To create, get, or delete a **filePlanSubcategory** descriptor, use the [subcategoryTemplate](security-subcategorytemplate.md) resource. ++This resource is one of a set of file plan descriptors that an administrator can choose to supplement a retention label. To find out more about these optional descriptors, and how to get the descriptors that have been chosen for a retention label, see [file plan descriptor](security-fileplandescriptor.md). ++Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|displayName|String|Unique string that defines a filePlanSubcategory name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.security.filePlanSubcategory" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.filePlanSubcategory", + "displayName": "String" +} +``` + |
v1.0 | Security Filethreatsubmission | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-filethreatsubmission.md | This is an abstract type. Inherits from [threatSubmission](../resources/security None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Fileurlthreatsubmission | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-fileurlthreatsubmission.md | Inherits from [fileThreatSubmission](../resources/security-filethreatsubmission. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Healthissue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-healthissue.md | + + Title: "healthIssue resource type" +description: "Represents potential issues within a customer's Microsoft Defender for Identity configuration that Microsoft Defender for Identity identified." ++ms.localizationpriority: medium Last updated : 03/20/2024+++# healthIssue resource type ++Namespace: microsoft.graph.security +++Represents potential issues within a customer's Microsoft Defender for Identity configuration that Microsoft Defender for Identity identified. ++Inherits from [microsoft.graph.entity](../resources/entity.md). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List](../api/security-identityContainer-list-healthissues.md)|[microsoft.graph.security.healthIssue](../resources/security-healthissue.md) collection|Get a list of [healthIssue](../resources/security-healthissue.md) objects and their properties.| +|[Get](../api/security-healthissue-get.md)|[microsoft.graph.security.healthIssue](../resources/security-healthissue.md)|Read the properties and relationships of a [healthIssue](../resources/security-healthissue.md) object.| +|[Update](../api/security-healthissue-update.md)|[microsoft.graph.security.healthIssue](../resources/security-healthissue.md)|Update the properties of a [healthIssue](../resources/security-healthissue.md) object.| ++## Properties +|Property|Type|Description| +|:|:|:| +|additionalInformation|String collection|Contains additional information about the issue, such as a list of items to fix.| +|createdDateTime|DateTimeOffset|The date and time of when the health issue was generated.| +|description|String|Contains more detailed information about the health issue.| +|displayName|String|The display name of the health issue.| +|domainNames|String collection|A list of the fully qualified domain names of the domains or the sensors the health issue is related to.| +|healthIssueType|[microsoft.graph.security.healthIssueType](#healthissuetype-values)|The type of the health issue. The possible values are: `sensor`, `global`, `unknownFutureValue`. For a list of all health issues and their identifiers, see [Microsoft Defender for Identity health issues](/defender-for-identity/health-alerts). | +|ID|String|A unique identifier that represents the health issue.| +|issueTypeId|String|The type identifier of the health issue. For a list of all health issues and their identifiers, see [Microsoft Defender for Identity health issues](/defender-for-identity/health-alerts).| +|lastModifiedDateTime|DateTimeOffset|The date and time of when the health issue was last updated.| +|recommendations|String collection|This field contains a list of recommended actions that can be taken to resolve the issue effectively and efficiently. These actions might include how to investigate the issue further. Not limited to prewritten responses.| +|recommendedActionCommands|String collection|Contains a list of commands from the product's PowerShell module that can be used to resolve the issue, if available. If there aren't any commands that can be used to solve the issue, this field is empty. The commands, if present, provide a quick and efficient way to address the issue. The commands run in order for the single recommended fix.| +|sensorDNSNames|String collection|A list of the dns names of the sensors the health issue is related to.| +|severity|[microsoft.graph.security.healthIssueSeverity](#healthissueseverity-values)|The severity of the health issue. The possible values are: `low`, `medium`, `high`, `unknownFutureValue`.| +|status|[microsoft.graph.security.healthIssueStatus](#healthissuestatus-values)|The status of the health issue. The possible values are: `open`, `closed`, `suppressed`, `unknownFutureValue`.| ++#### healthIssueSeverity values ++| Member | Description | +| :--| : | +| low | Low severity health issues usually indicate minor issues that don't have a significant impact on your environment. These issues require further investigation, but they usually don't require immediate action. | +| medium | Medium severity health issues indicate more significant issues that could potentially impact your environment. These issues may require further investigation and action to prevent any potential problems. | +| high | High severity health issues indicate critical issues that could have a severe impact on your environment. These issues require immediate attention and action. | +| unknownFutureValue | Evolvable enumeration sentinel value. Don't use.| ++#### healthIssueStatus values ++| Member | Description | +| :--| : | +| open | The issue is open and should be addressed. | +| closed | The issue was addressed. Either someone manually closed the issue or took an action on the affected item, or it was closed automatically by the system. | +| suppressed | The operator suppressed the issue manually. | +| unknownFutureValue | Evolvable enumeration sentinel value. Don't use.| ++#### healthIssueType values ++| Member | Description | +| :--| : | +| Sensor | The issue is on specific sensor. | +| Global | The issue is in the Defender for identity system configuration. | +| unknownFutureValue | Evolvable enumeration sentinel value. Don't use.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "ID", + "@odata.type": "microsoft.graph.security.healthIssue", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.healthIssue", + "ID": "String (identifier)", + "displayName": "String", + "healthIssueType": "String", + "issueTypeId": "String", + "severity": "String", + "status": "String", + "createdDateTime": "String (timestamp)", + "lastModifiedDateTime": "String (timestamp)", + "domainNames": [ + "String" + ], + "sensorDNSNames": [ + "String" + ], + "description": "String", + "recommendations": [ + "String" + ], + "recommendedActionCommands": [ + "String" + ], + "additionalInformation": [ + "String" + ] +} +``` + |
v1.0 | Security Hostcomponent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-hostcomponent.md | Inherits from [artifact](../resources/security-artifact.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Identitycontainer | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-identitycontainer.md | + + Title: "identityContainer resource type" +description: "A container for security identities APIs." ++ms.localizationpriority: medium Last updated : 03/27/2024+++# identityContainer resource type ++Namespace: microsoft.graph.security +++A container for security identities APIs. Currently exposes the [healthIssues](security-healthissue.md) relationship. ++## Methods ++None. ++## Properties ++None. ++## Relationships ++|Relationship|Type|Description| +|:|:|:| +|healthIssues|[microsoft.graph.security.healthIssue](security-healthissue.md) collection| Represents potential issues within a customer's Microsoft Defender for Identity configuration that Microsoft Defender for Identity identified.| ++## JSON representation ++The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.security.identityContainer", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.identityContainer" +} +``` |
v1.0 | Security Incident | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-incident.md | Because piecing the individual alerts together to gain insight into an attack ca |description|String|A rich text string describing the incident| |recommendedActions|String|A rich text string that represents the actions that are reccomnded to take in order to resolve the incident | |recommendedHuntingQueries|Collection(microsoft.graph.security.recommendedHuntingQuery)|List of hunting Kusto Query Language (KQL) queries related to the incident|+|resolvingComment|String|User input that explains the resolution of the incident and the classification choice. This property contains free editable text.| ### incidentStatus values |
v1.0 | Security Indicator | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-indicator.md | This resource isn't directly addressable. You can interact with this resource th ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Security Informationprotectionpolicysetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-informationprotectionpolicysetting.md | Represents the settings for a Microsoft Purview Information Protection label pol | defaultLabel | [microsoft.graph.security.sensitivityLabel](../resources/security-sensitivitylabel.md) | Represents the default label for an organization. If no label is selected, the default label is applied. | ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Ipevidence | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-ipevidence.md | Inherits from [alertEvidence](../resources/security-alertevidence.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.security.ipEvidence" |
v1.0 | Security Labelsroot | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-labelsroot.md | Title: "labelsRoot resource type" -description: "Represents the entry point for the retentionLabels resource type." +description: "A root resource for capabilities that support records management for Microsoft 365 data in an organization." ms.localizationpriority: medium Namespace: microsoft.graph.security [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents the entry point for the [retentionLabel](security-retentionlabel.md) resource type. +A root resource for capabilities that support records management for Microsoft 365 data in an organization. +Those capabilities include using a [retention label](security-retentionlabel.md) to configure retention and deletion settings for a type of content in the Microsoft 365 data, and using one or more [file plan descriptors](security-fileplandescriptor.md) to supplement the retention label and provide additional options to better manage and organize the content. Inherits from [microsoft.graph.entity](../resources/entity.md). |
v1.0 | Security Loggedonuser | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-loggedonuser.md | User that was logged in on the machine during the time of the alert. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.security.loggedOnUser" |
v1.0 | Security Protectdonotforwardaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-protectdonotforwardaction.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.security.protectDoNotForwardAction" |
v1.0 | Security Recordsmanagement Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-recordsmanagement-overview.md | doc_type: conceptualPageType [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -The Microsoft Purview records management APIs help organizations manage retention and deletion of data to meet their legal obligations and compliance regulations, and increases efficiency by enabling the regular disposition of items that no longer have to be retained. +The Microsoft Purview records management APIs help organizations manage retention and deletion of data to meet their legal obligations and compliance regulations. The records management APIs increase efficiency by enabling the regular disposition of items that no longer have to be retained. The records management solution is a part of the Microsoft Purview compliance center. ## Manage retention labels-Records management admins and developers need to maintain records management systems with labels that are created, updated, and deleted periodically. +Many organizations need to manage their data to comply with industry regulations and internal policies, reduce risks of litigation or security breach, and let their employees effectively share knowledge that is current and relevant to them. Managing data commonly involves retaining or deleting different types of content. -Developers and compliance admins can use the records management APIs to perform operations on records management labels in order to maintain their systems. +You can use [retention labels](security-retentionlabel.md) to configure retention and deletion settings for Microsoft 365 content. For example, you can set retention periods from when the content was labeled and you can set disposition review as the action at the end of the retention period. ++In addition, you can use [file plan descriptors](security-fileplandescriptor.md) to supplement a retention label and improve the manageability and organization of Microsoft 365 content. Examples of file plan descriptors include [authority](security-fileplanauthority.md), [citation](security-fileplancitation.md), and [department](security-fileplandepartment.md). ## Trigger events for an existing label-When an employee leaves a company, information is updated in the HR management system. From the leave date, confidential documents need to be retained for a period for 7 years. These documents have the label `Employee_departure` applied. +Some scenarios require starting a retention period for certain documents upon a specific event, such as an employee leaving an organization, a contract expiring, or the fiscal year ending. ++You can use the [retentionLabel](security-retentionlabel.md) resource to support event-based retention, by setting the **retentionTrigger** property as `dateOfEvent` and associating the label with a [retentionEventType](security-retentioneventtype.md) resource. A [retentionEvent](security-retentionevent.md) is associated with a **retentionEventType** as well. When a triggering event happens, only content with that retention label applied is retained for the specified retention period. -Developers and compliance administrators can use records management APIs to read the label `Employee_departure` and look up the associated event type `Event-employee_departure`. +For example, in an organization, when an employee leaves, employment records must be retained for 5 years. Use the **retentionLabel** and **retentionEvent** APIs to do the following for each employee record when the employee starts: +1. Apply a **retentionLabel** configured as follows: + - A display name of "Personnel information" + - A **retentionDuration** of 1827 days (5 years) + - Listening to the **retentionEventType** named "Employee departure" +2. Define a **retentionEvent** with the same **retentionEventType** named "Employee departure", and as part of its [eventQuery](security-eventquery.md) collection, an `Asset ID` with an employee ID value as the ID information associated with the event. -Compliance admins can use records management APIs to create an event for the associated event type. The retention period for the confidential documents starts after the creation of this event. +When an employee with an ID of 1234 leaves Contoso, the information is updated in the HR management system. The employee departure can trigger a new instance of **retentionEvent** with the "Employee departure" event type, and as part of its **eventQueries** property, an [eventQuery](security-eventquery.md) with a query string of 'AssetID:1234'. This way, employee record items using the "Personnel information" retention label and associated with the employee ID of 1234 get their 5 year retention period started from the date of the employee departure event. ## Entities The records management API includes the following key entities. The records management API includes the following key entities. | Name | Type | Use case | |:-|:-|:-| | Label | [microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md) | Contains retention settings and actions that can be applied to an item at the end of a period. |+| File plan descriptors |[microsoft.graph.securty.fileplandescriptor](../resources/security-fileplandescriptor.md) | Represents a set of optional descriptors to supplement a retention label and improve their manageability for an organization. | | Retention event | [microsoft.graph.security.retentionEvent](../resources/security-retentionevent.md) | Represents a trigger for event-based retention, where a retention period starts after the event occurs. | | Retention event type | [microsoft.graph.security.retentionEventType](../resources/security-retentioneventtype.md) | Represents a single group for the same type of retention events. | |
v1.0 | Security Retentiondurationforever | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-retentiondurationforever.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.security.retentionDurationForever" |
v1.0 | Security Retentionevent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-retentionevent.md | To learn more about it, see [Start retention when an event occurs](/microsoft-36 |description|String|Optional information about the event.| |displayName|String|Name of the event.| |eventPropagationResult|[microsoft.graph.security.eventPropagationResult](../resources/security-eventpropagationresult.md)|Represents the success status of a created event and additional information.|-|eventQueries|[microsoft.graph.security.eventQueries](../resources/security-eventqueries.md) collection| Represents the workload (SharePoint Online, OneDrive for Business, Exchange Online) and identification information associated with a retention event.| +|eventQuery|[microsoft.graph.security.eventQuery](../resources/security-eventquery.md) collection| Represents the workload (SharePoint Online, OneDrive for Business, Exchange Online) and identification information associated with a retention event.| |retentionEventStatus|[microsoft.graph.security.retentionEventStatus](../resources/security-retentioneventstatus.md) collection|Status of event propogation to the scoped locations after the event has been created.| |eventTriggerDateTime|DateTimeOffset|Optional time when the event should be triggered.| |id|String|Represents the unique ID of the user who created the retentionEvent. [entity](/graph/api/resources/entity).| The following is a JSON representation of the resource. "description": "String", "eventQueries": [ {- "@odata.type": "microsoft.graph.security.eventQueries" + "@odata.type": "microsoft.graph.security.eventQuery" } ], "eventTriggerDateTime": "String (timestamp)", The following is a JSON representation of the resource. }, "lastStatusUpdateDateTime": "String (timestamp)" }-``` +``` |
v1.0 | Security Retentionlabel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-retentionlabel.md | Namespace: microsoft.graph.security [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents how customers can manage their data, including whether and for how long to retain or delete it. +Represents how organizations, for compliance and governance purposes, can manage their data at an item level (email or document), including whether and for how long to retain or delete the item. ++Organizations can use retention labels for different types of content that require different retention settings. For example, they can apply a retention label to tax forms and supporting documents to retain them for the period required by law. ++Organizations can configure retention labels with the retention periods and actions based on factors such as the date last modified or created. They can also start different retention periods by specifying an [event that can trigger retention](security-retentionevent.md) when the event occurs. ++For more information on how retention labels work, when to use them, and how Microsoft Purview supports retention labels to let you configure retention and deletion settings, see [Learn about retention policies and retention labels](/purview/retention). ## Methods |Method|Return type|Description| Represents how customers can manage their data, including whether and for how lo ## Properties |Property|Type|Description| |:|:|:|-|actionAfterRetentionPeriod|microsoft.graph.security.actionAfterRetentionPeriod| Specifies the action to take on a document with this label applied during the retention period. The possible values are: `none`, `delete`, `startDispositionReview`, `unknownFutureValue`.| +|actionAfterRetentionPeriod|microsoft.graph.security.actionAfterRetentionPeriod| Specifies the action to take on the labeled document after the period specified by the retentionDuration property expires. The possible values are: `none`, `delete`, `startDispositionReview`, `unknownFutureValue`.| |behaviorDuringRetentionPeriod|microsoft.graph.security.behaviorDuringRetentionPeriod|Specifies how the behavior of a document with this label should be during the retention period. The possible values are: `doNotRetain`, `retain`, `retainAsRecord`, `retainAsRegulatoryRecord`, `unknownFutureValue`.| |createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the retentionLabel.| |createdDateTime|DateTimeOffset|Represents the date and time in which the retentionLabel is created.| |descriptionForAdmins|String|Provides label information for the admin. Optional.| |descriptionForUsers|String|Provides the label information for the user. Optional.| |displayName|String|Unique string that defines a label name.|-|id|String|Unique ID of the retentionLabel. [entity](/graph/api/resources/entity).| +|id|String|Unique ID of the retentionLabel.| |isInUse|Boolean|Specifies whether the label is currently being used.| |lastModifiedBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|The user who last modified the retentionLabel.| |lastModifiedDateTime|DateTimeOffset|The latest date time when the retentionLabel was modified.| |
v1.0 | Security Sitesource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-sitesource.md | None. |site|[site](../resources/site.md)|The SharePoint site associated with the **siteSource**.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Subcategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-subcategory.md | - Title: "subCategory resource type" -description: "Represents a unique subcategory applied to a retention label." ---doc_type: resourcePageType ---# subCategory resource type --Namespace: microsoft.graph.security ---Represents a unique subcategory applied to a retention label. ---Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). --## Properties -|Property|Type|Description| -|:|:|:| -|displayName|String|Unique string that defines a subcategory name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| --## Relationships -None. --## JSON representation -Here's a JSON representation of the resource. -<!-- { - "blockType": "resource", - "@odata.type": "microsoft.graph.security.subCategory" -} >-``` json -{ - "@odata.type": "#microsoft.graph.security.subCategory", - "displayName": "String" -} -``` - |
v1.0 | Security Subcategorytemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-subcategorytemplate.md | Title: "subCategoryTemplate resource type" + Title: "subcategoryTemplate resource type" description: "Represents the file plan descriptor of type subcategory for retention labels." ms.localizationpriority: medium-# subCategoryTemplate resource type +# subcategoryTemplate resource type Namespace: microsoft.graph.security [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents the file plan descriptor of type subcategory for retention labels. -+Represents the file plan descriptor of type subcategory for retention labels. This resource supports CRUD operations to apply and manage the [filePlanSubcategory](security-fileplansubcategory.md) descriptor for a [retentionLabel](security-retentionlabel.md). The **subcategory** file plan descriptor supplements a retention label to improve the manageability and organization of Microsoft 365 content. Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). ## Methods |Method|Return type|Description| |:|:|:|-|[List subCategories](../api/security-categorytemplate-list-subcategories.md)|[microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) collection|Get a list of the [microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) objects and their properties.| -|[Create subCategories](../api/security-categorytemplate-post-subcategories.md)|[microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md)|Create a new [microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) object.| -|[Get subCategories](../api/security-subcategorytemplate-get.md)|[microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md)|Read the properties and relationships of a [microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) object.| -|[Delete subCategories](../api/security-categorytemplate-delete-subcategories.md)|None|Delete a [microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) object.| +|[List subcategories](../api/security-categorytemplate-list-subcategories.md)|[microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md) collection|Get a list of the [microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md) objects and their properties.| +|[Create subcategories](../api/security-categorytemplate-post-subcategories.md)|[microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md)|Create a new [microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md) object.| +|[Get subcategories](../api/security-subcategorytemplate-get.md)|[microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md)|Read the properties and relationships of a [microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md) object.| +|[Delete subcategories](../api/security-categorytemplate-delete-subcategories.md)|None|Delete a [microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md) object.| ## Properties |Property|Type|Description| |:|:|:|-|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the subcategory. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| -|createdDateTime|DateTimeOffset|Represents the date and time in which the subcategory is created. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| -|displayName|String|Unique string that defines a subcategory name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| -|ID|String|Unique ID of the subcategory. Inherited from [microsoft.graph.entity](../resources/entity.md).| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the subcategory descriptor. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|createdDateTime|DateTimeOffset|Represents the date and time in which the subcategory descriptor is created. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|displayName|String|Unique string that defines a subcategory name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md).| +|id|String|Unique ID of the subcategory. Inherited from [microsoft.graph.entity](../resources/entity.md). Read-only.| ## Relationships None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id",- "@odata.type": "microsoft.graph.security.subCategoryTemplate", + "@odata.type": "microsoft.graph.security.subcategoryTemplate", "baseType": "microsoft.graph.security.filePlanDescriptor", "openType": false } --> ``` json {- "@odata.type": "#microsoft.graph.security.subCategoryTemplate", + "@odata.type": "#microsoft.graph.security.subcategoryTemplate", "id": "String (identifier)", "displayName": "String", "createdBy": { |
v1.0 | Security Submissionresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-submissionresult.md | Represents the result of a review after the threat submission is processed by Mi None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.security.submissionResult" |
v1.0 | Security Tenantallowblocklistentryresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-tenantallowblocklistentryresult.md | Represents the result of a tenant allow block list entry. An entry for a tenant None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.security.tenantAllowBlockListEntryResult" |
v1.0 | Security Tenantalloworblocklistaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-tenantalloworblocklistaction.md | Represents the tenant allow-or-block list action. When an admin creates an email None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.security.tenantAllowOrBlockListAction" |
v1.0 | Security Threatsubmission | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-threatsubmission.md | This resource is an abstract type. It's the base type for [emailThreatSubmission None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Unclassifiedartifact | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-unclassifiedartifact.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Unifiedgroupsource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-unifiedgroupsource.md | None. |group|[group](../resources/group.md)|Represents a group.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Usersource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-usersource.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Vmmetadata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-vmmetadata.md | Metadata of the virtual machine (VM) Microsoft Defender for Endpoint is running None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.security.vmMetadata" |
v1.0 | Security | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security.md | None. |alerts_v2 | [microsoft.graph.security.alert](security-alert.md) collection | A collection of alerts in Microsoft 365 Defender.| |attackSimulation|[attackSimulationRoot](../resources/attacksimulationroot.md)|Provides tenants capability to launch a simulated and realistic phishing attack and learn from it.| |collaboration|[microsoft.graph.security.collaborationRoot](../resources/security-collaborationroot.md)|Enables read and other actions on collaborative entities in Microsoft Defender.|+|identities|[microsoft.graph.security.identityContainer](../resources/security-identityContainer.md)|A container for security identities APIs.| |incidents | [microsoft.graph.security.incident](security-incident.md) collection | A collection of incidents in Microsoft 365 Defender, each of which is a set of correlated alerts and associated metadata that reflects the story of an attack.|+|partner| [microsoft.graph.partner.security.partnerSecurity](../resources/partner-security-partnersecurity.md) | A container that safeguards the Microsoft Azure resources of Microsoft Cloud Solution Provider (CSP) partnersΓÇÖ customers, including alerts, scores, and all aspects of security. | |secureScores | [secureScore](securescores.md) collection | Measurements of tenantsΓÇÖ security posture to help protect them from threats. | |securityactions|[securityAction](../resources/securityaction.md) collection|Actions that respond to alerts to block malicious activities.| |tiindicators|[tiIndicator](../resources/tiindicator.md) collection|Threat indicators sent to Microsoft that identify malicious activities.| |
v1.0 | Securitytoolawsresourceadministratorfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/securitytoolawsresourceadministratorfinding.md | description: "View AWS resources that can administer security tools." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Securitytoolawsroleadministratorfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/securitytoolawsroleadministratorfinding.md | description: "View AWS roles that can administer security tools." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Securitytoolawsserverlessfunctionadministratorfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/securitytoolawsserverlessfunctionadministratorfinding.md | description: "View AWS Serverless functions that can administer security tools." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Securitytoolawsuseradministratorfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/securitytoolawsuseradministratorfinding.md | description: "View AWS Users that can administer security tools." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Securityvendorinformation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/securityvendorinformation.md | Contains details about the security product/service vendor, provider, and subpro ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "optionalProperties": [ |
v1.0 | Selfservicesignupauthenticationflowconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/selfservicesignupauthenticationflowconfiguration.md | Represents the configurations related to self-service sign-up. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.selfServiceSignUpAuthenticationFlowConfiguration" |
v1.0 | Selfsignedcertificate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/selfsignedcertificate.md | Contains the public part of a signing certificate. It's the return type of the a ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Sensitivitylabelassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/sensitivitylabelassignment.md | Provides details about a sensitivity label assigned to a [file](./driveitem.md) |labels|[extractSensitivityLabelsResult](./extractsensitivitylabelsresult.md)|List of sensitivity labels assigned to a file.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.sensitivityLabelAssignment" |
v1.0 | Serviceannouncementbase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/serviceannouncementbase.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Servicehealth | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/servicehealth.md | Represents the health information of a service subscribed by a tenant. |issues|Collection([serviceHealthIssue](../resources/servicehealthissue.md))|A collection of issues that happened on the service, with detailed information for each issue.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Servicehostedmediaconfig | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/servicehostedmediaconfig.md | The media that's hosted remotely. This is inherited from [mediaConfig](mediaconf ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Serviceprincipalidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/serviceprincipalidentity.md | Inherits from [identity](../resources/identity.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.servicePrincipalIdentity" |
v1.0 | Serviceprincipallockconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/serviceprincipallockconfiguration.md | For more information about managing this object, see [Lock sensitive properties | tokenEncryptionKeyId | Boolean | Locks the tokenEncryptionKeyId property for modification on the service principal. | ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Serviceprovisioningerror | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/serviceprovisioningerror.md | Base type of [serviceProvisioningXmlError](../resources/serviceprovisioningxmler ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Serviceprovisioningxmlerror | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/serviceprovisioningxmlerror.md | Inherits from [serviceProvisioningError](../resources/serviceprovisioningerror.m ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Settingtemplatevalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/settingtemplatevalue.md | Represents an individual template setting definition, including the default valu ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Settingvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/settingvalue.md | A setting represented by a name/value pair. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Sharepointids | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/sharepointids.md | The **SharePointIds** resource groups the various identifiers for an item stored ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Sharepointonedriveoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/sharepointonedriveoptions.md | Provides the search content options when a search is performed using application | Property | Type | Description | |:-|:|:| |includeContent|searchContent| The type of search content. The possible values are: `privateContent`, `sharedContent`. Read-only. |+|includeHiddenContent|Boolean| Indicates whether the search results include content that is normally hidden, such as archived content and SharePoint Embedded (RaaS). The default value is `false`, which prevents hidden content from being returned. You can also optionally include KQL to scope your query for hidden content to specific content types. For more information, see [Search hidden content](/graph/search-concept-files#example-7-search-hidden-content). | ## JSON representation -The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", The following is a JSON representation of the resource. ```json {- "includeContent": "string" + "includeContent": "String", + "includeHiddenContent": "Boolean" } ``` |
v1.0 | Sharepointsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/sharepointsettings.md | Inherits from [entity](../resources/entity.md). | unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.sharepointSettings", |
v1.0 | Sharepointsharingabilities | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/sharepointsharingabilities.md | + + Title: "sharePointSharingAbilities resource type" +description: "Provides information about which sharing links are available to the user." ++ms.localizationpriority: medium ++++# sharePointSharingAbilities resource type ++Namespace: microsoft.graph +++Provides information about which sharing links are available to the user. ++## Properties ++|Property|Type|Description| +|:|:|:| +|anyoneLinkAbilities|[linkScopeAbilities](../resources/linkscopeabilities.md)|The anyone link abilities.| +|directSharingAbilities|[directSharingAbilities](../resources/directsharingabilities.md)|The direct sharing abilities.| +|organizationLinkAbilities|[linkScopeAbilities](../resources/linkscopeabilities.md)|The organization link abilities.| +|specificPeopleLinkAbilities|[linkScopeAbilities](../resources/linkscopeabilities.md)|The specificPeople link abilities.| ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.sharePointSharingAbilities" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.sharePointSharingAbilities", + "anyoneLinkAbilities": { + "@odata.type": "microsoft.graph.linkScopeAbilities" + }, + "organizationLinkAbilities": { + "@odata.type": "microsoft.graph.linkScopeAbilities" + }, + "specificPeopleLinkAbilities": { + "@odata.type": "microsoft.graph.linkScopeAbilities" + }, + "directSharingAbilities": { + "@odata.type": "microsoft.graph.directSharingAbilities" + } +} +``` |
v1.0 | Sharinginvitation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/sharinginvitation.md | The **SharingInvitation** resource groups invitation-related data items into a s ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Sharinglink | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/sharinglink.md | If a [**permission**](permission.md) resource has a non-null **sharingLink** fac ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Sharinglinkexpirationstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/sharinglinkexpirationstatus.md | + + Title: "sharingLinkExpirationStatus resource type" +description: "Indicates whether links must expire, and if link expiration is enabled, provides a default link expiration time." ++ms.localizationpriority: medium ++++# sharingLinkExpirationStatus resource type ++Namespace: microsoft.graph +++Indicates whether links must expire, and if link expiration is enabled, provides a default link expiration time. ++## Properties ++|Property|Type|Description| +|:|:|:| +|defaultExpirationInDays|Int32|Default link expiration in days. Returns -1 if there is no required expiration time.| +|disabledReason|String|Provides a description of why this operation is not enabled. Only returned if this operation is not enabled.| +|enabled|Boolean|Indicates whether this operation is enabled.| ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.sharingLinkExpirationStatus" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.sharingLinkExpirationStatus", + "enabled": "Boolean", + "disabledReason": "String", + "defaultExpirationInDays": "Integer" +} +``` |
v1.0 | Sharinglinkvariants | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/sharinglinkvariants.md | + + Title: "sharingLinkVariants resource type" +description: "Represents the status of potential sharing link variants. The variants generate a separate sharing link from the link that would otherwise be generated, but with identical role and scope.." ++ms.localizationpriority: medium ++++# sharingLinkVariants resource type ++Namespace: microsoft.graph +++Represents the status of potential sharing link variants. The variants generate a separate sharing link from the link that would otherwise be generated, but with identical role and scope. ++## Properties ++|Property|Type|Description| +|:|:|:| +|addressBarLinkPermission|sharingRole|Indicates the most permissive role with which an address bar link can be created. The possible values are: `none`, `view`, `edit`, `manageList`, `review`, `restrictedView`, `submitOnly`, `unknownFutureValue`.| +|allowEmbed|[sharingOperationStatus](../resources/sharingoperationstatus.md)|Indicates whether a link can be embedded.| +|passwordProtected|[sharingOperationStatus](../resources/sharingoperationstatus.md)|Indicates whether a link can be password protected, meaning that link users would need to enter a password to access the item for which the sharing link is produced. Creating a passwordProtected link for the first time requires providing a password.| +|requiresAuthentication|[sharingOperationStatus](../resources/sharingoperationstatus.md)|Indicates whether a link requires identity authentication for recipients. Users can be verified through either an email address or identity.| ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.sharingLinkVariants" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.sharingLinkVariants", + "passwordProtected": { + "@odata.type": "microsoft.graph.sharingOperationStatus" + }, + "requiresAuthentication": { + "@odata.type": "microsoft.graph.sharingOperationStatus" + }, + "addressBarLinkPermission": "String", + "allowEmbed": { + "@odata.type": "microsoft.graph.sharingOperationStatus" + } +} +``` |
v1.0 | Sharingoperationstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/sharingoperationstatus.md | + + Title: "sharingOperationStatus resource type" +description: "Represents the status of a particular sharing operation." ++ms.localizationpriority: medium ++++# sharingOperationStatus resource type ++Namespace: microsoft.graph +++Represents the status of a particular sharing operation. ++## Properties ++|Property|Type|Description| +|:|:|:| +|disabledReason|String|Provides a description of why this operation is not enabled. Only returned if this operation is not enabled.| +|enabled|Boolean|Indicates whether this operation is enabled.| ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.sharingOperationStatus" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.sharingOperationStatus", + "enabled": "Boolean", + "disabledReason": "String" +} +``` |
v1.0 | Sharingviewpoint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/sharingviewpoint.md | + + Title: "sharingViewpoint resource type" +description: "Represents the sharing operations the current user can take on the specified item." ++ms.localizationpriority: medium ++++# sharingViewpoint resource type ++Namespace: microsoft.graph +++Represents sharing operations the current user can take on the specified item. ++## Properties ++|Property|Type|Description| +|:|:|:| +|defaultSharingLink|[defaultSharingLink](../resources/defaultsharinglink.md)|The default sharing link the user can create for this item.| +|sharingAbilities|[sharePointSharingAbilities](../resources/sharepointsharingabilities.md)|Provides information about which sharing links are available to the user.| ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.sharingViewpoint" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.sharingViewpoint", + "sharingAbilities": { + "@odata.type": "microsoft.graph.sharePointSharingAbilities" + }, + "defaultSharingLink": { + "@odata.type": "microsoft.graph.defaultSharingLink" + } +} +``` |
v1.0 | Shiftactivity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/shiftactivity.md | Represents an activity in a [shift](shift.md). ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Shiftitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/shiftitem.md | Represents a version of a [shift](shift.md). ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Signin | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/signin.md | The [Microsoft Entra data retention policies](/azure/active-directory/reports-mo |authenticationDetails|[authenticationDetail](authenticationdetail.md) collection|The result of the authentication attempt and more details on the authentication method.| |authenticationMethodsUsed|String collection|The authentication methods used. Possible values: `SMS`, `Authenticator App`, `App Verification code`, `Password`, `FIDO`, `PTA`, or `PHS`.| |authenticationProcessingDetails|[keyValue](keyvalue.md) collection|More authentication processing details, such as the agent name for PTA and PHS, or a server or farm name for federated authentication.|-|authenticationProtocol|protocolType|Lists the protocol type or grant type used in the authentication. The possible values are: `oAuth2`, `ropc`, `wsFederation`, `saml20`, `deviceCode`, `unknownFutureValue`, `authenticationTransfer`, and `none`. Use `none` for all authentications that don't have a specific value in that list. | +|authenticationProtocol|protocolType|Lists the protocol type or grant type used in the authentication. The possible values are: `none`, `oAuth2`, `ropc`, `wsFederation`, `saml20`, `deviceCode`, `unknownFutureValue`, `authenticationTransfer`, `nativeAuth`. Use `none` for all authentications that don't have a specific value in that list. You must use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `authenticationTransfer`, `nativeAuth`. | |authenticationRequirement | String | This holds the highest level of authentication needed through all the sign-in steps, for sign-in to succeed. <br/><br/> Supports `$filter` (`eq`, `startsWith`).| |authenticationRequirementPolicies|[authenticationRequirementPolicy](../resources/authenticationrequirementpolicy.md) collection|Sources of authentication requirement, such as conditional access, per-user MFA, identity protection, and security defaults.| |autonomousSystemNumber|Int32|The Autonomous System Number (ASN) of the network used by the actor.| |azureResourceId|String|Contains a fully qualified Azure Resource Manager ID of an Azure resource accessed during the sign-in.| |clientAppUsed|String|The legacy client used for sign-in activity. For example: `Browser`, `Exchange ActiveSync`, `Modern clients`, `IMAP`, `MAPI`, `SMTP`, or `POP`. <br/><br/> Supports `$filter` (`eq`). | |clientCredentialType|clientCredentialType|Describes the credential type that a user client or service principal provided to Microsoft Entra ID to authenticate itself. You can review this property to track and eliminate less secure credential types or to watch for clients and service principals using anomalous credential types. The possible values are: `none`, `clientSecret`, `clientAssertion`, `federatedIdentityCredential`, `managedIdentity`, `certificate`, `unknownFutureValue`.|+|conditionalAccessAudiences|String|A list that indicates the audience that was evaluated by Conditional Access during a sign-in event. <br/><br/> Supports `$filter` (`eq`).| |conditionalAccessStatus|conditionalAccessStatus| The status of the conditional access policy triggered. Possible values: `success`, `failure`, `notApplied`, or `unknownFutureValue`. <br/><br/> Supports `$filter` (`eq`).| |correlationId|String|The identifier the client sends when sign-in is initiated. This is used for troubleshooting the corresponding sign-in activity when calling for support. <br/><br/> Supports `$filter` (`eq`).| |createdDateTime|DateTimeOffset|The date and time the sign-in was initiated. The Timestamp type is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. <br/><br/> Supports `$orderby`, `$filter` (`eq`, `le`, and `ge`).|-|crossTenantAccessType|signInAccessType|Describes the type of cross-tenant access used by the actor to access the resource. Possible values are: `none`, `b2bCollaboration`, `b2bDirectConnect`, `microsoftSupport`, `serviceProvider`, `unknownFutureValue`, `passthrough`. Also, note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value or values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `passthrough`. If the sign in didn't cross tenant boundaries, the value is `none`.| +|crossTenantAccessType|signInAccessType|Describes the type of cross-tenant access used by the actor to access the resource. Possible values are: `none`, `b2bCollaboration`, `b2bDirectConnect`, `microsoftSupport`, `serviceProvider`, `unknownFutureValue`, `passthrough`. Also, you must use the `Prefer: include-unknown-enum-members` request header to get the following value or values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `passthrough`. If the sign in didn't cross tenant boundaries, the value is `none`.| |deviceDetail|[deviceDetail](devicedetail.md)|The device information from where the sign-in occurred. Includes information such as deviceId, OS, and browser. <br/><br/> Supports `$filter` (`eq`, `startsWith`) on **browser** and **operatingSystem** properties.| |federatedCredentialId|String|Contains the identifier of an application's federated identity credential, if a federated identity credential was used to sign in.| |flaggedForReview|Boolean|During a failed sign-in, a user can select a button in the Azure portal to mark the failed event for tenant admins. If a user selects the button to flag the failed sign-in, this value is `true`.|+|globalSecureAccessIpAddress|String|The Global Secure Access IP address that the sign-in was initiated from.| |homeTenantId|String|The tenant identifier of the user initiating the sign-in. Not applicable in Managed Identity or service principal sign ins.| |homeTenantName|String|For user sign ins, the identifier of the tenant that the user is a member of. Only populated in cases where the home tenant has provided affirmative consent to Microsoft Entra ID to show the tenant content.| |id|String|The identifier representing the sign-in activity. Inherited from [entity](entity.md). <br/><br/> Supports `$filter` (`eq`).|-|incomingTokenType|incomingTokenType|Indicates the token types that were presented to Microsoft Entra ID to authenticate the actor in the sign in. The possible values are: `none`, `primaryRefreshToken`, `saml11`, `saml20`, `unknownFutureValue`, `remoteDesktopToken`. <br><br> **NOTE** Microsoft Entra ID might have also used token types not listed in this enum type to authenticate the actor. Don't infer the lack of a token if it isn't one of the types listed. Also, note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value or values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `remoteDesktopToken`.| +|incomingTokenType|incomingTokenType|Indicates the token types that were presented to Microsoft Entra ID to authenticate the actor in the sign in. The possible values are: `none`, `primaryRefreshToken`, `saml11`, `saml20`, `unknownFutureValue`, `remoteDesktopToken`. <br><br> **NOTE** Microsoft Entra ID might have also used token types not listed in this enum type to authenticate the actor. Don't infer the lack of a token if it isn't one of the types listed. Also, you must use the `Prefer: include-unknown-enum-members` request header to get the following value or values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `remoteDesktopToken`.| |ipAddress|String|The IP address of the client from where the sign-in occurred. <br/><br/> Supports `$filter` (`eq`, `startsWith`).| |ipAddressFromResourceProvider|String|The IP address a user used to reach a resource provider, used to determine Conditional Access compliance for some policies. For example, when a user interacts with Exchange Online, the IP address that Microsoft Exchange receives from the user can be recorded here. This value is often `null`.| |isInteractive|Boolean|Indicates whether a user sign in is interactive. In interactive sign in, the user provides an authentication factor to Microsoft Entra ID. These factors include passwords, responses to MFA challenges, biometric factors, or QR codes that a user provides to Microsoft Entra ID or an associated app. In non-interactive sign in, the user doesn't provide an authentication factor. Instead, the client app uses a token or code to authenticate or access a resource on behalf of a user. Non-interactive sign ins are commonly used for a client to sign in on a user's behalf in a process transparent to the user.| |isTenantRestricted|Boolean|Shows whether the sign in event was subject to a Microsoft Entra tenant restriction policy.|+|isThroughGlobalSecureAccess|Boolean|Indicates whether a user came through Global Secure Access service.| |location|[signInLocation](signinlocation.md)|The city, state, and two letter country code from where the sign-in occurred. <br/><br/> Supports `$filter` (`eq`, `startsWith`) on **city**, **state**, and **countryOrRegion** properties.| |managedServiceIdentity|[managedIdentity](../resources/managedidentity.md)|Contains information about the managed identity used for the sign in, including its type, associated Azure Resource Manager (ARM) resource ID, and federated token information.| |networkLocationDetails|[networkLocationDetail](networklocationdetail.md) collection|The network location details including the type of network used and its names.| The [Microsoft Entra data retention policies](/azure/active-directory/reports-mo |resourceId|String|The identifier of the resource that the user signed in to. <br/><br/> Supports `$filter` (`eq`).| |resourceServicePrincipalId|String|The identifier of the service principal representing the target resource in the sign-in event.| |resourceTenantId|String|The tenant identifier of the resource referenced in the sign in.|-|riskDetail|riskDetail|The reason behind a specific state of a risky user, sign-in, or a risk event. The possible values are `none`, `adminGeneratedTemporaryPassword`, `userPerformedSecuredPasswordChange`, `userPerformedSecuredPasswordReset`, `adminConfirmedSigninSafe`, `aiConfirmedSigninSafe`, `userPassedMFADrivenByRiskBasedPolicy`, `adminDismissedAllRiskForUser`, `adminConfirmedSigninCompromised`, `hidden`, `adminConfirmedUserCompromised`, `unknownFutureValue`, `adminConfirmedServicePrincipalCompromised`, `adminDismissedAllRiskForServicePrincipal`, `m365DAdminDismissedDetection`, `userChangedPasswordOnPremises`, `adminDismissedRiskForSignIn`, `adminConfirmedAccountSafe`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value or values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `adminConfirmedServicePrincipalCompromised`, `adminDismissedAllRiskForServicePrincipal`, `m365DAdminDismissedDetection`, `userChangedPasswordOnPremises`, `adminDismissedRiskForSignIn`, `adminConfirmedAccountSafe`.The value `none` means that Microsoft Entra risk detection has not flagged the user or the sign-in as a risky event so far. <br/><br/> Supports `$filter` (`eq`).<br> **Note:** Details for this property are only available for Microsoft Entra ID P2 customers. All other customers are returned `hidden`.| +|riskDetail|riskDetail|The reason behind a specific state of a risky user, sign-in, or a risk event. The possible values are `none`, `adminGeneratedTemporaryPassword`, `userPerformedSecuredPasswordChange`, `userPerformedSecuredPasswordReset`, `adminConfirmedSigninSafe`, `aiConfirmedSigninSafe`, `userPassedMFADrivenByRiskBasedPolicy`, `adminDismissedAllRiskForUser`, `adminConfirmedSigninCompromised`, `hidden`, `adminConfirmedUserCompromised`, `unknownFutureValue`, `adminConfirmedServicePrincipalCompromised`, `adminDismissedAllRiskForServicePrincipal`, `m365DAdminDismissedDetection`, `userChangedPasswordOnPremises`, `adminDismissedRiskForSignIn`, `adminConfirmedAccountSafe`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value or values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `adminConfirmedServicePrincipalCompromised`, `adminDismissedAllRiskForServicePrincipal`, `m365DAdminDismissedDetection`, `userChangedPasswordOnPremises`, `adminDismissedRiskForSignIn`, `adminConfirmedAccountSafe`.The value `none` means that Microsoft Entra risk detection hasn't flagged the user or the sign-in as a risky event so far. <br/><br/> Supports `$filter` (`eq`).<br> **Note:** Details for this property are only available for Microsoft Entra ID P2 customers. All other customers are returned `hidden`.| |riskEventTypes_v2|String collection|The list of risk event types associated with the sign-in. Possible values: `unlikelyTravel`, `anonymizedIPAddress`, `maliciousIPAddress`, `unfamiliarFeatures`, `malwareInfectedIPAddress`, `suspiciousIPAddress`, `leakedCredentials`, `investigationsThreatIntelligence`, `generic`, or `unknownFutureValue`. <br/><br/> Supports `$filter` (`eq`, `startsWith`).| |riskLevelAggregated|riskLevel|The aggregated risk level. Possible values: `none`, `low`, `medium`, `high`, `hidden`, or `unknownFutureValue`. The value `hidden` means the user or sign-in wasn't enabled for Microsoft Entra ID Protection. <br/><br/> Supports `$filter` (`eq`). <br>**Note:** Details for this property are only available for Microsoft Entra ID P2 customers. All other customers are returned `hidden`.| |riskLevelDuringSignIn|riskLevel|The risk level during sign-in. Possible values: `none`, `low`, `medium`, `high`, `hidden`, or `unknownFutureValue`. The value `hidden` means the user or sign-in wasn't enabled for Microsoft Entra ID Protection. <br/><br/> Supports `$filter` (`eq`). <br>**Note:** Details for this property are only available for Microsoft Entra ID P2 customers. All other customers are returned `hidden`.| The [Microsoft Entra data retention policies](/azure/active-directory/reports-mo |signInEventTypes|String collection|Indicates the category of sign in that the event represents. For user sign ins, the category can be `interactiveUser` or `nonInteractiveUser` and corresponds to the value for the **isInteractive** property on the signin resource. For managed identity sign ins, the category is `managedIdentity`. For service principal sign-ins, the category is **servicePrincipal**. Possible values are: `interactiveUser`, `nonInteractiveUser`, `servicePrincipal`, `managedIdentity`, `unknownFutureValue`. <br/><br/> Supports `$filter` (`eq`, `ne`).| |signInIdentifier|String|The identification that the user provided to sign in. It can be the userPrincipalName, but is also populated when a user signs in using other identifiers.| |signInIdentifierType|signInIdentifierType|The type of sign in identifier. Possible values are: `userPrincipalName`, `phoneNumber`, `proxyAddress`, `qrCode`, `onPremisesUserPrincipalName`, `unknownFutureValue`.|-|signInTokenProtectionStatus|tokenProtectionStatus|Token protection creates a cryptographically secure tie between the token and the device it is issued to. This field indicates whether the signin token was bound to the device or not. The possible values are: `none`, `bound`, `unbound`, `unknownFutureValue`.| +|signInTokenProtectionStatus|tokenProtectionStatus|Token protection creates a cryptographically secure tie between the token and the device it's issued to. This field indicates whether the signin token was bound to the device or not. The possible values are: `none`, `bound`, `unbound`, `unknownFutureValue`.| |status|[signInStatus](signinstatus.md)|The sign-in status. Includes the error code and description of the error (for a sign-in failure). <br/><br/> Supports `$filter` (`eq`) on **errorCode** property.| |tokenIssuerName|String|The name of the identity provider. For example, `sts.microsoft.com`. <br/><br/> Supports `$filter` (`eq`).| |tokenIssuerType|tokenIssuerType|The type of identity provider. The possible values are: `AzureAD`, `ADFederationServices`, `UnknownFutureValue`, `AzureADBackupAuth`, `ADFederationServicesMFAAdapter`, `NPSExtension`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `AzureADBackupAuth` , `ADFederationServicesMFAAdapter` , `NPSExtension`.| |
v1.0 | Signinlocation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/signinlocation.md | Provides the city, state and country/region from where the sign-in happened. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Simulation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/simulation.md | Inherits from [entity](../resources/entity.md). |Member|Description | |:|:|-|unknown| The simulation status is not defined. | +|unknown| The simulation status isn't defined. | |draft| The simulation is in draft mode. | |running| The simulation is running. | |scheduled| The simulation is scheduled. |-|succeeded| The simulation has succeeded. | -|failed| The simulation has failed. | +|succeeded| The simulation is complete with success status. | +|failed| The simulation is complete with fail status. | |cancelled| The simulation is cancelled. | |excluded| The simulation is excluded. |-|unknownFutureValue| Evolvable enumeration sentinel value. Do not use. | +|unknownFutureValue| Evolvable enumeration sentinel value. Don't use. | ### simulationAttackTechnique values Inherits from [entity](../resources/entity.md). |driveByUrl| Attack technique that involves an end user clicking a URL link in the phishing payload. | |linkInAttachment| Attack technique that involves an end user clicking a URL link in an attachment. | |linkToMalwareFile| Attack technique that involves an end user clicking a URL link to a malware file. |-|unknownFutureValue| Evolvable enumeration sentinel value. Do not use. | +|unknownFutureValue| Evolvable enumeration sentinel value. Don't use. | |oAuthConsentGrant| Attack technique that involves an end user who gives access consent to an app.|+|phishTraining| Attack technique that involves training end users on actions to be performed on a phish mail.| ### simulationAttackType values Inherits from [entity](../resources/entity.md). |social| Attack that uses social skills to manipulate victims psychologically, creating a false sense of curiosity, urgency, or fear. | |cloud| Attack on a host or user in a cloud environment, for example, denial of service attacks.| |endpoint| Attack on endpoints of a corporate network, such as desktops, laptops, mobile phones, and Internet of Things (IoT) devices. |-|unknownFutureValue| Evolvable enumeration sentinel value. Do not use. | +|unknownFutureValue| Evolvable enumeration sentinel value. Don't use. | ### simulationContentStatus values |Member|Description | |:|:|-|unknown| The simulation content status is not defined. | +|unknown| The simulation content status isn't defined. | |draft| The simulation content status is in draft state. | |ready| The simulation content status is in ready state. | |archive| The simulation content status is archive state. | |delete| The simulation content status is in delete state. |-|unknownFutureValue| Evolvable enumeration sentinel value. Do not use. | +|unknownFutureValue| Evolvable enumeration sentinel value. Don't use. | ### simulationContentSource values |Member|Description | |:|:|-|unknown| The simulation content source is not defined. | +|unknown| The simulation content source isn't defined. | |global| The simulation content source is global. | |tenant| The simulation content source is tenant. |-|unknownFutureValue| Evolvable enumeration sentinel value. Do not use. | +|unknownFutureValue| Evolvable enumeration sentinel value. Don't use. | ## Relationships |
v1.0 | Simulationautomation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/simulationautomation.md | Inherits from [entity](../resources/entity.md). |runs|[simulationAutomationRun](../resources/simulationautomationrun.md) collection|A collection of simulation automation runs. | ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Singleresourceazurepermissionsdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/singleresourceazurepermissionsdefinition.md | description: "Represents permissions for an Azure resource." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Singleresourcegcppermissionsdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/singleresourcegcppermissionsdefinition.md | description: "Represents permissions for a GCP resource." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Singlevaluelegacyextendedproperty | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/singlevaluelegacyextendedproperty.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Sitearchivaldetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/sitearchivaldetails.md | ++ +description: "Represents the archival details of a siteCollection." + Title: "siteArchivalDetails resource type" +ms.localizationpriority: "medium" +++# siteArchivalDetails resource type ++Represents the archival details of a [siteCollection](/graph/sitecollection). ++## Properties ++| Property | Type | Description | +|:- |: |:--| +| archiveStatus | siteArchiveStatus | Represents the current archive status of the site collection. Returned only on `$select`.| ++## siteArchiveStatus values ++| Value | Description | +|:--|:| +| recentlyArchived | The site collection was recently archived. | +| fullyArchived | The site collection is fully archived. | +| reactivating | The site collection is reactivating. | +| unknownFutureValue | Evolvable enumeration sentinel value. Do not use. | ++## JSON representation +The following JSON representation shows the resource type. +<!-- { +"blockType": "resource", +"@odata.type": "microsoft.graph.siteArchivalDetails", +"optionalProperties": [] +}--> ++```json +{ + "archiveStatus": "fullyArchived" +} +``` ++<!-- { +"type": "#page.annotation", +"createdBy": "API Clinic", +"section": "documentation" +}--> |
v1.0 | Sitecollection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/sitecollection.md | description: Provides more information about a site collection. Last updated 09/10/2017 Title: SiteCollection + Title: aiteCollection resource type ms.localizationpriority: medium doc_type: resourcePageType Namespace: microsoft.graph Provides more information about a site collection. -If a [**site**](site.md) resource has a non-null **siteCollection** property, then the site is a root site for a site collection. +If a [**site**](site.md) resource has a non-null **siteCollection** property, the site is a root site for a site collection. ## Properties If a [**site**](site.md) resource has a non-null **siteCollection** property, th | **hostname** | string | The hostname for the site collection. Read-only. | | **dataLocationCode** | string | The geographic region code for where this site collection resides. Only present for multi-geo tenants. Read-only. | | **root** | [root][] | If present, indicates that this is a root site collection in SharePoint. Read-only. |+| **archivalDetails** | [siteArchivalDetails][] | Represents whether the site collection is recently archived, fully archived, or reactivating. Possible values are: `recentlyArchived`, `fullyArchived`, `reactivating`, `unknownFutureValue`. | ## JSON representation The following JSON representation shows the resource type. { "hostname": "contoso.sharepoint.com", "dataLocationCode": "EUR",- "root": { "@odata.type": "microsoft.graph.root" } + "root": { "@odata.type": "microsoft.graph.root" }, + "archivalDetails": { + "@odata.type": "microsoft.graph.siteArchivalDetails", + "archiveStatus": "fullyArchived" + } } ``` [root]: root.md+[siteArchivalDetails]: siteArchivalDetails.md <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> |
v1.0 | Sitepage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/sitepage.md | Inherits from [baseSitePage](../resources/basesitepage.md). | [Update sitePage](../api/sitepage-update.md) | [sitePage](../resources/sitepage.md) | Update the properties of a [sitePage](../resources/sitepage.md) object. | | [Delete sitePage](../api/basesitepage-delete.md) | None | Deletes a [sitePage](../resources/sitepage.md) object. | | [Publish sitePage](../api/sitepage-publish.md) | None | Publish a [sitePage](../resources/sitepage.md) object. |-| [Get a collection of WebParts by position information](../api/sitepage-getwebpartsbyposition.md) | [webpart](../resources/webpart.md) collection | Get a collection of [WebPart](../resources/webpart.md) by providing [webPartPosition](../resources/webpartposition.md) information. | +| [Get a collection of WebParts by position information](../api/sitepage-getwebpartsbyposition.md) | [webPart](../resources/webpart.md) collection | Get a collection of [WebPart](../resources/webpart.md) by providing [webPartPosition](../resources/webpartposition.md) information. | ## Properties |
v1.0 | Sizerange | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/sizerange.md | Specifies the maximum and minimum sizes (in kilobytes) that an incoming message ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Smsauthenticationmethodconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/smsauthenticationmethodconfiguration.md | Inherits from [authenticationMethodConfiguration](../resources/authenticationmet |includeTargets|[smsAuthenticationMethodTarget](../resources/smsauthenticationmethodtarget.md) collection|A collection of groups that are enabled to use the authentication method.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Smsauthenticationmethodtarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/smsauthenticationmethodtarget.md | A collection of groups enabled to use [Text Message authentication methods polic None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Softwareoathauthenticationmethod | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/softwareoathauthenticationmethod.md | This is a derived type that inherits from the [authenticationMethod](authenticat None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Stalesigninalertconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/stalesigninalertconfiguration.md | Inherits from [unifiedRoleManagementAlertConfiguration](../resources/unifiedrole |alertDefinition|[unifiedRoleManagementAlertDefinition](../resources/unifiedrolemanagementalertdefinition.md)| The definition of the alert that contains its description, impact, and measures to mitigate or prevent it. Supports `$expand`.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Stalesigninalertincident | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/stalesigninalertincident.md | Inherits from [unifiedRoleManagementAlertIncident](../resources/unifiedrolemanag None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Standardtimezoneoffset | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/standardtimezoneoffset.md | That means the transition from daylight saving time to standard occurs at 2 AM o ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Statusdetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/statusdetails.md | Describes the status of the provisioning event and the associated errors. It's i ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Subjectrightsrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/subjectrightsrequest.md | Inherits from [entity](../resources/entity.md). |team|[team](../resources/team.md)|Information about the Microsoft Teams team that was created for the request.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Subjectset | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/subjectset.md | This object is an abstract base type from which the following resources are deri + [requestorManager](requestormanager.md) + [ruleBasedSubjectSet](../resources/identitygovernance-ruleBasedSubjectSet.md) + [singleUser](singleuser.md)++ [groupBasedSubjectSet](../resources/identitygovernance-groupbasedsubjectset.md) ## Properties |
v1.0 | Subscription | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/subscription.md | description: "Represents a subscription that allows a client app to receive chan ms.localizationpriority: medium doc_type: resourcePageType+ |
v1.0 | Superawsresourcefinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/superawsresourcefinding.md | description: "Represents the super AWS resources." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Superawsrolefinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/superawsrolefinding.md | description: "Represents the super AWS roles." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Superazureserviceprincipalfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/superazureserviceprincipalfinding.md | description: "Represents the super Azure service principals." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Supergcpserviceaccountfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/supergcpserviceaccountfinding.md | description: "Represents the super GCP service accounts." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Superserverlessfunctionfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/superserverlessfunctionfinding.md | description: "Represents the super serverless functions in AWS, Azure, or GCP." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Superuserfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/superuserfinding.md | description: "Represents the super users in AWS, Azure, or GCP." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Synchronization Attributemappingsource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/synchronization-attributemappingsource.md | Expression extracting first eight characters from the source attribute. ``` ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.attributeMappingSource" |
v1.0 | Synchronization Bulkupload | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/synchronization-bulkupload.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents the capability of the Microsoft Entra synchronization service to process bulk uploads. +Represents the capability of the Microsoft Entra synchronization service to process bulk uploads. For more information, see [API-driven inbound provisioning concepts](/entra/identity/app-provisioning/inbound-provisioning-api-concepts). ## Methods |
v1.0 | Synchronization Directorydefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/synchronization-directorydefinition.md | Inherits from [entity](../resources/entity.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Synchronization Filter | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/synchronization-filter.md | For more information, see [Attribute-based application provisioning with scoping ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Synchronization Synchronizationjobrestartcriteria | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/synchronization-synchronizationjobrestartcriteria.md | Defines the scope of the [synchronizationJob: restart](../api/synchronization-sy ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Synchronization Synchronizationschema | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/synchronization-synchronizationschema.md | The following sections describe the high-level components of the synchronization |directories|[directoryDefinition](../resources/synchronization-directorydefinition.md) collection|Contains the collection of directories and all of their objects.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Synchronization Synchronizationsecretkeystringvaluepair | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/synchronization-synchronizationsecretkeystringvaluepair.md | Represents a single secret value. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Synchronization Synchronizationtemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/synchronization-synchronizationtemplate.md | You can provide multiple templates for an application, and designate a default t ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Targetresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/targetresource.md | Represents target resource types associated with audit activity. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Targetusersponsors | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/targetusersponsors.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.targetUserSponsors" |
v1.0 | Tasks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/tasks.md | None. |lists|[baseTaskList](../resources/basetasklist.md) collection|The task lists in the users mailbox.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Taskviewpoint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/taskviewpoint.md | Contains personal properties of a [task](task.md). When sharing or assigning a * None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.taskViewpoint" |
v1.0 | Teaminfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teaminfo.md | Base type of [associatedTeamInfo](associatedteaminfo.md) and [sharedWithChannelT ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Teamsasyncoperationtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamsasyncoperationtype.md | Title: "teamsAsyncOperationType enum type" -description: "Types of teamsAsyncOperation. Members will be added here as more async operations are supported." +description: "Types of teamsAsyncOperation. Members are added here as more async operations are supported." ms.localizationpriority: medium Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Types of [teamsAsyncOperation](teamsasyncoperation.md). Members will be added here as more async operations are supported. +Types of [teamsAsyncOperation](teamsasyncoperation.md). Members are added here as more async operations are supported. ## Members-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: `teamifyGroup`, `createChannel`, `createChat`. +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: `teamifyGroup`, `createChannel`, `createChat`, `archiveChannel`, `unarchiveChannel`. | Member | Description | |:|:-| The following table lists the members of an [evolvable enumeration](/graph/best- |archiveTeam|Operation to archive a team.| |unarchiveTeam|Operation to restore an archived team.| |createTeam|Operation to create a team from scratch.|-|unknownFutureValue| Evolvable enumeration sentinel value. Do not use. | +|unknownFutureValue| Evolvable enumeration sentinel value. Don't use. | |teamifyGroup |Operation to create a team from a group. | |createChannel |Operation to create a channel in a team. | |createChat|Operation to create a chat from scratch.|+|archiveChannel |Operation to archive a channel.| +|unarchiveChannel |Operation to unarchive a channel.| |
v1.0 | Teamstab | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamstab.md | Title: "teamsTab resource type" -description: "A teamsTab is a tab that's pinned (attached) to a channel within a team. " +description: "Represents a tab pinned (attached) to a channel or a chat." ms.localizationpriority: medium Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -A teamsTab is a [tab](../resources/teamstab.md) that's pinned (attached) to a [channel](channel.md) within a [team](team.md). +Represents a tab pinned (attached) to a [channel](channel.md) or a [chat](chat.md). ++For more information about tabs, see [Build tabs for Teams](/microsoftteams/platform/tabs/what-are-tabs). ## Methods A teamsTab is a [tab](../resources/teamstab.md) that's pinned (attached) to a [c | id | string | Identifier that uniquely identifies a specific instance of a channel tab. Read only. | | displayName | string | Name of the tab. | | name (deprecated) | string | Name of the tab. |-| teamsAppId (deprecated)| string | App definition identifier of the tab. This value cannot be changed after tab creation. Because this property is deprecated, we recommend expanding **teamsApp** to retrieve the application that is linked to the tab. | +| teamsAppId (deprecated)| string | App definition identifier of the tab. This value can't be changed after tab creation. Because this property is deprecated, we recommend expanding **teamsApp** to retrieve the application that is linked to the tab. | | sortOrderIndex | string | Index of the order used for sorting tabs. | | webUrl | string | Deep link URL of the tab instance. Read only. | | configuration | [teamsTabConfiguration](teamstabconfiguration.md) | Container for custom settings applied to a tab. The tab is considered configured only once this property is set. | A teamsTab is a [tab](../resources/teamstab.md) that's pinned (attached) to a [c ## JSON representation -The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { |
v1.0 | Teamworkactivitytopic | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamworkactivitytopic.md | Represents the topic of an activity feed notification. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.teamworkActivityTopic" |
v1.0 | Teamworkdevice | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamworkdevice.md | Inherits from [entity](../resources/entity.md). |operations|[teamworkDeviceOperation](../resources/teamworkdeviceoperation.md) collection|The async operations on the device.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Teamworktag | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamworktag.md | When a tag is added, users can @mention it in a channel. Everyone who has been a |members|[teamworkTagMember](../resources/teamworktagmember.md) collection|Users assigned to the tag.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Tenantreference | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/tenantreference.md | Title: "tenantReference resource type" description: "Represents the information used to identify a Microsoft Entra tenant." + ms.localizationpriority: medium doc_type: resourcePageType |
v1.0 | Termstore Relation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/termstore-relation.md | Inherits from [entity](../resources/entity.md). |toTerm|[microsoft.graph.termStore.term](../resources/termstore-term.md)|The to [term] of the relation. The term to which the relationship is defined.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Textwebpart | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/textwebpart.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Thumbnailset | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/thumbnailset.md | It's used to represent a set of thumbnails associated with a DriveItem. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Tiindicator | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/tiindicator.md | Title: "tiIndicator resource type" + Title: "tiIndicator resource type (deprecated)" description: "Threat intelligence (TI) indicators represent data used to identify malicious activities." ms.localizationpriority: medium ms.prod: "security" doc_type: resourcePageType -# tiIndicator resource type +# tiIndicator resource type (deprecated) Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] +> [!NOTE] +> The [tiIndicator](tiindicator.md) entity is deprecated and will be removed by April 2026. + Represents data used to identify malicious activities. If your organization works with threat indicators, either by generating your own, obtaining them from open source feeds, sharing with partner organizations or communities, or by purchasing feeds of data, you might want to use these indicators in various security tools for matching with log data. The **tiIndicators** entity allows you to upload your threat indicators to Microsoft security tools for the actions of allow, block, or alert. None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Timecardbreak | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/timecardbreak.md | Represents a specific [timeCard](timecard.md) break. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Timecardentry | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/timecardentry.md | Represents a specific [timeCard](timecard.md) entry. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Timecardevent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/timecardevent.md | Represents a specific [timeCard](timecard.md) event. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Timeclocksettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/timeclocksettings.md | Represents timeclock settings for a [schedule](schedule.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Timeconstraint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/timeconstraint.md | Restricts meeting time suggestions to certain hours and days of the week accordi ## JSON representation-Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Timeoffitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/timeoffitem.md | Represents a version of the [timeOff](timeoff.md). ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Timestamp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/timestamp.md | Date and time information for a point in time. ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Timezonebase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/timezonebase.md | The basic representation of a time zone. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Timezoneinformation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/timezoneinformation.md | format as well when the current known problem is fixed. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Todosettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/todosettings.md | Company-wide settings for Microsoft Todo. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.todoSettings" |
v1.0 | Training | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/training.md | Inherits from [entity](../resources/entity.md). |Property|Type|Description| |:|:|:|-|availabilityStatus|trainingAvailabilityStatus|Training availability status. Possible values are: `unknown`, `notAvailable`, `available`, `archive`, `delete`, `unknownFutureValue`.| -|createdBy|[emailIdentity](../resources/emailidentity.md)|Identity of the user who created the training.| -|createdDateTime|DateTimeOffset|Date and time when the training was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| +|availabilityStatus|trainingAvailabilityStatus|The training availability status. Possible values are: `unknown`, `notAvailable`, `available`, `archive`, `delete`, `unknownFutureValue`.| +|createdBy|[emailIdentity](../resources/emailidentity.md)|The identity of the user who created the training.| +|createdDateTime|DateTimeOffset|The date and time when the training was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| +|customUrl|String|The training URL| |description|String|The description for the training.| |displayName|String|The display name for the training.|-|durationInMinutes|Int32|Training duration.| -|hasEvaluation|Boolean|Indicates whether the training has any evaluation.| -|id|String|Unique identifier for the **training** object. Inherited from [entity](../resources/entity.md).| -|lastModifiedBy|[emailIdentity](../resources/emailidentity.md)|Identity of the user who last modified the training.| -|lastModifiedDateTime|DateTimeOffset|Date and time when the training was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| -|source|[simulationContentSource](../resources/simulation.md#simulationcontentsource-values)|Training content source. Possible values are: `unknown`, `global`, `tenant`, `unknownFutureValue`.| -|supportedLocales|String collection|Supported locales for content for the associated training.| +|durationInMinutes|Int32|The duration of the training in minutes.| +|hasEvaluation|Boolean|Whether the training has any evaluation.| +|id|String|The unique identifier for the **training** object. Inherited from [entity](../resources/entity.md).| +|lastModifiedBy|[emailIdentity](../resources/emailidentity.md)|The identity of the user who last modified the training.| +|lastModifiedDateTime|DateTimeOffset|The date and time when the training was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| +|source|[simulationContentSource](../resources/simulation.md#simulationcontentsource-values)|The source of the training content. Possible values are: `unknown`, `global`, `tenant`, `unknownFutureValue`.| +|supportedLocales|String collection|The supported locales for content for the associated training.| |tags|String collection|Training tags.| |type|trainingType|The type of training. Possible values are: `unknown`, `phishing`, `unknownFutureValue`.| Inherits from [entity](../resources/entity.md). |Relationship|Type|Description| |:|:|:|-|languageDetails|[trainingLanguageDetail](../resources/traininglanguagedetail.md) collection|Language specific details on a training.| +|languageDetails|[trainingLanguageDetail](../resources/traininglanguagedetail.md) collection|Details about the language used in the training.| ## JSON representation The following JSON representation shows the resource type. "id": "String (identifier)", "lastModifiedBy": {"@odata.type": "microsoft.graph.emailIdentity"}, "lastModifiedDateTime": "String (timestamp)",+ "customUrl": "String", "source": "String", "supportedLocales": ["String"], "tags": ["String"], |
v1.0 | Trainingcampaign | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/trainingcampaign.md | + + Title: "trainingCampaign resource type" +description: "Represents a training campaign." ++ms.localizationpriority: medium +++# trainingCampaign resource type ++Namespace: microsoft.graph +++Represents a training campaign. In Attack simulation training in Microsoft 365 E5 or Microsoft Defender for Office 365 Plan 2, training campaigns are a fast, direct way to provide security training to users. Instead of creating and launching simulated phishing attacks that eventually lead to training, you can create and assign training campaigns directly to users. ++A training campaign contains one or more built-in training modules that you select. Currently, there are over 70 training modules to select from. For more information about training modules, see training modules for Training campaigns in Attack simulation training. +++Inherits from [entity](../resources/entity.md). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List trainingCampaigns](../api/attacksimulationroot-list-trainingcampaigns.md)|[trainingCampaign](../resources/trainingcampaign.md) collection|Get a list of the [trainingCampaign](../resources/trainingcampaign.md) objects and their properties.| +|[Create trainingCampaign](../api/attacksimulationroot-post-trainingcampaigns.md)|[trainingCampaign](../resources/trainingcampaign.md)|Create a new [trainingCampaign](../resources/trainingcampaign.md) object.| +|[Get trainingCampaign](../api/trainingcampaign-get.md)|[trainingCampaign](../resources/trainingcampaign.md)|Read the properties and relationships of a [trainingCampaign](../resources/trainingcampaign.md) object.| +|[Update trainingCampaign](../api/trainingcampaign-update.md)|[trainingCampaign](../resources/trainingcampaign.md)|Update the properties of a [trainingCampaign](../resources/trainingcampaign.md) object.| +|[Delete trainingCampaign](../api/attacksimulationroot-delete-trainingcampaigns.md)|None|Delete a [trainingCampaign](../resources/trainingcampaign.md) object.| ++## Properties +|Property|Type|Description| +|:|:|:| +|campaignSchedule|[campaignSchedule](../resources/campaignschedule.md)|Details about the schedule and current status for a training campaign| +|createdBy|[emailIdentity](../resources/emailidentity.md)|Identity of the user who created the training campaign| +|createdDateTime|DateTimeOffset|Date and time of creation of the training campaign.| +|description|String|Description of the training campaign.| +|displayName|String|Display name of the training campaign. Supports `$filter` and `$orderby`.| +|endUserNotificationSetting|[endUserNotificationSetting](../resources/endusernotificationsetting.md)|Details about the end user notification setting.| +|excludedAccountTarget|[accountTargetContent](../resources/accounttargetcontent.md)|Users excluded from the training campaign.| +|id|String|Unique identifier for the training campaign. Inherited from [entity](../resources/entity.md).| +|includedAccountTarget|[accountTargetContent](../resources/accounttargetcontent.md)|Users targeted in the training campaign.| +|lastModifiedBy|[emailIdentity](../resources/emailidentity.md)|Identity of the user who most recently modified the training campaign.| +|lastModifiedDateTime|DateTimeOffset|Date and time of the most recent modification of the training campaign.| +|report|[trainingCampaignReport](../resources/trainingcampaignreport.md)|Report of the training campaign.| +|trainingSetting|[trainingSetting](../resources/trainingsetting.md)|Details about the training settings for a training campaign.| ++### campaignStatus values ++|Member|Description | +|:|:| +|unknown| The campaign status isn't defined. | +|draft| The campaign is in draft mode. | +|inProgress| The campaign is in progress. | +|scheduled| The campaign is scheduled. | +|completed| The campaign is complete. | +|failed| The campaign failed. | +|cancelled| The campaign is cancelled. | +|excluded| The campaign is excluded. | +|deleted| The campaign is in draft mode. | +|unknownFutureValue| Evolvable enumeration sentinel value. Don't use. | ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.trainingCampaign", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.trainingCampaign", + "id": "String (identifier)", + "createdBy": { + "@odata.type": "microsoft.graph.emailIdentity" + }, + "createdDateTime": "String (timestamp)", + "description": "String", + "displayName": "String", + "endUserNotificationSetting": { + "@odata.type": "microsoft.graph.endUserNotificationSetting" + }, + "excludedAccountTarget": { + "@odata.type": "microsoft.graph.accountTargetContent" + }, + "includedAccountTarget": { + "@odata.type": "microsoft.graph.accountTargetContent" + }, + "lastModifiedBy": { + "@odata.type": "microsoft.graph.emailIdentity" + }, + "lastModifiedDateTime": "String (timestamp)", + "report": { + "@odata.type": "microsoft.graph.trainingCampaignReport" + }, + "trainingSetting": { + "@odata.type": "microsoft.graph.trainingSetting" + }, + "campaignSchedule": { + "@odata.type": "microsoft.graph.campaignSchedule" + } +} +``` ++## Related content +- [Training campaigns in Attack simulation training](/microsoft-365/security/office-365-security/attack-simulation-training-training-campaigns?view=o365-worldwide&preserve-view=true) + |
v1.0 | Trainingcampaignreport | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/trainingcampaignreport.md | + + Title: "trainingCampaignReport resource type" +description: "Represents a report of a training campaign, including an overview and a list of the users who participated in the campaign." ++ms.localizationpriority: medium +++# trainingCampaignReport resource type ++Namespace: microsoft.graph +++Represents a report of a training campaign, including an overview and a list of the users who participated in the campaign. ++## Properties +|Property|Type|Description| +|:|:|:| +|campaignUsers|[userSimulationDetails](../resources/usersimulationdetails.md) collection|The overview of the attack simulation and training campaign.| +|overview|[trainingCampaignReportOverview](../resources/trainingcampaignreportoverview.md)|The tenant users and their online actions in a training campaign.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.trainingCampaignReport" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.trainingCampaignReport", + "overview": { + "@odata.type": "microsoft.graph.trainingCampaignReportOverview" + }, + "campaignUsers": [ + { + "@odata.type": "microsoft.graph.userSimulationDetails" + } + ] +} +``` + |
v1.0 | Trainingcampaignreportoverview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/trainingcampaignreportoverview.md | + + Title: "trainingCampaignReportOverview resource type" +description: "Represents an overview report of a training campaign." ++ms.localizationpriority: medium +++# trainingCampaignReportOverview resource type ++Namespace: microsoft.graph +++Represents an overview report of a training campaign. ++## Properties +|Property|Type|Description| +|:|:|:| +|trainingModuleCompletion|[trainingEventsContent](../resources/trainingeventscontent.md)|Aggregate data of training completion.| +|trainingNotificationDeliveryStatus|[trainingNotificationDelivery](../resources/trainingnotificationdelivery.md)|Aggregate data of training mail delivery over the course of the training campaign.| +|userCompletionStatus|[userTrainingCompletionSummary](../resources/usertrainingcompletionsummary.md)|Aggregate data of users training progress.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.trainingCampaignReportOverview" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.trainingCampaignReportOverview", + "trainingModuleCompletion": { + "@odata.type": "microsoft.graph.trainingEventsContent" + }, + "userCompletionStatus": { + "@odata.type": "microsoft.graph.userTrainingCompletionSummary" + }, + "trainingNotificationDeliveryStatus": { + "@odata.type": "microsoft.graph.trainingNotificationDelivery" + } +} +``` + |
v1.0 | Trainingnotificationdelivery | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/trainingnotificationdelivery.md | + + Title: "trainingNotificationDelivery resource type" +description: "Contains aggregate data about training mail delivery over the course of the training campaign." ++ms.localizationpriority: medium +++# trainingNotificationDelivery resource type ++Namespace: microsoft.graph +++Contains aggregate data about training mail delivery over the course of the training campaign. ++## Properties +|Property|Type|Description| +|:|:|:| +|failedMessageDeliveryCount|Int32|The number of users to whom mails couldn't be delivered.| +|resolvedTargetsCount|Int32|The number of users whose email address was successfully resolved from target users.| +|successfulMessageDeliveryCount|Int32|The number of users who received a mail while the training campaign was in the "in progress" state.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.trainingNotificationDelivery" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.trainingNotificationDelivery", + "resolvedTargetsCount": "Integer", + "successfulMessageDeliveryCount": "Integer", + "failedMessageDeliveryCount": "Integer" +} +``` + |
v1.0 | Translationlanguageoverride | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/translationlanguageoverride.md | Title: "translationLanguageOverride resource type" description: "A resource representing an entry in the translation language override list." ms.localizationpriority: medium + doc_type: resourcePageType # translationLanguageOverride resource type |
v1.0 | Translationpreferences | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/translationpreferences.md | Title: "translationPreferences resource type" description: "A resource representing the user's translation settings preferences." ms.localizationpriority: medium + doc_type: resourcePageType # translationPreferences resource type |
v1.0 | Trustframeworkkey_V2 | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/trustFrameworkkey_v2.md | + + Title: "trustFrameworkKey_v2 resource type" +description: "Represents a JWK (JSON Web Key). TrustFrameworkKey_v2 is a JSON data structure that represents a cryptographic key. The structure of this resource follows the format defined in RFC 7517 Section 4." ++ms.localizationpriority: medium ++++# trustFrameworkKey_v2 resource type ++Namespace: microsoft.graph +++Represents a JWK (JSON Web Key). TrustFrameworkKey_v2 is a JSON data structure that represents a cryptographic key. The structure of this resource follows the format defined in [RFC 7517 Section 4](https://tools.ietf.org/html/rfc7517#section-4). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[Get](../api/trustframeworkkey_v2-get.md)|[trustFrameworkKey_v2](../resources/trustframeworkkey_v2.md)|Read the properties and relationships of a [trustFrameworkKey_v2](../resources/trustframeworkkey_v2.md) object.| +|[Update](../api/trustframeworkkey_v2-update.md)|[trustFrameworkKey_v2](../resources/trustframeworkkey_v2.md)|Update the properties of a [trustFrameworkKey_v2](../resources/trustframeworkkey_v2.md) object.| ++## Properties ++|Property|Type|Description| +|:|:|:| +|d|String|RSA Key - private exponent. The field isn't readable.| +|dp|String|RSA Key - first exponent. The field isn't readable.| +|dq|String|RSA Key - second exponent. The field isn't readable.| +|e|String|RSA Key - public exponent. | +|exp|Int64|This value is a NumericDate as defined in RFC 7519. That is, a JSON numeric value representing the number of seconds from 1970-01-01T00:00:00Z UTC until the specified UTC date/time, ignoring leap seconds.| +|k|String|Symmetric Key for oct key type. The field isn't readable.| +|kid|String|The unique identifier for the key. Primary key.| +|kty|String|The **kty** (key type) parameter identifies the cryptographic algorithm family used with the key. The valid values are `rsa`, `oct`.| +|n|String|RSA Key - modulus.| +|nbf|Int64|This value is a NumericDate as defined in RFC 7519. That is, a JSON numeric value representing the number of seconds from 1970-01-01T00:00:00Z UTC until the specified UTC date/time, ignoring leap seconds.| +|p|String|RSA Key - first prime. The field isn't readable.| +|q|String|RSA Key - second prime. The field isn't readable.| +|qi|String|RSA Key - Coefficient. The field isn't readable.| +|status|trustFrameworkKeyStatus|Status of the key. The possible values are: `enabled`, `disabled`, `unknownFutureValue`.| +|use|String|The **use** (public key use) parameter identifies the intended use of the public key. The **use** parameter is employed to indicate whether a public key is used for encrypting data or verifying the signature on data. Possible values are: `sig` (signature), `enc` (encryption).| +|x5c|String collection|The **x5c** (X.509 certificate chain) parameter contains a chain of one or more PKIX certificates. For more information, see [RFC 5280](https://tools.ietf.org/html/rfc5280).| +|x5t|String|The **x5t** (X.509 certificate SHA-1 thumbprint) parameter is a base64url-encoded SHA-1 thumbprint (also known as digest) of the DER encoding of an X.509 certificate. For more information, see [RFC 5280](https://tools.ietf.org/html/rfc5280).| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "kid", + "@odata.type": "microsoft.graph.trustFrameworkKey_v2", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.trustFrameworkKey_v2", + "k": "String", + "x5c": [ + "String" + ], + "x5t": "String", + "kty": "String", + "use": "String", + "status": "String", + "exp": "Integer", + "nbf": "Integer", + "kid": "String (identifier)", + "e": "String", + "n": "String", + "d": "String", + "p": "String", + "q": "String", + "dp": "String", + "dq": "String", + "qi": "String" +} +``` + |
v1.0 | Trustframeworkkey | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/trustframeworkkey.md | Title: "trustFrameworkKey resource type" description: "Represents a JWK (JSON Web Key). TrustFrameworkKey is a JSON data structure that represents a cryptographic key. The structure of this resource follows the format defined in RFC 7517 Section 4."+ ms.localizationpriority: medium- -doc_type: "resourcePageType" # trustFrameworkKey resource type Represents a JWK (JSON Web Key). TrustFrameworkKey is a JSON data structure that ## Properties -| Property | Type | Description | -|:-|:|:| -| kid | string | The unique identifier for the key. | -| kty | String | The **kty** (key type) parameter identifies the cryptographic algorithm family used with the key, The valid values are `rsa`, `oct`. | -| use | String | The **use** (public key use) parameter identifies the intended use of the public key. The **use** parameter is employed to indicate whether a public key is used for encrypting data or verifying the signature on data. Possible values are: `sig` (signature), `enc` (encryption) | -| x5c | string collection | The **x5c** (X.509 certificate chain) parameter contains a chain of one or more PKIX certificates [RFC 5280](https://tools.ietf.org/html/rfc5280). | -| x5t | string | The **x5t** (X.509 certificate SHA-1 thumbprint) parameter is a base64url-encoded SHA-1 thumbprint (also known as digest) of the DER encoding of an X.509 certificate [RFC 5280](https://tools.ietf.org/html/rfc5280). | -| e | string | RSA Key - public exponent | -| d| string | RSA Key - private exponent. Field can't be read back. | -| n | string | RSA Key - modulus | -| p | string | RSA Key - first prime. Field can't be read back. | -| q | string | RSA Key - second prime. Field can't be read back. | -| dp | string | RSA Key - first exponent. Field can't be read back. | -| dq | string | RSA Key - second exponent. Field can't be read back. | -| qi | string | RSA Key - Coefficient. Field can't be read back. | -| k | string | Symmetric Key for oct key type. Field can't be read back. | -| nbf | int | This value is a NumericDate as defined in RFC 7519 (A JSON numeric value representing the number of seconds from 1970-01-01T00:00:00Z UTC until the specified UTC date/time, ignoring leap seconds.) | -| exp | int | This value is a NumericDate as defined in RFC 7519 (A JSON numeric value representing the number of seconds from 1970-01-01T00:00:00Z UTC until the specified UTC date/time, ignoring leap seconds.) | --+|Property|Type|Description| +|:|:|:| +|d|String|RSA Key - private exponent. The field isn't readable.| +|dp|String|RSA Key - first exponent. The field isn't readable.| +|dq|String|RSA Key - second exponent. The field isn't readable.| +|e|String|RSA Key - public exponent. | +|exp|Int64|This value is a NumericDate as defined in RFC 7519. That is, a JSON numeric value representing the number of seconds from 1970-01-01T00:00:00Z UTC until the specified UTC date/time, ignoring leap seconds.| +|k|String|Symmetric Key for oct key type. The field isn't readable.| +|kid|String|The unique identifier for the key.| +|kty|String|The **kty** (key type) parameter identifies the cryptographic algorithm family used with the key. The valid values are `rsa`, `oct`.| +|n|String|RSA Key - modulus.| +|nbf|Int64|This value is a NumericDate as defined in RFC 7519. That is, a JSON numeric value representing the number of seconds from 1970-01-01T00:00:00Z UTC until the specified UTC date/time, ignoring leap seconds.| +|p|String|RSA Key - first prime. The field isn't readable.| +|q|String|RSA Key - second prime. The field isn't readable.| +|qi|String|RSA Key - Coefficient. The field isn't readable.| +|status|trustFrameworkKeyStatus|Status of the key. The possible values are: `enabled`, `disabled`, `unknownFutureValue`.| +|use|String|The **use** (public key use) parameter identifies the intended use of the public key. The **use** parameter is employed to indicate whether a public key is used for encrypting data or verifying the signature on data. Possible values are: `sig` (signature), `enc` (encryption).| +|x5c|String collection|The **x5c** (X.509 certificate chain) parameter contains a chain of one or more PKIX certificates. For more information, see [RFC 5280](https://tools.ietf.org/html/rfc5280).| +|x5t|String|The **x5t** (X.509 certificate SHA-1 thumbprint) parameter is a base64url-encoded SHA-1 thumbprint (also known as digest) of the DER encoding of an X.509 certificate. For more information, see [RFC 5280](https://tools.ietf.org/html/rfc5280).| ++## Relationships +None. ## JSON representation--Here's a JSON representation of the resource. -+The following JSON representation shows the resource type. <!-- { "blockType": "resource",- "optionalProperties": [ -- ], - "@odata.type": "microsoft.graph.trustFrameworkKey", - "baseType": null -}--> --```json + "@odata.type": "microsoft.graph.trustFrameworkKey" +} +--> +``` json {- "d": "String", - "dp": "String", - "dq": "String", - "e": "String", - "exp": 1024, + "@odata.type": "#microsoft.graph.trustFrameworkKey", "k": "String",- "kid": "String", + "x5c": [ + "String" + ], + "x5t": "String", "kty": "String",+ "use": "String", + "status": "String", + "exp": "Integer", + "nbf": "Integer", + "kid": "String (identifier)", + "e": "String", "n": "String",- "nbf": 1024, + "d": "String", "p": "String", "q": "String",- "qi": "String", - "use": "String", - "x5c": ["String"], - "x5t": "String" + "dp": "String", + "dq": "String", + "qi": "String" } ``` -<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98 -2019-02-04 14:57:30 UTC --> -<!-- { - "type": "#page.annotation", - "description": "trustFrameworkKey resource", - "keywords": "", - "section": "documentation", - "tocPath": "" -}--> -- |
v1.0 | Trustframeworkkeyset | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/trustframeworkkeyset.md | Title: "trustFrameworkKeySet resource type" description: "Represents a trust framework keyset/policy key."+ ms.localizationpriority: medium- -doc_type: "resourcePageType" # trustFrameworkKeySet resource type Namespace: microsoft.graph Represents a trust framework keyset/policy key. The Identity Experience framework stores the secrets, which can be used in the policies. The secrets can be passwords, certificates, or other files. In the portal, these entities are shown as `Policy keys`. The Identity Experience framework uses the JSON Web Key (JWK) standard for the keysets. This entity follows the format specified in [RFC 7517 Section 5](https://tools.ietf.org/html/rfc7517#section-5). -## Methods +Inherits from [entity](../resources/entity.md). -| Method | Return Type | Description | -|:-|:|:| -| [List](../api/trustframework-list-keysets.md) | [trustFrameworkKeySet](trustframeworkkeyset.md) Collection | List trustFrameworkKeySets. | -| [Create](../api/trustframework-post-keysets.md) | [trustFrameworkKeySet](trustframeworkkeyset.md) | Create trustFrameworkKeySet. | -| [Get](../api/trustframeworkkeyset-get.md) | [trustFrameworkKeySet](trustframeworkkeyset.md) | Read properties and relationships of trustFrameworkKeySet object. | -| [Update](../api/trustframeworkkeyset-update.md) | [trustFrameworkKeySet](trustframeworkkeyset.md) | Update trustFrameworkKeySet object. | -| [Delete](../api/trustframeworkkeyset-delete.md) | None | Delete trustFrameworkKeySet object. | -|[Generate key](../api/trustframeworkkeyset-generatekey.md)|[trustFrameworkKey](trustframeworkkey.md)| Generate a key in keyset. | -|[Get active key](../api/trustframeworkkeyset-getactivekey.md)|[trustFrameworkKey](trustframeworkkey.md)| Get currently active key in the keyset. | -|[Upload certificate](../api/trustframeworkkeyset-uploadcertificate.md)|[trustFrameworkKey](trustframeworkkey.md)| Upload a X.509 certificate. | -|[Upload PKCS12](../api/trustframeworkkeyset-uploadpkcs12.md)|[trustFrameworkKey](trustframeworkkey.md)| Upload a PKCS12 format certificate. | -|[Upload secret](../api/trustframeworkkeyset-uploadsecret.md)|[trustFrameworkKey](trustframeworkkey.md)| Upload a string based secret. | +## Methods +|Method|Return type|Description| +|:|:|:| +|[List](../api/trustframework-list-keysets.md)|[trustFrameworkKeySet](../resources/trustframeworkkeyset.md) collection|Get a list of the [trustFrameworkKeySet](../resources/trustframeworkkeyset.md) objects and their properties.| +|[Create](../api/trustframework-post-keysets.md)|[trustFrameworkKeySet](../resources/trustframeworkkeyset.md)|Create a new [trustFrameworkKeySet](../resources/trustframeworkkeyset.md) object.| +|[Get](../api/trustframeworkkeyset-get.md)|[trustFrameworkKeySet](../resources/trustframeworkkeyset.md)|Read the properties and relationships of a [trustFrameworkKeySet](../resources/trustframeworkkeyset.md) object.| +|[Update](../api/trustframeworkkeyset-update.md)|[trustFrameworkKeySet](../resources/trustframeworkkeyset.md)|Update the properties of a [trustFrameworkKeySet](../resources/trustframeworkkeyset.md) object.| +|[generateKey](../api/trustframeworkkeyset-generatekey.md)|[trustFrameworkKey](../resources/trustframeworkkey.md)|Generate a key in keyset.| +|[uploadSecret](../api/trustframeworkkeyset-uploadsecret.md)|[trustFrameworkKey](../resources/trustframeworkkey.md)|Upload a string based secret.| +|[getActiveKey](../api/trustframeworkkeyset-getactivekey.md)|[trustFrameworkKey](../resources/trustframeworkkey.md)|Get currently active key in the keyset.| +|[uploadCertificate](../api/trustframeworkkeyset-uploadcertificate.md)|[trustFrameworkKey](../resources/trustframeworkkey.md)|Upload a X.509 certificate.| +|[uploadPkcs12](../api/trustframeworkkeyset-uploadpkcs12.md)|[trustFrameworkKey](../resources/trustframeworkkey.md)|Upload a PKCS12 format certificate.| ## Properties--| Property | Type | Description | -|:-|:|:| -|id|String| Unique identifier of the trustframework keyset | -|keys|[trustFrameworkKey](trustframeworkkey.md) collection| A collection of the keys. | +|Property|Type|Description| +|:|:|:| +|id|String|Unique identifier of the trustframework keyset Inherited from [entity](../resources/entity.md).| +|keys|[trustFrameworkKey](../resources/trustframeworkkey.md) collection|A collection of the keys.| ## Relationships--None. +|Relationship|Type|Description| +|:|:|:| +|keys_v2|[trustFrameworkKey_v2](../resources/trustframeworkkey_v2.md) collection|A collection of the keys.| ## JSON representation--Here's a JSON representation of the resource. -+The following JSON representation shows the resource type. <!-- { "blockType": "resource",- "optionalProperties": [ -- ], + "keyProperty": "id", "@odata.type": "microsoft.graph.trustFrameworkKeySet",- "keyProperty": "id" -}--> --```json + "baseType": "microsoft.graph.entity", + "openType": false +} +--> +``` json {+ "@odata.type": "#microsoft.graph.trustFrameworkKeySet", "id": "String (identifier)",- "keys": [{"@odata.type": "microsoft.graph.trustFrameworkKey"}] + "keys": [ + { + "@odata.type": "microsoft.graph.trustFrameworkKey" + } + ] } ``` -<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98 -2019-02-04 14:57:30 UTC --> -<!-- { - "type": "#page.annotation", - "description": "trustFrameworkKeySet resource", - "keywords": "", - "section": "documentation", - "tocPath": "" -}--> -- |
v1.0 | Typedemailaddress | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/typedemailaddress.md | Represents the name, email addresses, and their corresponding email address type ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Unenforcedmfaawsuserfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/unenforcedmfaawsuserfinding.md | description: "View AWS local users without MFA." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Unifiedrbacresourceaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/unifiedrbacresourceaction.md | None. --> ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Unifiedrbacresourcenamespace | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/unifiedrbacresourcenamespace.md | Represents the namespace of the area or service such as Microsoft Entra ID, Intu |resourceActions|[unifiedRbacResourceAction](unifiedrbacresourceaction.md) collection|Operations that an authorized principal is allowed to perform.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Unifiedrolemanagementalertdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/unifiedrolemanagementalertdefinition.md | Inherits from [entity](../resources/entity.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Unifiedrolemanagementpolicyauthenticationcontextrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/unifiedrolemanagementpolicyauthenticationcontextrule.md | A type derived from the [unifiedRoleManagementPolicyRule](../resources/unifiedro None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Unifiedrolemanagementpolicyexpirationrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/unifiedrolemanagementpolicyexpirationrule.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Unifiedrolemanagementpolicyrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/unifiedrolemanagementpolicyrule.md | Inherits from [entity](../resources/entity.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Unknownsource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/unknownsource.md | description: "Represents an authorization system identity sourced from an unknow ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Updaterecordingstatusoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/updaterecordingstatusoperation.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Urlassessmentrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/urlassessmentrequest.md | Used to create and retrieve a URL threat assessment, derived from [threatAssessm ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Usageright | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/usageright.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | User | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/user.md | description: "Represents a Microsoft Entra user account. Inherits from directory ms.localizationpriority: high+ doc_type: resourcePageType This resource supports: | surname | String | The user's surname (family name or last name). Maximum length is 64 characters. <br><br>Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values). | | usageLocation | String | A two-letter country code (ISO standard 3166). Required for users that are assigned licenses due to legal requirements to check for availability of services in countries. Examples include: `US`, `JP`, and `GB`. Not nullable. <br><br>Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values).| | userPrincipalName | String | The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user's email name. The general format is alias@domain, where the domain must be present in the tenant's verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the **verifiedDomains** property of [organization](organization.md).<br>NOTE: This property can't contain accent characters. Only the following characters are allowed `A - Z`, `a - z`, `0 - 9`, `' . - _ ! # ^ ~`. For the complete list of allowed characters, see [username policies](/azure/active-directory/authentication/concept-sspr-policy#userprincipalname-policies-that-apply-to-all-user-accounts). <br><br>Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, `endsWith`) and `$orderby`.-| userType | String | A String value that can be used to classify user types in your directory, such as `Member` and `Guest`. <br><br>Supports `$filter` (`eq`, `ne`, `not`, `in`, and `eq` on `null` values). **NOTE:** For more information about the permissions for member and guest users, see [What are the default user permissions in Microsoft Entra ID?](/azure/active-directory/fundamentals/users-default-permissions?context=graph/context#member-and-guest-users) | +| userType | String | A String value that can be used to classify user types in your directory. The possible values are `Member` and `Guest`. <br><br>Supports `$filter` (`eq`, `ne`, `not`, `in`, and `eq` on `null` values). **NOTE:** For more information about the permissions for member and guest users, see [What are the default user permissions in Microsoft Entra ID?](/azure/active-directory/fundamentals/users-default-permissions?context=graph/context#member-and-guest-users) | > [!TIP] > Directory extensions and associated data are returned by default; schema extensions and associated data are returned only on `$select`; and open extensions and associated data are returned only on `$expand`. |
v1.0 | Useraccountinformation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/useraccountinformation.md | Inherits from [itemFacet](itemfacet.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Userflowapiconnectorconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/userflowapiconnectorconfiguration.md | Defines which APIs are called at specific points in the user flow. Each relatio ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.userFlowApiConnectorConfiguration" |
v1.0 | Userflowlanguageconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/userflowlanguageconfiguration.md | For [Azure Active Directory B2C user flows](/azure/active-directory-b2c/user-flo ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Userflowlanguagepage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/userflowlanguagepage.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Userregistrationfeaturecount | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/userregistrationfeaturecount.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Userregistrationfeaturesummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/userregistrationfeaturesummary.md | Represents the summary of users capable of multifactor authentication, self-serv |userRoles|includedUserRoles|The role type of the user. Possible values are: `all`, `privilegedAdmin`, `admin`, `user`, `unknownFutureValue`.| |userTypes|includedUserTypes|User type. Possible values are: `all`, `member`, `guest`, `unknownFutureValue`.| -The value `privilegedAdmin` consists of the following privileged admin roles: +The value `privilegedAdmin` consists of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): * Global Administrator * Security Administrator None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.userRegistrationFeatureSummary" |
v1.0 | Userregistrationmethodsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/userregistrationmethodsummary.md | Represents the summary of number of users registered for each authentication met |userRoles|includedUserRoles|The role type of the user. Possible values are: `all`, `privilegedAdmin`, `admin`, `user`, `unknownFutureValue`.| |userTypes|includedUserTypes|User type. Possible values are: `all`, `member`, `guest`, `unknownFutureValue`.| -The value `privilegedAdmin` consists of the following privileged admin roles: +The value `privilegedAdmin` consists of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): * Global Administrator * Security Administrator |
v1.0 | Users | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/users.md | description: "Build compelling app experiences based on users, their relationshi ms.localizationpriority: high + doc_type: conceptualPageType Last updated 03/01/2024 |
v1.0 | Usersecuritystate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/usersecuritystate.md | description: "Contains stateful information about the user account." ms.localizationpriority: medium + doc_type: resourcePageType |
v1.0 | Usersettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/usersettings.md | description: "The current user settings for content discovery. " ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Usertrainingcompletionsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/usertrainingcompletionsummary.md | + + Title: "userTrainingCompletionSummary resource type" +description: "Contains aggregate data about userss training progress." ++ms.localizationpriority: medium +++# userTrainingCompletionSummary resource type ++Namespace: microsoft.graph +++Contains aggregate data about userss training progress. ++## Properties +|Property|Type|Description| +|:|:|:| +|completedUsersCount|Int32|The number of users who completed all the trainings before the due date.| +|inProgressUsersCount|Int32|The number of users who started at least one training.| +|notCompletedUsersCount|Int32|The number of users who didn't complete all the trainings before the due date.| +|notStartedUsersCount|Int32|The number of users who didn't start any training.| +|previouslyAssignedUsersCount|Int32|The number of users who are already assigned the same training.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.userTrainingCompletionSummary" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.userTrainingCompletionSummary", + "notStartedUsersCount": "Integer", + "completedUsersCount": "Integer", + "inProgressUsersCount": "Integer", + "notCompletedUsersCount": "Integer", + "previouslyAssignedUsersCount": "Integer" +} +``` + |
v1.0 | Validationresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/validationresult.md | description: "Exposes the properties that specify the rules against which a user ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Verifieddomain | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/verifieddomain.md | description: "Specifies a domain for a tenant. The verifiedDomains property of t ms.localizationpriority: medium doc_type: resourcePageType -+ # verifiedDomain resource type Namespace: microsoft.graph Specifies a domain for a tenant. The **verifiedDomains** property of the [organization](organization.md) entity is a collection of **verifiedDomain** objects. - ## Properties -| Property | Type | Description | -|:-|:--|:-| -| capabilities | String | For example, `Email`, `OfficeCommunicationsOnline`. | -| isDefault | Boolean | `true` if this is the default domain associated with the tenant; otherwise, `false`. | -| isInitial | Boolean | `true` if this is the initial domain associated with the tenant; otherwise, `false`. | -| name | String | The domain name; for example, contoso.com`. | -| type | String | For example, `Managed`. | +| Property | Type | Description| +|||| +| capabilities | String | For example, `Email`, `OfficeCommunicationsOnline`. | +| isDefault | Boolean | `true` if this is the default domain associated with the tenant; otherwise, `false`. | +| isInitial | Boolean | `true` if this is the initial domain associated with the tenant; otherwise, `false`. | +| name | String | The domain name; for example, `contoso.com`. | +| type | String | For example, `Managed`. | ## JSON representation |
v1.0 | Verifiedpublisher | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/verifiedpublisher.md | Represents a verified publisher of an [application](application.md). For more in ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Verticalsection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/verticalsection.md | Inherits from [entity](../resources/entity.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Video | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/video.md | The properties of the **Video** resource are populated by extracting metadata fr ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Virtualendpoint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/virtualendpoint.md | Inherits from [entity](../resources/entity.md). |[Create cloudPcExternalPartnerSetting](../api/virtualendpoint-post-externalpartnersettings.md)|[cloudPcExternalPartnerSetting](../resources/cloudpcexternalpartnersetting.md)|Create a new [cloudPcExternalPartnerSetting](../resources/cloudpcexternalpartnersetting.md) object.| |[List frontLintServicePlans](../api/virtualendpoint-list-frontlineserviceplans.md) |[cloudPcFrontLineServicePlan](../resources/cloudpcfrontlineserviceplan.md) collection|Get a list of the [cloudPcFrontLineServicePlan](../resources/cloudpcfrontlineserviceplan.md) objects and their properties.| |[List sharedUseServicePlans](../api/virtualendpoint-list-shareduseserviceplans.md) (deprecated)|[cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) collection|List properties and relationships of the [cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) objects.|+|[List bulkActions](../api/virtualendpoint-list-bulkactions.md)|[cloudPcBulkAction](../resources/cloudpcbulkaction.md) collection|Get a list of the [cloudPcBulkAction](../resources/cloudpcbulkaction.md) objects and their properties.| +|[Create cloudPcBulkAction](../api/virtualendpoint-post-bulkactions.md)|[cloudPcBulkAction](../resources/cloudpcbulkaction.md)|Create a new [cloudPcBulkAction](../resources/cloudpcbulkaction.md) object.| ## Properties Inherits from [entity](../resources/entity.md). |Relationship|Type|Description| |:|:|:| |auditEvents|[cloudPcAuditEvent](../resources/cloudpcauditevent.md) collection|Cloud PC audit event.|+|bulkActions|[cloudPcBulkAction](../resources/cloudpcbulkaction.md) collection|Bulk actions applied to a Cloud PC.| |cloudPCs|[cloudPC](../resources/cloudpc.md) collection|Cloud managed virtual desktops.| |crossCloudGovernmentOrganizationMapping|[cloudPcCrossCloudGovernmentOrganizationMapping](../resources/cloudpccrosscloudgovernmentorganizationmapping.md)|Cloud PC organization mapping between public and US Government Community Cloud (GCC) organizations.| |deviceImages|[cloudPcDeviceImage](../resources/cloudpcdeviceimage.md) collection|The image resource on Cloud PC.| |
v1.0 | Virtualevent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/virtualevent.md | Title: "virtualEvent resource type" -description: "Information about a virtual event." +description: "Represents an abstract base type for a virtual event. " ms.localizationpriority: medium Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents a base virtual event. +Represents an abstract base type for a virtual event. -This is an abstract type. The base type of [virtualEventWebinar](virtualEventWebinar.md). +Base type of [virtualEventTownhall](virtualeventtownhall.md) and [virtualEventWebinar](virtualeventwebinar.md). Inherits from [entity](../resources/entity.md). > [!TIP]-> This is an abstract type and can't be used directly. Use the derived type [virtualEventWebinar](virtualEventWebinar.md) instead. +> This is an abstract type and can't be used directly. Use the derived types [virtualEventTownhall](virtualeventtownhall.md) or [virtualEventWebinar](virtualeventwebinar.md) instead. ++## Methods ++|Method|Return type|Description| +|:|:|:| +| [Cancel](../api/virtualevent-cancel.md) | None | Cancel a [virtualEventTownhall](../resources/virtualeventtownhall.md). This method is only available via the [virtualEventTownhall](virtualeventtownhall.md) resource.| +| [Publish](../api/virtualevent-publish.md) | None | Publish a [virtualEventTownhall](../resources/virtualeventtownhall.md). This method is only available via the [virtualEventTownhall](virtualeventtownhall.md) resource.| ## Properties Inherits from [entity](../resources/entity.md). |createdBy|[communicationsIdentitySet](communicationsidentityset.md)|Identity information for the creator of the virtual event. Inherited from [virtualEvent](../resources/virtualevent.md).| |description|[itemBody](../resources/itembody.md)|Description of the virtual event.| |displayName|String|Display name of the virtual event. |-|endDateTime|[dateTimeTimeZone](../resources/datetimetimezone.md)|End time of the virtual event. The **timeZone** property _can_ be set to any of the [time zones currently supported by Windows](/windows-hardware/manufacture/desktop/default-time-zones).| +|endDateTime|[dateTimeTimeZone](../resources/datetimetimezone.md)|End time of the virtual event. The **timeZone** property _can_ be set to any of the time zones currently supported by Windows. For details on how to get all available time zones using PowerShell, see [Get-TimeZone](/powershell/module/microsoft.powershell.management/get-timezone#example-3-get-all-available-time-zones).| |id|String|Unique identifier of the virtual event. Inherited from [entity](../resources/entity.md).|-|startDateTime|[dateTimeTimeZone](../resources/datetimetimezone.md)|Start time of the virtual event. The **timeZone** property _can_ be set to any of the [time zones currently supported by Windows](/windows-hardware/manufacture/desktop/default-time-zones).| -|status|virtualEventStatus|Status of the virtual event. The possible values are: `draft`, `published`, `canceled`, `unknownFutureValue`.| +|startDateTime|[dateTimeTimeZone](../resources/datetimetimezone.md)|Start time of the virtual event. The **timeZone** property _can_ be set to any of the time zones currently supported by Windows. For details on how to get all available time zones using PowerShell, see [Get-TimeZone](/powershell/module/microsoft.powershell.management/get-timezone#example-3-get-all-available-time-zones).| +|status|[virtualEventStatus](#virtualeventstatus-values)|Status of the virtual event. The possible values are: `draft`, `published`, `canceled`, `unknownFutureValue`.| ++### virtualEventStatus values ++| Value | Description | +| -- | -- | +| draft | The virtual event is in draft and only visible to the organizer. | +| published | The organizer published the virtual event and it's visible to the audience. | +| canceled | The organizer canceled the virtual event. | +| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | ## Relationships |
v1.0 | Virtualeventpresenter | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/virtualeventpresenter.md | Namespace: microsoft.graph Represents information about a presenter of a virtual event. +## Methods ++| Method | Return Type |Description | +| | -- | - | +| [List](../api/virtualevent-list-presenters.md) | [virtualEventPresenter](../resources/virtualeventpresenter.md) collection | Get the list of all [virtualEventPresenter](../resources/virtualeventpresenter.md) objects of a virtual event. | +| [Create](../api/virtualevent-post-presenters.md) | [virtualEventPresenter](../resources/virtualeventpresenter.md) | Create a new [virtualEventPresenter](../resources/virtualeventpresenter.md) object. | +| [Get](../api/virtualeventpresenter-get.md) | [virtualEventPresenter](../resources/virtualeventpresenter.md) | Read the properties and relationships of a [virtualEventPresenter](../resources/virtualeventpresenter.md) object. | +| [Delete](../api/virtualeventpresenter-delete.md) | None | Delete a [virtualEventPresenter](../resources/virtualeventpresenter.md) object. | + ## Properties |Property|Type|Description| |:|:|:| |email|String|Email address of the presenter.| |id|String|Unique identifier of the presenter. Inherited from [entity](../resources/entity.md).|-|identity|[identity](../resources/identity.md)|Identity information of the presenter. The supported identites are: [communicationsGuestIdentity](../resources/communicationsguestidentity.md) and [communicationsUserIdentity](../resources/communicationsuseridentity.md). | +|identity|[identity](../resources/identity.md)|Identity information of the presenter. The supported identities are: [communicationsGuestIdentity](../resources/communicationsguestidentity.md) and [communicationsUserIdentity](../resources/communicationsuseridentity.md). | |presenterDetails|[virtualEventPresenterDetails](../resources/virtualeventpresenterdetails.md)|Other detail information of the presenter.| ## JSON representation |
v1.0 | Virtualeventregistrationquestion | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/virtualeventregistrationquestion.md | Represents a registration question associated with a [virtualEventRegistration]( ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Virtualeventsession | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/virtualeventsession.md | Inherits from [onlineMeetingBase](../resources/onlinemeetingBase.md). |Relationship|Type|Description| |:|:|:|-|attendanceReports|[meetingAttendanceReport](../resources/meetingattendancereport.md) collection|Attendance reports of this virtual event session. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md).| +|attendanceReports|[meetingAttendanceReport](../resources/meetingattendancereport.md) collection|Attendance reports of this virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md).| ## JSON representation |
v1.0 | Virtualeventtownhall | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/virtualeventtownhall.md | + + Title: "virtualEventTownhall resource type" +description: "Represents information about a virtual event town hall." ++ms.localizationpriority: medium +++# virtualEventTownhall resource type ++Namespace: microsoft.graph +++Represents information about a virtual event town hall. ++Inherits from [virtualEvent](../resources/virtualevent.md). ++## Methods ++|Method|Return type|Description| +|:|:|:| +| [Create](../api/virtualeventsroot-post-townhalls.md) | [virtualEventTownhall](../resources/virtualeventtownhall.md) | Create a new [virtualEventTownhall](../resources/virtualeventtownhall.md) object. | +| [Get](../api/virtualeventtownhall-get.md) | [virtualEventTownhall](../resources/virtualeventtownhall.md) | Read the properties and relationships of a [virtualEventTownhall](../resources/virtualeventtownhall.md) object. | +| [Update](../api/virtualeventtownhall-update.md) | [virtualEventTownhall](../resources/virtualeventtownhall.md) | Update the properties of a [virtualEventTownhall](../resources/virtualeventtownhall.md) object. | +| [Publish](../api/virtualevent-publish.md) | None | Publish a [virtualEventTownhall](../resources/virtualeventtownhall.md).| +| [Cancel](../api/virtualevent-cancel.md) | None | Cancel a [virtualEventTownhall](../resources/virtualeventtownhall.md).| ++## Properties ++|Property|Type|Description| +|:|:|:| +| audience | [meetingAudience](#meetingaudience-values) | The audience to whom the town hall is visible. Possible values are: `everyone`, `organization`, `unknownFutureValue`. | +| coOrganizers | [communicationsUserIdentity](communicationsuseridentity.md) collection | Identity information of the coorganizers of the town hall. | +| createdBy | [communicationsIdentitySet](communicationsidentityset.md) | Identity information of the creator of the town hall. Inherited from [virtualEvent](../resources/virtualevent.md). Read-only. | +| description | [itemBody](../resources/itembody.md) | Description of the town hall. Inherited from [virtualEvent](../resources/virtualevent.md). | +| displayName | String | Display name of the town hall. Inherited from [virtualEvent](../resources/virtualevent.md). | +| endDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | Date and time when the town hall ends. The **timeZone** property _can_ be set to any of the time zones currently supported by Windows. For details on how to get all available time zones using PowerShell, see [Get-TimeZone](/powershell/module/microsoft.powershell.management/get-timezone#example-3-get-all-available-time-zones). Inherited from [virtualEvent](../resources/virtualevent.md). | +| id | String | Unique identifier of the town hall. Inherited from [entity](../resources/entity.md). Read-only. | +| invitedAttendees | [identity](../resources/identity.md) collection | The attendees invited to the town hall. The supported identites are: [communicationsUserIdentity](../resources/communicationsuseridentity.md) and [communicationsGuestIdentity](../resources/communicationsguestidentity.md). | +| isInviteOnly | Boolean | Indicates whether the town hall is only open to invited people and groups within your organization. The **isInviteOnly** property can only be `true` if the value of the **audience** property is set to `organization`. | +| startDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | Date and time when the town hall starts. The **timeZone** property _can_ be set to any of the time zones currently supported by Windows. For details on how to get all available time zones using PowerShell, see [Get-TimeZone](/powershell/module/microsoft.powershell.management/get-timezone#example-3-get-all-available-time-zones). Inherited from [virtualEvent](../resources/virtualevent.md). | +| status | [virtualEventStatus](#virtualeventstatus-values) | Status of the town hall. Possible values are: `draft`, `published`, `canceled`, `unknownFutureValue`. Inherited from [virtualEvent](../resources/virtualevent.md). | +### meetingAudience values ++| Value | Description | +| -- | -- | +| everyone | The town hall is open to anyone. Select this choice to include attendees from outside your organization. | +| organization | The town hall is open to people in your organization and guests of your organization. | +| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | ++### virtualEventStatus values ++| Value | Description | +| -- | -- | +| draft | The virtual event is in draft and only visible to the organizer. | +| published | The organizer published the virtual event and it's visible to the audience. | +| canceled | The organizer canceled the virtual event. | +| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | ++## Relationships ++|Relationship|Type|Description| +|:|:|:| +| presenters | [virtualEventPresenter](../resources/virtualeventpresenter.md) collection | Presenters' information of the town hall. Inherited from [virtualEvent](../resources/virtualevent.md).| +| sessions | [virtualEventSession](../resources/virtualeventsession.md) collection | Sessions of the town hall. Inherited from [virtualEvent](../resources/virtualevent.md). | ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.virtualEventTownhall", + "baseType": "microsoft.graph.virtualEvent", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.virtualEventTownhall", + "audience": "String", + "coOrganizers": [{"@odata.type": "microsoft.graph.communicationsUserIdentity"}], + "createdBy": {"@odata.type": "microsoft.graph.communicationsIdentitySet"}, + "description": {"@odata.type": "microsoft.graph.itemBody"}, + "displayName": "String", + "endDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"}, + "id": "String (identifier)", + "invitedAttendees": [{"@odata.type": "microsoft.graph.identity"}], + "isInviteOnly": "Boolean", + "startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"}, + "status": "String" +} +``` |
v1.0 | Virtualeventwebinar | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/virtualeventwebinar.md | Title: "virtualEventWebinar resource type" description: "Contains information about a virtual event webinar."-+ ms.localizationpriority: medium doc_type: resourcePageType Inherits from [virtualEvent](../resources/virtualevent.md). | createdBy | [communicationsIdentitySet](communicationsidentityset.md) | Identity information for the creator of the webinar. Inherited from [virtualEvent](../resources/virtualevent.md). | | description | [itemBody](../resources/itembody.md) | Description of the webinar. Inherited from [virtualEvent](../resources/virtualevent.md). | | displayName | String | Display name of the webinar. Inherited from [virtualEvent](../resources/virtualevent.md). |-| endDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | End time of the webinar. The **timeZone** property _can_ be set to any of the [time zones currently supported by Windows](/windows-hardware/manufacture/desktop/default-time-zones). Inherited from [virtualEvent](../resources/virtualevent.md). | -| startDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | Start time of the webinar. The **timeZone** property _can_ be set to any of the [time zones currently supported by Windows](/windows-hardware/manufacture/desktop/default-time-zones). Inherited from [virtualEvent](../resources/virtualevent.md). | +| endDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | End time of the webinar. The **timeZone** property _can_ be set to any of the time zones currently supported by Windows. For details on how to get all available time zones using PowerShell, see [Get-TimeZone](/powershell/module/microsoft.powershell.management/get-timezone#example-3-get-all-available-time-zones). | +| startDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | Start time of the webinar. The **timeZone** property _can_ be set to any of the time zones currently supported by Windows. For details on how to get all available time zones using PowerShell, see [Get-TimeZone](/powershell/module/microsoft.powershell.management/get-timezone#example-3-get-all-available-time-zones). | | id | String | Unique identifier of the webinar. Inherited from [entity](../resources/entity.md).| | status | [virtualEventStatus](#virtualeventstatus-values) | Status of the webinar. | Inherits from [virtualEvent](../resources/virtualevent.md). | Value | Description | | -- | -- |-| draft | The webinar is in draft and only visible to the organizer. | -| published | The organizer published the webinar and it's visible to the audience. | -| canceled | The organizer canceled the webinar. | +| draft | The virtual event is in draft and only visible to the organizer. | +| published | The organizer published the virtual event and it's visible to the audience. | +| canceled | The organizer canceled the virtual event. | | unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | ## Relationships | Relationship | Type | Description | | | - | -- |+| registrationConfiguration | [virtualEventWebinarRegistrationConfiguration](../resources/virtualeventwebinarregistrationconfiguration.md) | Registration configuration of the webinar. | | registrations | [virtualEventRegistration](../resources/virtualeventregistration.md) collection | Registration records of the webinar. | | sessions | [virtualEventSession](../resources/virtualeventsession.md) collection | Sessions of the webinar. Inherited from [virtualEvent](../resources/virtualevent.md). | The following JSON representation shows the resource type. "status": "String" } ```++## Related content ++[List meetingAttendanceReports](../api/meetingattendancereport-list.md) |
v1.0 | Virtualeventwebinarregistrationconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/virtualeventwebinarregistrationconfiguration.md | + + Title: "virtualEventWebinarRegistrationConfiguration resource type" +description: "Contains information about a webinar registration configuration." ++ms.localizationpriority: medium ++++# virtualEventWebinarRegistrationConfiguration resource type ++Namespace: microsoft.graph +++Contains information about a webinar registration configuration. ++Currently, the **virtualEventWebinarRegistrationConfiguration** resource inherits a subset of the properties and relationships from [virtualEventRegistrationConfiguration](../resources/virtualeventregistrationconfiguration.md). ++## Methods ++|Method|Return type|Description| +|:|:|:| +| [Get virtualEventWebinarRegistrationConfiguration](../api/virtualeventwebinarregistrationconfiguration-get.md) | [virtualEventWebinarRegistrationConfiguration](../resources/virtualeventwebinarregistrationconfiguration.md) | Read the properties and relationships of a [virtualEventWebinarRegistrationConfiguration](../resources/virtualeventwebinarregistrationconfiguration.md) object. | ++## Properties ++|Property|Type|Description| +|:|:|:| +| registrationWebUrl | String | Registration portal URL of the webinar. Inherited from [virtualEventRegistrationConfiguration](../resources/virtualeventregistrationconfiguration.md). | ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.virtualEventWebinarRegistrationConfiguration", + "baseType": "microsoft.graph.virtualEventRegistrationConfiguration", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.virtualEventWebinarRegistrationConfiguration", + "registrationWebUrl": "String" +} +``` |
v1.0 | Virtualmachinewithawsstoragebucketaccessfinding | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/virtualmachinewithawsstoragebucketaccessfinding.md | description: "View EC2 instances with S3 Bucket access." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Viva Learning Api Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/viva-learning-api-overview.md | The employee learning API in Microsoft Graph enables apps to make content from a ## How do integrations work? As administrators, you can integrate your content and learner records (employee assignments and completed course records) from your LMS or learning provider with Viva Learning, by using out-of-the-box integrations where Viva Learning can pull content metadata and learning records from your LMS or learning provider. You can also [use the employee learning API](#use-cases-for-the-employee-learning-api-in-microsoft-graph) in Microsoft Graph to push content metadata from your LMS or learning provider into Viva Learning. -When the content metadata, employee assignments, and their completed course records are uploaded to Viva Learning, they appear in Viva Learning at the following locations: -- The content appears on the home page under the **Browse courses** ΓÇô **Providers** section.-- Assignments and completed course records appear on the **My Learning** page under the **Assigned to you** and **Completed** sections, respectively.+When the content metadata, employee assignments, and their completed course records are uploaded to Viva Learning, they appear in Viva Learning in the following locations: ++- When the content metadata is synchronized, the content appears on the home page under the **Browse courses** ΓÇô **Providers** section. +- When the learning course activities are synchronized, assignments, recommendations, and self-learning course records appear on the **My Learning** tab. Based on progression, the status will move from **In Progress** to **Completed**. ++The learning course activities for the learners can be discovered outside of Viva Learning via APIs. ## Authorization With the appropriate delegated or application [employee learning permissions](/graph/permissions-reference#employee-learning-permissions), your app can use the employee learning API to manage learning providers and their content for a learning hub in a tenant. For more information about access tokens, app registration, and delegated and application permissions, see [Authentication and authorization basics](/graph/auth/auth-concepts). |
v1.0 | Voiceauthenticationmethodtarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/voiceauthenticationmethodtarget.md | A collection of groups enabled to use voice call authentication via the [voice c None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Vulnerabilitystate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/vulnerabilitystate.md | Contains stateful information about the vulnerability. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Watermarkprotectionvalues | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/watermarkprotectionvalues.md | These flags indicate that a watermark is enabled for this particular meeting. An ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Webapplication | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/webapplication.md | Specifies settings for a web application. |redirectUriSettings| [redirectUriSettings](redirecturisettings.md) collection | Specifies the index of the URLs where user tokens are sent for sign-in. This is only valid for applications using SAML.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Webpartdata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/webpartdata.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Website | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/website.md | Represents a web site. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Windows Setting Api Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/windows-setting-api-overview.md | + + Title: "Use the Windows settings API in Microsoft Graph" +description: "The Windows setting API enables users and authorized third parties acting on behalf of users to retrieve their Windows operating system settings data stored in the Microsoft cloud." +ms.localizationpriority: medium ++++# Use the Windows settings API in Microsoft Graph +++The Windows setting API enables users and authorized third parties acting on behalf of users to retrieve their Windows operating system settings data stored in the Microsoft cloud. The Windows settings data is available in the Microsoft cloud only when users activate the feature. The scope of data available for each user depends on their backup settings selections. The default values for any settings remain local and aren't transferred to the cloud. The Windows settings API only shares settings data that the user uploads to the cloud. ++## Windows settings ++The [**windowsSetting**](windowssetting.md) resource represents various Windows operating system settings that are stored in the cloud for a given user. Windows settings are of two types: `roaming` and `backup`. The **settingType** property of a [windowsSetting](../resources/windowssetting.md) object indicates the type of the setting. ++| Setting type | Description | +| :-- | : | +| roaming | The Windows setting is associated with a user's account. The setting is consistent across all devices and any changes to the setting value are synced or applied to all Windows devices that the user owns.| +| backup | The Windows setting doesn't roam or sync across devices. This type of setting is used in device backup and restore scenarios.| ++ A [windowsSetting](../resources/windowssetting.md) object of type `backup` might have a **windowsDeviceId** property that links the setting to a specific device. ++ The [List Windows settings](../api/usersettings-list-windows.md) API returns a collection of [windowsSetting](../resources/windowssetting.md) objects and their properties. You can filter the results by the **windowsDeviceId** and **settingType** properties. ++The [Get windowsSetting](../api/windowssetting-get.md) API allows you to pass the ID of a [windowsSetting](../resources/windowssetting.md) in the URL to read a specific Windows setting object. ++The following JSON representation shows an example of a **windowsSetting** resource type. The instances collection represents **windowsSettingInstance** objects. ++<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.windowsSetting", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.windowsSetting", + "id": "{67585f9f-ee4b-4dd8-808e-d88375d66ef7}$windows.data.apps.devicemetadata", + "windowsDeviceId": "67585f9f-ee4b-4dd8-808e-d88375d66ef7", + "settingType": "backup", + "payloadType": "windows.data.apps.devicemetadata", + "instances": [ + { + "id": "14b50191-10e5-4da5-9099-8c909b8458bd", + "payload": "VGhpcyBpcyBqdXN0IGFuIGV4YW1wbGUh", + "lastModifiedDateTime": "2024-10-31T23:30:41Z", + "createdDateTime": "2024-02-12T19:34:35.223Z", + "expirationDateTime": "2034-02-09T19:34:33.771Z" + } + ] +} +``` ++> [!Warning] +> The structure of the ID of a [**windowsSetting**](../resources/windowssetting.md) object is not guaranteed and the caller should not take any dependency on it. The ID should be treated as an opaque string. ++## Windows setting instances ++A [**windowsSettingInstance**](../resources/windowssettinginstance.md) represents a setting instance from the Windows operating system that is stored in the cloud for a given user. A [windowsSettingInstance](../resources/windowssettinginstance.md) belongs to a [windowsSetting](../resources/windowssetting.md). ++The following JSON representation shows an example of a **windowsSettingInstance** resource type. ++<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.windowsSettingInstance", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.windowsSettingInstance", + "id": "6984732f-86b0-8e31-dc02-37fce0df6d61", + "payload": "VGhpcyBpcyBhbm90aGVyIGp1c3QgYW4gZXhhbXBsZSE=", + "lastModifiedDateTime": "2024-10-31T23:30:41Z", + "createdDateTime": "2024-02-12T19:34:35.223Z", + "expirationDateTime": "2034-02-09T19:34:33.771Z" +} +``` ++The [List Windows setting instances](../api/windowssetting-list-instances.md) API returns a collection of [windowsSettingInstance](../resources/windowssettinginstance.md) objects and their properties. The API requires the ID of a [windowsSetting](../resources/windowssetting.md) in the URL to read the setting instances. ++The [Get Windows setting instance](../api/windowssettinginstance-get.md) API allows you to pass the ID of a [windowsSetting](../resources/windowssetting.md) and [windowsSettingInstance](../resources/windowssettinginstance.md) in the URL to read a specific windows setting instance object. ++The **payload** property of a [**windowsSettingInstance**](../resources/windowssettinginstance.md) contains the actual setting value. The **payload** is a string in Base64-encoded format. The **payloadType** property of the [**windowsSetting**](../resources/windowssetting.md) object indicates the type of the setting value. The **payload** when decoded is a JSON object, which differs from setting to setting and is specific to the **payloadType**. ++### payloadType property +The **payloadType** defines the structure of a [windowsSettingInstance](./windowssettinginstance.md) payload. Windows includes a number of payload types that represent distinct setting structures used by different operating system experiences. As Windows evolves, more payload types are created and onboarded to the cloud. Querying the API and exploring the settings that are available is the best way to learn about the various payload types. The users and admins have control over which settings are uploaded to the cloud and most components don't upload default settings that the user hasn't customized. ++The following example shows a **windowsSettingsInstance** object returned by the API. ++```json +{ + "id": "default$windows.data.fileexplorerclassic.advancedsettings", + "settingType": "roaming", + "payloadType": "windows.data.fileexplorerclassic.advancedsettings", + "instances": [ + { + "id": "d9a7f6e2-8c4b-4e3a-bf7c-1e5a9d8c6f4b", + "payload": "eyJtaWdyYXRlZEZyb21TU0YiOmZhbHNlLCJhbHdheXNTaG93TWVudXMiOmZhbHNlLCJmb2xkZXJDb250ZW50c0luZm9UaXAiOmZhbHNlLCJoaWRlRHJpdmVzV2l0aE5vTWVkaWEiOmZhbHNlLCJuYXZQYW5lRXhwYW5kVG9DdXJyZW50Rm9sZGVyIjpmYWxzZSwibmF2UGFuZVNob3dBbGxGb2xkZXJzIjpmYWxzZSwibmF2UGFuZVNob3dGYXZvcml0ZXMiOmZhbHNlLCJwZXJzaXN0QnJvd3NlcnMiOmZhbHNlLCJzaGFyaW5nV2l6YXJkT24iOmZhbHNlLCJzaG93RHJpdmVMZXR0ZXJzIjpmYWxzZSwic2hvd1ByZXZpZXdIYW5kbGVycyI6ZmFsc2UsInR5cGVBaGVhZCI6ZmFsc2UsInNob3dTdGF0dXNCYXIiOmZhbHNlLCJzaG93TGlicmFyaWVzIjpmYWxzZSwic2hvd0NvbXBDb2xvciI6ZmFsc2V9", + "lastModifiedDateTime": "2022-06-27T00:53:00Z", + "createdDateTime": "2024-02-13T19:51:15.8217101Z", + "expirationDateTime": "2034-02-10T19:51:14.813Z" + } + ] +} +``` ++In this example, the **payloadType** `windows.data.fileexplorerclassic.advancedsettings` represents some of the settings that the File Explorer backs up to the cloud. The Base64 payload can be decoded to a UTF-8 string to see the JSON representation of this object. ++The following example shows the payload decoded. ++```json +{ + "migratedFromSSF": false, + "alwaysShowMenus": false, + "folderContentsInfoTip": false, + "hideDrivesWithNoMedia": false, + "navPaneExpandToCurrentFolder": false, + "navPaneShowAllFolders": false, + "navPaneShowFavorites": false, + "persistBrowsers": false, + "sharingWizardOn": false, + "showDriveLetters": false, + "showPreviewHandlers": false, + "typeAhead": false, + "showStatusBar": false, + "showLibraries": false, + "showCompColor": false +} +``` ++Properties in the object are commonly a subset of those that are available in the user experience of the component because component owners decide which settings provide the most value when uploaded to the cloud. ++#### Payload types ++The payload types described in this section have a special role in the Windows settings backup process. ++#### windows.data.platform.backuprestore.deviceprofile ++The windows.data.platform.backuprestore.deviceprofile payload type is not a setting the user applied; this type records information about devices that have opted into settings backup features. The following properties on this object are useful for understanding the rest of the settings: ++- **deviceDisplayName** - The name of the computer. This setting is found in Windows system settings at "**Start** > **Settings** > **System**". +- **profileId** - An identifier used to link [**windowsSetting**](../resources/windowssetting.md) items to the device that uploaded them. This property corresponds to **windowsSetting.windowsDeviceId** and can be used as a filter to get settings for a specific device from the [List Windows settings](../api/usersettings-list-windows.md) API. ++The following example shows this resource type. ++```json +{ + "id": "default$windows.data.platform.backuprestore.deviceprofile$deviceprofiles", + "settingType": "backup", + "payloadType": "windows.data.platform.backuprestore.deviceprofile", + "instances": [ + { + "id": "73b1a0b8-262a-4804-592a-b82a3a2a0c0d", + "payload": "ewogICAgInByb2ZpbGVJZCI6ICJ7OTViM2EyYzgtNDgyYS00YTA2LTdiM2EtZGEyYTVhNGIyYzBmfSIsCiAgICAiZGV2aWNlRGlzcGxheU5hbWUiOiAiRVhBTVBMRVVTRVJERVNLVE9QIiwKICAgICJjcmVhdGVkQnkiOiAid2luZG93cyIsCiAgICAic291cmNlUHJvZmlsZUlkIjogIiIsCiAgICAiY3JlYXRlZFRpbWUiOiAxNjY0NjgwNTg5LAogICAgIm1vZGlmaWVkVGltZSI6IDE2OTg3OTUwNDAsCiAgICAiaXNBY3RpdmUiOiB0cnVlLAogICAgImxhc3RGdWxsQmFja3VwQ29tcGxldGVkVGltZSI6IDE2OTgzMzIxMzcsCiAgICAib3NWZXJzaW9uIjogIjE4MDQ1LjM3NTAudmJfcmVsZWFzZSIKfQ==", + "lastModifiedDateTime": "2023-10-31T23:30:40Z", + "createdDateTime": "2024-02-13T22:49:02.376Z", + "expirationDateTime": "2034-02-10T22:49:03.365Z" + } + ] +} +``` +The following example shows the payload decoded. ++```json +{ + "profileId": "{95b3a2c8-482a-4a06-7b3a-da2a5a4b2c0f}", + "deviceDisplayName": "EXAMPLEUSERDESKTOP", + "createdBy": "windows", + "sourceProfileId": "", + "createdTime": 1664680589, + "modifiedTime": 1698795040, + "isActive": true, + "lastFullBackupCompletedTime": 1698332137, + "osVersion": "18045.3750.vb_release" +} +``` ++#### windows.data.platform.settingsbackup.backupunitstore ++The **backupUnitStore** payload type settings are unique in that the actual settings value is a **blob** in the data property. This is because **backupUnitStore** settings are collected directly from the Windows registry, on disk files, or other at rest locations throughout Windows. These settings weren't designed to be interoperable with experiences other than the components that created them. They are exposed in this API for comprehensive coverage of all Windows settings that are stored in the cloud. |
v1.0 | Windowsapplication | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/windowsapplication.md | Represents settings for apps running Microsoft Windows and published in the Micr | redirectUris | String collection | Specifies the URLs where user tokens are sent for sign-in or the redirect URIs where OAuth 2.0 authorization codes and access tokens are sent. Only available for applications that support the `PersonalMicrosoftAccount` **signInAudience**. | ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Windowssetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/windowssetting.md | Inherits from [entity](../resources/entity.md). ## Methods |Method|Return type|Description| |:|:|:|-|[List Windows settings](../api/usersettings-list-windows.md)|[windowsSetting](../resources/windowssetting.md) collection|Get a list of the [windowsSetting](../resources/windowssetting.md) objects and their properties.| -|[Get windowsSetting](../api/windowssetting-get.md)|[windowsSetting](../resources/windowssetting.md)|Read the properties and relationships of a [windowsSetting](../resources/windowssetting.md) object.| +|[List](../api/usersettings-list-windows.md)|[windowsSetting](../resources/windowssetting.md) collection|Get a list of the [windowsSetting](../resources/windowssetting.md) objects and their properties.| +|[Get](../api/windowssetting-get.md)|[windowsSetting](../resources/windowssetting.md)|Read the properties and relationships of a [windowsSetting](../resources/windowssetting.md) object.| |[List instances](../api/windowssetting-list-instances.md)|[windowsSettingInstance](../resources/windowssettinginstance.md) collection|Read the properties and relationships of a [windowsSettingInstance](../resources/windowssettinginstance.md) object by passing the Windows setting ID and Windows setting instance ID in the URL.| ## Properties |
v1.0 | Windowsupdates Contentapplicabilitysettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/windowsupdates-contentapplicabilitysettings.md | Represents settings for governing whether content is applicable to a device. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.windowsUpdates.contentApplicabilitySettings" |
v1.0 | Windowsupdates Datedrivenrolloutsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/windowsupdates-datedrivenrolloutsettings.md | Inherits from [gradualRolloutSettings](../resources/windowsupdates-gradualrollou None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.windowsUpdates.dateDrivenRolloutSettings" |
v1.0 | Windowsupdates Durationdrivenrolloutsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/windowsupdates-durationdrivenrolloutsettings.md | Inherits from [gradualRolloutSettings](../resources/windowsupdates-gradualrollou None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.windowsUpdates.durationDrivenRolloutSettings" |
v1.0 | Windowsupdates Gradualrolloutsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/windowsupdates-gradualrolloutsettings.md | Represents settings for governing how to rollout content to devices. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.windowsUpdates.gradualRolloutSettings" |
v1.0 | Windowsupdates Qualityupdatecatalogentry | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/windowsupdates-qualityupdatecatalogentry.md | Inherits from [softwareUpdateCatalogEntry](../resources/windowsupdates-softwareu ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Windowsupdates Resourceconnection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/windowsupdates-resourceconnection.md | This resource type is abstract. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Windowsupdates Softwareupdatecatalogentry | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/windowsupdates-softwareupdatecatalogentry.md | This is an abstract type. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Workbookchart | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookchart.md | Represents a chart object in a workbook. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbookchartareaformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookchartareaformat.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Workbookchartaxes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookchartaxes.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Workbookchartaxis | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookchartaxis.md | Represents a single axis in a chart. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Workbookchartaxisformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookchartaxisformat.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Workbookchartaxistitle | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookchartaxistitle.md | Represents the title of a chart axis. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Workbookchartaxistitleformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookchartaxistitleformat.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Workbookchartdatalabelformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookchartdatalabelformat.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Workbookchartdatalabels | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookchartdatalabels.md | Represents a collection of all the data labels on a chart point. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Workbookchartfont | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookchartfont.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Workbookchartgridlines | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookchartgridlines.md | Represents major or minor gridlines on a chart axis. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbookchartgridlinesformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookchartgridlinesformat.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Workbookchartlegend | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookchartlegend.md | Represents the legend in a chart. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbookchartlegendformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookchartlegendformat.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Workbookchartlineformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookchartlineformat.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Workbookchartpoint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookchartpoint.md | Represents a point of a series in a chart. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Workbookchartpointformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookchartpointformat.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Workbookchartseries | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookchartseries.md | Represents a series in a chart. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbookchartseriesformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookchartseriesformat.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Workbookcharttitle | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookcharttitle.md | Represents a chart title object of a chart. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbookcharttitleformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookcharttitleformat.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Workbookfilter | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookfilter.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbookfiltercriteria | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookfiltercriteria.md | Represents the filtering criteria applied to a column. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbookicon | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookicon.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbookoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookoperation.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbookoperationerror | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookoperationerror.md | Represents an error from a failed workbook operation. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbookpivottable | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookpivottable.md | Represents an Excel PivotTable. |worksheet|[workbookWorksheet](workbookworksheet.md)| The worksheet containing the current PivotTable. Read-only. | ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbookrange | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookrange.md | Range represents a set of one or more contiguous cells such as a cell, a row, a ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbookrangeborder | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookrangeborder.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbookrangefill | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookrangefill.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbookrangefont | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookrangefont.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbookrangeformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookrangeformat.md | A format object encapsulating the range's font, fill, borders, alignment, and ot ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbookrangeview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookrangeview.md | RangeView represents a set of visible cells of the parent range. |rows|[workbookRangeView](workbookrangeview.md) collection| Represents a collection of range views associated with the range. Read-only. Read-only.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "optionalProperties": [ ], |
v1.0 | Workbooksessioninfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbooksessioninfo.md | Provides information about workbook session. ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbooksortfield | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbooksortfield.md | Represents a condition in a sorting operation. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbooktable | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbooktable.md | Represents an Excel table. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbooktablecolumn | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbooktablecolumn.md | Represents a column in a table. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbooktablesort | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbooktablesort.md | Manages sorting operations on Table objects. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbookworksheetprotection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookworksheetprotection.md | None. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbookworksheetprotectionoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookworksheetprotectionoptions.md | Represents the options in sheet protection. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workforceintegration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workforceintegration.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workinghours | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workinghours.md | appropriate time zone. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workplace | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workplace.md | + + Title: "workplace resource type" +description: "Represents a workplace in a tenant." ++ms.localizationpriority: medium +++# workplace resource type ++Namespace: microsoft.graph +++Represents a workplace in a tenant. ++## Methods ++|Method|Return type|Description| +|:|:|:| +|[List sensorDevices](../api/workplace-list-sensordevices.md)|[workplaceSensorDevice](../resources/workplacesensordevice.md) collection|Get a list of all workplace sensor devices created for a tenant.| +|[Create workplaceSensorDevice](../api/workplace-post-sensordevices.md)|[workplaceSensorDevice](../resources/workplacesensordevice.md)|Create a new sensor device.| ++## Properties ++None. ++## Relationships ++|Relationship|Type|Description| +|:|:|:| +|sensorDevices|[workplaceSensorDevice](../resources/workplacesensordevice.md) collection|A collection of sensor devices.| ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.workplace", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.workplace" +} +``` |
v1.0 | Workplacesensor | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workplacesensor.md | + + Title: "workplaceSensor resource type" +description: "Represents a sensor on hardware that collects and reports data on physical or environmental conditions, including occupancy, headcount, inferred occupancy, temperature, and more." ++ms.localizationpriority: medium +++# workplaceSensor resource type ++Namespace: microsoft.graph +++Represents a sensor on hardware that collects and reports data on physical or environmental conditions, including occupancy, headcount, inferred occupancy, temperature, and more. ++## Properties ++|Property|Type|Description| +|:|:|:| +|displayName|String|The display name of the sensor. Optional.| +|placeId|String| The unique identifier of the place that the sensor detects. If the device is installed in a room equipped with a mailbox, this property should match the **ExternalDirectoryObjectId** or Microsoft Entra object ID of the room mailbox. If the sensor detects the same place as the location of the device, the property can be omitted. The default value is the place identifier of the device. Optional. | +|sensorId|String| The user-defined unique identifier of the sensor on the device. If the device has multiple sensors of the same type, the property must be provided to identify each sensor. If the device has only one sensor of a type, the property can be omitted. The default value is the sensor type. Optional. | +|sensorType|[workplaceSensorType](../resources/workplacesensor.md#workplacesensortype-values)|The type of sensor. The possible values are: `occupancy`, `peopleCount`, `inferredOccupancy`, `heartbeat`, `unknownFutureValue`. Required. | ++### workplaceSensorType values ++| Member | Description | +|:-|:| +| occupancy | The sensor detects if the place is occupied or not. Use it for motion sensors or other binary sensors that measure occupancy of a place. | +| peopleCount | The sensor counts the number of people in the place. Use it for sensors that report people count as a number. | +| inferredOccupancy | The sensor estimates the occupancy status of the place based on other clues, such as the presence of a laptop or a backpack. Use it for sensors that don't directly detect motion or people count. | +| heartbeat | The sensor reports the heartbeat of the device. It indicates if the device is online or not. Use it for sensors that monitor the status of the device. | +| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | ++## Relationships ++None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.workplaceSensor" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.workplaceSensor", + "displayName": "String", + "placeId": "String", + "sensorId": "String", + "sensorType": "String" +} +``` + |
v1.0 | Workplacesensordevice | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workplacesensordevice.md | + + Title: "workplaceSensorDevice resource type" +description: "Represents hardware capable of hosting multiple sensors that collect and report data on physical or environmental conditions, including occupancy, headcount, inferred occupancy, temperature, and more." ++ms.localizationpriority: medium +++# workplaceSensorDevice resource type ++Namespace: microsoft.graph +++Represents hardware capable of hosting multiple sensors that collect and report data on physical or environmental conditions, including occupancy, headcount, inferred occupancy, temperature, and more. ++Inherits from [entity](../resources/entity.md). ++## Methods ++|Method|Return type|Description| +|:|:|:| +|[List sensorDevices](../api/workplace-list-sensordevices.md)|[workplaceSensorDevice](../resources/workplacesensordevice.md) collection|Get a list of all workplace sensor devices created for a tenant.| +|[Create workplaceSensorDevice](../api/workplace-post-sensordevices.md)|[workplaceSensorDevice](../resources/workplacesensordevice.md)|Create a new workplace sensor device.| +|[Get workplaceSensorDevice](../api/workplacesensordevice-get.md)|[workplaceSensorDevice](../resources/workplacesensordevice.md)|Get the properties of a workplace sensor device, including tags, MAC address, sensors, and more.| +|[Update workplaceSensorDevice](../api/workplacesensordevice-update.md)|[workplaceSensorDevice](../resources/workplacesensordevice.md)|Update the properties of a workplace sensor device.| +|[Delete workplaceSensorDevice](../api/workplacesensordevice-delete.md)|None|Delete a workplace sensor device.| +|[ingestTelemetry](../api/workplacesensordevice-ingesttelemetry.md)|None|Ingest sensor telemetry for a workplace sensor device.| ++## Properties ++|Property|Type|Description| +|:|:|:| +|description|String| The description of the device. | +|deviceId|String| The user-defined unique identifier of the device provided at the time of creation. | +|displayName|String| The display name of the device. | +|id|String| The unique identifier of the device. It's system generated and a user can't change it. Inherited from [entity](../resources/entity.md).| +|ipV4Address|String| The IPv4 address of the device. | +|ipV6Address|String| The IPv6 address of the device. | +|macAddress|String| The MAC address of the device. | +|manufacturer|String| The manufacturer of the device. | +|placeId|String| The unique identifier of the place where the device is located. If the device is installed in a room equipped with a mailbox, this property should match the **ExternalDirectoryObjectId** or Microsoft Entra object ID of the room mailbox. | +|sensors|[workplaceSensor](../resources/workplacesensor.md) collection| A list of sensors associated with the device that collect and report data about physical or environmental conditions, such as occupancy, people count, inferred occupancy, temperature, and more. | +|tags|String collection| A list of custom tags associated with the device. | ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.workplaceSensorDevice", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.workplaceSensorDevice", + "description": "String", + "deviceId": "String", + "displayName": "String", + "id": "String (identifier)", + "ipV4Address": "String", + "ipV6Address": "String", + "macAddress": "String", + "manufacturer": "String", + "placeId": "String", + "sensors": [{"@odata.type": "microsoft.graph.workplaceSensor"}], + "tags": ["String"] +} +``` |
v1.0 | Workplacesensordevicetelemetry | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workplacesensordevicetelemetry.md | + + Title: "workplaceSensorDeviceTelemetry resource type" +description: "Represents the data collected and reported by a sensor on a device, such as occupancy, people count, inferred occupancy, temperature, and more." ++ms.localizationpriority: medium +++# workplaceSensorDeviceTelemetry resource type ++Namespace: microsoft.graph +++Represents the data collected and reported by a sensor on a device, such as occupancy, people count, inferred occupancy, temperature, and more. ++## Properties ++|Property|Type|Description| +|:|:|:| +|boolValue|Boolean|The value of the sensor can be `true` or `false`. Use it for sensors that report binary values, such as occupancy or heartbeat.| +|deviceId|String|The user-defined unique identifier of the device provided at the time of creation. Don't use the system generated identifier of the device.| +|intValue|Int32|The value of the sensor as an integer. Use it for sensors that report numerical values, such as people count. | +|sensorId|String|The user-defined unique identifier of the sensor on the device. Optional. If the device has multiple sensors of the same type, the property must be provided to identify each sensor. If the device has unique sensor types, the property can be omitted. The default value is the sensor type.| +|sensorType|[workplaceSensorType](../resources/workplacesensor.md#workplacesensortype-values)| The type of sensor. The possible values are: `occupancy`, `peopleCount`, `inferredOccupancy`, `heartbeat`, `unknownFutureValue`.| +|timestamp|DateTimeOffset|The date and time when the sensor measured and reported its value. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. | ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.workplaceSensorDeviceTelemetry" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.workplaceSensorDeviceTelemetry", + "boolValue": "Boolean", + "deviceId": "String", + "intValue": "Int32", + "sensorId": "String", + "sensorType": "String", + "timestamp": "String (timestamp)" +} +``` |
v1.0 | Accesspackage Delete Incompatibleaccesspackage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/accesspackage-delete-incompatibleaccesspackage.md | DELETE https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement [!INCLUDE [sample-code](../includes/snippets/php/remove-incompatibleaccesspackage-from-accesspackage-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -# [PowerShell](#tab/powershell) - # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/remove-incompatibleaccesspackage-from-accesspackage-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Accesspackage Delete Incompatiblegroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/accesspackage-delete-incompatiblegroup.md | DELETE https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement [!INCLUDE [sample-code](../includes/snippets/php/remove-incompatiblegroup-from-accesspackage-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -# [PowerShell](#tab/powershell) - # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/remove-incompatiblegroup-from-accesspackage-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Adminconsentrequestpolicy Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/adminconsentrequestpolicy-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "adminconsentrequestpolicy_get" } --> [!INCLUDE [permissions-table](../includes/permissions/adminconsentrequestpolicy-get-permissions.md)] -When calling on behalf of a user, the user needs to belong to one of the following directory roles. To learn more about directory roles, see [Microsoft Entra built-in roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): -+ Global Administrator +When calling on behalf of a user, the user needs to belong to at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): + + Global Reader + Cloud Application Administrator + Application Administrator |
v1.0 | Adminconsentrequestpolicy Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/adminconsentrequestpolicy-update.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "adminconsentrequestpolicy_update" } --> [!INCLUDE [permissions-table](../includes/permissions/adminconsentrequestpolicy-update-permissions.md)] -When calling on behalf of a user, the user needs to belong to the [Global Administrator](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) directory role. +For delegated scenarios, the calling user needs to belong to at least the *Application Administrator* or *Cloud Application Administrator* [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request |
v1.0 | Administrativeunit Delete Members | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/administrativeunit-delete-members.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "administrativeunit_delete_members" } --> [!INCLUDE [permissions-table](../includes/permissions/administrativeunit-delete-members-permissions.md)] -To remove a member from an administrative unit, the calling principal must be assigned one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): --* Privileged Role Administrator -* Global Administrator +To remove a member from an administrative unit, the calling principal must be assigned at least the *Privileged Role Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Administrativeunit Delete Scopedrolemembers | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/administrativeunit-delete-scopedrolemembers.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "administrativeunit_delete_scopedrolemembers" } --> [!INCLUDE [permissions-table](../includes/permissions/administrativeunit-delete-scopedrolemembers-permissions.md)] -To remove a role assignment from an administrative unit, the calling principal must be assigned one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): --* Privileged Role Administrator -* Global Administrator +To remove a role assignment from an administrative unit, the calling principal must be assigned at least the *Privileged Role Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Administrativeunit Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/administrativeunit-delete.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "administrativeunit_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/administrativeunit-delete-permissions.md)] -To delete an administrative unit, the calling principal must be assigned one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): --* Privileged Role Administrator -* Global Administrator +To delete an administrative unit, the calling principal must be assigned at least the *Privileged Role Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Administrativeunit Post Members | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/administrativeunit-post-members.md | One of the following permissions is required to call this API. To learn more, in |Delegated (personal Microsoft account) | Not supported. | |Application | AdministrativeUnit.ReadWrite.All | -To add a user, group, or device to an administrative unit, the calling principal must be assigned one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): --* Privileged Role Administrator -* Global Administrator +To add a user, group, or device to an administrative unit, the calling principal must be assigned at least the *Privileged Role Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ### Permissions to create a new group <!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. --> To add a user, group, or device to an administrative unit, the calling principal |Delegated (personal Microsoft account) | Not supported. | |Application | Group.Create, Group.ReadWrite.All, Directory.ReadWrite.All | -To create a new group in an administrative unit, the calling principal must be assigned one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): +To create a new group in an administrative unit, the calling principal must be assigned at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): * Privileged Role Administrator-* Global Administrator * Groups Administrator ## HTTP request Content-type: application/json { "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groups/$entity",- "id": "45b7d2e7-b882-4a80-ba97-10b7a63b8fa4", - "deletedDateTime": null, - "classification": null, - "createdDateTime": "2018-12-22T02:21:05Z", - "description": "Self help community for golf", - "displayName": "Golf Assist", - "expirationDateTime": null, - "groupTypes": [ - "Unified" - ], + "id": "45b7d2e7-b882-4a80-ba97-10b7a63b8fa4", + "deletedDateTime": null, + "classification": null, + "createdDateTime": "2018-12-22T02:21:05Z", + "description": "Self help community for golf", + "displayName": "Golf Assist", + "expirationDateTime": null, + "groupTypes": [ + "Unified" + ], "isAssignableToRole": null,- "mail": "golfassist@contoso.com", - "mailEnabled": true, - "mailNickname": "golfassist", - "membershipRule": null, - "membershipRuleProcessingState": null, - "onPremisesLastSyncDateTime": null, - "onPremisesSecurityIdentifier": null, - "onPremisesSyncEnabled": null, - "preferredDataLocation": "CAN", - "preferredLanguage": null, - "proxyAddresses": [ - "SMTP:golfassist@contoso.com" - ], - "renewedDateTime": "2018-12-22T02:21:05Z", - "resourceBehaviorOptions": [], - "resourceProvisioningOptions": [], - "securityEnabled": false, - "securityIdentifier": "S-1-12-1-1753967289-1089268234-832641959-555555555", - "theme": null, - "visibility": "Public", - "onPremisesProvisioningErrors": [] + "mail": "golfassist@contoso.com", + "mailEnabled": true, + "mailNickname": "golfassist", + "membershipRule": null, + "membershipRuleProcessingState": null, + "onPremisesLastSyncDateTime": null, + "onPremisesSecurityIdentifier": null, + "onPremisesSyncEnabled": null, + "preferredDataLocation": "CAN", + "preferredLanguage": null, + "proxyAddresses": [ + "SMTP:golfassist@contoso.com" + ], + "renewedDateTime": "2018-12-22T02:21:05Z", + "resourceBehaviorOptions": [], + "resourceProvisioningOptions": [], + "securityEnabled": false, + "securityIdentifier": "S-1-12-1-1753967289-1089268234-832641959-555555555", + "theme": null, + "visibility": "Public", + "onPremisesProvisioningErrors": [] } ``` |
v1.0 | Administrativeunit Post Scopedrolemembers | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/administrativeunit-post-scopedrolemembers.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "administrativeunit_post_scopedrolemembers" } --> [!INCLUDE [permissions-table](../includes/permissions/administrativeunit-post-scopedrolemembers-permissions.md)] -To assign Microsoft Entra roles with an administrative unit scope, the calling principal must be assigned one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): --* Privileged Role Administrator -* Global Administrator +To assign Microsoft Entra roles with an administrative unit scope, the calling principal must be assigned at least the *Privileged Role Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Administrativeunit Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/administrativeunit-update.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "administrativeunit_update" } --> [!INCLUDE [permissions-table](../includes/permissions/administrativeunit-update-permissions.md)] -To update an administrative unit, the calling principal must be assigned one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): --* Privileged Role Administrator -* Global Administrator +To update an administrative unit, the calling principal must be assigned at least the *Privileged Role Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Appcatalogs List Teamsapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/appcatalogs-list-teamsapps.md | doc_type: apiPageType Namespace: microsoft.graph List [apps](../resources/teamsapp.md) from the Microsoft Teams app catalog.-This includes apps from the Microsoft Teams store, as well as apps from your organization's app catalog (the tenant app catalog). To get apps from your organization's app catalog only, specify `organization` as the **distributionMethod** in the request. +This includes apps from the Microsoft Teams store and apps from your organization's app catalog (the tenant app catalog). To get apps from your organization's app catalog only, specify `organization` as the **distributionMethod** in the request. > [!NOTE] > In general, the **id** of a **teamsApp** resource is generated by the server. It is not the same as the **id** specified in a Teams app manifest, unless its **distributionMethod** is `store`. For other cases, the **id** provided by the developer as part of the Teams app manifest is stamped as the **externalId** in the **teamsApp** resource. Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "appcatalogs_list_teamsapps" } --> [!INCLUDE [permissions-table](../includes/permissions/appcatalogs-list-teamsapps-permissions.md)] -> **Note**: -The Directory.Read.All and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission and avoid using these permissions going forward. +> [!NOTE] +> The Directory.Read.All and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission and avoid using these permissions going forward. ## HTTP request GET /appCatalogs/teamsApps This method supports the `$filter`, `$select`, and `$expand` [OData query parameters](/graph/query-parameters) to help customize the response. -Using `$expand=AppDefinitions` will return more information about the state of the app, such as the **publishingState**, which reflects the app submission review status and returns whether an app has been approved, rejected, or remains under review. +Using `$expand=AppDefinitions` returns more information about the state of the app, such as the **publishingState**, which reflects the app submission review status and returns whether an app is approved, rejected, or remains under review. > **Note:** You can filter on any of the fields of the [teamsApp](../resources/teamsapp.md) object to shorten the list of results. You can use any of the following filter operations: Equal, not-equal, and, or, and not. Content-Type: application/json ### Example 4: List applications with a given ID, and return the submission review state -The following example lists applications with a given ID, and expands **appDefinitions** to return the **publishingState**, which reflects the app's submission review state. `Submitted` means the review is pending, `published` means the app was approved by the admin, and `rejected` means the app was rejected by the admin. +The following example lists applications with a given ID, and expands **appDefinitions** to return the **publishingState**, which reflects the app's submission review state. `Submitted` means the review is pending, `published` means the admin approved the app, and `rejected` means the admin rejected the app. #### Request |
v1.0 | Application Addpassword | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/application-addpassword.md | Title: "application: addPassword" description: "Add a strong password to an application." ms.localizationpriority: medium-+ doc_type: "apiPageType" doc_type: "apiPageType" Namespace: microsoft.graph -Adds a strong password or secret to an [application](../resources/application.md). +Adds a strong password or secret to an [application](../resources/application.md). You can also [add passwords while creating the application](../api/application-post-applications.md#example-2-create-a-new-application-and-add-a-password-secret). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] POST /applications(appId='{appId}')/addPassword In the request body, provide an optional `passwordCredential` object with the following properties. -| Property | Type |Description| +| Property | Type |Description| |:|:--|:-| | displayName | String | Friendly name for the password. Optional. | | endDateTime | DateTimeOffset | The date and time at which the password expires represented using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Optional. The default value is "startDateTime + 2 years". | |
v1.0 | Application List Extensionproperty | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/application-list-extensionproperty.md | Title: "List extensionProperties (directory extensions)" description: "Retrieve a list of directory extension definitions." ms.localizationpriority: medium + doc_type: "apiPageType" |
v1.0 | Application Post Applications | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/application-post-applications.md | Namespace: microsoft.graph Create a new [application](../resources/application.md) object. > [!IMPORTANT]-> Adding [**passwordCredential**](../resources/passwordcredential.md) when creating applications is not supported. Use the [addPassword](application-addpassword.md) method to add passwords or secrets for an application. > > Do not share application client IDs (**appId**) in API documentation or code samples. In the request body, supply a JSON representation of [application](../resources/ If successful, this method returns `201 Created` response code and an [application](../resources/application.md) object in the response body. ## Examples-### Request ++### Example 1: Create an application with the default settings ++#### Request The following example shows a request. Content-type: application/json -### 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 new application and add a password secret ++#### Request ++```http +POST https://graph.microsoft.com/v1.0/applications +Content-type: application/json ++{ + "displayName": "MyAppName", + "passwordCredentials": [ + { + "displayName": "Password name" + } + ] +} +``` ++#### Response ++The following example shows the response. The **secretText** property in the response object contains the strong passwords or secret generated by Microsoft Entra ID and is 16-64 characters in length. There is no way to retrieve this password in the future. ++> **Note**: The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.passwordCredential" +} --> ++```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#applications/$entity", + "id": "83ab4737-da9d-4084-86f2-f8fbec220647", + "deletedDateTime": null, + "appId": "9519e58c-bd06-4120-a7fd-2220d4de8409", + "applicationTemplateId": null, + "disabledByMicrosoftStatus": null, + "createdDateTime": "2024-04-01T19:10:02.6626202Z", + "displayName": "MyAppName", + "description": null, + "keyCredentials": [], + "parentalControlSettings": { + "countriesBlockedForMinors": [], + "legalAgeGroupRule": "Allow" + }, + "passwordCredentials": [ + { + "customKeyIdentifier": null, + "displayName": "Password name", + "endDateTime": "2026-04-01T19:10:02.6576213Z", + "hint": "puE", + "keyId": "09a0c91a-1bc3-4eaf-a945-c88c041fad6c", + "secretText": "1234567890abcdefghijklmnopqrstuvwxyzabcd", + "startDateTime": "2024-04-01T19:10:02.6576213Z" + } + ], + "publicClient": { + "redirectUris": [] + } +} +``` + <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!-- |
v1.0 | Application Post Calls | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/application-post-calls.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "application_post_calls" } --> [!INCLUDE [permissions-table](../includes/permissions/application-post-calls-permissions.md)] -> **Notes:** +> [!NOTE] > - For a call with app-hosted media, you need the Calls.AccessMedia.All permission in addition to one of the permissions listed in the previous table.-> - Cloud Video Interop solutions that are [Certified for Microsoft Teams](/MicrosoftTeams/cloud-video-interop) have permission to call this API to join meetings for which they have meeting join links, similar to external users joining through a browser. > - The Calls.JoinGroupCalls.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +Cloud Video Interop solutions that are [Certified for Microsoft Teams](/MicrosoftTeams/cloud-video-interop) have permission to call this API to join meetings for which they have meeting join links, similar to external users joining through a browser. + ## HTTP request <!-- { "blockType": "ignored" } --> ```http |
v1.0 | Application Post Extensionproperty | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/application-post-extensionproperty.md | Title: "Create extensionProperty (directory extension)" description: "Create a new directory extension." ms.localizationpriority: medium + doc_type: "apiPageType" |
v1.0 | Application Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/application-update.md | In the request body, supply the values for relevant fields that should be update | spa | [spaApplication](../resources/spaapplication.md) | Specifies settings for a single-page application, including sign out URLs and redirect URIs for authorization codes and access tokens. | | tags | String collection | Custom strings that can be used to categorize and identify the application. Not nullable. | | tokenEncryptionKeyId | String | Specifies the keyId of a public key from the keyCredentials collection. When configured, Microsoft Entra ID encrypts all the tokens it emits by using the key this property points to. The application code that receives the encrypted token must use the matching private key to decrypt the token before it can be used for the signed-in user. |+| uniqueName | String | The unique identifier that can be assigned to an application and used as an alternate key. Can updated only if `null` and is immutable once set. | | web | [webApplication](../resources/webapplication.md) | Specifies settings for a web application. | ## Response |
v1.0 | Application Upsert | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/application-upsert.md | + + Title: "Upsert application" +description: "Create a new application object if it doesn't exist, or update the properties of an existing application object." ++ms.localizationpriority: medium ++++# Upsert application ++Namespace: microsoft.graph ++Create a new [application](../resources/application.md) object if it doesn't exist, or update the properties of an existing [application](../resources/application.md) object. ++> [!IMPORTANT] +> Using PATCH to set [**passwordCredential**](../resources/passwordcredential.md) is not supported. Use the [addPassword](./application-addpassword.md) and [removePassword](./application-removepassword.md) methods to update the password or secret for an application. +++## 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": "application_post_applications" } --> ++## HTTP request ++To create or update an application, specify the **uniqueName** client-provided alternate key. ++<!-- { "blockType": "ignored" } --> +```http +PATCH /applications(uniqueName='{uniqueName}') +``` ++## Request headers +| Name | Description| +|:--|:-| +| Authorization | Bearer {token}. Required. | +| Content-Type | application/json. Required. | +| Prefer | `create-if-missing`. Required for upsert behavior, otherwise the request is treated as an update operation. | ++## Request body ++In the request body, supply a JSON representation of the [application](../resources/application.md) object. The request body must contain **displayName**, which is a required property. Specify other writable properties as necessary for your application, for creation or update. ++## Response ++If successful, if an application object with **uniqueName** doesn't exist, this method returns a `201 Created` response code and a new [application](../resources/application.md) object in the response body. ++If an application object with **uniqueName** already exists, this method updates the [application](../resources/application.md) object and returns a `204 No Content` response code. ++## Examples ++### Example 1: Create a new application if it doesn't exist ++The following example creates an application because an application with the specified **uniqueName** value doesn't exist. ++#### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "upsert_application_create" +} +--> ++``` http +PATCH https://graph.microsoft.com/v1.0/applications(uniqueName='app-65278') +Content-Type: application/json +Prefer: create-if-missing ++{ + "displayName": "Display name" +} +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) ++++### 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.application" +} +--> ++```http +HTTP/1.1 201 Created +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#applications/$entity", + "id": "03ef14b0-ca33-4840-8f4f-d6e91916010e", + "deletedDateTime": null, + "isFallbackPublicClient": null, + "appId": "631a96bc-a705-4eda-9f99-fdaf9f54f6a2", + "applicationTemplateId": null, + "identifierUris": [], + "createdDateTime": "2019-09-17T19:10:35.2742618Z", + "displayName": "Display name", + "isDeviceOnlyAuthSupported": null, + "groupMembershipClaims": null, + "optionalClaims": null, + "addIns": [], + "publisherDomain": "contoso.onmicrosoft.com", + "samlMetadataUrl": "https://graph.microsoft.com/2h5hjaj542de/app", + "signInAudience": "AzureADandPersonalMicrosoftAccount", + "tags": [], + "tokenEncryptionKeyId": null, + "api": { + "requestedAccessTokenVersion": 2, + "acceptMappedClaims": null, + "knownClientApplications": [], + "oauth2PermissionScopes": [], + "preAuthorizedApplications": [] + }, + "appRoles": [], + "publicClient": { + "redirectUris": [] + }, + "info": { + "termsOfServiceUrl": null, + "supportUrl": null, + "privacyStatementUrl": null, + "marketingUrl": null, + "logoUrl": null + }, + "keyCredentials": [], + "parentalControlSettings": { + "countriesBlockedForMinors": [], + "legalAgeGroupRule": "Allow" + }, + "passwordCredentials": [], + "requiredResourceAccess": [], + "uniqueName": "app-65278", + "web": { + "redirectUris": [], + "homePageUrl": null, + "logoutUrl": null, + "implicitGrantSettings": { + "enableIdTokenIssuance": false, + "enableAccessTokenIssuance": false + } + }, + "windows" : null +} +``` ++### Example 2: Update an existing application ++The following example updates the application because an application with the specified **uniqueName** value exists. ++#### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "application_upsert_update" +} +--> ++``` http +PATCH https://graph.microsoft.com/v1.0/applications(uniqueName='app-65278') +Content-Type: application/json +Prefer: create-if-missing ++{ + "displayName": "Display name" +} +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) ++++#### Response ++The following example shows the response. +<!-- { + "blockType": "response" +} +--> ++``` http +HTTP/1.1 204 No Content +``` |
v1.0 | Applicationtemplate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/applicationtemplate-get.md | Title: 'Get applicationTemplate' description: 'Retrieve the properties and relationships of applicationtemplate object.' ms.localizationpriority: medium-++ doc_type: apiPageType |
v1.0 | Applicationtemplate List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/applicationtemplate-list.md | Title: 'List applicationTemplates' description: 'Retrieve a list of applicationtemplate objects.' ms.localizationpriority: medium-++ doc_type: apiPageType |
v1.0 | Authenticationeventlistener Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationeventlistener-delete.md | + + Title: "Delete authenticationEventListener" +description: "Delete an authenticationEventListener object." ++ms.localizationpriority: medium ++++# Delete authenticationEventListener +Namespace: microsoft.graph ++Delete an [authenticationEventListener](../resources/authenticationeventlistener.md) object. +++## 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": "authenticationeventlistener_delete" } --> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /identity/authenticationEventListeners/{authenticationEventListenerId} +``` ++## 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 `204 No Content` response code. ++## Examples ++### Request +The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_authenticationeventlistener" +} +--> +``` http +DELETE https://graph.microsoft.com/v1.0/identity/authenticationEventListeners/c7a1f2c5-3d36-4b3f-b75c-143af30a5246 +``` ++# [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. +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Authenticationeventlistener Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationeventlistener-get.md | + + Title: "Get authenticationEventListener" +description: "Read the properties and relationships of an authenticationEventListener object." ++ms.localizationpriority: medium ++++# Get authenticationEventListener +Namespace: microsoft.graph ++Read the properties and relationships of an [authenticationEventListener](../resources/authenticationeventlistener.md) object. The **@odata.type** property in the response object indicates the type of the authenticationEventListener object. +++## 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": "authenticationeventlistener_get" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /identity/authenticationEventListeners/{authenticationEventListenerId} +``` ++## Optional query parameters +This method does not support 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 an [authenticationEventListener](../resources/authenticationeventlistener.md) object in the response body. ++## Examples ++### Request +The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_authenticationeventlistener" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/identity/authenticationEventListeners/6fc5012e-7665-43d6-9708-4370863f4e6e +``` ++# [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. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.authenticationEventListener" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identity/authenticationEventListeners/$entity", + "@odata.type": "#microsoft.graph.onTokenIssuanceStartListener", + "id": "6fc5012e-7665-43d6-9708-4370863f4e6e", + "conditions": { + "applications": { + "includeApplications@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identity/authenticationEventListeners('6fc5012e-7665-43d6-9708-4370863f4e6e')/microsoft.graph.onTokenIssuanceStartListener/conditions/applications/includeApplications", + "includeApplications": [ + { + "appId": "77552a27-2fbf-4fb0-873e-af165ec071d5" + } + ] + } + } +} +``` + |
v1.0 | Authenticationeventlistener Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationeventlistener-update.md | + + Title: "Update authenticationEventListener" +description: "Update the properties of an authenticationEventListener object." ++ms.localizationpriority: medium ++++# Update authenticationEventListener +Namespace: microsoft.graph ++Update the properties of an [authenticationEventListener](../resources/authenticationeventlistener.md) object. You must specify the **@odata.type** property and the value of the [authenticationEventListener](../resources/authenticationeventlistener.md) object type to update. +++## 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": "authenticationeventlistener_update" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /identity/authenticationEventListeners/{authenticationEventListenerId} +``` ++## 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 ++You must specify the **@odata.type** property and the value of the [authenticationEventListener](../resources/authenticationeventlistener.md) object type to update. For example, `"@odata.type": "#microsoft.graph.onTokenIssuanceStartListener"`. ++|Property|Type|Description| +|:|:|:| +|conditions|[authenticationConditions](../resources/authenticationconditions.md)|The conditions on which this authenticationEventListener should trigger. Optional.| +|handler|[onTokenIssuanceStartHandler](../resources/ontokenissuancestarthandler.md)|The handler to invoke when conditions are met. Can be updated for the **onTokenIssuanceStartListener** listener type.| ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request +The following example shows a request to update an authentication event listener's trigger conditions: ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_authenticationeventlistener" +} +--> +``` http +PATCH https://graph.microsoft.com/v1.0/identity/authenticationEventListeners/990d94e5-cc8f-4c4b-97b4-27e2678aac28 +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.onTokenIssuanceStartListener", + "conditions": { + "applications": { + "includeApplications": [ + { + "appId": "a13d0fc1-04ab-4ede-b215-63de0174cbb4" + } + ] + } + }, +} +``` ++# [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. +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Authenticationmethodspolicy Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationmethodspolicy-get.md | HTTP/1.1 200 OK Content-Type: application/json {- "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#authenticationMethodsPolicy", + "@odata.context": "https://graph.microsoft.com/beta/$metadata#authenticationMethodsPolicy", + "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET policies/authenticationMethodsPolicy?$select=description,displayName", "id": "authenticationMethodsPolicy", "displayName": "Authentication Methods Policy", "description": "The tenant-wide policy that controls which authentication methods are allowed in the tenant, authentication method registration requirements, and self-service password reset settings",- "lastModifiedDateTime": "2022-01-26T10:47:26.6044384Z", - "policyVersion": "1.4", + "lastModifiedDateTime": "2024-04-26T12:44:42.0858664Z", + "policyVersion": "1.5", + "policyMigrationState": "preMigration", "registrationEnforcement": { "authenticationMethodsRegistrationCampaign": { "snoozeDurationInDays": 1,- "state": "default", + "enforceRegistrationAfterAllowedSnoozes": true, + "state": "disabled", "excludeTargets": [], "includeTargets": [ { Content-Type: application/json ] } },+ "systemCredentialPreferences": { + "state": "disabled", + "excludeTargets": [], + "includeTargets": [ + { + "id": "all_users", + "targetType": "group" + } + ] + }, + "reportSuspiciousActivitySettings": { + "state": "disabled", + "voiceReportingCode": 0, + "includeTarget": { + "id": "all_users", + "targetType": "group" + } + }, + "authenticationMethodConfigurations@odata.context": "https://graph.microsoft.com/beta/$metadata#policies/authenticationMethodsPolicy/authenticationMethodConfigurations", "authenticationMethodConfigurations": [ { "@odata.type": "#microsoft.graph.fido2AuthenticationMethodConfiguration", "id": "Fido2",- "state": "disabled", + "state": "enabled", "isSelfServiceRegistrationAllowed": true, "isAttestationEnforced": true,+ "defaultPasskeyProfile": null, + "excludeTargets": [ + { + "id": "dad4ae4a-730c-4e52-826c-0d9094971f04", + "targetType": "group" + } + ], "keyRestrictions": { "isEnforced": false, "enforcementType": "block", "aaGuids": [] },+ "includeTargets@odata.context": "https://graph.microsoft.com/beta/$metadata#policies/authenticationMethodsPolicy/authenticationMethodConfigurations('Fido2')/microsoft.graph.fido2AuthenticationMethodConfiguration/includeTargets", "includeTargets": [ { "targetType": "group", "id": "all_users",- "isRegistrationRequired": false + "isRegistrationRequired": false, + "allowedPasskeyProfiles": [] }- ] + ], + "passkeyProfiles": [] }, { "@odata.type": "#microsoft.graph.microsoftAuthenticatorAuthenticationMethodConfiguration", "id": "MicrosoftAuthenticator",- "state": "disabled", + "state": "enabled", + "isSoftwareOathEnabled": false, + "excludeTargets": [ + { + "id": "dad4ae4a-730c-4e52-826c-0d9094971f04", + "targetType": "group" + } + ], + "featureSettings": { + "companionAppAllowedState": { + "state": "default", + "includeTarget": { + "targetType": "group", + "id": "all_users" + }, + "excludeTarget": { + "targetType": "group", + "id": "00000000-0000-0000-0000-000000000000" + } + }, + "numberMatchingRequiredState": { + "state": "enabled", + "includeTarget": { + "targetType": "group", + "id": "all_users" + }, + "excludeTarget": { + "targetType": "group", + "id": "00000000-0000-0000-0000-000000000000" + } + }, + "displayAppInformationRequiredState": { + "state": "default", + "includeTarget": { + "targetType": "group", + "id": "all_users" + }, + "excludeTarget": { + "targetType": "group", + "id": "00000000-0000-0000-0000-000000000000" + } + }, + "displayLocationInformationRequiredState": { + "state": "default", + "includeTarget": { + "targetType": "group", + "id": "all_users" + }, + "excludeTarget": { + "targetType": "group", + "id": "00000000-0000-0000-0000-000000000000" + } + } + }, + "includeTargets@odata.context": "https://graph.microsoft.com/beta/$metadata#policies/authenticationMethodsPolicy/authenticationMethodConfigurations('MicrosoftAuthenticator')/microsoft.graph.microsoftAuthenticatorAuthenticationMethodConfiguration/includeTargets", "includeTargets": [ { "targetType": "group", "id": "all_users", "isRegistrationRequired": false,- "authenticationMode": "any", - "outlookMobileAllowedState": "default", - "displayAppInformationRequiredState": "default", - "numberMatchingRequiredState": "default" + "authenticationMode": "any" } ] }, { "@odata.type": "#microsoft.graph.smsAuthenticationMethodConfiguration", "id": "Sms",- "state": "enabled", + "state": "disabled", + "excludeTargets": [], + "includeTargets@odata.context": "https://graph.microsoft.com/beta/$metadata#policies/authenticationMethodsPolicy/authenticationMethodConfigurations('Sms')/microsoft.graph.smsAuthenticationMethodConfiguration/includeTargets", "includeTargets": [ { "targetType": "group", "id": "all_users", "isRegistrationRequired": false,- "isUsableForSignIn": true + "isUsableForSignIn": false } ] }, { "@odata.type": "#microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration", "id": "TemporaryAccessPass",- "state": "disabled", + "state": "enabled", "defaultLifetimeInMinutes": 60, "defaultLength": 8, "minimumLifetimeInMinutes": 60, "maximumLifetimeInMinutes": 480, "isUsableOnce": false,+ "excludeTargets": [ + { + "id": "dad4ae4a-730c-4e52-826c-0d9094971f04", + "targetType": "group" + } + ], + "includeTargets@odata.context": "https://graph.microsoft.com/beta/$metadata#policies/authenticationMethodsPolicy/authenticationMethodConfigurations('TemporaryAccessPass')/microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration/includeTargets", + "includeTargets": [ + { + "targetType": "group", + "id": "all_users", + "isRegistrationRequired": false + } + ] + }, + { + "@odata.type": "#microsoft.graph.hardwareOathAuthenticationMethodConfiguration", + "id": "HardwareOath", + "state": "enabled", + "excludeTargets": [], + "includeTargets@odata.context": "https://graph.microsoft.com/beta/$metadata#policies/authenticationMethodsPolicy/authenticationMethodConfigurations('HardwareOath')/microsoft.graph.hardwareOathAuthenticationMethodConfiguration/includeTargets", + "includeTargets": [ + { + "targetType": "group", + "id": "all_users", + "isRegistrationRequired": false + } + ] + }, + { + "@odata.type": "#microsoft.graph.softwareOathAuthenticationMethodConfiguration", + "id": "SoftwareOath", + "state": "enabled", + "excludeTargets": [], + "includeTargets@odata.context": "https://graph.microsoft.com/beta/$metadata#policies/authenticationMethodsPolicy/authenticationMethodConfigurations('SoftwareOath')/microsoft.graph.softwareOathAuthenticationMethodConfiguration/includeTargets", + "includeTargets": [ + { + "targetType": "group", + "id": "dad4ae4a-730c-4e52-826c-0d9094971f04", + "isRegistrationRequired": false + } + ] + }, + { + "@odata.type": "#microsoft.graph.voiceAuthenticationMethodConfiguration", + "id": "Voice", + "state": "disabled", + "isOfficePhoneAllowed": false, + "callerIdNumber": null, + "isCustomGreetingEnabled": false, + "excludeTargets": [], + "includeTargets@odata.context": "https://graph.microsoft.com/beta/$metadata#policies/authenticationMethodsPolicy/authenticationMethodConfigurations('Voice')/microsoft.graph.voiceAuthenticationMethodConfiguration/includeTargets", "includeTargets": [ { "targetType": "group", Content-Type: application/json { "@odata.type": "#microsoft.graph.emailAuthenticationMethodConfiguration", "id": "Email",- "state": "enabled", + "state": "disabled", "allowExternalIdToUseEmailOtp": "default",- "includeTargets": [] + "excludeTargets": [], + "includeTargets@odata.context": "https://graph.microsoft.com/beta/$metadata#policies/authenticationMethodsPolicy/authenticationMethodConfigurations('Email')/microsoft.graph.emailAuthenticationMethodConfiguration/includeTargets", + "includeTargets": [ + { + "targetType": "group", + "id": "d2d5bae7-a7b7-4581-8d52-5a8d26f517b3", + "isRegistrationRequired": false + } + ] + }, + { + "@odata.type": "#microsoft.graph.x509CertificateAuthenticationMethodConfiguration", + "id": "X509Certificate", + "state": "enabled", + "excludeTargets": [], + "certificateUserBindings": [ + { + "x509CertificateField": "PrincipalName", + "userProperty": "userPrincipalName", + "priority": 1, + "trustAffinityLevel": "low" + }, + { + "x509CertificateField": "RFC822Name", + "userProperty": "userPrincipalName", + "priority": 2, + "trustAffinityLevel": "low" + } + ], + "authenticationModeConfiguration": { + "x509CertificateAuthenticationDefaultMode": "x509CertificateSingleFactor", + "x509CertificateDefaultRequiredAffinityLevel": "low", + "rules": [] + }, + "issuerHintsConfiguration": { + "state": "disabled" + }, + "crlValidationConfiguration": { + "state": "disabled", + "exemptedCertificateAuthoritiesSubjectKeyIdentifiers": [] + }, + "includeTargets@odata.context": "https://graph.microsoft.com/beta/$metadata#policies/authenticationMethodsPolicy/authenticationMethodConfigurations('X509Certificate')/microsoft.graph.x509CertificateAuthenticationMethodConfiguration/includeTargets", + "includeTargets": [ + { + "targetType": "group", + "id": "eb2aa918-770c-40b4-97b8-f58a0087f8b5", + "isRegistrationRequired": false + }, + { + "targetType": "group", + "id": "d97d81ce-74be-46a4-ba6e-62eed46fabb9", + "isRegistrationRequired": false + } + ] + }, + { + "@odata.type": "#microsoft.graph.externalAuthenticationMethodConfiguration", + "id": "fda55161-0d73-48ec-b29f-d29689e3d1b6", + "state": "enabled", + "displayName": "Adatum - Broken", + "appId": "73f7c26a-7a24-4408-adfa-ff1ff19b5c10", + "excludeTargets": [ + { + "id": "18c6ce0e-243f-4130-ad7d-d9049806df0e", + "targetType": "group" + } + ], + "openIdConnectSetting": { + "clientId": "966c7a17-8cb9-47a6-8504-c1e50b05f21d", + "discoveryUrl": "https://Adatum.com/.well-known/openid-configurationx" + }, + "includeTargets@odata.context": "https://graph.microsoft.com/beta/$metadata#policies/authenticationMethodsPolicy/authenticationMethodConfigurations('fda55161-0d73-48ec-b29f-d29689e3d1b6')/microsoft.graph.externalAuthenticationMethodConfiguration/includeTargets", + "includeTargets": [ + { + "targetType": "group", + "id": "all_users", + "isRegistrationRequired": false + } + ] } ] } |
v1.0 | Authenticationmethodsroot Usersregisteredbyfeature | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationmethodsroot-usersregisteredbyfeature.md | The following table shows the parameters that can be used with this function. |includedUserRoles|includedUserRoles|The role type for the user. Possible values are: `all`, `privilegedAdmin`, `admin`, `user`.| |includedUserTypes|includedUserTypes|User type. Possible values are: `all`, `member`, `guest`.| -The value `privilegedAdmin` consists of the following privileged admin roles: +The value `privilegedAdmin` consists of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): * Global Administrator * Security Administrator |
v1.0 | Authenticationmethodsroot Usersregisteredbymethod | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationmethodsroot-usersregisteredbymethod.md | The following table shows the parameters that can be used with this function. |includedUserRoles|includedUserRoles|The role type for the user. Possible values are: `all`, `privilegedAdmin`, `admin`, `user`.| |includedUserTypes|includedUserTypes|User type. Possible values are: `all`, `member`, `guest`.| -The value `privilegedAdmin` consists of the following privileged admin roles: +The value `privilegedAdmin` consists of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): * Global Administrator * Security Administrator |
v1.0 | B2xidentityuserflow Delete Identityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/b2xidentityuserflow-delete-identityproviders.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2xidentityuserflow_delete_identityproviders" } --> [!INCLUDE [permissions-table](../includes/permissions/b2xidentityuserflow-delete-identityproviders-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2xidentityuserflow Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/b2xidentityuserflow-delete.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2xidentityuserflow_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/b2xidentityuserflow-delete-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2xidentityuserflow Get Apiconnectorconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/b2xidentityuserflow-get-apiconnectorconfiguration.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2xidentityuserflow_get_apiconnectorconfiguration" } --> [!INCLUDE [permissions-table](../includes/permissions/b2xidentityuserflow-get-apiconnectorconfiguration-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2xidentityuserflow Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/b2xidentityuserflow-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2xidentityuserflow_get" } --> [!INCLUDE [permissions-table](../includes/permissions/b2xidentityuserflow-get-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2xidentityuserflow List Identityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/b2xidentityuserflow-list-identityproviders.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2xidentityuserflow_list_identityproviders" } --> [!INCLUDE [permissions-table](../includes/permissions/b2xidentityuserflow-list-identityproviders-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2xidentityuserflow List Languages | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/b2xidentityuserflow-list-languages.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2xidentityuserflow_list_languages" } --> [!INCLUDE [permissions-table](../includes/permissions/b2xidentityuserflow-list-languages-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2xidentityuserflow Post Identityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/b2xidentityuserflow-post-identityproviders.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2xidentityuserflow_post_identityproviders" } --> [!INCLUDE [permissions-table](../includes/permissions/b2xidentityuserflow-post-identityproviders-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | B2xidentityuserflow Put Apiconnectorconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/b2xidentityuserflow-put-apiconnectorconfiguration.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "b2xidentityuserflow_put_apiconnectorconfiguration" } --> [!INCLUDE [permissions-table](../includes/permissions/b2xidentityuserflow-put-apiconnectorconfiguration-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Basesitepage Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/basesitepage-delete.md | ++ +description: "Delete a sitePage from the site pages list in a site." + Title: "Delete baseSitePage" +ms.localizationpriority: medium ++# Delete baseSitePage ++Namespace: microsoft.graph ++Delete a [baseSitePage][] from the site pages [list][] in a [site][]. ++[baseSitePage]: ../resources/basesitepage.md +[list]: ../resources/list.md +[site]: ../resources/site.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). ++>**Note:** To delete an item, the user must have granted the application write access to the item to be deleted. ++<!-- { "blockType": "permissions", "name": "basesitepage_delete" } --> ++## HTTP request ++<!-- { "blockType": "ignored" } --> ++```http +DELETE /sites/{site-id}/pages/{page-id} +``` ++## Request headers ++| Name | Value | Description +|:--|:|:-- +|Authorization|Bearer {token}.| Required| +| _if-match_ | etag | If this request header is included and the eTag provided doesn't match the current tag on the item, a `412 Precondition Failed` response is returned and the item won't be deleted. ++## Request body ++Don't supply a request body with this method. ++## Response ++If successful, this method returns a `204 No Content`. It doesn't return anything in the response body. ++## Example ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { "blockType": "request", "name": "delete-page", "scopes": "files.readwrite sites.readwrite.all" } --> +```http +DELETE /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202 +``` ++# [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. ++<!-- { "blockType": "response" } --> ++```http +HTTP/1.1 204 No Content +``` ++<!-- +{ + "type": "#page.annotation", + "description": "Delete a page in the SitePages list in a site.", + "keywords": "", + "section": "documentation", + "tocPath": "Pages/Delete", + "suppressions": [] +} +--> |
v1.0 | Basesitepage Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/basesitepage-get.md | ++ +description: "Read the properties and relationships of a baseSitePage object." Last updated : 03/15/2018+ Title: Get baseSitePage +ms.localizationpriority: medium +++# Get baseSitePage ++Namespace: microsoft.graph ++Get the metadata for a [baseSitePage][] in the site pages [list][] in a [site][]. ++[baseSitePage]: ../resources/basesitepage.md +[list]: ../resources/list.md +[site]: ../resources/site.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": "basesitepage_get" } --> ++## HTTP request ++<!-- { "blockType": "ignored" } --> ++```http +GET /sites/{site-id}/pages/{page-id} +``` ++## Optional query parameters ++This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. ++## 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 ++Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200` and a [baseSitePage](../resources/basesitepage.md) object in the response body. ++## Example ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!--{ + "blockType": "request", + "name": "get-basesitepage", + "scopes": "sites.read.all", + "tags": "service.sharepoint" +} +--> ++```msgraph-interactive +GET /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202 +``` ++# [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. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- +{ + "blockType": "response", + "@odata.type": "microsoft.graph.baseSitePage", + "truncated": true, + "isCollection":false +} +--> ++```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "@odata.type": "#microsoft.graph.sitePage", + "@odata.etag": "\"{F45354CB-D634-45DF-8B88-2B4E96A1DC45},8\"", + "description": "Reiciendis placeat dolores.Mollitia veniam tempora tempora quidem voluptatum.Quos animi maiores facilis.Dolores officiis consequatur provident beatae deleniti accusamus magni quam tenetur.", + "eTag": "\"{F45354CB-D634-45DF-8B88-2B4E96A1DC45},8\"", + "id": "f45354cb-d634-45df-8b88-2b4e96a1dc45", + "lastModifiedDateTime": "2023-04-16T10:01:41Z", + "name": "Electronic Convertible.aspx", + "webUrl": "https://contoso.sharepoint.com/SitePages/Electronic Convertible.aspx", + "title": "Electronic Convertible", + "pageLayout": "article", + "thumbnailWebUrl": "https://media.akamai.odsp.cdn.office.net/_layouts/15/images/sitepagethumbnail.png", + "promotionKind": "page", + "showComments": false, + "showRecommendedPages": true, + "contentType": { + "id": "0x0101009D1CB255DA76424F860D91F20E6C4118009E6554A5E299E84FB2E07731DD6C6D4A", + "name": "Site Page" + }, + "createdBy": { + "user": { + "displayName": "admin_contoso", + "email": "admin@contoso.onmicrosoft.com" + } + }, + "lastModifiedBy": { + "user": { + "displayName": "admin_contoso", + "email": "admin@contoso.onmicrosoft.com" + } + }, + "parentReference": { + "siteId": "45bb2a3b-0a4e-46f4-8c68-749c3fea75d3" + }, + "publishingState": { + "level": "draft", + "versionId": "0.4" + }, + "reactions": {} +} +``` ++<!-- +{ + "type": "#page.annotation", + "description": "Get a page in a site", + "keywords": "", + "section": "documentation", + "tocPath": "Pages/Get", + "suppressions": [ + ] +} +--> |
v1.0 | Basesitepage List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/basesitepage-list.md | ++ +description: "Get the collection of baseSitePage objects from the site pages list in a site." + Title: "List baseSitePages" +ms.localizationpriority: medium +++# List baseSitePages ++Namespace: microsoft.graph ++Get the collection of [baseSitePage][] objects from the site pages [list][] in a [site][]. All pages in the site are returned (with pagination). Sort alphabetically by **name** in ascending order. ++> **Note:** The [baseSitePage][] specified is a parent type and does not have any instance. As a result, the returned data only consists of available subtypes that are provided as a list. ++**The following table lists the available subtypes.** ++| Entity name | Description | +| :-- | :- | +| [sitePage][] | Represents a regular page. | ++[baseSitePage]: ../resources/basesitepage.md +[sitePage]: ../resources/sitepage.md +[list]: ../resources/list.md +[site]: ../resources/site.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": "basesitepage_list" } --> ++## HTTP request ++<!-- { "blockType": "ignored" } --> ++```msgraph-interactive +GET /sites/{site-id}/pages +``` ++## Optional query parameters ++This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. ++## 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 ++Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a collection of [baseSitePage](../resources/basesitepage.md) objects in the response body. ++## Example ++### Request ++The following example shows a request. +<!-- +{ + "blockType": "request", + "name": "get-basesitepages", + "scopes": "sites.read.all", + "tags": "service.sharepoint" +} +--> ++# [HTTP](#tab/http) ++```msgraph-interactive +GET /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages +``` ++# [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. ++<!-- +{ + "blockType": "response", + "@odata.type": "Collection(microsoft.graph.baseSitePage)", + "truncated": true +} +--> ++```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "value": [ + { + "@odata.type": "#microsoft.graph.sitePage", + "@odata.etag": "\"{5FA48F95-2FDF-40E8-A28C-6D0D8345BCD2},8\"", + "description": "Placeat porro perspiciatis maxime esse nobis illo.Voluptate vitae maxime totam consectetur fugit sit quos.Saepe ea veniam voluptate tempore quod deleniti necessitatibus repellat.", + "eTag": "\"{5FA48F95-2FDF-40E8-A28C-6D0D8345BCD2},8\"", + "id": "5fa48f95-2fdf-40e8-a28c-6d0d8345bcd2", + "lastModifiedDateTime": "2023-04-16T08:37:51Z", + "name": "Account holistic.aspx", + "webUrl": "https://contoso.sharepoint.com/SitePages/Account holistic.aspx", + "title": "CSS Global Lithuanian meter", + "pageLayout": "article", + "thumbnailWebUrl": "https://media.akamai.odsp.cdn.office.net/a830edad9050849vanaukyisx52.spgrid.com/_layouts/15/images/sitepagethumbnail.png", + "promotionKind": "page", + "showComments": false, + "showRecommendedPages": false, + "contentType": { + "id": "0x0101009D1CB255DA76424F860D91F20E6C4118009E6554A5E299E84FB2E07731DD6C6D4A", + "name": "Site Page" + }, + "createdBy": { + "user": { + "displayName": "admin_contoso", + "email": "admin@contoso.onmicrosoft.com" + } + }, + "lastModifiedBy": { + "user": { + "displayName": "admin_contoso", + "email": "admin@contoso.onmicrosoft.com" + } + }, + "parentReference": { + "siteId": "45bb2a3b-0a4e-46f4-8c68-749c3fea75d3" + }, + "publishingState": { + "level": "draft", + "versionId": "0.4" + }, + "reactions": {} + }, + { + "@odata.type": "#microsoft.graph.sitePage", + "@odata.etag": "\"{DA0F67BE-977E-4D09-88AC-506A1002E678},5\"", + "eTag": "\"{DA0F67BE-977E-4D09-88AC-506A1002E678},5\"", + "id": "da0f67be-977e-4d09-88ac-506a1002e678", + "lastModifiedDateTime": "2023-04-16T06:39:30Z", + "name": "Analyst Fresh.aspx", + "webUrl": "https://contoso.sharepoint.com/SitePages/Analyst Fresh.aspx", + "title": "Lesotho Account Metal Analyst du", + "pageLayout": "article", + "thumbnailWebUrl": "https://media.akamai.odsp.cdn.office.net/a830edad9050849vanaukyisx52.spgrid.com/_layouts/15/images/sitepagethumbnail.png", + "promotionKind": "page", + "showComments": false, + "showRecommendedPages": false, + "contentType": { + "id": "0x0101009D1CB255DA76424F860D91F20E6C4118009E6554A5E299E84FB2E07731DD6C6D4A", + "name": "Site Page" + }, + "createdBy": { + "user": { + "displayName": "admin_contoso", + "email": "admin@contoso.onmicrosoft.com" + } + }, + "lastModifiedBy": { + "user": { + "displayName": "admin_contoso", + "email": "admin@contoso.onmicrosoft.com" + } + }, + "parentReference": { + "siteId": "45bb2a3b-0a4e-46f4-8c68-749c3fea75d3" + }, + "publishingState": { + "level": "draft", + "versionId": "0.1" + }, + "reactions": {}, + "titleArea": { + "enableGradientEffect": false, + "imageWebUrl": "https://loremflickr.com/640/480", + "layout": "plain", + "showAuthor": false, + "showPublishedDate": false, + "showTextBlockAboveTitle": false, + "textAboveTitle": "generating ADP", + "textAlignment": "center", + "title": "strategic underneath protocol Buckinghamshire forecast", + "authors@odata.type": "#Collection(String)", + "authors": [], + "authorByline@odata.type": "#Collection(String)", + "authorByline": [], + "imageSourceType": 4, + "serverProcessedContent": { + "htmlStrings": [], + "searchablePlainTexts": [], + "links": [], + "imageSources": [] + } + } + } + ] +} +``` ++<!-- +{ + "type": "#page.annotation", + "description": "Enumerate the list of pages in a site", + "keywords": "", + "section": "documentation", + "tocPath": "Pages/Enumerate", + "suppressions": [ + ] +} +--> |
v1.0 | Bitlocker List Recoverykeys | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bitlocker-list-recoverykeys.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "bitlocker_list_recoverykeys" } --> [!INCLUDE [permissions-table](../includes/permissions/bitlocker-list-recoverykeys-permissions.md)] -For delegated permissions, the calling user must be the registered owner of the device that the BitLocker recovery key was originally backed up from, or they must be in one of the following [directory roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): +For delegated permissions, the calling user must be the registered owner of the device that the BitLocker recovery key was originally backed up from, or they must be in at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): -* Global administrator * Cloud device administrator * Helpdesk administrator * Intune service administrator |
v1.0 | Bitlockerrecoverykey Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bitlockerrecoverykey-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "bitlockerrecoverykey_get" } --> [!INCLUDE [permissions-table](../includes/permissions/bitlockerrecoverykey-get-permissions.md)] -For delegated permissions, the calling user must be the registered owner of the device that the BitLocker recovery key was originally backed up from, or they must be in one of the following [directory roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): -* Global administrator +For delegated permissions, the calling user must be the registered owner of the device that the BitLocker recovery key was originally backed up from, or they must be in at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): + * Cloud device administrator * Helpdesk administrator * Intune service administrator |
v1.0 | Bookingappointment Cancel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingappointment-cancel.md | Namespace: microsoft.graph Cancel the specified [bookingAppointment](../resources/bookingappointment.md) in the specified [bookingBusiness](../resources/bookingbusiness.md) and send a message to the involved customer and staff members. ## Permissions |
v1.0 | Bookingappointment Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingappointment-delete.md | Namespace: microsoft.graph Delete a [bookingAppointment](../resources/bookingappointment.md) in the specified [bookingBusiness](../resources/bookingbusiness.md). ## Permissions |
v1.0 | Bookingappointment Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingappointment-get.md | Get the properties and relationships of a [bookingAppointment](../resources/book The **startDateTime** and **endDateTime** properties are always returned in UTC. ## 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). |
v1.0 | Bookingappointment Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingappointment-update.md | Namespace: microsoft.graph Update the properties of a [bookingAppointment](../resources/bookingappointment.md) object in the specified [bookingBusiness](../resources/bookingbusiness.md). ## Permissions |
v1.0 | Bookingbusiness Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingbusiness-delete.md | Namespace: microsoft.graph Delete a [bookingBusiness](../resources/bookingbusiness.md) object. ## 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). |
v1.0 | Bookingbusiness Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingbusiness-get.md | Namespace: microsoft.graph Get the properties and relationships of a [bookingBusiness](../resources/bookingbusiness.md) object. ## 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). |
v1.0 | Bookingbusiness Getstaffavailability | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingbusiness-getstaffavailability.md | Namespace: microsoft.graph Get the availability information of [staff members](../resources/bookingstaffmember.md) of a [Microsoft Bookings calendar](../resources/bookingappointment.md). ## Permissions |
v1.0 | Bookingbusiness List Appointments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingbusiness-list-appointments.md | Namespace: microsoft.graph Get a list of [bookingAppointment](../resources/bookingappointment.md) objects for the specified [bookingBusiness](../resources/bookingbusiness.md). ## Permissions |
v1.0 | Bookingbusiness List Calendarview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingbusiness-list-calendarview.md | Namespace: microsoft.graph Get the collection of [bookingAppointment](../resources/bookingappointment.md) objects for a [bookingBusiness](../resources/bookingbusiness.md) that occurs in the specified date range. ## Permissions |
v1.0 | Bookingbusiness List Customers | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingbusiness-list-customers.md | Namespace: microsoft.graph Get a list of [bookingCustomer](../resources/bookingcustomer.md) objects of a business. ## 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). |
v1.0 | Bookingbusiness List Customquestions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingbusiness-list-customquestions.md | Namespace: microsoft.graph Get the [bookingCustomQuestion](../resources/bookingcustomquestion.md) resources associated with a [bookingBusiness](../resources/bookingbusiness.md). ## Permissions |
v1.0 | Bookingbusiness List Services | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingbusiness-list-services.md | Namespace: microsoft.graph Get a list of [bookingService](../resources/bookingservice.md) objects in the specified [bookingBusiness](../resources/bookingbusiness.md). ## Permissions |
v1.0 | Bookingbusiness List Staffmembers | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingbusiness-list-staffmembers.md | Namespace: microsoft.graph Get a list of [bookingStaffMember](../resources/bookingstaffmember.md) objects in the specified [bookingBusiness](../resources/bookingbusiness.md). ## Permissions |
v1.0 | Bookingbusiness List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingbusiness-list.md | This operation returns only the **id** and **displayName** of each Microsoft Boo > **Note:** Results are limited to 500 mailboxes. Pagination of the results is not currently supported. ## Permissions |
v1.0 | Bookingbusiness Post Appointments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingbusiness-post-appointments.md | Namespace: microsoft.graph Create a new [bookingAppointment](../resources/bookingappointment.md) for the specified [bookingBusiness](../resources/bookingbusiness.md). ## Permissions |
v1.0 | Bookingbusiness Post Bookingbusinesses | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingbusiness-post-bookingbusinesses.md | Create a new [Microsoft Bookings business](../resources/bookingbusiness.md) in a This is the first step in setting up a Bookings business where you must specify the business display name. You can include other information such as business address, web site address, and scheduling policy, or set that information later by [updating](bookingbusiness-update.md) the **bookingBusiness**. ## 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). |
v1.0 | Bookingbusiness Post Customers | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingbusiness-post-customers.md | Namespace: microsoft.graph Create a new [bookingCustomer](../resources/bookingcustomer.md) object. ## 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). |
v1.0 | Bookingbusiness Post Customquestions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingbusiness-post-customquestions.md | Namespace: microsoft.graph Create a new [bookingCustomQuestion](../resources/bookingcustomquestion.md) object. ## Permissions |
v1.0 | Bookingbusiness Post Services | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingbusiness-post-services.md | Namespace: microsoft.graph Create a new [bookingService](../resources/bookingservice.md) for the specified [bookingBusiness](../resources/bookingbusiness.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). |
v1.0 | Bookingbusiness Post Staffmembers | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingbusiness-post-staffmembers.md | Namespace: microsoft.graph Create a new [bookingStaffMember](../resources/bookingstaffmember.md) in the specified [bookingBusiness](../resources/bookingbusiness.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). |
v1.0 | Bookingbusiness Publish | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingbusiness-publish.md | Make the scheduling page of a business available to external customers. Set the **isPublished** property to `true`, and the **publicUrl** property to the URL of the scheduling page. ## 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). |
v1.0 | Bookingbusiness Unpublish | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingbusiness-unpublish.md | Make the scheduling page of this business not available to external customers. Set the **isPublished** property to `false`, and the **publicUrl** property to `null`. ## 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). |
v1.0 | Bookingbusiness Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingbusiness-update.md | Namespace: microsoft.graph Update the properties of a [bookingBusiness](../resources/bookingbusiness.md) object. ## 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). |
v1.0 | Bookingcurrency Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingcurrency-get.md | Namespace: microsoft.graph Get the properties of a [bookingCurrency](../resources/bookingcurrency.md) object that is available to a Microsoft Bookings business. Use the **id** property, which is the currency code, to specify the currency. ## 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). |
v1.0 | Bookingcurrency List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingcurrency-list.md | Namespace: microsoft.graph Get a list of [bookingCurrency](../resources/bookingcurrency.md) objects available to a Microsoft Bookings business. ## 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). |
v1.0 | Bookingcustomer Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingcustomer-delete.md | Namespace: microsoft.graph Delete the specified [bookingCustomer](../resources/bookingcustomer.md) object. ## Permissions |
v1.0 | Bookingcustomer Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingcustomer-get.md | Namespace: microsoft.graph Get the properties and relationships of a [bookingCustomer](../resources/bookingcustomer.md) object. ## Permissions |
v1.0 | Bookingcustomer Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingcustomer-update.md | Namespace: microsoft.graph Update the properties of a [bookingCustomer](../resources/bookingcustomer.md) object. ## Permissions |
v1.0 | Bookingcustomquestion Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingcustomquestion-delete.md | Namespace: microsoft.graph Delete a [bookingCustomQuestion](../resources/bookingcustomquestion.md) object. ## Permissions |
v1.0 | Bookingcustomquestion Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingcustomquestion-get.md | Namespace: microsoft.graph Read the properties and relationships of a [bookingCustomQuestion](../resources/bookingcustomquestion.md) object. ## Permissions |
v1.0 | Bookingcustomquestion Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingcustomquestion-update.md | Namespace: microsoft.graph Update the properties of a [bookingCustomQuestion](../resources/bookingcustomquestion.md) object. ## Permissions |
v1.0 | Bookingservice Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingservice-delete.md | Namespace: microsoft.graph Delete a [bookingService](../resources/bookingservice.md) object in the specified [bookingBusiness](../resources/bookingbusiness.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). |
v1.0 | Bookingservice Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingservice-get.md | Namespace: microsoft.graph Get the properties and relationships of a [bookingService](../resources/bookingservice.md) object in the specified [bookingBusiness](../resources/bookingbusiness.md). ## Permissions |
v1.0 | Bookingservice Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingservice-update.md | The following are some examples you can customize for a service: - Any time buffer to set up before or finish up after the service - [Scheduling policy](../resources/bookingschedulingpolicy.md) parameters, such as minimum notice to book or cancel, and whether customers can select specific staff members for an appointment. ## 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). |
v1.0 | Bookingstaffmember Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingstaffmember-delete.md | Namespace: microsoft.graph Delete a [bookingStaffMember](../resources/bookingstaffmember.md) in the specified [bookingBusiness](../resources/bookingbusiness.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). |
v1.0 | Bookingstaffmember Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingstaffmember-get.md | Namespace: microsoft.graph Get the properties and relationships of a [bookingStaffMember](../resources/bookingstaffmember.md) in the specified [bookingBusiness](../resources/bookingbusiness.md). ## Permissions |
v1.0 | Bookingstaffmember Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingstaffmember-update.md | Namespace: microsoft.graph Update the properties of a [bookingStaffMember](../resources/bookingstaffmember.md) in the specified [bookingBusiness](../resources/bookingbusiness.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). |
v1.0 | Calendar Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/calendar-delete.md | The following example shows a request. DELETE https://graph.microsoft.com/v1.0/me/calendar ``` -# [C#](#tab/csharp) --# [CLI](#tab/cli) --# [Go](#tab/go) --# [Java](#tab/java) - # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/delete-calendar-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -# [PHP](#tab/php) --# [Python](#tab/python) - ##### Response |
v1.0 | Certificatebasedauthconfiguration Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/certificatebasedauthconfiguration-delete.md | Title: "Delete certificateBasedAuthConfiguration" description: "Delete certificateBasedAuthConfiguration." ms.localizationpriority: medium-+ doc_type: "apiPageType" |
v1.0 | Certificatebasedauthconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/certificatebasedauthconfiguration-get.md | Title: "Get certificateBasedAuthConfiguration" description: "Get the properties of a certificatebasedauthconfiguration object." ms.localizationpriority: medium-+ doc_type: "apiPageType" |
v1.0 | Certificatebasedauthconfiguration List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/certificatebasedauthconfiguration-list.md | Title: "List certificateBasedAuthConfigurations" description: "Get a list of certificatebasedauthconfiguration objects." ms.localizationpriority: medium-+ doc_type: "apiPageType" |
v1.0 | Certificatebasedauthconfiguration Post Certificatebasedauthconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/certificatebasedauthconfiguration-post-certificatebasedauthconfiguration.md | Title: "Create certificateBasedAuthConfiguration" description: "Use this API to create a new certificateBasedAuthConfiguration." ms.localizationpriority: medium-+ doc_type: "apiPageType" |
v1.0 | Channel Get Filesfolder | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/channel-get-filesfolder.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "channel_get_filesfolder" } --> [!INCLUDE [permissions-table](../includes/permissions/channel-get-filesfolder-permissions.md)] -> **Note**: The Group.Read.All and Group.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> [!NOTE] +> The Group.Read.All and Group.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Channel List Messages | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/channel-list-messages.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "channel_list_messages" } --> [!INCLUDE [permissions-table](../includes/permissions/channel-list-messages-permissions.md)] -> **Note**: The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request |
v1.0 | Channel Patch Tabs | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/channel-patch-tabs.md | Namespace: microsoft.graph Update the properties of the specified [tab](../resources/teamstab.md). This API can be used to configure the content of the tab. +> [!NOTE] +> You can't use this API to update a static tab. An attempt to update a static tab returns a `400 Bad Request` response code. + [!INCLUDE [national-cloud-support](../../includes/global-us.md)] ## Permissions |
v1.0 | Channel Post Members | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/channel-post-members.md | Include the following properties in the request body. If successful, this method returns a `201 Created` response code and a [conversationMember](../resources/conversationmember.md) object in the response body. +> [!NOTE] +> The response code `404 Not Found` is returned when you attempt to add a disabled/blocked user. + ## Examples ### Example 1: Add a member to a private channel |
v1.0 | Channel Post Messages | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/channel-post-messages.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "channel_post_messages" } --> [!INCLUDE [permissions-table](../includes/permissions/channel-post-messages-permissions.md)] -> **Note**: The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. --> **Note**: Application permissions are *only* supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). -In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. +> [!NOTE] +> The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> - Application permissions are only supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. <!-- markdownlint-disable MD024 --> <!-- markdownlint-disable MD001 --> POST /teams/{team-id}/channels/{channel-id}/messages ## Request body -In the request body, supply a JSON representation of a [chatMessage](../resources/chatmessage.md) object. Only the body property is mandatory. )ther properties are optional. +In the request body, supply a JSON representation of a [chatMessage](../resources/chatmessage.md) object. Only the body property is mandatory. All other properties are optional. ## Response |
v1.0 | Channel Post Tabs | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/channel-post-tabs.md | Namespace: microsoft.graph Add (pin) a [tab](../resources/teamstab.md) to the specified [channel](../resources/channel.md) within a [team](../resources/team.md). The app must be [preinstalled in the team](../api/team-list-installedapps.md) and have the [configurableTabs](/microsoftteams/platform/resources/schema/manifest-schema#configurabletabs) property defined in the app manifest. +> **Note**: If the app manifest for a given **appId** contains a static tab that matches the current scope (**team**), the static tab is pinned by default. + [!INCLUDE [national-cloud-support](../../includes/global-us.md)] ## Permissions POST /teams/{team-id}/channels/{channel-id}/tabs A [teamsTab](../resources/teamstab.md). +> [!NOTE] +> When you pin a static tab, Teams takes the **displayName** and **configuration** from the app manifest. If these properties are specified in the request body, this API returns a `400 Bad Request` response code. ## Response If successful, this method returns a `201 Created` response code. |
v1.0 | Channel Post | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/channel-post.md | doc_type: apiPageType Namespace: microsoft.graph -Create a new [channel](../resources/channel.md) in a team, as specified in the request body. When you create a channel, the maximum length of the channel's `displayName` is 50 characters. This is the name that appears to the user in Microsoft Teams. +Create a new [channel](../resources/channel.md) in a team, as specified in the request body. When you create a channel, the maximum length of the channel's `displayName` is 50 characters. This is the name that appears to the user in Microsoft Teams. If you're creating a private channel, you can add a maximum of 200 members. If you're creating a private channel, you can add a maximum of 200 members. ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Channel.Create, Group.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Channel.Create.Group*, Channel.Create, Teamwork.Migrate.All, Group.ReadWrite.All, Directory.ReadWrite.All | +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of. -> **Notes**: -> The Group.ReadWrite.All and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). -> -> This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of. -> -> In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported -using Teamwork.Migrate.All and/or [migration APIs](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). +<!-- { "blockType": "permissions", "name": "channel_post" } --> ++> [!NOTE] +> - The Group.ReadWrite.All and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> - The Channel.Create.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported using Teamwork.Migrate.All and/or [migration APIs](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). ## HTTP request <!-- { "blockType": "ignored" } --> Location: /teams('57fb72d0-d811-46f4-8947-305e6072eaa5')/channels('19:4b6bed8d24 #### Request -The following example shows a request to create a private channel and add a user as an team owner. +The following example shows a request to create a private channel and add a user as a team owner. # [HTTP](#tab/http) |
v1.0 | Chat Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/chat-delete.md | Soft-delete a [chat](../resources/chat.md). When invoked with delegated permissi > After chats are deleted, tenant admins have seven days to restore them. Chats deleted for more than seven days can't be restored. > One delete request per second per tenant is allowed. + ## 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). |
v1.0 | Chat Get Installedapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/chat-get-installedapps.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_get_installedapps" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-get-installedapps-permissions.md)] -> **Note:** -The TeamsAppInstallation.ReadWriteAndConsentSelfForChat and TeamsAppInstallation.ReadWriteAndConsentForChat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamsAppInstallation.ReadWriteAndConsentSelfForChat and TeamsAppInstallation.ReadWriteAndConsentForChat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request Content-type: application/json ### Example 2: Get the set of resource-specific permissions consented for the app installed in the specified chat -The following example gets the list of any [resource-specific permissions that were granted to an app](../resources/teamsapppermissionset.md) as part of installation. A `$select` query parameterd is required to show the consented permission set. +The following example gets the list of any [resource-specific permissions that were granted to an app](../resources/teamsapppermissionset.md) as part of installation. A `$select` query parameter is required to show the consented permission set. #### Request |
v1.0 | Chat List Installedapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/chat-list-installedapps.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_list_installedapps" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-list-installedapps-permissions.md)] -> **Note:** -The following permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent): +> [!NOTE] +> The following permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent): > - TeamsAppInstallation.ReadWriteAndConsentSelfForChat > - TeamsAppInstallation.ReadWriteAndConsentForChat > - TeamsAppInstallation.ReadWriteAndConsentSelfForChat.All |
v1.0 | Chat Patch Tabs | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/chat-patch-tabs.md | Namespace: microsoft.graph Update the properties of the specified [tab](../resources/teamstab.md) in a [chat](../resources/chat.md). This can be used to configure the content of the tab. -> **Note**: If the chat is associated with an [onlineMeeting](../resources/onlinemeeting.md) instance, then, effectively, the tab pinned in the meeting will be updated. +> [!NOTE] +> - If the chat is associated with an [onlineMeeting](../resources/onlinemeeting.md) instance, then, effectively, the tab pinned in the meeting will be updated. +> - You can't use this API to update a static tab. An attempt to update a static tab returns a `400 Bad Request` response code. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] |
v1.0 | Chat Post Installedapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/chat-post-installedapps.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_post_installedapps" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-post-installedapps-permissions.md)] -> **Note:** These TeamsAppInstallation.ReadWriteSelfForChat, TeamsAppInstallation.ReadWriteForChat, TeamsAppInstallation.ReadWriteSelfForChat.All, and TeamsAppInstallation.ReadWriteForChat.All permissions cannot be used to install apps that require consent to resource-specific permissions. +> [!NOTE] +> These TeamsAppInstallation.ReadWriteSelfForChat, TeamsAppInstallation.ReadWriteForChat, TeamsAppInstallation.ReadWriteSelfForChat.All, and TeamsAppInstallation.ReadWriteForChat.All permissions cannot be used to install apps that require consent to resource-specific permissions. ## HTTP request POST /chats/{chat-id}/installedApps ## Request body The request body should include the generated app ID of the catalog app. For more information, see [teamsApp properties](../resources/teamsapp.md#properties).-The following table lists additional parameters that can be used with the request body. +The following table lists other parameters that can be used with the request body. |Parameter|Type|Description| |:|:|:| The following example shows the response. HTTP/1.1 201 Created ``` -### Example 2: Install app in a chat and and consent to the resource-specific permissions required by the app +### Example 2: Install app in a chat and consent to the resource-specific permissions required by the app To get the list of resource-specific permissions required by the app, get the app from **appCatalog**, as shown in [Example 7](../api/appcatalogs-list-teamsapps.md#example-7-list-applications-with-a-given-id-and-return-only-the-resource-specific-permissions-required-by-the-app). |
v1.0 | Chat Post Tabs | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/chat-post-tabs.md | Namespace: microsoft.graph Add (pin) a [tab](../resources/teamstab.md) to the specified [chat](../resources/chat.md). The corresponding app must already be [installed in the chat](../api/chat-list-installedapps.md). -> **Note**: If the chat is associated with an [onlineMeeting](../resources/onlinemeeting.md) instance, then, effectively, the tab will get added to the meeting. +> **Notes**: +> * If the chat is associated with an [onlineMeeting](../resources/onlinemeeting.md) instance, then the tab is effectively added to the meeting. +> * If the app manifest for a given **appId** contains a static tab that matches the current scope (`chat`/`groupChat`), the static tab is pinned by default. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] POST /chats/{chat-id}/tabs In the request body include a JSON representation of a [teamsTab](../resources/teamstab.md). +> [!NOTE] +> When you pin a static tab, Teams takes the **displayName** and **configuration** from the app manifest. If these properties are specified in the request body, this API returns a `400 Bad Request` response code. + ## Response If successful, this method returns a `201 Created` response code and an instance of the [teamsTab](../resources/teamstab.md) resource in the body. |
v1.0 | Chat Teamsappinstallation Upgrade | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/chat-teamsappinstallation-upgrade.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chat_teamsappinstallation_upgrade" } --> [!INCLUDE [permissions-table](../includes/permissions/chat-teamsappinstallation-upgrade-permissions.md)] -> **Note:** The TeamsAppInstallation.ReadWriteSelfForChat, TeamsAppInstallation.ReadWriteForChat, TeamsAppInstallation.ReadWriteSelfForChat.All, and TeamsAppInstallation.ReadWriteForChat.All permissions can't be used to install apps that require consent to resource-specific permissions. +> [!NOTE] +> The TeamsAppInstallation.ReadWriteSelfForChat, TeamsAppInstallation.ReadWriteForChat, TeamsAppInstallation.ReadWriteSelfForChat.All, and TeamsAppInstallation.ReadWriteForChat.All permissions can't be used to install apps that require consent to resource-specific permissions. ## HTTP request <!-- { "blockType": "ignored" } --> POST /chats/{chat-id}/installedApps/{app-installation-id}/upgrade In the request body, supply a JSON representation of the parameters. -The following table lists additional parameters that can be used with the upgrade action. +The following table lists other parameters that can be used with the upgrade action. |Parameter|Type|Description| |:|:|:| |
v1.0 | Chatmessage Delta | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/chatmessage-delta.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chatmessage_delta" } --> [!INCLUDE [permissions-table](../includes/permissions/chatmessage-delta-permissions.md)] -> **Note**: The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Chatmessage Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/chatmessage-get.md | One of the following permissions is required to call this API. To learn more, in |Delegated (personal Microsoft account)|Not supported.| |Application| Chat.Read.All, Chat.ReadWrite.All| -> **Note:** The _ChannelMessage.Read.Group_ and _ChatMessage.Read.Chat_ permissions use [resource-specific consent]( https://aka.ms/teams-rsc). +> [!NOTE] +> The ChannelMessage.Read.Group and ChatMessage.Read.Chat permissions use [resource-specific consent]( https://aka.ms/teams-rsc). ## HTTP request GET /me/chats/{chat-id}/messages/{message-id} ``` ## Optional query parameters-This method does not support the [OData query parameters](/graph/query-parameters) to customize the response. +This method doesn't support the [OData query parameters](/graph/query-parameters) to customize the response. ## Request headers | Header | Value | |
v1.0 | Chatmessage List Hostedcontents | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/chatmessage-list-hostedcontents.md | doc_type: "apiPageType" Namespace: microsoft.graph -Retrieve the list of [chatMessageHostedContent](../resources/chatmessagehostedcontent.md) objects from a message. This API only lists the hosted content objects. To get the content bytes, see [get chatmessage hosted content](chatmessagehostedcontent-get.md) +Retrieve the list of [chatMessageHostedContent](../resources/chatmessagehostedcontent.md) objects from a message. This API only lists the hosted content objects. To get the content bytes, see [get chatmessage hosted content](chatmessagehostedcontent-get.md). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] Retrieve the list of [chatMessageHostedContent](../resources/chatmessagehostedco |Delegated (personal Microsoft account)|Not supported.| |Application| Chat.Read.All, Chat.ReadWrite.All| -> **Note:** The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request |
v1.0 | Chatmessage List Replies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/chatmessage-list-replies.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chatmessage_list_replies" } --> [!INCLUDE [permissions-table](../includes/permissions/chatmessage-list-replies-permissions.md)] -> **Note:** The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request |
v1.0 | Chatmessage Post Replies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/chatmessage-post-replies.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chatmessage_post_replies" } --> [!INCLUDE [permissions-table](../includes/permissions/chatmessage-post-replies-permissions.md)] -> **Note**: The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. --> **Note**: Application permissions are *only* supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). -In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. +> [!NOTE] +> - The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> - Application permissions are only supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Chatmessage Post | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/chatmessage-post.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "chatmessage_post" } --> [!INCLUDE [permissions-table](../includes/permissions/chatmessage-post-permissions.md)] -> **Note**: The Group.ReadWrite.All permissino is supported only for backward compatibility. We recommend that you update your solutions to use the alternative permissions listed in the table. --> **Note**: Application permissions are *only* supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). In the future, Microsoft might require you or your customers to pay additional fees based on the amount of data imported. +> [!NOTE] +> - The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use the alternative permissions listed in the table. +> - Application permissions are only supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). In the future, Microsoft might require you or your customers to pay additional fees based on the amount of data imported. ### Permissions for chat <!-- { "blockType": "permissions", "name": "chatmessage_post_2" } --> |
v1.0 | Chatmessage Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/chatmessage-update.md | One of the following permissions is required to call this API. To learn more, in | Delegated (personal Microsoft account) | Not supported. | | Application | ChannelMessage.UpdatePolicyViolation.All, Group.ReadWrite.All** | -> **Note:** The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> [!NOTE] +> The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. ### Permissions for chat <!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. --> |
v1.0 | Chatmessagehostedcontent Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/chatmessagehostedcontent-get.md | One of the following permissions is required to call this API. To learn more, in |Delegated (personal Microsoft account)|Not supported.| |Application| Chat.Read.All, Chat.ReadWrite.All| -> **Note:** The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request GET /users/{user-id | user-principal-name}/chats/{chat-id}/messages/{message-id} ## Optional query parameters -This operation does not support the [OData query parameters](/graph/query-parameters) to customize the response. +This operation doesn't support the [OData query parameters](/graph/query-parameters) to customize the response. ## Request headers |
v1.0 | Cloudclipboarditem Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudclipboarditem-get.md | Read the properties and relationships of a [cloudClipboardItem](../resources/clo This API doesn't support using another user's credentials to get a [cloudClipboardItem](../resources/cloudclipboarditem.md) 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). |
v1.0 | Cloudclipboardroot List Items | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudclipboardroot-list-items.md | Get a list of the [cloudClipboardItem](../resources/cloudclipboarditem.md) objec This API doesn't support using another user's credentials to get a [cloudClipboardItem](../resources/cloudclipboarditem.md) 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). |
v1.0 | Cloudpc Endgraceperiod | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpc-endgraceperiod.md | Namespace: microsoft.graph End the grace period for a specific [cloudPC](../resources/cloudpc.md) object. The grace period is triggered when the Cloud PC license is removed or the provisioning policy is unassigned. It allows users to access Cloud PCs for up to seven days before deprovisioning occurs. Ending the grace period immediately deprovisions the Cloud PC without waiting the seven days. + ## 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). If successful, this method returns a `204 No Content` response code. The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "endgraceperiod_cloudpc" The following example shows a request. POST https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/cloudPCs/4b18de4b-ab05-4059-8c61-0323a7df4ced/endGracePeriod ``` +# [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. |
v1.0 | Cloudpc Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpc-get.md | Namespace: microsoft.graph Read the properties and relationships of a specific [cloudPC](../resources/cloudpc.md) object. + ## 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). If successful, this method returns a `200 OK` response code and a [cloudPC](../r The following example shows a request to get the default properties of a Cloud PC. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_cloudpc_default_properties" The following example shows a request to get the default properties of a Cloud P GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/cloudPCs/9ec90ff8-fd63-4fb9-ab5a-aa4fdcc43ec9 ``` +# [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. |
v1.0 | Cloudpc Reboot | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpc-reboot.md | Namespace: microsoft.graph Reboot a specific [cloudPC](../resources/cloudpc.md) object. + ## 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). If successful, this method returns a `204 No Content` response code. The following example shows a request to reboot a Cloud PC for the administrator. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "reboot_cloudpc" The following example shows a request to reboot a Cloud PC for the administrator POST https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/cloudPCs/831dd62e-cfa1-4d49-a3b4-58d4e9920f8e/reboot ``` +# [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. |
v1.0 | Cloudpc Rename | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpc-rename.md | Namespace: microsoft.graph Rename a specific [cloudPC](../resources/cloudpc.md) object. Use this API to update the **displayName** of a Cloud PC entity. + ## 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). If successful, this method returns a `204 No Content` response code. The following example shows a request to rename a Cloud PC for the administrator. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "rename_cloudpc" Content-Type: application/json } ``` +# [CLI](#tab/cli) ++# [JavaScript](#tab/javascript) +++ ### Response The following example shows the response. <!-- { |
v1.0 | Cloudpc Restore | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpc-restore.md | Namespace: microsoft.graph Restore a specific [cloudPC](../resources/cloudpc.md) object to a previous state from a snapshot. Use this API to trigger a remote action that restores a Cloud PC device to a previous state. + ## 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). If successful, this method returns a `204 No Content` response code. The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "cloudpc_restore", Content-length: 37 } ``` +# [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. |
v1.0 | Cloudpc Troubleshoot | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpc-troubleshoot.md | Namespace: microsoft.graph Troubleshoot a specific [cloudPC](../resources/cloudpc.md) object. Use this API to check the health status of the Cloud PC and the session host. + ## 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). If successful, this method returns a `204 No Content` response code. ### Request The following example shows a request.+# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "troubleshoot_cloudpc" The following example shows a request. POST https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/cloudPCs/ff4eb6ab-d56a-4edf-90c1-baaec8dd6032/troubleshoot ``` +# [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. <!-- { |
v1.0 | Cloudpcauditevent Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpcauditevent-get.md | Namespace: microsoft.graph Read the properties and relationships of a [cloudPcAuditEvent](../resources/cloudpcauditevent.md) object. ## Permissions If successful, this method returns a `200 OK` response code and a [cloudPcAuditE The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_cloudpcauditevent" The following example shows a request. ``` http GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/auditEvents/{id} ```++# [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 |
v1.0 | Cloudpcauditevent Getauditactivitytypes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpcauditevent-getauditactivitytypes.md | Namespace: microsoft.graph Get audit activity types by tenant ID. ## 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": "cloudpcauditevent_getAuditActivityTypes" } --> +<!-- { "blockType": "permissions", "name": "cloudpcauditevent_getauditactivitytypes" } --> [!INCLUDE [permissions-table](../includes/permissions/cloudpcauditevent-getauditactivitytypes-permissions.md)] ## HTTP request If successful, this method returns a `200 OK` response code and a String collect The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "cloudpcauditevent_getauditactivitytypes" The following example shows a request. ``` http GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/auditEvents/getAuditActivityTypes ```++# [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 |
v1.0 | Cloudpcdeviceimage Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpcdeviceimage-delete.md | Namespace: microsoft.graph Delete a [cloudPcDeviceImage](../resources/cloudpcdeviceimage.md) object. + ## 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). If successful, this method returns a `204 No Content` response code. The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "delete_deviceimages_from_virtualendpoint" The following example shows a request. DELETE https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/deviceImages/435849e6-0263-4621-9f93-8657667af3bb ``` +# [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. |
v1.0 | Cloudpcdeviceimage Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpcdeviceimage-get.md | Namespace: microsoft.graph Read the properties and relationships of a specific [cloudPcDeviceImage](../resources/cloudpcdeviceimage.md) object. + ## 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). If successful, this method returns a `200 OK` response code and a [cloudPcDevice The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_cloudpcdeviceimage" The following example shows a request. GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/deviceImages/eda7ed64-7705-4079-9d08-c2bd883f4fff ``` +# [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. |
v1.0 | Cloudpcdeviceimage Getsourceimages | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpcdeviceimage-getsourceimages.md | Namespace: microsoft.graph Get [cloudPcSourceDeviceImage](../resources/cloudpcsourcedeviceimage.md) objects that can be uploaded and used on Cloud PCs. View a list of all the managed image resources from your Microsoft Entra subscriptions. + ## 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). If successful, this method returns a `200 OK` response code and a collection of The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "cloudpcdeviceimage_getsourceimages" The following example shows a request. GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/deviceImages/getSourceImages ``` +# [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. |
v1.0 | Cloudpcgalleryimage Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpcgalleryimage-get.md | Namespace: microsoft.graph Read the properties and relationships of a specific [cloudPcGalleryImage](../resources/cloudpcgalleryimage.md) object. + ## 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). If successful, this method returns a `200 OK` response code and a [cloudPcGaller The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_cloudpcgalleryimage", The following example shows a request. GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/galleryImages/MicrosoftWindowsDesktop_windows-ent-cpc_19h2-ent-cpc-os ``` +# [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. |
v1.0 | Cloudpconpremisesconnection Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpconpremisesconnection-delete.md | When you delete an Azure network connection, permissions to the service are remo You cannot delete an Azure network connection when it's in use, as indicated by the **inUse** property. ## 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": "cloudPcOnPremisesConnection_delete" } --> +<!-- { "blockType": "permissions", "name": "cloudpconpremisesconnection_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/cloudpconpremisesconnection-delete-permissions.md)] ## HTTP request If successful, this method returns a `204 No Content` response code. The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "delete_onpremisesconnections_from_virtualendpoint" The following example shows a request. DELETE https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/onPremisesConnections/{id} ``` +# [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 |
v1.0 | Cloudpconpremisesconnection Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpconpremisesconnection-get.md | Read the properties and relationships of the [cloudPcOnPremisesConnection](../re [!INCLUDE [on-premise-rename-note](../../includes/on-premise-rename-note.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": "cloudPcOnPremisesConnection_get" } --> +<!-- { "blockType": "permissions", "name": "cloudpconpremisesconnection_get" } --> [!INCLUDE [permissions-table](../includes/permissions/cloudpconpremisesconnection-get-permissions.md)] ## HTTP request If successful, this method returns a `200 OK` response code and a [cloudPcOnPrem #### Request The following example shows a request.+# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_cloudpconpremisesconnection" The following example shows a request. GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/onPremisesConnections/{id} ``` +# [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 Content-Type: application/json #### Request The following example shows a request.+# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_cloudpconpremisesconnection_withDetails" The following example shows a request. GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/onPremisesConnections/{id}?$select=id,displayName,healthCheckStatus,healthCheckStatusDetail,inUse ``` +# [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 |
v1.0 | Cloudpconpremisesconnection Runhealthcheck | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpconpremisesconnection-runhealthcheck.md | Run health checks on the [cloudPcOnPremisesConnection](../resources/cloudpconpre It triggers a new health check for the [cloudPcOnPremisesConnection (../resources/cloudpconpremisesconnection.md) object and changes the healthCheckStatus and [healthCheckStatusDetail](../resources/cloudpconpremisesconnectionstatusdetail.md) properties when check finished. ## 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": "cloudPcOnPremisesConnection_runhealthcheck" } --> +<!-- { "blockType": "permissions", "name": "cloudpconpremisesconnection_runhealthcheck" } --> [!INCLUDE [permissions-table](../includes/permissions/cloudpconpremisesconnection-runhealthcheck-permissions.md)] ## HTTP request If successful, this method returns a `204 No Content` response code. ### Request The following example shows a request.+# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "cloudpconpremisesconnection_runhealthcheck_2" The following example shows a request. ``` http POST https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/onPremisesConnections/{id}/runHealthChecks ```++# [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 |
v1.0 | Cloudpconpremisesconnection Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpconpremisesconnection-update.md | Update the properties of a [cloudPcOnPremisesConnection](../resources/cloudpconp [!INCLUDE [on-premise-rename-note](../../includes/on-premise-rename-note.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": "cloudPcOnPremisesConnection_update" } --> +<!-- { "blockType": "permissions", "name": "cloudpconpremisesconnection_update" } --> [!INCLUDE [permissions-table](../includes/permissions/cloudpconpremisesconnection-update-permissions.md)] ## HTTP request If successful, this method returns a `200 OK` response code and an updated [clou ### Request The following example shows a request.+# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "update_onpremisesconnections" Content-Type: application/json } ``` +# [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 |
v1.0 | Cloudpcprovisioningpolicy Assign | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpcprovisioningpolicy-assign.md | Namespace: microsoft.graph Assign a [cloudPcProvisioningPolicy](../resources/cloudpcprovisioningpolicy.md) to user groups. + ## 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). If successful, this method returns a `204 No Content` response code. The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "assign_cloudpcprovisioningpolicy", Content-Type: application/json } ``` +# [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. |
v1.0 | Cloudpcprovisioningpolicy Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpcprovisioningpolicy-delete.md | Namespace: microsoft.graph Delete a [cloudPcProvisioningPolicy](../resources/cloudpcprovisioningpolicy.md) object. You canΓÇÖt delete a policy thatΓÇÖs in use. + ## 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). If successful, this method returns a `204 No Content` response code. The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "delete_provisioningpolicies_from_virtualendpoint" The following example shows a request. DELETE https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/provisioningPolicies/1d164206-bf41-4fd2-8424-a3192d39ffff ``` +# [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. |
v1.0 | Cloudpcprovisioningpolicy Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpcprovisioningpolicy-get.md | Namespace: microsoft.graph Read the properties and relationships of a [cloudPcProvisioningPolicy](../resources/cloudpcprovisioningpolicy.md) object. + ## 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). The following example shows how to get the properties of the specified provision The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_cloudpcprovisioningpolicy_1" The following example shows a request. GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/provisioningPolicies/1d164206-bf41-4fd2-8424-a3192d39ffff ``` +# [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. The following example shows how to get the properties of the specified provision The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_cloudpcprovisioningpolicy_2" The following example shows a request. GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/provisioningPolicies/1d164206-bf41-4fd2-8424-a3192d39ffff?$expand=assignments ``` +# [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. The following example shows a request that retrieves the selected properties of The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_cloudpcprovisioningpolicy_3" The following example shows a request. GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/provisioningPolicies/60b94f83-3e22-430e-a69d-440f65b922d6?$select=id,description,displayName,domainJoinConfigurations,imageDisplayName,imageId,imageType,windowsSetting,cloudPcGroupDisplayName,gracePeriodInHours,localAdminEnabled,alternateResourceUrl ``` +# [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. |
v1.0 | Cloudpcprovisioningpolicy Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpcprovisioningpolicy-update.md | Namespace: microsoft.graph Update the properties of a [cloudPcProvisioningPolicy](../resources/cloudpcprovisioningpolicy.md) object. + ## 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). If successful, this method returns a `204 No Content` response code. The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "update_provisioningpolicy" Content-Type: application/json } ``` +# [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. |
v1.0 | Cloudpcusersetting Assign | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpcusersetting-assign.md | Namespace: microsoft.graph Assign a [cloudPcUserSetting](../resources/cloudpcusersetting.md) to user groups. + ## 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). If successful, this method returns a `204 No Content` response code. The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "cloudpcusersetting_assign", Content-Type: application/json } ``` +# [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. |
v1.0 | Cloudpcusersetting Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpcusersetting-delete.md | Namespace: microsoft.graph Delete a [cloudPcUserSetting](../resources/cloudpcusersetting.md) object. + ## 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). If successful, this method returns a `204 No Content` response code. The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "delete_cloudpcusersetting" The following example shows a request. DELETE https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/userSettings/b0c2d35f-3385-46c8-a6f5-6c3dfad7ffff ``` +# [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. |
v1.0 | Cloudpcusersetting Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpcusersetting-get.md | Namespace: microsoft.graph Read the properties and relationships of a [cloudPcUserSetting](../resources/cloudpcusersetting.md) object. + ## 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). The following example shows how to get the properties of the specified user sett The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_cloudpcusersetting" The following example shows a request. GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/userSettings/556092f8-92f8-5560-f892-6055f8926055 ``` +# [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. The following example shows how to get the properties of the specified user sett The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_cloudpcusersetting_2" The following example shows a request. GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/userSettings/b0c2d35f-3385-46c8-a6f5-6c3dfad7ffff?$expand=assignments ``` +# [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. |
v1.0 | Cloudpcusersetting Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpcusersetting-update.md | Namespace: microsoft.graph Update the properties of a [cloudPcUserSetting](../resources/cloudpcusersetting.md) object. + ## 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). If successful, this method returns a `200 OK` response code and an updated [clou The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "update_cloudpcusersetting" Content-Type: application/json } ``` +# [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. |
v1.0 | Conversationmember Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/conversationmember-get.md | One of the following permissions is required to call this API. To learn more, in |Delegated (personal Microsoft account)|Not supported.| |Application| For **user** or **chat** resource: Not supported.<br/><br/>For **channel** resource: TeamMember.Read.Group, ChannelMember.Read.All, ChannelMember.ReadWrite.All | -> **Note:** The TeamMember.Read.Group permmission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamMember.Read.Group permmission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request |
v1.0 | Crosstenantaccesspolicy List Partners | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/crosstenantaccesspolicy-list-partners.md | Content-Type: application/json { "tenantId": "123f4846-ba00-4fd7-ba43-dac1f8f63013", "inboundTrust": null,+ "isInMultiTenantOrganization": false, "automaticUserConsentSettings": { "inboundAllowed": null, "outboundAllowed": null |
v1.0 | Crosstenantaccesspolicyconfigurationdefault Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/crosstenantaccesspolicyconfigurationdefault-get.md | Content-Type: application/json } ] }+ }, + "invitationRedemptionIdentityProviderConfiguration": + { + "primaryIdentityProviderPrecedenceOrder": [ + "externalFederation", + "azureActiveDirectory", + "socialIdentityProviders" + ], + "fallbackIdentityProvider": "defaultConfiguredIdp" } } ``` |
v1.0 | Crosstenantaccesspolicyconfigurationdefault Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/crosstenantaccesspolicyconfigurationdefault-update.md | If successful, this method returns a `204 No Content` response code. ## Examples -### Request +### Example 1: Block outbound B2B collaboration for a group of users +#### Request # [HTTP](#tab/http) <!-- { If successful, this method returns a `204 No Content` response code. "name": "update_crosstenantaccesspolicyconfigurationdefault" } -->- ``` http PATCH https://graph.microsoft.com/v1.0/policies/crossTenantAccessPolicy/default Content-Type: application/json Content-Type: application/json -### Response +#### Response ++<!-- { + "blockType": "response", + "truncated": true +} +--> ++``` http +HTTP/1.1 204 No Content +``` ++### Example 2: Update default invitation redemption configuration ++#### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_crosstenantaccesspolicyconfigurationdefault_idpconfiguration" +} +--> +``` http +PATCH https://graph.microsoft.com/v1.0/policies/crossTenantAccessPolicy/default +Content-Type: application/json ++{ + "invitationRedemptionIdentityProviderConfiguration": { + "primaryIdentityProviderPrecedenceOrder": [ + "externalFederation", + "azureActiveDirectory", + "socialIdentityProviders" + ], + "fallbackIdentityProvider": "defaultConfiguredIdp" + } +} +``` ++# [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 ++<!-- { + "blockType": "response", + "truncated": true +} +--> ++``` http +HTTP/1.1 204 No Content +``` ++### Example 3: Disallow Microsoft accounts as an option for redeeming B2B invitations ++#### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_crosstenantaccesspolicyconfigurationdefault_idpconfiguration_noMsa" +} +--> +``` http +PATCH https://graph.microsoft.com/v1.0/policies/crossTenantAccessPolicy/default +Content-Type: application/json ++{ + "invitationRedemptionIdentityProviderConfiguration": { + "primaryIdentityProviderPrecedenceOrder": [ + "externalFederation", + "azureActiveDirectory", + "socialIdentityProviders" + ], + "fallbackIdentityProvider": "emailOneTimePasscode" + } +} +``` ++# [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 <!-- { "blockType": "response", |
v1.0 | Crosstenantaccesspolicyconfigurationpartner Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/crosstenantaccesspolicyconfigurationpartner-get.md | Content-Type: application/json { "tenantId": "9c5d131d-b1c3-4fc4-9e3f-c6557947d551", "inboundTrust": null,+ "isInMultiTenantOrganization": false, "automaticUserConsentSettings": { "inboundAllowed": null, |
v1.0 | Customauthenticationextension Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/customauthenticationextension-delete.md | + + Title: "Delete customAuthenticationExtension" +description: "Delete a customAuthenticationExtension object." ++ms.localizationpriority: medium ++++# Delete customAuthenticationExtension +Namespace: microsoft.graph ++Delete a [customAuthenticationExtension](../resources/customauthenticationextension.md) object. +++## 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": "customauthenticationextension_delete" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /identity/customAuthenticationExtensions/{customAuthenticationExtensionId} +``` ++## 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 `204 No Content` response code. ++## Examples ++### Request +The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_customauthenticationextension" +} +--> +``` http +DELETE https://graph.microsoft.com/v1.0/identity/customAuthenticationExtensions/5c82815a-ee61-4c9b-9f4b-914a708a0c68 +``` ++# [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. +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Customauthenticationextension Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/customauthenticationextension-get.md | + + Title: "Get customAuthenticationExtension" +description: "Read the properties and relationships of a customAuthenticationExtension object." ++ms.localizationpriority: medium ++++# Get customAuthenticationExtension +Namespace: microsoft.graph ++Read the properties and relationships of a [customAuthenticationExtension](../resources/customauthenticationextension.md) object. +++## 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": "customauthenticationextension_get" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /identity/customAuthenticationExtensions/{customAuthenticationExtensionId} +``` ++## Optional query parameters +This method supports the `$expand` 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 [customAuthenticationExtension](../resources/customauthenticationextension.md) object in the response body. ++## Examples ++### Request +The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_customauthenticationextension" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/identity/customAuthenticationExtensions/6fc5012e-7665-43d6-9708-4370863f4e6e +``` ++# [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. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.customAuthenticationExtension" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identity/customAuthenticationExtensions/$entity", + "@odata.type": "#microsoft.graph.onTokenIssuanceStartCustomExtension", + "id": "6fc5012e-7665-43d6-9708-4370863f4e6e", + "displayName": "onTokenIssuanceStartCustomExtension", + "description": "Fetch additional claims from custom user store", + "clientConfiguration": null, + "authenticationConfiguration": { + "@odata.type": "#microsoft.graph.azureAdTokenAuthentication", + "resourceId": "api://authenticationeventsAPI.contoso.com/a13d0fc1-04ab-4ede-b215-63de0174cbb4" + }, + "endpointConfiguration": { + "@odata.type": "#microsoft.graph.httpRequestEndpoint", + "targetUrl": "https://authenticationeventsAPI.contoso.com" + }, + "claimsForTokenConfiguration": [ + { + "claimIdInApiResponse": "DateOfBirth" + }, + { + "claimIdInApiResponse": "CustomRoles" + } + ] +} +``` + |
v1.0 | Customauthenticationextension Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/customauthenticationextension-update.md | + + Title: "Update customAuthenticationExtension" +description: "Update the properties of a customAuthenticationExtension object." ++ms.localizationpriority: medium ++++# Update customAuthenticationExtension +Namespace: microsoft.graph ++Update the properties of a [customAuthenticationExtension](../resources/customauthenticationextension.md) object. +++## 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": "customauthenticationextension_update" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /identity/customAuthenticationExtensions/{customAuthenticationExtensionId} +``` ++## 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 ++You must specify the `@odata.type` property when updating a [customAuthenticationExtension](../resources/customauthenticationextension.md) object. For example, to update an [onTokenIssuanceStartCustomExtension](../resources/ontokenissuancestartcustomextension.md) object type, set the `@odata.type` property to `#microsoft.graph.onTokenIssuanceStartCustomExtension`. ++|Property|Type|Description| +|:|:|:| +|authenticationConfiguration|[customExtensionAuthenticationConfiguration](../resources/customextensionauthenticationconfiguration.md)|The authentication configuration for this custom extension. Inherited from [customCalloutExtension](../resources/customcalloutextension.md). Optional.| +|description|String|Description for the custom extension. Inherited from [customCalloutExtension](../resources/customcalloutextension.md). Optional.| +|displayName|String|Display name for the custom extension. Inherited from [customCalloutExtension](../resources/customcalloutextension.md). Optional.| +|endpointConfiguration|[customExtensionEndpointConfiguration](../resources/customextensionendpointconfiguration.md)|Configuration for the API endpoint that the custom extension will call. Inherited from [customCalloutExtension](../resources/customcalloutextension.md). Optional.| +++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request +The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_customauthenticationextension" +} +--> +``` http +PATCH https://graph.microsoft.com/v1.0/identity/customAuthenticationExtensions/6fc5012e-7665-43d6-9708-4370863f4e6e +Content-Type: application/json +Content-length: 468 ++{ + "@odata.type": "#microsoft.graph.onTokenIssuanceStartCustomExtension", + "displayName": "onTokenIssuanceStartCustomExtension", + "description": "Fetch additional claims from custom user store", + "endpointConfiguration": { + "@odata.type": "#microsoft.graph.httpRequestEndpoint", + "targetUrl": "https://authenticationeventsAPI.contoso.com" + }, + "authenticationConfiguration": { + "@odata.type": "#microsoft.graph.azureAdTokenAuthentication", + "resourceId": "api://authenticationeventsAPI.contoso.com/a13d0fc1-04ab-4ede-b215-63de0174cbb4" + }, + "claimsForTokenConfiguration": [ + { + "claimIdInApiResponse": "DateOfBirth" + }, + { + "claimIdInApiResponse": "CustomRoles" + } + ] +} +``` ++# [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. +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Customauthenticationextension Validateauthenticationconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/customauthenticationextension-validateauthenticationconfiguration.md | + + Title: "customAuthenticationExtension: validateAuthenticationConfiguration" +description: "An API to check validity of the endpoint and authentication configuration for a customAuthenticationExtension." ++ms.localizationpriority: medium ++++# customAuthenticationExtension: validateAuthenticationConfiguration +Namespace: microsoft.graph ++An API to check validity of the endpoint and and authentication configuration for a customAuthenticationExtension. +++## 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": "customauthenticationextension_validateauthenticationconfiguration" } --> ++## HTTP request ++To validate the endpoint and authentication configuration for a customAuthenticationExtension by its ID. +<!-- { + "blockType": "ignored" +} +--> +``` http +POST /identity/customAuthenticationExtensions/{customAuthenticationExtensionId}/validateAuthenticationConfiguration +``` ++To validate the endpoint and authentication configuration that's specified in the request body for a customAuthenticationExtension. The custom authentication extension object may not exist yet and you can use this endpoint to validate the configuration before creating the custom authentication extension. +<!-- { + "blockType": "ignored" +} +--> +``` http +POST /identity/customAuthenticationExtensions/validateAuthenticationConfiguration +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ++## Request body ++In the request body, supply JSON representation of the parameters. ++The following table shows the parameters that can be used with this action. Supply a endpointConfiguration and authenticationConfiguration if querying at the root level. Otherwise, for a specific custom extension, do not supply a request body for this method. ++|Parameter|Type|Description| +|:|:|:| +|endpointConfiguration|[customExtensionEndpointConfiguration](../resources/customextensionendpointconfiguration.md)|The HTTP endpoint for the custom authentication extension to be validated.| +|authenticationConfiguration|[customExtensionEndpointConfiguration](../resources/customextensionendpointconfiguration.md)|The authentication configuration for the custom authenticaion extension to validate.| ++## Response ++If successful, this action returns a `200 OK` response code and a [authenticationConfigurationValidation](../resources/authenticationconfigurationvalidation.md) in the response body. ++## Examples ++### Example 1: Supply and validate a potential custom authentication extension configuration ++#### Request +The following example shows a request. +<!-- { + "blockType": "request", + "name": "customauthenticationextensionthis.validateauthenticationconfiguration" +} +--> +``` http +POST https://graph.microsoft.com/v1.0/customAuthenticationExtensions/validateAuthenticationConfiguration +Content-Type: application/json ++{ + "endpointConfiguration": { + "@odata.type": "#microsoft.graph.httpRequestEndpoint", + "targetUrl": "https://australia.contoso.com/users" + }, + "authenticationConfiguration": { + "@odata.type": "#microsoft.graph.azureAdTokenAuthentication", + "resourceId": "api://extensibilityapi.azurwebsites.net/f9c5dc6b-d72b-4226-8ccd-801f7a290428" + } +} +``` +++#### 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.authenticationConfigurationValidation" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.authenticationConfigurationValidation", + "errors": [ + { + "code": "IncorrectResourceIdFormat", + "message": "ResourceId should be in the format of 'api://{fully qualified domain name}/{appid}'" + }, + { + "code": "DomainNameDoesNotMatch", + "message": "The fully qualified domain name in resourceId should match that of the targetUrl" + }, + { + "code": "ServicePrincipalNotFound", + "message": "The appId of the resourceId should correspond to a real service principal in the tenant" + } + ], + "warnings": [ + { + "code": "PermissionNotGrantedToServicePrincipal", + "message": "The permission CustomAuthenticationExtensions.Receive.Payload is not granted to the service principal of the resource app" + }, + ] +} +``` +++### Example 2: Validate the configuration of a specific existing custom authentication extension ++#### Request +The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "customauthenticationextensionthis.validateauthenticationconfiguration_byId" +} +--> +``` http +POST https://graph.microsoft.com/v1.0/identity/customAuthenticationExtensions/9f39f3bb-457c-4a2a-8099-0e480e7ea142/validateAuthenticationConfiguration +``` ++# [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. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.authenticationConfigurationValidation" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.authenticationConfigurationValidation", + "errors": [ + { + "code": "IncorrectResourceIdFormat", + "message": "ResourceId should be in the format of 'api://{fully qualified domain name}/{appid}'" + }, + { + "code": "DomainNameDoesNotMatch", + "message": "The fully qualified domain name in resourceId should match that of the targetUrl" + }, + { + "code": "ServicePrincipalNotFound", + "message": "The appId of the resourceId should correspond to a real service principal in the tenant" + } + ], + "warnings": [ + { + "code": "PermissionNotGrantedToServicePrincipal", + "message": "The permission CustomAuthenticationExtensions.Receive.Payload is not granted to the service principal of the resource app" + }, + ] +} +``` ++ |
v1.0 | Delegatedadminrelationship Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/delegatedadminrelationship-update.md | doc_type: apiPageType # Update delegatedAdminRelationship Namespace: microsoft.graph -Update the properties of a [delegatedAdminRelationship](../resources/delegatedadminrelationship.md) object. You can only update a relationship when it's in the `created` **status**. However, you can update the **autoExtendDuration** property when the relationship is in either the `created` or `active` **status**. +Update the properties of a [delegatedAdminRelationship](../resources/delegatedadminrelationship.md) object. ++The following restrictions apply: +- You can update this relationship when its **status** property is `created`. +- You can update the **autoExtendDuration** property when **status** is either `created` or `active`. +- You can only remove the Microsoft Entra Global Administrator role when the **status** property is `active`, which indicates a long-running operation. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] PATCH /tenantRelationships/delegatedAdminRelationships/{delegatedAdminRelationsh ## Response -If successful, this method returns a `200 OK` response code and an updated [delegatedAdminRelationship](../resources/delegatedadminrelationship.md) object in the response body. +If successful, this method returns either a `200 OK` or a `202 Accepted` response code. The response body contains a + [delegatedAdminRelationship](../resources/delegatedadminrelationship.md) object when the response is `200 OK`. ++### Response headers +|Name|Description| +|:|:| +|Content-Type|application/json.| +|Location|The location of the long-running operation.| +|Retry-After|The time after which a subsequent API call can be made to the Location URL to check the status of the long-running operation.| ++This method returns a `202 Accepted` response if you remove the Microsoft Entra Global Administrator role from the relationship while its **status** property is `active`. The response includes a URL in the Location header that you can use to monitor the operation's progress. ++If you don't supply the template ID that corresponds to the Microsoft Entra Global Administrator role in the `unifiedRoles` array in the `accessDetails` property of the request body, then the API returns `200 OK` and the original [delegatedAdminRelationship](../resources/delegatedAdminRelationship.md) object in the response body. ## Examples ### Request+The following example shows the request. # [HTTP](#tab/http) <!-- { Content-Type: application/json ### Response+The following example shows the request. >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", Content-Type: application/json } ``` +The following is an example response that returns a `202 Accepted` response code along with **Location** and **Retry-After** headers. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.delegatedAdminRelationship" +} +--> ++``` http +HTTP/1.1 202 Accepted +Location: https://graph.microsoft.com/v1.0/tenantRelationships/delegatedAdminRelationships/5e5594d3-6f82-458b-b567-77db4811f0cd-00000000-0000-0000-0000-000000001234/operations/d8dbb27b-7fe7-4523-a3df-f766355fe0f2 +Retry-After: 10 +Content-Type: application/json ++{ +} +``` + |
v1.0 | Deletedchat Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/deletedchat-get.md | Namespace: microsoft.graph Read the properties and relationships of a [deletedChat](../resources/deletedchat.md) object. + ## 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). GET https://graph.microsoft.com/v1.0/teamwork/deletedChats/19:64dedcac16b74a209b [!INCLUDE [sample-code](../includes/snippets/php/get-deletedchat-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-deletedchat-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Deletedchat Undodelete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/deletedchat-undodelete.md | Restore a [deletedChat](../resources/deletedchat.md) to an active [chat](../res >**Note:** This operation is not supported for non-admin users. + ## 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). POST https://graph.microsoft.com/v1.0/teamwork/deletedChats/19:64dedcac16b74a209 [!INCLUDE [sample-code](../includes/snippets/php/deletedchatundodelete-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/deletedchatundodelete-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Device Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/device-delete.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "device_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/device-delete-permissions.md)] -The calling user must also be in one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): *Global Administrator*, *Intune Administrator*, *Windows 365 Administrator*, or *Cloud Device Administrator*. +The calling user must also be in one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): *Intune Administrator*, *Windows 365 Administrator*, or *Cloud Device Administrator*. ## HTTP request |
v1.0 | Device Post Devices | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/device-post-devices.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "device_post_devices" } --> [!INCLUDE [permissions-table](../includes/permissions/device-post-devices-permissions.md)] -The calling user must also be in one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): *Global Administrator*, *Intune Administrator*, or *Windows 365 Administrator*. +The calling user must also be in one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): *Intune Administrator*, or *Windows 365 Administrator*. ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Device Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/device-update.md | Choose the permission or permissions marked as least privileged for this API. Us In application-only scenarios and for non-Windows devices, that is, where the **operatingSystem** property is not `Windows`, the app can update only the **extensionAttributes** property. -The calling user must also be in one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): *Global Administrator*, *Intune Administrator*. A calling user in the *Cloud Device Administrator* role can only enable or disable devices using this API and a user with the *Windows 365 Administrator* role can only update basic device properties. +The calling user must also be in one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): *Intune Administrator*. A calling user in the *Cloud Device Administrator* role can only enable or disable devices using this API and a user with the *Windows 365 Administrator* role can only update basic device properties. A Global Administrator has full management privileges over the device. ## HTTP request |
v1.0 | Directory Deleteditems List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/directory-deleteditems-list.md | ConsistencyLevel: eventual This example requires the **ConsistencyLevel** header because the `$orderby` and `$count` query parameters are used in the query. -### Examples using the $orderby OData query parameter +### $orderby OData query parameter examples -The `$orderby` OData query parameter is supported on the **deletedDateTime**, **displayName**, and **userPrincipalName** properties of the deleted object types. On the **deletedDateTime** property, the query requires adding the [advanced query parameters](/graph/aad-advanced-queries) (**ConsistencyLevel** header set to `true` and `$count=true` query string). +The `$orderby` OData query parameter is supported on the **deletedDateTime**, **displayName**, and **userPrincipalName** properties of the deleted object types. On the **deletedDateTime** property, the query requires adding the [advanced query parameters](/graph/aad-advanced-queries) (**ConsistencyLevel** header set to `eventual` and `$count=true` query string). | OData cast | Properties supporting $orderby | Example | | : | : | : | |
v1.0 | Directory Post Administrativeunits | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/directory-post-administrativeunits.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "directory_post_administrativeunits" } --> [!INCLUDE [permissions-table](../includes/permissions/directory-post-administrativeunits-permissions.md)] -To create an administrative unit, the calling principal must be assigned one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): --* Privileged Role Administrator -* Global Administrator +To create an administrative unit, the calling principal must be assigned at least the *Privileged Role Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Directoryobject Checkmemberobjects | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/directoryobject-checkmemberobjects.md | description: "Check for membership in a list of groups, administrative units, or ms.localizationpriority: medium + doc_type: "apiPageType" |
v1.0 | Domain Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/domain-delete.md | Title: "Delete domain" -description: "Deletes a domain from a tenant." -+description: "Delete a domain from a tenant." + ms.localizationpriority: medium doc_type: apiPageType doc_type: apiPageType Namespace: microsoft.graph -Deletes a domain from a tenant. +Delete a domain from a tenant. > **Important:** > - Deleted domains are not recoverable.<br /> Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "domain_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/domain-delete-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* Domain Name Administrator +The work or school account needs to belong to at least the *Domain Name Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Domain Forcedelete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/domain-forcedelete.md | Title: "Force domain deletion" -description: "Deletes a domain using an asynchronous long-running operation." -+ Title: "domain: forceDelete" +description: "Delete a domain using an asynchronous long-running operation." + ms.localizationpriority: medium doc_type: apiPageType -# Force domain deletion +# domain: forceDelete Namespace: microsoft.graph -Deletes a domain using an asynchronous long-running operation. +Delete a domain using an asynchronous long-running operation. -Prior to calling [forceDelete](domain-forcedelete.md), you must update or remove any references to **Exchange** as the provisioning service. +Before performing this operation, you must update or remove any references to **Exchange** as the provisioning service. The following actions are performed as part of this operation: The following actions are performed as part of this operation: * If one of the `applications` to be renamed is a multitenant app, an error is returned. -After the domain deletion completes, API operations for the deleted domain will return an HTTP 404 status code. To verify deletion of a domain, you can perform a [get domain](domain-get.md) operation. +After the domain deletion completes, API operations for the deleted domain return an HTTP 404 status code. To verify deletion of a domain, you can perform a [get domain](domain-get.md) operation. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "domain_forcedelete" } --> [!INCLUDE [permissions-table](../includes/permissions/domain-forcedelete-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* Domain Name Administrator +The work or school account needs to belong to at least the *Domain Name Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request In the request body, provide a JSON object with the following parameters. | Parameter | Type | Description | |:|:--|:-|-|`disableUserAccounts`|`Boolean`| Option to disable user accounts that are renamed. If a user account is disabled, the user won't be allowed to sign in. If set to **true** the `users` updated as part of this operation will be disabled. Default value is **true**. | +|`disableUserAccounts`|`Boolean`| Option to disable user accounts that are renamed. If a user account is disabled, the user isn't allowed to sign in. If set to `true` the users updated as part of this operation are disabled. Default value is `true`. | ## Response body |
v1.0 | Domain Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/domain-get.md | Title: "Get domain" description: "Retrieve the properties and relationships of domain object."-+ ms.localizationpriority: medium doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "domain_get" } --> [!INCLUDE [permissions-table](../includes/permissions/domain-get-permissions.md)] -The work or school account needs to belong to one of the following roles: +The work or school account needs to belong to atleast one of the following Microsoft Entra roles: -* Global Administrator * User Administrator * Helpdesk Administrator * Service Support Administrator |
v1.0 | Domain List Domainnamereferences | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/domain-list-domainnamereferences.md | Title: "List domainNameReferences" description: "Retrieve a list of directoryObject with a reference to the domain."-+ ms.localizationpriority: medium doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "domain_list_domainnamereferences" } --> [!INCLUDE [permissions-table](../includes/permissions/domain-list-domainnamereferences-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* Domain Name Administrator -* Global Reader +The work or school account needs to belong to at least the *Domain Name Administrator* or *Global Reader* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). [!INCLUDE [limited-info](../../includes/limited-info.md)] |
v1.0 | Domain List Serviceconfigurationrecords | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/domain-list-serviceconfigurationrecords.md | Title: "List serviceConfigurationRecords" description: "Retrieves a list of domainDnsRecord objects needed to enable services for the domain."-+ ms.localizationpriority: medium doc_type: apiPageType |
v1.0 | Domain List Verificationdnsrecords | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/domain-list-verificationdnsrecords.md | Title: "List verificationDnsRecords" description: "Retrieve a list of domainDnsRecord objects."-+ ms.localizationpriority: medium doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "domain_list_verificationdnsrecords" } --> [!INCLUDE [permissions-table](../includes/permissions/domain-list-verificationdnsrecords-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* Domain Name Administrator -* Global Reader +The work or school account needs to belong to at least the *Domain Name Administrator* or *Global Reader* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Domain List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/domain-list.md | Title: "List domains" description: "Retrieve a list of domain objects."-+ ms.localizationpriority: medium doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "domain_list" } --> [!INCLUDE [permissions-table](../includes/permissions/domain-list-permissions.md)] -The work or school account needs to belong to one of the following roles: +The work or school account needs to belong to one of the following Microsoft Entra roles: -* Global Administrator * User Administrator * Helpdesk Administrator * Service Support Administrator |
v1.0 | Domain Post Domains | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/domain-post-domains.md | Title: "Create domain" description: "Adds a domain to the tenant."-+ ms.localizationpriority: medium doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "domain_post_domains" } --> [!INCLUDE [permissions-table](../includes/permissions/domain-post-domains-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* Domain Name Administrator +The work or school account needs to belong to at least the *Domain Name Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request |
v1.0 | Domain Post Federationconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/domain-post-federationconfiguration.md | Title: "Create internalDomainFederation" description: "Create a new internalDomainFederation object." ms.localizationpriority: medium-+ doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "domain_post_federationconfiguration" } --> [!INCLUDE [permissions-table](../includes/permissions/domain-post-federationconfiguration-permissions.md)] +> [!IMPORTANT] +> This method has a [known permissions issue](https://developer.microsoft.com/en-us/graph/known-issues/?search=21445) and might require consenting to the *Directory.AccessAsUser.All* permission for delegated scenarios. + [!INCLUDE [rbac-domainfederation-apis-write](../includes/rbac-for-apis/rbac-domainfederation-apis-write.md)] ## HTTP request You can specify the following properties when creating an **internalDomainFedera |displayName|String|The display name of the federated identity provider.| |issuerUri|String|Issuer URI of the federation server.| |metadataExchangeUri|String|URI of the metadata exchange endpoint used for authentication from rich client applications.|-|signingCertificate|String|Current certificate used to sign tokens passed to the Microsoft identity platform. The certificate is formatted as a Base64 encoded string of the public portion of the federated IdP's token signing certificate and must be compatible with the X509Certificate2 class. <br>This property is used in the following scenarios: <li> If a rollover is required outside of the autorollover update <li> A new federation service is being set up <li> If the new token signing certificate isn't present in the federation properties after the federation service certificate has been updated.<br>Microsoft Entra ID updates certificates via an autorollover process in which it attempts to retrieve a new certificate from the federation service metadata, 30 days before expiry of the current certificate. If a new certificate isn't available, Microsoft Entra ID monitors the metadata daily and will update the federation settings for the domain when a new certificate is available.| +|signingCertificate|String|Current certificate used to sign tokens passed to the Microsoft identity platform. The certificate is formatted as a Base 64 encoded string of the public portion of the federated IdP's token signing certificate and must be compatible with the X509Certificate2 class. <br>This property is used in the following scenarios: <li> If a rollover is required outside of the autorollover update <li> A new federation service is being set up <li> If the new token signing certificate isn't present in the federation properties after the federation service certificate has been updated.<br>Microsoft Entra ID updates certificates via an autorollover process in which it attempts to retrieve a new certificate from the federation service metadata, 30 days before expiry of the current certificate. If a new certificate isn't available, Microsoft Entra ID monitors the metadata daily and updates the federation settings for the domain when a new certificate is available.| |passiveSignInUri|String|URI that web-based clients are directed to when signing in to Microsoft Entra services.| |preferredAuthenticationProtocol|authenticationProtocol|Preferred authentication protocol. The possible values are: `wsFed`, `saml`, `unknownFutureValue`.| |activeSignInUri|String|URL of the endpoint used by active clients when authenticating with federated domains set up for single sign-on in Microsoft Entra ID. Corresponds to the **ActiveLogOnUri** property of the [Set-MsolDomainFederationSettings MSOnline v1 PowerShell cmdlet](/powershell/module/msonline/set-msoldomainfederationsettings).| |signOutUri|String|URI that clients are redirected to when they sign out of Microsoft Entra services. Corresponds to the **LogOffUri** property of the [Set-MsolDomainFederationSettings MSOnline v1 PowerShell cmdlet](/powershell/module/msonline/set-msoldomainfederationsettings).| |promptLoginBehavior|promptLoginBehavior|Sets the preferred behavior for the sign-in prompt. The possible values are: `translateToFreshPasswordAuthentication`, `nativeSupport`, `disabled`, `unknownFutureValue`.|-|isSignedAuthenticationRequestRequired|Boolean|If true, when SAML authentication requests are sent to the federated SAML IDP, Microsoft Entra ID will sign those requests using the OrgID signing key. If false (default), the SAML authentication requests sent to the federated IDP are not signed.| -|nextSigningCertificate|String|Fallback token signing certificate that is used to sign tokens when the primary signing certificate expires. Formatted as Base64 encoded strings of the public portion of the federated IdP's token signing certificate. Needs to be compatible with the X509Certificate2 class. Much like the **signingCertificate**, the **nextSigningCertificate** property is used if a rollover is required outside of the auto-rollover update, a new federation service is being set up, or if the new token signing certificate is not present in the federation properties after the federation service certificate has been updated.| +|isSignedAuthenticationRequestRequired|Boolean|If true, when SAML authentication requests are sent to the federated SAML IDP, Microsoft Entra ID signs those requests using the OrgID signing key. If false (default), the SAML authentication requests sent to the federated IDP aren't signed.| +|nextSigningCertificate|String|Fallback token signing certificate that is used to sign tokens when the primary signing certificate expires. Formatted as Base 64 encoded strings of the public portion of the federated IdP's token signing certificate. Needs to be compatible with the X509Certificate2 class. Much like the **signingCertificate**, the **nextSigningCertificate** property is used if a rollover is required outside of the autorollover update, a new federation service is being set up, or if the new token signing certificate isn't present in the federation properties after the federation service certificate has been updated.| |signingCertificateUpdateStatus|[signingCertificateUpdateStatus](../resources/signingcertificateupdatestatus.md)|Provides status and timestamp of the last update of the signing certificate.| |federatedIdpMfaBehavior|federatedIdpMfaBehavior|Determines whether Microsoft Entra ID accepts the MFA performed by the federated IdP when a federated user accesses an application that is governed by a conditional access policy that requires MFA. The possible values are: `acceptIfMfaDoneByFederatedIdp`, `enforceMfaByFederatedIdp`, `rejectMfaByFederatedIdp`, `unknownFutureValue`. For more information, see [federatedIdpMfaBehavior values](#federatedidpmfabehavior-values).| + ### federatedIdpMfaBehavior values | Member | Description | Content-Type: application/json "federatedIdpMfaBehavior": "rejectMfaByFederatedIdp" } ```++<!-- +{ + "type": "#page.annotation", + "description": "", + "keywords": "", + "section": "documentation", + "tocPath": "", + "suppressions": [ + "Error: /api/domain-post-federationconfiguration.md: + Exception processing links. + Link Definition was null. Link text: !INCLUDE Azure AD PowerShell deprecation note (Parameter 'Definition')" + ] +} +--> |
v1.0 | Domain Promote | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/domain-promote.md | Title: "domain: promote" description: "Promote a verified subdomain to the root domain."-+ ms.localizationpriority: medium doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "domain_promote" } --> [!INCLUDE [permissions-table](../includes/permissions/domain-promote-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* Domain Name Administrator +The work or school account needs to belong to at least the *Domain Name Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request |
v1.0 | Domain Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/domain-update.md | Title: "Update domain" description: "Update the properties of domain object."-+ ms.localizationpriority: medium doc_type: apiPageType doc_type: apiPageType Namespace: microsoft.graph -Update the properties of domain object. --> **Important:** -> Only verified domains can be updated. +Update the properties of [domain](../resources/domain.md) object. Only verified domains can be updated. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "domain_update" } --> [!INCLUDE [permissions-table](../includes/permissions/domain-update-permissions.md)] -The work or school account needs to belong to one of the following roles: +The work or school account needs to belong to at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): -* Global Administrator * Domain Name Administrator * Security Administrator * External Identity Provider Administrator |
v1.0 | Domain Verify | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/domain-verify.md | Title: "domain: verify" description: "Validates the ownership of the domain."-+ ms.localizationpriority: medium doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "domain_verify" } --> [!INCLUDE [permissions-table](../includes/permissions/domain-verify-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* Domain Name Administrator +The work or school account needs to belong to at least the *Domain Name Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). ## HTTP request |
v1.0 | Driveitem Get Content Format | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/driveitem-get-content-format.md | The following values are valid for the **format** parameter: | Format value | Description | Supported source extensions |:-|:--|- | pdf | Converts the item into PDF format. | csv, doc, docx, odp, ods, odt, pot, potm, potx, pps, ppsx, ppsxm, ppt, pptm, pptx, rtf, xls, xlsx+| html | Converts the item into HTML format.| loop, fluid, wbtx ## Request headers |
v1.0 | Educationassignment Activate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/educationassignment-activate.md | Namespace: microsoft.graph Activate an `inactive` [educationAssignment](../resources/educationassignment.md) to signal that the assignment has further action items for teachers or students. This action can only be performed by a teacher on currently inactive assignments. + ## 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). If successful, this method returns a `200 OK` response code and an [educationAss ### Request The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "sampleKeys": ["37d99af7-cfc5-4e3b-8566-f7d40e4a2070", "c0f133b9-615c-4119-876c-c1848fd0a99a"], The following example shows a request. POST https://graph.microsoft.com/v1.0/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/c0f133b9-615c-4119-876c-c1848fd0a99a/activate ``` +# [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. |
v1.0 | Educationassignment Deactivate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/educationassignment-deactivate.md | Namespace: microsoft.graph Mark an `assigned` [educationAssignment](../resources/educationassignment.md) as `inactive` to signal that the assignment has no further action items for teachers and students. This action can only be performed by a teacher on assigned assignments. + ## 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). The following example shows how to mark an assignment `inactive` without the opt #### Request The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "sampleKeys": ["37d99af7-cfc5-4e3b-8566-f7d40e4a2070", "c0f133b9-615c-4119-876c-c1848fd0a99a"], The following example shows a request. POST https://graph.microsoft.com/v1.0/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/c0f133b9-615c-4119-876c-c1848fd0a99a/deactivate ``` +# [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 when `Prefer: include-unknown-enum-members` isn't provided in the request header. The following example shows how to mark an assignment `inactive` using the optio #### Request The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "sampleKeys": ["37d99af7-cfc5-4e3b-8566-f7d40e4a2070", "2cb9ce0c-a4a1-40b8-b386-b43e0f05e7ed"], POST https://graph.microsoft.com/v1.0/education/classes/37d99af7-cfc5-4e3b-8566- Prefer: include-unknown-enum-members ``` +# [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 when `Prefer: include-unknown-enum-members` is provided in the request header. |
v1.0 | Educationclass Delete Members | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/educationclass-delete-members.md | The following example shows a request. "name": "create_educationclass_from_educationschool_1" }--> ```http-DELETE https://graph.microsoft.com/v1.0/education/classes/{class-id}/members/{member-id} +DELETE https://graph.microsoft.com/v1.0/education/classes/{class-id}/members/{member-id}/$ref ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/create-educationclass-from-educationschool-1-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) + ### Response |
v1.0 | Entitlementmanagement Post Assignmentrequests | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/entitlementmanagement-post-assignmentrequests.md | Namespace: microsoft.graph In [Microsoft Entra Entitlement Management](../resources/entitlementmanagement-overview.md), create a new [accessPackageAssignmentRequest](../resources/accesspackageassignmentrequest.md) object. This operation is used to assign a user to an access package, update the assignment, or to remove an access package assignment. - [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions If this is an `adminAdd` request, then subsequently an [accessPackageAssignment] ## Examples ### Example 1: Admin requests a direct assignment for a user already in the directory-#### Request --The following example shows a request for a direct assignment, in which the administrator is requesting the creation of an assignment for the user. Because the [accessPackageSubject](../resources/accesspackagesubject.md) might not yet exist, the value of the **targetID** is the object ID of the user being assigned, the value of the **accessPackageId** is the desired access package for that user, and the value of **assignmentPolicyId** is a direct assignment policy in that access package. +#### Request +The following example shows a request for a direct assignment, in which the administrator requests the creation of an assignment for a user. Because the [accessPackageSubject](../resources/accesspackagesubject.md) might not yet exist, the value of the **targetID** is the object ID of the user being assigned, the value of the **accessPackageId** is the desired access package for that user, and the value of **assignmentPolicyId** is a direct assignment policy in that access package. # [HTTP](#tab/http) <!-- { HTTP/1.1 201 Created Content-type: application/json {-- "id": "7e382d02-4454-436b-b700-59c7dd77f466", + "id": "46184453-e63b-4f20-86c2-c557ed5d5df9", "requestType": "adminAdd", "requestState": "Submitted", "requestStatus": "Accepted" Content-type: application/json ### Example 2: Remove an assignment -To remove assignments, create a new accessPackageAssignmentRequest object with the following settings: +To remove assignments, create a new **accessPackageAssignmentRequest** object with the following settings: -+ The value of the **requestType** property set to `adminRemove`. -+ In the assignment property, include an object with the identifier of the accessPackageAssignment object to delete. +* The value of the **requestType** property set to `adminRemove`. +* In the **assignment** property, include an object with the identifier of the **accessPackageAssignment** object to delete. #### Request The following example shows how to remove an assignment. - # [HTTP](#tab/http) <!-- { "blockType": "request", Content-type: application/json The following example shows the response. -> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call. +> **Note:** The response object shown here might be shortened for readability. All the properties are returned from an actual call. <!-- { "blockType": "response", Content-type: application/json { "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#accessPackageAssignmentRequests/$entity",- "id": "78eaee8c-e6cf-48c9-8f99-aae44c35e379", "requestType": "adminRemove", "requestState": "Submitted", Content-type: application/json } ``` -### Example 3: Request an assignment +### Example 3: Request an assignment by providing answers to questions -The following example shows how a user can request an access package assignment for themselves. +The following example shows how a user can request an access package assignment for themselves by answering questions required by the policy during the request process. #### Request +The following example shows a request. # [HTTP](#tab/http) <!-- { "blockType": "request",- "name": "create_accesspackageassignmentrequest_from_accesspackageassignmentrequests_packageID" + "name": "create_accesspackageassignmentrequest_from_accesspackageassignmentrequests_requestor_answer_approver" }-->+ ```http POST https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/assignmentRequests Content-type: application/json {+ "@odata.type": "#microsoft.graph.accessPackageAssignmentRequest", "requestType": "userAdd",+ "answers": [ + { + "@odata.type": "#microsoft.graph.accessPackageAnswerString", + "displayValue": "This is the answer to a multiple choice question", + "value": "MultipleChoiceAnswerValue", + "answeredQuestion": { + "@odata.type": "#microsoft.graph.accessPackageMultipleChoiceQuestion", + "id": "8fe745e7-80b2-490d-bd22-4e708c77288c" + } + }, + { + "@odata.type": "#microsoft.graph.accessPackageAnswerString", + "value": "This is my answer to a text input question.", + "displayValue": "This is my answer.", + "answeredQuestion": { + "@odata.type": "#microsoft.graph.accessPackageTextInputQuestion", + "id": "7aaa18c9-8e4f-440f-bd5a-3a7ce312cbe6" + } + } + ], "assignment": {- "accessPackageId": "d7be3253-b9c6-4fab-adef-30d30de8da2b" + "accessPackageId": "977c7ff4-ef8f-4910-9d31-49048ddf3120" } } ``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [CLI](#tab/cli) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] Content-type: application/json The following example shows the response. -> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call. +> **Note:** The response object shown here might be shortened for readability. All the properties are returned from an actual call. <!-- { "blockType": "response", HTTP/1.1 201 Created Content-type: application/json {- "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identityGovernance/entitlementManagement/assignmentRequests/$entity", - "id": "724bc62d-90ff-48f3-903f-b59ec8453343", + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#accessPackageAssignmentRequests/$entity", + "id": "7a6ab703-0780-4b37-8445-81f679b2d75c", "requestType": "userAdd",- "state": "submitted" + "state": "submitted", + "status": "Accepted", + "createdDateTime": null, + "completedDateTime": null, + "schedule": { + "startDateTime": null, + "recurrence": null, + "expiration": { + "endDateTime": null, + "duration": null, + "type": "notSpecified" + } + }, + "answers": [ + { + "@odata.type": "#microsoft.graph.accessPackageAnswerString", + "value": "MultipleChoiceAnswerValue", + "answeredQuestion": { + "@odata.type": "#microsoft.graph.accessPackageMultipleChoiceQuestion", + "id": "8fe745e7-80b2-490d-bd22-4e708c77288c" + }, + "displayValue": "This is the answer to a multiple choice question" + }, + { + "@odata.type": "#microsoft.graph.accessPackageAnswerString", + "value": "This is my answer to a text input question.", + "answeredQuestion": { + "@odata.type": "#microsoft.graph.accessPackageTextInputQuestion", + "id": "7aaa18c9-8e4f-440f-bd5a-3a7ce312cbe6" + }, + "displayValue": "This is my answer." + } + ] } ``` +### Example 4: Request a package and provide a justification -### Example 4: Request an assignment by providing answers to questions --The following example shows how a user can request an access package assignment for themselves by answering questions required by the policy while making the request. +The following example shows how to request an access package and provide justification to the approver. #### Request +The following example shows a request. + # [HTTP](#tab/http) <!-- { "blockType": "request",- "name": "create_accesspackageassignmentrequest_from_accesspackageassignmentrequests_requestor_answer_to_approver" + "name": "create_assignmentrequests_from_assignmentrequests_justification_provided" }--> ```http POST https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/a Content-type: application/json {- "@odata.type": "#microsoft.graph.accessPackageAssignmentRequest", - "requestType": "userAdd", - "answers": [ - { - "@odata.type": "#microsoft.graph.accessPackageAnswerString", - "displayValue": "This is the answer to a multiple choice question", - "value": "MultipleChoiceAnswerValue", - "answeredQuestion": { - "@odata.type": "#microsoft.graph.accessPackageMultipleChoiceQuestion", - "id": "8fe745e7-80b2-490d-bd22-4e708c77288c" - } - }, - { - "@odata.type": "#microsoft.graph.accessPackageAnswerString", - "value": "This is my answer to a text input question.", - "displayValue": "This is my answer.", - "answeredQuestion": { - "@odata.type": "#microsoft.graph.accessPackageTextInputQuestion", - "id": "7aaa18c9-8e4f-440f-bd5a-3a7ce312cbe6" - } - } - ], - "assignment": { - "accessPackageId": "977c7ff4-ef8f-4910-9d31-49048ddf3120" - } + "requestType": "UserAdd", + "accessPackageAssignment": { + "accessPackageId": "a914b616-e04e-476b-aa37-91038f0b165b" + }, + "justification":"Need access to New Hire access package" } ``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [CLI](#tab/cli) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] Content-type: application/json The following example shows the response. -> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call. +> **Note:** The response object shown here might be shortened for readability. All the properties are returned from an actual call. <!-- { "blockType": "response", HTTP/1.1 201 Created Content-type: application/json {- "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#accessPackageAssignmentRequests/$entity", - "id": "7a6ab703-0780-4b37-8445-81f679b2d75c", - "requestType": "userAdd", - "state": "submitted", - "status": "Accepted", + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identityGovernance/entitlementManagement/assignmentRequests/$entity", + "id": "9c1e258d-7723-43b1-ae21-e6eeeb324fe5", + "requestType": "UserAdd", + "requestState": "Submitted", + "requestStatus": "Accepted", "createdDateTime": null,- "completedDateTime": null, + "completedDate": null, + "justification": "Need access to New Hire access package", + "isValidationOnly": false, "schedule": { "startDateTime": null, "recurrence": null, Content-type: application/json "type": "notSpecified" } },- "answers": [ - { - "@odata.type": "#microsoft.graph.accessPackageAnswerString", - "value": "MultipleChoiceAnswerValue", - "answeredQuestion": { - "@odata.type": "#microsoft.graph.accessPackageMultipleChoiceQuestion", - "id": "8fe745e7-80b2-490d-bd22-4e708c77288c" - }, - "displayValue": "This is the answer to a multiple choice question" - }, - { - "@odata.type": "#microsoft.graph.accessPackageAnswerString", - "value": "This is my answer to a text input question.", - "answeredQuestion": { - "@odata.type": "#microsoft.graph.accessPackageTextInputQuestion", - "id": "7aaa18c9-8e4f-440f-bd5a-3a7ce312cbe6" - }, - "displayValue": "This is my answer." - } - ] + "answers": [], + "verifiedCredentialsData": [] } ``` +### Example 5: Admin requests a direct assignment for a user not yet in the directory -### Example 5: Request an update to answers for an assignment +#### Request ++The following example shows a request for a direct assignment, in which the administrator requests the creation of an assignment for a user who doesn't exist in the directory. The value of the **accessPackageId** is the desired access package for that user, and the value of **assignmentPolicyId** is a direct assignment policy in that access package. -The following example shows how an admin can request updates to an assignment to edit their responses to questions that were answered while requesting the assignment. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_assignmentrequest_from_assignmentrequests_direct_assignment" +}--> ++```http +POST https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/assignmentRequests +Content-type: application/json ++{ + "requestType": "AdminAdd", + "accessPackageAssignment":{ + "target": { + "email": "user@contoso.com" + }, + "assignmentPolicyId":"2264bf65-76ba-417b-a27d-54d291f0cbc8", + "accessPackageId":"a914b616-e04e-476b-aa37-91038f0b165b" + } +} +``` ++# [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. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.accessPackageAssignmentRequest" +} --> ++```http +HTTP/1.1 201 Created +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identityGovernance/entitlementManagement/assignmentRequests/$entity", + "id": "cb32aef9-2976-496d-9804-eb432fd894a7", + "requestType": "AdminAdd", + "requestState": "Submitted", + "requestStatus": "Accepted", + "createdDateTime": null, + "completedDate": null, + "justification": null, + "isValidationOnly": false, + "schedule": { + "startDateTime": null, + "recurrence": null, + "expiration": { + "endDateTime": null, + "duration": null, + "type": "notSpecified" + } + }, + "answers": [], + "verifiedCredentialsData": [], + "customExtensionHandlerInstances": [], + "customExtensionCalloutInstances": [] +} +``` ++### Example 6: Request an update to answers for an assignment ++The following example shows how an admin can request updates to an assignment to edit their responses to questions that were answered during the request for the assignment. #### Request +The following example shows a request. + # [HTTP](#tab/http) <!-- { "blockType": "request",- "name": "update_accesspackageassignmentrequest_from_accesspackageassignmentrequests_requestor_answer_to_approver" + "name": "update_accesspackageassignmentrequest_from_assignmentrequests_requestor_answer_to_approver" }--> ```http POST https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/assignmentRequests Content-type: application/json ``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [CLI](#tab/cli) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] Content-type: application/json The following example shows the response. -> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call. +> **Note:** The response object shown here might be shortened for readability. All the properties are returned from an actual call. <!-- { "blockType": "response", Content-type: application/json ] } ```++<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98 +2019-02-04 14:57:30 UTC --> +<!-- { + "type": "#page.annotation", + "description": "Create accessPackageAssignmentRequest", + "keywords": "", + "section": "documentation", + "tocPath": "" +}--> |
v1.0 | Extensionproperty Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/extensionproperty-delete.md | Title: "Delete extensionProperty (directory extension)" description: "Delete a directory extension definition." ms.localizationpriority: medium + doc_type: "apiPageType" |
v1.0 | Extensionproperty Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/extensionproperty-get.md | Title: "Get extensionProperty (directory extension)" description: "Read a directory extension definition." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Federatedidentitycredential Upsert | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/federatedidentitycredential-upsert.md | + + Title: "Upsert federatedIdentityCredential" +description: "Create a new federatedIdentityCredential object if it doesn't exist, or update the properties of an existing federatedIdentityCredential object." ++ms.localizationpriority: medium ++++# Upsert federatedIdentityCredential +Namespace: microsoft.graph ++Create a new [federatedIdentityCredential](../resources/federatedidentitycredential.md) object for an application if it does exist, or update the properties of an existing [federatedIdentityCredential](../resources/federatedidentitycredential.md) object. By [configuring a trust relationship](/azure/active-directory/develop/workload-identity-federation-create-trust) between your Microsoft Entra application registration and the identity provider for your compute platform, you can use tokens issued by that platform to authenticate with Microsoft identity platform and call APIs in the Microsoft ecosystem. Maximum of 20 objects can be added to an application. +++## 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": "application_post_federatedidentitycredentials" } --> ++## HTTP request ++You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in app registrations in the Microsoft Entra admin center. +<!-- { "blockType": "ignored" } --> +```http +PATCH /applications/{id}/federatedIdentityCredentials(name='{name}') +PATCH /applications(appId='{appId}')/federatedIdentityCredentials(name='{name}') +``` ++## Request headers ++|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Content-Type|application/json. Required.| +| Prefer | `create-if-missing`. Required for upsert behavior, otherwise the request is treated as an update operation. | ++## Request body ++In the request body, supply a JSON representation of the [federatedIdentityCredential](../resources/federatedidentitycredential.md) object. +The following table lists the properties that are required when you create the [federatedIdentityCredential](../resources/federatedidentitycredential.md). Note that the **name** property is required as part of the request URL. ++|Property|Type|Description| +|:|:|:| +|audiences|String collection|The audience that can appear in the external token. This field is mandatory and should be set to `api://AzureADTokenExchange` for Microsoft Entra ID. It says what Microsoft identity platform should accept in the `aud` claim in the incoming token. This value represents Microsoft Entra ID in your external identity provider and has no fixed value across identity providers - you may need to create a new application registration in your identity provider to serve as the audience of this token. This field can only accept a single value and has a limit of 600 characters. Required.| +|issuer|String|TThe URL of the external identity provider and must match the issuer claim of the external token being exchanged. The combination of the values of **issuer** and **subject** must be unique on the app. It has a limit of 600 characters. Required.| +|subject|String|Required. The identifier of the external software workload within the external identity provider. Like the audience value, it has no fixed format, as each identity provider uses their own - sometimes a GUID, sometimes a colon delimited identifier, sometimes arbitrary strings. The value here must match the sub claim within the token presented to Microsoft Entra ID. It has a limit of 600 characters. The combination of **issuer** and **subject** must be unique on the app.| ++## Response ++If successful, if an application object with **name** doesn't exist, this method returns a `201 Created` response code and a new [federatedIdentityCredential](../resources/federatedidentitycredential.md) object in the response body. ++If an application object with **name** already exists, this method updates the [federatedIdentityCredential](../resources/federatedidentitycredential.md) object and returns a `204 No Content` response code. ++## Examples ++### Example 1: Create a new federatedIdentityCredential if it doesn't exist ++The following example creates a federatedIdentityCredential because a federatedIdentityCredential with the specified **name** value doesn't exist. ++### Request ++The following example shows a request. +<!-- { + "blockType": "request", + "name": "upsert_federatedidentitycredential_create" +} +--> +``` http +PATCH https://graph.microsoft.com/v1.0/applications(uniqueName='app-65278')/federatedIdentityCredentials(name='fic01-app-65278') +Content-Type: application/json ++{ + "issuer": "https://login.microsoftonline.com/3d1e2be9-a10a-4a0c-8380-7ce190f98ed9/v2.0", + "subject": "a7d388c3-5e3f-4959-ac7d-786b3383006a", + "audiences": [ + "api://AzureADTokenExchange" + ] +} +``` ++### 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.federatedIdentityCredential" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#applications('bcd7c908-1c4d-4d48-93ee-ff38349a75c8')/federatedIdentityCredentials/$entity", + "id": "d9b7bf1e-429e-4678-8132-9b00c9846cc4", + "name": "testing02fic01-app-65278", + "issuer": "https://login.microsoftonline.com/3d1e2be9-a10a-4a0c-8380-7ce190f98ed9/v2.0", + "subject": "a7d388c3-5e3f-4959-ac7d-786b3383006a", + "description": null, + "audiences": [ + "api://AzureADTokenExchange" + ] +} +``` ++### Example 2: Update an existing federatedIdentityCredential ++The following example updates the federatedIdentityCredential because a federatedIdentityCredential with the specified **name** value exists. ++#### Request ++The following example shows a request. +<!-- { + "blockType": "request", + "name": "federatedIdentityCredential_upsert_update" +} +--> ++``` http +PATCH https://graph.microsoft.com/v1.0/applications(uniqueName='app-65278')/federatedIdentityCredentials(name='fic01-app-65278') +Content-Type: application/json +Prefer: create-if-missing ++{ + "issuer": "https://login.microsoftonline.com/3d1e2be9-a10a-4a0c-8380-7ce190f98ed9/v2.0", + "subject": "a7d388c3-5e3f-4959-ac7d-786b3383006a", + "audiences": [ + "api://AzureADTokenExchange" + ] +} +``` ++#### Response ++The following example shows the response. +<!-- { + "blockType": "response" +} +--> ++``` http +HTTP/1.1 204 No Content +``` |
v1.0 | Group Assignlicense | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/group-assignlicense.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "group_assignlicense" } --> [!INCLUDE [permissions-table](../includes/permissions/group-assignlicense-permissions.md)] -For delegated scenarios, the calling user needs one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). +For delegated scenarios, the calling user needs at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). - Directory Writers - Groups Administrator - License Administrator - User Administrator-- Global Administrator ## HTTP request |
v1.0 | Group Delete Acceptedsenders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/group-delete-acceptedsenders.md | DELETE https://graph.microsoft.com/v1.0/groups/{id}/acceptedSenders/$ref?$id=htt [!INCLUDE [sample-code](../includes/snippets/php/delete-acceptedsenders-from-group-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-acceptedsenders-from-group-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Group Delete Rejectedsenders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/group-delete-rejectedsenders.md | DELETE https://graph.microsoft.com/v1.0/groups/{id}/rejectedSenders/$ref?$id=htt [!INCLUDE [sample-code](../includes/snippets/php/remove-rejectedsender-from-group-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/remove-rejectedsender-from-group-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Group Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/group-delete.md | Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/group-delete-permissions.md)] The following conditions apply for apps to delete role-assignable groups:-+ For delegated scenarios, the app must be assigned the _RoleManagement.ReadWrite.Directory_ delegated permission, and the calling user must be the creator of the group or a global administrator or a privileged role administrator. -+ For app-only scenarios, the calling app must be the owner of the group or be assigned the _RoleManagement.ReadWrite.Directory_ application permission or be assigned the Global Administrator or Privileged Role Administrator Microsoft Entra role. ++ For delegated scenarios, the app must be assigned the _RoleManagement.ReadWrite.Directory_ delegated permission, and the calling user must be the creator of the group or be assigned at least the Privileged Role Administrator Microsoft Entra role.++ For app-only scenarios, the calling app must be the owner of the group or be assigned the _RoleManagement.ReadWrite.Directory_ application permission or be assigned at least the Privileged Role Administrator Microsoft Entra role. ## HTTP request |
v1.0 | Group Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/group-update.md | The following table specifies the properties that can be updated. | mailNickname | String | The mail alias for the group, unique for Microsoft 365 groups in the organization. Maximum length is 64 characters. This property can contain only characters in the [ASCII character set 0 - 127](/office/vba/language/reference/user-interface-help/character-set-0127) except the following: ` @ () \ [] " ; : . <> , SPACE`. | | preferredDataLocation | String | The preferred data location for the Microsoft 365 group. To update this property, the calling user must be assigned one of the following Microsoft Entra roles: <br><ul><li> Global Administrator <li> User Account Administrator <li> Directory Writer <li> Exchange Administrator <li> SharePoint Administrator </ul> <br/>For more information about this property, see [OneDrive Online Multi-Geo](/sharepoint/dev/solution-guidance/multigeo-introduction). | | securityEnabled | Boolean | Specifies whether the group is a security group. |+| uniqueName | String | The unique identifier that can be assigned to a group and used as an alternate key. Can updated only if `null` and is immutable once set. | | visibility | String | Specifies the visibility of a Microsoft 365 group. The possible values are: **Private**, **Public**, or empty (which is interpreted as **Public**). | > [!IMPORTANT] |
v1.0 | Group Upsert | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/group-upsert.md | + + Title: "Upsert group" +description: "Create a new Microsoft 365 group or security group if it doesn't exist, or update the properties of an existing group object." ++ms.localizationpriority: medium ++++# Upsert group ++Namespace: microsoft.graph ++Create a new [group](../resources/group.md) object if it doesn't exist, or update the properties of an existing [group](../resources/group.md) object. +You can create or update the following types of group: ++- Microsoft 365 group (unified group) +- Security group ++ By default, this operation returns only a subset of the properties for each group. For a list of properties that are returned by default, see the [Properties](../resources/group.md#properties) section of the [group](../resources/group.md) resource. To get properties that are _not_ returned by default, do a [GET operation](group-get.md) and specify the properties in a `$select` OData query option. ++>**Note**: To create a [team](../resources/team.md), first create a group then add a team to it. For more information, see [Create team](../api/team-put-teams.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": "group_post_groups" } --> ++In order for an app with Group.Create permission to create a group with owners or members, it must have the privileges to read the object type that it wants to assign as the group owner or member. Therefore: ++- The app can assign itself as the group's owner or member. +- To create the group with users as owners or members, the app must have at least the *User.Read.All* permission. +- To create the group with other service principals as owners or members, the app must have at least the *Application.Read.All* permission. +- To create the group with either users or service principals as owners or members, the app must have at least the *Directory.Read.All* permission. ++## HTTP request ++<!-- { "blockType": "ignored" } --> ++``` http +PATCH /groups/(uniqueName='uniqueName') +``` ++## Request headers ++| Name | Description | +|:--|:| +| Authorization | Bearer {token}. Required.| +| Content-Type | application/json. Required.| +| Prefer | `create-if-missing`. Required for upsert behavior, otherwise the request is treated as an update operation. | ++## Request body ++In the request body, supply a JSON representation of the [group](../resources/group.md) object. ++The following table lists the properties that are required when you create the [group](../resources/group.md). Specify other writable properties as necessary for your group on creation or update. ++| Property | Type | Description | +| :-- | : | :-- | +| displayName | String | The name to display in the address book for the group. Maximum length is 256 characters. Required. | +| mailEnabled | Boolean | Set to `true` for mail-enabled groups. Required. | +| mailNickname | String | The mail alias for the group, unique for Microsoft 365 groups in the organization. Maximum length is 64 characters. This property can contain only characters in the [ASCII character set 0 - 127](/office/vba/language/reference/user-interface-help/character-set-0127) except the following: ` @ () \ [] " ; : <> , SPACE`. Required. | +| securityEnabled | Boolean | Set to `true` for security-enabled groups, including Microsoft 365 groups. Required. **Note:** Groups created using the Microsoft Entra admin center or the Azure portal always have **securityEnabled** initially set to `true`. | ++> [!IMPORTANT] +> +> - Creating a group using the **Group.Create** application permission without specifying owners will create the group anonymously and the group will not be modifiable. Add owners to the group while creating it to specify owners who can modify the group. +> - Creating a Microsoft 365 group programmatically with an app-only context and without specifying owners will create the group anonymously. Doing so can result in the associated SharePoint Online site not being created automatically until further manual action is taken. +> - The following properties can't be set in the initial POST request and must be set in a subsequent PATCH request: **allowExternalSenders**, **autoSubscribeNewMembers**, **hideFromAddressLists**, **hideFromOutlookClients**, **isSubscribedByMail**, **unseenCount**. ++Because the **group** resource supports [extensions](/graph/extensibility-overview), you can add custom properties with your own data to the group while creating it. ++### groupTypes options ++Use the **groupTypes** property to control the type of group and its membership, as shown. ++| Type of group | Assigned membership | Dynamic membership | +| :-- | : | :-- | +| Microsoft 365 (aka unified group) | `["Unified"]` | `["Unified","DynamicMembership"]` | +| Dynamic | `[]` (_null_) | `["DynamicMembership"]` | ++## Response ++If successful, if the object with the **uniqueName** doesn't exist, this method returns a `201 Created` response code and a new [group](../resources/group.md) object in the response body. ++If the object with the **uniqueName** already exists, this method updates the [group](../resources/group.md) object and returns a `204 No Content` response code. ++## Examples ++### Example 1: Create a Microsoft 365 group if it doesn't exist ++The following example creates a Microsoft 365 group because a group with the specified **uniqueName** value does not exist. Because the owners have not been specified, the calling user is automatically added as the owner of the group. ++#### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "upsert_group_create" +}--> ++```http +PATCH https://graph.microsoft.com/v1.0/groups(uniqueName='uniqueName') +Content-type: application/json +Prefer: create-if-missing ++{ + "description": "Self help community for golf", + "displayName": "Golf Assist", + "groupTypes": [ + "Unified" + ], + "mailEnabled": true, + "mailNickname": "golfassist", + "securityEnabled": false +} +``` ++# [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. The value of the **preferredDataLocation** property is inherited from the group creator's preferred data location. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.group" +} --> ++```http +HTTP/1.1 201 Created +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groups/$entity", + "id": "45b7d2e7-b882-4a80-ba97-10b7a63b8fa4", + "deletedDateTime": null, + "classification": null, + "createdDateTime": "2018-12-22T02:21:05Z", + "description": "Self help community for golf", + "displayName": "Golf Assist", + "expirationDateTime": null, + "groupTypes": [ + "Unified" + ], + "isAssignableToRole": null, + "mail": "golfassist@contoso.com", + "mailEnabled": true, + "mailNickname": "golfassist", + "membershipRule": null, + "membershipRuleProcessingState": null, + "onPremisesLastSyncDateTime": null, + "onPremisesSecurityIdentifier": null, + "onPremisesSyncEnabled": null, + "preferredDataLocation": "CAN", + "preferredLanguage": null, + "proxyAddresses": [ + "SMTP:golfassist@contoso.onmicrosoft.com" + ], + "renewedDateTime": "2018-12-22T02:21:05Z", + "resourceBehaviorOptions": [], + "resourceProvisioningOptions": [], + "securityEnabled": false, + "securityIdentifier": "S-1-12-1-1753967289-1089268234-832641959-555555555", + "theme": null, + "visibility": "Public", + "uniqueName": "uniqueName", + "onPremisesProvisioningErrors": [] +} +``` ++### Example 2: Create a security group with an owner and members if it doesn't exist ++The following example creates a security group with an owner and members specified because a group with the specified **uniqueName** value does not exist. Note that a maximum of 20 relationships, such as owners and members, can be added as part of group creation. You can subsequently add multiple additional members by using the [add member](group-post-members.md) API or JSON batching. ++#### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "upsert_create_prepopulated_group" +}--> ++```http +PATCH https://graph.microsoft.com/v1.0/groups(uniqueName='uniqueName') +Content-Type: application/json ++{ + "description": "Group with designated owner and members", + "displayName": "Operations group", + "groupTypes": [ + ], + "mailEnabled": false, + "mailNickname": "operations2019", + "securityEnabled": true, + "owners@odata.bind": [ + "https://graph.microsoft.com/v1.0/users/26be1845-4119-4801-a799-aea79d09f1a2" + ], + "members@odata.bind": [ + "https://graph.microsoft.com/v1.0/users/ff7cb387-6688-423c-8188-3da9532a73cc", + "https://graph.microsoft.com/v1.0/users/69456242-0067-49d3-ba96-9de6f2728e14" + ] +} +``` ++# [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 is an example of a successful response. It includes only default properties. You can subsequently get the **owners** or **members** navigation properties of the group to verify the owner or members. The value of the **preferredDataLocation** property is inherited from the group creator's preferred data location. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.group" +} --> ++```http +HTTP/1.1 201 Created +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groups/$entity", + "@odata.id": "https://graph.microsoft.com/v2/84841066-274d-4ec0-a5c1-276be684bdd3/directoryObjects/1226170d-83d5-49b8-99ab-d1ab3d91333e/Microsoft.DirectoryServices.Group", + "id": "1226170d-83d5-49b8-99ab-d1ab3d91333e", + "deletedDateTime": null, + "classification": null, + "createdDateTime": "2021-09-21T07:14:44Z", + "createdByAppId": "de8bc8b5-d9f9-48b1-a8ad-b748da725064", + "organizationId": "84841066-274d-4ec0-a5c1-276be684bdd3", + "description": "Group with designated owner and members", + "displayName": "Operations group", + "expirationDateTime": null, + "groupTypes": [], + "infoCatalogs": [], + "isAssignableToRole": null, + "isManagementRestricted": null, + "mail": null, + "mailEnabled": false, + "mailNickname": "operations2019", + "membershipRule": null, + "membershipRuleProcessingState": null, + "onPremisesDomainName": null, + "onPremisesLastSyncDateTime": null, + "onPremisesNetBiosName": null, + "onPremisesSamAccountName": null, + "onPremisesSecurityIdentifier": null, + "onPremisesSyncEnabled": null, + "preferredDataLocation": null, + "preferredLanguage": null, + "proxyAddresses": [], + "renewedDateTime": "2021-09-21T07:14:44Z", + "resourceBehaviorOptions": [], + "resourceProvisioningOptions": [], + "securityEnabled": true, + "securityIdentifier": "S-1-12-1-304486157-1236829141-2882644889-1043566909", + "theme": null, + "uniqueName": "uniqueName", + "visibility": null, + "writebackConfiguration": { + "isEnabled": null, + "onPremisesGroupType": null + }, + "onPremisesProvisioningErrors": [] +} +``` ++### Example 3: Update an existing group ++In this example, the specified group already exists, so the operation is treated as an update. ++#### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "upsert_update_prepopulated_group" +}--> ++```http +POST https://graph.microsoft.com/v1.0/groups +Content-Type: application/json ++{ + "description": "Group assignable to a role", + "displayName": "Role assignable group", + "groupTypes": [ + "Unified" + ], + "isAssignableToRole": true, + "mailEnabled": true, + "securityEnabled": true, + "mailNickname": "contosohelpdeskadministrators", + "owners@odata.bind": [ + "https://graph.microsoft.com/v1.0/users/99e44b05-c10b-4e95-a523-e2732bbaba1e" + ], + "members@odata.bind": [ + "https://graph.microsoft.com/v1.0/users/6ea91a8d-e32e-41a1-b7bd-d2d185eed0e0", + "https://graph.microsoft.com/v1.0/users/4562bcc8-c436-4f95-b7c0-4f8ce89dca5e" + ] +} +``` ++# [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. The value of the **preferredDataLocation** property is inherited from the group creator's preferred data location. ++<!-- { + "blockType": "response" +} --> ++``` http +HTTP/1.1 204 No Content +``` ++## Related content ++- [Add custom data to resources using extensions](/graph/extensibility-overview) +- [Add custom data to users using open extensions (preview)](/graph/extensibility-open-users) +- [Add custom data to groups using schema extensions (preview)](/graph/extensibility-schema-groups) |
v1.0 | Horizontalsection Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/horizontalsection-delete.md | + + Title: 'Delete horizontalSection' +description: 'Delete a horizontal section from a page.' ++ms.localizationpriority: medium +++# Delete horizontalSection ++Namespace: microsoft.graph ++Remove a [horizontalSection](../resources/horizontalSection.md) from a [sitePage](../resources/sitepage.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). ++> **Note:** To delete an item, the user must have granted the application write access to the item to be deleted. ++<!-- { "blockType": "permissions", "name": "horizontalsection_delete" } --> ++## HTTP request ++<!-- { "blockType": "ignored" } --> ++```http +DELETE /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/horizontalSections/{horizontal-section-id} +``` ++## Request headers ++| Name |Description| +|:-|:-| +| Authorization | Bearer \{token\}. Required. | ++## Request body ++Don't supply a request body with this method. ++## Response ++If successful, this call returns a `204 No Content` response to indicate that the resource was deleted and there was nothing to return. ++If the target horizontal section is not found, this method returns `404 Not Found`. ++## Example ++### Request ++The following example shows a request. ++<!-- { "blockType": "ignored" } --> ++``` http +DELETE https://graph.microsoft.com/v1.0/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/horizontalSections/1 +``` ++### Response ++The following example shows the response. ++<!-- { "blockType": "response" } --> ++```http +HTTP/1.1 204 No Content +``` |
v1.0 | Horizontalsection Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/horizontalsection-get.md | + + Title: 'Get horizontalSection' +description: 'Read the properties and relationships of a horizontalSection object.' ++ms.localizationpriority: medium +++# Get horizontalSection ++Namespace: microsoft.graph ++Read the properties and relationships of a [horizontalSection](../resources/horizontalsection.md) object. ++## 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": "horizontalsection_get" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +GET /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/horizontalSections/{horizontal-section-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 [horizontalSection](../resources/horizontalsection.md) object in the response body. ++## Examples ++### Example 1: Get a horizontalSection object ++#### Request ++The following is an example of a request. ++<!-- { "blockType": "ignored" } --> ++``` http +GET https://graph.microsoft.com/v1.0/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/horizontalSections/1 +``` ++#### 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.horizontalSection" +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "layout": "twoColumns", + "id": "1", + "emphasis": "soft" +} +``` ++### Example 2: Get a horizontalSection object using select and expand +#### Request ++With `$select` and `$expand` statements, you can retrieve horizontalSection metadata and column information in a single request. ++<!-- { "blockType": "ignored" } --> ++``` http +GET https://graph.microsoft.com/v1.0/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/horizontalSections/1?$select=id&$expand=columns +``` ++#### Response ++The following is an example of a request. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.horizontalSection" +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "layout": "twoColumns", + "id": "1", + "columns":[{ + "id": "1", + "width": 6 + },{ + "id": "2", + "width": 6 + }] +} +``` |
v1.0 | Horizontalsection List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/horizontalsection-list.md | + + Title: "List horizontalSections" +description: "Get a list of the horizontalSection objects and their properties." ++ms.localizationpriority: medium +++# List horizontalSections ++Namespace: microsoft.graph ++Get a list of the [horizontalSection](../resources/horizontalsection.md) objects and their properties. Sort by `id` in ascending order. ++## 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": "horizontalsection_list" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +GET /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/horizontalSections +``` ++## 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).| +| Content-Type | application/json. Required. | ++## 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 [horizontalSection](../resources/horizontalsection.md) objects in the response body. ++## Examples ++### Request ++The following is an example of a request. ++<!-- { "blockType": "ignored" } --> ++``` http +GET https://graph.microsoft.com/v1.0/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/horizontalSections +``` ++### 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.horizontalSection)" +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "@odata.type": "#microsoft.graph.horizontalSection", + "layout": "twoColumns", + "id": "1", + "emphasis": "soft" + }, + { + "@odata.type": "#microsoft.graph.horizontalSection", + "layout": "oneThirdRightColumn", + "id": "2", + "emphasis": "none" + } + ] +} +``` |
v1.0 | Horizontalsection Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/horizontalsection-update.md | + + Title: 'Update horizontalSection' +description: "Update the properties of a horizontalSection object." ++ms.localizationpriority: medium ++# Update horizontalSection ++Namespace: microsoft.graph ++Update the properties of a [horizontalSection](../resources/horizontalSection.md) object. ++## 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": "horizontalsection_update" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +PATCH /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/horizontalSections/{horizontal-section-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 [horizontalSection](../resources/horizontalSection.md) resource to update. ++## Response ++If successful, this method returns a `200 OK` response code and an updated [horizontalSection](../resources/horizontalSection.md) object in the response body. ++## Examples ++### Request ++The following is an example of a request. ++<!-- { "blockType": "ignored" } --> ++``` http +PATCH https://graph.microsoft.com/v1.0/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/horizontalSections/1 ++Content-Type: application/json ++{ + "emphasis": "strong", + "layout": "twoColumns", +} +``` ++### Response ++The following example shows the response. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "@odata.type": "microsoft.graph.horizontalSection", + "truncated": true +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "emphasis": "strong", + "layout": "twoColumns", + "id": "3", + "columns": [ + { + "id": "1", + "width": 6 + }, + { + "id": "2", + "width": 6 + } + ] +} +``` |
v1.0 | Horizontalsectioncolumn Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/horizontalsectioncolumn-get.md | + + Title: 'Get horizontalSectionColumn' +description: 'Read the properties and relationships of a horizontalSectionColumn object.' ++ms.localizationpriority: medium +++# Get horizontalSectionColumn ++Namespace: microsoft.graph ++++Read the properties and relationships of a [horizontalSectionColumn](../resources/horizontalsectioncolumn.md) object. ++## 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": "horizontalsectioncolumn_get" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +GET /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/horizontalSections/{horizontal-section-id}/columns/{horizontal-section-column-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 [horizontalSectionColumn](../resources/horizontalsectioncolumn.md) object in the response body. ++## Examples ++### Example 1: Get a horizontalSectionColumn +#### Request ++The following is an example of a request. ++<!-- { "blockType": "ignored" } --> ++```http +GET /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/horizontalSections/1/columns/1 +``` ++#### 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.horizontalSectionColumn" +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": { + "@odata.type": "#microsoft.graph.horizontalSectionColumn", + "id": "1", + "width": 6 + } +} +``` +### Example 2: Get a horizontalSectionColumn using select and expand +#### Request ++With `$select` and `$expand` statements, you can retrieve horizontalSectionColumn metadata and associated webParts in a single request. ++<!-- { "blockType": "ignored" } --> ++```http +GET /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/horizontalSections/1/columns/1?$select=id&$expand=webparts +``` ++#### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.horizontalSectionColumn" +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": { + "@odata.type": "#microsoft.graph.horizontalSectionColumn", + "id": "1", + "webparts":[{ + "@odata.type": "#microsoft.graph.textWebPart", + "id": "1212fc8d-dd6b-408a-8d5d-9f1cc787efbb", + "innerHtml": "<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Quisque vel.</p>" + }] + } +} +``` |
v1.0 | Horizontalsectioncolumn List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/horizontalsectioncolumn-list.md | + + Title: 'List horizontalSectionColumns' +description: 'Get a list of the horizontalSectionColumn objects and their properties.' ++ms.localizationpriority: medium +++# List horizontalSectionColumns ++Namespace: microsoft.graph ++++Get a list of the [horizontalSectionColumn](../resources/horizontalsectioncolumn.md) objects and their properties. Sort by `id` in ascending order. ++## 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": "horizontalsectioncolumn_list" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +GET /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/horizontalSections/{horizontal-section-id}/columns +``` ++## 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 [horizontalSectionColumn](../resources/horizontalsectioncolumn.md) objects in the response body. ++## Examples ++### Request ++The following is an example of a request. ++<!-- { "blockType": "ignored" } --> ++```http +GET /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202//microsoft.graph.sitePage/canvasLayout/horizontalSections/1/columns +``` ++### 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.horizontalSectionColumn)" +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "@odata.type": "#microsoft.graph.horizontalSectionColumn", + "id": "1", + "width": 6 + }, + { + "@odata.type": "#microsoft.graph.horizontalSectionColumn", + "id": "2", + "width": 6 + } + ] +} +``` |
v1.0 | Identityapiconnector Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identityapiconnector-create.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityapiconnector_create" } --> [!INCLUDE [permissions-table](../includes/permissions/identityapiconnector-create-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Identityapiconnector Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identityapiconnector-delete.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityapiconnector_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/identityapiconnector-delete-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Identityapiconnector Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identityapiconnector-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityapiconnector_get" } --> [!INCLUDE [permissions-table](../includes/permissions/identityapiconnector-get-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Identityapiconnector List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identityapiconnector-list.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityapiconnector_list" } --> [!INCLUDE [permissions-table](../includes/permissions/identityapiconnector-list-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Identityapiconnector Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identityapiconnector-update.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityapiconnector_update" } --> [!INCLUDE [permissions-table](../includes/permissions/identityapiconnector-update-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Identityapiconnector Uploadclientcertificate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identityapiconnector-uploadclientcertificate.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityapiconnector_uploadclientcertificate" } --> [!INCLUDE [permissions-table](../includes/permissions/identityapiconnector-uploadclientcertificate-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Identitycontainer List Authenticationeventlisteners | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identitycontainer-list-authenticationeventlisteners.md | + + Title: "List authenticationEventListeners" +description: "Get a list of the authenticationEventListener objects and their properties." ++ms.localizationpriority: medium ++++# List authenticationEventListeners +Namespace: microsoft.graph ++Get a list of the [authenticationEventListener](../resources/authenticationeventlistener.md) objects and their properties. The following derived types are supported: ++- [onTokenIssuanceStartListener](../resources/ontokenissuancestartlistener.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": "identitycontainer_list_authenticationeventlisteners" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /identity/authenticationEventListeners +``` ++## Optional query parameters +This method supports the `$filter` and `$expand` 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 [authenticationEventListener](../resources/authenticationeventlistener.md) objects in the response body. The **@odata.type** property in the response object indicates the type of the authenticationEventListener object. ++## Examples ++### Request +The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "list_authenticationeventlistener" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/identity/authenticationEventListeners +``` ++# [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. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.authenticationEventListener)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identity/authenticationEventListeners", + "value": [ + { + "@odata.type": "#microsoft.graph.onTokenIssuanceStartListener", + "id": "990d94e5-cc8f-4c4b-97b4-27e2678aac28", + "conditions": { + "applications": { + "includeApplications@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identity/authenticationEventListeners('990d94e5-cc8f-4c4b-97b4-27e2678aac28')/microsoft.graph.onTokenIssuanceStartListener/conditions/applications/includeApplications", + "includeApplications": [ + { + "appId": "a13d0fc1-04ab-4ede-b215-63de0174cbb4" + } + ] + } + }, + "handler": { + "@odata.type": "#microsoft.graph.onTokenIssuanceStartCustomExtensionHandler", + "configuration": null, + "customExtension": { + "id": "6fc5012e-7665-43d6-9708-4370863f4e6e", + "displayName": "onTokenIssuanceStartCustomExtension", + "description": "Fetch additional claims from custom user store", + "clientConfiguration": null, + "authenticationConfiguration": { + "@odata.type": "#microsoft.graph.azureAdTokenAuthentication", + "resourceId": "api://authenticationeventsAPI.contoso.net/a13d0fc1-04ab-4ede-b215-63de0174cbb4" + }, + "endpointConfiguration": { + "@odata.type": "#microsoft.graph.httpRequestEndpoint", + "targetUrl": "https://authenticationeventsAPI.contoso.net" + }, + "claimsForTokenConfiguration": [ + { + "claimIdInApiResponse": "DateOfBirth" + }, + { + "claimIdInApiResponse": "CustomRoles" + } + ] + } + } + } + ] +} +``` + |
v1.0 | Identitycontainer List B2xuserflows | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identitycontainer-list-b2xuserflows.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identitycontainer_list_b2xuserflows" } --> [!INCLUDE [permissions-table](../includes/permissions/identitycontainer-list-b2xuserflows-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Identitycontainer List Customauthenticationextensions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identitycontainer-list-customauthenticationextensions.md | + + Title: "List customAuthenticationExtensions" +description: "Get a list of the customAuthenticationExtension objects and their properties." ++ms.localizationpriority: medium ++++# List customAuthenticationExtensions +Namespace: microsoft.graph ++Get a list of the [customAuthenticationExtension](../resources/customauthenticationextension.md) objects and their properties. The following derived types are supported. ++- [onTokenIssuanceStartCustomExtension](../resources/ontokenissuancestartcustomextension.md) resource type. +++## 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": "identitycontainer_list_customauthenticationextensions" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /identity/customAuthenticationExtensions +``` ++## Optional query parameters +This method supports the `$filter` 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 [customAuthenticationExtension](../resources/customauthenticationextension.md) objects in the response body. An **@odata.type** property is returned for each object to specify the type of customAuthenticationExtension. ++## Examples ++### Request +The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "list_customauthenticationextension" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/identity/customAuthenticationExtensions?$filter=isOf('microsoft.graph.onTokenIssuanceStartCustomExtension') +``` ++# [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. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.customAuthenticationExtension)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identity/customAuthenticationExtensions", + "value": [ + { + "@odata.type": "#microsoft.graph.onTokenIssuanceStartCustomExtension", + "id": "6fc5012e-7665-43d6-9708-4370863f4e6e", + "displayName": "onTokenIssuanceStartCustomExtension", + "description": "Fetch additional claims from custom user store", + "clientConfiguration": null, + "authenticationConfiguration": { + "@odata.type": "#microsoft.graph.azureAdTokenAuthentication", + "resourceId": "api://authenticationeventsAPI.contoso.net/a13d0fc1-04ab-4ede-b215-63de0174cbb4" + }, + "endpointConfiguration": { + "@odata.type": "#microsoft.graph.httpRequestEndpoint", + "targetUrl": "https://authenticationeventsAPI.contoso.net" + }, + "claimsForTokenConfiguration": [ + { + "claimIdInApiResponse": "DateOfBirth" + }, + { + "claimIdInApiResponse": "CustomRoles" + } + ] + } + ] +} +``` + |
v1.0 | Identitycontainer List Identityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identitycontainer-list-identityproviders.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identitycontainer_list_identityproviders" } --> [!INCLUDE [permissions-table](../includes/permissions/identitycontainer-list-identityproviders-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* External Identity Provider Administrator -* External ID user flow administrator ## HTTP request |
v1.0 | Identitycontainer Post Authenticationeventlisteners | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identitycontainer-post-authenticationeventlisteners.md | + + Title: "Create authenticationEventListener" +description: "Create a new authenticationEventListener object." ++ms.localizationpriority: medium ++++# Create authenticationEventListener +Namespace: microsoft.graph ++Create a new [authenticationEventListener](../resources/authenticationeventlistener.md) object. You can create one of the following subtypes that are derived from **authenticationEventListener**. ++- [onTokenIssuanceStartListener resource type](../resources/ontokenissuancestartlistener.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": "identitycontainer_post_authenticationeventlisteners" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /identity/authenticationEventListeners +``` ++## 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 [authenticationEventListener](../resources/authenticationeventlistener.md) object. ++You can specify the following properties when creating an **authenticationEventListener**. You must specify the **@odata.type** property to specify the type of authenticationEventListener to create; for example, `@odata.type": "microsoft.graph.onTokenIssuanceStartListener"`. ++|Property|Type|Description| +|:|:|:| +|conditions|[authenticationConditions](../resources/authenticationconditions.md)|The conditions on which this authenticationEventListener should trigger. Optional.| +|handler|[onTokenIssuanceStartHandler](../resources/ontokenissuancestarthandler.md)|The handler to invoke when conditions are met. Can be set for the **onTokenIssuanceStartListener** listener type.| ++## Response ++If successful, this method returns a `201 Created` response code and an [authenticationEventListener](../resources/authenticationeventlistener.md) object in the response body. The **@odata.type** property specifies the type of the created object. ++## Examples +++### Request +The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_authenticationeventlistener_onTokenIssuanceStartListener" +} +--> +``` http +POST https://graph.microsoft.com/v1.0/identity/authenticationEventListeners +Content-Type: application/json +Content-length: 312 ++{ + "@odata.type": "#microsoft.graph.onTokenIssuanceStartListener", + "conditions": { + "applications": { + "includeApplications": [ + { + "appId": "a13d0fc1-04ab-4ede-b215-63de0174cbb4" + } + ] + } + }, + "handler": { + "@odata.type": "#microsoft.graph.onTokenIssuanceStartCustomExtensionHandler", + "customExtension": { + "id": "6fc5012e-7665-43d6-9708-4370863f4e6e" + } + } +} +``` ++# [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. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.authenticationEventListener" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identity/authenticationEventListeners/$entity", + "@odata.type": "#microsoft.graph.onTokenIssuanceStartListener", + "id": "990d94e5-cc8f-4c4b-97b4-27e2678aac28", + "conditions": { + "applications": { + "includeApplications": [ + { + "appId": "a13d0fc1-04ab-4ede-b215-63de0174cbb4" + } + ] + } + }, + "handler": { + "@odata.type": "#microsoft.graph.onTokenIssuanceStartCustomExtensionHandler", + "customExtension": { + "id": "6fc5012e-7665-43d6-9708-4370863f4e6e" + } + } +} +``` + |
v1.0 | Identitycontainer Post B2xuserflows | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identitycontainer-post-b2xuserflows.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identitycontainer_post_b2xuserflows" } --> [!INCLUDE [permissions-table](../includes/permissions/identitycontainer-post-b2xuserflows-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Identitycontainer Post Customauthenticationextensions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identitycontainer-post-customauthenticationextensions.md | + + Title: "Create customAuthenticationExtension" +description: "Create a new customAuthenticationExtension object." ++ms.localizationpriority: medium ++++# Create customAuthenticationExtension +Namespace: microsoft.graph ++Create a new [customAuthenticationExtension](../resources/customauthenticationextension.md) object. The following derived types are currently supported. ++- [onTokenIssuanceStartCustomExtension](../resources/ontokenissuancestartcustomextension.md) resource type. +++## 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": "identitycontainer_post_customauthenticationextensions" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /identity/customAuthenticationExtensions +``` ++## 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 [customAuthenticationExtension](../resources/customauthenticationextension.md) object. ++You can specify the following properties when creating a **customAuthenticationExtension**. You must specify the **@odata.type** property with a value of the customAuthenticationExtension object type that you want to create. For example, to create an **onTokenIssuanceStartCustomExtension** object, set **@odata.type** to `#microsoft.graph.onTokenIssuanceStartCustomExtension`. ++|Property|Type|Description| +|:|:|:| +|authenticationConfiguration|[customExtensionAuthenticationConfiguration](../resources/customextensionauthenticationconfiguration.md)|The authentication configuration for this custom extension. Required.| +|claimsForTokenConfiguration|[onTokenIssuanceStartReturnClaim](../resources/ontokenissuancestartreturnclaim.md) collection|Collection of claims to be returned by the API called by this custom authentication extension. Can be set for **onTokenIssuanceStartCustomExtension** object only. Used to populate claims mapping experience in Microsoft Entra admin center. Optional. | +|clientConfiguration|[customExtensionClientConfiguration](../resources/customextensionclientconfiguration.md)|The connection settings for the custom extension. Optional.| +|description|String|Description for the custom extension. Optional.| +|displayName|String|Display name for the custom extension. Required.| +|endpointConfiguration|[customExtensionEndpointConfiguration](../resources/customextensionendpointconfiguration.md)|Configuration for the API endpoint that the custom extension will call. Required.| ++## Response ++If successful, this method returns a `201 Created` response code and a [customAuthenticationExtension](../resources/customauthenticationextension.md) object in the response body. ++## Examples +++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_customauthenticationextension_onTokenIssuanceStartCustomExtension" +} +--> +``` http +POST https://graph.microsoft.com/v1.0/identity/customAuthenticationExtensions +Content-Type: application/json +Content-length: 468 ++{ + "@odata.type": "#microsoft.graph.onTokenIssuanceStartCustomExtension", + "displayName": "onTokenIssuanceStartCustomExtension", + "description": "Fetch additional claims from custom user store", + "endpointConfiguration": { + "@odata.type": "#microsoft.graph.httpRequestEndpoint", + "targetUrl": "https://authenticationeventsAPI.contoso.com" + }, + "authenticationConfiguration": { + "@odata.type": "#microsoft.graph.azureAdTokenAuthentication", + "resourceId": "api://authenticationeventsAPI.contoso.com/a13d0fc1-04ab-4ede-b215-63de0174cbb4" + }, + "clientConfiguration": { + "timeoutInMilliseconds": 2000, + "maximumRetries": 1 + }, + "claimsForTokenConfiguration": [ + { + "claimIdInApiResponse": "DateOfBirth" + }, + { + "claimIdInApiResponse": "CustomRoles" + } + ] +} +``` ++# [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. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.customAuthenticationExtension" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identity/customAuthenticationExtensions/$entity", + "@odata.type": "#microsoft.graph.onTokenIssuanceStartCustomExtension", + "id": "6fc5012e-7665-43d6-9708-4370863f4e6e", + "displayName": "onTokenIssuanceStartCustomExtension", + "description": "Fetch additional claims from custom user store", + "clientConfiguration": null, + "authenticationConfiguration": { + "@odata.type": "#microsoft.graph.azureAdTokenAuthentication", + "resourceId": "api://authenticationeventsAPI.contoso.com/a13d0fc1-04ab-4ede-b215-63de0174cbb4" + }, + "clientConfiguration": { + "timeoutInMilliseconds": 2000, + "maximumRetries": 1 + }, + "endpointConfiguration": { + "@odata.type": "#microsoft.graph.httpRequestEndpoint", + "targetUrl": "https://authenticationeventsAPI.contoso.com" + }, + "claimsForTokenConfiguration": [ + { + "claimIdInApiResponse": "DateOfBirth" + }, + { + "claimIdInApiResponse": "CustomRoles" + } + ] +} +``` + |
v1.0 | Identitycontainer Post Identityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identitycontainer-post-identityproviders.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identitycontainer_post_identityproviders" } --> [!INCLUDE [permissions-table](../includes/permissions/identitycontainer-post-identityproviders-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Identitygovernance Lifecycleworkflowscontainer Post Workflows | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identitygovernance-lifecycleworkflowscontainer-post-workflows.md | Title: "Create workflow" -description: "Create a new workflow object. You can create up to 50 workflows in a tenant." +description: "Create a new workflow object. You can create up to 100 workflows in a tenant." ms.localizationpriority: medium doc_type: apiPageType Namespace: microsoft.graph.identityGovernance -Create a new [workflow](../resources/identitygovernance-workflow.md) object. You can create up to 50 workflows in a tenant. +Create a new [workflow](../resources/identitygovernance-workflow.md) object. You can create up to 100 workflows in a tenant. [!INCLUDE [national-cloud-support](../../includes/global-us.md)] |
v1.0 | Identityprovider Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identityprovider-delete.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityprovider_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/identityprovider-delete-permissions.md)] -The work or school account must be a global administrator of the tenant. ## HTTP request |
v1.0 | Identityprovider Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identityprovider-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityprovider_get" } --> [!INCLUDE [permissions-table](../includes/permissions/identityprovider-get-permissions.md)] -The work or school account must be a global administrator of the tenant. ## HTTP request |
v1.0 | Identityprovider List Availableprovidertypes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identityprovider-list-availableprovidertypes.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityprovider_list_availableprovidertypes" } --> [!INCLUDE [permissions-table](../includes/permissions/identityprovider-list-availableprovidertypes-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Identityprovider List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identityprovider-list.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityprovider_list" } --> [!INCLUDE [permissions-table](../includes/permissions/identityprovider-list-permissions.md)] -The work or school account must be a global administrator of the tenant. ## HTTP request |
v1.0 | Identityprovider Post Identityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identityprovider-post-identityproviders.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityprovider_post_identityproviders" } --> [!INCLUDE [permissions-table](../includes/permissions/identityprovider-post-identityproviders-permissions.md)] -The work or school account must be a global administrator of the tenant. ## HTTP request |
v1.0 | Identityprovider Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identityprovider-update.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityprovider_update" } --> [!INCLUDE [permissions-table](../includes/permissions/identityprovider-update-permissions.md)] -The work or school account must be a global administrator of the tenant. ## HTTP request |
v1.0 | Identityproviderbase Availableprovidertypes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identityproviderbase-availableprovidertypes.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityproviderbase_availableprovidertypes" } --> [!INCLUDE [permissions-table](../includes/permissions/identityproviderbase-availableprovidertypes-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Identityproviderbase Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identityproviderbase-delete.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityproviderbase_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/identityproviderbase-delete-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Identityproviderbase Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identityproviderbase-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityproviderbase_get" } --> [!INCLUDE [permissions-table](../includes/permissions/identityproviderbase-get-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* External Identity Provider Administrator -* External ID user flow administrator ## HTTP request |
v1.0 | Identityproviderbase Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identityproviderbase-update.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "identityproviderbase_update" } --> [!INCLUDE [permissions-table](../includes/permissions/identityproviderbase-update-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Internaldomainfederation Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/internaldomainfederation-delete.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "internaldomainfederation_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/internaldomainfederation-delete-permissions.md)] +> [!IMPORTANT] +> This method has a [known permissions issue](https://developer.microsoft.com/en-us/graph/known-issues/?search=21445) and might require consenting to the *Directory.AccessAsUser.All* permission for delegated scenarios. ++<!-- Domain Name Administrator and Hybrid Identity Administrator can't delete federated domains --> The calling user must be assigned one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): - Security Administrator |
v1.0 | Internaldomainfederation Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/internaldomainfederation-update.md | Title: "Update internalDomainFederation" description: "Update the properties of an internalDomainFederation object." ms.localizationpriority: medium-+ doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "internaldomainfederation_update" } --> [!INCLUDE [permissions-table](../includes/permissions/internaldomainfederation-update-permissions.md)] +> [!IMPORTANT] +> This method has a [known permissions issue](https://developer.microsoft.com/en-us/graph/known-issues/?search=21445) and might require consenting to the *Directory.AccessAsUser.All* permission for delegated scenarios. + [!INCLUDE [rbac-domainfederation-apis-write](../includes/rbac-for-apis/rbac-domainfederation-apis-write.md)] ## HTTP request PATCH /domains/{domainsId}/federationConfiguration/{internalDomainFederationId} |activeSignInUri|String|URL of the endpoint used by active clients when authenticating with federated domains set up for single sign-on in Microsoft Entra ID. Corresponds to the **ActiveLogOnUri** property of the [Set-MsolDomainFederationSettings MSOnline v1 PowerShell cmdlet](/powershell/module/msonline/set-msoldomainfederationsettings).| |displayName|String|The display name of the federated identity Provider (IdP). | |federatedIdpMfaBehavior|federatedIdpMfaBehavior|Determines whether Microsoft Entra ID accepts the MFA performed by the federated IdP when a federated user accesses an application that is governed by a conditional access policy that requires MFA. The possible values are: `acceptIfMfaDoneByFederatedIdp`, `enforceMfaByFederatedIdp`, `rejectMfaByFederatedIdp`, `unknownFutureValue`. For more information, see [federatedIdpMfaBehavior values](#federatedidpmfabehavior-values).|-|isSignedAuthenticationRequestRequired|Boolean|If `true`, when SAML authentication requests are sent to the federated SAML IdP, Microsoft Entra ID will sign those requests using the OrgID signing key. If `false` (default), the SAML authentication requests sent to the federated IdP are not signed.| +|isSignedAuthenticationRequestRequired|Boolean|If `true`, when SAML authentication requests are sent to the federated SAML IdP, Microsoft Entra ID signs those requests using the OrgID signing key. If `false` (default), the SAML authentication requests sent to the federated IdP aren't signed.| |issuerUri|String|Issuer URI of the federation server.| |metadataExchangeUri|String|URI of the metadata exchange endpoint used for authentication from rich client applications.|-|nextSigningCertificate|String|Fallback token signing certificate that is used to sign tokens when the primary signing certificate expires. Formatted as Base64 encoded strings of the public portion of the federated IdP's token signing certificate. Needs to be compatible with the X509Certificate2 class. Much like the **signingCertificate**, the **nextSigningCertificate** property is used if a rollover is required outside of the auto-rollover update, a new federation service is being set up, or if the new token signing certificate is not present in the federation properties after the federation service certificate has been updated.| +|nextSigningCertificate|String|Fallback token signing certificate that is used to sign tokens when the primary signing certificate expires. Formatted as Base 64 encoded strings of the public portion of the federated IdP's token signing certificate. Needs to be compatible with the X509Certificate2 class. Much like the **signingCertificate**, the **nextSigningCertificate** property is used if a rollover is required outside of the autorollover update, a new federation service is being set up, or if the new token signing certificate isn't present in the federation properties after the federation service certificate has been updated.| |passiveSignInUri|String|URI that web-based clients are directed to when signing into Microsoft Entra services. | |preferredAuthenticationProtocol|authenticationProtocol|Preferred authentication protocol. The possible values are: `wsFed`, `saml`, `unknownFutureValue`. | |promptLoginBehavior|promptLoginBehavior|Sets the preferred behavior for the sign-in prompt. The possible values are: `translateToFreshPasswordAuthentication`, `nativeSupport`, `disabled`, `unknownFutureValue`.|-|signingCertificate|String|Current certificate used to sign tokens passed to the Microsoft identity platform. The certificate is formatted as a Base64 encoded string of the public portion of the federated IdP's token signing certificate and must be compatible with the X509Certificate2 class. <br>This property is used in the following scenarios: <li> If a rollover is required outside of the autorollover update <li> A new federation service is being set up <li> If the new token signing certificate isn't present in the federation properties after the federation service certificate has been updated.<br>Microsoft Entra ID updates certificates via an autorollover process in which it attempts to retrieve a new certificate from the federation service metadata, 30 days before expiry of the current certificate. If a new certificate isn't available, Microsoft Entra ID monitors the metadata daily and will update the federation settings for the domain when a new certificate is available. Inherited from [samlOrWsFedProvider](../resources/samlorwsfedprovider.md).| +|signingCertificate|String|Current certificate used to sign tokens passed to the Microsoft identity platform. The certificate is formatted as a Base 64 encoded string of the public portion of the federated IdP's token signing certificate and must be compatible with the X509Certificate2 class. <br>This property is used in the following scenarios: <li> If a rollover is required outside of the autorollover update <li> A new federation service is being set up <li> If the new token signing certificate isn't present in the federation properties after the federation service certificate has been updated.<br>Microsoft Entra ID updates certificates via an autorollover process in which it attempts to retrieve a new certificate from the federation service metadata, 30 days before expiry of the current certificate. If a new certificate isn't available, Microsoft Entra ID monitors the metadata daily and updates the federation settings for the domain when a new certificate is available. Inherited from [samlOrWsFedProvider](../resources/samlorwsfedprovider.md).| |signingCertificateUpdateStatus|[signingCertificateUpdateStatus](../resources/signingcertificateupdatestatus.md)|Provides status and timestamp of the last update of the signing certificate.| |signOutUri|String|URI that clients are redirected to when they sign out of Microsoft Entra services. Corresponds to the **LogOffUri** property of the [Set-MsolDomainFederationSettings MSOnline v1 PowerShell cmdlet](/powershell/module/msonline/set-msoldomainfederationsettings).| + ### federatedIdpMfaBehavior values | Member | Description | Content-Type: application/json "federatedIdpMfaBehavior": "acceptIfMfaDoneByFederatedIdp" } ```++<!-- +{ + "type": "#page.annotation", + "description": "", + "keywords": "", + "section": "documentation", + "tocPath": "", + "suppressions": [ + "Error: /api/internaldomainfederation-update.md: + Exception processing links. + Link Definition was null. Link text: !INCLUDE Azure AD PowerShell deprecation note (Parameter 'Definition')" + ] +} +--> |
v1.0 | Intune Apps Mobileappcontentfile Commit | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-apps-mobileappcontentfile-commit.md | Namespace: microsoft.graph Commits a file of a given app. + ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). Here is an example of the request. <!-- { "blockType": "ignored" , "name" : "intune_apps_mobileappcontentfile_commit_commit_action" }--> ``` http POST https://graph.microsoft.com/v1.0/deviceAppManagement/mobileApps/{mobileAppId}/contentVersions/{mobileAppContentId}/files/{mobileAppContentFileId}/commit+ Content-type: application/json Content-length: 399 |
v1.0 | Intune Apps Mobileappcontentfile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-apps-mobileappcontentfile-create.md | Namespace: microsoft.graph Create a new [mobileAppContentFile](../resources/intune-apps-mobileappcontentfile.md) object. + ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). The following table shows the properties that are required when you create the m |Property|Type|Description| |:|:|:|-|azureStorageUri|String|The Azure Storage URI.| -|isCommitted|Boolean|A value indicating whether the file is committed.| -|id|String|The File Id.| -|createdDateTime|DateTimeOffset|The time the file was created.| -|name|String|the file name.| -|size|Int64|The size of the file prior to encryption.| -|sizeEncrypted|Int64|The size of the file after encryption.| -|azureStorageUriExpirationDateTime|DateTimeOffset|The time the Azure storage Uri expires.| -|manifest|Binary|The manifest information.| -|uploadState|[mobileAppContentFileUploadState](../resources/intune-apps-mobileappcontentfileuploadstate.md)|The state of the current upload request. Possible values are: `success`, `transientError`, `error`, `unknown`, `azureStorageUriRequestSuccess`, `azureStorageUriRequestPending`, `azureStorageUriRequestFailed`, `azureStorageUriRequestTimedOut`, `azureStorageUriRenewalSuccess`, `azureStorageUriRenewalPending`, `azureStorageUriRenewalFailed`, `azureStorageUriRenewalTimedOut`, `commitFileSuccess`, `commitFilePending`, `commitFileFailed`, `commitFileTimedOut`.| +|azureStorageUri|String|Indicates the Azure Storage URI that the file is uploaded to. Created by the service upon receiving a valid mobileAppContentFile. Read-only. This property is read-only.| +|isCommitted|Boolean|A value indicating whether the file is committed. A committed app content file has been fully uploaded and validated by the Intune service. TRUE means that app content file is committed, FALSE means that app content file is not committed. Defaults to FALSE. Read-only. This property is read-only.| +|id|String|The unique identifier for this mobileAppContentFile. This id is assigned during creation of the mobileAppContentFile. Read-only. This property is read-only.| +|createdDateTime|DateTimeOffset|Indicates created date and time associated with app content file, in ISO 8601 format. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Read-only. This property is read-only.| +|name|String|Indicates the name of the file.| +|size|Int64|The size of the file prior to encryption. To be deprecated, please use sizeInBytes property instead.| +|sizeEncrypted|Int64|The size of the file after encryption. To be deprecated, please use sizeEncryptedInBytes property instead.| +|sizeInBytes|Int64|Indicates the original size of the file, in bytes. Valid values 0 to 9.22337203685478E+18| +|sizeEncryptedInBytes|Int64|Indicates the size of the file after encryption, in bytes. Valid values 0 to 9.22337203685478E+18| +|azureStorageUriExpirationDateTime|DateTimeOffset|Indicates the date and time when the Azure storage URI expires, in ISO 8601 format. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Read-only. This property is read-only.| +|manifest|Binary|Indicates the manifest information, containing file metadata.| +|uploadState|[mobileAppContentFileUploadState](../resources/intune-apps-mobileappcontentfileuploadstate.md)|Indicates the state of the current upload request. Possible values are: success, transientError, error, unknown, azureStorageUriRequestSuccess, azureStorageUriRequestPending, azureStorageUriRequestFailed, azureStorageUriRequestTimedOut, azureStorageUriRenewalSuccess, azureStorageUriRenewalPending, azureStorageUriRenewalFailed, azureStorageUriRenewalTimedOut, commitFileSuccess, commitFilePending, commitFileFailed, commitFileTimedOut. Default value is success. This property is read-only. Possible values are: `success`, `transientError`, `error`, `unknown`, `azureStorageUriRequestSuccess`, `azureStorageUriRequestPending`, `azureStorageUriRequestFailed`, `azureStorageUriRequestTimedOut`, `azureStorageUriRenewalSuccess`, `azureStorageUriRenewalPending`, `azureStorageUriRenewalFailed`, `azureStorageUriRenewalTimedOut`, `commitFileSuccess`, `commitFilePending`, `commitFileFailed`, `commitFileTimedOut`.| +|isDependency|Boolean|Indicates whether this content file is a dependency for the main content file. TRUE means that the content file is a dependency, FALSE means that the content file is not a dependency and is the main content file. Defaults to FALSE.| If successful, this method returns a `201 Created` response code and a [mobileAp ### Request Here is an example of the request.--<!-- { "blockType": "ignored" , "name" : "intune_apps_mobileappcontentfile_create_create_mobileappcontentfile" }--> ``` http POST https://graph.microsoft.com/v1.0/deviceAppManagement/mobileApps/{mobileAppId}/contentVersions/{mobileAppContentId}/files Content-type: application/json-Content-length: 342 +Content-length: 419 { "@odata.type": "#microsoft.graph.mobileAppContentFile", Content-length: 342 "name": "Name value", "size": 4, "sizeEncrypted": 13,+ "sizeInBytes": 11, + "sizeEncryptedInBytes": 4, "azureStorageUriExpirationDateTime": "2017-01-01T00:00:08.4940464-08:00", "manifest": "bWFuaWZlc3Q=",- "uploadState": "transientError" + "uploadState": "transientError", + "isDependency": true } ``` ### Response Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.--<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.mobileAppContentFile" }--> ``` http HTTP/1.1 201 Created Content-Type: application/json-Content-Length: 450 +Content-Length: 527 { "@odata.type": "#microsoft.graph.mobileAppContentFile", Content-Length: 450 "name": "Name value", "size": 4, "sizeEncrypted": 13,+ "sizeInBytes": 11, + "sizeEncryptedInBytes": 4, "azureStorageUriExpirationDateTime": "2017-01-01T00:00:08.4940464-08:00", "manifest": "bWFuaWZlc3Q=",- "uploadState": "transientError" + "uploadState": "transientError", + "isDependency": true } ``` |
v1.0 | Intune Apps Mobileappcontentfile Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-apps-mobileappcontentfile-get.md | Namespace: microsoft.graph Read properties and relationships of the [mobileAppContentFile](../resources/intune-apps-mobileappcontentfile.md) object. + ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). If successful, this method returns a `200 OK` response code and [mobileAppConten ### Request Here is an example of the request.--<!-- { "blockType": "ignored" , "name" : "intune_apps_mobileappcontentfile_get_get_mobileappcontentfile" }--> ``` http GET https://graph.microsoft.com/v1.0/deviceAppManagement/mobileApps/{mobileAppId}/contentVersions/{mobileAppContentId}/files/{mobileAppContentFileId} ``` ### Response Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.--<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.mobileAppContentFile" }--> ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 491 +Content-Length: 574 { "value": { Content-Length: 491 "name": "Name value", "size": 4, "sizeEncrypted": 13,+ "sizeInBytes": 11, + "sizeEncryptedInBytes": 4, "azureStorageUriExpirationDateTime": "2017-01-01T00:00:08.4940464-08:00", "manifest": "bWFuaWZlc3Q=",- "uploadState": "transientError" + "uploadState": "transientError", + "isDependency": true } } ``` |
v1.0 | Intune Apps Mobileappcontentfile List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-apps-mobileappcontentfile-list.md | Namespace: microsoft.graph List properties and relationships of the [mobileAppContentFile](../resources/intune-apps-mobileappcontentfile.md) objects. + ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). If successful, this method returns a `200 OK` response code and a collection of ### Request Here is an example of the request.--<!-- { "blockType": "ignored" , "name" : "intune_apps_mobileappcontentfile_list_list_mobileappcontentfiles" }--> ``` http GET https://graph.microsoft.com/v1.0/deviceAppManagement/mobileApps/{mobileAppId}/contentVersions/{mobileAppContentId}/files ``` ### Response Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.--<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.mobileAppContentFile" }--> ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 527 +Content-Length: 616 { "value": [ Content-Length: 527 "sizeEncrypted": 13, "azureStorageUriExpirationDateTime": "2017-01-01T00:00:08.4940464-08:00", "manifest": "bWFuaWZlc3Q=",- "uploadState": "transientError" + "uploadState": "transientError", + "isDependency": true } ] } |
v1.0 | Intune Apps Mobileappcontentfile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-apps-mobileappcontentfile-update.md | Namespace: microsoft.graph Update the properties of a [mobileAppContentFile](../resources/intune-apps-mobileappcontentfile.md) object. + ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). The following table shows the properties that are required when you create the [ |Property|Type|Description| |:|:|:|-|azureStorageUri|String|The Azure Storage URI.| -|isCommitted|Boolean|A value indicating whether the file is committed.| -|id|String|The File Id.| -|createdDateTime|DateTimeOffset|The time the file was created.| -|name|String|the file name.| -|size|Int64|The size of the file prior to encryption.| -|sizeEncrypted|Int64|The size of the file after encryption.| -|azureStorageUriExpirationDateTime|DateTimeOffset|The time the Azure storage Uri expires.| -|manifest|Binary|The manifest information.| -|uploadState|[mobileAppContentFileUploadState](../resources/intune-apps-mobileappcontentfileuploadstate.md)|The state of the current upload request. Possible values are: `success`, `transientError`, `error`, `unknown`, `azureStorageUriRequestSuccess`, `azureStorageUriRequestPending`, `azureStorageUriRequestFailed`, `azureStorageUriRequestTimedOut`, `azureStorageUriRenewalSuccess`, `azureStorageUriRenewalPending`, `azureStorageUriRenewalFailed`, `azureStorageUriRenewalTimedOut`, `commitFileSuccess`, `commitFilePending`, `commitFileFailed`, `commitFileTimedOut`.| +|azureStorageUri|String|Indicates the Azure Storage URI that the file is uploaded to. Created by the service upon receiving a valid mobileAppContentFile. Read-only. This property is read-only.| +|isCommitted|Boolean|A value indicating whether the file is committed. A committed app content file has been fully uploaded and validated by the Intune service. TRUE means that app content file is committed, FALSE means that app content file is not committed. Defaults to FALSE. Read-only. This property is read-only.| +|id|String|The unique identifier for this mobileAppContentFile. This id is assigned during creation of the mobileAppContentFile. Read-only. This property is read-only.| +|createdDateTime|DateTimeOffset|Indicates created date and time associated with app content file, in ISO 8601 format. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Read-only. This property is read-only.| +|name|String|Indicates the name of the file.| +|size|Int64|The size of the file prior to encryption. To be deprecated, please use sizeInBytes property instead.| +|sizeEncrypted|Int64|The size of the file after encryption. To be deprecated, please use sizeEncryptedInBytes property instead.| +|sizeInBytes|Int64|Indicates the original size of the file, in bytes. Valid values 0 to 9.22337203685478E+18| +|sizeEncryptedInBytes|Int64|Indicates the size of the file after encryption, in bytes. Valid values 0 to 9.22337203685478E+18| +|azureStorageUriExpirationDateTime|DateTimeOffset|Indicates the date and time when the Azure storage URI expires, in ISO 8601 format. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Read-only. This property is read-only.| +|manifest|Binary|Indicates the manifest information, containing file metadata.| +|uploadState|[mobileAppContentFileUploadState](../resources/intune-apps-mobileappcontentfileuploadstate.md)|Indicates the state of the current upload request. Possible values are: success, transientError, error, unknown, azureStorageUriRequestSuccess, azureStorageUriRequestPending, azureStorageUriRequestFailed, azureStorageUriRequestTimedOut, azureStorageUriRenewalSuccess, azureStorageUriRenewalPending, azureStorageUriRenewalFailed, azureStorageUriRenewalTimedOut, commitFileSuccess, commitFilePending, commitFileFailed, commitFileTimedOut. Default value is success. This property is read-only. Possible values are: `success`, `transientError`, `error`, `unknown`, `azureStorageUriRequestSuccess`, `azureStorageUriRequestPending`, `azureStorageUriRequestFailed`, `azureStorageUriRequestTimedOut`, `azureStorageUriRenewalSuccess`, `azureStorageUriRenewalPending`, `azureStorageUriRenewalFailed`, `azureStorageUriRenewalTimedOut`, `commitFileSuccess`, `commitFilePending`, `commitFileFailed`, `commitFileTimedOut`.| +|isDependency|Boolean|Indicates whether this content file is a dependency for the main content file. TRUE means that the content file is a dependency, FALSE means that the content file is not a dependency and is the main content file. Defaults to FALSE.| If successful, this method returns a `200 OK` response code and an updated [mobi ### Request Here is an example of the request.--<!-- { "blockType": "ignored" , "name" : "intune_apps_mobileappcontentfile_update_update_mobileappcontentfile" }--> ``` http PATCH https://graph.microsoft.com/v1.0/deviceAppManagement/mobileApps/{mobileAppId}/contentVersions/{mobileAppContentId}/files/{mobileAppContentFileId} Content-type: application/json-Content-length: 342 +Content-length: 419 { "@odata.type": "#microsoft.graph.mobileAppContentFile", Content-length: 342 "sizeEncrypted": 13, "azureStorageUriExpirationDateTime": "2017-01-01T00:00:08.4940464-08:00", "manifest": "bWFuaWZlc3Q=",- "uploadState": "transientError" + "uploadState": "transientError", + "isDependency": true } ``` ### Response Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.--<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.mobileAppContentFile" }--> ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 450 +Content-Length: 527 { "@odata.type": "#microsoft.graph.mobileAppContentFile", Content-Length: 450 "name": "Name value", "size": 4, "sizeEncrypted": 13,+ "sizeInBytes": 11, + "sizeEncryptedInBytes": 4, "azureStorageUriExpirationDateTime": "2017-01-01T00:00:08.4940464-08:00", "manifest": "bWFuaWZlc3Q=",- "uploadState": "transientError" + "uploadState": "transientError", + "isDependency": true } ``` |
v1.0 | Intune Devices Manageddevice Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-devices-manageddevice-create.md | The following table shows the properties that are required when you create the m |notes|String|Notes on the device created by IT Admin. Default is null. To retrieve actual values GET call needs to be made, with device id and included in select parameter. Supports: $select. $Search is not supported.| |ethernetMacAddress|String|Indicates Ethernet MAC Address of the device. Default, is Null (Non-Default property) for this property when returned as part of managedDevice entity. Individual get call with select query options is needed to retrieve actual values. Example: deviceManagement/managedDevices({managedDeviceId})?$select=ethernetMacAddress Supports: $select. $Search is not supported. Read-only. This property is read-only.| |physicalMemoryInBytes|Int64|Total Memory in Bytes. Default is 0. To retrieve actual values GET call needs to be made, with device id and included in select parameter. Supports: $select. Read-only. This property is read-only.|+|enrollmentProfileName|String|Name of the enrollment profile assigned to the device. Default value is empty string, indicating no enrollment profile was assgined. This property is read-only.| Here is an example of the request. ``` http POST https://graph.microsoft.com/v1.0/deviceManagement/managedDevices Content-type: application/json-Content-length: 4942 +Content-length: 5058 { "@odata.type": "#microsoft.graph.managedDevice", Content-length: 4942 "udid": "Udid value", "notes": "Notes value", "ethernetMacAddress": "Ethernet Mac Address value",- "physicalMemoryInBytes": 5 + "physicalMemoryInBytes": 5, + "enrollmentProfileName": "Enrollment Profile Name value" } ```+### Response +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) ++ # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/intune-devices-manageddevice-create-create-manageddevice-csharp-snippets.md)] Content-length: 4942 -### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) +# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) ++++Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. <!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.managedDevice" }--> ``` http HTTP/1.1 201 Created Content-Type: application/json-Content-Length: 4991 +Content-Length: 5107 { "@odata.type": "#microsoft.graph.managedDevice", Content-Length: 4991 "udid": "Udid value", "notes": "Notes value", "ethernetMacAddress": "Ethernet Mac Address value",- "physicalMemoryInBytes": 5 + "physicalMemoryInBytes": 5, + "enrollmentProfileName": "Enrollment Profile Name value" } ``` |
v1.0 | Intune Devices Manageddevice Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-devices-manageddevice-get.md | GET /deviceManagement/detectedApps/{detectedAppId}/managedDevices/{managedDevice GET /deviceManagement/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}/users/{userId}/managedDevices/{managedDeviceId} ``` +## Optional query parameters +This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. + ## Request headers |Header|Value| |:|:| If successful, this method returns a `200 OK` response code and [managedDevice]( ### Request Here is an example of the request.--# [HTTP](#tab/http) -<!-- { "blockType": "request" , "name" : "intune_devices_manageddevice_get_get_manageddevice" }--> ``` http GET https://graph.microsoft.com/v1.0/deviceManagement/managedDevices/{managedDeviceId} ``` -# [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 Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.--<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.managedDevice" }--> ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 5220 +Content-Length: 5340 { "value": { Content-Length: 5220 "udid": "Udid value", "notes": "Notes value", "ethernetMacAddress": "Ethernet Mac Address value",- "physicalMemoryInBytes": 5 + "physicalMemoryInBytes": 5, + "enrollmentProfileName": "Enrollment Profile Name value" } } ``` |
v1.0 | Intune Devices Manageddevice List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-devices-manageddevice-list.md | If successful, this method returns a `200 OK` response code and a collection of ### Request Here is an example of the request.--# [HTTP](#tab/http) -<!-- { "blockType": "request" , "name" : "intune_devices_manageddevice_list_list_manageddevices" }--> ``` http GET https://graph.microsoft.com/v1.0/deviceManagement/managedDevices ``` -# [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 Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.--<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.managedDevice" }--> ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 5444 +Content-Length: 5568 { "value": [ Content-Length: 5444 "udid": "Udid value", "notes": "Notes value", "ethernetMacAddress": "Ethernet Mac Address value",- "physicalMemoryInBytes": 5 + "physicalMemoryInBytes": 5, + "enrollmentProfileName": "Enrollment Profile Name value" } ] } |
v1.0 | Intune Devices Manageddevice Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-devices-manageddevice-update.md | The following table shows the properties that are required when you create the [ |notes|String|Notes on the device created by IT Admin. Default is null. To retrieve actual values GET call needs to be made, with device id and included in select parameter. Supports: $select. $Search is not supported.| |ethernetMacAddress|String|Indicates Ethernet MAC Address of the device. Default, is Null (Non-Default property) for this property when returned as part of managedDevice entity. Individual get call with select query options is needed to retrieve actual values. Example: deviceManagement/managedDevices({managedDeviceId})?$select=ethernetMacAddress Supports: $select. $Search is not supported. Read-only. This property is read-only.| |physicalMemoryInBytes|Int64|Total Memory in Bytes. Default is 0. To retrieve actual values GET call needs to be made, with device id and included in select parameter. Supports: $select. Read-only. This property is read-only.|+|enrollmentProfileName|String|Name of the enrollment profile assigned to the device. Default value is empty string, indicating no enrollment profile was assgined. This property is read-only.| If successful, this method returns a `200 OK` response code and an updated [mana ### Request Here is an example of the request.--# [HTTP](#tab/http) -<!-- { "blockType": "request" , "name" : "intune_devices_manageddevice_update_update_manageddevice" }--> ``` http PATCH https://graph.microsoft.com/v1.0/deviceManagement/managedDevices/{managedDeviceId} Content-type: application/json-Content-length: 4942 +Content-length: 5058 { "@odata.type": "#microsoft.graph.managedDevice", Content-length: 4942 "udid": "Udid value", "notes": "Notes value", "ethernetMacAddress": "Ethernet Mac Address value",- "physicalMemoryInBytes": 5 + "physicalMemoryInBytes": 5, + "enrollmentProfileName": "Enrollment Profile Name value" } ``` -# [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 Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.--<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.managedDevice" }--> ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 4991 +Content-Length: 5107 { "@odata.type": "#microsoft.graph.managedDevice", Content-Length: 4991 "udid": "Udid value", "notes": "Notes value", "ethernetMacAddress": "Ethernet Mac Address value",- "physicalMemoryInBytes": 5 + "physicalMemoryInBytes": 5, + "enrollmentProfileName": "Enrollment Profile Name value" } ``` |
v1.0 | Intune Devices Manageddeviceoverview Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-devices-manageddeviceoverview-get.md | If successful, this method returns a `200 OK` response code and [managedDeviceOv ### Request Here is an example of the request.--# [HTTP](#tab/http) -<!-- { "blockType": "request" , "name" : "intune_devices_manageddeviceoverview_get_get_manageddeviceoverview" }--> ``` http GET https://graph.microsoft.com/v1.0/deviceManagement/managedDeviceOverview ``` -# [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 Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.--<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.managedDeviceOverview" }--> ``` http HTTP/1.1 200 OK Content-Type: application/json |
v1.0 | Intune Devices Manageddeviceoverview Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-devices-manageddeviceoverview-update.md | Namespace: microsoft.graph Update the properties of a [managedDeviceOverview](../resources/intune-devices-manageddeviceoverview.md) object. + ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). If successful, this method returns a `200 OK` response code and an updated [mana ### Request Here is an example of the request.--# [HTTP](#tab/http) -<!-- { "blockType": "request" , "name" : "intune_devices_manageddeviceoverview_update_update_manageddeviceoverview" }--> ``` http PATCH https://graph.microsoft.com/v1.0/deviceManagement/managedDeviceOverview Content-type: application/json Content-length: 900 } ``` -# [JavaScript](#tab/javascript) --- ### Response Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.--<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.managedDeviceOverview" }--> ``` http HTTP/1.1 200 OK Content-Type: application/json |
v1.0 | Intune Mstunnel Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-devicemanagement-get.md | - Title: "Get deviceManagement" -description: "Read properties and relationships of the deviceManagement object." --localization_priority: Normal --doc_type: apiPageType ---# Get deviceManagement --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Read properties and relationships of the [deviceManagement](../resources/intune-mstunnel-devicemanagement.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement -``` --## Optional query parameters -This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-mstunnel-devicemanagement.md) object in the response body. --## Example --### Request -Here is an example of the request. --# [HTTP](#tab/http) -<!-- { "blockType": "request" , "name" : "intune_mstunnel_devicemanagement_get_get_devicemanagement" }--> -``` http -GET https://graph.microsoft.com/v1.0/deviceManagement -``` --# [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 -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.deviceManagement" }--> -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 130 --{ - "value": { - "@odata.type": "#microsoft.graph.deviceManagement", - "id": "0b283420-3420-0b28-2034-280b2034280b" - } -} -``` |
v1.0 | Intune Mstunnel Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-devicemanagement-update.md | - Title: "Update deviceManagement" -description: "Update the properties of a deviceManagement object." --localization_priority: Normal --doc_type: apiPageType ---# Update deviceManagement --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Update the properties of a [deviceManagement](../resources/intune-mstunnel-devicemanagement.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -PATCH /deviceManagement -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-mstunnel-devicemanagement.md) object. --The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-mstunnel-devicemanagement.md). --|Property|Type|Description| -|:|:|:| -|id|String|Not yet documented| ----## Response -If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-mstunnel-devicemanagement.md) object in the response body. --## Example --### Request -Here is an example of the request. --# [HTTP](#tab/http) -<!-- { "blockType": "request" , "name" : "intune_mstunnel_devicemanagement_update_update_devicemanagement" }--> -``` http -PATCH https://graph.microsoft.com/v1.0/deviceManagement -Content-type: application/json -Content-length: 58 --{ - "@odata.type": "#microsoft.graph.deviceManagement" -} -``` --# [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 -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.deviceManagement" }--> -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 107 --{ - "@odata.type": "#microsoft.graph.deviceManagement", - "id": "0b283420-3420-0b28-2034-280b2034280b" -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelconfiguration Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelconfiguration-create.md | - Title: "Create microsoftTunnelConfiguration" -description: "Create a new microsoftTunnelConfiguration object." --localization_priority: Normal --doc_type: apiPageType ---# Create microsoftTunnelConfiguration --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Create a new [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) object. --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST /deviceManagement/microsoftTunnelConfigurations -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the microsoftTunnelConfiguration object. --The following table shows the properties that are required when you create the microsoftTunnelConfiguration. --|Property|Type|Description| -|:|:|:| -|id|String|The unique identifier for the configuration id. Supports: $delete, $update. $Insert, $skip, $top is not supported. Read-only.| -|displayName|String|The display name for the server configuration. This property is required when a server is created.| -|description|String|The configuration's description (optional)| -|network|String|The subnet that will be used to allocate virtual address for the clients| -|dnsServers|String collection|The DNS servers that will be used by the clients| -|defaultDomainSuffix|String|The Default Domain appendix that will be used by the clients| -|routeIncludes|String collection|The routes that will be routed by the server| -|routeExcludes|String collection|Subsets of the routes that will not be routed by the server| -|splitDNS|String collection|The domains that will be resolved using the provided dns servers| -|listenPort|Int32|The port that both TCP and UPD will listen over on the server| -|advancedSettings|[keyValuePair](../resources/intune-shared-keyvaluepair.md) collection|Additional settings that may be applied to the server| -|lastUpdateDateTime|DateTimeOffset|When the configuration was last updated| -|roleScopeTagIds|String collection|List of Scope Tags for this Entity instance| -|disableUdpConnections|Boolean|When DisableUdpConnections is set, the clients and VPN server will not use DTLS connections to transfer data.| ----## Response -If successful, this method returns a `201 Created` response code and a [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) object in the response body. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelconfiguration_create_create_microsofttunnelconfiguration" }--> -``` http -POST https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelConfigurations -Content-type: application/json -Content-length: 782 --{ - "@odata.type": "#microsoft.graph.microsoftTunnelConfiguration", - "displayName": "Display Name value", - "description": "Description value", - "network": "Network value", - "dnsServers": [ - "Dns Servers value" - ], - "defaultDomainSuffix": "Default Domain Suffix value", - "routeIncludes": [ - "Route Includes value" - ], - "routeExcludes": [ - "Route Excludes value" - ], - "splitDNS": [ - "Split DNS value" - ], - "listenPort": 10, - "advancedSettings": [ - { - "@odata.type": "microsoft.graph.keyValuePair", - "name": "Name value", - "value": "Value value" - } - ], - "lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ], - "disableUdpConnections": true -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.microsoftTunnelConfiguration" }--> -``` http -HTTP/1.1 201 Created -Content-Type: application/json -Content-Length: 831 --{ - "@odata.type": "#microsoft.graph.microsoftTunnelConfiguration", - "id": "b8bdb469-b469-b8bd-69b4-bdb869b4bdb8", - "displayName": "Display Name value", - "description": "Description value", - "network": "Network value", - "dnsServers": [ - "Dns Servers value" - ], - "defaultDomainSuffix": "Default Domain Suffix value", - "routeIncludes": [ - "Route Includes value" - ], - "routeExcludes": [ - "Route Excludes value" - ], - "splitDNS": [ - "Split DNS value" - ], - "listenPort": 10, - "advancedSettings": [ - { - "@odata.type": "microsoft.graph.keyValuePair", - "name": "Name value", - "value": "Value value" - } - ], - "lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ], - "disableUdpConnections": true -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelconfiguration Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelconfiguration-delete.md | - Title: "Delete microsoftTunnelConfiguration" -description: "Deletes a microsoftTunnelConfiguration." --localization_priority: Normal --doc_type: apiPageType ---# Delete microsoftTunnelConfiguration --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Deletes a [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md). --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -DELETE /deviceManagement/microsoftTunnelConfigurations/{microsoftTunnelConfigurationId} -DELETE /deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId}/microsoftTunnelConfiguration -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `204 No Content` response code. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelconfiguration_delete_delete_microsofttunnelconfiguration" }--> -``` http -DELETE https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelConfigurations/{microsoftTunnelConfigurationId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response"}--> -``` http -HTTP/1.1 204 No Content -``` |
v1.0 | Intune Mstunnel Microsofttunnelconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelconfiguration-get.md | - Title: "Get microsoftTunnelConfiguration" -description: "Read properties and relationships of the microsoftTunnelConfiguration object." --localization_priority: Normal --doc_type: apiPageType ---# Get microsoftTunnelConfiguration --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Read properties and relationships of the [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) object. --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/microsoftTunnelConfigurations/{microsoftTunnelConfigurationId} -GET /deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId}/microsoftTunnelConfiguration -``` --## Optional query parameters -This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) object in the response body. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelconfiguration_get_get_microsofttunnelconfiguration" }--> -``` http -GET https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelConfigurations/{microsoftTunnelConfigurationId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.microsoftTunnelConfiguration" }--> -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 912 --{ - "value": { - "@odata.type": "#microsoft.graph.microsoftTunnelConfiguration", - "id": "b8bdb469-b469-b8bd-69b4-bdb869b4bdb8", - "displayName": "Display Name value", - "description": "Description value", - "network": "Network value", - "dnsServers": [ - "Dns Servers value" - ], - "defaultDomainSuffix": "Default Domain Suffix value", - "routeIncludes": [ - "Route Includes value" - ], - "routeExcludes": [ - "Route Excludes value" - ], - "splitDNS": [ - "Split DNS value" - ], - "listenPort": 10, - "advancedSettings": [ - { - "@odata.type": "microsoft.graph.keyValuePair", - "name": "Name value", - "value": "Value value" - } - ], - "lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ], - "disableUdpConnections": true - } -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelconfiguration List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelconfiguration-list.md | - Title: "List microsoftTunnelConfigurations" -description: "List properties and relationships of the microsoftTunnelConfiguration objects." --localization_priority: Normal --doc_type: apiPageType ---# List microsoftTunnelConfigurations --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --List properties and relationships of the [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) objects. --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/microsoftTunnelConfigurations -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and a collection of [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) objects in the response body. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelconfiguration_list_list_microsofttunnelconfigurations" }--> -``` http -GET https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelConfigurations -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.microsoftTunnelConfiguration" }--> -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 988 --{ - "value": [ - { - "@odata.type": "#microsoft.graph.microsoftTunnelConfiguration", - "id": "b8bdb469-b469-b8bd-69b4-bdb869b4bdb8", - "displayName": "Display Name value", - "description": "Description value", - "network": "Network value", - "dnsServers": [ - "Dns Servers value" - ], - "defaultDomainSuffix": "Default Domain Suffix value", - "routeIncludes": [ - "Route Includes value" - ], - "routeExcludes": [ - "Route Excludes value" - ], - "splitDNS": [ - "Split DNS value" - ], - "listenPort": 10, - "advancedSettings": [ - { - "@odata.type": "microsoft.graph.keyValuePair", - "name": "Name value", - "value": "Value value" - } - ], - "lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ], - "disableUdpConnections": true - } - ] -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelconfiguration Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelconfiguration-update.md | - Title: "Update microsoftTunnelConfiguration" -description: "Update the properties of a microsoftTunnelConfiguration object." --localization_priority: Normal --doc_type: apiPageType ---# Update microsoftTunnelConfiguration --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Update the properties of a [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) object. --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -PATCH /deviceManagement/microsoftTunnelConfigurations/{microsoftTunnelConfigurationId} -PATCH /deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId}/microsoftTunnelConfiguration -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) object. --The following table shows the properties that are required when you create the [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md). --|Property|Type|Description| -|:|:|:| -|id|String|The unique identifier for the configuration id. Supports: $delete, $update. $Insert, $skip, $top is not supported. Read-only.| -|displayName|String|The display name for the server configuration. This property is required when a server is created.| -|description|String|The configuration's description (optional)| -|network|String|The subnet that will be used to allocate virtual address for the clients| -|dnsServers|String collection|The DNS servers that will be used by the clients| -|defaultDomainSuffix|String|The Default Domain appendix that will be used by the clients| -|routeIncludes|String collection|The routes that will be routed by the server| -|routeExcludes|String collection|Subsets of the routes that will not be routed by the server| -|splitDNS|String collection|The domains that will be resolved using the provided dns servers| -|listenPort|Int32|The port that both TCP and UPD will listen over on the server| -|advancedSettings|[keyValuePair](../resources/intune-shared-keyvaluepair.md) collection|Additional settings that may be applied to the server| -|lastUpdateDateTime|DateTimeOffset|When the configuration was last updated| -|roleScopeTagIds|String collection|List of Scope Tags for this Entity instance| -|disableUdpConnections|Boolean|When DisableUdpConnections is set, the clients and VPN server will not use DTLS connections to transfer data.| ----## Response -If successful, this method returns a `200 OK` response code and an updated [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) object in the response body. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelconfiguration_update_update_microsofttunnelconfiguration" }--> -``` http -PATCH https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelConfigurations/{microsoftTunnelConfigurationId} -Content-type: application/json -Content-length: 782 --{ - "@odata.type": "#microsoft.graph.microsoftTunnelConfiguration", - "displayName": "Display Name value", - "description": "Description value", - "network": "Network value", - "dnsServers": [ - "Dns Servers value" - ], - "defaultDomainSuffix": "Default Domain Suffix value", - "routeIncludes": [ - "Route Includes value" - ], - "routeExcludes": [ - "Route Excludes value" - ], - "splitDNS": [ - "Split DNS value" - ], - "listenPort": 10, - "advancedSettings": [ - { - "@odata.type": "microsoft.graph.keyValuePair", - "name": "Name value", - "value": "Value value" - } - ], - "lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ], - "disableUdpConnections": true -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.microsoftTunnelConfiguration" }--> -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 831 --{ - "@odata.type": "#microsoft.graph.microsoftTunnelConfiguration", - "id": "b8bdb469-b469-b8bd-69b4-bdb869b4bdb8", - "displayName": "Display Name value", - "description": "Description value", - "network": "Network value", - "dnsServers": [ - "Dns Servers value" - ], - "defaultDomainSuffix": "Default Domain Suffix value", - "routeIncludes": [ - "Route Includes value" - ], - "routeExcludes": [ - "Route Excludes value" - ], - "splitDNS": [ - "Split DNS value" - ], - "listenPort": 10, - "advancedSettings": [ - { - "@odata.type": "microsoft.graph.keyValuePair", - "name": "Name value", - "value": "Value value" - } - ], - "lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ], - "disableUdpConnections": true -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelhealththreshold Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelhealththreshold-create.md | - Title: "Create microsoftTunnelHealthThreshold" -description: "Create a new microsoftTunnelHealthThreshold object." --localization_priority: Normal --doc_type: apiPageType ---# Create microsoftTunnelHealthThreshold --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Create a new [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) object. --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST /deviceManagement/microsoftTunnelHealthThresholds -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the microsoftTunnelHealthThreshold object. --The following table shows the properties that are required when you create the microsoftTunnelHealthThreshold. --|Property|Type|Description| -|:|:|:| -|id|String|The unique identifier for the metric name. Supports: $delete, $update. $Insert, $skip, $top is not supported. Read-only.| -|healthyThreshold|Int64|The threshold for being healthy based on default health status metrics: CPU usage healthy < 50%, Memory usage healthy < 50%, Disk space healthy > 5GB, Latency healthy < 10ms, health metrics can be customized.| -|unhealthyThreshold|Int64|The threshold for being unhealthy based on default health status metrics: CPU usage unhealthy > 75%, Memory usage unhealthy > 75%, Disk space < 3GB, Latency Unhealthy > 20ms, health metrics can be customized.| -|defaultHealthyThreshold|Int64|The threshold for being healthy based on default health status metrics: CPU usage healthy < 50%, Memory usage healthy < 50%, Disk space healthy > 5GB, Latency healthy < 10ms, health metrics can be customized. Read-only.| -|defaultUnhealthyThreshold|Int64|The threshold for being unhealthy based on default health status metrics: CPU usage unhealthy > 75%, Memory usage unhealthy > 75%, Disk space < 3GB, Latency unhealthy > 20ms, health metrics can be customized. Read-only.| ----## Response -If successful, this method returns a `201 Created` response code and a [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) object in the response body. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelhealththreshold_create_create_microsofttunnelhealththreshold" }--> -``` http -POST https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelHealthThresholds -Content-type: application/json -Content-length: 194 --{ - "@odata.type": "#microsoft.graph.microsoftTunnelHealthThreshold", - "healthyThreshold": 0, - "unhealthyThreshold": 2, - "defaultHealthyThreshold": 7, - "defaultUnhealthyThreshold": 9 -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.microsoftTunnelHealthThreshold" }--> -``` http -HTTP/1.1 201 Created -Content-Type: application/json -Content-Length: 243 --{ - "@odata.type": "#microsoft.graph.microsoftTunnelHealthThreshold", - "id": "419c526e-526e-419c-6e52-9c416e529c41", - "healthyThreshold": 0, - "unhealthyThreshold": 2, - "defaultHealthyThreshold": 7, - "defaultUnhealthyThreshold": 9 -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelhealththreshold Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelhealththreshold-delete.md | - Title: "Delete microsoftTunnelHealthThreshold" -description: "Deletes a microsoftTunnelHealthThreshold." --localization_priority: Normal --doc_type: apiPageType ---# Delete microsoftTunnelHealthThreshold --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Deletes a [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md). --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -DELETE /deviceManagement/microsoftTunnelHealthThresholds/{microsoftTunnelHealthThresholdId} -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `204 No Content` response code. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelhealththreshold_delete_delete_microsofttunnelhealththreshold" }--> -``` http -DELETE https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelHealthThresholds/{microsoftTunnelHealthThresholdId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response"}--> -``` http -HTTP/1.1 204 No Content -``` |
v1.0 | Intune Mstunnel Microsofttunnelhealththreshold Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelhealththreshold-get.md | - Title: "Get microsoftTunnelHealthThreshold" -description: "Read properties and relationships of the microsoftTunnelHealthThreshold object." --localization_priority: Normal --doc_type: apiPageType ---# Get microsoftTunnelHealthThreshold --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Read properties and relationships of the [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) object. --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/microsoftTunnelHealthThresholds/{microsoftTunnelHealthThresholdId} -``` --## Optional query parameters -This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) object in the response body. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelhealththreshold_get_get_microsofttunnelhealththreshold" }--> -``` http -GET https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelHealthThresholds/{microsoftTunnelHealthThresholdId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.microsoftTunnelHealthThreshold" }--> -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 274 --{ - "value": { - "@odata.type": "#microsoft.graph.microsoftTunnelHealthThreshold", - "id": "419c526e-526e-419c-6e52-9c416e529c41", - "healthyThreshold": 0, - "unhealthyThreshold": 2, - "defaultHealthyThreshold": 7, - "defaultUnhealthyThreshold": 9 - } -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelhealththreshold List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelhealththreshold-list.md | - Title: "List microsoftTunnelHealthThresholds" -description: "List properties and relationships of the microsoftTunnelHealthThreshold objects." --localization_priority: Normal --doc_type: apiPageType ---# List microsoftTunnelHealthThresholds --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --List properties and relationships of the [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) objects. --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/microsoftTunnelHealthThresholds -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and a collection of [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) objects in the response body. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelhealththreshold_list_list_microsofttunnelhealththresholds" }--> -``` http -GET https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelHealthThresholds -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.microsoftTunnelHealthThreshold" }--> -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 300 --{ - "value": [ - { - "@odata.type": "#microsoft.graph.microsoftTunnelHealthThreshold", - "id": "419c526e-526e-419c-6e52-9c416e529c41", - "healthyThreshold": 0, - "unhealthyThreshold": 2, - "defaultHealthyThreshold": 7, - "defaultUnhealthyThreshold": 9 - } - ] -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelhealththreshold Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelhealththreshold-update.md | - Title: "Update microsoftTunnelHealthThreshold" -description: "Update the properties of a microsoftTunnelHealthThreshold object." --localization_priority: Normal --doc_type: apiPageType ---# Update microsoftTunnelHealthThreshold --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Update the properties of a [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) object. --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -PATCH /deviceManagement/microsoftTunnelHealthThresholds/{microsoftTunnelHealthThresholdId} -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) object. --The following table shows the properties that are required when you create the [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md). --|Property|Type|Description| -|:|:|:| -|id|String|The unique identifier for the metric name. Supports: $delete, $update. $Insert, $skip, $top is not supported. Read-only.| -|healthyThreshold|Int64|The threshold for being healthy based on default health status metrics: CPU usage healthy < 50%, Memory usage healthy < 50%, Disk space healthy > 5GB, Latency healthy < 10ms, health metrics can be customized.| -|unhealthyThreshold|Int64|The threshold for being unhealthy based on default health status metrics: CPU usage unhealthy > 75%, Memory usage unhealthy > 75%, Disk space < 3GB, Latency Unhealthy > 20ms, health metrics can be customized.| -|defaultHealthyThreshold|Int64|The threshold for being healthy based on default health status metrics: CPU usage healthy < 50%, Memory usage healthy < 50%, Disk space healthy > 5GB, Latency healthy < 10ms, health metrics can be customized. Read-only.| -|defaultUnhealthyThreshold|Int64|The threshold for being unhealthy based on default health status metrics: CPU usage unhealthy > 75%, Memory usage unhealthy > 75%, Disk space < 3GB, Latency unhealthy > 20ms, health metrics can be customized. Read-only.| ----## Response -If successful, this method returns a `200 OK` response code and an updated [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) object in the response body. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelhealththreshold_update_update_microsofttunnelhealththreshold" }--> -``` http -PATCH https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelHealthThresholds/{microsoftTunnelHealthThresholdId} -Content-type: application/json -Content-length: 194 --{ - "@odata.type": "#microsoft.graph.microsoftTunnelHealthThreshold", - "healthyThreshold": 0, - "unhealthyThreshold": 2, - "defaultHealthyThreshold": 7, - "defaultUnhealthyThreshold": 9 -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.microsoftTunnelHealthThreshold" }--> -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 243 --{ - "@odata.type": "#microsoft.graph.microsoftTunnelHealthThreshold", - "id": "419c526e-526e-419c-6e52-9c416e529c41", - "healthyThreshold": 0, - "unhealthyThreshold": 2, - "defaultHealthyThreshold": 7, - "defaultUnhealthyThreshold": 9 -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelserver Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelserver-create.md | - Title: "Create microsoftTunnelServer" -description: "Create a new microsoftTunnelServer object." --localization_priority: Normal --doc_type: apiPageType ---# Create microsoftTunnelServer --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Create a new [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) object. --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST /deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId}/microsoftTunnelServers -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the microsoftTunnelServer object. --The following table shows the properties that are required when you create the microsoftTunnelServer. --|Property|Type|Description| -|:|:|:| -|id|String|The unique identifier for the managed server. This id is assigned at enrollment time. Supports: $delete. $Update, $insert, $skip, $top is not supported. Read-only.| -|displayName|String|The display name for the server. This property is required when a server is created and cannot be cleared during updates.| -|tunnelServerHealthStatus|[microsoftTunnelServerHealthStatus](../resources/intune-mstunnel-microsofttunnelserverhealthstatus.md)|Indicates the server's health Status as of the last evaluation time. Health is evaluated every 60 seconds, and the possible values are: unknown, healthy, unhealthy, warning, offline, upgradeInProgress, upgradeFailed. Possible values are: `unknown`, `healthy`, `unhealthy`, `warning`, `offline`, `upgradeInProgress`, `upgradeFailed`, `unknownFutureValue`.| -|lastCheckinDateTime|DateTimeOffset|Indicates when the server last checked in| -|agentImageDigest|String|The digest of the current agent image running on this server| -|serverImageDigest|String|The digest of the current server image running on this server| ----## Response -If successful, this method returns a `201 Created` response code and a [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) object in the response body. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelserver_create_create_microsofttunnelserver" }--> -``` http -POST https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId}/microsoftTunnelServers -Content-type: application/json -Content-length: 312 --{ - "@odata.type": "#microsoft.graph.microsoftTunnelServer", - "displayName": "Display Name value", - "tunnelServerHealthStatus": "healthy", - "lastCheckinDateTime": "2017-01-01T00:02:46.0431416-08:00", - "agentImageDigest": "Agent Image Digest value", - "serverImageDigest": "Server Image Digest value" -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.microsoftTunnelServer" }--> -``` http -HTTP/1.1 201 Created -Content-Type: application/json -Content-Length: 361 --{ - "@odata.type": "#microsoft.graph.microsoftTunnelServer", - "id": "b5cf0aee-0aee-b5cf-ee0a-cfb5ee0acfb5", - "displayName": "Display Name value", - "tunnelServerHealthStatus": "healthy", - "lastCheckinDateTime": "2017-01-01T00:02:46.0431416-08:00", - "agentImageDigest": "Agent Image Digest value", - "serverImageDigest": "Server Image Digest value" -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelserver Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelserver-delete.md | - Title: "Delete microsoftTunnelServer" -description: "Deletes a microsoftTunnelServer." --localization_priority: Normal --doc_type: apiPageType ---# Delete microsoftTunnelServer --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Deletes a [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md). --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -DELETE /deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId}/microsoftTunnelServers/{microsoftTunnelServerId} -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `204 No Content` response code. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelserver_delete_delete_microsofttunnelserver" }--> -``` http -DELETE https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId}/microsoftTunnelServers/{microsoftTunnelServerId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response"}--> -``` http -HTTP/1.1 204 No Content -``` |
v1.0 | Intune Mstunnel Microsofttunnelserver Generateserverlogcollectionrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelserver-generateserverlogcollectionrequest.md | - Title: "generateServerLogCollectionRequest action" -description: "Not yet documented" --localization_priority: Normal --doc_type: apiPageType ---# generateServerLogCollectionRequest action --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Not yet documented --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST /deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId}/microsoftTunnelServers/{microsoftTunnelServerId}/generateServerLogCollectionRequest -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply JSON representation of the parameters. --The following table shows the parameters that can be used with this action. --|Property|Type|Description| -|:|:|:| -|startDateTime|DateTimeOffset|Not yet documented| -|endDateTime|DateTimeOffset|Not yet documented| ----## Response -If successful, this action returns a `200 OK` response code and a [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) in the response body. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelserver_generateserverlogcollectionrequest_generateserverlogcollectionrequest_action" }--> -``` http -POST https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId}/microsoftTunnelServers/{microsoftTunnelServerId}/generateServerLogCollectionRequest -Content-type: application/json -Content-length: 115 --{ - "startDateTime": "2016-12-31T23:58:46.7156189-08:00", - "endDateTime": "2017-01-01T00:03:30.9241974-08:00" -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.microsoftTunnelServerLogCollectionResponse" }--> -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 481 --{ - "value": { - "@odata.type": "#microsoft.graph.microsoftTunnelServerLogCollectionResponse", - "id": "05dcc2e9-c2e9-05dc-e9c2-dc05e9c2dc05", - "status": "completed", - "startDateTime": "2016-12-31T23:58:46.7156189-08:00", - "endDateTime": "2017-01-01T00:03:30.9241974-08:00", - "sizeInBytes": 11, - "serverId": "Server Id value", - "requestDateTime": "2017-01-01T00:03:07.1589002-08:00", - "expiryDateTime": "2017-01-01T00:03:32.5199332-08:00" - } -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelserver Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelserver-get.md | - Title: "Get microsoftTunnelServer" -description: "Read properties and relationships of the microsoftTunnelServer object." --localization_priority: Normal --doc_type: apiPageType ---# Get microsoftTunnelServer --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Read properties and relationships of the [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) object. --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId}/microsoftTunnelServers/{microsoftTunnelServerId} -``` --## Optional query parameters -This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) object in the response body. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelserver_get_get_microsofttunnelserver" }--> -``` http -GET https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId}/microsoftTunnelServers/{microsoftTunnelServerId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.microsoftTunnelServer" }--> -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 394 --{ - "value": { - "@odata.type": "#microsoft.graph.microsoftTunnelServer", - "id": "b5cf0aee-0aee-b5cf-ee0a-cfb5ee0acfb5", - "displayName": "Display Name value", - "tunnelServerHealthStatus": "healthy", - "lastCheckinDateTime": "2017-01-01T00:02:46.0431416-08:00", - "agentImageDigest": "Agent Image Digest value", - "serverImageDigest": "Server Image Digest value" - } -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelserver List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelserver-list.md | - Title: "List microsoftTunnelServers" -description: "List properties and relationships of the microsoftTunnelServer objects." --localization_priority: Normal --doc_type: apiPageType ---# List microsoftTunnelServers --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --List properties and relationships of the [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) objects. --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId}/microsoftTunnelServers -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and a collection of [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) objects in the response body. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelserver_list_list_microsofttunnelservers" }--> -``` http -GET https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId}/microsoftTunnelServers -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.microsoftTunnelServer" }--> -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 422 --{ - "value": [ - { - "@odata.type": "#microsoft.graph.microsoftTunnelServer", - "id": "b5cf0aee-0aee-b5cf-ee0a-cfb5ee0acfb5", - "displayName": "Display Name value", - "tunnelServerHealthStatus": "healthy", - "lastCheckinDateTime": "2017-01-01T00:02:46.0431416-08:00", - "agentImageDigest": "Agent Image Digest value", - "serverImageDigest": "Server Image Digest value" - } - ] -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelserver Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelserver-update.md | - Title: "Update microsoftTunnelServer" -description: "Update the properties of a microsoftTunnelServer object." --localization_priority: Normal --doc_type: apiPageType ---# Update microsoftTunnelServer --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Update the properties of a [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) object. --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -PATCH /deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId}/microsoftTunnelServers/{microsoftTunnelServerId} -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) object. --The following table shows the properties that are required when you create the [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md). --|Property|Type|Description| -|:|:|:| -|id|String|The unique identifier for the managed server. This id is assigned at enrollment time. Supports: $delete. $Update, $insert, $skip, $top is not supported. Read-only.| -|displayName|String|The display name for the server. This property is required when a server is created and cannot be cleared during updates.| -|tunnelServerHealthStatus|[microsoftTunnelServerHealthStatus](../resources/intune-mstunnel-microsofttunnelserverhealthstatus.md)|Indicates the server's health Status as of the last evaluation time. Health is evaluated every 60 seconds, and the possible values are: unknown, healthy, unhealthy, warning, offline, upgradeInProgress, upgradeFailed. Possible values are: `unknown`, `healthy`, `unhealthy`, `warning`, `offline`, `upgradeInProgress`, `upgradeFailed`, `unknownFutureValue`.| -|lastCheckinDateTime|DateTimeOffset|Indicates when the server last checked in| -|agentImageDigest|String|The digest of the current agent image running on this server| -|serverImageDigest|String|The digest of the current server image running on this server| ----## Response -If successful, this method returns a `200 OK` response code and an updated [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) object in the response body. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelserver_update_update_microsofttunnelserver" }--> -``` http -PATCH https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId}/microsoftTunnelServers/{microsoftTunnelServerId} -Content-type: application/json -Content-length: 312 --{ - "@odata.type": "#microsoft.graph.microsoftTunnelServer", - "displayName": "Display Name value", - "tunnelServerHealthStatus": "healthy", - "lastCheckinDateTime": "2017-01-01T00:02:46.0431416-08:00", - "agentImageDigest": "Agent Image Digest value", - "serverImageDigest": "Server Image Digest value" -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.microsoftTunnelServer" }--> -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 361 --{ - "@odata.type": "#microsoft.graph.microsoftTunnelServer", - "id": "b5cf0aee-0aee-b5cf-ee0a-cfb5ee0acfb5", - "displayName": "Display Name value", - "tunnelServerHealthStatus": "healthy", - "lastCheckinDateTime": "2017-01-01T00:02:46.0431416-08:00", - "agentImageDigest": "Agent Image Digest value", - "serverImageDigest": "Server Image Digest value" -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelserverlogcollectionresponse Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-create.md | - Title: "Create microsoftTunnelServerLogCollectionResponse" -description: "Create a new microsoftTunnelServerLogCollectionResponse object." --localization_priority: Normal --doc_type: apiPageType ---# Create microsoftTunnelServerLogCollectionResponse --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Create a new [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) object. --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST /deviceManagement/microsoftTunnelServerLogCollectionResponses -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the microsoftTunnelServerLogCollectionResponse object. --The following table shows the properties that are required when you create the microsoftTunnelServerLogCollectionResponse. --|Property|Type|Description| -|:|:|:| -|id|String|The unique identifier for server log collection response. Read-only.| -|status|[microsoftTunnelLogCollectionStatus](../resources/intune-mstunnel-microsofttunnellogcollectionstatus.md)|The status of log collection. Possible values are: pending, completed, failed. Possible values are: `pending`, `completed`, `failed`, `unknownFutureValue`.| -|startDateTime|DateTimeOffset|The start time of the logs collected| -|endDateTime|DateTimeOffset|The end time of the logs collected| -|sizeInBytes|Int64|The size of the logs in bytes| -|serverId|String|ID of the server the log collection is requested upon| -|requestDateTime|DateTimeOffset|The time when the log collection was requested| -|expiryDateTime|DateTimeOffset|The time when the log collection is expired| ----## Response -If successful, this method returns a `201 Created` response code and a [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) object in the response body. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelserverlogcollectionresponse_create_create_microsofttunnelserverlogcollectionresponse" }--> -``` http -POST https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelServerLogCollectionResponses -Content-type: application/json -Content-length: 395 --{ - "@odata.type": "#microsoft.graph.microsoftTunnelServerLogCollectionResponse", - "status": "completed", - "startDateTime": "2016-12-31T23:58:46.7156189-08:00", - "endDateTime": "2017-01-01T00:03:30.9241974-08:00", - "sizeInBytes": 11, - "serverId": "Server Id value", - "requestDateTime": "2017-01-01T00:03:07.1589002-08:00", - "expiryDateTime": "2017-01-01T00:03:32.5199332-08:00" -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.microsoftTunnelServerLogCollectionResponse" }--> -``` http -HTTP/1.1 201 Created -Content-Type: application/json -Content-Length: 444 --{ - "@odata.type": "#microsoft.graph.microsoftTunnelServerLogCollectionResponse", - "id": "05dcc2e9-c2e9-05dc-e9c2-dc05e9c2dc05", - "status": "completed", - "startDateTime": "2016-12-31T23:58:46.7156189-08:00", - "endDateTime": "2017-01-01T00:03:30.9241974-08:00", - "sizeInBytes": 11, - "serverId": "Server Id value", - "requestDateTime": "2017-01-01T00:03:07.1589002-08:00", - "expiryDateTime": "2017-01-01T00:03:32.5199332-08:00" -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelserverlogcollectionresponse Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-delete.md | - Title: "Delete microsoftTunnelServerLogCollectionResponse" -description: "Deletes a microsoftTunnelServerLogCollectionResponse." --localization_priority: Normal --doc_type: apiPageType ---# Delete microsoftTunnelServerLogCollectionResponse --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Deletes a [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md). --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -DELETE /deviceManagement/microsoftTunnelServerLogCollectionResponses/{microsoftTunnelServerLogCollectionResponseId} -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `204 No Content` response code. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelserverlogcollectionresponse_delete_delete_microsofttunnelserverlogcollectionresponse" }--> -``` http -DELETE https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelServerLogCollectionResponses/{microsoftTunnelServerLogCollectionResponseId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response"}--> -``` http -HTTP/1.1 204 No Content -``` |
v1.0 | Intune Mstunnel Microsofttunnelserverlogcollectionresponse Generatedownloadurl | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-generatedownloadurl.md | - Title: "generateDownloadUrl action" -description: "Not yet documented" --localization_priority: Normal --doc_type: apiPageType ---# generateDownloadUrl action --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Not yet documented --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST /deviceManagement/microsoftTunnelServerLogCollectionResponses/{microsoftTunnelServerLogCollectionResponseId}/generateDownloadUrl -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this action returns a `200 OK` response code and a String in the response body. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelserverlogcollectionresponse_generatedownloadurl_generatedownloadurl_action" }--> -``` http -POST https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelServerLogCollectionResponses/{microsoftTunnelServerLogCollectionResponseId}/generateDownloadUrl -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" }--> -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 59 --{ - "value": "https://example.com/generateDownloadUrl/" -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelserverlogcollectionresponse Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-get.md | - Title: "Get microsoftTunnelServerLogCollectionResponse" -description: "Read properties and relationships of the microsoftTunnelServerLogCollectionResponse object." --localization_priority: Normal --doc_type: apiPageType ---# Get microsoftTunnelServerLogCollectionResponse --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Read properties and relationships of the [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) object. --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/microsoftTunnelServerLogCollectionResponses/{microsoftTunnelServerLogCollectionResponseId} -``` --## Optional query parameters -This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) object in the response body. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelserverlogcollectionresponse_get_get_microsofttunnelserverlogcollectionresponse" }--> -``` http -GET https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelServerLogCollectionResponses/{microsoftTunnelServerLogCollectionResponseId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.microsoftTunnelServerLogCollectionResponse" }--> -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 481 --{ - "value": { - "@odata.type": "#microsoft.graph.microsoftTunnelServerLogCollectionResponse", - "id": "05dcc2e9-c2e9-05dc-e9c2-dc05e9c2dc05", - "status": "completed", - "startDateTime": "2016-12-31T23:58:46.7156189-08:00", - "endDateTime": "2017-01-01T00:03:30.9241974-08:00", - "sizeInBytes": 11, - "serverId": "Server Id value", - "requestDateTime": "2017-01-01T00:03:07.1589002-08:00", - "expiryDateTime": "2017-01-01T00:03:32.5199332-08:00" - } -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelserverlogcollectionresponse List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-list.md | - Title: "List microsoftTunnelServerLogCollectionResponses" -description: "List properties and relationships of the microsoftTunnelServerLogCollectionResponse objects." --localization_priority: Normal --doc_type: apiPageType ---# List microsoftTunnelServerLogCollectionResponses --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --List properties and relationships of the [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) objects. --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/microsoftTunnelServerLogCollectionResponses -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and a collection of [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) objects in the response body. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelserverlogcollectionresponse_list_list_microsofttunnelserverlogcollectionresponses" }--> -``` http -GET https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelServerLogCollectionResponses -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.microsoftTunnelServerLogCollectionResponse" }--> -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 513 --{ - "value": [ - { - "@odata.type": "#microsoft.graph.microsoftTunnelServerLogCollectionResponse", - "id": "05dcc2e9-c2e9-05dc-e9c2-dc05e9c2dc05", - "status": "completed", - "startDateTime": "2016-12-31T23:58:46.7156189-08:00", - "endDateTime": "2017-01-01T00:03:30.9241974-08:00", - "sizeInBytes": 11, - "serverId": "Server Id value", - "requestDateTime": "2017-01-01T00:03:07.1589002-08:00", - "expiryDateTime": "2017-01-01T00:03:32.5199332-08:00" - } - ] -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelserverlogcollectionresponse Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-update.md | - Title: "Update microsoftTunnelServerLogCollectionResponse" -description: "Update the properties of a microsoftTunnelServerLogCollectionResponse object." --localization_priority: Normal --doc_type: apiPageType ---# Update microsoftTunnelServerLogCollectionResponse --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Update the properties of a [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) object. --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -PATCH /deviceManagement/microsoftTunnelServerLogCollectionResponses/{microsoftTunnelServerLogCollectionResponseId} -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) object. --The following table shows the properties that are required when you create the [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md). --|Property|Type|Description| -|:|:|:| -|id|String|The unique identifier for server log collection response. Read-only.| -|status|[microsoftTunnelLogCollectionStatus](../resources/intune-mstunnel-microsofttunnellogcollectionstatus.md)|The status of log collection. Possible values are: pending, completed, failed. Possible values are: `pending`, `completed`, `failed`, `unknownFutureValue`.| -|startDateTime|DateTimeOffset|The start time of the logs collected| -|endDateTime|DateTimeOffset|The end time of the logs collected| -|sizeInBytes|Int64|The size of the logs in bytes| -|serverId|String|ID of the server the log collection is requested upon| -|requestDateTime|DateTimeOffset|The time when the log collection was requested| -|expiryDateTime|DateTimeOffset|The time when the log collection is expired| ----## Response -If successful, this method returns a `200 OK` response code and an updated [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) object in the response body. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelserverlogcollectionresponse_update_update_microsofttunnelserverlogcollectionresponse" }--> -``` http -PATCH https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelServerLogCollectionResponses/{microsoftTunnelServerLogCollectionResponseId} -Content-type: application/json -Content-length: 395 --{ - "@odata.type": "#microsoft.graph.microsoftTunnelServerLogCollectionResponse", - "status": "completed", - "startDateTime": "2016-12-31T23:58:46.7156189-08:00", - "endDateTime": "2017-01-01T00:03:30.9241974-08:00", - "sizeInBytes": 11, - "serverId": "Server Id value", - "requestDateTime": "2017-01-01T00:03:07.1589002-08:00", - "expiryDateTime": "2017-01-01T00:03:32.5199332-08:00" -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.microsoftTunnelServerLogCollectionResponse" }--> -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 444 --{ - "@odata.type": "#microsoft.graph.microsoftTunnelServerLogCollectionResponse", - "id": "05dcc2e9-c2e9-05dc-e9c2-dc05e9c2dc05", - "status": "completed", - "startDateTime": "2016-12-31T23:58:46.7156189-08:00", - "endDateTime": "2017-01-01T00:03:30.9241974-08:00", - "sizeInBytes": 11, - "serverId": "Server Id value", - "requestDateTime": "2017-01-01T00:03:07.1589002-08:00", - "expiryDateTime": "2017-01-01T00:03:32.5199332-08:00" -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelsite Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelsite-create.md | - Title: "Create microsoftTunnelSite" -description: "Create a new microsoftTunnelSite object." --localization_priority: Normal --doc_type: apiPageType ---# Create microsoftTunnelSite --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Create a new [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) object. --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST /deviceManagement/microsoftTunnelSites -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the microsoftTunnelSite object. --The following table shows the properties that are required when you create the microsoftTunnelSite. --|Property|Type|Description| -|:|:|:| -|id|String|The unique identifier for the site id. $Insert, $skip, $top is not supported. Read-only.| -|displayName|String|The display name for the site. This property is required when a site is created.| -|description|String|The site's description (optional)| -|publicAddress|String|The site's public domain name or IP address| -|upgradeWindowUtcOffsetInMinutes|Int32|The site's timezone represented as a minute offset from UTC| -|upgradeWindowStartTime|TimeOfDay|The site's upgrade window start time of day| -|upgradeWindowEndTime|TimeOfDay|The site's upgrade window end time of day| -|upgradeAutomatically|Boolean|The site's automatic upgrade setting. True for automatic upgrades, false for manual control| -|upgradeAvailable|Boolean|The site provides the state of when an upgrade is available| -|internalNetworkProbeUrl|String|The site's Internal Network Access Probe URL| -|roleScopeTagIds|String collection|List of Scope Tags for this Entity instance| ----## Response -If successful, this method returns a `201 Created` response code and a [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) object in the response body. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelsite_create_create_microsofttunnelsite" }--> -``` http -POST https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelSites -Content-type: application/json -Content-length: 524 --{ - "@odata.type": "#microsoft.graph.microsoftTunnelSite", - "displayName": "Display Name value", - "description": "Description value", - "publicAddress": "Public Address value", - "upgradeWindowUtcOffsetInMinutes": 15, - "upgradeWindowStartTime": "12:01:27.3030000", - "upgradeWindowEndTime": "11:57:17.9830000", - "upgradeAutomatically": true, - "upgradeAvailable": true, - "internalNetworkProbeUrl": "https://example.com/internalNetworkProbeUrl/", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ] -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.microsoftTunnelSite" }--> -``` http -HTTP/1.1 201 Created -Content-Type: application/json -Content-Length: 573 --{ - "@odata.type": "#microsoft.graph.microsoftTunnelSite", - "id": "b2f7dc3e-dc3e-b2f7-3edc-f7b23edcf7b2", - "displayName": "Display Name value", - "description": "Description value", - "publicAddress": "Public Address value", - "upgradeWindowUtcOffsetInMinutes": 15, - "upgradeWindowStartTime": "12:01:27.3030000", - "upgradeWindowEndTime": "11:57:17.9830000", - "upgradeAutomatically": true, - "upgradeAvailable": true, - "internalNetworkProbeUrl": "https://example.com/internalNetworkProbeUrl/", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ] -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelsite Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelsite-delete.md | - Title: "Delete microsoftTunnelSite" -description: "Deletes a microsoftTunnelSite." --localization_priority: Normal --doc_type: apiPageType ---# Delete microsoftTunnelSite --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Deletes a [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md). --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -DELETE /deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId} -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `204 No Content` response code. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelsite_delete_delete_microsofttunnelsite" }--> -``` http -DELETE https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response"}--> -``` http -HTTP/1.1 204 No Content -``` |
v1.0 | Intune Mstunnel Microsofttunnelsite Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelsite-get.md | - Title: "Get microsoftTunnelSite" -description: "Read properties and relationships of the microsoftTunnelSite object." --localization_priority: Normal --doc_type: apiPageType ---# Get microsoftTunnelSite --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Read properties and relationships of the [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) object. --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId} -``` --## Optional query parameters -This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) object in the response body. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelsite_get_get_microsofttunnelsite" }--> -``` http -GET https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.microsoftTunnelSite" }--> -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 620 --{ - "value": { - "@odata.type": "#microsoft.graph.microsoftTunnelSite", - "id": "b2f7dc3e-dc3e-b2f7-3edc-f7b23edcf7b2", - "displayName": "Display Name value", - "description": "Description value", - "publicAddress": "Public Address value", - "upgradeWindowUtcOffsetInMinutes": 15, - "upgradeWindowStartTime": "12:01:27.3030000", - "upgradeWindowEndTime": "11:57:17.9830000", - "upgradeAutomatically": true, - "upgradeAvailable": true, - "internalNetworkProbeUrl": "https://example.com/internalNetworkProbeUrl/", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ] - } -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelsite List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelsite-list.md | - Title: "List microsoftTunnelSites" -description: "List properties and relationships of the microsoftTunnelSite objects." --localization_priority: Normal --doc_type: apiPageType ---# List microsoftTunnelSites --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --List properties and relationships of the [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) objects. --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/microsoftTunnelSites -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and a collection of [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) objects in the response body. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelsite_list_list_microsofttunnelsites" }--> -``` http -GET https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelSites -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.microsoftTunnelSite" }--> -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 662 --{ - "value": [ - { - "@odata.type": "#microsoft.graph.microsoftTunnelSite", - "id": "b2f7dc3e-dc3e-b2f7-3edc-f7b23edcf7b2", - "displayName": "Display Name value", - "description": "Description value", - "publicAddress": "Public Address value", - "upgradeWindowUtcOffsetInMinutes": 15, - "upgradeWindowStartTime": "12:01:27.3030000", - "upgradeWindowEndTime": "11:57:17.9830000", - "upgradeAutomatically": true, - "upgradeAvailable": true, - "internalNetworkProbeUrl": "https://example.com/internalNetworkProbeUrl/", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ] - } - ] -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelsite Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/intune-mstunnel-microsofttunnelsite-update.md | - Title: "Update microsoftTunnelSite" -description: "Update the properties of a microsoftTunnelSite object." --localization_priority: Normal --doc_type: apiPageType ---# Update microsoftTunnelSite --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Update the properties of a [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) object. --## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -PATCH /deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId} -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) object. --The following table shows the properties that are required when you create the [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md). --|Property|Type|Description| -|:|:|:| -|id|String|The unique identifier for the site id. $Insert, $skip, $top is not supported. Read-only.| -|displayName|String|The display name for the site. This property is required when a site is created.| -|description|String|The site's description (optional)| -|publicAddress|String|The site's public domain name or IP address| -|upgradeWindowUtcOffsetInMinutes|Int32|The site's timezone represented as a minute offset from UTC| -|upgradeWindowStartTime|TimeOfDay|The site's upgrade window start time of day| -|upgradeWindowEndTime|TimeOfDay|The site's upgrade window end time of day| -|upgradeAutomatically|Boolean|The site's automatic upgrade setting. True for automatic upgrades, false for manual control| -|upgradeAvailable|Boolean|The site provides the state of when an upgrade is available| -|internalNetworkProbeUrl|String|The site's Internal Network Access Probe URL| -|roleScopeTagIds|String collection|List of Scope Tags for this Entity instance| ----## Response -If successful, this method returns a `200 OK` response code and an updated [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) object in the response body. --## Example --### Request -Here is an example of the request. --<!-- { "blockType": "request" , "name" : "intune_mstunnel_microsofttunnelsite_update_update_microsofttunnelsite" }--> -``` http -PATCH https://graph.microsoft.com/v1.0/deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId} -Content-type: application/json -Content-length: 524 --{ - "@odata.type": "#microsoft.graph.microsoftTunnelSite", - "displayName": "Display Name value", - "description": "Description value", - "publicAddress": "Public Address value", - "upgradeWindowUtcOffsetInMinutes": 15, - "upgradeWindowStartTime": "12:01:27.3030000", - "upgradeWindowEndTime": "11:57:17.9830000", - "upgradeAutomatically": true, - "upgradeAvailable": true, - "internalNetworkProbeUrl": "https://example.com/internalNetworkProbeUrl/", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ] -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. --<!-- { "blockType": "response" , "@odata.type" : "microsoft.graph.microsoftTunnelSite" }--> -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 573 --{ - "@odata.type": "#microsoft.graph.microsoftTunnelSite", - "id": "b2f7dc3e-dc3e-b2f7-3edc-f7b23edcf7b2", - "displayName": "Display Name value", - "description": "Description value", - "publicAddress": "Public Address value", - "upgradeWindowUtcOffsetInMinutes": 15, - "upgradeWindowStartTime": "12:01:27.3030000", - "upgradeWindowEndTime": "11:57:17.9830000", - "upgradeAutomatically": true, - "upgradeAvailable": true, - "internalNetworkProbeUrl": "https://example.com/internalNetworkProbeUrl/", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ] -} -``` |
v1.0 | Itemanalytics Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/itemanalytics-get.md | GET /drives/{drive-id}/items/{item-id}/analytics/lastSevenDays GET /sites/{site-id}/analytics/lastSevenDays GET /sites/{site-id}/lists/{list-id}/items/{item-id}/analytics/lastSevenDays ```++> [!NOTE] +> The value for `{item-id}` in the `/sites/{site-id}/lists/{list-id}/items/{item-id}` request is the `listItemUniqueId`. To get the `listItemUniqueId` of an item, call the `/sites/{site-id}/lists/{list-id}/items/{item-id}?$select=sharepointIds` endpoint. For details, see [sharePointIds](/graph/api/resources/sharepointids). + ## Optional query parameters This method supports the [OData query parameters](/graph/query-parameters) to help customize the response. |
v1.0 | Learningcontent Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/learningcontent-get.md | Content-type: application/json "numberOfPages": 10, "duration": "PT20M", "format": "Book",+ "level": "Beginner", "createdDateTime": "2018-01-01T00:00:00", "lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z", "contributors": [ Content-type: application/json "numberOfPages": 10, "duration": "PT20M", "format": "Book",+ "level": "Beginner", "createdDateTime": "2018-01-01T00:00:00", "lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z", "contributors": [ |
v1.0 | Learningcontent Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/learningcontent-update.md | PATCH /employeeExperience/learningProviders/{learningProviderId}/learningContent |duration|Duration|The duration of the learning content in seconds. The value is represented in ISO 8601 format for durations. Optional.| |externalId|String|Unique external content ID for the learning content. Required.| |format|String|The format of the learning content. For example, `Course`, `Video`, `Book`, `Book Summary`, `Audiobook Summary`. Optional.|+|level|Level|The difficulty level of the learning content. Possible values are: `Beginner`, `Intermediate`, `Advanced`. Optional.| |isActive|Boolean|Indicates whether the content is active or not. Inactive content doesn't show up in the UI. The default value is `true`. Optional.| |isPremium|Boolean|Indicates whether the learning content requires the user to sign-in on the learning provider platform or not. The default value is `false`. Optional.| |isSearchable|Boolean|Indicates whether the learning content is searchable or not. The default value is `true`. Optional.| Content-Type: application/json "numberOfPages": 9, "duration": "PT20M", "format": "Book",+ "level": "Beginner", "createdDateTime": "2018-01-01T00:00:00Z", "lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z", "contributors": [ Content-Type: application/json "numberOfPages": 9, "duration": "PT20M", "format": "Book",+ "level": "Beginner", "createdDateTime": "2018-01-01T00:00:00", "lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z", "contributors": [ Content-Type: application/json "numberOfPages": 9, "duration": "PT20M", "format": "Book",+ "level": "Beginner", "createdDateTime": "2018-01-01T00:00:00", "lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z", "contributors": [ Content-Type: application/json "numberOfPages": 9, "duration": "PT20M", "format": "Book",+ "level": "Beginner", "createdDateTime": "2018-01-01T00:00:00", "lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z", "contributors": [ |
v1.0 | Learningprovider List Learningcontents | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/learningprovider-list-learningcontents.md | HTTP/1.1 200 OK Content-Type: application/json {- "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#learningProviders('13727311-e7bb-470d-8b20-6a23d9030d70')/learningContents", + "@odata.context": "https://graph.microsoft.com/beta/$metadata#learningProviders('13727311-e7bb-470d-8b20-6a23d9030d70')/learningContents", + "@odata.nextLink": "https://graph.microsoft.com/beta/$metadata#learningProviders('13727311-e7bb-470d-8b20-6a23d9030d70')/learningContents?skip=2&top=2", + "@odata.count": 10, "value": [ { "id": "99029577-a660-46b6-ba58-3ce4d21d5f50", |
v1.0 | Licensedetails Getteamslicensingdetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/licensedetails-getteamslicensingdetails.md | + + Title: "licenseDetails: getTeamsLicensingDetails" +description: "Get the license status of a user in Microsoft Teams." ++ms.localizationpriority: high ++++# licenseDetails: getTeamsLicensingDetails ++Namespace: microsoft.graph ++Get the license status of a [user](../resources/user.md) in Microsoft Teams. +++## 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": "licensedetails_getteamslicensingdetails" } --> ++## HTTP request +<!-- { "blockType": "ignored" } --> +```http +GET /users/{user-id}/licenseDetails/getTeamsLicensingDetails +``` ++## Request headers ++| Header | Value | +| : | :- | +|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 along with a [teamsLicensingDetails](../resources/teamslicensingdetails.md) object. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "user_get_teams_licensing_details", + "sampleKeys": ["2f39ffba-51ca-4d2d-a66f-a020a83ce208"] +}--> +```msgraph-interactive +GET https://graph.microsoft.com/beta/users/2f39ffba-51ca-4d2d-a66f-a020a83ce208/licenseDetails/getTeamsLicensingDetails +``` ++# [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. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.teamsLicensingDetails" +} --> +```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.teamsLicensingDetails", + "hasTeamsLicense": true +} +``` ++## Related content ++- [Get userTeamwork](userteamwork-get.md) +- [Get teamwork](teamwork-get.md) |
v1.0 | Listitem Delta | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/listitem-delta.md | ++ +description: "Get newly created, updated, or deleted list items without having to perform a full read of the entire items collection." + Title: "listItem: delta" +ms.localizationpriority: "medium" +++# listItem: delta ++Namespace: microsoft.graph ++Get newly created, updated, or deleted [list items](../resources/listitem.md) without having to perform a full read of the entire items collection. ++Your app begins by calling `delta` without any parameters. +The service starts enumerating the hierarchy of the list, returning pages of items, and either an **@odata.nextLink** or an **@odata.deltaLink**. +Your app should continue calling with the **@odata.nextLink** until you see an **@odata.deltaLink** returned. ++After you received all the changes, you can apply them to your local state. +To check for changes in the future, call `delta` again with the **@odata.deltaLink** from the previous response. ++The delta feed shows the latest state for each item, not each change. If an item was renamed twice, it only shows up once, with its latest name. +The same item might appear more than once in a delta feed, for various reasons. You should use the last occurrence you see. ++Items with this property should be removed from your local state. ++> **Note:** You should only delete a folder locally if it's empty after syncing all the changes. +++## 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_delta" } --> ++## HTTP request ++<!-- { "blockType": "ignored" } --> ++```http +GET /sites/{siteId}/lists/{listId}/items/delta +``` ++## Query parameters ++In the request URL, you can include the following optional query parameter. ++| Parameter | Type | Description | +|:-|:-|:-| +| token | String | If unspecified, enumerates the current state of the hierarchy. If `latest`, returns an empty response with the latest delta token. If a previous delta token, returns a new state since that token.| ++This method also supports the `$select`, `$expand`, and `$top` [OData query parameters](/graph/query-parameters) to customize the response. ++## Request headers ++|Header |Value | +|-|-| +|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 [listItem](../resources/listitem.md) objects in the response body. ++In addition to a collection of **listItem** objects, the response also includes one of the following properties. ++| Name | Value | Description | +|:--|:-|:| +| @odata.nextLink | URL | A URL to retrieve the next available page of changes if there are more changes in the current set. | +| @odata.deltaLink | URL | A URL returned instead of **@odata.nextLink** after all current changes have been returned. Use this property to read the next set of changes in the future. | ++In some cases, the service returns a `410 Gone` response code with an error response that contains one of the following error codes, and a `Location` header that contains a new `nextLink` that starts a fresh delta enumeration. This occurs when the service can't provide a list of changes for a given token; for example, if a client tries to reuse an old token after being disconnected for a long time, or if the server state has changed and a new token is required. ++After the full enumeration is completed, compare the returned items with your local state and follow the instructions based on the error type. ++| Error type | Instructions | +|:-|:-| +| resyncChangesApplyDifferences | Replace any local items with the versions from the server (including deletes) if you're sure that the service was up-to-date with your local changes when you last synchronized. Upload any local changes that the server doesn't know about. | +| resyncChangesUploadDifferences | Upload any local items that the service didn't return and upload any items that differ from the versions from the server. Keep both copies if you're not sure which one is more up-to-date. | ++In addition to the resync errors and for more details about how errors are returned, see [Microsoft Graph error responses and resource types](/graph/errors). ++## Examples ++### Example 1: Initial request ++The following example shows an initial request and how to call this API to establish your local state. ++#### Request ++The following example shows an initial request. ++# [HTTP](#tab/http) +<!-- { "blockType": "request", "name": "get_listItem_delta_first", "sampleKeys": ["contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE", "22e03ef3-6ef4-424d-a1d3-92a337807c30"] } --> ++```msgraph-interactive +GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/22e03ef3-6ef4-424d-a1d3-92a337807c30/items/delta +``` ++# [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 that includes the first page of changes and the **@odata.nextLink** property that indicates that no more items are available in the current set of items. Your app should continue to request the URL value of **@odata.nextLink** until all pages of items have been retrieved. ++<!-- { "blockType": "response", "name": "get_listItem_delta_first", "@odata.type": "Collection(microsoft.graph.listItem)", "truncated": true, "scope": "site.read" } --> ++```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "value": [ + { + "createdDateTime": "2020-06-02T22:46:58Z", + "eTag": "\"{12AD05BB-59B8-43AA-9456-77C44E9BC066},756\"", + "id": "1", + "lastModifiedDateTime": "2021-10-14T23:27:27Z", + "webUrl": "http://contoso.sharepoint.com/Shared%20Documents/TestFolder", + "createdBy": { + "user": { + "displayName": "John doe" + } + }, + "parentReference": { + "id": "1", + "path": "Shared%20Documents", + "siteId": "12AD05BB-59B8-43AA-9456-77C44E9BC066" + }, + "contentType": { + "id": "0x00123456789abc", + "name": "Folder" + } + }, + { + "createdDateTime": "2020-06-02T22:46:58Z", + "eTag": "\"{12AD05BB-59B8-43AA-9456-77C44E9BC067},756\"", + "id": "2", + "lastModifiedDateTime": "2021-10-14T23:27:27Z", + "webUrl": "http://contoso.sharepoint.com/Shared%20Documents/TestItemA.txt", + "createdBy": { + "user": { + "displayName": "John doe" + } + }, + "parentReference": { + "id": "2", + "path": "Shared%20Documents", + "siteId": "12AD05BB-59B8-43AA-9456-77C44E9BC066" + }, + "contentType": { + "id": "0x00123456789abc", + "name": "Document" + } + }, + { + "createdDateTime": "2020-06-02T22:46:58Z", + "eTag": "\"{12AD05BB-59B8-43AA-9456-77C44E9BC068},756\"", + "id": "3", + "lastModifiedDateTime": "2021-10-14T23:27:27Z", + "webUrl": "http://contoso.sharepoint.com/Shared%20Documents/TestItemB.txt", + "createdBy": { + "user": { + "displayName": "John doe" + } + }, + "parentReference": { + "id": "3", + "path": "Shared%20Documents", + "siteId": "12AD05BB-59B8-43AA-9456-77C44E9BC066" + }, + "contentType": { + "id": "0x00123456789abc", + "name": "Document" + } + } + ], + "@odata.nextLink": "https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/22e03ef3-6ef4-424d-a1d3-92a337807c30/items/delta?token=1230919asd190410jlka" +} +``` ++### Example 2: Last page request ++The following example shows a request that gets the last page in a set and how to call this API to update your local state. ++#### Request ++The following example shows a request after the initial request. ++# [HTTP](#tab/http) +<!-- { "blockType": "request", "name": "get-listItem-delta-last", "sampleKeys": ["contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE","22e03ef3-6ef4-424d-a1d3-92a337807c30"] }--> ++```msgraph-interactive +GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/22e03ef3-6ef4-424d-a1d3-92a337807c30/items/delta?token=1230919asd190410jlka +``` ++# [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 that indicates that the item named `TestItemB.txt` was deleted and the item `TestFolder` was either added or modified between the initial request and this request to update the local state. ++The final page of items includes the **@odata.deltaLink** property that provides the URL that can be used later to retrieve changes since the current set of items. ++<!-- { "blockType": "response", "name": "get-listItem-delta-last", "truncated": true, "@odata.type": "Collection(microsoft.graph.listItem)", "scope": "site.read" } --> ++```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "value": [ + { + "createdDateTime": "2020-06-02T22:46:58Z", + "eTag": "\"{12AD05BB-59B8-43AA-9456-77C44E9BC066},756\"", + "id": "1", + "lastModifiedDateTime": "2016-03-21T20:01:37Z", + "webUrl": "http://contoso.sharepoint.com/Shared%20Documents/TestFolder", + "createdBy": { + "user": { + "displayName": "John doe" + } + }, + "parentReference": { + "id": "1", + "path": "Shared%20Documents", + "siteId": "12AD05BB-59B8-43AA-9456-77C44E9BC066" + }, + "contentType": { + "id": "0x00123456789abc", + "name": "Folder" + } + }, + { + "id": "3", + "parentReference": { + "siteId": "12AD05BB-59B8-43AA-9456-77C44E9BC066" + }, + "contentType": { + "id": "0x00123456789abc", + "name": "Document" + }, + "deleted": { + "state": "deleted" + } + } + ], + "@odata.deltaLink": "https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/22e03ef3-6ef4-424d-a1d3-92a337807c30/items/delta?token=1230919asd190410jlka" +} +``` ++### Example 3: Delta link request ++In some scenarios, you might want to request the current `deltaLink` value without first enumerating all of the items in the list already. This can be useful if your app only wants to know about changes and doesn't need to know about existing items. +To retrieve the latest `deltaLink`, call `delta` with the query string parameter `?token=latest`. ++#### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { "blockType": "request", "name": "get-delta-latest_datalink_tokenislatest", "scope": "sites.read", "target": "action", "sampleKeys": ["contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE","22e03ef3-6ef4-424d-a1d3-92a337807c30"] } --> ++```msgraph-interactive +GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/22e03ef3-6ef4-424d-a1d3-92a337807c30/items/delta?token=latest +``` ++# [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. ++<!-- { "blockType": "response", "name": "get-delta-latest_datalink_tokenislatest", "isEmpty": true, "@odata.type": "Collection(microsoft.graph.listItem)" } --> ++```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "value": [ ], + "@odata.deltaLink": "https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/22e03ef3-6ef4-424d-a1d3-92a337807c30/items/delta?token=1230919asd190410jlka" +} +``` ++## Related content +- [Use delta query to track changes in Microsoft Graph data](/graph/delta-query-overview) +- [Best practices for discovering files and detecting changes at scale](/onedrive/developer/rest-api/concepts/scan-guidance) ++<!-- { + "type": "#page.annotation", + "description": "Sync changes from the service to your client state.", + "keywords": "sync,delta,changes,$delta", + "section": "documentation", + "tocPath": "ListItem/Get delta" +} --> |
v1.0 | M365appsinstallationoptions Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/m365appsinstallationoptions-get.md | Namespace: microsoft.graph Read the properties and relationships of an [m365AppsInstallationOptions](../resources/m365appsInstallationoptions.md) object. + ## 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). GET https://graph.microsoft.com/v1.0/admin/microsoft365Apps/installationOptions - ### Response The following example shows a response. >**Note:** The response object shown here might be shortened for readability. |
v1.0 | M365appsinstallationoptions Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/m365appsinstallationoptions-update.md | Namespace: microsoft.graph Update the properties of an [m365AppsInstallationOptions](../resources/m365appsInstallationoptions.md) object. + ## 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). |
v1.0 | Mailfolder Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/mailfolder-get.md | GET /users/{id | userPrincipalName}/mailFolders/{id} ``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.+ ## Request headers-| Name | Type | Description| -|:--|:|:-| -| Authorization | string | Bearer {token}. Required. | ++|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. |
v1.0 | Meetingattendancereport List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/meetingattendancereport-list.md | doc_type: apiPageType Namespace: microsoft.graph -Get a list of [meetingAttendanceReport](../resources/meetingAttendanceReport.md) objects for an [onlineMeeting](../resources/onlinemeeting.md) or a [virtualEvent](../resources/virtualevent.md). Each time an online meeting ends, an attendance report is generated for that session. +Get a list of [meetingAttendanceReport](../resources/meetingAttendanceReport.md) objects for an [onlineMeeting](../resources/onlinemeeting.md) or a [virtualEvent](../resources/virtualevent.md). Each time an online meeting or a virtual event ends, an attendance report is generated for that session. > [!WARNING] > |
v1.0 | Multitenantorganization Delete Tenants | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganization-delete-tenants.md | + + Title: "Remove multiTenantOrganizationMember" +description: "Remove a tenant from a multitenant organization." ++ms.localizationpriority: medium ++++# Remove multiTenantOrganizationMember +Namespace: microsoft.graph ++Remove a tenant from a multitenant organization. A tenant can be removed in the following scenarios: ++* An active member tenant can remove itself. +* An active owner tenant can remove any other tenant. +* An active owner tenant can remove itself as long as there is another active owner tenant remaining. +* An active owner tenant can remove itself as long as there is no other active tenant remaining, thereby deleting the entire multitenant organization. +++## 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": "multitenantorganization_delete_tenants" } --> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /tenantRelationships/multiTenantOrganization/tenants/{tenantId} +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++The following example removes a tenant from a multitenant organization. ++### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_multitenantorganizationmember" +} +--> +``` http +DELETE https://graph.microsoft.com/v1.0/tenantRelationships/multiTenantOrganization/tenants/5036a0a0-a7a4-4933-9086-5dd54535dd6e +``` ++# [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 ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Multitenantorganization Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganization-get.md | + + Title: "Get multiTenantOrganization" +description: "Get properties of the multitenant organization." ++ms.localizationpriority: medium ++++# Get multiTenantOrganization +Namespace: microsoft.graph ++Get properties of the multitenant organization. +++## 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": "multitenantorganization_get" } --> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /tenantRelationships/multiTenantOrganization +``` ++## Optional query parameters +This method supports the `$select` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [multiTenantOrganization](../resources/multitenantorganization.md) object in the response body. ++## Examples ++The following example gets properties of the multitenant organization. ++### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_multitenantorganization" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/tenantRelationships/multiTenantOrganization +``` ++# [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 ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.multiTenantOrganization" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#tenantRelationships/multiTenantOrganization/$entity", + "id": "6d8b39e5-039a-4034-bf3a-e0b4f8cd60b6", + "createdDateTime": "2023-05-26T22:05:23Z", + "displayName": "Contoso organization", + "description": "Multitenant organization between Contoso, Fabrikam, and Woodgrove Bank", + "state": "active" +} +``` ++The following response shows when the requesting tenant is not part of any multitenant organization. ++``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "createdDateTime": null, + "displayName": null, + "description": null, + "state": "inactive" +} +``` + |
v1.0 | Multitenantorganization List Tenants | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganization-list-tenants.md | + + Title: "List multiTenantOrganizationMembers" +description: "List the tenants and their properties in the multitenant organization." ++ms.localizationpriority: medium ++++# List multiTenantOrganizationMembers +Namespace: microsoft.graph ++List the tenants and their properties in the multitenant organization. +++## 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": "multitenantorganization_list_tenants" } --> ++If called with MultiTenantOrganization.Read.All or MultiTenantOrganization.ReadWrite.All permissions, this API returns both active and pending tenants. If called with MultiTenantOrganization.ReadBasic.All permission, the caller can only read the **displayName** and **tenantId** properties. +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /tenantRelationships/multiTenantOrganization/tenants +``` ++## Optional query parameters +This method supports the `$select` and `$filter` 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.| ++## 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 [multiTenantOrganizationMember](../resources/multitenantorganizationmember.md) objects in the response body. ++## Examples ++The following example lists the tenants and their properties in the multitenant organization. ++### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "list_multitenantorganizationmember" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/tenantRelationships/multiTenantOrganization/tenants +``` ++# [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 ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.multiTenantOrganizationMember)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#tenantRelationships/multiTenantOrganization/tenants", + "value": [ + { + "tenantId": "1fd6544e-e994-4de2-9f1b-787b51c7d325", + "displayName": "Contoso", + "addedDateTime": "2023-05-26T22:05:23Z", + "joinedDateTime": null, + "addedByTenantId": "1fd6544e-e994-4de2-9f1b-787b51c7d325", + "role": "owner", + "state": "active", + "transitionDetails": null + }, + { + "tenantId": "4a12efe6-aa14-4d03-8dff-88fc89e2e2ad", + "displayName": "Fabrikam", + "addedDateTime": "2023-05-27T19:24:29Z", + "joinedDateTime": null, + "addedByTenantId": "1fd6544e-e994-4de2-9f1b-787b51c7d325", + "role": "member", + "state": "pending", + "transitionDetails": null + }, + { + "tenantId": "5036a0a0-a7a4-4933-9086-5dd54535dd6e", + "displayName": "Woodgrove Bank", + "addedDateTime": "2023-05-27T20:41:56Z", + "joinedDateTime": null, + "addedByTenantId": "1fd6544e-e994-4de2-9f1b-787b51c7d325", + "role": "member", + "state": "pending", + "transitionDetails": null + } + ] +} +``` + |
v1.0 | Multitenantorganization Post Tenants | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganization-post-tenants.md | + + Title: "Add multiTenantOrganizationMember" +description: "Add a tenant to a multitenant organization." ++ms.localizationpriority: medium ++++# Add multiTenantOrganizationMember +Namespace: microsoft.graph ++Add a tenant to a multitenant organization. The administrator of an owner tenant has the permissions to add tenants to the multitenant organization. The added tenant is in the pending state until the administrator of the added tenant joins the multitenant organization by submitting a join request. A tenant can be part of only one multitenant organization. +++## 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": "multitenantorganization_post_tenants" } --> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /tenantRelationships/multiTenantOrganization/tenants +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [multiTenantOrganizationMember](../resources/multitenantorganizationmember.md) object. ++You can specify the following properties when creating a **multiTenantOrganizationMember**. ++|Property|Type|Description| +|:|:|:| +|tenantId|String|Tenant ID of the Microsoft Entra tenant to add to the multitenant organization. Required.| +|displayName|String|Display name of the tenant added to the multitenant organization. Currently, can't be changed once set. Required.| +|role|multiTenantOrganizationMemberRole|Role of the tenant in the multitenant organization. The possible values are: `owner`, `member` (default), `unknownFutureValue`. Optional.| +++## Response ++If successful, this method returns a `201 Created` response code and a [multiTenantOrganizationMember](../resources/multitenantorganizationmember.md) object in the response body. If the tenant is already pending or active in this multitenant organization, you get a 'Request_BadRequest' error. ++## Examples ++The following example adds the Fabrikam tenant to the multitenant organization. ++### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_multitenantorganizationmember_from_" +} +--> +``` http +POST https://graph.microsoft.com/v1.0/tenantRelationships/multiTenantOrganization/tenants +Content-Type: application/json ++{ + "tenantId": "4a12efe6-aa14-4d03-8dff-88fc89e2e2ad", + "displayName": "Fabrikam" +} +``` ++# [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 ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.multiTenantOrganizationMember" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#tenantRelationships/multiTenantOrganization/tenants/$entity", + "tenantId": "4a12efe6-aa14-4d03-8dff-88fc89e2e2ad", + "displayName": "Fabrikam", + "addedDateTime": "2023-05-27T19:24:29Z", + "joinedDateTime": null, + "addedByTenantId": "1fd6544e-e994-4de2-9f1b-787b51c7d325", + "role": "member", + "state": "pending", + "transitionDetails": null +} +``` ++If tenant is already pending or active in this multitenant organization, you get a 'Request_BadRequest' error. ++```http +HTTP/1.1 400 Bad Request +Content-Type: application/json ++{ + "error": { + "code": "Request_BadRequest", + "message": "Tenant is already being added in Multi-Tenant Organization.", + "innerError": { + "date": "2023-05-27T20:56:14", + "request-id": "a1e5973c-66f1-4853-9e3d-39e6b4f606d1", + "client-request-id": "651548c3-e864-4509-837b-4f5d4cf546a5" + } + } +} +``` |
v1.0 | Multitenantorganization Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganization-update.md | + + Title: "Update multiTenantOrganization" +description: "Update the properties of a multitenant organization." ++ms.localizationpriority: medium ++++# Update multiTenantOrganization +Namespace: microsoft.graph ++Update the properties of a multitenant organization. ++## 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": "multitenantorganization_update" } --> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /tenantRelationships/multiTenantOrganization +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +++|Property|Type|Description| +|:|:|:| +|displayName|String|Display name of the multitenant organization. Optional.| +|description|String|Description of the multitenant organization. Optional.| ++++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++The following example updates the description and display name for a multitenant organization. ++### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_multitenantorganization" +} +--> +``` http +PATCH https://graph.microsoft.com/v1.0/tenantRelationships/multiTenantOrganization +Content-Type: application/json ++{ + "displayName": "Contoso organization", + "description": "Multitenant organization between Contoso, Fabrikam, and Woodgrove Bank" +} +``` ++# [JavaScript](#tab/javascript) ++++### Response ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Multitenantorganizationidentitysyncpolicytemplate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganizationidentitysyncpolicytemplate-get.md | + + Title: "Get multiTenantOrganizationIdentitySyncPolicyTemplate" +description: "Get the cross-tenant access policy template with user synchronization settings for a multitenant organization." ++ms.localizationpriority: medium ++++# Get multiTenantOrganizationIdentitySyncPolicyTemplate +Namespace: microsoft.graph ++Get the cross-tenant access policy template with user synchronization settings for a multitenant organization. +++## 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": "multitenantorganizationidentitysyncpolicytemplate_get" } --> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /policies/crossTenantAccessPolicy/templates/multiTenantOrganizationIdentitySynchronization +``` ++## Optional query parameters +This method supports the `$select` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [multiTenantOrganizationIdentitySyncPolicyTemplate](../resources/multitenantorganizationidentitysyncpolicytemplate.md) object in the response body. ++## Examples ++The following example gets the user synchronization settings of the template. ++### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_multitenantorganizationidentitysyncpolicytemplate" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/policies/crossTenantAccessPolicy/templates/multiTenantOrganizationIdentitySynchronization +``` ++# [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 response shows the unconfigured (or reset) state of the cross-tenant access policy template for user synchronization settings for multitenant organization tenants. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.multiTenantOrganizationIdentitySyncPolicyTemplate" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#policies/crossTenantAccessPolicy/templates/multiTenantOrganizationIdentitySynchronization/$entity", + "templateApplicationLevel": "newPartners,existingPartners", + "id": "0e7aad84-cb46-4b8e-a881-522ef25939f1", + "userSyncInbound": { + "isSyncAllowed": null + } +} +``` ++The following example response shows a configured state of the cross-tenant access policy template for user synchronization settings, after inbound user synchronization has been configured. ++``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#policies/crossTenantAccessPolicy/templates/multiTenantOrganizationIdentitySynchronization/$entity", + "id": "e1a11ff3-01f1-4c48-9784-b9d931571474", + "templateApplicationLevel": "newPartners,existingPartners", + "userSyncInbound": { + "isSyncAllowed": true + } +} +``` |
v1.0 | Multitenantorganizationidentitysyncpolicytemplate Resettodefaultsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganizationidentitysyncpolicytemplate-resettodefaultsettings.md | + + Title: "multiTenantOrganizationIdentitySyncPolicyTemplate: resetToDefaultSettings" +description: "Reset the cross-tenant access policy template with user synchronization settings for a multitenant organization to the default values." ++ms.localizationpriority: medium ++++# multiTenantOrganizationIdentitySyncPolicyTemplate: resetToDefaultSettings +Namespace: microsoft.graph ++Reset the cross-tenant access policy template with user synchronization settings for a multitenant organization to the default values. ++In its reset state, the template has no impact on user synchronization settings, other than that unconfigured user synchronization settings are created if needed, for every multitenant organization tenant. +++## 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": "multitenantorganizationidentitysyncpolicytemplate_resettodefaultsettings" } --> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /policies/crossTenantAccessPolicy/templates/multiTenantOrganizationIdentitySynchronization/resetToDefaultSettings +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this action returns a `204 No Content` response code. ++## Examples ++The following example resets the user synchronization settings of the template to the default values. ++### Request ++<!-- { + "blockType": "request", + "name": "multitenantorganizationidentitysyncpolicytemplatethis.resettodefaultsettings" +} +--> +``` http +POST https://graph.microsoft.com/v1.0/policies/crossTenantAccessPolicy/templates/multiTenantOrganizationIdentitySynchronization/resetToDefaultSettings +``` ++### Response ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Multitenantorganizationidentitysyncpolicytemplate Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganizationidentitysyncpolicytemplate-update.md | + + Title: "Update multiTenantOrganizationIdentitySyncPolicyTemplate" +description: "Update the cross-tenant access policy template with user synchronization settings for a multitenant organization." ++ms.localizationpriority: medium ++++# Update multiTenantOrganizationIdentitySyncPolicyTemplate +Namespace: microsoft.graph ++Update the cross-tenant access policy template with user synchronization settings for a multitenant organization. +++## 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": "multitenantorganizationidentitysyncpolicytemplate_update" } --> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /policies/crossTenantAccessPolicy/templates/multiTenantOrganizationIdentitySynchronization +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +++|Property|Type|Description| +|:|:|:| +|userSyncInbound|[crossTenantUserSyncInbound](../resources/crosstenantusersyncinbound.md)|Determines whether users can be synchronized from the partner tenant. `false` causes any current user synchronization from the source tenant to the target tenant to stop. This property has no impact on existing users who have already been synchronized.| +|templateApplicationLevel|templateApplicationLevel|Specifies whether the template will be applied to user synchronization settings of certain tenants. The possible values are: `none`, `newPartners`, `existingPartners`, `unknownFutureValue`. You can also specify multiple values like `newPartners,existingPartners` (default). `none` indicates the template is not applied to any new or existing partner tenants. `newPartners` indicates the template is applied to new partner tenants. `existingPartners` indicates the template is applied to existing partner tenants, those who already had partner-specific user synchronization settings in place. Optional.| +++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++The following example updates the user synchronization settings of the template. It configures that the template is applied for new and existing partners. For more information, see [crossTenantIdentitySyncPolicyPartner resource type](../resources/crosstenantidentitysyncpolicypartner.md). ++### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_multitenantorganizationidentitysyncpolicytemplate" +} +--> +``` http +PATCH https://graph.microsoft.com/v1.0/policies/crossTenantAccessPolicy/templates/multiTenantOrganizationIdentitySynchronization +Content-Type: application/json ++{ + "templateApplicationLevel": "newPartners,existingPartners", + "userSyncInbound": { + "isSyncAllowed": true + } +} +``` ++# [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 ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Multitenantorganizationjoinrequestrecord Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganizationjoinrequestrecord-get.md | + + Title: "Get multiTenantOrganizationJoinRequestRecord" +description: "Get the status of a tenant joining a multitenant organization." ++ms.localizationpriority: medium ++++# Get multiTenantOrganizationJoinRequestRecord +Namespace: microsoft.graph ++Get the status of a tenant joining a multitenant organization. +++## 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": "multitenantorganizationjoinrequestrecord_get" } --> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /tenantRelationships/multiTenantOrganization/joinRequest +``` ++## Optional query parameters +This method supports the `$select` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [multiTenantOrganizationJoinRequestRecord](../resources/multitenantorganizationjoinrequestrecord.md) object in the response body. ++## Examples ++The following example gets the status of a tenant joining a multitenant organization. ++### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_multitenantorganizationjoinrequestrecord" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/tenantRelationships/multiTenantOrganization/joinRequest +``` ++# [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 before an added tenant joins a multitenant organization. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.multiTenantOrganizationJoinRequestRecord" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#tenantRelationships/multiTenantOrganization/joinRequest/$entity", + "id": "7149c406-fac5-4be9-ad4b-f46fac7fe60c", + "addedByTenantId": "00000000-0000-0000-0000-000000000000", + "memberState": null, + "role": null, + "transitionDetails": null +} +``` ++The following example shows the response after an added tenant [requests to join a multitenant organization](multitenantorganizationjoinrequestrecord-update.md) and the state is still `pending`. ++``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#tenantRelationships/multiTenantOrganization/joinRequest/$entity", + "id": "3e536776-7489-43e9-9637-742d62ec3fc5", + "addedByTenantId": "1fd6544e-e994-4de2-9f1b-787b51c7d325", + "memberState": "pending", + "role": null, + "transitionDetails": { + "desiredMemberState": "active", + "status": "notStarted", + "details": "" + } +} +``` ++The following example shows the response after an added tenant successfully joins a multitenant organization and the state is changed to `active`. ++``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#tenantRelationships/multiTenantOrganization/joinRequest/$entity", + "id": "3e536776-7489-43e9-9637-742d62ec3fc5", + "addedByTenantId": "1fd6544e-e994-4de2-9f1b-787b51c7d325", + "memberState": "active", + "role": member, + "transitionDetails": null +} +``` ++The following example shows the response when an added tenant fails to join a multitenant organization. To reset a failed join request, see [Update multiTenantOrganizationJoinRequestRecord](multitenantorganizationjoinrequestrecord-update.md). ++``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#tenantRelationships/multiTenantOrganization/joinRequest/$entity", + "id": "3e536776-7489-43e9-9637-742d62ec3fc5", + "addedByTenantId": "1fd6544e-e994-4de2-9f1b-787b51c7d325", + "memberState": "pending", + "role": null, + "transitionDetails": { + "desiredMemberState": "active", + "status": "failed", + "details": "DirectoryService Exception" + } +} +``` |
v1.0 | Multitenantorganizationjoinrequestrecord Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganizationjoinrequestrecord-update.md | + + Title: "Update multiTenantOrganizationJoinRequestRecord" +description: "Join a multitenant organization." ++ms.localizationpriority: medium ++++# Update multiTenantOrganizationJoinRequestRecord +Namespace: microsoft.graph ++Join a multitenant organization, after the owner of the multitenant organization has added your tenant to the multitenant organization as pending. ++Before a tenant added to a multitenant organization can participate in the multitenant organization, the administrator of the joining tenant must submit a join request. ++To allow for asynchronous processing, you must wait **up to 2 hours** before joining a multitenant organization is completed. +++## 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": "multitenantorganizationjoinrequestrecord_update" } --> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /tenantRelationships/multiTenantOrganization/joinRequest +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +++|Property|Type|Description| +|:|:|:| +|addedByTenantId|String|Tenant ID of the Microsoft Entra tenant that added the current tenant to the multitenant organization. To reset a failed join request, set `addedByTenantId` to `00000000-0000-0000-0000-000000000000`. Required.| +++## Response ++If successful, this method returns a `204 No Content` response code. ++A join request might be unsuccessful. The following are some scenarios: ++* The joining tenant has not been added to the multitenant organization by its owner. +* The owner or joiner tenant exceeds the maximum number of internal users per tenant. +* The multitenant organization would exceed the maximum number of tenants. +* The joining tenant is already part of a different multitenant organization. ++## Examples ++### Example 1: Join a multitenant organization ++The following example shows a request by the current tenant to join a multitenant organization. It can take a few minutes for the join to complete. If the join succeeds, the state of the tenant is changed to `active`. ++#### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_multitenantorganizationjoinrequestrecord" +} +--> +``` http +PATCH https://graph.microsoft.com/v1.0/tenantRelationships/multiTenantOrganization/joinRequest +Content-Type: application/json ++{ + "addedByTenantId": "1fd6544e-e994-4de2-9f1b-787b51c7d325" +} +``` ++# [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 ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` ++### Example 2: Reset a failed join request ++The following example shows a request by the current tenant to reset a failed join request. To reset a failed join request, set `addedByTenantId` to `00000000-0000-0000-0000-000000000000`. ++#### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_multitenantorganizationjoinrequestrecord_joinfailed" +} +--> +``` http +PATCH https://graph.microsoft.com/v1.0/tenantRelationships/multiTenantOrganization/joinRequest +Content-Type: application/json ++{ + "addedByTenantId": "00000000-0000-0000-0000-000000000000" +} +``` ++# [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 ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` |
v1.0 | Multitenantorganizationmember Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganizationmember-get.md | + + Title: "Get multiTenantOrganizationMember" +description: "Get a tenant and its properties in the multitenant organization." ++ms.localizationpriority: medium ++++# Get multiTenantOrganizationMember +Namespace: microsoft.graph ++Get a tenant and its properties in the multitenant organization. +++## 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": "multitenantorganizationmember_get" } --> ++If called with MultiTenantOrganization.ReadBasic.All permission, the caller can only read the **displayName** and **tenantId** properties. +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /tenantRelationships/multiTenantOrganization/tenants/{tenantId} +``` ++## Optional query parameters +This method supports the `$select` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [multiTenantOrganizationMember](../resources/multitenantorganizationmember.md) object in the response body. ++## Examples ++The following example gets a tenant and its properties in the multitenant organization. ++### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_multitenantorganizationmember" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/tenantRelationships/multiTenantOrganization/tenants/1fd6544e-e994-4de2-9f1b-787b51c7d325 +``` ++# [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 ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.multiTenantOrganizationMember" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#tenantRelationships/multiTenantOrganization/tenants/$entity", + "tenantId": "1fd6544e-e994-4de2-9f1b-787b51c7d325", + "displayName": "Contoso", + "addedDateTime": "2023-05-26T22:05:23Z", + "joinedDateTime": null, + "addedByTenantId": "1fd6544e-e994-4de2-9f1b-787b51c7d325", + "role": "owner", + "state": "active", + "transitionDetails": null +} +``` ++If an update is in progress, `transitionDetails` lists information about the update. The following response indicates the role is being changed from member to owner. ++``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#tenantRelationships/multiTenantOrganization/tenants/$entity", + "tenantId": "5036a0a0-a7a4-4933-9086-5dd54535dd6e", + "displayName": "Woodgrove Bank", + "addedDateTime": "2023-05-27T21:52:40Z", + "joinedDateTime": null, + "addedByTenantId": "1fd6544e-e994-4de2-9f1b-787b51c7d325", + "role": "member", + "state": "pending", + "transitionDetails": { + "desiredState": "active", + "desiredRole": "owner", + "status": "notStarted", + "details": null + } +} +``` + |
v1.0 | Multitenantorganizationmember Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganizationmember-update.md | + + Title: "Update multiTenantOrganizationMember" +description: "Update the properties of a tenant in a multitenant organization." ++ms.localizationpriority: medium ++++# Update multiTenantOrganizationMember +Namespace: microsoft.graph ++Update the properties of a tenant in a multitenant organization. Only owner tenants can call this API. +++## 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": "multitenantorganizationmember_update" } --> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /tenantRelationships/multiTenantOrganization/tenants/{tenantId} +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +++|Property|Type|Description| +|:|:|:| +|role|multiTenantOrganizationMemberRole|Role of the tenant in the multitenant organization. The possible values are: `owner`, `member` (default), `unknownFutureValue`. Optional.| +++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++The following example changes the role of a tenant in a multitenant organization from member to owner. ++### Request ++<!-- { + "blockType": "request", + "name": "update_multitenantorganizationmember" +} +--> +``` http +PATCH https://graph.microsoft.com/v1.0/tenantRelationships/multiTenantOrganization/tenant/5036a0a0-a7a4-4933-9086-5dd54535dd6e +Content-Type: application/json ++{ + "role": "owner" +} +``` +++### Response ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Multitenantorganizationpartnerconfigurationtemplate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganizationpartnerconfigurationtemplate-get.md | + + Title: "Get multiTenantOrganizationPartnerConfigurationTemplate" +description: "Get the cross-tenant access policy template with inbound and outbound partner configuration settings for a multitenant organization." ++ms.localizationpriority: medium ++++# Get multiTenantOrganizationPartnerConfigurationTemplate +Namespace: microsoft.graph ++Get the cross-tenant access policy template with inbound and outbound partner configuration settings for a multitenant organization. +++## 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": "multitenantorganizationpartnerconfigurationtemplate_get" } --> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /policies/crossTenantAccessPolicy/templates/multiTenantOrganizationPartnerConfiguration +``` ++## Optional query parameters +This method supports the `$select` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [multiTenantOrganizationPartnerConfigurationTemplate](../resources/multitenantorganizationpartnerconfigurationtemplate.md) object in the response body. ++## Examples ++The following example gets the partner configuration settings of the template. ++### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_multitenantorganizationpartnerconfigurationtemplate" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/policies/crossTenantAccessPolicy/templates/multiTenantOrganizationPartnerConfiguration +``` ++# [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 response shows the unconfigured (or reset) state of the cross-tenant access policy template for partner configuration settings for multitenant organization tenants. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.multiTenantOrganizationPartnerConfigurationTemplate" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#policies/crossTenantAccessPolicy/templates/multiTenantOrganizationPartnerConfiguration/$entity", + "id": "75b1889b-6f42-4cc5-8e62-e774b8db243c", + "templateApplicationLevel": "newPartners,existingPartners", + "inboundTrust": null, + "b2bCollaborationOutbound": null, + "b2bCollaborationInbound": null, + "b2bDirectConnectOutbound": null, + "b2bDirectConnectInbound": null, + "automaticUserConsentSettings": { + "inboundAllowed": null, + "outboundAllowed": null + } +} +``` ++The following example response shows a configured state of the cross-tenant access policy template for partner configuration settings, after inbound trust and automatic redemption have been configured. ++``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#policies/crossTenantAccessPolicy/templates/multiTenantOrganizationPartnerConfiguration/$entity", + "id": "8d253b1b-1798-434a-8e77-bec3774d1512", + "templateApplicationLevel": "newPartners,existingPartners", + "b2bCollaborationOutbound": null, + "b2bCollaborationInbound": null, + "b2bDirectConnectOutbound": null, + "b2bDirectConnectInbound": null, + "inboundTrust": { + "isMfaAccepted": true, + "isCompliantDeviceAccepted": true, + "isHybridAzureADJoinedDeviceAccepted": true + }, + "automaticUserConsentSettings": { + "inboundAllowed": true, + "outboundAllowed": true + } +} +``` + |
v1.0 | Multitenantorganizationpartnerconfigurationtemplate Resettodefaultsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganizationpartnerconfigurationtemplate-resettodefaultsettings.md | + + Title: "multiTenantOrganizationPartnerConfigurationTemplate: resetToDefaultSettings" +description: "Reset the cross-tenant access policy template with inbound and outbound partner configuration settings for a multitenant organization to the default values." ++ms.localizationpriority: medium ++++# multiTenantOrganizationPartnerConfigurationTemplate: resetToDefaultSettings +Namespace: microsoft.graph ++Reset the cross-tenant access policy template with inbound and outbound partner configuration settings for a multitenant organization to the default values. ++In its reset state, the template has no impact on partner configuration settings, other than that an unconfigured partner configuration is created if needed, for every multitenant organization tenant. +++## 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": "multitenantorganizationpartnerconfigurationtemplate_resettodefaultsettings" } --> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /policies/crossTenantAccessPolicy/templates/multiTenantOrganizationPartnerConfiguration/resetToDefaultSettings +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this action returns a `204 No Content` response code. ++## Examples ++The following example resets the inbound and outbound partner configuration settings of the template to the default values. ++### Request ++<!-- { + "blockType": "request", + "name": "multitenantorganizationpartnerconfigurationtemplatethis.resettodefaultsettings" +} +--> +``` http +POST https://graph.microsoft.com/v1.0/policies/crossTenantAccessPolicy/templates/multiTenantOrganizationPartnerConfiguration/resetToDefaultSettings +``` ++### Response ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Multitenantorganizationpartnerconfigurationtemplate Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganizationpartnerconfigurationtemplate-update.md | + + Title: "Update multiTenantOrganizationPartnerConfigurationTemplate" +description: "Update the cross-tenant access policy template with inbound and outbound partner configuration settings for a multitenant organization." ++ms.localizationpriority: medium ++++# Update multiTenantOrganizationPartnerConfigurationTemplate +Namespace: microsoft.graph ++Update the cross-tenant access policy template with inbound and outbound partner configuration settings for a multitenant organization. +++## 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": "multitenantorganizationpartnerconfigurationtemplate_update" } --> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /policies/crossTenantAccessPolicy/templates/multiTenantOrganizationPartnerConfiguration +``` ++## Request headers ++|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +++|Property|Type|Description| +|:|:|:| +|inboundTrust|[crossTenantAccessPolicyInboundTrust](../resources/crosstenantaccesspolicyinboundtrust.md)|Determines the partner-specific configuration for trusting other Conditional Access claims from external Microsoft Entra organizations. Optional.| +|b2bCollaborationOutbound|[crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md)|Defines your partner-specific configuration for users in your organization going outbound to access resources in another organization via Microsoft Entra B2B collaboration. Optional.| +|b2bCollaborationInbound|[crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md)|Defines your partner-specific configuration for users from other organizations accessing your resources via Microsoft Entra B2B collaboration. Optional.| +|b2bDirectConnectOutbound|[crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md)|Defines your partner-specific configuration for users in your organization going outbound to access resources in another organization via Microsoft Entra B2B direct connect. Optional.| +|b2bDirectConnectInbound|[crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md)|Defines your partner-specific configuration for users from other organizations accessing your resources via Microsoft Entra B2B direct connect. Optional.| +|automaticUserConsentSettings|[inboundOutboundPolicyConfiguration](../resources/inboundoutboundpolicyconfiguration.md)|Determines the partner-specific configuration for automatic user consent settings. Optional.| +|templateApplicationLevel|templateApplicationLevel|Specifies whether the template will be applied to partner configuration settings of certain tenants. The possible values are: `none`, `newPartners`, `existingPartners`, `unknownFutureValue`. You can also specify multiple values like `newPartners,existingPartners` (default). `none` indicates the template isn't applied to any new or existing partner tenants. `newPartners` indicates the template is applied to new partner tenants. `existingPartners` indicates the template is applied to existing partner tenants, those who already had partner-specific partner configurations in place. Optional.| +++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++The following example configures the inbound trust settings to accept MFA, compliant, and Microsoft Entra hybrid joined devices from the partner tenant. It configures automatic redemption on behalf of your users and accepts admin consent for the users of the partner. It configures that the template is applied for new and existing partners. For more information, see [crossTenantAccessPolicyConfigurationPartner resource type](../resources/crosstenantaccesspolicyconfigurationpartner.md). ++### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_multitenantorganizationpartnerconfigurationtemplate" +} +--> +``` http +PATCH https://graph.microsoft.com/v1.0/policies/crossTenantAccessPolicy/templates/multiTenantOrganizationPartnerConfiguration +Content-Type: application/json ++{ + "inboundTrust": { + "isMfaAccepted": true, + "isCompliantDeviceAccepted": true, + "isHybridAzureADJoinedDeviceAccepted": true + }, + "automaticUserConsentSettings": { + "inboundAllowed": true, + "outboundAllowed": true + }, + "templateApplicationLevel": "newPartners,existingPartners" +} ++``` ++# [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 ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` |
v1.0 | Opentypeextension Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/opentypeextension-delete.md | Title: "Delete open extension" description: "Delete an open extension (openTypeExtension object) from the specified instance of a resource." ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | Opentypeextension Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/opentypeextension-get.md | Title: "Get open extension" description: "Get an open extension (openTypeExtension object) identified by name or fully qualified name." ms.localizationpriority: high + doc_type: apiPageType |
v1.0 | Opentypeextension Post Opentypeextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/opentypeextension-post-opentypeextension.md | Title: "Create open extension" description: "Create an open extension (openTypeExtension object) and add custom properties in a new or existing instance of a resource." ms.localizationpriority: high + doc_type: apiPageType |
v1.0 | Opentypeextension Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/opentypeextension-update.md | Title: "Update open extension" description: "Update an open extension (openTypeExtension object) with the properties in the request body:" ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | Outlookcategory Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/outlookcategory-update.md | Title: "Update Outlook category" -description: "Update the writable property, **color**, of the specified outlookCategory object. You can't modify the **displayName** property " + Title: "Update outlookCategory" +description: "Update the writable property, **color**, of the specified outlookCategory object." ms.localizationpriority: medium doc_type: apiPageType -# Update Outlook category +# Update outlookCategory Namespace: microsoft.graph -Update the writable property, **color**, of the specified [outlookCategory](../resources/outlookcategory.md) object. You can't modify the **displayName** property -once you have created the category. +Update the writable property, **color**, of the specified [outlookCategory](../resources/outlookcategory.md) object. You can't modify the **displayName** property once you have created the category. [!INCLUDE [national-cloud-support](../../includes/global-us.md)] maintains their previous values or are recalculated based on changes to other pr ## Response -If successful, this method returns a `200 OK` response code and updated [outlookCategory](../resources/outlookcategory.md) object in the response body. +If successful, this method returns a `200 OK` response code and an updated [outlookCategory](../resources/outlookcategory.md) object in the response body. ## Example-##### Request +### Request The following example shows a request. # [HTTP](#tab/http) Content-type: application/json -##### Response -The following example shows the response. Note: The response object shown here might be shortened for readability. +### Response +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", "truncated": true, |
v1.0 | Outlookuser List Mastercategories | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/outlookuser-list-mastercategories.md | Title: "List Outlook categories" -description: "Get all the categories that have been defined for the user." + Title: "List masterCategories" +description: "Get all the categories that have been defined for a user." ms.localizationpriority: medium doc_type: apiPageType -# List Outlook categories +# List masterCategories Namespace: microsoft.graph -Get all the categories that have been defined for the user. +Get all the categories that have been defined for a user. [!INCLUDE [national-cloud-support](../../includes/global-us.md)] |
v1.0 | Partners Billing Billedreconciliation Export | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/partners-billing-billedreconciliation-export.md | Namespace: microsoft.graph.partners.billing Export the billed invoice reconciliation data. + ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/billedreconciliationthisexport-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/billedreconciliationthisexport-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Planner Post Plans | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/planner-post-plans.md | Title: "Create plannerPlan" -description: "Use this API to create a new **plannerPlan**." +description: "Create a new plannerPlan object." ms.localizationpriority: medium doc_type: apiPageType Namespace: microsoft.graph -Use this API to create a new **plannerPlan**. +Create a new [plannerPlan](../resources/plannerplan.md) object. [!INCLUDE [national-cloud-support](../../includes/global-us.md)] The following table shows the properties that are required when you create a [pl |Property|Type|Description| |:|:|:|-|container|[plannerPlanContainer](../resources/plannerplancontainer.md)|Identifies the container of the plan. Specify only the **url**, the **containerId** and **type**, or all properties. After it is set, this property canΓÇÖt be updated.| +|container|[plannerPlanContainer](../resources/plannerplancontainer.md)|Identifies the container of the plan. Specify only the **url**, the **containerId** and **type**, or all properties. After it's set, this property can't be updated.| |title|String|The title of the plan.| ->**Note:** If the container is a Microsoft 365 group, the user who is creating the plan must be a member of the group that will contain the plan. When you create a new group by using [Create group](../api/group-post-groups.md), you are not added to the group as a member. After the group is created, add yourself as a member by using [group post members](../api/group-post-members.md). +>**Note:** If the container is a Microsoft 365 group, the user who creates the plan must be a member of the group that contains the plan. When you create a new group by using [Create group](../api/group-post-groups.md), you aren't added to the group as a member. After the group is created, add yourself as a member by using [group post members](../api/group-post-members.md). ## Response This method can return any of the [HTTP status codes](/graph/errors). The most c The following example shows a request. - # [HTTP](#tab/http) <!-- { "blockType": "request", Content-type: application/json { "container": {- "url": "https://graph.microsoft.com/beta/groups/ebf3b108-5234-4e22-b93d-656d7dae5874" + "url": "https://graph.microsoft.com/v1.0/groups/ebf3b108-5234-4e22-b93d-656d7dae5874" }, "title": "title-value" } Content-type: application/json "createdDateTime": "2015-03-30T18:36:49.2407981Z", "container": { "@odata.type": "microsoft.graph.plannerPlanContainer",- "url": "https://graph.microsoft.com/beta/groups/ebf3b108-5234-4e22-b93d-656d7dae5874", + "url": "https://graph.microsoft.com/v1.0/groups/ebf3b108-5234-4e22-b93d-656d7dae5874", "containerId": "ebf3b108-5234-4e22-b93d-656d7dae5874", "type": "group" }, |
v1.0 | Plannertask Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/plannertask-update.md | PATCH /planner/tasks/{id} | Property | Type |Description| |:|:--|:-|-|appliedCategories|[plannerAppliedCategories](../resources/plannerappliedcategories.md)|The categories to which the task has been applied. See [applied Categories](../resources/plannerappliedcategories.md) for possible values.| +|appliedCategories|[plannerAppliedCategories](../resources/plannerappliedcategories.md)|The categories to which the task has been applied. For possible values, see [appliedCategories](../resources/plannerappliedcategories.md).| |assigneePriority|String|Hint used to order items of this type in a list view. The format is defined in [Using order hints in Planner](../resources/planner-order-hint-format.md).| |assignments|[plannerAssignments](../resources/plannerassignments.md)|The set of users the task is assigned to.|-|bucketId|String|Bucket ID to which the task belongs. The bucket needs to be in the plan that the task is in. It is 28 characters long and case-sensitive. [Format validation](../resources/planner-identifiers-disclaimer.md) is done on the service. | +|bucketId|String|Bucket ID to which the task belongs. The bucket needs to be in the plan that the task is in. The value is 28 characters long and case-sensitive. [Format validation](../resources/planner-identifiers-disclaimer.md) is done on the service. | |conversationThreadId|String|Thread ID of the conversation on the task. This is the ID of the conversation thread object created in the group.| |dueDateTime|DateTimeOffset|Date and time at which the task is due. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| |orderHint|String|Hint used to order items of this type in a list view. The format is defined in [Using order hints in Planner](../resources/planner-order-hint-format.md).| PATCH /planner/tasks/{id} |startDateTime|DateTimeOffset|Date and time at which the task starts. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| |title|String|Title of the task.| +> [!NOTE] +> For Project tasks that are replicated to Planner, only the **percentComplete** property can be updated. + ## Response If successful, this method returns a `204 No Content` response code and an empty content. If the request specifies the `Prefer` header with a `return=representation` preference, then this method returns a `200 OK` response code and an updated [plannerTask](../resources/plannertask.md) object in the response body. |
v1.0 | Printershare Delete Allowedgroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/printershare-delete-allowedgroup.md | DELETE https://graph.microsoft.com/v1.0/print/shares/{printerShareId}/allowedGro [!INCLUDE [sample-code](../includes/snippets/php/delete-allowedgroup-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -# [PowerShell](#tab/powershell) - # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-allowedgroup-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Printershare Delete Alloweduser | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/printershare-delete-alloweduser.md | DELETE https://graph.microsoft.com/v1.0/print/shares/{printerShareId}/allowedUse [!INCLUDE [sample-code](../includes/snippets/php/delete-alloweduser-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -# [PowerShell](#tab/powershell) - # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-alloweduser-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Profilephoto Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/profilephoto-delete.md | Delete the photo for the signed-in user or the specified group. > > The delete operation supports only user or group photos, but _not Outlook contact nor Teams photos_. + ## Permissions The following tables show the least privileged permission or permissions required to call this API on each supported resource type. Follow [best practices](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions) to request least privileged 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). The following example shows a request. DELETE https://graph.microsoft.com/v1.0/me/photo/$value ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/delete-profilephoto-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) ++# [Python](#tab/python) + ### Response |
v1.0 | Reportroot Getrelyingpartydetailedsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/reportroot-getrelyingpartydetailedsummary.md | + + Title: "reportRoot: getRelyingPartyDetailedSummary" +description: "Get a summary of AD FS relying parties information." ++ms.localizationpriority: medium ++++# reportRoot: getRelyingPartyDetailedSummary ++Namespace: microsoft.graph +++Get a summary of AD FS relying parties information. +++## 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": "reportroot-getrelyingpartydetailedsummary-permissions" +} +--> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /reports/getRelyingPartyDetailedSummary(period='parameterValue') +``` ++## Function parameters +In the request URL, provide the following query parameters with values. +The following table lists the parameters that are required when you call this function. ++## Optional query parameters ++This method supports the `$filter` and `$orderby` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++|Parameter|Type|Description| +|:|:|:| +|period|String|Specifies the length of time over which the report is aggregated. The supported values are: D1, D7, D30. These values follow the format `Dn` where n represents the number of days over which the report is aggregated.| +++## Request headers ++|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body ++Don't supply a request body for this method. ++## Response ++If successful, this function returns a `200 OK` response code and a [relyingPartyDetailedSummary](../resources/relyingpartydetailedsummary.md) collection in the response body. ++## Examples ++### Request ++The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "reportrootthis.getrelyingpartydetailedsummary" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/reports/getRelyingPartyDetailedSummary(period='D7') +``` ++# [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. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.relyingPartyDetailedSummary)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "@odata.type": "#microsoft.graph.relyingPartyDetailedSummary", + "id": "31b45f83-0f5c-40be-80af-02e918f3b55b", + "relyingPartyId": "https://customer.contoso.com/mgmt", + "serviceId": "4cce6fff-4ccc-41fe-8521-bce16ea521e9", + "relyingPartyName": "Contoso", + "successfulSignInCount": 0, + "failedSignInCount": 225, + "totalSignInCount": 225, + "signInSuccessRate": 0, + "uniqueUserCount": 1, + "migrationStatus": "ready", + "replyUrls": [ + "https://adfshelp.microsoft.com/Contoso/tokenresponse" + ], + "migrationValidationDetails": [ + { + "name": "AdditionalWSFedEndpointCheckResult", + "value": "{\"result\": 0, \"message\": \"No additional WS-Federation endpoints were found.\"}" + }, + { + "name": "AllowedAuthenticationClassReferencesCheckResult", + "value": "{\"result\": 0, \"message\": \"AllowedAuthenticationClassReferences is not set up.\"}" + } + ] + } + ] +} +``` ++<!-- { + "type": "#page.annotation", + "description": "reportRoot: getRelyingPartyDetailedSummary", + "keywords": "", + "section": "documentation", + "tocPath": "", + "suppressions": [ + "Error: reportrootthis.getrelyingpartydetailedsummary/container/signInSuccessRate: + Expected type Double but actual was Int64. Property: signInSuccessRate, actual value: '0'" + ] +}--> + |
v1.0 | Samlorwsfedexternaldomainfederation Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/samlorwsfedexternaldomainfederation-delete.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "samlorwsfedexternaldomainfederation_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/samlorwsfedexternaldomainfederation-delete-permissions.md)] -The work or school account needs to belong to one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Samlorwsfedexternaldomainfederation Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/samlorwsfedexternaldomainfederation-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "samlorwsfedexternaldomainfederation_get" } --> [!INCLUDE [permissions-table](../includes/permissions/samlorwsfedexternaldomainfederation-get-permissions.md)] -The work or school account needs to belong to one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Samlorwsfedexternaldomainfederation List Domains | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/samlorwsfedexternaldomainfederation-list-domains.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "samlorwsfedexternaldomainfederation_list_domains" } --> [!INCLUDE [permissions-table](../includes/permissions/samlorwsfedexternaldomainfederation-list-domains-permissions.md)] -The work or school account needs to belong to one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Samlorwsfedexternaldomainfederation List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/samlorwsfedexternaldomainfederation-list.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "samlorwsfedexternaldomainfederation_list" } --> [!INCLUDE [permissions-table](../includes/permissions/samlorwsfedexternaldomainfederation-list-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Samlorwsfedexternaldomainfederation Post Domains | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/samlorwsfedexternaldomainfederation-post-domains.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "samlorwsfedexternaldomainfederation_post_domains" } --> [!INCLUDE [permissions-table](../includes/permissions/samlorwsfedexternaldomainfederation-post-domains-permissions.md)] -The work or school account needs to belong to one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Samlorwsfedexternaldomainfederation Post | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/samlorwsfedexternaldomainfederation-post.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "samlorwsfedexternaldomainfederation_post" } --> [!INCLUDE [permissions-table](../includes/permissions/samlorwsfedexternaldomainfederation-post-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Samlorwsfedexternaldomainfederation Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/samlorwsfedexternaldomainfederation-update.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "samlorwsfedexternaldomainfederation_update" } --> [!INCLUDE [permissions-table](../includes/permissions/samlorwsfedexternaldomainfederation-update-permissions.md)] -The work or school account needs to belong to one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): --* Global Administrator -* External Identity Provider Administrator ## HTTP request |
v1.0 | Schemaextension Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/schemaextension-delete.md | Title: "Delete schemaExtension" description: "Delete the definition of a schema extension." ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | Schemaextension Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/schemaextension-get.md | Title: "Get schemaExtension" description: "Get the properties of the specified schemaExtension definition." ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | Schemaextension List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/schemaextension-list.md | Title: "List schemaExtensions" description: "Get a list of schemaExtension objects created by any apps you own in the current tenant (that can be " ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | Schemaextension Post Schemaextensions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/schemaextension-post-schemaextensions.md | Title: "Create schemaExtension" description: "Create a new schemaExtension definition to extend a supporting resource type." ms.localizationpriority: high + doc_type: apiPageType |
v1.0 | Schemaextension Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/schemaextension-update.md | Title: "Update schemaExtension" description: "Update properties in the definition of the specified schemaExtension." ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | Search Acronym Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-acronym-delete.md | Namespace: microsoft.graph.search Delete an [acronym](../resources/search-acronym.md) object. + ## 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). DELETE https://graph.microsoft.com/v1.0/search/acronyms/733b26d5-af76-4eea-ac69- [!INCLUDE [sample-code](../includes/snippets/php/delete-acronym-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-acronym-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Search Acronym Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-acronym-get.md | Namespace: microsoft.graph.search Read the properties and relationships of an [acronym](../resources/search-acronym.md) object. + ## 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). GET https://graph.microsoft.com/v1.0/search/acronyms/733b26d5-af76-4eea-ac69-1a0 [!INCLUDE [sample-code](../includes/snippets/php/get-acronym-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-acronym-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Search Acronym Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-acronym-update.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/update-acronym-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/update-acronym-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Search Bookmark Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-bookmark-delete.md | Namespace: microsoft.graph.search Delete a [bookmark](../resources/search-bookmark.md) object. + ## 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). DELETE https://graph.microsoft.com/v1.0/search/bookmarks/733b26d5-af76-4eea-ac69 [!INCLUDE [sample-code](../includes/snippets/php/delete-bookmark-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-bookmark-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Search Bookmark Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-bookmark-get.md | Namespace: microsoft.graph.search Read the properties and relationships of a [bookmark](../resources/search-bookmark.md) object. + ## 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). GET https://graph.microsoft.com/v1.0/search/bookmarks/733b26d5-af76-4eea-ac69-1a [!INCLUDE [sample-code](../includes/snippets/php/get-bookmark-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-bookmark-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Search Bookmark Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-bookmark-update.md | Namespace: microsoft.graph.search Update the properties of a [bookmark](../resources/search-bookmark.md) object. + ## 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). Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/update-bookmark-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/update-bookmark-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Search Qna Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-qna-delete.md | Namespace: microsoft.graph.search Delete a [qna](../resources/search-qna.md) object. + ## 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). DELETE https://graph.microsoft.com/v1.0/search/qnas/733b26d5-af76-4eea-ac69-1a0c [!INCLUDE [sample-code](../includes/snippets/php/delete-qna-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-qna-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Search Qna Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-qna-get.md | GET https://graph.microsoft.com/v1.0/search/qnas/733b26d5-af76-4eea-ac69-1a0ce87 [!INCLUDE [sample-code](../includes/snippets/php/get-qna-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-qna-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Search Qna Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-qna-update.md | Namespace: microsoft.graph.search Update the properties of a [qna](../resources/search-qna.md) object. + ## 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). Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/update-qna-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/update-qna-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Search Searchentity List Acronyms | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-searchentity-list-acronyms.md | Namespace: microsoft.graph.search Get a list of the [acronym](../resources/search-acronym.md) objects and their properties. + ## 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). GET https://graph.microsoft.com/v1.0/search/acronyms [!INCLUDE [sample-code](../includes/snippets/php/list-acronym-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-acronym-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Search Searchentity List Bookmarks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-searchentity-list-bookmarks.md | Namespace: microsoft.graph.search Get a list of [bookmark](../resources/search-bookmark.md) objects and their properties. + ## 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). GET https://graph.microsoft.com/v1.0/search/bookmarks [!INCLUDE [sample-code](../includes/snippets/php/list-bookmark-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-bookmark-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Search Searchentity List Qnas | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-searchentity-list-qnas.md | Namespace: microsoft.graph.search Get a list of the [qna](../resources/search-qna.md) objects and their properties. + ## 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). GET https://graph.microsoft.com/v1.0/search/qnas [!INCLUDE [sample-code](../includes/snippets/php/list-qna-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-qna-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Search Searchentity Post Acronyms | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-searchentity-post-acronyms.md | Namespace: microsoft.graph.search Create a new [acronym](../resources/search-acronym.md) object. + ## 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). Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/create-acronym-from-acronyms-e1-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/create-acronym-from-acronyms-e1-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Search Searchentity Post Bookmarks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-searchentity-post-bookmarks.md | Namespace: microsoft.graph.search Create a new [bookmark](../resources/search-bookmark.md) object. + ## 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). Content-Type: application/json "description": "Try or buy Contoso for Home or Business and view product information", "keywords": { "keywords": ["Contoso", "install"],- "reservedKeywords": ["Contoso"], + "reservedKeywords": ["Unique keyword"], "matchSimilarKeywords": true }, "availabilityStartDateTime": null, Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/create-bookmark-from-bookmarks-e1-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/create-bookmark-from-bookmarks-e1-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Search Searchentity Post Qnas | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-searchentity-post-qnas.md | Namespace: microsoft.graph.search Create a new [qna](../resources/search-qna.md) object. + ## 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). Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/create-qna-from-qnas-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/create-qna-from-qnas-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Security Authoritytemplate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-authoritytemplate-get.md | + + Title: "Get authorityTemplate" +description: "Read the properties and relationships of an authorityTemplate." ++ms.localizationpriority: medium +++# Get authorityTemplate +Namespace: microsoft.graph.security ++Read the properties and relationships of a [authorityTemplate](../resources/security-authoritytemplate.md) object. +++## 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": "security_authoritytemplate_get" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/labels/authorities/{authorityTemplateId} +GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/authorityTemplate +``` ++## 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.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) object in the response body. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_authoritytemplate" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/security/labels/authorities/a94af2e3-853b-6fcc-c898-d61d3a6d9efc +``` ++# [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 +Here's an example of the response. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.security.authorityTemplate" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": { + "@odata.type": "#microsoft.graph.security.authorityTemplate", + "id": "a94af2e3-853b-6fcc-c898-d61d3a6d9efc", + "displayName": "String", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} +} +``` + |
v1.0 | Security Categorytemplate Delete Subcategories | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-categorytemplate-delete-subcategories.md | + + Title: "Delete subcategoryTemplate" +description: "Delete a subcategoryTemplate object." ++ms.localizationpriority: medium +++# Delete subcategoryTemplate +Namespace: microsoft.graph.security ++Delete a [subcategoryTemplate](../resources/security-subcategorytemplate.md) object. ++## 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": "security_categorytemplate_delete_subcategories" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /security/labels/categories/{categoryTemplateId}/subcategories/{subcategoryTemplateId}/$ref +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_subcategorytemplate" +} +--> +``` http +DELETE https://graph.microsoft.com/v1.0/security/labels/categories/f44dkle55-6baf-44ff-5dcc-08d8de97b1d5/subcategories/6cf65e55-6baf-44ff-5dcc-08d8de97b1d5 +``` ++# [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 +Here's an example of the response. +> +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Security Categorytemplate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-categorytemplate-get.md | + + Title: "Get categoryTemplate" +description: "Read the properties and relationships of a categoryTemplate object." ++ms.localizationpriority: medium +++# Get categoryTemplate +Namespace: microsoft.graph.security ++Read the properties and relationships of a [categoryTemplate](../resources/security-categorytemplate.md) object. +++## 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": "security_categorytemplate_get" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/labels/categories/{categoryTemplateId} +GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate +``` ++## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For example, to retrieve the **subategories** property associated with this particular category, you can use the `expand` parameter:`$expand=subcategories`. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) object in the response body. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_categorytemplate" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/security/labels/categories/e2c79762-34a9-75ba-b6f0-a7c9a57978ef +``` ++# [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 +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.security.categoryTemplate" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": { + "@odata.type": "#microsoft.graph.security.categoryTemplate", + "id": "e2c79762-34a9-75ba-b6f0-a7c9a57978ef", + "displayName": "Accounts payable", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} +} +``` + |
v1.0 | Security Categorytemplate List Subcategories | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-categorytemplate-list-subcategories.md | + + Title: "List subcategories" +description: "Get the subcategoryTemplate resources from the subcategories navigation property." ++ms.localizationpriority: medium +++# List subcategories +Namespace: microsoft.graph.security ++Get a list of subcategories [subcategoryTemplate](../resources/security-subcategorytemplate.md) associated with a category template. +++## 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": "security_categorytemplate_list_subcategories" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/labels/categories/{categoryTemplateId}/subcategories +``` ++## 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.| ++## 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 [microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md) objects in the response body. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "list_subcategorytemplate" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/security/labels/categories/{categoryTemplateId}/subcategories +``` ++# [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 +Here's an example of the response. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.security.subcategoryTemplate)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "@odata.type": "#microsoft.graph.security.subcategoryTemplate", + "id": "2ac39915-dbeb-e933-82e2-92b981835fa0", + "displayName": "Vendor Invoice", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-03-24T02:09:08Z" + } + ] +} +``` + |
v1.0 | Security Categorytemplate Post Subcategories | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-categorytemplate-post-subcategories.md | + + Title: "Create subcategoryTemplate" +description: "Create a new subcategoryTemplate object." ++ms.localizationpriority: medium +++# Create subcategoryTemplate +Namespace: microsoft.graph.security ++Create a new [subcategoryTemplate](../resources/security-subcategorytemplate.md) object. +++## 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": "security_categorytemplate_post_subcategories" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /security/labels/categories/{categoryTemplateId}/subcategories +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md) object. ++You can specify the following properties when creating a **subcategoryTemplate**. ++|Property|Type|Description| +|:|:|:| +|displayName|String| Unique string that defines a sub-category name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptor.md). Optional.| +++++## Response ++If successful, this method returns a `201 Created` response code and a [microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md) object in the response body. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_subcategorytemplate_from_" +} +--> +``` http +POST https://graph.microsoft.com/v1.0/security/labels/categories/{categoryTemplateId}/subcategories +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.security.subcategoryTemplate", + "displayName": "Vendor Invoice", +} +``` ++# [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 +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.security.subcategoryTemplate" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.security.subcategoryTemplate", + "id": "2ac39915-dbeb-e933-82e2-92b981835fa0", + "displayName": "Vendor Invoice", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-03-24T02:09:08Z" + } +``` + |
v1.0 | Security Citationtemplate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-citationtemplate-get.md | + + Title: "Get citationTemplate" +description: "Read the properties and relationships of a citationTemplate object." ++ms.localizationpriority: medium +++# Get citationTemplate +Namespace: microsoft.graph.security ++Read the properties and relationships of a [citationTemplate](../resources/security-citationtemplate.md) object. +++## 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": "security_citationtemplate_get" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/labels/citations/{citationTemplateId} +GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/citationTemplate +``` ++## 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.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) object in the response body. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_citationtemplate" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/security/labels/citations/c0475d01-d532-8a53-6e26-14ea58c640bf +``` ++# [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 +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.security.citationTemplate" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": { + "@odata.type": "#microsoft.graph.security.citationTemplate", + "id": "c0475d01-d532-8a53-6e26-14ea58c640bf", + "displayName": "Contoso Company Policy", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z", + "citationUrl": "www.citationUrl.com", + "citationJurisdiction": "Contoso" + } +} +``` + |
v1.0 | Security Departmenttemplate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-departmenttemplate-get.md | + + Title: "Get departmentTemplate" +description: "Read the properties and relationships of a departmentTemplate object." ++ms.localizationpriority: medium +++# Get departmentTemplate +Namespace: microsoft.graph.security ++Read the properties and relationships of a [departmentTemplate](../resources/security-departmenttemplate.md) object. +++## 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": "security_departmenttemplate_get" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/labels/departments/{departmentTemplateId} +GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/departmentTemplate +``` ++## 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.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) object in the response body. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_departmenttemplate" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/security/labels/departments/11b44677-9f06-c85a-4a0b-766b66904bf8 +``` ++# [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 +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.security.departmentTemplate" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": { + "@odata.type": "#microsoft.graph.security.departmentTemplate", + "id": "11b44677-9f06-c85a-4a0b-766b66904bf8", + "displayName": "Finance", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} +} +``` + |
v1.0 | Security Fileplanreferencetemplate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-fileplanreferencetemplate-get.md | + + Title: "Get filePlanReferenceTemplate" +description: "Read the properties and relationships of a filePlanReferenceTemplate object." ++ms.localizationpriority: medium +++# Get filePlanReferenceTemplate +Namespace: microsoft.graph.security ++Read the properties and relationships of a [filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) object. +++## 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": "security_fileplanreferencetemplate_get" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/labels/filePlanReferences/{filePlanReferenceTemplateId} +GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/filePlanReferenceTemplate +``` ++## 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.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) object in the response body. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_fileplanreferencetemplate" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/security/labels/filePlanReferences/b1f7b518-a44f-1d4b-c6f1-ab8771d3907c +``` ++# [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 +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.security.filePlanReferenceTemplate" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": { + "@odata.type": "#microsoft.graph.security.filePlanReferenceTemplate", + "id": "b1f7b518-a44f-1d4b-c6f1-ab8771d3907c", + "displayName": "String", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} +} +``` + |
v1.0 | Security Labelsroot Delete Authorities | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-delete-authorities.md | + + Title: "Delete authorityTemplate" +description: "Delete an authorityTemplate object." ++ms.localizationpriority: medium +++# Delete authorityTemplate +Namespace: microsoft.graph.security ++Delete a [authorityTemplate](../resources/security-authoritytemplate.md) object. ++## 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": "security_labelsroot_delete_authorities" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /security/labels/authorities/{authorityTemplateId}/$ref +DELETE /security/labels/retentionLabels/{retentionLabelId}/descriptors/authorityTemplate/$ref +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_authoritytemplate" +} +--> +``` http +DELETE https://graph.microsoft.com/v1.0/security/labels/authorities/6cf65e55-6baf-44ff-5dcc-08d8de97b1d5 +``` ++# [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 +Here's an example of the response. +> +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Security Labelsroot Delete Categories | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-delete-categories.md | + + Title: "Delete categoryTemplate" +description: "Delete a categoryTemplate object." ++ms.localizationpriority: medium +++# Delete categoryTemplate +Namespace: microsoft.graph.security ++Delete a [categoryTemplate](../resources/security-categorytemplate.md) object. ++## 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": "security_labelsroot_delete_categories" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /security/labels/categories/{categoryTemplateId}/$ref +DELETE /security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate/$ref +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_categorytemplate" +} +--> +``` http +DELETE https://graph.microsoft.com/v1.0/security/labels/categories/6cf65e55-6baf-44ff-5dcc-08d8de97b1d5 +``` ++# [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 +Here's an example of the response. +> +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Security Labelsroot Delete Citations | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-delete-citations.md | + + Title: "Delete citationTemplate" +description: "Delete a citationTemplate object." ++ms.localizationpriority: medium +++# Delete citationTemplate +Namespace: microsoft.graph.security ++Delete a [citationTemplate](../resources/security-citationtemplate.md) object. ++## 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": "security_labelsroot_delete_citations" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /security/labels/citations/{citationTemplateId}/$ref +DELETE /security/labels/retentionLabels/{retentionLabelId}/descriptors/citationTemplate/$ref +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_citationtemplate" +} +--> +``` http +DELETE https://graph.microsoft.com/v1.0/security/labels/citations/6cf65e55-6baf-44ff-5dcc-08d8de97b1d5 +``` ++# [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 +Here's an example of the response. +> +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Security Labelsroot Delete Departments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-delete-departments.md | + + Title: "Delete departmentTemplate" +description: "Delete a departmentTemplate object." ++ms.localizationpriority: medium +++# Delete departmentTemplate +Namespace: microsoft.graph.security ++Delete a [departmentTemplate](../resources/security-departmenttemplate.md) object. ++## 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": "security_labelsroot_delete_departments" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /security/labels/departments/{departmentTemplateId}/$ref +DELETE /security/labels/retentionLabels/{retentionLabelId}/descriptors/departmentTemplate/$ref +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_departmenttemplate" +} +--> +``` http +DELETE https://graph.microsoft.com/v1.0/security/labels/departments/6cf65e55-6baf-44ff-5dcc-08d8de97b1d5 +``` ++# [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 +Here's an example of the response. +> +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Security Labelsroot Delete Fileplanreferences | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-delete-fileplanreferences.md | + + Title: "Delete filePlanReferenceTemplate" +description: "Delete a filePlanReferenceTemplate object." ++ms.localizationpriority: medium +++# Delete filePlanReferenceTemplate +Namespace: microsoft.graph.security ++Delete a [filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) object. ++## 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": "security_labelsroot_delete_fileplanreferences" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /security/labels/filePlanReferences/{filePlanReferenceTemplateId}/$ref +DELETE /security/labels/retentionLabels/{retentionLabelId}/descriptors/filePlanReferenceTemplate/$ref +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_fileplanreferencetemplate" +} +--> +``` http +DELETE https://graph.microsoft.com/v1.0/security/labels/filePlanReferences/6cf65e55-6baf-44ff-5dcc-08d8de97b1d5 +``` ++# [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 +Here's an example of the response. +> +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Security Labelsroot List Authorities | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-list-authorities.md | + + Title: "List authorityTemplates" +description: "Get a list of the authorityTemplate objects and their properties." ++ms.localizationpriority: medium +++# List authorityTemplates +Namespace: microsoft.graph.security +++Get a list of the [authorityTemplate](../resources/security-authoritytemplate.md) objects and their properties. +++## 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": "security_labelsroot_list_authorities" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/labels/authorities +``` ++## 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.| ++## 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 [microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) objects in the response body. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "list_authoritytemplate" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/security/labels/authorities +``` ++# [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 +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.security.authorityTemplate)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "@odata.type": "#microsoft.graph.security.authorityTemplate", + "id": "a94af2e3-853b-6fcc-c898-d61d3a6d9efc", + "displayName": "Business", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-03-24T02:09:08Z" + }, + { + "@odata.type": "#microsoft.graph.security.authorityTemplate", + "id": "6cf65e55-6baf-44ff-5dcc-08d8de97b1d5", + "displayName": "Legal", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-03-24T02:09:08Z" + } + ] +} +``` |
v1.0 | Security Labelsroot List Categories | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-list-categories.md | + + Title: "List categoryTemplates" +description: "Get a list of the categoryTemplate objects and their properties." ++ms.localizationpriority: medium +++# List categoryTemplates +Namespace: microsoft.graph.security ++Get a list of the [categoryTemplate](../resources/security-categorytemplate.md) objects and their properties. +++## 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": "security_labelsroot_list_categories" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/labels/categories +``` ++## 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.| ++## 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 [microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) objects in the response body. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "list_categorytemplate" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/security/labels/categories +``` ++# [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 +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.security.categoryTemplate)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "@odata.type": "#microsoft.graph.security.categoryTemplate", + "id": "e2c79762-34a9-75ba-b6f0-a7c9a57978ef", + "displayName": "Accounts Payable", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-03-24T02:09:08Z" + }, + { + "@odata.type": "#microsoft.graph.security.categoryTemplate", + "id": "6cf65e55-6baf-44ff-5dcc-08d8de97b1d5", + "displayName": "Accounts", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-03-24T02:09:08Z" + } + ] +} +``` |
v1.0 | Security Labelsroot List Citations | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-list-citations.md | + + Title: "List citationTemplates" +description: "Get a list of the citationTemplate objects and their properties." ++ms.localizationpriority: medium +++# List citationTemplates +Namespace: microsoft.graph.security ++Get a list of the [citationTemplate](../resources/security-citationtemplate.md) objects and their properties. +++## 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": "security_labelsroot_list_citations" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/labels/citations +``` ++## 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.| ++## 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 [microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) objects in the response body. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "list_citationtemplate" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/security/labels/citations +``` ++# [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 +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.security.citationTemplate)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "@odata.type": "#microsoft.graph.security.citationTemplate", + "id": "c0475d01-d532-8a53-6e26-14ea58c640bf", + "displayName": "Contoso Company Policy", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-03-24T02:09:08Z", + "citationUrl": "www.citationUrl.com", + "citationJurisdiction": "Contoso" + } + ] +} +``` + |
v1.0 | Security Labelsroot List Departments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-list-departments.md | + + Title: "List departmentTemplates" +description: "Get a list of the departmentTemplate objects and their properties." ++ms.localizationpriority: medium +++# List departmentTemplates +Namespace: microsoft.graph.security ++Get a list of the [departmentTemplate](../resources/security-departmenttemplate.md) objects and their properties. +++## 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": "security_labelsroot_list_departments" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/labels/departments +``` ++## 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.| ++## 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 [microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) objects in the response body. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "list_departmenttemplate" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/security/labels/departments +``` ++# [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 +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.security.departmentTemplate)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "@odata.type": "#microsoft.graph.security.departmentTemplate", + "id": "11b44677-9f06-c85a-4a0b-766b66904bf8", + "displayName": "Finance", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-03-24T02:09:08Z" + } + ] +} +``` + |
v1.0 | Security Labelsroot List Fileplanreferences | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-list-fileplanreferences.md | + + Title: "List filePlanReferenceTemplates" +description: "Get a list of the filePlanReferenceTemplate objects and their properties." ++ms.localizationpriority: medium +++# List filePlanReferenceTemplates +Namespace: microsoft.graph.security ++Get a list of the [filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) objects and their properties. +++## 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": "security_labelsroot_list_fileplanreferences" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/labels/filePlanReferences +``` ++## 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.| ++## 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 [microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) objects in the response body. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "list_fileplanreferencetemplate" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/security/labels/filePlanReferences +``` ++# [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 +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.security.filePlanReferenceTemplate)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "@odata.type": "#microsoft.graph.security.filePlanReferenceTemplate", + "id": "b1f7b518-a44f-1d4b-c6f1-ab8771d3907c", + "displayName": "FIN 01-02-001", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-03-24T02:09:08Z" + } + ] +} +``` + |
v1.0 | Security Labelsroot List Retentionlabel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-list-retentionlabel.md | + + Title: "List retentionLabels" +description: "Get a list of the retentionLabel objects and their properties." ++ms.localizationpriority: medium +++# List retentionLabels +Namespace: microsoft.graph.security ++Get a list of the [retentionLabel](../resources/security-retentionlabel.md) objects and their properties. +++## 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": "security_labelsroot_list_retentionlabel" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/labels/retentionLabels +``` ++## Optional query parameters +This method supports the `expand` OData query parameter to help customize the response. ++For example: +- To retrieve the **retentionEventType** property, use `$expand=retentionEventType`. +- To retrieve the **descriptors** property, use `$expand=descriptors`. ++For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## 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 [microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md) objects in the response body. ++## Examples ++### Request +Here's an example of a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "list_retentionlabel" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/security/labels/retentionLabels +``` ++# [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 +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.security.retentionLabel)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "@odata.type": "#microsoft.graph.security.retentionLabel", + "id": "64a99fb4-07be-0481-8746-44c15c0eef1f", + "displayName": "Retention Schedule 10004", + "behaviorDuringRetentionPeriod": "retain", + "actionAfterRetentionPeriod": "relabel", + "retentionTrigger": "dateCreated", + "retentionDuration": { + "@odata.type": "microsoft.graph.security.retentionDurationInDays", + "days": "730" + }, + "isInUse": true, + "descriptionForAdmins": "creation based retention label for schedule 10004", + "descriptionForUsers": "retains for 2 years then relabeled", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2017-11-27T02:10:12Z", + "lastModifiedBy": { + "user": { + "id": "9563a605-e827-4324-a5a9-09efddff1e90", + "displayName": "Records Manager" + } + }, + "lastModifiedDateTime": "2020-08-28T22:13:09Z", + "labelToBeApplied": "Retention schedule 10005", + "defaultRecordBehavior": "startLocked" + } + ] +} +``` ++ |
v1.0 | Security Labelsroot Post Authorities | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-post-authorities.md | + + Title: "Create authorityTemplate" +description: "Create a new authorityTemplate object." ++ms.localizationpriority: medium +++# Create authorityTemplate +Namespace: microsoft.graph.security ++Create a new [authorityTemplate](../resources/security-authoritytemplate.md) object. +++## 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": "security_labelsroot_post_authorities" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /security/labels/authorities +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) object. ++You can specify the following properties when creating a **authorityTemplate**. ++|Property|Type|Description| +|:|:|:| +|displayName|String|Unique string that defines an authority name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptor.md).| +++++## Response ++If successful, this method returns a `201 Created` response code and a [microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) object in the response body. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_authoritytemplate_from_" +} +--> +``` http +POST https://graph.microsoft.com/v1.0/security/labels/authorities +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.security.authorityTemplate", + "displayName": "Business", +} +``` ++# [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 +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.security.authorityTemplate" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.security.authorityTemplate", + "id": "a94af2e3-853b-6fcc-c898-d61d3a6d9efc", + "displayName": "Business", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} +``` + |
v1.0 | Security Labelsroot Post Categories | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-post-categories.md | + + Title: "Create categoryTemplate" +description: "Create a new categoryTemplate object." ++ms.localizationpriority: medium +++# Create categoryTemplate +Namespace: microsoft.graph.security ++Create a new [categoryTemplate](../resources/security-categorytemplate.md) object. +++## 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": "security_labelsroot_post_categories" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /security/labels/categories +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) object. ++You can specify the following properties when creating a **categoryTemplate**. ++|Property|Type|Description| +|:|:|:| +|displayName|String|Unique string that defines a category name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptor.md).| +++++## Response ++If successful, this method returns a `201 Created` response code and a [microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) object in the response body. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_categorytemplate_from_" +} +--> +``` http +POST https://graph.microsoft.com/v1.0/security/labels/categories +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.security.categoryTemplate", + "displayName": "Accounts Payable", +} +``` ++# [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 +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.security.categoryTemplate" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.security.categoryTemplate", + "id": "e2c79762-34a9-75ba-b6f0-a7c9a57978ef", + "displayName": "Accounts Payable", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} +``` |
v1.0 | Security Labelsroot Post Citations | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-post-citations.md | + + Title: "Create citationTemplate" +description: "Create a new citationTemplate object." ++ms.localizationpriority: medium +++# Create citationTemplate +Namespace: microsoft.graph.security ++Create a new [citationTemplate](../resources/security-citationtemplate.md) object. +++## 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": "security_labelsroot_post_citations" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /security/labels/citations +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) object. ++You can specify the following properties when creating a **citationTemplate**. ++|Property|Type|Description| +|:|:|:| +|displayName|String|Unique string that defines a citation name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptor.md).| +|citationUrl|String|Represents the URL to the published citation. Optional.| +|citationJurisdiction|String|Represents the jurisdiction or agency that published the citation. Optional.| +++## Response ++If successful, this method returns a `201 Created` response code and a [microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) object in the response body. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_citationtemplate_from_" +} +--> +``` http +POST https://graph.microsoft.com/v1.0/security/labels/citations +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.security.citationTemplate", + "displayName": "Contoso Company Policy", + "citationUrl": "www.citationUrl.com", + "citationJurisdiction": "Contoso" +} +``` ++# [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 +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.security.citationTemplate" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.security.citationTemplate", + "id": "c0475d01-d532-8a53-6e26-14ea58c640bf", + "displayName": "Contoso Company Policy", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z", + "createdDateTime": "String (timestamp)", + "citationUrl": "www.citationUrl.com", + "citationJurisdiction": "String" +} +``` + |
v1.0 | Security Labelsroot Post Departments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-post-departments.md | + + Title: "Create departmentTemplate" +description: "Create a new departmentTemplate object." ++ms.localizationpriority: medium +++# Create departmentTemplate +Namespace: microsoft.graph.security ++Create a new [departmentTemplate](../resources/security-departmenttemplate.md) object. +++## 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": "security_labelsroot_post_departments" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /security/labels/departments +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) object. ++You can specify the following properties when creating a **departmentTemplate**. ++|Property|Type|Description| +|:|:|:| +|displayName|String|Unique string that defines a department name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptor.md).| +++++## Response ++If successful, this method returns a `201 Created` response code and a [microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) object in the response body. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_departmenttemplate_from_" +} +--> +``` http +POST https://graph.microsoft.com/v1.0/security/labels/departments +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.security.departmentTemplate", + "displayName": "Finance", +} +``` ++# [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 +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.security.departmentTemplate" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.security.departmentTemplate", + "id": "11b44677-9f06-c85a-4a0b-766b66904bf8", + "displayName": "Finance", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} +``` + |
v1.0 | Security Labelsroot Post Fileplanreferences | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-post-fileplanreferences.md | + + Title: "Create filePlanReferenceTemplate" +description: "Create a new filePlanReferenceTemplate object." ++ms.localizationpriority: medium +++# Create filePlanReferenceTemplate +Namespace: microsoft.graph.security ++Create a new [filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) object. +++## 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": "security_labelsroot_post_fileplanreferences" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /security/labels/filePlanReferences +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) object. ++You can specify the following properties when creating a **filePlanReferenceTemplate**. ++|Property|Type|Description| +|:|:|:| +|displayName|String|Unique string that defines a file plan reference name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptor.md).| +++++## Response ++If successful, this method returns a `201 Created` response code and a [microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) object in the response body. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_fileplanreferencetemplate_from_" +} +--> +``` http +POST https://graph.microsoft.com/v1.0/security/labels/filePlanReferences +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.security.filePlanReferenceTemplate", + "displayName": "FIN 01-02-001", +} +``` ++# [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 +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.security.filePlanReferenceTemplate" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.security.filePlanReferenceTemplate", + "id": "b1f7b518-a44f-1d4b-c6f1-ab8771d3907c", + "displayName": "FIN 01-02-001", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} +``` + |
v1.0 | Security Labelsroot Post Retentionlabel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-post-retentionlabel.md | + + Title: "Create retentionLabel" +description: "Create a new retentionLabel object." ++ms.localizationpriority: medium +++# Create retentionLabel +Namespace: microsoft.graph.security ++Create a new [retentionLabel](../resources/security-retentionlabel.md) object. ++To create a [disposition review stage](../resources/security-dispositionreviewstage.md), include the **actionAfterRetentionPeriod** property in the request body with one of the possible values specified. +++## 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": "security_labelsroot_post_retentionlabel" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /security/labels/retentionLabels +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [retentionLabel](../resources/security-retentionlabel.md) object. ++Specify the following properties when you create a **retentionLabel**. ++|Property|Type|Description| +|:|:|:| +|actionAfterRetentionPeriod|microsoft.graph.security.actionAfterRetentionPeriod| Specifies the action to take on a document with this label applied during the retention period. The possible values are: `none`, `delete`, `startDispositionReview`, `unknownFutureValue`. | +|behaviorDuringRetentionPeriod|microsoft.graph.security.behaviorDuringRetentionPeriod|Specifies how the behavior of a document with this label should be during the retention period. The possible values are: `doNotRetain`, `retain`, `retainAsRecord`, `retainAsRegulatoryRecord`, `unknownFutureValue`. | +|descriptionForAdmins|String|Provides label information for the admin. Optional. | +|descriptionForUsers|String|Provides the label information for the user. Optional. | +|displayName|String|Unique string that defines a label name. | +|dispositionReviewStages|[microsoft.graph.security.dispositionReviewStage](../resources/security-dispositionreviewstage.md) collection|Review stages during which reviewers are notified to determine whether a document must be deleted or retained. | +|retentionDuration|[microsoft.graph.security.retentionDuration](../resources/security-retentionduration.md)|Specifies the number of days to retain the content. | +|retentionTrigger|microsoft.graph.security.retentionTrigger|Specifies whether the retention duration is calculated from the content creation date, labeled date, or last modification date. The possible values are: `dateLabeled`, `dateCreated`, `dateModified`, `dateOfEvent`, `unknownFutureValue`. | +|defaultRecordBehavior|microsoft.graph.security.defaultRecordBehavior|Specifies the locked or unlocked state of a record label when it's created. The possible values are: `startLocked`, `startUnlocked`, `unknownFutureValue`. | +|labelToBeApplied|String|Specifies the replacement label to be applied automatically after the retention period of the current label ends. | ++++## Response ++If successful, this method returns a `201 Created` response code and a [microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md) object in the response body. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_retentionlabel_from_" +} +--> +``` http +POST https://graph.microsoft.com/v1.0/security/labels/retentionLabels +Content-Type: application/json +Content-length: 555 ++{ + "@odata.type": "#microsoft.graph.security.retentionLabel", + "displayName": "Retention Schedule 10005", + "behaviorDuringRetentionPeriod": "retain", + "actionAfterRetentionPeriod": "startDispositionReview", + "retentionTrigger": "dateOfEvent", + "retentionEventType@odata.bind": "https://graph.microsoft.com/beta/security/triggerTypes/retentionEventTypes('e095f4fc-b966-4c40-94de-fb8a383658e4')", + "retentionDuration": { + "@odata.type": "microsoft.graph.security.retentionDurationInDays", + "days": 2555 + }, + "dispositionReviewStages": [ + { + "stageNumber" : 1, + "name": "Stage1", + "reviewersEmailAddresses ": [ + "Admin@contoso.onmicrosoft.com" + ] + } + ], + "descriptionForAdmins": "retain for 7 years", + "descriptionForUsers": "retain for 7 years", + "descriptors": { + "authorityTemplate@odata.bind" : "https://graph.microsoft.com/beta/security/labels/authorities('fie3f4fc-b966-4c40-94de-fb8a383658e4')", + "categoryTemplate@odata.bind" : "https://graph.microsoft.com/beta/security/labels/categories('0bjk8-b966-4c40-94de-fb8a383658e4')", + "citationTemplate@odata.bind" : "https://graph.microsoft.com/beta/security/labels/citations('0e23f4fc-b966-4c40-94de-fb8a383658e4')", + "departmentTemplate@odata.bind" : "https://graph.microsoft.com/beta/security/labels/departments('p99ef4fc-b966-4c40-94de-fb8a383658e4')", + "filePlanReferenceTemplate@odata.bind" : "https://graph.microsoft.com/beta/security/labels/filePlanReferences('e095f4fc-b966-4c40-94de-fb8a383658e4')" + }, + "defaultRecordBehavior":"startLocked", +} +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++++### Response +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.security.retentionLabel" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.security.retentionLabel", + "id": "64a99fb4-07be-0481-8746-44c15c0eef1f", + "displayName": "Retention Schedule 10005", + "behaviorDuringRetentionPeriod": "retain", + "actionAfterRetentionPeriod": "startDispositionReview", + "retentionTrigger": "dateOfEvent", + "retentionDuration": { + "@odata.type": "microsoft.graph.security.retentionDurationInDays", + "days": 2555 + }, + "dispositionReviewStages": [ + { + "stageNumber" : 1, + "name": "Stage1", + "reviewersEmailAddresses ": [ + "Admin@contoso.onmicrosoft.com" + ] + } + ], + "isInUse": true, + "descriptionForAdmins": "retain for 7 years", + "descriptionForUsers": "retain for 7 years", + "defaultRecordBehavior":"startLocked", + "createdBy": { + "user": { + "id": "9563a605-e827-4324-a5a9-09efddff1e90", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-08-23T16:43:55Z", + "labelToBeApplied": " ", + "defaultRecordBehavior": "startLocked", + "descriptors": { + "authority": { + "displayName": "Business" + }, + "category": { + "displayName": "Accounts Payable", + }, + "citation": { + "displayName" : "Contoso Company Policy", + "citationUrl": "www.citationUrl.com", + "citationJurisdiction": "Contoso" + }, + "department": { + "displayName" : "Finance" + }, + "filePlanReference": { + "displayName" : "FIN 01-02-001" + } + } +} +``` + |
v1.0 | Security Retentionlabel Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-retentionlabel-delete.md | + + Title: "Delete retentionLabel" +description: "Deletes a retentionLabel object." ++ms.localizationpriority: medium +++# Delete retentionLabel +Namespace: microsoft.graph.security ++Delete a [retentionLabel](../resources/security-retentionlabel.md) object. +++## 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": "security_retentionlabel_delete" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /security/labels/retentionLabels/{retentionLabelId} ++``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_retentionlabel" +} +--> +``` http +DELETE https://graph.microsoft.com/v1.0/security/labels/retentionLabels/9563a605-e827-4324-a5a9-09efddff1e50 +``` ++# [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 +Here's an example of the response. +> +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Security Retentionlabel Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-retentionlabel-get.md | + + Title: "Get retentionLabel" +description: "Read the properties and relationships of a retentionLabel object." ++ms.localizationpriority: medium +++# Get retentionLabel +Namespace: microsoft.graph.security ++Read the properties and relationships of a [retentionLabel](../resources/security-retentionlabel.md) object. +++## 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": "security_retentionlabel_get" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/labels/retentionLabels/{retentionLabelId} +GET /security/triggers/retentionEvents/{retentionEventId}/labels/{retentionLabelId} +``` ++## Optional query parameters +This method supports the expand OData query parameters to help customize the response. For example, to retrieve the **retentionEventType** property, you can use the `expand` parameter:`$expand=retentionEventType` or `$expand=descriptors`. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md) object in the response body. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_retentionlabel" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/security/labels/retentionLabels/{retentionLabelId} +``` ++# [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 +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.security.retentionLabel" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": { + "@odata.type": "#microsoft.graph.security.retentionLabel", + "id": "64a99fb4-07be-0481-8746-44c15c0eef1f", + "displayName": "Retention Schedule 10004", + "behaviorDuringRetentionPeriod": "retain", + "actionAfterRetentionPeriod": "relabel", + "retentionTrigger": "dateCreated", + "retentionDuration": { + "@odata.type": "microsoft.graph.security.retentionDurationInDays", + "days": 730 + }, + "isInUse": true, + "descriptionForAdmins": "creation based retention label for schedule 10004", + "descriptionForUsers": "retains for 2 years then relabeled", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2017-11-27T02:10:12Z", + "lastModifiedBy": { + "user": { + "id": "9563a605-e827-4324-a5a9-09efddff1e90", + "displayName": "Records Manager" + } + }, + "lastModifiedDateTime": "2020-08-28T22:13:09Z", + "labelToBeApplied": "Retention schedule 10005", + "defaultRecordBehavior": "startLocked" + } +} +``` + |
v1.0 | Security Retentionlabel Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-retentionlabel-update.md | + + Title: "Update retentionLabel" +description: "Update the properties of a retentionLabel object." ++ms.localizationpriority: medium +++# Update retentionLabel +Namespace: microsoft.graph.security ++Update the properties of a [retentionLabel](../resources/security-retentionlabel.md) object. ++To update a [disposition review stage](../resources/security-dispositionreviewstage.md), include the **actionAfterRetentionPeriod** property in the request body with one of the possible values specified. +++## 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": "security_retentionlabel_update" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /security/labels/retentionLabels/{retentionLabelId} ++``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +++|Property|Type|Description| +|:|:|:| +|descriptionForAdmins|String|This is an optional property that provides the label information for the admin.| +|descriptionForUsers|String|This is an optional property that provides the label information for the user.| +|dispositionReviewStages|[microsoft.graph.security.dispositionReviewStage](../resources/security-dispositionreviewstage.md) collection|Review stages during which reviewers are notified to determine whether a document must be deleted or retained.| +|retentionDuration|[microsoft.graph.security.retentionDuration](../resources/security-retentionduration.md)|Specifies the number of days to retain the content.| +|defaultRecordBehavior|microsoft.graph.security.defaultRecordBehavior|Specifies the locked or unlocked state of a record label when it is created. The possible values are: `startLocked`, `startUnlocked`, `unknownFutureValue`.| +|labelToBeApplied|String|Specifies the replacement label to be applied automatically after the retention period of the current label ends. | ++++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_retentionlabel" +} +--> +``` http +PATCH https://graph.microsoft.com/beta/security/labels/retentionLabels/9563a605-e827-4324-a5a9-09efddff1e50 +Content-Type: application/json +Content-length: 555 ++{ + "@odata.type": "#microsoft.graph.security.retentionLabel", + "retentionDuration": { + "@odata.type": "microsoft.graph.security.retentionDurationInDays", + "days": 2555 + }, +} +``` ++# [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 +Here's an example of the response. ++<!-- { + "blockType": "response" +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Security Subcategorytemplate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-subcategorytemplate-get.md | + + Title: "Get subcategoryTemplate" +description: "Read the properties and relationships of a subcategoryTemplate object." ++ms.localizationpriority: medium +++# Get subcategoryTemplate +Namespace: microsoft.graph.security ++Read the properties and relationships of a [subcategoryTemplate](../resources/security-subcategorytemplate.md) object. +++## 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": "security_subcategorytemplate_get" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /security/labels/categories/{categoryTemplateId}/subcategories/{subcategoryTemplateId} +``` ++## 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.| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md) object in the response body. ++## Examples ++### Request +Here's an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_subcategorytemplate" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/security/labels/categories/82d00422-1f60-46cd-9809-33ca0b4d2286/subcategories/2ac39915-dbeb-e933-82e2-92b981835fa0 +``` ++# [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 +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.security.subcategoryTemplate" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": { + "@odata.type": "#microsoft.graph.security.subcategoryTemplate", + "id": "2ac39915-dbeb-e933-82e2-92b981835fa0", + "displayName": "Vendor Invoice", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} +} +``` + |
v1.0 | Serviceprincipal Post Approleassignedto | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/serviceprincipal-post-approleassignedto.md | To grant an app role assignment, you need three identifiers: ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->-|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | AppRoleAssignment.ReadWrite.All and Application.Read.All, AppRoleAssignment.ReadWrite.All and Directory.Read.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | AppRoleAssignment.ReadWrite.All and Application.Read.All, AppRoleAssignment.ReadWrite.All and Directory.Read.All | [!INCLUDE [rbac-approleassignments-apis-write](../includes/rbac-for-apis/rbac-approleassignments-apis-write.md)] |
v1.0 | Serviceprincipal Post Serviceprincipals | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/serviceprincipal-post-serviceprincipals.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "serviceprincipal_post_serviceprincipals" } --> [!INCLUDE [permissions-table](../includes/permissions/serviceprincipal-post-serviceprincipals-permissions.md)] -For multi-tenant apps, the calling user must also be in one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): +For multi-tenant apps, the calling user must also be in at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): -+ Global Administrator + Application Administrator + Cloud Application Administrator roles |
v1.0 | Serviceprincipal Upsert | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/serviceprincipal-upsert.md | + + Title: "Upsert servicePrincipal" +description: "Create a new servicePrincipal object if it doesn't exist, or update the properties of an existing servicePrincipal object." ++ms.localizationpriority: medium ++++# Upsert servicePrincipal ++Namespace: microsoft.graph ++Create a new [servicePrincipal](../resources/serviceprincipal.md) object if it doesn't exist, or update the properties of an existing [servicePrincipal](../resources/serviceprincipal.md) object. ++> [!IMPORTANT] +> Adding [**passwordCredential**](../resources/passwordcredential.md) when creating servicePrincipals is not supported. Use the [addPassword](serviceprincipal-addpassword.md) method to add passwords or secrets for a servicePrincipal. +++## 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": "serviceprincipal_upsert" } --> ++For multitenant apps, the calling user must also be in one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): +++ Global Administrator++ Application Administrator++ Cloud Application Administrator roles++For single-tenant apps where the calling user is a nonadmin user but is the owner of the backing application, the user must have the *Application Developer* role. ++## HTTP request +<!-- { "blockType": "ignored" } --> +```http +PATCH /servicePrincipals(appId='appId') +``` ++## Request headers +| Name | Description| +|:--|:-| +| Authorization | Bearer {token}. Required. | +| Content-Type | application/json. Required. | +| Prefer | `create-if-missing`. Required for upsert behavior, otherwise the request is treated as an update operation. | ++## Request body ++In the request body, supply a JSON representation of a [servicePrincipal](../resources/serviceprincipal.md) object. ++## Response ++If successful, if a servicePrincipal with **appId** doesn't exist, this method returns a `201 Created` response code and a new [servicePrincipal](../resources/servicePrincipal.md) object in the response body. ++If a servicePrincipal with **appId** already exists, this method updates the [servicePrincipal](../resources/servicePrincipal.md) object and returns a `204 No Content` response code. ++## Examples ++### Example 1: Create a new servicePrincipal if it doesn't exist ++The following example creates a servicePrincipal because a servicePrincipal with the specified **appId** value doesn't exist. ++#### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "upsert_create_serviceprincipal" +}--> +```http +PATCH https://graph.microsoft.com/v1.0/servicePrincipals(appId='65415bb1-9267-4313-bbf5-ae259732ee12') +Content-type: application/json +Prefer: create-if-missing ++{ + "displayName": "My app instance" +} +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) ++++#### 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.servicePrincipal" +} --> +```http +HTTP/1.1 201 Created +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#servicePrincipals/$entity", + "id": "59e617e5-e447-4adc-8b88-00af644d7c92", + "deletedDateTime": null, + "accountEnabled": true, + "appDisplayName": "My App", + "appId": "65415bb1-9267-4313-bbf5-ae259732ee12", + "applicationTemplateId": null, + "appOwnerOrganizationId": "1bc1c026-2f7b-48a5-98da-afa2fd8bc7bc", + "appRoleAssignmentRequired": false, + "displayName": "My app instance", + "errorUrl": null, + "homepage": null, + "loginUrl": null, + "logoutUrl": null, + "notificationEmailAddresses": [], + "preferredSingleSignOnMode": null, + "preferredTokenSigningKeyEndDateTime": null, + "preferredTokenSigningKeyThumbprint": null, + "publisherName": "Contoso", + "replyUrls": [], + "samlMetadataUrl": null, + "samlSingleSignOnSettings": null, + "servicePrincipalNames": [ + "f1bd758f-4a1a-4b71-aa20-a248a22a8928" + ], + "signInAudience": "AzureADandPersonalMicrosoftAccount", + "tags": [], + "addIns": [], + "api": { + "resourceSpecificApplicationPermissions": [] + }, + "appRoles": [], + "info": { + "termsOfServiceUrl": null, + "supportUrl": null, + "privacyStatementUrl": null, + "marketingUrl": null, + "logoUrl": null + }, + "keyCredentials": [], + "publishedPermissionScopes": [], + "passwordCredentials": [] +} +``` ++### Example 2: Update an existing servicePrincipal ++The following example updates the servicePrincipal because a servicePrincipal with the specified **appId** value exists. ++#### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "upsert_update_serviceprincipal" +} +--> ++```http +PATCH https://graph.microsoft.com/v1.0/servicePrincipals(appId='65415bb1-9267-4313-bbf5-ae259732ee12') +Content-type: application/json +Prefer: create-if-missing ++{ + "displayName": "My app instance" +} +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) ++++#### Response ++The following example shows the response. +<!-- { + "blockType": "response" +} +--> ++``` http +HTTP/1.1 204 No Content +``` ++<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 +2015-10-25 14:57:30 UTC --> +<!-- +{ + "type": "#page.annotation", + "description": "Create serviceprincipal", + "keywords": "", + "section": "documentation", + "tocPath": "", + "suppressions": [ + ] +} +--> |
v1.0 | Signin Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/signin-get.md | One of the following permissions is required to call this API. To learn more, in Apps must be [properly registered](/azure/active-directory/active-directory-reporting-api-prerequisites-azure-portal) to Microsoft Entra ID. -In addition to the delegated permissions, the signed-in user needs to belong to one of the following directory roles that allow them to read sign-in reports. To learn more about directory roles, see [Microsoft Entra built-in roles](/entra/identity/role-based-access-control/permissions-reference): -+ Global Administrator +In addition to the delegated permissions, the signed-in user needs to belong to at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference): + + Global Reader + Reports Reader + Security Administrator |
v1.0 | Signin List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/signin-list.md | One of the following permissions is required to call this API. To learn more, in Apps must be [properly registered](/azure/active-directory/active-directory-reporting-api-prerequisites-azure-portal) to Microsoft Entra ID. -In addition to the delegated permissions, the signed-in user needs to belong to one of the following directory roles that allow them to read sign-in reports. To learn more about directory roles, see [Microsoft Entra built-in roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): -+ Global Administrator +In addition to the delegated permissions, the signed-in user needs to belong to at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): + + Global Reader + Reports Reader + Security Administrator |
v1.0 | Site Delta | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/site-delta.md | Your application should continue making calls using the **@odata.nextLink** unti After you receive all the changes, you can apply them to your local state. To monitor future changes, call the **delta** API by using the **@odata.deltaLink** in the previous response. -Deleted sites are returned with the @removed annotation with the reason for removal. Any resources marked as deleted should be removed from your local state. +Any resources marked as deleted should be removed from your local state. + ## Permissions The following example shows the initial request and how to call this API to esta The following example shows the initial request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_sites_delta_first", "tags": "service.graph" } --> -```http +```msgraph-interactive GET https://graph.microsoft.com/v1.0/sites/delta ``` +# [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 that includes the first page of changes and the **@odata.nextLink** property that indicates that no more sites are available in the current set of sites. Your app should continue to request the URL value of **@odata.nextLink** until all pages of sites are retrieved. The following example shows a request that accesses the last page in a set and h The following example shows a request after the initial request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get-sites-delta-last", "tags": "service.graph" }--> -```http +```msgraph-interactive GET https://graph.microsoft.com/v1.0/sites/delta?token=1230919asd190410jlka ``` +# [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 that indicates that the site named `All Company` was deleted between the initial request and this request to update the local state. Content-type: application/json "displayName": "All Company", "isPersonalSite": false, "id": "bd565af7-7963-4658-9a77-26e11ac73186",- "@removed": { - "reason": "deleted" - }, "root": {} } ] To retrieve the latest `deltaLink`, call `delta` with the query string parameter The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get-sites-delta-latest", "scopes": "sites.read", "tags": "service.graph", "target": "action" } --> -```http +```msgraph-interactive GET https://graph.microsoft.com/v1.0/sites/delta?token=latest ``` +# [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. |
v1.0 | Site Follow | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/site-follow.md | Namespace: microsoft.graph Follow a user's [site](../resources/site.md) or multiple sites. + ## 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). Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/follow-site-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/follow-site-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Site Unfollow | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/site-unfollow.md | Namespace: microsoft.graph Unfollow a user's [site](../resources/site.md) or multiple sites. + ## 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). Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/unfollow-site-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/unfollow-site-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Sitepage Create Webpart | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/sitepage-create-webpart.md | + + Title: 'Create webPart' +description: 'Create a new webPart at a specified position in the sitePage' ++ms.localizationpriority: medium +++# Create webPart ++Namespace: microsoft.graph ++Create a new [webPart] at a specified position in the [sitePage]. ++[sitePage]: ../resources/sitepage.md +[webPart]: ../resources/webPart.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": "sitepage_create_webpart" } --> ++## HTTP request ++<!-- { "blockType": "ignored" } --> ++```http +POST /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/verticalSection/webparts +POST /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/horizontalSections/{horizontal-section-id}/columns/{horizontal-section-column-id}/webparts +``` ++## Optional query parameters ++| Name | Description | +| :- | :-- | +| index | The position at which the web part should be inserted in the collection of web parts | ++## 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 [textWebPart](../resources/textWebPart.md) or [standardWebPart](../resources/standardWebPart.md). ++To ensure successful parsing of the request body, the `@odata.type=#microsoft.graph.textwebpart` or `@odata.type=#microsoft.graph.standardwebpart` must be included in the request body. ++### Supported web parts ++There are two kinds of web parts that can be added to a [sitePage](../resources/sitepage.md): [standardWebPart](../resources/standardWebPart.md) and [textWebPart](../resources/textWebPart.md). ++For [standardWebPart](../resources/standardWebPart.md), only the following are supported when updating using the Microsoft Graph API. Attempting to add unsupported web parts will result in a failure or exception. ++| # | Web Part | Type | +| | -- | -- | +| 1 | Bing Maps | `e377ea37-9047-43b9-8cdb-a761be2f8e09` | +| 2 | Button | `0f087d7f-520e-42b7-89c0-496aaf979d58` | +| 3 | Call To Action | `df8e44e7-edd5-46d5-90da-aca1539313b8` | +| 4 | Divider | `2161a1c6-db61-4731-b97c-3cdb303f7cbb` | +| 5 | Document Embed | `b7dd04e1-19ce-4b24-9132-b60a1c2b910d` | +| 6 | Image | `d1d91016-032f-456d-98a4-721247c305e8` | +| 7 | Image Gallery | `af8be689-990e-492a-81f7-ba3e4cd3ed9c` | +| 8 | Link Preview | `6410b3b6-d440-4663-8744-378976dc041e` | +| 9 | Org Chart | `e84a8ca2-f63c-4fb9-bc0b-d8eef5ccb22b` | +| 10 | People | `7f718435-ee4d-431c-bdbf-9c4ff326f46e` | +| 11 | Quick Links | `c70391ea-0b10-4ee9-b2b4-006d3fcad0cd` | +| 12 | Spacer | `8654b779-4886-46d4-8ffb-b5ed960ee986` | +| 13 | Youtube Embed | `544dd15b-cf3c-441b-96da-004d5a8cea1d` | ++## Response ++If successful, this method returns a `201` and the created [webPart](../resources/webPart.md) object in the response body. ++## Example ++### Request ++The following example shows how to create a new webpart. ++<!-- { "blockType": "ignored" } --> ++```http +POST /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202//microsoft.graph.sitePage/canvasLayout/verticalSection/webparts +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.textWebPart", + "innerHtml": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus blandit pellentesque ipsum tempor porta. Phasellus tincidunt et ipsum nec iaculis. Sed eu arcu tristique, congue erat a, consequat lorem. Suspendisse ac ullamcorper elit. Sed ultricies, risus sed hendrerit dictum, nunc massa ornare velit, a pharetra dolor urna quis lorem. Maecenas eget pellentesque purus, nec ultricies risus. Donec rhoncus lorem at euismod varius. Donec auctor sed mi vitae pharetra. Aenean id tempor mauris. Donec dui nulla, semper ut elit id, mattis commodo arcu. Aliquam erat volutpat." +} +``` ++++### Response ++If successful, this method returns a [webPart][] in the response body for the created webPart. ++<!-- { "blockType": "response", "@odata.type": "microsoft.graph.webPart", "truncated": true } --> ++```http +HTTP/1.1 201 Created +Content-type: application/json ++{ + "@odata.type": "#microsoft.graph.textWebPart", + "id": "51053496-e6f3-4161-94ac-07bdf4d92226", + "innerHtml": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus blandit pellentesque ipsum tempor porta. Phasellus tincidunt et ipsum nec iaculis. Sed eu arcu tristique, congue erat a, consequat lorem. Suspendisse ac ullamcorper elit. Sed ultricies, risus sed hendrerit dictum, nunc massa ornare velit, a pharetra dolor urna quis lorem. Maecenas eget pellentesque purus, nec ultricies risus. Donec rhoncus lorem at euismod varius. Donec auctor sed mi vitae pharetra. Aenean id tempor mauris. Donec dui nulla, semper ut elit id, mattis commodo arcu. Aliquam erat volutpat." +} +``` ++[webPart]: ../resources/webPart.md ++<!-- +{ + "type": "#webpart.annotation", + "description": "Create a WebPart.", + "keywords": "", + "section": "documentation", + "tocPath": "WebParts/Create", + "suppressions": [] +} +--> |
v1.0 | Sitepage Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/sitepage-create.md | ++ +description: "Create a new sitePage in the site pages list in a site." Last updated : 05/07/2018+ Title: Create a new page in a SharePoint site +ms.localizationpriority: medium +++# Create a page in the site pages list of a site ++Namespace: microsoft.graph ++Create a new [sitePage][] in the site pages [list][] in a [site][]. ++[sitePage]: ../resources/sitepage.md +[list]: ../resources/list.md +[site]: ../resources/site.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": "sitepage_create" } --> ++## HTTP request ++<!-- { "blockType": "ignored" } --> ++```http +POST /sites/{site-id}/pages +``` +## 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 [sitePage](../resources/sitepage.md) resource to create. ++> **Notes:** : +> 1. To ensure successful parsing of the request body, the `@odata.type=#microsoft.graph.sitePage` must be included in the request body. +> 2. If you're using the response from the [Get sitepage](../api/sitepage-get.md) operation to create a **sitePage**, we recommend that you add the HTTP header `Accept: application/json;odata.metadata=none`. This will remove all OData metadata from the response. You can also manually remove all OData metadata. +> 3. Only the web part listed in the [Supported web parts](#supported-web-parts) section are supported when creating a [sitePage](../resources/sitepage.md) using the Microsoft Graph API. Attempting to add unsupported web parts will result in a failure or exception. ++### Supported web parts ++There are two kinds of web parts that can be added to a [sitePage](../resources/sitepage.md): [standardWebParts](../resources/standardwebpart.md) and [textWebPart](../resources/textwebpart.md). The following table lists the supported web parts for standard web parts. ++| # | Web Part | Type | +| | -- | -- | +| 1 | Bing Maps | `e377ea37-9047-43b9-8cdb-a761be2f8e09` | +| 2 | Button | `0f087d7f-520e-42b7-89c0-496aaf979d58` | +| 3 | Call To Action | `df8e44e7-edd5-46d5-90da-aca1539313b8` | +| 4 | Divider | `2161a1c6-db61-4731-b97c-3cdb303f7cbb` | +| 5 | Document Embed | `b7dd04e1-19ce-4b24-9132-b60a1c2b910d` | +| 6 | Image | `d1d91016-032f-456d-98a4-721247c305e8` | +| 7 | Image Gallery | `af8be689-990e-492a-81f7-ba3e4cd3ed9c` | +| 8 | Link Preview | `6410b3b6-d440-4663-8744-378976dc041e` | +| 9 | Org Chart | `e84a8ca2-f63c-4fb9-bc0b-d8eef5ccb22b` | +| 10 | People | `7f718435-ee4d-431c-bdbf-9c4ff326f46e` | +| 11 | Quick Links | `c70391ea-0b10-4ee9-b2b4-006d3fcad0cd` | +| 12 | Spacer | `8654b779-4886-46d4-8ffb-b5ed960ee986` | +| 13 | Youtube Embed | `544dd15b-cf3c-441b-96da-004d5a8cea1d` | ++## Response ++If successful, this method returns a `201` and the created [sitePage](../resources/basesitepage.md) object. ++## Example ++The following example shows how to create a new page. ++### Request ++# [HTTP](#tab/http) +<!-- { "blockType": "request", "name": "create-page", "scopes": "sites.readwrite.all" } --> ++```http +POST /sites/{site-id}/pages +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.sitePage", + "name": "test.aspx", + "title": "test", + "pageLayout": "article", + "showComments": true, + "showRecommendedPages": false, + "titleArea": { + "enableGradientEffect": true, + "imageWebUrl": "https://cdn.hubblecontent.osi.office.net/m365content/publish/005292d6-9dcc-4fc5-b50b-b2d0383a411b/image.jpg", + "layout": "colorBlock", + "showAuthor": true, + "showPublishedDate": false, + "showTextBlockAboveTitle": false, + "textAboveTitle": "TEXT ABOVE TITLE", + "textAlignment": "left", + "imageSourceType": 2, + "title": "sample1" + }, + "canvasLayout": { + "horizontalSections": [ + { + "layout": "oneThirdRightColumn", + "id": "1", + "emphasis": "none", + "columns": [ + { + "id": "1", + "width": 8, + "webparts": [ + { + "id": "6f9230af-2a98-4952-b205-9ede4f9ef548", + "innerHtml": "<p><b>Hello!</b></p>" + } + ] + }, + { + "id": "2", + "width": 4, + "webparts": [ + { + "id": "73d07dde-3474-4545-badb-f28ba239e0e1", + "webPartType": "d1d91016-032f-456d-98a4-721247c305e8", + "data": { + "dataVersion": "1.9", + "description": "Show an image on your page", + "title": "Image", + "properties": { + "imageSourceType": 2, + "altText": "", + "overlayText": "", + "siteid": "0264cabe-6b92-450a-b162-b0c3d54fe5e8", + "webid": "f3989670-cd37-4514-8ccb-0f7c2cbe5314", + "listid": "bdb41041-eb06-474e-ac29-87093386bb14", + "uniqueid": "d9f94b40-78ba-48d0-a39f-3cb23c2fe7eb", + "imgWidth": 4288, + "imgHeight": 2848, + "fixAspectRatio": false, + "captionText": "", + "alignment": "Center" + }, + "serverProcessedContent": { + "imageSources": [ + { + "key": "imageSource", + "value": "/_LAYOUTS/IMAGES/VISUALTEMPLATEIMAGE1.JPG" + } + ], + "customMetadata": [ + { + "key": "imageSource", + "value": { + "siteid": "0264cabe-6b92-450a-b162-b0c3d54fe5e8", + "webid": "f3989670-cd37-4514-8ccb-0f7c2cbe5314", + "listid": "bdb41041-eb06-474e-ac29-87093386bb14", + "uniqueid": "d9f94b40-78ba-48d0-a39f-3cb23c2fe7eb", + "width": "4288", + "height": "2848" + } + } + ] + } + } + } + ] + } + ] + } + ] + } +} +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) ++++++### Response ++If successful, this method returns a [sitePage][] in the response body for the created page. ++<!-- { "blockType": "response", "@odata.type": "microsoft.graph.sitePage", "truncated": true } --> ++```http +HTTP/1.1 201 Created +Content-type: application/json ++{ + "@odata.type": "microsoft.graph.sitePage", + "id": "0dd6ddd6-45bd-4acd-b683-de0e6e7231b7", + "name": "test.aspx", + "webUrl": "https://contoso.sharepoint.com/SitePages/test.aspx", + "title": "test", + "pageLayout": "article", + "showComments": true, + "showRecommendedPages": false, + "createdBy": { + "user": { + "displayName": "Rahul Mittal", + "email": "rahmit@contoso.com" + } + }, + "lastModifiedBy": { + "user": { + "displayName": "Rahul Mittal", + "email": "rahmit@contoso.com" + } + }, + "publishingState": { + "level": "checkout", + "versionId": "0.1", + "checkedOutBy": { + "user": { + "displayName": "Rahul Mittal", + "email": "rahmit@contoso.com" + } + } + }, + "titleArea": { + "enableGradientEffect": true, + "imageWebUrl": "https://cdn.hubblecontent.osi.office.net/m365content/publish/005292d6-9dcc-4fc5-b50b-b2d0383a411b/image.jpg", + "layout": "colorBlock", + "showAuthor": true, + "showPublishedDate": false, + "showTextBlockAboveTitle": false, + "textAboveTitle": "TEXT ABOVE TITLE", + "textAlignment": "left", + "title": "sample4", + "imageSourceType": 2 + } +} +``` ++**Note:** The response object is truncated for clarity. Default properties will be returned from the actual call. ++[list]: ../resources/list.md +[listitem]: ../resources/listitem.md +[site]: ../resources/site.md +[sitePage]: ../resources/sitepage.md ++<!-- +{ + "type": "#page.annotation", + "description": "Create a sitePage in the SitePages list in a site.", + "keywords": "", + "section": "documentation", + "tocPath": "Pages/Create", + "suppressions": [] +} +--> |
v1.0 | Sitepage Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/sitepage-get.md | ++ +description: "Returns the metadata for a sitePage in the site pages list in a site." Last updated : 03/15/2018+ Title: Get sitePage +ms.localizationpriority: medium +++# Get SitePage ++Namespace: microsoft.graph ++Returns the metadata for a [sitePage][] in the site pages [list][] in a [site][]. ++[sitePage]: ../resources/sitepage.md +[list]: ../resources/list.md +[site]: ../resources/site.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": "sitepage_get" } --> +++## HTTP request ++<!-- { "blockType": "ignored" } --> ++```http +GET /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage +``` ++## Optional query parameters ++This method supports the `$select` and `$expand` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++You can use the `$expand=canvasLayout` query string parameter to include the content of an item when retrieving the metadata of an item if the item has a **=canvasLayout** relationship. +++## Request headers ++| Name | Description | +|:|:--| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +| Content-Type | application/json. Required. | +| Accept |application/json;odata.metadata=none. Optional. Removes all OData metadata from the response. We recommend including this header when the response will be used in another request. | ++## Request body ++Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200` and a [sitePage](../resources/sitepage.md) object in the response body. +++## Examples ++### Example 1: Get a page in the site pages list of a site +#### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { "blockType": "request", "name": "get-page", "scopes": "sites.read.all", "tags": "service.sharepoint" } --> ++```msgraph-interactive +GET /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage +``` ++# [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. ++<!-- { "blockType": "response", "@odata.type": "microsoft.graph.sitePage", "truncated": true } --> ++```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "@odata.type": "microsoft.graph.sitePage", + "description": "Here's the page description", + "id": "65e59907-59d5-44ff-a038-7c0bf3098c01", + "name": "Home.aspx", + "webUrl": "https://contoso.sharepoint.com/SitePages/Home.aspx", + "title": "Organization Home", + "thumbnailWebUrl": "https://cdn.hubblecontent.osi.office.net/m365content/publish/00210d24-bba0-42e6-9a31-1d452a95dd75/thumbnails/large.jpg?file=163352059.jpg", + "promotionKind": "page", + "pageLayout": "home", + "showComments": true, + "showRecommendedPages": false, + "createdBy": { + "user": { + "displayName": "Rahul Mittal", + "email": "rahmit@contoso.com" + } + }, + "lastModifiedBy": { + "user": { + "displayName": "Rahul Mittal", + "email": "rahmit@contoso.com" + } + }, + "publishingState": { + "level": "published", + "versionId": "1.0" + }, + "reactions": { + "commentCount": 1 + } +} +``` ++### Example 2: Get a page using select and expand ++#### Request ++With `$select` and `$expand` statements, you can retrieve sitePage metadata and page content in a single request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_sitePage" +} +--> ++```msgraph-interactive +GET /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage?$select=id,name +``` ++# [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. ++<!-- { "blockType": "response", "@odata.type": "microsoft.graph.sitePage", "truncated": true } --> ++```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "@odata.etag": "\"{F45354CB-D634-45DF-8B88-2B4E96A1DC45},8\"", + "id": "f45354cb-d634-45df-8b88-2b4e96a1dc45", + "name": "Electronic Convertible.aspx" +} +``` ++### Example 3: Get a page with page content ++#### Request ++You can expand references in your URL with the _$expand_ query parameter. To access the page with page content, append the `?$expand=canvasLayout` query string. ++```http +GET /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage?$expand=canvasLayout +``` ++#### Response ++The following example shows the response. +```json +{ + "description": "Reiciendis placeat dolores.", + "eTag": "\"{F45354CB-D634-45DF-8B88-2B4E96A1DC45},8\"", + "id": "f45354cb-d634-45df-8b88-2b4e96a1dc45", + "lastModifiedDateTime": "2023-04-16T10:01:41Z", + "name": "autotest Electronic Convertible.aspx", + "webUrl": "https://contoso.sharepoint.com/SitePages/autotest Electronic Convertible.aspx", + "title": "autotest Electronic Convertible", + "pageLayout": "article", + "thumbnailWebUrl": "https://media.akamai.odsp.cdn.office.net/sitepagethumbnail.png", + "promotionKind": "page", + "showComments": false, + "showRecommendedPages": true, + "createdBy": { + "user": { + "displayName": "Rahul Mittal", + "email": "rahmit@contoso.com" + } + }, + "lastModifiedBy": { + "user": { + "displayName": "Rahul Mittal", + "email": "rahmit@contoso.com" + } + }, + "parentReference": { + "listId": "468fc883-e278-4773-ba09-91351a1e42ed", + "siteId": "45bb2a3b-0a4e-46f4-8c68-749c3fea75d3" + }, + "contentType": { + "id": "0x0101009D1CB255DA76424F860D91F20E6C4118009E6554A5E299E84FB2E07731DD6C6D4A", + "name": "Site Page" + }, + "publishingState": { + "level": "draft", + "versionId": "0.4" + }, + "reactions": {}, + "canvasLayout": { + "horizontalSections": [ + { + "layout": "threeColumns", + "id": "1", + "emphasis": "neutral", + "columns": [ + { + "id": "1", + "width": 4, + "webparts": [ + { + "@odata.type": "#oneDrive.textWebPart", + "id": "f6d0ef70-c977-45e4-ae4b-4676a30d5aab", + "innerHtml": "<h1>sample content</h1>" + } + ] + }, + { + "id": "2", + "width": 4, + "webparts": [ + { + "@odata.type": "#oneDrive.textWebPart", + "id": "99f59f91-c853-433e-9e75-ad7a32e46106", + "innerHtml": "<h1>sample content</h1>" + } + ] + }, + { + "id": "3", + "width": 4, + "webparts": [ + { + "@odata.type": "#oneDrive.textWebPart", + "id": "48998492-9633-48b8-a7e9-d293533b4fa6", + "innerHtml": "<h1>sample content</h1>" + } + ] + } + ] + } + ] + } +} +``` ++<!-- +{ + "type": "#page.annotation", + "description": "Get a page in a site", + "keywords": "", + "section": "documentation", + "tocPath": "Pages/Get", + "suppressions": [ + ] +} +--> |
v1.0 | Sitepage Getwebpartsbyposition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/sitepage-getwebpartsbyposition.md | + + Title: "sitePage getWebPartsByPosition" +description: "Get a collection of webParts by position." ++ms.localizationpriority: medium +++# sitePage: getWebPartsByPosition ++Namespace: microsoft.graph ++Get a collection of [webPart](../resources/webpart.md) by providing [webPartPosition](../resources/webpartposition.md) information. ++## 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": "sitepage_getwebpartsbyposition" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +GET /sites/{site-id}/pages/{page-id}/microsoft.graph.sitepage/getWebPartsByPosition +``` ++## Function parameters ++In the request URL, provide one or more following parameters with a valid value. ++| Parameter | Type | Description | +| : | : | :- | +| columnId | Double | Indicates the identifier of the column where the WebPart located. Only works if `horizontalSectionId` is provided. | +| horizontalSectionId | Double | Indicates the horizontal section where the WebPart located. | +| isInVerticalSection | boolean | Indicate whether the WebPart is contained in the current vertical section. | +| webPartIndex | Double | The index of the current WebPart. Represents the order of WebPart in the current column or section. Only works if either `columnId` or `isInVerticalSection` is provided. | ++## Optional query parameters ++This method supports the `$expand`, `$filter`, and `$select` [OData query parameters](/graph/query-parameters) to help customize the response. ++## 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 ++Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a collection of [webPart](../resources/webpart.md) objects in the response body. ++## Examples ++### Request ++The following is an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_webparts_by_position" +} +--> ++```msgraph-interactive +GET https://graph.microsoft.com/v1.0/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/getWebPartsByPosition?isInVerticalSection=true +``` ++# [JavaScript](#tab/javascript) ++++++### 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.webPart)" +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "@odata.type": "#microsoft.graph.textWebPart", + "id": "d79d70af-27ea-4208-8dce-23c3bf678664", + "innerHtml": "<h2>How do you get started?</h2>" + } + ] +} +``` |
v1.0 | Sitepage List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/sitepage-list.md | ++ +description: "Get the collection of sitePage objects from the site pages [list] in a site. All pages in the site are returned (with pagination)." Last updated : 03/15/2018+ Title: List SitePage +ms.localizationpriority: medium +++# List SitePage ++Namespace: microsoft.graph ++Get the collection of [sitePage][] objects from the site pages [list][] in a site [site][]. All pages in the site are returned (with pagination). Sort alphabetically by `name` in ascending order. ++[sitePage]: ../resources/sitepage.md +[list]: ../resources/list.md +[site]: ../resources/site.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": "sitepage_list" } --> ++## HTTP request ++<!-- { "blockType": "ignored" } --> ++```http +GET /sites/{site-id}/pages/microsoft.graph.sitePage +``` ++## Optional query parameters ++This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. ++## 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 ++Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200` and a list of [sitePage](../resources/sitepage.md) object in the response body. ++## Example ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!--{ + "blockType": "request", + "name": "get-pages", + "scopes": "sites.read.all", + "tags": "service.sharepoint" +} +--> ++```msgraph-interactive +GET /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/microsoft.graph.sitePage +``` ++# [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. ++<!-- +{ + "blockType": "response", + "@odata.type": "microsoft.graph.sitePage", + "truncated": true, + "isCollection":true +} +--> ++```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "value": [ + { + "id": "08f48aa6-02e3-407c-bbcb-ff61cec653fa", + "name": "sample.aspx", + "webUrl": "https://contoso.sharepoint.com/SitePages/sample.aspx", + "title": "sample", + "pageLayout": "article", + "showComments": true, + "showRecommendedPages": false, + "createdBy": { + "user": { + "displayName": "Rahul Mittal", + "email": "rahmit@contoso.com" + } + }, + "lastModifiedBy": { + "user": { + "displayName": "Rahul Mittal", + "email": "rahmit@contoso.com" + } + }, + "publishingState": { + "level": "checkout", + "versionId": "1.1", + "checkedOutBy": { + "user": { + "displayName": "Rahul Mittal", + "email": "rahmit@contoso.com" + } + } + }, + "reactions": { + "commentCount": 4, + "likeCount": 2 + }, + "titleArea": { + "enableGradientEffect": true, + "imageWebUrl": "https://cdn.hubblecontent.osi.office.net/m365content/publish/005292d6-9dcc-4fc5-b50b-b2d0383a411b/image.jpg", + "layout": "imageAndTitle", + "showAuthor": false, + "showPublishedDate": false, + "showTextBlockAboveTitle": false, + "textAboveTitle": "", + "textAlignment": "left", + "imageSourceType": 2, + "title": "sample" + } + }, + { + "id": "7d87eee1-7c77-46b5-b2c4-ad6e4e432a8e", + "name": "Home.aspx", + "webUrl": "https://contoso.sharepoint.com/SitePages/Home.aspx", + "title": "Home", + "pageLayout": "home", + "showComments": true, + "showRecommendedPages": false, + "createdBy": { + "user": { + "displayName": "Rahul Mittal", + "email": "rahmit@contoso.com" + } + }, + "lastModifiedBy": { + "user": { + "displayName": "Rahul Mittal", + "email": "rahmit@contoso.com" + } + }, + "publishingState": { + "level": "checkout", + "versionId": "1.1", + "checkedOutBy": { + "user": { + "displayName": "Rahul Mittal", + "email": "rahmit@contoso.com" + } + } + }, + "reactions": { + "commentCount": 1 + }, + "titleArea": { + "enableGradientEffect": true, + "imageWebUrl": "https://cdn.hubblecontent.osi.office.net/m365content/publish/005292d6-9dcc-4fc5-b50b-b2d0383a411b/image.jpg", + "layout": "imageAndTitle", + "showAuthor": true, + "showPublishedDate": false, + "showTextBlockAboveTitle": false, + "textAboveTitle": "Text Above Title", + "textAlignment": "left", + "imageSourceType": 2, + "title": "Home", + "hasTitleBeenCommitted": true + } + } + ] +} +``` ++<!-- +{ + "type": "#page.annotation", + "description": "Enumerate the list of pages in a site", + "keywords": "", + "section": "documentation", + "tocPath": "Pages/Enumerate", + "suppressions": [ + ] +} +--> |
v1.0 | Sitepage Post Horizontalsection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/sitepage-post-horizontalsection.md | + + Title: 'Create horizontalSection' +description: "Create a horizontalSection in a page" ++ms.localizationpriority: medium ++# Create horizontalSection ++Namespace: microsoft.graph ++Create a [horizontalSection](../resources/horizontalSection.md) object in a given [sitePage](../resources/sitepage.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": "sitepage_post_horizontalsection" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +POST /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/horizontalSections +``` ++## 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 [horizontalSection](../resources/horizontalSection.md) resource to create. ++## Response ++If successful, this method returns a `201 Created` response code and a created [horizontalSection](../resources/horizontalSection.md) object in the response body. ++## Examples ++### Request ++The following is an example of a request. ++<!-- { "blockType": "ignored" } --> ++```http +POST https://graph.microsoft.com/v1.0/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/horizontalSections +Content-Type: application/json ++{ + "emphasis": "soft", + "layout": "oneColumn", + "id": "3", + "columns": [ + { + "id": "1", + "width": 12, + "webparts":[ + { + "id":"20a69b85-529c-41f3-850e-c93458aa74eb", + "innerHtml":"<p>sample text in text web part</p>" + } + ] + } + ] +} +``` ++### Response ++The following example shows the response. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "@odata.type": "microsoft.graph.horizontalSection", + "truncated": true +} +--> ++```http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "emphasis": "soft", + "layout": "oneColumn", + "id": "3", + "columns": [ + { + "id": "1", + "width": 12, + "webparts":[ + { + "id":"20a69b85-529c-41f3-850e-c93458aa74eb", + "innerHtml":"<p>sample text in text web part</p>" + } + ] + } + ] +} +``` |
v1.0 | Sitepage Post Verticalsection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/sitepage-post-verticalsection.md | + + Title: 'Create verticalSection' +description: "Create a verticalSection in a page" ++ms.localizationpriority: medium ++# Create verticalSection ++Namespace: microsoft.graph ++Create a [verticalSection](../resources/verticalSection.md) object in a given [sitePage](../resources/sitepage.md). ++A [sitePage](../resources/sitepage.md) can only have one vertical section. If a vertical section already exists, this method returns a `409 Conflict` response code. ++## 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": "sitepage_post_verticalsection" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +PUT /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/verticalSection +``` ++## 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 [verticalSection](../resources/verticalSection.md) resource to create. ++## Response ++If successful, this method returns a `201 Created` response code and a created [verticalSection](../resources/verticalSection.md) object in the response body. ++If the vertical section already exists, this method returns a `409 Conflict` response code. ++## Examples ++### Request ++The following is an example of a request. ++<!-- { "blockType": "ignored" } --> ++```http +PUT https://graph.microsoft.com/v1.0/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/verticalSection +Content-Type: application/json ++{ + "emphasis": "soft", + "webparts":[ + { + "id":"20a69b85-529c-41f3-850e-c93458aa74eb", + "innerHtml":"<p>sample text in text web part</p>" + } + ] +} +``` ++++### Response ++The following example shows the response. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "@odata.type": "microsoft.graph.verticalSection", + "truncated": true +} +--> ++```http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "emphasis": "soft", + "webparts":[ + { + "id":"20a69b85-529c-41f3-850e-c93458aa74eb", + "innerHtml":"<p>sample text in text web part</p>" + } + ] +} +``` |
v1.0 | Sitepage Publish | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/sitepage-publish.md | ++ +description: "Publish the latest version of a sitePage resource, which makes the version of the page available to all users." + Title: "sitePage: publish" +ms.localizationpriority: medium ++# sitePage: publish ++Namespace: microsoft.graph ++Publish the latest version of a [sitePage][] resource, which makes the version of the page available to all users. If the page is checked out, check in the page and publish it. If the page is checked out to the caller of this API, the page is automatically checked in and then published. ++> If a page approval flow has been activated in the page library, the page is not published until the approval flow is completed. ++[sitePage]: ../resources/sitepage.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": "sitepage_publish" } --> ++## HTTP request ++<!-- { "blockType": "ignored" } --> ++```http +POST /sites/{siteId}/pages/{pageId}/microsoft.graph.sitePage/publish +``` ++## 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 `204 No Content`. It does not return anything in the response body. ++<!-- { "blockType": "response" } --> ++```http +HTTP/1.1 204 No Content +``` +++<!-- +{ + "type": "#page.annotation", + "description": "Publish a page.", + "keywords": "publish page", + "section": "documentation", + "tocPath": "Pages/Publish", + "suppressions": [] +} +--> ++ |
v1.0 | Sitepage Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/sitepage-update.md | + + Title: "Update sitePage" +description: "Update the properties of a sitePage object." ++ms.localizationpriority: medium +++# Update sitePage ++Namespace: microsoft.graph ++Update the properties of a [sitePage](../resources/sitepage.md) object. +++## 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": "sitepage_update" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +PATCH /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage +``` ++## 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 +++These fields and be used in update requests. ++| Property | Type | Description | +| :- | :- | :-- | +| description | String | Description of the site page. Optional. | +| thumbnailWebUrl | String | Url of the site page's thumbnail image. Optional. | +| title | String | Title of the site page. Optional. | +| showComments | Boolean | Boolean to determine whether or not to show comments at the bottom of the page. Optional. | +| showRecommendedPages | Boolean | Boolean to determine whether or not to show recommended pages at the bottom of the page. Optional. | +| promotionKind | [PagePromotionType](../resources/sitepage.md#pagepromotiontype-values) | Promotion kind of the SharePoint page. Optional. Only support promote a page (e.g from `page` to `newsPost`). Demote is not supported. | +| titleArea | [titleArea](../resources/titlearea.md) | Title area on the site page. Optional. | +| canvasLayout | [canvasLayout](../resources/canvaslayout.md) | The layout of the content in a page, including horizontal sections and vertical section. A content of the entire page layout needs to be provided, the update function does not support partial updates. Optional. | ++> **Notes:** : +> 1. To ensure successful parsing of the request body, the `@odata.type=#microsoft.graph.sitePage` must be included in the request body. +> 2. If you're using the response from the [Get sitepage](../api/sitepage-get.md) operation to update a **sitePage**, we recommend that you add the HTTP header `Accept: application/json;odata.metadata=none`. This will remove all OData metadata from the response. You can also manually remove all OData metadata. +> 3. Only the web part listed in the [Supported web parts](#supported-web-parts) section are supported when updating a [sitePage](../resources/sitepage.md) using the Microsoft Graph API. Attempting to add unsupported web parts will result in a failure or exception. ++### Supported web parts ++There are two kinds of web parts that can be added to a [sitePage](../resources/sitepage.md): [standardWebParts](../resources/standardwebpart.md) and [textWebPart](../resources/textwebpart.md). The following table lists the supported web parts for standard web parts. ++| # | Web Part | Type | +| | -- | -- | +| 1 | Bing Maps | `e377ea37-9047-43b9-8cdb-a761be2f8e09` | +| 2 | Button | `0f087d7f-520e-42b7-89c0-496aaf979d58` | +| 3 | Call To Action | `df8e44e7-edd5-46d5-90da-aca1539313b8` | +| 4 | Divider | `2161a1c6-db61-4731-b97c-3cdb303f7cbb` | +| 5 | Document Embed | `b7dd04e1-19ce-4b24-9132-b60a1c2b910d` | +| 6 | Image | `d1d91016-032f-456d-98a4-721247c305e8` | +| 7 | Image Gallery | `af8be689-990e-492a-81f7-ba3e4cd3ed9c` | +| 8 | Link Preview | `6410b3b6-d440-4663-8744-378976dc041e` | +| 9 | Org Chart | `e84a8ca2-f63c-4fb9-bc0b-d8eef5ccb22b` | +| 10 | People | `7f718435-ee4d-431c-bdbf-9c4ff326f46e` | +| 11 | Quick Links | `c70391ea-0b10-4ee9-b2b4-006d3fcad0cd` | +| 12 | Spacer | `8654b779-4886-46d4-8ffb-b5ed960ee986` | +| 13 | Youtube Embed | `544dd15b-cf3c-441b-96da-004d5a8cea1d` | ++## Response ++If successful, this method returns a `200 OK` response code and an updated [sitePage](../resources/sitepage.md) object in the response body. ++## Examples ++### Request ++The following is an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_sitepage" +} +--> ++```http +PATCH https://graph.microsoft.com/v1.0/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.sitePage", + "title": "sample", + "showComments": true, + "showRecommendedPages": false +} +``` ++# [JavaScript](#tab/javascript) ++++++### Response ++The following example shows the response. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "@odata.type": "microsoft.graph.sitePage", + "truncated": true +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.sitePage", + "id": "0dd6ddd6-45bd-4acd-b683-de0e6e7231b7", + "name": "sample.aspx", + "webUrl": "https://contoso.sharepoint.com/SitePages/sample.aspx", + "title": "sample", + "pageLayout": "article", + "showComments": true, + "showRecommendedPages": false, + "createdBy": { + "user": { + "displayName": "Rahul Mittal", + "email": "rahmit@contoso.com" + } + }, + "lastModifiedBy": { + "user": { + "displayName": "Rahul Mittal", + "email": "rahmit@contoso.com" + } + }, + "publishingState": { + "level": "draft", + "versionId": "0.1" + }, + "titleArea": { + "enableGradientEffect": true, + "imageWebUrl": "https://cdn.hubblecontent.osi.office.net/m365content/publish/005292d6-9dcc-4fc5-b50b-b2d0383a411b/image.jpg", + "layout": "colorBlock", + "showAuthor": true, + "showPublishedDate": false, + "showTextBlockAboveTitle": false, + "textAboveTitle": "TEXT ABOVE TITLE", + "textAlignment": "left", + "title": "sample", + "imageSourceType": 2 + } +} +``` |
v1.0 | Subscription Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/subscription-delete.md | description: "Delete a subscription." ms.localizationpriority: medium doc_type: apiPageType+ # Delete subscription |
v1.0 | Subscription Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/subscription-get.md | Title: "Get subscription" description: "Retrieve the properties and relationships of a subscription." ms.localizationpriority: high + doc_type: apiPageType |
v1.0 | Subscription List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/subscription-list.md | Title: "List subscriptions" description: "Retrieve the properties and relationships of webhook subscriptions, based on the app ID, the user, and the user's role with a tenant." ms.localizationpriority: high + doc_type: apiPageType |
v1.0 | Subscription Post Subscriptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/subscription-post-subscriptions.md | Title: "Create subscription" description: "Subscribes a listener application to receive change notifications when data on the Microsoft Graph changes." ms.localizationpriority: high + doc_type: apiPageType |
v1.0 | Subscription Reauthorize | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/subscription-reauthorize.md | Title: "subscription: reauthorize" description: "Reauthorize a subscription when you receive a reauthorizationRequired challenge." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Subscription Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/subscription-update.md | Title: "Update subscription" description: "Renew a subscription by extending its expiry time." ms.localizationpriority: medium + doc_type: apiPageType PATCH /subscriptions/{id} [!INCLUDE [table-intro](../../includes/update-property-table-intro.md)] +The request body must include at least one of the properties listed. + | Name | Type | Description| |:--|:|:-| | expirationDateTime | DateTimeOffset | Specifies the date and time in UTC when the subscription expires. For the maximum supported subscription length of time varies depending on the resource. |+| notificationUrl | String | This URL must make use of the HTTPS protocol. Any query string parameter included in the notificationUrl property is included in the HTTP POST request when Microsoft Graph sends the change notifications.| ## Response |
v1.0 | Team Clone | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/team-clone.md | You can specify which parts of the team to clone: - **settings** ΓÇô Copies all settings within the team, along with key group settings. - **tabs** ΓÇô Copies the tabs within channels. -> **Note:** This method isn't supported for organization-wide teams. +> [!NOTE] +> This method isn't supported for organization-wide teams. > [!NOTE] > A known issue related to owners of cloned teams is associated with this method. For details, see [Known issues](https://developer.microsoft.com/graph/known-issues). When tabs are cloned, they aren't configured. The tabs are displayed on the tab bar in Microsoft Teams, and the first time a user opens them, they must go through the configuration screen. -If the user who opens the tab doesn't have permission to configure apps, they'll see a message that says that the tab isn't configured. +If the user who opens the tab doesn't have permission to configure apps, they see a message that says that the tab isn't configured. Cloning is a long-running operation. After the POST clone returns, you need to GET the [operation](../resources/teamsasyncoperation.md) returned by the `Location:` header to see if it's `running`, `succeeded`, or `failed`. You should continue to GET until the status isn't `running`. The recommended delay between GETs is 5 seconds. Cloning is a long-running operation. After the POST clone returns, you need to G ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Team.Create, Group.ReadWrite.All**, Directory.ReadWrite.All** | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Team.Create, Group.ReadWrite.All**, Directory.ReadWrite.All** | +<!-- { "blockType": "permissions", "name": "team_clone" } --> -> **Note**: Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> [!NOTE] +> The Group.ReadWrite.All and Directory.ReadWrite.All are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. ## HTTP request <!-- { "blockType": "ignored" } --> POST /teams/{id}/clone | Property | Type |Description| |:|:--|:-|-|classification|String (optional)|Describes a classification for the group (such as low, medium or high business impact). If classification isn't specified, the classification is copied from the original team/group.| -|description|String (optional)|An optional description for the group. If this property isn't specified, it is left blank.| +|classification|String (optional)|Describes a classification for the group (such as low, medium, or high business impact). If classification isn't specified, the classification is copied from the original team/group.| +|description|String (optional)|An optional description for the group. If this property isn't specified, it's left blank.| |displayName|String|The display name for the group. This property is required when a group is created and it can't be cleared during updates. Supports $filter and $orderby.|-|mailNickname|String|The mail alias for the group, unique in the organization. This property must be specified when a group is created. Supports $filter. If this property isn't specified, it is computed from the displayName. Known issue: this property is currently ignored.| +|mailNickname|String|The mail alias for the group, unique in the organization. This property must be specified when a group is created. Supports `filter`. If this property isn't specified, it's computed from the displayName. This property is currently ignored.| |partsToClone| [clonableTeamParts](../resources/clonableteamparts.md) |A comma-separated list of the parts to clone. Legal parts are "apps, tabs, settings, channels, members".| |visibility|[teamVisibilityType](../resources/teamvisibilitytype.md) (optional)| Specifies the visibility of the group. Possible values are: **Private**, **Public**. If visibility isn't specified, the visibility is copied from the original team/group. If the team being cloned is an **educationClass** team, the visibility parameter is ignored, and the new group's visibility will be set to HiddenMembership.| |
v1.0 | Team Delete Installedapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/team-delete-installedapps.md | Uninstalls an [app](../resources/teamsappinstallation.md) from the specified [te ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | TeamsAppInstallation.ReadWriteSelfForTeam, TeamsAppInstallation.ReadWriteForTeam, Group.ReadWrite.All**, Directory.ReadWrite.All** | -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamsAppInstallation.ReadWriteSelfForTeam.All, TeamsAppInstallation.ReadWriteForTeam.All, Group.ReadWrite.All**, Directory.ReadWrite.All** | +<!-- { "blockType": "permissions", "name": "team_delete_installedapps" } --> -> **Note**: Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> [!NOTE] +> The Group.ReadWrite.All and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Team Get Installedapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/team-get-installedapps.md | Retrieve the [app](../resources/teamsappinstallation.md) installed in the specif ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | TeamsAppInstallation.ReadWriteSelfForTeam, TeamsAppInstallation.ReadForUser, TeamsAppInstallation.ReadForTeam, TeamsAppInstallation.ReadWriteForTeam, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam, TeamsAppInstallation.ReadWriteAndConsentForTeam, Group.Read.All<sup>1</sup>, Group.ReadWrite.All<sup>1</sup>, Directory.Read.All<sup>1</sup>, Directory.ReadWrite.All<sup>1</sup> | -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamsAppInstallation.Read.Group<sup>2</sup>, TeamsAppInstallation.ReadWriteSelfForTeam, TeamsAppInstallation.ReadForTeam.All, TeamsAppInstallation.ReadWriteForTeam.All, TeamsAppInstallation.ReadWriteAndConsentForTeam.All, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam.All, Group.Read.All<sup>1</sup>, Group.ReadWrite.All<sup>1</sup>, Directory.Read.All<sup>1</sup>, Directory.ReadWrite.All<sup>1</sup> | +<!-- { "blockType": "permissions", "name": "team_get_installedapps" } --> +> [!NOTE] +> - The Group.Read.All, Group.ReadWrite.All, Directory.Read.All, and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission and avoid using these permissions going forward. +> - The TeamsAppInstallation.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request |
v1.0 | Team Get Members | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/team-get-members.md | Get a [conversationMember](../resources/conversationmember.md) from a [team](../ ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission Type|Permissions (from least to most privileged)| -||-| -|Delegated (work or school account)| TeamMember.Read.All, TeamMember.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application| TeamMember.Read.Group*, TeamMember.Read.All, TeamMember.ReadWrite.All | +<!-- { "blockType": "permissions", "name": "team_get_members" } --> ++> [!NOTE] +> The TeamMember.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). -> **Note**: Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request <!-- { "blockType": "ignored"} --> ```http GET /teams/{team-id}/members/{membership-id} ## Optional query parameters -This operation does not support the [OData query parameters](/graph/query-parameters) to customize the response. +This operation doesn't support the [OData query parameters](/graph/query-parameters) to customize the response. ## Request headers |
v1.0 | Team Get Primarychannel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/team-get-primarychannel.md | Get the default [channel](../resources/channel.md), **General**, of a [team](../ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | ChannelSettings.Read.Group*, ChannelSettings.ReadWrite.Group*, Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All | +This API supports admin permissions. Global admins can access groups that they aren't a member of. -> **Note**: Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +<!-- { "blockType": "permissions", "name": "team_get_primarychannel" } --> -> **Note**: This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of. +> [!NOTE] +> The ChannelSettings.Read.Group and ChannelSettings.ReadWrite.Group permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Team List Installedapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/team-list-installedapps.md | Retrieve a list of [apps installed](../resources/teamsappinstallation.md) in the ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | TeamsAppInstallation.ReadForTeam, TeamsAppInstallation.ReadWriteSelfForTeam, TeamsAppInstallation.ReadWriteForTeam, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam, TeamsAppInstallation.ReadWriteAndConsentForTeam, Group.Read.All<sup>1</sup>, Group.ReadWrite.All<sup>1</sup>, Directory.Read.All<sup>1</sup>, Directory.ReadWrite.All<sup>1</sup> | -|Delegated (personal Microsoft account) | Not supported. | -|Delegated (work or school account) | TeamsAppInstallation.ReadForTeam, TeamsAppInstallation.ReadWriteSelfForTeam, TeamsAppInstallation.ReadWriteForTeam, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam, TeamsAppInstallation.ReadWriteAndConsentForTeam, Group.Read.All<sup>1</sup>, Group.ReadWrite.All<sup>1</sup>, Directory.Read.All<sup>1</sup>, Directory.ReadWrite.All<sup>1</sup> | +<!-- { "blockType": "permissions", "name": "team_list_installedapps" } --> +> [!NOTE] +> The Group.Read.All, Group.ReadWrite.All, Directory.Read.All, and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission and avoid using these permissions going forward. ## HTTP request |
v1.0 | Team List Members | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/team-list-members.md | Namespace: microsoft.graph Get the [conversationMember](../resources/conversationmember.md) collection of a [team](../resources/team.md). -The membership IDs returned by the server must be treated as opaque strings. The client should not try to parse or make assumptions about these resource IDs. +The membership IDs returned by the server must be treated as opaque strings. The client shouldn't try to parse or make assumptions about these resource IDs. -In the future, membership results may include users from various tenants, as indicated in the response. Clients should avoid assuming that all members exclusively belong to the current tenant. +In the future, membership results can include users from various tenants, as indicated in the response. Clients should avoid assuming that all members exclusively belong to the current tenant. > [!NOTE]-> This API results in a 401 error when a newly created tenant calls this method. For more information, see [Known issues](https://developer.microsoft.com/en-us/graph/known-issues/?search=19164). +> This API returns a 401 error when a newly created tenant calls this method. For more information, see [Known issues](https://developer.microsoft.com/en-us/graph/known-issues/?search=19164). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)| TeamMember.Read.All, TeamMember.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application| TeamMember.Read.Group*, TeamMember.Read.All, TeamMember.ReadWrite.All | +<!-- { "blockType": "permissions", "name": "team_list_members" } --> -> **Note**: Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamMember.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request |
v1.0 | Team Post Members | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/team-post-members.md | If successful, this method returns a `201 Created` response code and a [conversa For best results, stagger calls with a 2 second buffer. +> [!NOTE] +> The response code `404 Not Found` is returned when you attempt to add a disabled/blocked user. + ## Examples ### Example 1: Add a member to a team |
v1.0 | Team Post | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/team-post.md | Create a new [team](../resources/team.md). ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -| Permission type | Permissions (from least to most privileged) | -| :- | : | -| Delegated (work or school account) | Team.Create, Group.ReadWrite.All**, Directory.ReadWrite.All** | -| Delegated (personal Microsoft account) | Not supported. | -| Application | Team.Create, Teamwork.Migrate.All, Group.ReadWrite.All**, Directory.ReadWrite.All** | +<!-- { "blockType": "permissions", "name": "team_post" } --> -> **Note**: The Teamwork.Migrate.All permission is *only* supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). -In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. --> **Note**: Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> [!NOTE] +> - The Teamwork.Migrate.All permission is only supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. +> - The Group.ReadWrite.All and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. ## HTTP request To create a team from a non-standard base template, you want to change the `temp To learn more about supported base template types, see [Get started with Teams templates](/MicrosoftTeams/get-started-with-teams-templates). -> [!Note] +> [!NOTE] > It can take up to 24 hours for Teams users to see a custom template change in the gallery. #### Request |
v1.0 | Team Sendactivitynotification | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/team-sendactivitynotification.md | Send an activity feed notification in the scope of a team. For more information [!INCLUDE [national-cloud-support](../../includes/global-us.md)] ## Permissions-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|TeamsActivity.Send| -|Delegated (personal Microsoft account)|Not Supported.| -|Application|TeamsActivity.Send.Group*, TeamsActivity.Send| +<!-- { "blockType": "permissions", "name": "team_sendactivitynotification" } --> ->**Note:** Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamsActivity.Send.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request |
v1.0 | Team Teamsappinstallation Upgrade | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/team-teamsappinstallation-upgrade.md | Title: "teamsAppInstallation in a team: upgrade" -description: "Upgrade an app installation in a team" +description: "Upgrade an app installation in a team." ms.localizationpriority: medium Upgrade an [app installation](../resources/teamsappinstallation.md) in a [team]( ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | TeamsAppInstallation.ReadWriteSelfForTeam<sup>1</sup>, TeamsAppInstallation.ReadWriteForTeam<sup>1</sup>, TeamsAppInstallation.ReadWriteAndConsentForTeam, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam, Group.ReadWrite.All<sup>2</sup>, Directory.ReadWrite.All<sup>2</sup> | -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamsAppInstallation.ReadWriteSelfForTeam.All<sup>1</sup>, TeamsAppInstallation.ReadWriteForTeam.All<sup>1</sup>, TeamsAppInstallation.ReadWriteAndConsentForTeam.All, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam.All, Group.ReadWrite.All<sup>2</sup>, Directory.ReadWrite.All<sup>2</sup> | +<!-- { "blockType": "permissions", "name": "team_teamsappinstallation_upgrade" } --> -> **Note**: -<br><sup>1</sup> These permissions cannot be used to install apps that require consent to [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent) permissions. -<br><sup>2</sup> These permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission and avoid using these permissions going forward. +> [!NOTE] +> - The TeamsAppInstallation.ReadWriteSelfForTeam, TeamsAppInstallation.ReadWriteForTeampermissions, TeamsAppInstallation.ReadWriteSelfForTeam.All, and TeamsAppInstallation.ReadWriteForTeam.All permissions cannot be used to install apps that require consent to [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent) permissions. +> - The Group.ReadWrite.All and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission and avoid using these permissions going forward. ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Teamsapp Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/teamsapp-delete.md | You can also use this API to remove a submitted app from the review process. ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). ->**Note:** Only global administrators can call this API. +Only global administrators can call this API. -| Permission Type | Permissions (from least to most privileged)| -|:- |:-| -| Delegated (work or school account) | AppCatalog.Submit, AppCatalog.ReadWrite.All, Directory.ReadWrite.All** | -| Delegated (personal Microsoft account) | Not supported.| -| Application | Not supported. | +<!-- { "blockType": "permissions", "name": "teamsapp_delete" } --> -> **Note:** -> -> * Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. -> * You can only use the `AppCatalog.Submit` permission to delete app definitions in review. +> [!NOTE] +> - The Directory.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> - You can only use the AppCatalog.Submit permission to delete app definitions in review. ## HTTP request To delete an app from the app catalog: DELETE /appCatalogs/teamsApps/{id} ``` -To delete an app that has been submitted but has not been approved: +To delete an app that is submitted but isn't yet approved: ```http DELETE appCatalogs/teamsApps/{appId}/appDefinitions/{appDefinitionId} |
v1.0 | Teamsapp Publish | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/teamsapp-publish.md | The **requiresReview** property allows any user to submit an app for review by a ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -| Permission Type | Permissions (from least to most privileged)| -|:- |:-| -| Delegated (work or school account) | AppCatalog.Submit, AppCatalog.ReadWrite.All, Directory.ReadWrite.All** | -| Delegated (personal Microsoft account) | Not supported. | -| Application | Not supported. | +<!-- { "blockType": "permissions", "name": "teamsapp_publish" } --> -> **Note**: Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> [!NOTE] +> The Directory.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. ## HTTP request <!-- { "blockType": "ignored" } --> POST /appCatalogs/teamsApps?requiresReview={Boolean} |Property|Type|Description| |-|-|-|-|requiresReview| Boolean | This optional query parameter triggers the app review process. Users with admin privileges can submit apps without triggering a review. If users want to request a review before publishing, they must set **requiresReview** to `true`. A user who has admin privileges can opt not to set **requiresReview** or set the value to `false` and the app will be considered approved and will publish instantly.| +|requiresReview| Boolean | This optional query parameter triggers the app review process. Users with admin privileges can submit apps without triggering a review. If users want to request a review before publishing, they must set **requiresReview** to `true`. A user who has admin privileges can opt not to set **requiresReview** or set the value to `false` and the app is approved and immediately published.| ## Request headers |
v1.0 | Teamsapp Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/teamsapp-update.md | This API specifically updates an app published to your organization's app catalo ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -| Permission Type | Permissions (from least to most privileged)| -|:- |:-| -| Delegated (work or school account) | AppCatalog.Submit, AppCatalog.ReadWrite.All, Directory.ReadWrite.All** | -| Delegated (personal Microsoft account) | Not supported. | -| Application | Not supported. | +Only Global Administrators can call this API. -> **Note:** -> * Only Global Administrators can call this API. -> * Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +<!-- { "blockType": "permissions", "name": "teamsapp_update" } --> +++> [!NOTE] +> * The Directory.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. ## HTTP request POST /appCatalogs/teamsApps/{id}/appDefinitions |Property|Type|Description| |-|-|-|-|requiresReview| Boolean | This optional query parameter triggers the app review process. Users with admin privileges can submit apps without triggering a review. If users want to request a review before publishing, they must set **requiresReview** to `true`. A user who has admin privileges can opt not to set **requiresReview** or set the value to `false` and the app will be considered approved and will publish instantly.| +|requiresReview| Boolean | This optional query parameter triggers the app review process. Users with admin privileges can submit apps without triggering a review. If users want to request a review before publishing, they must set **requiresReview** to `true`. A user who has admin privileges can opt not to set **requiresReview** or set the value to `false` and the app is approved and immediately published.| ## Request headers POST /appCatalogs/teamsApps/{id}/appDefinitions ## Request body -In the request body, include a Teams zip manifest payload. For details, see [Create an app package](/microsoftteams/platform/concepts/apps/apps-package) +In the request body, include a Teams zip manifest payload. For details, see [Create an app package](/microsoftteams/platform/concepts/apps/apps-package). >**Note:** Use the ID returned from the [List published apps](./appcatalogs-list-teamsapps.md) call to reference the app you'd like to update. Do not use the ID from the manifest of the zip app package. The following example shows the response. HTTP/1.1 204 No Content ``` -### Example 2: Update a new version of an existing app for admin review prior to publication in the current tenant catalog +### Example 2: Update a new version of an existing app for admin review before publication in the current tenant catalog #### Request |
v1.0 | Teamwork Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/teamwork-get.md | + + Title: "Get teamwork." +description: "Get organization settings for teamwork, such as the region of the organization and the Microsoft Teams enablement status." ++ms.localizationpriority: high ++++# Get teamwork ++Namespace: microsoft.graph ++Get the properties and relationships of a [teamwork](../resources/teamwork.md) object, such as the region of the organization and whether Microsoft Teams is enabled. +++## 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": "teamwork_get" } --> ++## HTTP request +<!-- { "blockType": "ignored" } --> +```http +GET /teamwork +``` ++## Request headers ++| Header | Value | +| : | :- | +|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 along with a [teamwork](../resources/teamwork.md) object in the response body. +++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_teamworkSettings_for_organization", +}--> ++```msgraph-interactive +GET https://graph.microsoft.com/v1.0/teamwork +``` ++# [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. ++>**Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.teamwork" +} --> ++```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#teamwork", + "id": "teamwork", + "isTeamsEnabled": true, + "region": "Americas" +} +``` ++## Related content ++- [licenseDetails: getTeamsLicensingDetails](licenseDetails-getteamslicensingdetails.md) +- [Get userTeamwork](userteamwork-get.md) |
v1.0 | Tenantrelationship Put Multitenantorganization | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/tenantrelationship-put-multitenantorganization.md | + + Title: "Create multiTenantOrganization" +description: "Create a new multitenant organization." ++ms.localizationpriority: medium ++++# Create multiTenantOrganization +Namespace: microsoft.graph ++Create a new multitenant organization. By default, the creator tenant becomes an owner tenant upon successful creation. Only owner tenants can manage a multitenant organization. +++## 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": "tenantrelationship_put_multitenantorganization" } --> +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PUT /tenantRelationships/multiTenantOrganization +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [multiTenantOrganization](../resources/multitenantorganization.md) object. ++You can specify the following properties when creating a **multiTenantOrganization**. ++|Property|Type|Description| +|:|:|:| +|displayName|String|Display name of the multitenant organization. Required.| +|description|String|Description of the multitenant organization. Optional.| ++++## Response ++If successful, this method returns a `201 Created` response code and a [multiTenantOrganization](../resources/multitenantorganization.md) object in the response body. ++## Examples ++The following example creates a new multitenant organization. ++### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_multitenantorganization_from_" +} +--> +``` http +PUT https://graph.microsoft.com/v1.0/tenantRelationships/multiTenantOrganization +Content-Type: application/json ++{ + "displayName": "Contoso organization", + "description": "Multitenant organization between Contoso, Fabrikam, and Woodgrove Bank" +} +``` ++# [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 ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.multiTenantOrganization" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#tenantRelationships/multiTenantOrganization/$entity", + "id": "6d8b39e5-039a-4034-bf3a-e0b4f8cd60b6", + "createdDateTime": "2023-05-26T22:05:23Z", + "displayName": "Contoso organization", + "description": "Multitenant organization between Contoso, Fabrikam, and Woodgrove Bank", + "state": "active" +} +``` + |
v1.0 | User Assignlicense | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-assignlicense.md | Title: "user: assignLicense" description: "Add or remove subscriptions for the user. You can also enable and disable specific plans associated with a subscription." ms.localizationpriority: high+ doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "user_assignlicense" } --> [!INCLUDE [permissions-table](../includes/permissions/user-assignlicense-permissions.md)] -For delegated scenarios, the calling user needs one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). +For delegated scenarios, the calling user needs at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). - Directory Writers - License Administrator - User Administrator-- Global Administrator ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | User Changepassword | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-changepassword.md | description: "Update your own password." ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | User Delete Approleassignments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-delete-approleassignments.md | Title: "Delete appRoleAssignment" description: "Delete an appRoleAssignment that has been granted to a user." ms.localizationpriority: medium doc_type: apiPageType+ |
v1.0 | User Delete Manager | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-delete-manager.md | description: "Remove a user's manager." ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | User Delete Sponsors | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-delete-sponsors.md | + + Title: "Remove sponsor" +description: "Remove a user's sponsor." ++ms.localizationpriority: medium ++++# Remove sponsor ++Namespace: microsoft.graph ++Remove a user's sponsor. ++## 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": "user_delete_sponsors" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /users/{id}/sponsors/{id}/$ref +``` ++> [!CAUTION] +> If `/$ref` is not appended to the request and the calling app has permissions to manage the sponsor object type, the sponsor object is also deleted from Microsoft Entra ID; otherwise, a `403 Forbidden` error is returned. For example, an app with `User.ReadWrite.All` permissions deletes a user who is a sponsor. You can restore specific objects through the [Restore deleted items API](directory-deleteditems-restore.md). ++## 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 `204 No Content` response code. It doesn't return anything in the response body. ++## Examples ++### Request ++The following is an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_sponsors_from_user" +} +--> +``` http +DELETE https://graph.microsoft.com/v1.0/users/{user-id}/sponsors/{directory-object-id}/$ref +``` ++# [JavaScript](#tab/javascript) ++++### Response ++The following example shows the response. +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` |
v1.0 | User Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-delete.md | description: "Describes the delete method of the user resource (entity) of the M ms.localizationpriority: high+ doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "ignored", "name": "user_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/user-delete-permissions.md)] -The calling user must be assigned one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): +The calling user must be assigned at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): - User Administrator - Privileged Authentication Administrator-- Global Administrator To delete users with privileged administrator roles in delegated scenarios, the app must be assigned the *Directory.AccessAsUser.All* delegated permission, and the calling user must have a higher privileged administrator role as indicated in [Who can perform sensitive actions](../resources/users.md#who-can-perform-sensitive-actions). |
v1.0 | User Delta | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-delta.md | description: "Get newly created, updated, or deleted users without having to per ms.localizationpriority: high + doc_type: apiPageType |
v1.0 | User Exportpersonaldata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-exportpersonaldata.md | description: "Submits a data policy operation request, made by a Company Adminis ms.localizationpriority: medium + doc_type: apiPageType doc_type: apiPageType Namespace: microsoft.graph -Submit a data policy operation request from a company administrator or an application to export an organizational user's data. This data includes the user's data stored in OneDrive and their activity reports. For more guidance about exporting data while complying with regulations, see [Data Subject Requests and the GDPR and CCPA](/compliance/regulatory/gdpr-data-subject-requests). +Submit a data policy operation request from a company administrator or an application to export an organizational user's data. This data includes the user's data stored in OneDrive and their activity reports. For more information about exporting data while complying with regulations, see [Data Subject Requests and the GDPR and CCPA](/compliance/regulatory/gdpr-data-subject-requests). [!INCLUDE [national-cloud-support](../../includes/global-only.md)] POST /users/{id}/exportPersonalData ## Request body In the request body, provide a JSON object with the following parameters. -| Parameter | Type |Description| +| Parameter | Type |Description| |:|:--|:-|-|storageLocation|String|This is a shared access signature (SAS) URL to an Azure Storage account, to where data should be exported.| +|storageLocation|String|A shared access signature (SAS) URL to an Azure Storage account, to where data should be exported.| ## Response If successful, this method returns a `202 Accepted` response code. It doesn't return anything in the response body. The response contains the following response headers. |
v1.0 | User Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-get.md | description: "Retrieve the properties and relationships of user object." ms.localizationpriority: high+ doc_type: apiPageType |
v1.0 | User List Agreementacceptances | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-list-agreementacceptances.md | Title: "List agreementAcceptances" description: "Retrieve a list of a user's agreementAcceptance objects." ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | User List Approleassignments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-list-approleassignments.md | Title: "List appRoleAssignments granted to a user" description: "Retrieve the list of app role assignments granted to a user." ms.localizationpriority: high doc_type: apiPageType+ |
v1.0 | User List Createdobjects | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-list-createdobjects.md | description: "Get a list of directory objects that were created by the user." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | User List Directreports | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-list-directreports.md | description: "Get a user's direct reports." ms.localizationpriority: high + doc_type: apiPageType |
v1.0 | User List Joinedteams | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-list-joinedteams.md | Get the [teams](../resources/team.md) in Microsoft Teams that the user is a dire [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--|:| -|Delegated (work or school account) | Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, User.Read.All, User.ReadWrite.All, Directory.Read.All**, Directory.ReadWrite.All** | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, User.Read.All, User.ReadWrite.All, Directory.Read.All**, Directory.ReadWrite.All** | +<!-- { "blockType": "permissions", "name": "user_list_joinedteams" } --> -> **Note:** Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> [!NOTE] +> The Directory.Read.All and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. ## HTTP request <!-- { "blockType": "ignored" } --> GET /users/{id | user-principal-name}/joinedTeams ``` ## Optional query parameters-This method does not currently support the [OData query parameters](/graph/query-parameters) to customize the response. +This method doesn't currently support the [OData query parameters](/graph/query-parameters) to customize the response. ## Request headers | Header | Value | Don't supply a request body for this method. If successful, this method returns a `200 OK` response code and a collection of [team](../resources/team.md) objects in the response body. -> [!Note] +> [!NOTE] > This API has a [known issue](https://developer.microsoft.com/en-us/graph/known-issues/?search=13633) where it returns only the **id**, **displayName**, and **description** properties of a [team](../resources/team.md).To get all properties, use the [Get team](../api/team-get.md) operation. ## Example |
v1.0 | User List Licensedetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-list-licensedetails.md | Title: "List licenseDetails" description: "Retrieve a list of licenseDetails objects." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | User List Manager | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-list-manager.md | description: "Get user's manager. Returns the user or contact assigned as the us ms.localizationpriority: high + doc_type: apiPageType |
v1.0 | User List Memberof | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-list-memberof.md | description: "Get groups, directory roles, and administrative units that the use ms.localizationpriority: high+ doc_type: apiPageType Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "user_list_memberof" } --> [!INCLUDE [permissions-table](../includes/permissions/user-list-memberof-permissions.md)] -> **Note:** To list the members of a group with hidden membership, the Member.Read.Hidden permission is required. +> [!TIP] +> - Calling the `/me/memberOf` endpoint requires a signed-in user and therefore a delegated permission. Application permissions are not supported when you use the `/me/memberOf` endpoint. +> - To list the members of a group with hidden membership, the `Member.Read.Hidden` permission is required. [!INCLUDE [limited-info](../../includes/limited-info.md)] |
v1.0 | User List Owneddevices | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-list-owneddevices.md | description: "Get the list of devices that are owned by the user." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | User List Ownedobjects | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-list-ownedobjects.md | description: "Get the list of directory objects that are owned by the user." ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | User List Registereddevices | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-list-registereddevices.md | description: "Get the list of user's registered devices." ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | User List Sponsors | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-list-sponsors.md | + + Title: "List sponsors" +description: "Get a user's sponsors." +ms.localizationpriority: medium +++++# List sponsors ++Namespace: microsoft.graph ++Get a user's sponsors. Sponsors are users and groups that are responsible for this guest's privileges in the tenant and for keeping the guest's information and access up to date. +++## 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": "user_list_sponsors" } --> +++## HTTP request ++Get sponsors. +<!-- { "blockType": "ignored" } --> +```http +GET /users/{id | userPrincipalName}/sponsors +``` ++## Optional query parameters ++This method supports the `$select` and `$expand` [OData query parameters](/graph/query-parameters) to help customize the response. You can specify `$select` inside `$expand` to select the individual sponsor's properties: `$expand=sponsors($select=id,displayName)`. ++## Request headers ++| Header | Value | +| : | : | +|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 [user](../resources/user.md) and [group](../resources/group.md) objects in the response body. ++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_sponsors" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/users/025e5e3e-e5b7-4eb4-ba1f-4e5b0579f1a2/sponsors +``` ++# [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. +>**Note**: The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.directoryObject", + "isCollection": true +} +--> +```http +HTTP/1.1 200 OK +Content-type: application/json ++{ +"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#directoryObjects", + "value": [ + { + "@odata.type": "#microsoft.graph.user", + "id": "263a1289-8282-4bf7-91f7-550d9bba8c02", + "displayName": "Sara Davis", + "jobTitle": "Finance VP", + "mail": "SaraD@contoso.com", + "userPrincipalName": "SaraD@contoso.com" + }, + { + "@odata.type": "#microsoft.graph.group", + "id": "08143e93-989e-4771-ac78-803bcdac52d2", + "mail": "groupforsponsors@contoso.com", + "mailEnabled": true, + "mailNickname": "groupforsponsors", + "securityEnabled": true + } + ] +} +``` |
v1.0 | User List Transitivememberof | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-list-transitivememberof.md | description: "Get groups, directory roles, and administrative units that the use ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | User List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-list.md | description: "Retrieve a list of user objects." ms.localizationpriority: high+ doc_type: apiPageType |
v1.0 | User Post Approleassignments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-post-approleassignments.md | Title: "Grant an appRoleAssignment to a user" description: "Grant an app role assignment to a user." ms.localizationpriority: high doc_type: apiPageType+ |
v1.0 | User Post Manager | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-post-manager.md | description: "Assign a user's manager." ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | User Post Sponsors | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-post-sponsors.md | + + Title: "Add sponsor" +description: "Assign a user a sponsor." ++ms.localizationpriority: medium ++++# Add sponsor ++Namespace: microsoft.graph ++Assign a user a sponsor. Sponsors are users and groups that are responsible for this guest user's privileges in the tenant and for keeping the guest user's information and access up to date. ++## 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": "user_post_sponsors" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /users/{id}/sponsors/$ref +``` ++## 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 object and pass an `@odata.id` parameter with the read URL of the [user](../resources/user.md) or [group](../resources/group.md) object to be added. ++## Response ++If successful, this method returns `204 No Content` response code. It doesn't return anything in the response body. ++## Examples ++### Example 1: Assign a user as a sponsor ++#### Request ++The following example shows a request. The request body is a JSON object with an `@odata.id` parameter and the read URL for the [user](../resources/user.md) object to be assigned as a sponsor. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_userSponsors" +} +--> +``` http +POST https://graph.microsoft.com/v1.0/users/d8ab5060-f636-4cff-ae97-d4687f5c83f3/sponsors/$ref +Content-Type: application/json ++{ + "@odata.id": "https://graph.microsoft.com/v1.0/users/{user-id}" +} +``` ++# [JavaScript](#tab/javascript) ++++#### Response ++The following example shows the response. +<!-- { + "blockType": "response" +} --> +```http +HTTP/1.1 204 No Content +``` ++### Example 2: Assign a group as a sponsor ++#### Request ++The following example shows a request. The request body is a JSON object with an `@odata.id` parameter and the read URL for the [group](../resources/group.md) object to be assigned as a sponsor. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_groupSponsors" +} +--> +``` http +POST https://graph.microsoft.com/v1.0/users/d8ab5060-f636-4cff-ae97-d4687f5c83f3/sponsors/$ref +Content-Type: application/json ++{ + "@odata.id": "https://graph.microsoft.com/v1.0/groups/{group-id}" +} +``` ++# [JavaScript](#tab/javascript) ++++#### Response ++The following example shows the response. +<!-- { + "blockType": "response" +} --> +```http +HTTP/1.1 204 No Content +``` |
v1.0 | User Post Users | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-post-users.md | description: "Use this API to create a new User." ms.localizationpriority: high+ doc_type: apiPageType |
v1.0 | User Reprocesslicenseassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-reprocesslicenseassignment.md | description: "Reprocess all group-based license assignments for the user." ms.localizationpriority: medium + doc_type: "apiPageType" Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "user_reprocesslicenseassignment" } --> [!INCLUDE [permissions-table](../includes/permissions/user-reprocesslicenseassignment-permissions.md)] -For delegated scenarios, the calling user needs one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). +For delegated scenarios, the calling user needs at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). - Directory Writers - License Administrator - User Administrator-- Global Administrator ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | User Retryserviceprovisioning | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-retryserviceprovisioning.md | Title: "user: retryServiceProvisioning" description: "Retries user service provisioning." ms.localizationpriority: medium + doc_type: "apiPageType" |
v1.0 | User Revokesigninsessions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-revokesigninsessions.md | description: "Invalidates all the user's refresh tokens issued to applications ( ms.localizationpriority: medium + doc_type: apiPageType |
v1.0 | User Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-update.md | description: "Update the properties of a user object." ms.localizationpriority: high+ doc_type: apiPageType |
v1.0 | Userflowlanguageconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/userflowlanguageconfiguration-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "userflowlanguageconfiguration_get" } --> [!INCLUDE [permissions-table](../includes/permissions/userflowlanguageconfiguration-get-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Userflowlanguageconfiguration List Defaultpages | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/userflowlanguageconfiguration-list-defaultpages.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "userflowlanguageconfiguration_list_defaultpages" } --> [!INCLUDE [permissions-table](../includes/permissions/userflowlanguageconfiguration-list-defaultpages-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Userflowlanguageconfiguration List Overridespages | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/userflowlanguageconfiguration-list-overridespages.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "userflowlanguageconfiguration_list_overridespages" } --> [!INCLUDE [permissions-table](../includes/permissions/userflowlanguageconfiguration-list-overridespages-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Userflowlanguagepage Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/userflowlanguagepage-delete.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "userflowlanguagepage_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/userflowlanguagepage-delete-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request The following example shows a request. DELETE https://graph.microsoft.com/beta/identity/b2xUserFlows/B2X_1_Partner/languages/en/overridesPages/selfasserted1_1/$value ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/delete-userflowlanguagepage-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) ++# [Python](#tab/python) + ### Response |
v1.0 | Userflowlanguagepage Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/userflowlanguagepage-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "userflowlanguagepage_get" } --> [!INCLUDE [permissions-table](../includes/permissions/userflowlanguagepage-get-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Userflowlanguagepage Put | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/userflowlanguagepage-put.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "userflowlanguagepage_put" } --> [!INCLUDE [permissions-table](../includes/permissions/userflowlanguagepage-put-permissions.md)] -The work or school account needs to belong to one of the following roles: --* Global administrator -* External Identity User Flow administrator ## HTTP request |
v1.0 | Usersettings Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/usersettings-get.md | description: "Read the user and organization settings object." ms.localizationpriority: high+ doc_type: apiPageType |
v1.0 | Usersettings List Windows | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/usersettings-list-windows.md | Namespace: microsoft.graph Get a list of [windowsSetting](../resources/windowssetting.md) objects and their properties for the signed in 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). GET https://graph.microsoft.com/v1.0/me/settings/windows [!INCLUDE [sample-code](../includes/snippets/php/list-windowssetting1-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-windowssetting1-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] GET https://graph.microsoft.com/v1.0/me/settings/windows?$filter=settingType eq [!INCLUDE [sample-code](../includes/snippets/php/list-windowssetting2-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-windowssetting2-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] GET https://graph.microsoft.com/v1.0/me/settings/windows?$filter=settingType eq [!INCLUDE [sample-code](../includes/snippets/php/list-windowssetting3-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-windowssetting3-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] GET https://graph.microsoft.com/v1.0/me/settings/windows?$filter=windowsDeviceId [!INCLUDE [sample-code](../includes/snippets/php/list-windowssetting4-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-windowssetting4-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Usersettings Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/usersettings-update.md | description: "Update the properties of the settings object. " ms.localizationpriority: medium+ doc_type: apiPageType |
v1.0 | Userteamwork Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/userteamwork-get.md | + + Title: "Get userTeamwork" +description: "Get user teamwork settings for a user such as user locale and user region." ++ms.localizationpriority: high ++++# Get userTeamwork ++Namespace: microsoft.graph ++Get the [userTeamwork](../resources/userteamwork.md) settings for a specified [user](../resources/user.md), which includes the Microsoft Teams region and the locale chosen by the 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": "userteamwork_get" } --> ++## HTTP request +<!-- { "blockType": "ignored" } --> +```http +GET /users/{user-id}/teamwork +``` ++## Request headers ++| Header | Value | +| : | :- | +|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 with a [userTeamwork](../resources/userteamwork.md) object in the response body. +++## Examples ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_userTeamworkSettings_for_user", + "sampleKeys": ["2f39ffba-51ca-4d2d-a66f-a020a83ce208"] +}--> +```msgraph-interactive +GET https://graph.microsoft.com/v1.0/users/2f39ffba-51ca-4d2d-a66f-a020a83ce208/teamwork +``` ++# [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. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.userTeamwork" +} --> +```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('2f39ffba-51ca-4d2d-a66f-a020a83ce208')/teamwork/$entity", + "id": "userTeamwork", + "locale": "en-us", + "region": "Americas" +} +``` ++## Related content ++- [licenseDetails: getTeamsLicensingDetails](licenseDetails-getteamslicensingdetails.md) +- [Get teamwork](teamwork-get.md) |
v1.0 | Verticalsection Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/verticalsection-delete.md | + + Title: 'Delete verticalSection' +description: 'Delete a vertical section from a page.' ++ms.localizationpriority: medium +++# Delete verticalSection ++Namespace: microsoft.graph ++Remove a [verticalSection](../resources/verticalSection.md) from a [sitePage](../resources/sitepage.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). ++>**Note:** To delete an item, the user must have granted the application write access to the item to be deleted. ++<!-- { "blockType": "permissions", "name": "verticalsection_delete" } --> ++## HTTP request ++<!-- { "blockType": "ignored" } --> ++```http +DELETE /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/verticalSection +``` ++## Request headers ++| Name |Description| +|:-|:-| +| Authorization | Bearer \{token\}. Required. | ++## Request body ++Don't supply a request body with this method. ++## Response ++If successful, this call returns a `204 No Content`. It doesn't return anything in the response body. ++If the vertical section isn't found, this method returns `404 Not Found`. ++## Example ++### Request ++The following example shows a request. ++<!-- { "blockType": "ignored" } --> ++```http +DELETE https://graph.microsoft.com/v1.0/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/verticalSection +``` +### Response ++The following example shows the response. ++<!-- { "blockType": "response" } --> ++```http +HTTP/1.1 204 No Content +``` |
v1.0 | Verticalsection Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/verticalsection-get.md | + + Title: 'Get verticalSection' +description: 'Read the properties and relationships of a verticalSection object.' ++ms.localizationpriority: medium +++# Get verticalSection ++Namespace: microsoft.graph ++Read the properties and relationships of a [verticalSection](../resources/verticalsection.md) object. ++## 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": "verticalsection_get" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +GET /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/verticalSection +``` ++## 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 [verticalSection](../resources/verticalsection.md) object in the response body. ++## Examples ++### Example 1: Get a verticalSection object +#### Request ++The following is an example of a request. ++<!-- { "blockType": "ignored" } --> ++```http +GET https://graph.microsoft.com/v1.0/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/verticalSection +``` ++#### 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.verticalSection" +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.verticalSection", + "emphasis": "neutral" +} +``` ++### Example 2: Get a verticalSection object using select and expand +#### Request ++With `$select` and `$expand` statements, you can retrieve verticalSection metadata and associated webParts in a single request. ++<!-- { "blockType": "ignored" } --> ++```http +GET https://graph.microsoft.com/v1.0/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/verticalSection?$select=emphasis&$expand=webparts +``` ++#### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.verticalSection" +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "emphasis": "neutral", + "webparts":[{ + "id": "1212fc8d-dd6b-408a-8d5d-9f1cc787efbb", + "innerHtml": "<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Quisque vel.</p>" + }] +} +``` |
v1.0 | Verticalsection Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/verticalsection-update.md | + + Title: 'Update verticalSection' +description: "Update the properties of a verticalSection object." ++ms.localizationpriority: medium ++# Update verticalSection ++Namespace: microsoft.graph ++Update the properties of a [verticalSection](../resources/verticalSection.md) object. ++If the vertical section does not exist, this method returns a `404 NotFound` response code. ++## 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": "verticalsection_update" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +PATCH /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/verticalSection +``` ++## 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 [verticalSection](../resources/verticalSection.md) resource to update. ++## Response ++If successful, this method returns a `200 OK` response code and an updated [verticalSection](../resources/verticalSection.md) object in the response body. ++If the vertical section does not exist, this method returns a `404 NotFound` response code. ++## Examples ++### Request ++The following is an example of a request. ++<!-- { "blockType": "ignored" } --> ++```http +PATCH /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/verticalSection +Content-Type: application/json ++{ + "emphasis": "strong" +} +``` ++### Response ++The following example shows the response. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "@odata.type": "microsoft.graph.verticalSection", + "truncated": true +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "emphasis": "strong", + "webparts":[ + { + "id":"20a69b85-529c-41f3-850e-c93458aa74eb", + "innerHtml":"<p>sample text in text web part</p>" + } + ] +} +``` |
v1.0 | Virtualendpoint List Auditevents | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualendpoint-list-auditevents.md | Namespace: microsoft.graph List all the [cloudPcAuditEvent](../resources/cloudpcauditevent.md) objects for the tenant. ## Permissions If successful, this method returns a `200 OK` response code and a collection of The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "list_cloudpcauditevent" The following example shows a request. ``` http GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/auditEvents ```++# [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 |
v1.0 | Virtualendpoint List Cloudpcs | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualendpoint-list-cloudpcs.md | Namespace: microsoft.graph List the [cloudPC](../resources/cloudpc.md) devices in a tenant. + ## 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). The following example shows how to get a list of all [cloudPC](../resources/clou The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "list_cloudpcs" The following example shows a request. GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/cloudPCs ``` +# [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. The following example shows how to use the `$top` query parameter to get the top The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "list_cloudpcs_with_top_query" The following example shows a request. GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/cloudPCs?$top=2 ``` +# [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. |
v1.0 | Virtualendpoint List Deviceimages | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualendpoint-list-deviceimages.md | Namespace: microsoft.graph List the properties and relationships of [cloudPcDeviceImage](../resources/cloudpcdeviceimage.md) objects (operating system images) uploaded to Cloud PC. + ## 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). If successful, this method returns a `200 OK` response code and a collection of The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "list_cloudpcdeviceimages" The following example shows a request. GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/deviceImages ``` +# [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. |
v1.0 | Virtualendpoint List Galleryimages | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualendpoint-list-galleryimages.md | Namespace: microsoft.graph List the properties and relationships of [cloudPcGalleryImage](../resources/cloudpcgalleryimage.md) objects. + ## 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). If successful, this method returns a `200 OK` response code and a collection of The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "list_cloudpcgalleryimage" The following example shows a request. GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/galleryImages ``` +# [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. |
v1.0 | Virtualendpoint List Onpremisesconnections | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualendpoint-list-onpremisesconnections.md | List properties and relationships of the [cloudPcOnPremisesConnection](../resour [!INCLUDE [on-premise-rename-note](../../includes/on-premise-rename-note.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": "virtualendpoint-list-onpremisesconnections" } --> +<!-- { "blockType": "permissions", "name": "virtualendpoint_list_onpremisesconnections" } --> [!INCLUDE [permissions-table](../includes/permissions/virtualendpoint-list-onpremisesconnections-permissions.md)] ## HTTP request If successful, this method returns a `200 OK` response code and a collection of ### Request The following example shows a request.+# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "list_cloudpconpremisesconnections" The following example shows a request. GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/onPremisesConnections ``` +# [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 |
v1.0 | Virtualendpoint List Provisioningpolicies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualendpoint-list-provisioningpolicies.md | Namespace: microsoft.graph List properties and relationships of the [cloudPcProvisioningPolicy](../resources/cloudpcprovisioningpolicy.md) objects. + ## 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). If successful, this method returns a `200 OK` response code and a collection of The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "list_cloudpcprovisioningpolicies" The following example shows a request. GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/provisioningPolicies ``` +# [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. |
v1.0 | Virtualendpoint List Usersettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualendpoint-list-usersettings.md | Namespace: microsoft.graph Get a list of [cloudPcUserSetting](../resources/cloudpcusersetting.md) objects and their properties. + ## 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). If successful, this method returns a `200 OK` response code and a collection of The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "list_cloudpcusersetting" The following example shows a request. GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/userSettings ``` +# [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. |
v1.0 | Virtualendpoint Post Deviceimages | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualendpoint-post-deviceimages.md | Namespace: microsoft.graph Create a new [cloudPcDeviceImage](../resources/cloudpcdeviceimage.md) object. Upload a custom OS image that you can later provision on Cloud PCs. + ## 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). If successful, this method returns a `201 Created` response code and a [cloudPcD The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "create_cloudpcdeviceimage_from_cloudpcdeviceimage" Content-Type: application/json } ``` +# [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. |
v1.0 | Virtualendpoint Post Onpremisesconnections | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualendpoint-post-onpremisesconnections.md | Create a new [cloudPcOnPremisesConnection](../resources/cloudpconpremisesconnect [!INCLUDE [on-premise-rename-note](../../includes/on-premise-rename-note.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": "virtualendpoint-post-onpremisesconnections" } --> +<!-- { "blockType": "permissions", "name": "virtualendpoint_post_onpremisesconnections" } --> [!INCLUDE [permissions-table](../includes/permissions/virtualendpoint-post-onpremisesconnections-permissions.md)] ## HTTP request If successful, this method returns a `201 Created` response code and a [cloudPcO The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "create_cloudpconpremisesconnection_from_cloudpconpremisesconnection" Content-Type: application/json } ``` +# [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 |
v1.0 | Virtualendpoint Post Provisioningpolicies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualendpoint-post-provisioningpolicies.md | Namespace: microsoft.graph Create a new [cloudPcProvisioningPolicy](../resources/cloudpcprovisioningpolicy.md) object. + ## 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). If successful, this method returns a `201 Created` response code and a [cloudPcP The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "create_cloudpcprovisioningpolicy_from_cloudpcprovisioningpolicy" Content-Type: application/json } ``` +# [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. |
v1.0 | Virtualendpoint Post Usersettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualendpoint-post-usersettings.md | Namespace: microsoft.graph Create a new [cloudPcUserSetting](../resources/cloudpcusersetting.md) object. + ## 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). If successful, this method returns a `201 Created` response code and a [cloudPcU The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "create_cloudpcusersetting_from_" Content-Type: application/json } ``` +# [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. |
v1.0 | Webpart Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/webpart-delete.md | + + Title: "Delete webPart" +description: "Delete a webPart object." ++ms.localizationpriority: medium +++# Delete webPart ++Namespace: microsoft.graph ++Delete a [webPart](../resources/webpart.md) object. ++## 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": "webpart_delete" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +DELETE /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/webParts/{webpart-id} +DELETE /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/verticalSection/webparts/{webpart-index} +DELETE /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/horizontalSections/{horizontal-section-id}/columns/{horizontal-section-column-id}/webparts/{webpart-index} +``` +## Request headers ++| Name | Value | Description +|:--|:|:-- +|Authorization|Bearer {token}.| Required| +| _if-match_ | etag | If this request header is included and the eTag provided does not match the current tag on the item, a `412 Precondition Failed` response is returned and the item will not be deleted. ++## Request body ++Don't supply a request body with this method. ++## Response ++If successful, this method returns a `204 No Content`. It does not return anything in the response body. ++## Example ++### Request ++The following example shows a request. ++# [HTTP](#tab/http) +<!-- { "blockType": "request", "name": "delete-webpart", "scopes": "sites.readwrite.all" } --> ++```http +DELETE https://graph.microsoft.com/v1.0/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/webParts/29c08ca7-7f16-4c97-ba05-ea8d2850fc0e +``` ++# [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. ++<!-- { "blockType": "response" } --> ++```http +HTTP/1.1 204 No Content +``` ++<!-- +{ + "type": "#page.annotation", + "description": "Delete a webpart object.", + "keywords": "", + "section": "documentation", + "tocPath": "WebParts/Delete", + "suppressions": [] +} +--> |
v1.0 | Webpart Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/webpart-get.md | + + Title: "Get webPart" +description: "Read the properties and relationships of a webPart object." ++ms.localizationpriority: medium +++# Get webPart ++Namespace: microsoft.graph ++Read the properties and relationships of a [webPart](../resources/webpart.md) object. ++## 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": "webpart_get" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +GET /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/webParts/{webpart-id} +GET /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/verticalSection/webparts/{webpart-index} +GET /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/horizontalSections/{horizontal-section-id}/columns/{horizontal-section-column-id}/webparts/{webpart-index} +``` ++## 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 [standardWebPart](../resources/standardwebpart.md) or [textWebPart](../resources/textwebpart.md) object in the response body. ++## Examples ++### Example 1: Get a webPart object +#### Request ++The following is an example of a request. ++<!-- { "blockType": "ignored" } --> ++```http +GET https://graph.microsoft.com/v1.0/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/webParts/58ce69a6-bcb0-4f35-b6cd-d757d95f1a8e +``` ++#### 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.webPart" +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": { + "@odata.type": "#microsoft.graph.textWebPart", + "id": "1212fc8d-dd6b-408a-8d5d-9f1cc787efbb", + "innerHtml": "<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Quisque vel.</p>" + } +} +``` ++### Example 2: Get a webPart object using select +#### Request ++With `$select` statement, you can retrieve selected webpart metadata in a request. ++<!-- { "blockType": "ignored" } --> ++```http +GET https://graph.microsoft.com/v1.0/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/webParts/58ce69a6-bcb0-4f35-b6cd-d757d95f1a8e?$select=id +``` ++#### 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.webPart" +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": { + "@odata.type": "#microsoft.graph.textWebPart", + "id": "1212fc8d-dd6b-408a-8d5d-9f1cc787efbb" + } +} +``` |
v1.0 | Webpart Getposition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/webpart-getposition.md | + + Title: "webPart: getPosition" +description: "Get position information of a webPart" ++ms.localizationpriority: medium +++# webPart: getPosition ++Namespace: microsoft.graph ++Get the [webPartPosition](../resources/webpartposition.md) information of a [webPart](../resources/webpart.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": "webpart_getposition" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +GET /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/webParts/{webpart-id}/getPositionOfWebPart +GET /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/verticalSection/webparts/{webpart-index}/getPositionOfWebPart +GET /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/horizontalSections/{horizontal-section-id}/columns/{horizontal-section-column-id}/webparts/{webpart-index}/getPositionOfWebPart +``` ++## 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 [webPartPosition](../resources/webpartposition.md) object in the response body. ++## Examples ++### Request ++The following is an example of a request. ++<!-- { "blockType": "ignored" } --> ++```http +GET https://graph.microsoft.com/v1.0/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/webParts/a3c93a28-806d-4f1a-b4fc-404848b935f6/getPositionOfWebPart +``` ++### 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.webPartPosition" +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "columnId": 1.0, + "horizontalSectionId": 1.0, + "isInVerticalSection": false, + "webpartIndex": 1.0 +} +``` |
v1.0 | Webpart List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/webpart-list.md | + + Title: "List webparts" +description: "Get the webPart collection from a sitePage." ++ms.localizationpriority: medium +++# List webparts ++Namespace: microsoft.graph ++Get the [webPart](../resources/webpart.md) resources from a [sitePage](../resources/sitepage.md). Sort by the order in which they appear on the page. ++## 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": "webpart_list" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +GET /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/webparts +GET /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/horizontalSections/{horizontal-section-id}/columns/{horizontal-section-column-id}/webparts +GET /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/verticalSection/webparts +``` ++## 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 [webPart](../resources/webpart.md) objects in the response body. ++## Examples ++### Request ++The following is an example of a request. ++<!-- { "blockType": "ignored" } --> ++```http +GET https://graph.microsoft.com/v1.0/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/canvasLayout/horizontalSections/1/columns/1/webparts +``` ++### 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.webPart)" +} +--> ++```http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "@odata.type": "#microsoft.graph.textWebPart", + "id": "d79d70af-27ea-4208-8dce-23c3bf678664", + "innerHtml": "<h2>How do you get started?</h2>" + }, + { + "@odata.type": "#microsoft.graph.standardWebPart", + "id": "6346d908-f20d-4528-902f-3c2a9c8c2442", + "webPartType": "d1d91016-032f-456d-98a4-721247c305e8", + "data": { + "audiences": [], + "dataVersion": "1.9", + "description": "Show an image on your page", + "title": "Image", + "properties": { + "imageSourceType": 2, + "altText": "", + "overlayText": "", + "siteid": "0264cabe-6b92-450a-b162-b0c3d54fe5e8", + "webid": "f3989670-cd37-4514-8ccb-0f7c2cbe5314", + "listid": "bdb41041-eb06-474e-ac29-87093386bb14", + "uniqueid": "d9f94b40-78ba-48d0-a39f-3cb23c2fe7eb", + "imgWidth": 4288, + "imgHeight": 2848, + "fixAspectRatio": false, + "captionText": "", + "alignment": "Center" + }, + "serverProcessedContent": { + "htmlStrings": [], + "links": [], + "searchablePlainTexts": [], + "imageSources": [ + { + "@odata.type": "#microsoft.graph.metaDataKeyStringPair", + "key": "imageSource", + "value": "/_LAYOUTS/IMAGES/VISUALTEMPLATEIMAGE1.JPG" + } + ] + } + } + } + ] +} +``` |
v1.0 | Webpart Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/webpart-update.md | + + Title: "Update webPart" +description: "Update the properties of a webPart." ++ms.localizationpriority: medium +++# Update webPart ++Namespace: microsoft.graph ++Update the properties of a [webPart](../resources/webpart.md) object. ++## 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": "webpart_update" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> ++```http +PATCH /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/webParts/{webpart-id} +PATCH /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/verticalSection/webparts/{webpart-index} +PATCH /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/horizontalSections/{horizontal-section-id}/columns/{horizontal-section-column-id}/webparts/{webpart-index} +``` ++## 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 [textWebPart](../resources/textWebPart.md) or [standardWebPart](../resources/standardWebPart.md). ++To ensure successful parsing of the request body, the `@odata.type=#microsoft.graph.textwebpart` or `@odata.type=#microsoft.graph.standardwebpart` must be included in the request body. ++### Supported web parts ++There are two kinds of web parts that can be added to a [sitePage](../resources/sitepage.md): [standardWebPart](../resources/standardWebPart.md) and [textWebPart](../resources/textWebPart.md). ++For [standardWebPart](../resources/standardWebPart.md), only the following are supported when updating using the Microsoft Graph API. Attempting to add unsupported web parts will result in a failure or exception. ++| # | Web Part | Type | +| | -- | -- | +| 1 | Bing Maps | `e377ea37-9047-43b9-8cdb-a761be2f8e09` | +| 2 | Button | `0f087d7f-520e-42b7-89c0-496aaf979d58` | +| 3 | Call To Action | `df8e44e7-edd5-46d5-90da-aca1539313b8` | +| 4 | Divider | `2161a1c6-db61-4731-b97c-3cdb303f7cbb` | +| 5 | Document Embed | `b7dd04e1-19ce-4b24-9132-b60a1c2b910d` | +| 6 | Image | `d1d91016-032f-456d-98a4-721247c305e8` | +| 7 | Image Gallery | `af8be689-990e-492a-81f7-ba3e4cd3ed9c` | +| 8 | Link Preview | `6410b3b6-d440-4663-8744-378976dc041e` | +| 9 | Org Chart | `e84a8ca2-f63c-4fb9-bc0b-d8eef5ccb22b` | +| 10 | People | `7f718435-ee4d-431c-bdbf-9c4ff326f46e` | +| 11 | Quick Links | `c70391ea-0b10-4ee9-b2b4-006d3fcad0cd` | +| 12 | Spacer | `8654b779-4886-46d4-8ffb-b5ed960ee986` | +| 13 | Youtube Embed | `544dd15b-cf3c-441b-96da-004d5a8cea1d` | ++## Response ++If successful, this method returns a `200 OK` response code and an updated [webPart](../resources/webpart.md) object in the response body. ++## Example ++### Request ++The following example shows how to update a webpart. ++<!-- { "blockType": "ignored" } --> ++```http +PATCH /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/webParts/c867fd9e-4c1e-43ec-a448-9760c9fff589 +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.textWebPart", + "innerHtml": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus blandit pellentesque ipsum tempor porta. Phasellus tincidunt et ipsum nec iaculis. Sed eu arcu tristique, congue erat a, consequat lorem. Suspendisse ac ullamcorper elit. Sed ultricies, risus sed hendrerit dictum, nunc massa ornare velit, a pharetra dolor urna quis lorem. Maecenas eget pellentesque purus, nec ultricies risus. Donec rhoncus lorem at euismod varius. Donec auctor sed mi vitae pharetra. Aenean id tempor mauris. Donec dui nulla, semper ut elit id, mattis commodo arcu. Aliquam erat volutpat." +} +``` ++### Response ++If successful, this method returns a [webPart][] in the response body for the updated webpart. ++<!-- { "blockType": "response", "@odata.type": "microsoft.graph.webPart", "truncated": true } --> ++```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "@odata.type": "#microsoft.graph.textWebPart", + "id": "51053496-e6f3-4161-94ac-07bdf4d92226", + "innerHtml": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus blandit pellentesque ipsum tempor porta. Phasellus tincidunt et ipsum nec iaculis. Sed eu arcu tristique, congue erat a, consequat lorem. Suspendisse ac ullamcorper elit. Sed ultricies, risus sed hendrerit dictum, nunc massa ornare velit, a pharetra dolor urna quis lorem. Maecenas eget pellentesque purus, nec ultricies risus. Donec rhoncus lorem at euismod varius. Donec auctor sed mi vitae pharetra. Aenean id tempor mauris. Donec dui nulla, semper ut elit id, mattis commodo arcu. Aliquam erat volutpat." +} +``` ++[webPart]: ../resources/webPart.md ++<!-- +{ + "type": "#webpart.annotation", + "description": "Update a WebPart.", + "keywords": "", + "section": "documentation", + "tocPath": "WebParts/Update", + "suppressions": [] +} +--> |
v1.0 | Windowssetting Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/windowssetting-get.md | Namespace: microsoft.graph Read the properties and relationships of a [windowsSetting](../resources/windowssetting.md) object by passing the ID of the setting in the URL. This method gets the setting for the signed-in 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). GET https://graph.microsoft.com/v1.0/me/settings/windows/{windowsSettingId} [!INCLUDE [sample-code](../includes/snippets/php/get-windowssetting-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-windowssetting-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Windowssetting List Instances | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/windowssetting-list-instances.md | Namespace: microsoft.graph Get a list of [windowsSettingInstance](../resources/windowssettinginstance.md) objects and their properties for the signed-in 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). GET https://graph.microsoft.com/v1.0/me/settings/windows/{windowsSettingId}/inst [!INCLUDE [sample-code](../includes/snippets/php/list-windowssettinginstance-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-windowssettinginstance-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Windowssettinginstance Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/windowssettinginstance-get.md | Namespace: microsoft.graph Read the properties and relationships of a [windowsSettingInstance](../resources/windowssettinginstance.md) object by passing the Windows setting ID and Windows setting instance ID in the URL. This method gets a **windowsSettingInstance** for the signed-in 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). GET https://graph.microsoft.com/v1.0/me/settings/windows/{windowsSettingId}/inst [!INCLUDE [sample-code](../includes/snippets/php/get-windowssettinginstance-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-windowssettinginstance-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Link Validation Config.Json | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/config/link-validation-config.json | a/api-reference/v1.0/config/link-validation-config.json "/partner-center", "/powershell", "/previous-versions", - "/purview", + "/purview", "/rest", "/security", "/skypeforbusiness", |
v1.0 | Accesspackage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accesspackage.md | Each access package is referenced by a single access package catalog, and has li |resourceRoleScopes| [accessPackageResourceRoleScope](accesspackageresourcerolescope.md) collection | The resource roles and scopes in this access package. | ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Accesspackageapprovalstage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accesspackageapprovalstage.md | Used for the **stages** property of [approval settings](accesspackageassignmenta |fallbackPrimaryApprovers|[subjectSet](../resources/subjectset.md) collection|The subjects, typically users, who are the fallback primary approvers.| |isApproverJustificationRequired|Boolean|Indicates whether the approver is required to provide a justification for approving a request.| |isEscalationEnabled|Boolean|If `true`, then one or more **escalationApprovers** are configured in this approval stage.|-|primaryApprovers|[subjectSet](../resources/subjectset.md) collection|The subjects, typically users, who will be asked to approve requests. A collection of [singleUser](singleuser.md), [groupMembers](groupmembers.md), [requestorManager](requestormanager.md), [internalSponsors](internalsponsors.md) or [externalSponsors](externalsponsors.md).| +|primaryApprovers|[subjectSet](../resources/subjectset.md) collection|The subjects, typically users, who will be asked to approve requests. A collection of [singleUser](singleuser.md), [groupMembers](groupmembers.md), [requestorManager](requestormanager.md), [internalSponsors](internalsponsors.md), [externalSponsors](externalsponsors.md), or [targetUserSponsors](targetusersponsors.md).| ## Relationships None. |
v1.0 | Accesspackageassignmentapprovalsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accesspackageassignmentapprovalsettings.md | Used for the **requestApprovalSettings** property of an [access package assignme ## Relationships None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.accessPackageAssignmentApprovalSettings" |
v1.0 | Accesspackageassignmentrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accesspackageassignmentrequest.md | In [Microsoft Entra Entitlement Management](entitlementmanagement-overview.md), |requestor|[accessPackageSubject](../resources/accesspackagesubject.md)|The subject who requested or, if a direct assignment, was assigned. Read-only. Nullable. Supports `$expand`.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Accesspackageassignmentrequestcallbackdata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accesspackageassignmentrequestcallbackdata.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.accessPackageAssignmentRequestCallbackData" |
v1.0 | Accesspackageassignmentrequestorsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accesspackageassignmentrequestorsettings.md | Provides additional settings to select who can create a request for an access pa ## Relationships None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.accessPackageAssignmentRequestorSettings" |
v1.0 | Accesspackageassignmentworkflowextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accesspackageassignmentworkflowextension.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Accesspackageresourcescope | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accesspackageresourcescope.md | If the resource is in an access package catalog but hasn't yet had its roles add ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Accesspackagesubject | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accesspackagesubject.md | None. |connectedOrganization|[connectedOrganization](connectedorganization.md)|The connected organization of the subject. Read-only. Nullable.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Accesspackagetextinputquestion | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accesspackagetextinputquestion.md | Inherits from [accessPackageQuestion](../resources/accesspackagequestion.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.accessPackageTextInputQuestion" |
v1.0 | Accessreviewapplyaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accessreviewapplyaction.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.accessReviewApplyAction" |
v1.0 | Accessreviewhistorydefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accessreviewhistorydefinition.md | An **accessReviewHistoryDefinition** contains a list of [accessReviewHistoryInst ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Accessreviewhistoryinstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accessreviewhistoryinstance.md | Namespace: microsoft.graph ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Accessreviewhistoryschedulesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accessreviewhistoryschedulesettings.md | Defines the settings of an [accessReviewHistoryDefinition](accessreviewhistoryde ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.accessReviewHistoryScheduleSettings" |
v1.0 | Accessreviewinstance | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accessreviewinstance.md | Inherits from [entity](../resources/entity.md). ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Accessreviewinstancedecisionitemresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accessreviewinstancedecisionitemresource.md | Every decision item in an access review represents a principal's access to a res None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.accessReviewInstanceDecisionItemResource" |
v1.0 | Accessreviewnotificationrecipientscope | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accessreviewnotificationrecipientscope.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.accessReviewNotificationRecipientScope" |
v1.0 | Accessreviewscheduledefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accessreviewscheduledefinition.md | An accessReviewScheduleDefinition contains a list of [accessReviewInstance](acce | instances|[accessReviewInstance](accessreviewinstance.md) collection | If the **accessReviewScheduleDefinition** is a recurring access review, instances represent each recurrence. A review that doesn't recur will have exactly one instance. Instances also represent each unique resource under review in the **accessReviewScheduleDefinition**. If a review has multiple resources and multiple instances, each resource has a unique instance for each recurrence. | ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Accessreviewstage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accessreviewstage.md | Every **accessReviewStage** contains a list of [decision items](accessreviewinst |decisions|[accessReviewInstanceDecisionItem](../resources/accessreviewinstancedecisionitem.md) collection|Each user reviewed in an accessReviewStage has a decision item representing if they were approved, denied, or not yet reviewed.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Activitybasedtimeoutpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/activitybasedtimeoutpolicy.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Addin | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/addin.md | Title: "addIn resource type" -description: "Here's a JSON representation of the resource." +description: "The following JSON representation shows the resource type." ms.localizationpriority: medium doc_type: resourcePageType Defines custom behavior that a consuming service can use to call an app in speci ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Administrativeunit | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/administrativeunit.md | doc_type: resourcePageType Namespace: microsoft.graph -An administrative unit provides a conceptual container for user, group, and device directory objects. Using administrative units, a company administrator can now delegate administrative responsibilities to manage the users, groups, and devices contained within or scoped to an administrative unit to a regional or departmental administrator. This resource is an open type that allows other properties to be passed in. +An administrative unit provides a conceptual container for user, group, and device directory objects. With administrative units, a company administrator can now delegate administrative responsibilities to manage the users, groups, and devices contained within or scoped to an administrative unit to a regional or departmental administrator. For more information about administrative units, see [Administrative units in Microsoft Entra ID](/entra/identity/role-based-access-control/administrative-units). -Let's look at an example. Imagine that Contoso Corp is made up of two divisions - a West Coast Division and an East Coast Division. Directory roles at Contoso are scoped to the entire tenant. Lee, a Contoso company administrator, wants to delegate administrative responsibilities, but scope them to the West Coast Division or the East Coast division. Lee can create a *West Coast administrative unit* and place all West Coast users into this administrative unit. Similarly, Lee can create an *East Coast administrative unit*. Now Lee, can start delegating administrative responsibilities to others, but **scoped** to the new administrative units they created. Lee places Jennifer in a *helpdesk administrator* role **scoped** to the *West Coast administrative unit*. This allows Jennifer to reset any user's password, but only if those users are in the *West Coast administrative unit*. Similarly, Lee places Dave in a *user account administrator* role **scoped** to the *East Coast administrative unit*. This allows Dave to update users, assign licenses and reset any user's password, but only if those users are in the *East Coast administrative unit*. For a video overview, please see [Introduction to Microsoft Entra Administrative Units](https://channel9.msdn.com/Series/Windows-Azure-Active-Directory/Introduction-to-Azure-Active-Directory-Administrative-Units). +This resource is an open type that allows other properties to be passed in. This resource supports: This resource supports: |[Create](../api/directory-post-administrativeunits.md) | [administrativeUnit](administrativeunit.md) | Create a new administrative unit.| |[List](../api/directory-list-administrativeunits.md) | [administrativeUnit](administrativeunit.md) collection |List properties of all administrativeUnits.| |[Get](../api/administrativeunit-get.md) | [administrativeUnit](administrativeunit.md) |Read properties and relationships of a specific administrativeUnit object.|-|[Update](../api/administrativeunit-update.md) | [administrativeUnit](administrativeunit.md) |Update administrativeUnit object. | +|[Update](../api/administrativeunit-update.md) | [administrativeUnit](administrativeunit.md) |Update administrativeUnit object. | |[Delete](../api/administrativeunit-delete.md) | None |Delete administrativeUnit object. | |[Add a member](../api/administrativeunit-post-members.md) |[directoryObject](directoryobject.md)| Add a member (user, group, or device).| |[List members](../api/administrativeunit-list-members.md) |[directoryObject](directoryobject.md) collection| Get the list of (user, group, or device) members.| This resource supports: > [!IMPORTANT] > Specific usage of `$filter` and the `$search` query parameter is supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on directory objects](/graph/aad-advanced-queries#administrative-unit-properties). -| Property | Type |Description| +| Property | Type |Description| |:|:--|:-| |description|String|An optional description for the administrative unit. Supports `$filter` (`eq`, `ne`, `in`, `startsWith`), `$search`.| |displayName|String|Display name for the administrative unit. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values), `$search`, and `$orderby`.| This resource supports: > Directory extensions and associated data are returned by default while schema extensions and associated data returned only on `$select`. ## Relationships-| Relationship | Type |Description| +| Relationship | Type |Description| |:|:--|:-| |members|[directoryObject](directoryobject.md) collection|Users and groups that are members of this administrative unit. Supports `$expand`.| |extensions|[extension](extension.md) collection|The collection of open extensions defined for this administrative unit. Nullable.| This resource supports: ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Agreementfile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/agreementfile.md | Inherits from [agreementFileProperties](agreementfileproperties.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Agreementfilelocalization | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/agreementfilelocalization.md | Inherits from [agreementFileProperties](agreementfileproperties.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Agreementfileversion | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/agreementfileversion.md | Inherits from [agreementFileProperties](agreementfileproperties.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Alert | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/alert.md | Title: "alert resource type" + Title: "alert resource type (deprecated)" description: "Represents potential security issues within a customer's tenant that Microsoft or partner security solutions have identified." ms.localizationpriority: high -# alert resource type +# alert resource type (deprecated) Namespace: microsoft.graph -This resource corresponds to the first generation of alerts in the Microsoft Graph security API, representing potential security issues within a customer's tenant that Microsoft or a partner security solution has identified. +> [!NOTE] +> The legacy alerts API is deprecated and will be removed by April 2026. We recommend that you migrate to the new [alerts and incidents](/graph/api/resources/security-alert) API. ++This resource corresponds to the first generation of alerts in the Microsoft Graph security API, representing potential security issues within a customer's tenant that Microsoft or a partner security solution identifies. This type of alerts federates calling of supported Azure and Microsoft 365 Defender security providers listed in [Use the Microsoft Graph security API](security-api-overview.md#legacy-alerts). It aggregates common alert data among the different domains to allow applications to unify and streamline management of security issues across all integrated solutions. To learn more, see the sample queries in [Graph Explorer](https://developer.micr | assignedTo | String | Name of the analyst the alert is assigned to for triage, investigation, or remediation (supports [update](../api/alert-update.md)). | | azureSubscriptionId | String | Azure subscription ID, present if this alert is related to an Azure resource. | | azureTenantId | String | Microsoft Entra tenant ID. Required. |-| category | String | Category of the alert (for example, credentialTheft, ransomware, etc.). | +| category | String | Category of the alert (for example, credentialTheft, ransomware). | | closedDateTime | DateTimeOffset | Time at which the alert was closed. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z` (supports [update](../api/alert-update.md)). | | cloudAppStates | [cloudAppSecurityState](cloudappsecuritystate.md) collection | Security-related stateful information generated by the provider about the cloud application/s related to this alert. | | comments | String collection | Customer-provided comments on alert (for customer alert management) (supports [update](../api/alert-update.md)). | To learn more, see the sample queries in [Graph Explorer](https://developer.micr | createdDateTime | DateTimeOffset | Time at which the alert was created by the alert provider. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Required. | | description | String | Alert description. | | detectionIds | String collection | Set of alerts related to this alert entity (each alert is pushed to the SIEM as a separate record). |-| eventDateTime | DateTimeOffset | Time at which the event(s) that served as the trigger(s) to generate the alert occurred. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Required. | -| feedback | alertFeedback | Analyst feedback on the alert. Possible values are: `unknown`, `truePositive`, `falsePositive`, `benignPositive`. (supports [update](../api/alert-update.md)) | +| eventDateTime | DateTimeOffset | Time at which the event or events that served as the trigger to generate the alert occurred. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Required. | +| feedback | alertFeedback | Analyst feedback on the alert. Possible values are: `unknown`, `truePositive`, `falsePositive`, `benignPositive`. Supports [update](../api/alert-update.md). | | | fileStates | [fileSecurityState](filesecuritystate.md) collection | Security-related stateful information generated by the provider about the file(s) related to this alert. | | hostStates | [hostSecurityState](hostsecuritystate.md) collection | Security-related stateful information generated by the provider about the host(s) related to this alert. | | id | String | Provider-generated GUID/unique identifier. Read-only. Required. | To learn more, see the sample queries in [Graph Explorer](https://developer.micr | registryKeyStates | [registryKeyState](registrykeystate.md) collection | Security-related stateful information generated by the provider about the registry keys related to this alert. | | securityResources | [securityResource](securityResource.md) collection | Resources related to current alert. For example, for some alerts this can have the Azure Resource value. | | severity | alertSeverity | Alert severity - set by vendor/provider. Possible values are: `unknown`, `informational`, `low`, `medium`, `high`. Required. |-| sourceMaterials | String collection | Hyperlinks (URIs) to the source material related to the alert, for example, provider's user interface for alerts or log search, etc. | +| sourceMaterials | String collection | Hyperlinks (URIs) to the source material related to the alert, for example, provider's user interface for alerts or log search. | | status | alertStatus | Alert lifecycle status (stage). Possible values are: `unknown`, `newAlert`, `inProgress`, `resolved`. (supports [update](../api/alert-update.md)). Required. |-| tags | String collection | User-definable labels that can be applied to an alert and can serve as filter conditions (for example "HVA", "SAW", etc.) (supports [update](../api/alert-update.md)). | +| tags | String collection | User-definable labels that can be applied to an alert and can serve as filter conditions (for example "HVA", "SAW") (supports [update](../api/alert-update.md)). | | title | String | Alert title. Required. | | triggers | [alertTrigger](alerttrigger.md) collection | Security-related information about the specific properties that triggered the alert (properties appearing in the alert). Alerts might contain information about multiple users, hosts, files, ip addresses. This field indicates which properties triggered the alert generation. | | userStates | [userSecurityState](usersecuritystate.md) collection | Security-related stateful information generated by the provider about the user accounts related to this alert. | None. ## JSON representation -The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Allowedvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/allowedvalue.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Anonymousguestconversationmember | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/anonymousguestconversationmember.md | Inherits from [conversationMember](../resources/conversationmember.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Apiapplication | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/apiapplication.md | Specifies settings for an application that implements a web API. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Appidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/appidentity.md | Indicates the identity of the application that performed the action or was chang ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Applemanagedidentityprovider | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/applemanagedidentityprovider.md | Retrieve the **developerId**, **serviceId**, **keyId**, and the **certificateDat ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Application | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/application.md | This resource supports: |[Create application](../api/application-post-applications.md) | [application](application.md) | Creates (registers) a new application.| |[Get application](../api/application-get.md) | [application](application.md) |Read properties and relationships of application object.| |[Update application](../api/application-update.md) | None |Update application object. |+|[Upsert application](../api/application-upsert.md) | [application](application.md) | Create a new application if it doesn't exist, or update the properties of an existing application.| |[Delete application](../api/application-delete.md) | None |Delete application object. | |[Get delta](../api/application-delta.md)|[application](application.md)|Get newly created, updated, or deleted applications without performing a full read of the entire resource collection.| |[List deleted applications](../api/directory-deleteditems-list.md) | [directoryObject](directoryobject.md) collection | Retrieve a list of recently deleted applications. | This resource supports: |[Remove password](../api/application-removepassword.md)|[passwordCredential](passwordcredential.md)|Remove a password from an application.| |[Add key](../api/application-addkey.md)|[keyCredential](keycredential.md)|Add a key credential to an application.| |[Remove key](../api/application-removekey.md)|None|Remove a key credential from an application.|-|**Extensions**| | | -| [List extensionProperties](../api/application-list-extensionproperty.md) | [extensionProperty](extensionProperty.md) collection | List extension properties on an application object. | -| [Create extensionProperties](../api/application-post-extensionproperty.md) | [extensionProperty](extensionProperty.md) | Create an extension property on an application object. | -| [Get extensionProperty](../api/extensionproperty-delete.md) | None | Get an extension property from an application object. | -| [Delete extensionProperty](../api/extensionproperty-delete.md) | None | Delete an extension property from an application object. | -|[Get available extension properties](../api/directoryobject-getavailableextensionproperties.md)|[extensionProperty](../resources/extensionproperty.md) collection|Get all or a filtered list of the directory extension properties that are registered in a directory.| -|**Federated identity credentials**| | | -| [List federatedIdentityCredential](../api/application-list-federatedidentitycredentials.md) | [federatedIdentityCredential](../resources/federatedidentitycredential.md) collection | List federated identity credentials on an application object. | -| [Create federatedIdentityCredential](../api/application-post-federatedidentitycredentials.md) | [federatedIdentityCredential](../resources/federatedidentitycredential.md) | Create a federated identity credential on an application object. | -| [Get federatedIdentityCredential](../api/federatedidentitycredential-get.md) | [federatedIdentityCredential](../resources/federatedidentitycredential.md) | Retrieve the properties of a federated identity credential. | -| [Update federatedIdentityCredential](../api/federatedidentitycredential-update.md) | None | Update a federated identity credential of an application object. | -| [Delete federatedIdentityCredential](../api/federatedidentitycredential-delete.md) | None | Delete a federated identity credential from an application object. | |**Owners**| | | |[List owners](../api/application-list-owners.md) |[directoryObject](directoryobject.md) collection| Get the owners of an application.| |[Add owner](../api/application-post-owners.md) |[directoryObject](directoryobject.md)| Assign an owner to an application. Application owners can be users or service principals.| |[Remove owner](../api/application-delete-owners.md) |None| Remove an owner from an application. As a recommended best practice, apps should have at least two owners.|-|**Policies**| | | -|[Assign tokenIssuancePolicy](../api/application-post-tokenissuancepolicies.md)| [tokenIssuancePolicy](tokenissuancepolicy.md) collection| Assign a tokenIssuancePolicy to this object.| -|[List tokenIssuancePolicies](../api/application-list-tokenissuancepolicies.md)| [tokenIssuancePolicy](tokenissuancepolicy.md) collection| Get all tokenIssuancePolicies assigned to this object.| -|[Remove tokenIssuancePolicy](../api/application-delete-tokenissuancepolicies.md)| [tokenIssuancePolicy](tokenissuancepolicy.md) collection| Remove a tokenIssuancePolicy from this object.| -|[Assign tokenLifetimePolicy](../api/application-post-tokenlifetimepolicies.md)| [tokenLifetimePolicy](tokenlifetimepolicy.md) collection| Assign a tokenLifetimePolicy to this object.| -|[List tokenLifetimePolicies](../api/application-list-tokenlifetimepolicies.md)| [tokenLifetimePolicy](tokenlifetimepolicy.md) collection| Get all tokenLifetimePolicies assigned to this object.| -|[Remove tokenLifetimePolicy](../api/application-delete-tokenlifetimepolicies.md)| [tokenLifetimePolicy](tokenlifetimepolicy.md) collection| Remove a tokenLifetimePolicy from this object.| |**Verified publisher**| | | |[Set verified publisher](../api/application-setverifiedpublisher.md)| None | Set the verified publisher of an application.| |[Unset verified publisher](../api/application-unsetverifiedpublisher.md)| None | Unset the verified publisher of an application.| This resource supports: | displayName | String | The display name for the application. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values), `$search`, and `$orderby`. | | groupMembershipClaims | String | Configures the `groups` claim issued in a user or OAuth 2.0 access token that the application expects. To set this attribute, use one of the following valid string values: `None`, `SecurityGroup` (for security groups and Microsoft Entra roles), `All` (this gets all of the security groups, distribution groups, and Microsoft Entra directory roles that the signed-in user is a member of). | | id | String | Unique identifier for the application object. This property is referred to as **Object ID** in the Microsoft Entra admin center. Inherited from [directoryObject](directoryobject.md). Key. Not nullable. Read-only. Supports `$filter` (`eq`, `ne`, `not`, `in`).|-| identifierUris | String collection | Also known as App ID URI, this value is set when an application is used as a resource app. The identifierUris acts as the prefix for the scopes you reference in your API's code, and it must be globally unique. You can use the default value provided, which is in the form `api://<application-client-id>`, or specify a more readable URI like `https://contoso.com/api`. For more information on valid identifierUris patterns and best practices, see [Microsoft Entra application registration security best practices](/azure/active-directory/develop/security-best-practices-for-app-registration#appid-uri-configuration). Not nullable. <br><br>Supports `$filter` (`eq`, `ne`, `ge`, `le`, `startsWith`).| +| identifierUris | String collection | Also known as App ID URI, this value is set when an application is used as a resource app. The identifierUris acts as the prefix for the scopes you reference in your API's code, and it must be globally unique. You can use the default value provided, which is in the form `api://<appId>`, or specify a more readable URI like `https://contoso.com/api`. For more information on valid identifierUris patterns and best practices, see [Microsoft Entra application registration security best practices](/azure/active-directory/develop/security-best-practices-for-app-registration#appid-uri-configuration). Not nullable. <br><br>Supports `$filter` (`eq`, `ne`, `ge`, `le`, `startsWith`).| | info | [informationalUrl](informationalurl.md) | Basic profile information of the application such as app's marketing, support, terms of service and privacy statement URLs. The terms of service and privacy statement are surfaced to users through the user consent experience. For more info, see How to: [Add Terms of service and privacy statement for registered Microsoft Entra apps](/azure/active-directory/develop/howto-add-terms-of-service-privacy-statement). <br><br>Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, and `eq` on `null` values). | | isDeviceOnlyAuthSupported | Boolean | Specifies whether this application supports device authentication without a user. The default is `false`. | | isFallbackPublicClient | Boolean | Specifies the fallback application type as public client, such as an installed application running on a mobile device. The default value is `false`, which means the fallback application type is confidential client such as a web app. There are certain scenarios where Microsoft Entra ID can't determine the client application type. For example, the [ROPC](https://tools.ietf.org/html/rfc6749#section-4.3) flow where it's configured without specifying a redirect URI. In those cases, Microsoft Entra ID interprets the application type based on the value of this property.| This resource supports: | samlMetadataUrl | String | The URL where the service exposes SAML metadata for federation. This property is valid only for single-tenant applications. Nullable. | | serviceManagementReference | String | References application or service contact information from a Service or Asset Management database. Nullable. | | servicePrincipalLockConfiguration | [servicePrincipalLockConfiguration](servicePrincipalLockConfiguration.md) | Specifies whether sensitive properties of a multitenant application should be locked for editing after the application is provisioned in a tenant. Nullable. `null` by default. |-| signInAudience | String | Specifies the Microsoft accounts that are supported for the current application. The possible values are: `AzureADMyOrg`, `AzureADMultipleOrgs`, `AzureADandPersonalMicrosoftAccount` (default), and `PersonalMicrosoftAccount`. See more in the [table](#signinaudience-values). <br/><br/>The value of this object also limits the number of permissions an app can request. For more information, see [Limits on requested permissions per app](#limits-on-requested-permissions-per-app). <br><br>The value for this property has implications on other app object properties. As a result, if you change this property, you might need to change other properties first. For more information, see [Validation differences for signInAudience](/azure/active-directory/develop/supported-accounts-validation?context=graph/context).<br><br>Supports `$filter` (`eq`, `ne`, `not`).| +| signInAudience | String | Specifies the Microsoft accounts that are supported for the current application. The possible values are: `AzureADMyOrg` (default), `AzureADMultipleOrgs`, `AzureADandPersonalMicrosoftAccount`, and `PersonalMicrosoftAccount`. See more in the [table](#signinaudience-values). <br/><br/>The value of this object also limits the number of permissions an app can request. For more information, see [Limits on requested permissions per app](#limits-on-requested-permissions-per-app). <br><br>The value for this property has implications on other app object properties. As a result, if you change this property, you might need to change other properties first. For more information, see [Validation differences for signInAudience](/azure/active-directory/develop/supported-accounts-validation?context=graph/context).<br><br>Supports `$filter` (`eq`, `ne`, `not`).| | spa | [spaApplication](../resources/spaapplication.md) | Specifies settings for a single-page application, including sign out URLs and redirect URIs for authorization codes and access tokens. | | tags |String collection| Custom strings that can be used to categorize and identify the application. Not nullable. Strings added here will also appear in the **tags** property of any associated [service principals](serviceprincipal.md).<br><br>Supports `$filter` (`eq`, `not`, `ge`, `le`, `startsWith`) and `$search`.| | tokenEncryptionKeyId |String|Specifies the keyId of a public key from the keyCredentials collection. When configured, Microsoft Entra ID encrypts all the tokens it emits by using the key this property points to. The application code that receives the encrypted token must use the matching private key to decrypt the token before it can be used for the signed-in user.|+| uniqueName | String | The unique identifier that can be assigned to an application and used as an alternate key. Immutable. Read-only. | | verifiedPublisher | [verifiedPublisher](verifiedPublisher.md) | Specifies the verified publisher of the application. For more information about how publisher verification helps support application security, trustworthiness, and compliance, see [Publisher verification](/azure/active-directory/develop/publisher-verification-overview).| | web |[webApplication](webapplication.md)| Specifies settings for a web application. | This resource supports: | Value | Description | |:|:--|-|AzureADMyOrg|Users with a Microsoft work or school account in my organization's Microsoft Entra tenant (single tenant).| +|AzureADMyOrg|Users with a Microsoft work or school account in my organization's Microsoft Entra tenant (single tenant). This is the default value for the **signInAudience** property. | |AzureADMultipleOrgs|Users with a Microsoft work or school account in any organization's Microsoft Entra tenant (multitenant).|-|AzureADandPersonalMicrosoftAccount|Users with a personal Microsoft account, or a work or school account in any organization's Microsoft Entra tenant. For authenticating users with Azure AD B2C user flows, use `AzureADandPersonalMicrosoftAccount`. This value allows for the widest set of user identities including local accounts and user identities from Microsoft, Facebook, Google, Twitter, or any OpenID Connect provider. This is the default value for the **signInAudience** property. | +|AzureADandPersonalMicrosoftAccount|Users with a personal Microsoft account, or a work or school account in any organization's Microsoft Entra tenant. For authenticating users with Azure AD B2C user flows, use `AzureADandPersonalMicrosoftAccount`. This value allows for the widest set of user identities including local accounts and user identities from Microsoft, Facebook, Google, Twitter, or any OpenID Connect provider. | |PersonalMicrosoftAccount|Users with a personal Microsoft account only.| The following JSON representation shows the resource type. "spa": {"@odata.type": "microsoft.graph.spaApplication"}, "tags": ["String"], "tokenEncryptionKeyId": "String",+ "uniqueName": "String", "verifiedPublisher": {"@odata.type": "microsoft.graph.verifiedPublisher"}, "web": {"@odata.type": "microsoft.graph.webApplication"} } |
v1.0 | Applicationauthenticationmethodpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/applicationauthenticationmethodpolicy.md | Depending on whether your app is a single tenant or multitenant app, you apply t ## Requirements -- Management of application authentication method policies can be performed by a global administrator, application administrator, or cloud application administrator.+- The least privileged Microsoft Entra roles for the management of application authentication method policies are Application Administrator and Cloud Application Administrator. - All app policy management operations require a [Microsoft Entra Workload ID Premium license](/azure/active-directory/workload-identities/workload-identities-faqs#what-is-the-cost-of-workload-identities-premium-plan). ## Next steps |
v1.0 | Applications Api Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/applications-api-overview.md | description: "Learn how to manage the lifecycle and settings for Microsoft Entra Last updated : 04/05/2024 ms.localizationpriority: medium |
v1.0 | Applicationserviceprincipal | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/applicationserviceprincipal.md | Title: 'applicationServicePrincipal resource type' description: 'A combination of an application and a servicePrincipal.' ms.localizationpriority: medium-++ doc_type: resourcePageType |
v1.0 | Appliedconditionalaccesspolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/appliedconditionalaccesspolicy.md | Title: "appliedConditionalAccessPolicy resource type" description: "Indicates the attributes related to applied conditional access policy or policies that are triggered by the corresponding sign-in activity." ms.localizationpriority: medium + doc_type: resourcePageType Indicates the attributes related to applied conditional access policy or policie ## Properties -| Property | Type |Description| +| Property | Type |Description| |:|:--|:-|-|displayName|String|Refers to the Name of the conditional access policy (example: ΓÇ£Require MFA for SalesforceΓÇ¥).| -|enforcedGrantControls|String collection|Refers to the grant controls enforced by the conditional access policy (example: ΓÇ£Require multifactor authenticationΓÇ¥).| -|enforcedSessionControls|String collection|Refers to the session controls enforced by the conditional access policy (example: ΓÇ£Require app enforced controlsΓÇ¥).| +|displayName|String|Refers to the Name of the conditional access policy (example: "Require MFA for Salesforce").| +|enforcedGrantControls|String collection|Refers to the grant controls enforced by the conditional access policy (example: "Require multifactor authentication").| +|enforcedSessionControls|String collection|Refers to the session controls enforced by the conditional access policy (example: "Require app enforced controls").| |id|String|An identifier of the conditional access policy. Supports `$filter` (`eq`).| |result|appliedConditionalAccessPolicyResult| Indicates the result of the CA policy that was triggered. Possible values are: `success`, `failure`, `notApplied` (policy isn't applied because policy conditions weren't met), `notEnabled` (This is due to the policy in a disabled state), `unknown`, `unknownFutureValue`, `reportOnlySuccess`, `reportOnlyFailure`, `reportOnlyNotApplied`, `reportOnlyInterrupted`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `reportOnlySuccess`, `reportOnlyFailure`, `reportOnlyNotApplied`, `reportOnlyInterrupted`.| ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Approle | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/approle.md | With [appRoleAssignments](approleassignment.md), app roles can be assigned to us ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Appscope | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/appscope.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Archivedprintjob | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/archivedprintjob.md | A record of a "final state" (completed, aborted, or canceled) print job that is ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Assignedlabel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/assignedlabel.md | Represents a sensitivity label assigned to a Microsoft 365 group. Sensitivity la ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Assignedlicense | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/assignedlicense.md | Title: "assignedLicense resource type" description: "Represents a license assigned to a user. The **assignedLicenses** property of the user entity is a collection of **assignedLicense**." ms.localizationpriority: medium + doc_type: resourcePageType Represents a license assigned to a user. The **assignedLicenses** property of th ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Assignedplan | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/assignedplan.md | The following table describes the possible statuses for the **capabilityStatus** ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Attachment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/attachment.md | None ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Attachmentbase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/attachmentbase.md | Inherits from [entity](../resources/entity.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Attachmentinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/attachmentinfo.md | Represents the attributes of an attachment. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.attachmentInfo" |
v1.0 | Attachmentitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/attachmentitem.md | Represents attributes of an item to be attached. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Attendee | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/attendee.md | Derived from [attendeeBase](attendeebase.md). ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Attendeeavailability | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/attendeeavailability.md | The availability of an attendee. ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Attendeebase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/attendeebase.md | Derived from [recipient](recipient.md). ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Auditactivityinitiator | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/auditactivityinitiator.md | Identity the resource object that initiates the activity. The initiator can be a ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Authentication | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/authentication.md | None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Authenticationcombinationconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/authenticationcombinationconfiguration.md | This is an abstract type. In use, [fido2combinationConfigurations](fido2combinat ## Relationships |id|String|A unique system-generated identifier.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Authenticationconditionapplication | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/authenticationconditionapplication.md | + + Title: "authenticationConditionApplication resource type" +description: "Represents the application that is triggered for an authenticationEventListener." ++ms.localizationpriority: medium ++++# authenticationConditionApplication resource type ++Namespace: microsoft.graph ++Represents the application that is triggered for an authenticationEventListener. ++## Methods ++None. ++## Properties +|Property|Type|Description| +|:|:|:| +|appId|String|The identifier for an application corresponding to a condition that triggers an authenticationEventListener.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.authenticationConditionApplication", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.authenticationConditionApplication", + "appId": "String" +} +``` + |
v1.0 | Authenticationconditions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/authenticationconditions.md | + + Title: "authenticationConditions resource type" +description: "The conditions on which an authenticationEventListener should trigger." ++ms.localizationpriority: medium ++++# authenticationConditions resource type ++Namespace: microsoft.graph ++The conditions on which an authenticationEventListener should trigger. ++## Properties +|Property|Type|Description| +|:|:|:| +|applications|[authenticationConditionsApplications](../resources/authenticationconditionsapplications.md)|Applications which trigger a custom authentication extension.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.authenticationConditions" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.authenticationConditions", + "applications": { + "@odata.type": "microsoft.graph.authenticationConditionsApplications" + } +} +``` + |
v1.0 | Authenticationconditionsapplications | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/authenticationconditionsapplications.md | + + Title: "authenticationConditionsApplications resource type" +description: "The applications on which an authenticationEventListener should trigger." ++ms.localizationpriority: medium ++++# authenticationConditionsApplications resource type ++Namespace: microsoft.graph ++The applications on which an authenticationEventListener should trigger. ++## Properties +None. ++## Relationships +|Relationship|Type|Description| +|:|:|:| +|includeApplications|[authenticationConditionApplication](../resources/authenticationconditionapplication.md) collection|Collection of the application conditions on which an authenticationEventListener should trigger.| ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.authenticationConditionsApplications" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.authenticationConditionsApplications" +} +``` + |
v1.0 | Authenticationconfigurationvalidation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/authenticationconfigurationvalidation.md | + + Title: "authenticationConfigurationValidation resource type" +description: "The result of a validateAuthenticationConfiguration action that validates a customAuthenticationExtension configuration." ++ms.localizationpriority: medium ++++# authenticationConfigurationValidation resource type ++Namespace: microsoft.graph ++The validation result of a [validateAuthenticationConfiguration action](../api/customauthenticationextension-validateauthenticationconfiguration.md) that validates a [customAuthenticationExtension](../resources/customauthenticationextension.md) configuration. ++## Properties +|Property|Type|Description| +|:|:|:| +|errors|[genericError](../resources/genericerror.md) collection|Errors in the validation result of a [customAuthenticationExtension](../resources/customauthenticationextension.md).| +|warnings|[genericError](../resources/genericerror.md) collection|Warnings in the validation result of a [customAuthenticationExtension](../resources/customauthenticationextension.md).| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.authenticationConfigurationValidation" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.authenticationConfigurationValidation", + "errors": [ + { + "@odata.type": "microsoft.graph.genericError" + } + ], + "warnings": [ + { + "@odata.type": "microsoft.graph.genericError" + } + ] +} +``` + |
v1.0 | Authenticationcontextclassreference | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/authenticationcontextclassreference.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Authenticationeventlistener | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/authenticationeventlistener.md | + + Title: "authenticationEventListener resource type" +description: "Listener for taking action on events in the authentication process." ++ms.localizationpriority: medium ++++# authenticationEventListener resource type ++Namespace: microsoft.graph ++To customize the authentication process, listeners can be registered which specify that for some event, on some conditions, some custom logic can be invoked. This is an abstract type from which the following types are derived. ++- [onTokenIssuanceStartListener resource type](../resources/ontokenissuancestartlistener.md) resource type +Inherits from [entity](../resources/entity.md). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List authenticationEventListener objects](../api/identitycontainer-list-authenticationeventlisteners.md)|[authenticationEventListener](../resources/authenticationeventlistener.md) collection|Get a list of the [authenticationEventListener](../resources/authenticationeventlistener.md) objects and their properties.| +|[Create authenticationEventListener](../api/identitycontainer-post-authenticationeventlisteners.md)|[authenticationEventListener](../resources/authenticationeventlistener.md)|Create a new [authenticationEventListener](../resources/authenticationeventlistener.md) object.| +|[Get authenticationEventListener](../api/authenticationeventlistener-get.md)|[authenticationEventListener](../resources/authenticationeventlistener.md)|Read the properties and relationships of an [authenticationEventListener](../resources/authenticationeventlistener.md) object.| +|[Update authenticationEventListener](../api/authenticationeventlistener-update.md)|[authenticationEventListener](../resources/authenticationeventlistener.md)|Update the properties of an [authenticationEventListener](../resources/authenticationeventlistener.md) object.| +|[Delete authenticationEventListener](../api/authenticationeventlistener-delete.md)|None|Delete an [authenticationEventListener](../resources/authenticationeventlistener.md) object.| ++## Properties +|Property|Type|Description| +|:|:|:| +|conditions|[authenticationConditions](../resources/authenticationconditions.md)|The conditions on which this authenticationEventListener should trigger.| +|id|String|Identifier for this authenticationEventListener. Inherited from [entity](../resources/entity.md).| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.authenticationEventListener", + "baseType": "microsoft.graph.entity", + "openType": true +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.authenticationEventListener", + "id": "String (identifier)", + "conditions": { + "@odata.type": "microsoft.graph.authenticationConditions" + }, +} +``` + |
v1.0 | Authenticationmethodconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/authenticationmethodconfiguration.md | The following authentication methods are derived from the **authenticationMethod None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Authenticationmethodsroot | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/authenticationmethodsroot.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Authenticationmethodtarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/authenticationmethodtarget.md | A collection of groups that are enabled to use an authentication method as part None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Automaticrepliesmailtips | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/automaticrepliesmailtips.md | Namespace: microsoft.graph ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Automaticrepliessetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/automaticrepliessetting.md | respond to emails. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Availabilityitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/availabilityitem.md | Indicates the status of a [staff member](bookingstaffmember.md) for a given time ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Azure Ad Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/azure-ad-overview.md | - Title: "Working with Microsoft Entra resources in Microsoft Graph" -description: "With Microsoft Graph, you can access Microsoft Entra resources to enable scenarios like managing administrator (directory) roles, inviting external users to an organization, and, if you are a Cloud Solution Provider (CSP), managing your customer's data. Microsoft Graph also provides methods that apps can use to, for example, discover information about users' transitive group and role memberships. " ---doc_type: conceptualPageType Previously updated : 07/07/2022---# Working with Microsoft Entra resources in Microsoft Graph --With Microsoft Graph, you can access [Microsoft Entra](/azure/active-directory/active-directory-whatis) resources to enable scenarios like managing administrator (directory) roles, inviting external users to an organization, and, if you are a [Cloud Solution Provider (CSP)](https://partner.microsoft.com/cloud-solution-provider), managing your customer's data. Microsoft Graph also provides methods that apps can use to, for example, discover information about users' transitive group and role memberships. --> **Note**: Some Microsoft Entra resources are documented in other sections of the API reference. For more information, see [Users](users.md) and [Groups](group.md). ---## Authorization --To call the Microsoft Graph APIs on Microsoft Entra resources, your app will need the appropriate permissions. Many of the APIs exposed on Microsoft Entra resources require one of the [_Directory_ permissions](/graph/permissions-reference#directory-permissions). Directory permissions are highly privileged and always require administrator consent. --If your app is acting on behalf of a user (delegated permissions), that user will likely need to be a member of an appropriate [administrator role](/azure/active-directory/active-directory-assign-admin-roles) for your app to successfully call many of the Microsoft Entra APIs. --For more information about permissions, including delegated and application permissions, see [Permissions](/graph/permissions-reference). --## Common use cases --The following table lists some common use cases for Microsoft Entra resources. --| **Use cases** | **REST resources** | **See also** | -|:|:--|:-| -| **Directory object and methods** | | | -| `directoryObject` is the base class that many directory resources, like users and groups, inherit from. Microsoft Graph exposes several methods that you can use to discover information about users, groups, and other directory objects. For example, you can check for transitive membership in a list of groups, return all the groups and directory roles that a directory object is a transitive member of, or get all the resources of a specified type (like user or group) from a list of generic resource IDs. | [directoryObject](../resources/directoryobject.md) | N/A | -| **Manage directory (administrator) roles** | | | -| Activate directory roles in a Microsoft Entra tenant and manage user memberships in directory roles. Directory roles are also known as administrator roles. | [directoryRole](../resources/directoryrole.md) <br/>[directoryRoleTemplate](../resources/directoryroletemplate.md) | [Assigning Microsoft Entra administrator roles](/azure/active-directory/active-directory-assign-admin-roles) | -| Apply predefined group settings across a tenant or to individual resource instances. Group settings control behaviors like blocked word lists for group display names, whether guest users are allowed to be group owners, and much more. | [groupSetting](../resources/groupsetting.md) <br/>[groupSettingTemplate](../resources/groupsettingtemplate.md)| [Microsoft Entra cmdlets for configuring group settings](/azure/active-directory/active-directory-accessmanagement-groups-settings-cmdlets)| -| **Manage devices** | | | -| Manage devices registered in the organization. Devices are registered to users and include items like laptops, desktops, tablets, and mobile phones. Devices are typically created in the cloud using the Device Registration Service or by Microsoft Intune. They're used by conditional access policies for multifactor authentication. | [device](../resources/device.md) | [Getting started with Microsoft Entra device registration](/mem/intune/enrollment/).<br/><br/>[What is Intune?](/mem/intune/fundamentals/what-is-intune)<br/><br/>[Enroll devices for management in Intune](/mem/intune/enrollment/) | -| **Partner tenant management** | | | -| Get information about partnerships with customer tenants.<br/><br/>**Note:** This applies to partner tenants only. Partner tenants are Microsoft Entra tenants that belong to Microsoft partners who are either part of the [Microsoft Cloud Solution Provider](https://partnercenter.microsoft.com/partner/programs), Office 365 Syndication, or Microsoft Advisor partner programs. | [contract](../resources/contract.md) | [Call Microsoft Graph from a Cloud Solution Provider application](/graph/auth-cloudsolutionprovider) | -| Manage domains associated with a tenant. Domain operations enable registrars to automate domain association for services such as Microsoft 365. | [domain](../resources/domain.md) | [Add a custom domain name to Microsoft Entra ID](/azure/active-directory/active-directory-domains-add-azure-portal) | -| **Tenant management** | | | -| Get information about an organization, such as its business address, technical and notification contacts, the service plans that it's subscribed to, and the domains associated with it. | [organization](../resources/organization.md) | N/A | -| Get information about the service SKUs that a company is subscribed to. | [subscribedSku](../resources/subscribedsku.md) | N/A | -| Invite external (guest) users to an organization. | [invitation](../resources/invitation.md) | [What is Microsoft Entra B2B collaboration?](/azure/active-directory/active-directory-b2b-what-is-azure-ad-b2b) | -| Manage branding for the sign-in experience of an organization. | [organizationalbranding](../resources/organizationalbranding.md) | [Add branding to your organization's Microsoft Entra sign-in page](/azure/active-directory/fundamentals/customize-branding)| -| **Consent requests** | | | -| Manage the consent request workflow for users attempting to access apps that require admin authorization. | [Consent requests API](../resources/consentrequests-overview.md) |[Configure the admin consent workflow](/azure/active-directory/manage-apps/configure-admin-consent-workflow) | --## Next steps -Directory resources and APIs can open up new ways for you to engage with users and manage their experiences with Microsoft Graph. To learn more: --- Drill down on the methods and properties of the resources most helpful to your scenario.-- Try the API in the [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer). |
v1.0 | Azureadtokenauthentication | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/azureadtokenauthentication.md | + + Title: "azureAdTokenAuthentication resource type" +description: "Defines the Microsoft Entra application used to authenticate with a custom extension." ++ms.localizationpriority: medium ++++# azureAdTokenAuthentication resource type ++Namespace: microsoft.graph ++Defines the Microsoft Entra application used to authenticate an app with a custom extension. Only the app ID of the application is required. Derived from [customExtensionAuthenticationConfiguration](../resources/customextensionauthenticationconfiguration.md). ++## Properties ++|Property|Type|Description| +|:|:|:| +|resourceId|String|The **appID** of the Microsoft Entra application to use to authenticate an app with a custom extension.| ++## JSON representation ++The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.azureAdTokenAuthentication", + "baseType": "microsoft.graph.customExtensionAuthenticationConfiguration" +} +--> ++``` json +{ + "@odata.type": "#microsoft.graph.azureAdTokenAuthentication", + "resourceId": "String" + } +``` |
v1.0 | B2xidentityuserflow | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/b2xidentityuserflow.md | Inherits from base class [identityUserFlow](../resources/identityuserflow.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Basesitepage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/basesitepage.md | + + Title: "baseSitePage resource type" +description: "An abstract type that represents a baseSitePage in the site page library." ++ms.localizationpriority: medium +++# baseSitePage resource type ++Namespace: microsoft.graph ++++An abstract type that represents a page in the site page library. ++Inherits from [baseItem](../resources/baseitem.md). ++## Methods ++| Method | Return type | Description | +| : | : | :- | +| [List baseSitePage](../api/basesitepage-list.md) | [baseSitePage](../resources/basesitepage.md) collection | Get the collection of [baseSitePage](../resources/basesitepage.md) objects from the site pages [list](../resources/list.md) in a [site](../resources/site.md). | +| [Get baseSitePage](../api/baseSitePage-get.md) | [baseSitePage](../resources/basesitepage.md) | Get the metadata for a [baseSitePage](../resources/basesitepage.md) in the site pages [list](../resources/list.md) in a [site](../resources/site.md). | +| [Delete baseSitePage](../api/baseSitePage-delete.md) | None | Delete a [baseSitePage](../resources/basesitepage.md) object. | ++## Properties ++| Property | Type | Description | +| :- | :- | : | +| contentType | [contentTypeInfo](../resources/contentTypeInfo.md) | The content type of this item. Inherited from [baseItem](../resources/baseitem.md). | +| createdBy | [identitySet](../resources/identityset.md) | Identity of the creator of this item. Read-only. Inherited from [baseItem](../resources/baseitem.md). | +| createdDateTime | DateTimeOffset | The date and time the item was created. Read-only. Inherited from [baseItem](../resources/baseitem.md). | +| description | String | The descriptive text for the item. Inherited from [baseItem](../resources/baseitem.md). | +| eTag | String | ETag for the item. Inherited from [baseItem](../resources/baseitem.md). | +| id | String | The unique identifier of the item. Inherited from [entity](../resources/entity.md). | +| lastModifiedBy | [identitySet](../resources/identityset.md) | The identity of the last modifier of this item. Read-only. Inherited from [baseItem](../resources/baseitem.md). | +| lastModifiedDateTime | DateTimeOffset | The date and time the item was last modified. Read-only. Inherited from [baseItem](../resources/baseitem.md). | +| name | String | The name of the item. Inherited from [baseItem](../resources/baseitem.md). | +| pageLayout | [pageLayoutType](../resources/basesitepage.md#pagelayouttype-values) | The name of the page layout of the page. The possible values are: `microsoftReserved`, `article`, `home`, `unknownFutureValue`. | +| parentReference | [itemReference](../resources/itemreference.md) | Parent information, if the item has a parent. Inherited from [baseItem](../resources/baseitem.md). | +| publishingState | [publicationFacet](../resources/publicationfacet.md) | The publishing status and the MM.mm version of the page. | +| title | String | Title of the sitePage. | +| webUrl | String | URL that displays the resource in the browser. Read-only. Inherited from [baseItem](../resources/baseitem.md). | ++### pageLayoutType values ++| Value | Description | +| | | +| microsoftReserved | The page is a special type reserved for Microsoft use only. | +| article | The page is an article page. | +| home | The page is a home page. | +| unknownFutureValue | Marker value for future compatibility. | ++## Relationships ++| Relationship | Type | Description | +| :-- | : | : | +| createdByUser | [user](../resources/user.md) | Identity of the creator of this item. Read-only. Inherited from [baseItem](../resources/baseitem.md) | +| lastModifiedByUser | [user](../resources/user.md) | Identity of the last modifier of this item. Read-only. Inherited from [baseItem](../resources/baseitem.md) | ++## JSON representation ++The following is a JSON representation of the resource. ++<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.baseSitePage", + "baseType": "microsoft.graph.baseItem", + "openType": true +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.baseSitePage", + "id": "String (identifier)", + "createdBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "createdDateTime": "String (timestamp)", + "contentType": { + "@odata.type": "microsoft.graph.contentTypeInfo" + }, + "description": "String", + "eTag": "String", + "lastModifiedBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "lastModifiedDateTime": "String (timestamp)", + "name": "String", + "parentReference": { + "@odata.type": "microsoft.graph.itemReference" + }, + "webUrl": "String", + "title": "String", + "pageLayout": "String", + "publishingState": { + "@odata.type": "microsoft.graph.publicationFacet" + } +} +``` |
v1.0 | Basicauthentication | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/basicauthentication.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.basicAuthentication" |
v1.0 | Bitlocker | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/bitlocker.md | None. | recoveryKeys | [bitlockerRecoveryKey](../resources/bitlockerrecoverykey.md) collection | The recovery keys associated with the bitlocker entity. | ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.bitlocker", |
v1.0 | Bookingappointment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/bookingappointment.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Bookingcurrency | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/bookingcurrency.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Bookingcustomerbase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/bookingcustomerbase.md | Base type of [bookingCustomer](bookingcustomer.md) |id|String|ID of the customer. Inherited from [entity](../resources/entity.md).| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Bookingquestionassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/bookingquestionassignment.md | Contains the set of custom questions associated with a particular service. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.bookingQuestionAssignment" |
v1.0 | Bookingstaffmemberbase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/bookingstaffmemberbase.md | Base type of [bookingStaffMember](bookingstaffmember.md). |id|String|ID of the staff member. Inherited from [entity](../resources/entity.md).| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Broadcastmeetingcaptionsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/broadcastmeetingcaptionsettings.md | The following table shows the supported language codes for translation languages ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.broadcastMeetingCaptionSettings" |
v1.0 | Broadcastmeetingsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/broadcastmeetingsettings.md | Represents settings related to a [live event](/microsoftteams/teams-live-events/ ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Bucketaggregationdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/bucketaggregationdefinition.md | Provides the details on how to generate the aggregations in the results. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Builtinidentityprovider | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/builtinidentityprovider.md | This type inherits from [identityProviderBase](../resources/identityproviderbase ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Calendargroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/calendargroup.md | A group of user calendars. ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Calendarpermission | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/calendarpermission.md | Once a share recipient or delegate has been set up for a calendar, you can [upda ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Call | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/call.md | https://teams.microsoft.com/l/meetup-join/19:meeting_NTg0NmQ3NTctZDVkZC00YzRhLTh ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Callrecords Feedbacktokenset | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/callrecords-feedbacktokenset.md | Explicit property names won't be documented since the feedback token names can c ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Callrecords Segment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/callrecords-segment.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Canvaslayout | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/canvaslayout.md | + + Title: 'canvasLayout resource type' +description: Represents the layout of the content in a given SharePoint page. ++ms.localizationpriority: medium +++# canvasLayout resource type ++Namespace: microsoft.graph ++++Represents the layout of the content in a given SharePoint page. ++Inherits from [entity](../resources/entity.md). ++## Methods ++None. ++## Properties ++| Property | Type | Description | +| :- | :-- | :-- | +| id | String | The unique identifier of the resource. Inherited from [entity](../resources/entity.md). | ++## Relationships ++| Relationship | Type | Description | +| :-- | :- | :-- | +| horizontalSections | [horizontalSection](../resources/horizontalsection.md) collection | Collection of horizontal sections on the SharePoint page. | +| verticalSection | [verticalSection](../resources/verticalsection.md) | Vertical section on the SharePoint page. | ++## JSON representation ++The following is a JSON representation of the resource. ++<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.canvasLayout", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.canvasLayout", + "id": "String (identifier)", + /* relationships */ + "horizontalSections": { + "@odata.type": "Collection(microsoft.graph.horizontalSection)" + }, + "verticalSection": { "@odata.type": "microsoft.graph.verticalSection" } +} +``` |
v1.0 | Certificateauthority | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/certificateauthority.md | Title: "certificateAuthority resource type" description: "Represents a certificate authority." ms.localizationpriority: medium-+ doc_type: "resourcePageType" doc_type: "resourcePageType" Namespace: microsoft.graph -Represents a certificate authority. +Used by the **certificateAuthorities** property of [certificateBasedAuthConfiguration resource type](certificatebasedauthconfiguration.md) to represent a certificate authority. ## Properties |
v1.0 | Certificatebasedauthconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/certificatebasedauthconfiguration.md | Title: "certificateBasedAuthConfiguration resource type" description: "Represents a collection of certificate authorities." ms.localizationpriority: medium-+ doc_type: "resourcePageType" |
v1.0 | Certification | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/certification.md | The certification property of an application is read-only, and can't be manually |lastCertificationDateTime|DateTimeOffset|The timestamp when the certification for the application was most recently added or updated.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Change Notifications Api Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/change-notifications-api-overview.md | Title: "Overview: Microsoft Graph API change notifications" description: "Deliver change notifications to clients." ms.localizationpriority: high + doc_type: conceptualPageType Last updated 09/10/2022 |
v1.0 | Changenotification | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/changenotification.md | description: "Represents the change notification sent to the subscriber." ms.localizationpriority: medium doc_type: resourcePageType+ # changeNotification resource type |
v1.0 | Changenotificationcollection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/changenotificationcollection.md | description: "Represents a collection of subscription notifications sent to the ms.localizationpriority: medium doc_type: resourcePageType+ # changeNotificationCollection resource type |
v1.0 | Changenotificationencryptedcontent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/changenotificationencryptedcontent.md | description: "A changeNotificationEncryptedContent object represents the encrypt ms.localizationpriority: medium doc_type: resourcePageType+ # changeNotificationEncryptedContent resource type |
v1.0 | Chart | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/chart.md | Represents a chart object in a workbook. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Chartareaformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/chartareaformat.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Chartaxes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/chartaxes.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Chartaxis | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/chartaxis.md | Represents a single axis in a chart. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Chartaxisformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/chartaxisformat.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Chartaxistitle | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/chartaxistitle.md | Represents the title of a chart axis. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Chartaxistitleformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/chartaxistitleformat.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Chartdatalabelformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/chartdatalabelformat.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Chartdatalabels | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/chartdatalabels.md | Represents a collection of all the data labels on a chart point. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Chartfont | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/chartfont.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Chartgridlines | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/chartgridlines.md | Represents major or minor gridlines on a chart axis. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Chartgridlinesformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/chartgridlinesformat.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Chartlegend | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/chartlegend.md | Represents the legend in a chart. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Chartlegendformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/chartlegendformat.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Chartlineformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/chartlineformat.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Chartpoint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/chartpoint.md | Represents a point of a series in a chart. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Chartpointformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/chartpointformat.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Chartseries | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/chartseries.md | Represents a series in a chart. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Chartseriesformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/chartseriesformat.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Charttitle | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/charttitle.md | Represents a chart title object of a chart. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Charttitleformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/charttitleformat.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Chatmessagehostedcontent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/chatmessagehostedcontent.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Chatmessageinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/chatmessageinfo.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Chatmessagepolicyviolation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/chatmessagepolicyviolation.md | Represents a policy violation on a chat message. Policy violations are typically ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Cloudappsecuritystate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/cloudappsecuritystate.md | Contains stateful information about the cloud application (destinationServiceNam ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Cloudpcwindowssetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/cloudpcwindowssetting.md | The following JSON representation shows the resource type. ``` json { "@odata.type": "#microsoft.graph.cloudPcWindowsSetting",- "language": "String" + "locale": "String" } ``` |
v1.0 | Conditionalaccessguestsorexternalusers | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/conditionalaccessguestsorexternalusers.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Conditionalaccesssessioncontrols | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/conditionalaccesssessioncontrols.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Connectors Api Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/connectors-api-overview.md | The following are current known limitations: - An application is limited to 25 concurrent operations on a connection. - Connections have a capacity limit of 5,000,000 items or ~350 GB of data. - Maximum size of an `externalItem` entity is 4 MB.-- Sorting results is not supported. ## Next steps |
v1.0 | Contenttypeinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/contenttypeinfo.md | Represents the SharePoint [contentType](contenttype.md) of an item. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.contentTypeInfo", "@type.aka": "oneDrive.contentTypeFacet" } --> |
v1.0 | Contract | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/contract.md | None ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Conversation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/conversation.md | This resource supports subscribing to [change notifications](/graph/webhooks). ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Conversationthread | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/conversationthread.md | A new thread is created when a recipient is removed from the thread. ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Convertidresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/convertidresult.md | The result of an ID format conversion performed by the [translateExchangeIds](.. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Crosstenantaccesspolicy Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/crosstenantaccesspolicy-overview.md | The cross-tenant access settings API can be used to set up multiple configuratio </td> <td> Users in group 'g1' are blocked from accessing application 'a1' only. All users, including users in group 'g1' are able to access any other application. </td> </tr>+<tr> +<td> + Prioritize using an external federation over Entra ID during guest user invitation redemption +</td> +<td> ++``` json +"invitationRedemptionIdentityProviderConfiguration": { + "primaryIdentityProviderPrecedenceOrder": [ + "externalFederation", + "azureActiveDirectory", + "socialIdentityProviders" + ], + "fallbackIdentityProvider": "defaultConfiguredIdp" +} +``` +</td> +<td> +Check if the guest user is from an externally federated partner before trying Entra ID for authentication. +</td> +</tr> </table> ## Cross-tenant access settings vs tenant restrictions |
v1.0 | Crosstenantaccesspolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/crosstenantaccesspolicy.md | Represents the base policy in the directory for cross-tenant access settings. |:|:|:| |default|[crossTenantAccessPolicyConfigurationDefault](../resources/crosstenantaccesspolicyconfigurationdefault.md)|Defines the default configuration for how your organization interacts with external Microsoft Entra organizations.| |partners|[crossTenantAccessPolicyConfigurationPartner](../resources/crosstenantaccesspolicyconfigurationpartner.md) collection|Defines partner-specific configurations for external Microsoft Entra organizations.|+|templates|[policyTemplate](../resources/policytemplate.md)|Represents the base policy in the directory for multitenant organization settings.| ## JSON representation |
v1.0 | Crosstenantaccesspolicyconfigurationdefault | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/crosstenantaccesspolicyconfigurationdefault.md | The default configuration defined for inbound and outbound settings of Microsoft |Property|Type|Description| |:|:|:|-| automaticUserConsentSettings | [inboundOutboundPolicyConfiguration](../resources/inboundoutboundpolicyconfiguration.md) | Determines the default configuration for automatic user consent settings. The **inboundAllowed** and **outboundAllowed** properties are always `false` and cannot be updated in the default configuration. Read-only. | +| automaticUserConsentSettings | [inboundOutboundPolicyConfiguration](../resources/inboundoutboundpolicyconfiguration.md) | Determines the default configuration for automatic user consent settings. The **inboundAllowed** and **outboundAllowed** properties are always `false` and can't be updated in the default configuration. Read-only. | | b2bCollaborationInbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) |Defines your default configuration for users from other organizations accessing your resources via Microsoft Entra B2B collaboration. | | b2bCollaborationOutbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) |Defines your default configuration for users in your organization going outbound to access resources in another organization via Microsoft Entra B2B collaboration. | | b2bDirectConnectInbound |[crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your default configuration for users from other organizations accessing your resources via Microsoft Entra B2B direct connect. | | b2bDirectConnectOutbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) |Defines your default configuration for users in your organization going outbound to access resources in another organization via Microsoft Entra B2B direct connect. | | inboundTrust | [crossTenantAccessPolicyInboundTrust](../resources/crosstenantaccesspolicyinboundtrust.md) | Determines the default configuration for trusting other Conditional Access claims from external Microsoft Entra organizations. |-| isServiceDefault | Boolean | If `true`, the default configuration is set to the system default configuration. If `false`, the default settings have been customized. | +| invitationRedemptionIdentityProviderConfiguration | [defaultInvitationRedemptionIdentityProviderConfiguration](../resources/defaultInvitationRedemptionIdentityProviderConfiguration.md) | Defines the priority order based on which an identity provider is selected during invitation redemption for a guest user. | +| isServiceDefault | Boolean | If `true`, the default configuration is set to the system default configuration. If `false`, the default settings are customized. | ## Relationships None. ## JSON representation -The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", The following is a JSON representation of the resource. "b2bDirectConnectInbound": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting"}, "b2bDirectConnectOutbound": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting"}, "inboundTrust": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyInboundTrust"},+ "invitationRedemptionIdentityProviderConfiguration": { + "@odata.type": "microsoft.graph.defaultInvitationRedemptionIdentityProviderConfiguration" + }, "isServiceDefault": "Boolean" } ``` |
v1.0 | Crosstenantaccesspolicyconfigurationpartner | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/crosstenantaccesspolicyconfigurationpartner.md | For any partner-specific property that is `null`, these settings inherit the beh | b2bDirectConnectInbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your partner-specific configuration for users from other organizations accessing your resources via Azure B2B direct connect. | | b2bDirectConnectOutbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your partner-specific configuration for users in your organization going outbound to access resources in another organization via Microsoft Entra B2B direct connect. | | inboundTrust | [crossTenantAccessPolicyInboundTrust](../resources/crosstenantaccesspolicyinboundtrust.md) | Determines the partner-specific configuration for trusting other Conditional Access claims from external Microsoft Entra organizations. |+| isInMultiTenantOrganization | Boolean | Identifies whether a tenant is a member of a multitenant organization. | | isServiceProvider | Boolean | Identifies whether the partner-specific configuration is a Cloud Service Provider for your organization. | | tenantId | String | The tenant identifier for the partner Microsoft Entra organization. Read-only. Key.| For any partner-specific property that is `null`, these settings inherit the beh ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "tenantId", Here's a JSON representation of the resource. "b2bDirectConnectInbound": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting"}, "b2bDirectConnectOutbound": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting"}, "inboundTrust": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyInboundTrust"},+ "isInMultiTenantOrganization": "Boolean", "isServiceProvider": "Boolean", "tenantId": "String (identifier)" } |
v1.0 | Customauthenticationextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/customauthenticationextension.md | + + Title: "customAuthenticationExtension resource type" +description: "Custom authentication extensions let you interact with external systems during a user authentication session." ++ms.localizationpriority: medium ++++# customAuthenticationExtension resource type ++Namespace: microsoft.graph ++Custom authentication extensions define interactions with external systems during a user authentication session. This is an abstract type from which the following types are derived. ++- [onTokenIssuanceStartCustomExtension](../resources/ontokenissuancestartcustomextension.md) resource type. ++Inherits from [customCalloutExtension](../resources/customcalloutextension.md). ++Learn how to use this API when [Configuring a custom claim provider token issuance event](/azure/active-directory/develop/custom-extension-get-started?tabs=microsoft-graph?toc=/graph/toc.json&context=graph/context). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List customAuthenticationExtensions](../api/identitycontainer-list-customauthenticationextensions.md)|[customAuthenticationExtension](../resources/customauthenticationextension.md) collection|Get a list of the [customAuthenticationExtension](../resources/customauthenticationextension.md) objects and their properties.| +|[Create customAuthenticationExtension](../api/identitycontainer-post-customauthenticationextensions.md)|[customAuthenticationExtension](../resources/customauthenticationextension.md)|Create a new [customAuthenticationExtension](../resources/customauthenticationextension.md) object.| +|[Get customAuthenticationExtension](../api/customauthenticationextension-get.md)|[customAuthenticationExtension](../resources/customauthenticationextension.md)|Read the properties and relationships of a [customAuthenticationExtension](../resources/customauthenticationextension.md) object.| +|[Update customAuthenticationExtension](../api/customauthenticationextension-update.md)|None|Update the properties of a [customAuthenticationExtension](../resources/customauthenticationextension.md) object.| +|[Delete customAuthenticationExtension](../api/customauthenticationextension-delete.md)|None|Delete a [customAuthenticationExtension](../resources/customauthenticationextension.md) object.| +|[validateAuthenticationConfiguration](../api/customauthenticationextension-validateauthenticationconfiguration.md)|[authenticationConfigurationValidation](../resources/authenticationconfigurationvalidation.md)|Check validity of the endpoint and authentication configuration for a [customAuthenticationExtension](../resources/customauthenticationextension.md) object.| ++## Properties +|Property|Type|Description| +|:|:|:| +|authenticationConfiguration|[customExtensionAuthenticationConfiguration](../resources/customextensionauthenticationconfiguration.md)|The authentication configuration for the customAuthenticationExtension. Inherited from [customCalloutExtension](../resources/customcalloutextension.md).| +|clientConfiguration|[customExtensionClientConfiguration](../resources/customextensionclientconfiguration.md)|The connection settings for the customAuthenticationExtension. Inherited from [customCalloutExtension](../resources/customcalloutextension.md).| +|description|String|The description of the customAuthenticationExtension. Inherited from [customCalloutExtension](../resources/customcalloutextension.md).| +|displayName|String|The display name for the customAuthenticationExtension. Inherited from [customCalloutExtension](../resources/customcalloutextension.md).| +|endpointConfiguration|[customExtensionEndpointConfiguration](../resources/customextensionendpointconfiguration.md)|The HTTP endpoint that this custom extension calls. Inherited from [customCalloutExtension](../resources/customcalloutextension.md).| +|id|String|Identifier for the customAuthenticationExtension. Inherited from [entity](../resources/entity.md).| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.customAuthenticationExtension", + "baseType": "microsoft.graph.customCalloutExtension", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.customAuthenticationExtension", + "id": "String (identifier)", + "authenticationConfiguration": { + "@odata.type": "microsoft.graph.customExtensionAuthenticationConfiguration" + }, + "clientConfiguration": { + "@odata.type": "microsoft.graph.customExtensionClientConfiguration" + }, + "description": "String", + "displayName": "String", + "endpointConfiguration": { + "@odata.type": "microsoft.graph.customExtensionEndpointConfiguration" + } +} +``` ++## Related content ++- [Configure a custom claim provider token issuance event](/azure/active-directory/develop/custom-extension-get-started?tabs=microsoft-graph?toc=/graph/toc.json&context=graph/context) + |
v1.0 | Customcalloutextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/customcalloutextension.md | An abstract type that defines the configuration for apps that can extend the cus This abstract type is inherited by the following derived types. - [customTaskExtension](../resources/identitygovernance-customtaskextension.md)+- [customAuthenticationExtension](../resources/customauthenticationextension.md) - [accessPackageAssignmentRequestWorkflowExtension](accesspackageassignmentrequestworkflowextension.md) - [accessPackageAssignmentWorkflowExtension](../resources/accesspackageassignmentworkflowextension.md) None. ## JSON representation -The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Customextensionauthenticationconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/customextensionauthenticationconfiguration.md | Namespace: microsoft.graph Abstract base type that exposes the configuration for the **authenticationConfiguration** property of the derived types that inherit from the [customCalloutExtension](customcalloutextension.md) abstract type. -This abstract type is inherited by the following resource type: -+This abstract type is inherited by the following resource types: +- [azureAdTokenAuthentication](../resources/azureadtokenauthentication.md) - [azureAdPopTokenAuthentication](../resources/azureAdPopTokenAuthentication.md) -The type of token authentication used depends on the token security. If the value is Proof of Possession, you'll use the [azureAdPopTokenAuthentication](../resources/azureAdPopTokenAuthentication.md) resource type. +The type of token authentication used depends on the token security. If the token security value is normal, you use the [azureAdTokenAuthentication](../resources/azureadtokenauthentication.md) resource type. If the value is Proof of Possession, you use the [azureAdPopTokenAuthentication](../resources/azureAdPopTokenAuthentication.md) resource type. ## Properties None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.customExtensionAuthenticationConfiguration", |
v1.0 | Customextensionclientconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/customextensionclientconfiguration.md | doc_type: resourcePageType Namespace: microsoft.graph -Connection settings that define how long Microsoft Entra ID can wait for a response from an external app before it shuts down the connection when trying to trigger the external app. Only **timeoutInMilliseconds** is supported. +Connection settings that define how long Microsoft Entra ID can wait for a response from an external app before it shuts down the connection when trying to trigger the external app. ## Properties |Property|Type|Description| |:|:|:| |timeoutInMilliseconds|Int32|The max duration in milliseconds that Microsoft Entra ID waits for a response from the external app before it shuts down the connection. The valid range is between `200` and `2000` milliseconds. Default duration is `1000`.|+|maximumRetries|Int32|The max number of retries that Microsoft Entra ID makes to the external API. Values of 0 or 1 are supported. If `null`, the default for the service applies.| ## Relationships None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.customExtensionClientConfiguration" Here's a JSON representation of the resource. ``` json { "@odata.type": "#microsoft.graph.customExtensionClientConfiguration",- "timeoutInMilliseconds": "Integer" + "timeoutInMilliseconds": "Integer", + "maximumRetries": "Integer" } ``` |
v1.0 | Customextensionendpointconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/customextensionendpointconfiguration.md | Namespace: microsoft.graph Abstract base type that exposes the derived types used to configure the **endpointConfiguration** property of a custom extension. This abstract type is inherited by the following type: -- [logicAppTriggerEndpointConfiguration](logicapptriggerendpointconfiguration.md) - configure this object.+- [logicAppTriggerEndpointConfiguration](logicapptriggerendpointconfiguration.md) - configure this object for the [customTaskExtension](../resources/identitygovernance-customtaskextension.md) in Lifecycle Workflows in Entitlement Management access package request and assignment cycles. +- [httpRequestEndpoint](../resources/httprequestendpoint.md) - configure this object to [validate a custom authentication extension](../api/customauthenticationextension-validateauthenticationconfiguration.md). ## Properties None. ## JSON representation -The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.customExtensionEndpointConfiguration", |
v1.0 | Customextensionoverwriteconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/customextensionoverwriteconfiguration.md | + + Title: "customExtensionOverwriteConfiguration resource type" +description: "Configuration regarding properties of the custom extension which can be overwritten per event listener. If no values are provided, the properties on the custom extension are used." ++ms.localizationpriority: medium ++++# customExtensionOverwriteConfiguration resource type ++Namespace: microsoft.graph ++Configuration regarding properties of the custom extension which can be overwritten per event listener. If no values are provided, the properties on the custom extension are used. ++## Properties +|Property|Type|Description| +|:|:|:| +|clientConfiguration|[customExtensionClientConfiguration](../resources/customextensionclientconfiguration.md)|Configuration regarding properties of the custom extension which can be overwritten per event listener. If no values are provided, the properties on the custom extension are used.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.customExtensionOverwriteConfiguration" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.customExtensionOverwriteConfiguration", + "clientConfiguration": { + "@odata.type": "microsoft.graph.customExtensionClientConfiguration" + } +} +``` + |
v1.0 | Customtimezone | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/customtimezone.md | Represents a time zone where the transition from standard to daylight saving tim ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Datetimetimezone | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/datetimetimezone.md | Describes the date, time, and time zone of a point in time. In general, the **timeZone** property _can_ be set to any of the [time zones currently supported by Windows](/windows-hardware/manufacture/desktop/default-time-zones), as well as the other [time zones supported by the calendar API](#additional-time-zones). - Methods such as [create](../api/user-post-events.md) or [update](../api/event-update.md) might not support all **dateTimeTimeZone** time zones.-- If you use **dateTimeTimeZone** with the [virtual event](../resources/virtualevent.md) APIs, the only supported format for the **timeZone** property is [time zones currently supported by Windows](/windows-hardware/manufacture/desktop/default-time-zones).+- If you use **dateTimeTimeZone** with the [virtual event](../resources/virtualevent.md) APIs, the only supported format for the **timeZone** property is time zones currently supported by Windows. For details on how to get all available time zones using PowerShell, see [Get-TimeZone](/powershell/module/microsoft.powershell.management/get-timezone#example-3-get-all-available-time-zones). ### Additional time zones |
v1.0 | Daylighttimezoneoffset | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/daylighttimezoneoffset.md | daylight saving time to standard occurs at 2 AM on the fourth Sunday of May, eve ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Defaultinvitationredemptionidentityproviderconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/defaultinvitationredemptionidentityproviderconfiguration.md | + + Title: "defaultInvitationRedemptionIdentityProviderConfiguration resource type" +description: "Defines the invitation redemption provider configuration to set redemption flow settings for Microsoft Entra ID B2B collaboration." ++ms.localizationpriority: medium ++++# defaultInvitationRedemptionIdentityProviderConfiguration resource type ++Namespace: microsoft.graph ++Defines the invitation redemption provider configuration to set redemption flow settings for Microsoft Entra ID B2B collaboration. ++Inherits from [invitationRedemptionIdentityProviderConfiguration](../resources/invitationRedemptionIdentityProviderConfiguration.md) ++## Properties ++|Property|Type|Description| +|:|:|:| +| primaryIdentityProviderPrecedenceOrder | b2bIdentityProvidersType collection | Collection of identity providers in priority order of preference to be used for guest invitation redemption. Possible values are: `azureActiveDirectory`, `externalFederation`, or `socialIdentityProviders`. | +| fallbackIdentityProvider | b2bIdentityProvidersType | The fallback identity provider to be used in case no primary identity provider can be used for guest invitation redemption. Possible values are: `defaultConfiguredIdp`, `emailOneTimePasscode`, or `microsoftAccount`. | ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.defaultInvitationRedemptionIdentityProviderConfiguration" +} +--> ++``` json +{ + "primaryIdentityProviderPrecedenceOrder": ["String"], + "fallbackIdentityProvider": "String" +} +``` |
v1.0 | Delegatedadminrelationship | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/delegatedadminrelationship.md | Represents a delegated admin relationship between a partner and customer. |requests|[delegatedAdminRelationshipRequest](../resources/delegatedadminrelationshiprequest.md) collection|The requests associated with the delegated admin relationship.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Delegatedadminrelationshipoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/delegatedadminrelationshipoperation.md | Represents a long-running operation related to a delegated admin relationship. A |data|String|The data (payload) for the operation. Read-only.| |id|String|The unique identifier of the delegated admin long-running operation. Read-only. Inherited from [entity](../resources/entity.md).| |lastModifiedDateTime|DateTimeOffset|The time in ISO 8601 format and in UTC time when the long-running operation was last modified. Read-only.|-|operationType|delegatedAdminRelationshipOperationType|The type of long-running operation. The possible values are: `delegatedAdminAccessAssignmentUpdate`, `unknownFutureValue`. Read-only.| +|operationType|delegatedAdminRelationshipOperationType|The type of long-running operation. The possible values are: `delegatedAdminAccessAssignmentUpdate`, `unknownFutureValue`,`delegatedAdminRelationshipUpdate`. Read-only. You must use the `Prefer: include-unknown-enum-members` request header to get the following value from this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `delegatedAdminRelationshipUpdate`.| |status|longRunningOperationStatus|The status of the operation. Read-only. The possible values are: `notStarted`, `running`, `succeeded`, `failed`, `unknownFutureValue`. Read-only. Supports `$orderby`.| ## Relationships None. ## JSON representation-The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Deleted | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/deleted.md | See [view changes for an item](../api/driveitem-delta.md) for more information o ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Deleteditemcontainer | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/deleteditemcontainer.md | Inherits from [entity](../resources/entity.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Detailsinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/detailsinfo.md | The **detailsInfo** resource is a JSON string that contains more properties such ## Relationships None ## JSON Representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", "@odata.type": "microsoft.graph.detailsInfo", |
v1.0 | Device | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/device.md | This resource is an open type that allows other properties to be passed in. You |deviceVersion|Int32| For internal use only. | |displayName|String|The display name for the device. Required. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values), `$search`, and `$orderby`. | |enrollmentProfileName|String|Enrollment profile applied to the device. For example, `Apple Device Enrollment Profile`, `Device enrollment - Corporate device identifiers`, or `Windows Autopilot profile name`. This property is set by Intune.|+|enrollmentType|String|Enrollment type of the device. This property is set by Intune. Possible values are: `unknown`, `userEnrollment`, `deviceEnrollmentManager`, `appleBulkWithUser`, `appleBulkWithoutUser`, `windowsAzureADJoin`, `windowsBulkUserless`, `windowsAutoEnrollment`, `windowsBulkAzureDomainJoin`, `windowsCoManagement`.| | extensionAttributes | [onPremisesExtensionAttributes](onpremisesextensionattributes.md) | Contains extension attributes 1-15 for the device. The individual extension attributes are not selectable. These properties are mastered in cloud and can be set during creation or update of a device object in Microsoft Entra ID. <br><br>Supports `$filter` (`eq`, `not`, `startsWith`, and `eq` on `null` values). | |id|String|The unique identifier for the device. Inherited from [directoryObject](directoryobject.md). Key, Not nullable. Read-only. Supports `$filter` (`eq`, `ne`, `not`, `in`). | |isCompliant|Boolean|`true` if the device complies with Mobile Device Management (MDM) policies; otherwise, `false`. Read-only. This can only be updated by Intune for any device OS type or by an [approved MDM app](/windows/client-management/mdm/azure-active-directory-integration-with-mdm) for Windows OS devices. Supports `$filter` (`eq`, `ne`, `not`).| |isManaged|Boolean|`true` if the device is managed by a Mobile Device Management (MDM) app; otherwise, `false`. This can only be updated by Intune for any device OS type or by an [approved MDM app](/windows/client-management/mdm/azure-active-directory-integration-with-mdm) for Windows OS devices. Supports `$filter` (`eq`, `ne`, `not`). | |manufacturer|String| Manufacturer of the device. Read-only. |+|isRooted|Boolean|`true` if the device is rooted; `false` if the device is jail-broken. This property can only be updated by Intune.| +|managementType|String|The management channel of the device. This property is set by Intune. Possible values are: `eas`, `mdm`, `easMdm`, `intuneClient`, `easIntuneClient`, `configurationManagerClient`, `configurationManagerClientMdm`, `configurationManagerClientMdmEas`, `unknown`, `jamf`, `googleCloudDevicePolicyController`.| |mdmAppId|String|Application identifier used to register device into MDM. Read-only. Supports `$filter` (`eq`, `ne`, `not`, `startsWith`).| |model|String| Model of the device. Read-only. | |onPremisesLastSyncDateTime|DateTimeOffset|The last time at which the object was synced with the on-premises directory. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z` Read-only. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`).|+|onPremisesSecurityIdentifier|String|The on-premises security identifier (SID) for the user who was synchronized from on-premises to the cloud. Read-only. Returned only on `$select`. Supports `$filter` (`eq`).| |onPremisesSyncEnabled|Boolean|`true` if this object is synced from an on-premises directory; `false` if this object was originally synced from an on-premises directory but is no longer synced; `null` if this object has never been synced from an on-premises directory (default). Read-only. Supports `$filter` (`eq`, `ne`, `not`, `in`, and `eq` on `null` values). | |operatingSystem|String| The type of operating system on the device. Required. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `startsWith`, and `eq` on `null` values). | |operatingSystemVersion|String|The version of the operating system on the device. Required. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `startsWith`, and `eq` on `null` values). | The following is a JSON representation of the resource. "deviceVersion": "Int32", "displayName": "String", "enrollmentProfileName": "String",+ "enrollmentType": "String", "extensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"}, "id": "String (identifier)", "isCompliant": "Boolean", "isManaged": "Boolean",+ "isRooted": "Boolean", + "managementType": "String", "manufacturer": "String", "mdmAppId": "String", "model": "String", "onPremisesLastSyncDateTime": "String (timestamp)",+ "onPremisesSecurityIdentifier": "Boolean", "onPremisesSyncEnabled": "Boolean", "operatingSystem": "String", "operatingSystemVersion": "String", |
v1.0 | Devicedetail | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/devicedetail.md | Indicates device details associated with a device used for signing in. The infor ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Directory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/directory.md | Inherits from [entity](entity.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Directoryaudit | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/directoryaudit.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Directoryrole | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/directoryrole.md | This resource supports: ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Directoryroletemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/directoryroletemplate.md | None ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Domain | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/domain.md | Title: "domain resource type" description: "Represents a domain associated with the tenant."-+ ms.localizationpriority: medium doc_type: resourcePageType Namespace: microsoft.graph Represents a domain associated with the tenant. -Use domain operations to associate domains to a tenant, verify domain ownership, and configure supported services. Domain operations enable registrars to automate domain association for services such as Microsoft 365. For example, as part of domain sign up, a registrar can enable a vanity domain for email, websites, authentication, etc. +Use domain operations to associate domains to a tenant, verify domain ownership, and configure supported services. Domain operations enable registrars to automate domain association for services such as Microsoft 365. For example, as part of domain sign-up, a registrar can enable a vanity domain for email, websites, authentication, etc. To associate a domain with a tenant: To associate a domain with a tenant: 2. [Retrieve](../api/domain-list-verificationdnsrecords.md) the domain verification records. Add the verification record details to the domain's zone file using the domain registrar or DNS server configuration. -3. [Verify](../api/domain-verify.md) the ownership of the domain. This will verify the domain and set the **isVerified** property to `true`. +3. [Verify](../api/domain-verify.md) the ownership of the domain. This verifies the domain and sets the **isVerified** property to `true`. 4. [Indicate](../api/domain-update.md) the supported services you plan to use with the domain. To associate a domain with a tenant: | Property | Type | Description | |:|:--|:-|-|authenticationType|String| Indicates the configured authentication type for the domain. The value is either `Managed` or `Federated`. `Managed` indicates a cloud managed domain where Microsoft Entra ID performs user authentication. `Federated` indicates authentication is federated with an identity provider such as the tenant's on-premises Active Directory via Active Directory Federation Services. Not nullable. | +|authenticationType|String| Indicates the configured authentication type for the domain. The value is either `Managed` or `Federated`. `Managed` indicates a cloud managed domain where Microsoft Entra ID performs user authentication. `Federated` indicates authentication is federated with an identity provider such as the tenant's on-premises Active Directory via Active Directory Federation Services. Not nullable. <br/><br/>To update this property in delegated scenarios, the calling app must be assigned the *Directory.AccessAsUser.All* delegated permission. | |availabilityStatus|String| This property is always `null` except when the [verify](../api/domain-verify.md) action is used. When the [verify](../api/domain-verify.md) action is used, a **domain** entity is returned in the response. The **availabilityStatus** property of the **domain** entity in the response is either `AvailableImmediately` or `EmailVerifiedDomainTakeoverScheduled`.| |id|String| The fully qualified name of the domain. Key, immutable, not nullable, unique. |-|isAdminManaged|Boolean| The value of the property is `false` if the DNS record management of the domain has been delegated to Microsoft 365. Otherwise, the value is `true`. Not nullable | -|isDefault|Boolean| `true` if this is the default domain that is used for user creation. There is only one default domain per company. Not nullable | -|isInitial|Boolean| `true` if this is the initial domain created by Microsoft Online Services (contoso.com). There is only one initial domain per company. Not nullable | +|isAdminManaged|Boolean| The value of the property is `false` if the DNS record management of the domain is delegated to Microsoft 365. Otherwise, the value is `true`. Not nullable | +|isDefault|Boolean| `true` if this is the default domain that is used for user creation. There's only one default domain per company. Not nullable | +|isInitial|Boolean| `true` if this is the initial domain created by Microsoft Online Services (contoso.com). There's only one initial domain per company. Not nullable | |isRoot|Boolean| `true` if the domain is a verified root domain. Otherwise, `false` if the domain is a subdomain or unverified. Not nullable | |isVerified|Boolean| `true` if the domain has completed domain ownership verification. Not nullable |-|passwordNotificationWindowInDays|Int32|Specifies the number of days before a user receives notification that their password will expire. If the property is not set, a default value of 14 days will be used.| -|passwordValidityPeriodInDays|Int32| Specifies the length of time that a password is valid before it must be changed. If the property is not set, a default value of 90 days will be used. | +|passwordNotificationWindowInDays|Int32|Specifies the number of days before a user receives notification that their password will expire. If the property isn't set, a default value of 14 days is used.| +|passwordValidityPeriodInDays|Int32| Specifies the length of time that a password is valid before it must be changed. If the property isn't set, a default value of 90 days is used. | |state|[domainState](domainstate.md)| Status of asynchronous operations scheduled for the domain. |-|supportedServices|String collection| The capabilities assigned to the domain. Can include `0`, `1` or more of following values: `Email`, `Sharepoint`, `EmailInternalRelayOnly`, `OfficeCommunicationsOnline`, `SharePointDefaultDomain`, `FullRedelegation`, `SharePointPublic`, `OrgIdAuthentication`, `Yammer`, `Intune`. The values which you can add/remove using Graph API include: `Email`, `OfficeCommunicationsOnline`, `Yammer`. Not nullable.| +|supportedServices|String collection| The capabilities assigned to the domain. Can include `0`, `1` or more of following values: `Email`, `Sharepoint`, `EmailInternalRelayOnly`, `OfficeCommunicationsOnline`, `SharePointDefaultDomain`, `FullRedelegation`, `SharePointPublic`, `OrgIdAuthentication`, `Yammer`, `Intune`. The values that you can add or remove using the API include: `Email`, `OfficeCommunicationsOnline`, `Yammer`. Not nullable.| ## Relationships Relationships between a domain and other objects in the directory such as its ve | Relationship | Type |Description| |:|:--|:-|-|domainNameReferences|[directoryObject](directoryobject.md) collection| The objects such as users and groups that reference the domain ID. Read-only, Nullable. Supports `$expand` and `$filter` by the OData type of objects returned. For example `/domains/{domainId}/domainNameReferences/microsoft.graph.user` and `/domains/{domainId}/domainNameReferences/microsoft.graph.group`.| +|domainNameReferences|[directoryObject](directoryobject.md) collection| The objects such as users and groups that reference the domain ID. Read-only, Nullable. Supports `$expand` and `$filter` by the OData type of objects returned. For example, `/domains/{domainId}/domainNameReferences/microsoft.graph.user` and `/domains/{domainId}/domainNameReferences/microsoft.graph.group`.| |serviceConfigurationRecords|[domainDnsRecord](domaindnsrecord.md) collection| DNS records the customer adds to the DNS zone file of the domain before the domain can be used by Microsoft Online services. Read-only, Nullable. Supports `$expand`. | |verificationDnsRecords|[domainDnsRecord](domaindnsrecord.md) collection| DNS records that the customer adds to the DNS zone file of the domain before the customer can complete domain ownership verification with Microsoft Entra ID. Read-only, Nullable. Supports `$expand`.| |federationConfiguration|[internalDomainFederation](internaldomainfederation.md)| Domain settings configured by a customer when federated with Microsoft Entra ID. Supports `$expand`.| ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Domaindnscnamerecord | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/domaindnscnamerecord.md | Title: "domainDnsCnameRecord resource type" description: "Represents a CNAME record added to the DNS zone file of a particular domain in the tenant."-+ ms.localizationpriority: medium doc_type: resourcePageType Represents a CNAME record added to the DNS zone file of a particular domain in t Direct queries to this resource aren't supported. See the [domain](domain.md) article for information on how to query for domain service records. ## Properties-| Property | Type |Description| +| Property | Type |Description| |:|:--|:-| |canonicalName|String| The canonical name of the CNAME record. Used to configure the CNAME record at the DNS host. | |id|String| Unique identifier assigned to this entity. Not nullable, Read-only| None ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Domaindnsmxrecord | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/domaindnsmxrecord.md | Title: "domainDnsMxRecord resource type" description: "Represents a MX record added to the DNS zone file of a particular domain in the tenant."-+ ms.localizationpriority: medium doc_type: resourcePageType Represents a MX record added to the DNS zone file of a particular domain in the Direct queries to this resource aren't supported. See the [domain](domain.md) article for information on how to query for domain service records. ## Properties-| Property | Type |Description| +| Property | Type |Description| |:|:--|:-| |id|String| Unique identifier assigned to this entity. Not nullable, Read-only.| |isOptional|Boolean| If false, the MX record must be configured by the customer at the DNS host for Microsoft Online Services to operate correctly with the domain. | Direct queries to this resource aren't supported. See the [domain](domain.md) ar None ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Domaindnsrecord | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/domaindnsrecord.md | Title: "domainDnsRecord resource type" description: "The domainDnsRecord entity is used to present DNS records." ms.localizationpriority: medium-+ doc_type: resourcePageType doc_type: resourcePageType Namespace: microsoft.graph -For each [domain](domain.md) in the tenant, you may be required to add DNS record(s) to the DNS zone file of the domain before the domain can be used by Microsoft Online Services. These DNS records are represented +For each [domain](domain.md) in the tenant, you may be required to add DNS records to the DNS zone file of the domain before the domain can be used by Microsoft Online Services. These DNS records are represented. The **domainDnsRecord** resource type is used to present such DNS records as exposed through the **serviceConfigurationRecords** and **verificationDnsRecords**. This resource type is the base entity for the following resources: + [domainDnsCnameRecord](domaindnscnamerecord.md) The **domainDnsRecord** resource type is used to present such DNS records as exp None. ## Properties-| Property | Type |Description| +| Property | Type |Description| |:|:--|:-| |id|String| Unique identifier assigned to this entity. Not nullable, Read-only.|-|isOptional|Boolean| If `false`, this record must be configured by the customer at the DNS host for Microsoft Online Services to operate correctly with the domain. | +|isOptional|Boolean| If `false`, the customer must configure this record at the DNS host for Microsoft Online Services to operate correctly with the domain. | |label|String| Value used when configuring the name of the DNS record at the DNS host. | |recordType|String| Indicates what type of DNS record this entity represents. The value can be `CName`, `Mx`, `Srv`, or `Txt`. | |supportedService|String| Microsoft Online Service or feature that has a dependency on this DNS record. Can be one of the following values: `null`, `Email`, `Sharepoint`, `EmailInternalRelayOnly`, `OfficeCommunicationsOnline`, `SharePointDefaultDomain`, `FullRedelegation`, `SharePointPublic`, `OrgIdAuthentication`, `Yammer`, `Intune`.| None. None ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Domaindnssrvrecord | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/domaindnssrvrecord.md | Title: "domainDnsSrvRecord resource type" description: "Represents a SRV record added to the DNS zone file of a particular domain in the tenant."-+ ms.localizationpriority: medium doc_type: resourcePageType None ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Domaindnstxtrecord | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/domaindnstxtrecord.md | Title: "domainDnsTxtRecord resource type" description: "Represents a TXT record added to the DNS zone file of a particular domain in the tenant."-+ ms.localizationpriority: medium doc_type: resourcePageType Represents a TXT record added to the DNS zone file of a particular domain in the Direct queries to this resource aren't supported. See the [domain](domain.md) article for information on how to query for domain service records. ## Properties-| Property | Type |Description| +| Property | Type |Description| |:|:--|:-| |id|String| Unique identifier assigned to this entity. Not nullable, Read-only. | |isOptional|Boolean| If false, the TXT record must be configured by the customer at the DNS host for Microsoft Online Services to operate correctly with the domain. | None ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Domaindnsunavailablerecord | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/domaindnsunavailablerecord.md | Title: "domainDnsUnavailableRecord resource type" description: "Indicates that serviceConfigurationRecords can't be generated." ms.localizationpriority: medium-+ doc_type: resourcePageType When you query for the navigation property **serviceConfigurationRecords** for a Direct queries to this resource aren't supported. See the [domain](domain.md) article for information on how to query for domain service records. ## Properties-| Property | Type |Description| +| Property | Type |Description| |:|:--|:-| |description|String|Provides the reason why the **DomainDnsUnavailableRecord** entity is returned. | Direct queries to this resource aren't supported. See the [domain](domain.md) ar None ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Domainidentitysource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/domainidentitysource.md | When you're [creating a new connectedOrganization](../api/entitlementmanagement- ## Relationships None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.domainIdentitySource", |
v1.0 | Domainstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/domainstate.md | Title: "domainState resource type" description: "Represents the status of asynchronous operations scheduled on a domain."-+ ms.localizationpriority: medium doc_type: resourcePageType Represents the status of asynchronous operations scheduled on a domain. | Property | Type | Description | |:|:--|:-| | lastActionDateTime | DateTimeOffset | Timestamp for when the last activity occurred. The value is updated when an operation is scheduled, the asynchronous task starts, and when the operation completes. |-| operation | String | Type of asynchronous operation. The values can be *ForceDelete* or *Verification* | -| status | String | Current status of the operation. <br> *Scheduled* - Operation has been scheduled but has not started. <br> *InProgress* - Task has started and is in progress. <br> *Failed* - Operation has failed. | +| operation | String | Type of asynchronous operation. The values can be `ForceDelete` or `Verification`. | +| status | String | Current status of the operation. <br> `Scheduled` - Operation is scheduled but hasn't started. <br> `InProgress` - Task is in progress. <br> `Failed` - The operation failed. | ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Educationassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationassignment.md | Inherits from [entity](../resources/entity.md). |id|String| The unique identifier for the **assignment**. Inherited from [entity](../resources/entity.md). Read-only.| |instructions|[itemBody](itembody.md)| Instructions for the assignment. The instructions and the display name tell the student what to do. | |lastModifiedBy|[identitySet](identityset.md)| Who last modified the **assignment**. |-|lastModifiedDateTime|DateTimeOffset|Moment when the **assignment** was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| +|lastModifiedDateTime|DateTimeOffset|The date and time on which the **assignment** was modified. A student submission doesn't modify the assignment; only teachers can update assignments. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| |moduleUrl|string| The URL of the module from which to access the **assignment**.| |notificationChannelUrl|String|Optional field to specify the URL of the [channel](channel.md) to post the **assignment** publish notification. If not specified or null, defaults to the `General` channel. This field only applies to **assignments** where the **assignTo** value is [educationAssignmentClassRecipient](educationassignmentclassrecipient.md). Updating the **notificationChannelUrl** isn't allowed after the assignment is published.| |resourcesFolderUrl|string| Folder URL where all the file resources for this **assignment** are stored.| |
v1.0 | Educationassignmentpointsgrade | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationassignmentpointsgrade.md | which will add the who data to this property. The max points are stored in the * ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Educationassignmentresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationassignmentresource.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Educationassignmentsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationassignmentsettings.md | Specifies class-level assignments settings. |gradingCategories|[educationGradingCategory](educationgradingcategory.md) collection| When set, enables users to weight assignments differently when computing a class average grade.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Educationlinkresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationlinkresource.md | This resource is a link and doesn't have any other data associated with it. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Educationorganization | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationorganization.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Educationschool | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationschool.md | Inherits from [educationOrganization](../resources/educationorganization.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Educationsubmission | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationsubmission.md | If [setUpResourcesFolder](../api/educationsubmission-setupResourcesFolder.md) ha |resourcesFolderUrl|String|Folder where all file resources for this submission need to be stored.| |returnedBy|[identitySet](identityset.md)|User who moved the status of this submission to returned.| |returnedDateTime|DateTimeOffset|Moment in time when the submission was returned. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.|-|status|string| Read-only. Possible values are: `working`, `submitted`, `returned`, and `reassigned`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `reassigned`.| +|status|educationSubmissionStatus| Read-only. Possible values are: `working`, `submitted`, `returned`, and `reassigned`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `reassigned`.| |submittedBy|[identitySet](identityset.md)|User who moved the resource into the submitted state.| |submittedDateTime|DateTimeOffset|Moment in time when the submission was moved into the submitted state. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| |unsubmittedBy|[identitySet](identityset.md)|User who moved the resource from submitted into the working state.| |
v1.0 | Educationsubmissionresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationsubmissionresource.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Educationterm | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationterm.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Emailaddress | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/emailaddress.md | The name and email address of a contact or message recipient. ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Emailauthenticationmethodconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/emailauthenticationmethodconfiguration.md | Inherits from [authenticationMethodConfiguration](../resources/authenticationmet ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Emailfileassessmentrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/emailfileassessmentrequest.md | Inherits from [threatAssessmentRequest](threatassessmentrequest.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Emailidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/emailidentity.md | Inherits from [identity](../resources/identity.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.emailIdentity" |
v1.0 | Employeeorgdata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/employeeorgdata.md | Title: "employeeOrgData resource type" description: "Represents organization data associated with a user." ms.localizationpriority: medium doc_type: resourcePageType+ |
v1.0 | Entitlementmanagement Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/entitlementmanagement-overview.md | The following table lists the methods that you can use to interact with entitlem ## Related content - [What is Microsoft Entra entitlement management?](/azure/active-directory/governance/entitlement-management-overview)-- [subjectSet](subjectset.md) subtypes [singleUser](singleuser.md), [groupMembers](groupmembers.md), [connectedOrganizationMembers](connectedorganizationmembers.md), [requestorManager](requestormanager.md), [internalSponsors](internalsponsors.md), and [externalSponsors](externalsponsors.md).+- [subjectSet](subjectset.md) subtypes [singleUser](singleuser.md), [groupMembers](groupmembers.md), [connectedOrganizationMembers](connectedorganizationmembers.md), [requestorManager](requestormanager.md), [internalSponsors](internalsponsors.md), [externalSponsors](externalsponsors.md), and [targetUserSponsors](targetusersponsors.md). - [accessPackageSubject](accesspackagesubject.md) - Used in the [accessPackageAssignment](accesspackageassignment.md) as a subject user who has an access package assignment. - [identitySource](identitysource.md) - used in the [connectedOrganization](connectedorganization.md), one of [azureActiveDirectoryTenant](azureactivedirectorytenant.md), [domainIdentitySource](domainidentitysource.md) or [externalDomainFederation](externaldomainfederation.md). |
v1.0 | Entity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/entity.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Enums Security | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/enums-security.md | +### actionAfterRetentionPeriod values ++| Member | +| : | +| none | +| delete | +| startDispositionReview | +| unknownFutureValue | + ### behaviorDuringRetentionPeriod values | Member | Namespace: microsoft.graph.security | markdown | | unknownFutureValue | +### defaultRecordBehavior values ++| Member | +| :-- | +| startLocked | +| startUnlocked | +| unknownFutureValue | + ### detectionStatus values | Member Namespace: microsoft.graph.security | messages | | unknownFutureValue | +### retentionTrigger values ++| Member | +| :-- | +| dateLabeled | +| dateCreated | +| dateModified | +| dateOfEvent | +| unknownFutureValue | + ### vulnerabilitySeverity values | Member | |
v1.0 | Enums | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/enums.md | Namespace: microsoft.graph | serviceProvider | | unknownFutureValue | +### migrationStatus values ++|Member| +|:| +|ready| +|needsReview| +|additionalStepsRequired| +|unknownFutureValue| + ### appCredentialRestrictionType values | Member | Namespace: microsoft.graph | user | | group | +### multiTenantOrganizationMemberProcessingStatus values ++|Member| +|:| +|notStarted| +|running| +|succeeded| +|failed| +|unknownFutureValue| ++### multiTenantOrganizationMemberRole values ++|Member| +|:| +|owner| +|member| +|unknownFutureValue| ++### multiTenantOrganizationMemberState values ++|Member| +|:| +|pending| +|active| +|removed| +|unknownFutureValue| ++### multiTenantOrganizationState values ++|Member| +|:| +|active| +|inactive| +|unknownFutureValue| ++### templateApplicationLevel values ++|Member| +|:| +|none| +|newPartners| +|existingPartners| +|unknownFutureValue| + ### federatedIdpMfaBehavior values | Member | | :- | Possible values for user account types (group membership), per Windows definitio | Failed | | EntryLevelErrors | +### stagedFeatureName values ++| Member | +|:-| +| passthroughAuthentication | +| seamlessSso | +| passwordHashSync | +| emailAsAlternateId | +| unknownFutureValue | +| certificateBasedAuthentication | +| multiFactorAuthentication | + ### synchronizationJobRestartScope values |Member| Possible values for user account types (group membership), per Windows definitio | assigned | | unknownFutureValue | | inactive |++### b2bIdentityProvidersType values ++|Member| +|:--| +|azureActiveDirectory| +|externalFederation| +|socialIdentityProviders| +|emailOneTimePasscode| +|microsoftAccount| +|defaultConfiguredIdp| +|unknownFutureValue| |
v1.0 | Event | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/event.md | This resource supports: ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Eventmessage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/eventmessage.md | Aside from a meeting request, an **eventMessage** instance can be found in an in ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Eventmessagerequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/eventmessagerequest.md | To respond to the meeting request, first, use the **event** navigation property ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Extension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/extension.md | An abstract type to support the OData v4 open type [openTypeExtension](opentypee ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "abstract": "true", |
v1.0 | Extensionproperty | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/extensionproperty.md | Title: "extensionProperty resource type (directory extensions)" description: "Represents a directory extension." ms.localizationpriority: medium + doc_type: "resourcePageType" |
v1.0 | Extensionschemaproperty | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/extensionschemaproperty.md | Title: "extensionSchemaProperty resource type" description: "Use the **extensionSchemaProperty** resource to define a property's name and its type, as part of a schemaExtension definition." ms.localizationpriority: medium + doc_type: resourcePageType Use the **extensionSchemaProperty** resource to define a property's name and its ## Properties-| Property | Type |Description| +| Property | Type |Description| |:|:--|:-| |name|String| The name of the strongly typed property defined as part of a schema extension.|-|type|String| The type of the property that is defined as part of a schema extension. Allowed values are `Binary`, `Boolean`, `DateTime`, `Integer` or `String`. See the table in the Supported property data types section for more details.| +|type|String| The type of the property that is defined as part of a schema extension. Allowed values are `Binary`, `Boolean`, `DateTime`, `Integer`, or `String`. For more information, see [Supported property data types](#supported-property-data-types).| ### Supported property data types The following data types are supported when defining a property in a schema exte | Property Type | Remarks | |-|| | Binary | 256 bytes maximum. |-| Boolean | Not supported for contacts, messages, events and posts. | +| Boolean | Not supported for contacts, messages, events, and posts. | | DateTime | Must be specified in ISO 8601 format and is stored in UTC. | | Integer | 32-bit value. Not supported for contacts, messages, events and posts. | | String | 256 characters maximum. | ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Externalconnectors Acl | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/externalconnectors-acl.md | An access control entry for an item indexed by a Microsoft Search externalConnec None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.externalConnectors.acl" |
v1.0 | Externalconnectors Identity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/externalconnectors-identity.md | Represents an [identity](externalconnectors-identity.md) used to set permissions None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Externalconnectors Property | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/externalconnectors-property.md | A [schema](externalconnectors-schema.md) property definition for a Microsoft Sea None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.externalConnectors.property" |
v1.0 | Externalsponsors | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/externalsponsors.md | None. ## Relationships None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.externalSponsors", |
v1.0 | Featurerolloutpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/featurerolloutpolicy.md | Title: "featureRolloutPolicy resource type" description: "Represents a feature rollout policy associated with a directory object." ms.localizationpriority: medium + doc_type: "resourcePageType" The following are limitations of feature rollout: - The **appliesTo** field only supports groups. - Dynamic groups and nested groups are not supported. -The following are pre-requisites for each of the features that are currently supported for rollout using this rollout policy. --### Passthrough Authentication --* Identify a server running Windows Server 2012 R2 or later where you want the [PassthroughAuthentication](/azure/active-directory/hybrid/how-to-connect-pta) Agent to run. Ensure that the server is domain-joined, can authenticate selected users with Active Directory, and can communicate with Microsoft Entra ID on outbound ports / URLs. -* [Download](https://aka.ms/getauthagent) & install the Microsoft Entra Connect Authentication Agent on the server. -* To enable high availability, install additional Authentication Agents on other servers as described [here](/azure/active-directory/hybrid/how-to-connect-pta-quick-start#step-4-ensure-high-availability). -* Ensure that you have configured your [Smart Lockout](/azure/active-directory/authentication/howto-password-smart-lockout) settings appropriately. This is to ensure that your users’ on-premises Active Directory accounts don’t get locked out by bad actors. --### SeamlessSso --* Enable [SeamlessSso](/azure/active-directory/hybrid/how-to-connect-sso) for the AD forests based on [these](/azure/active-directory/hybrid/tshoot-connect-sso#manual-reset-of-the-feature) instructions. --### PasswordHashSync --* Enable [PasswordHashSync](/azure/active-directory/hybrid/whatis-phs) from the “Optional features” page in Microsoft Entra Connect. --### EmailAsAlternateId --* Associate alternate email with user accounts. +For more information about staged rollout, see [How to configure staged rollout in Microsoft Entra ID](https://www.youtube.com/watch?v=LFTE1epYDFQ). ## Methods The following are pre-requisites for each of the features that are currently sup |:-|:|:| |description|String|A description for this feature rollout policy.| |displayName|String|The display name for this feature rollout policy.|-|feature|stagedFeatureName| Possible values are: `passthroughAuthentication`, `seamlessSso`, `passwordHashSync`, `emailAsAlternateId`, `unknownFutureValue`.| +|feature|stagedFeatureName| Possible values are: `passthroughAuthentication`, `seamlessSso`, `passwordHashSync`, `emailAsAlternateId`, `unknownFutureValue`, `certificateBasedAuthentication`, `multiFactorAuthentication`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value or values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `certificateBasedAuthentication`, `multiFactorAuthentication`. For more information about the prerequisites for the enabled features, see [Prerequisites for enabled features](#prerequisites-for-enabled-features).| |id|String| Read-only.| |isAppliedToOrganization|Boolean|Indicates whether this feature rollout policy should be applied to the entire organization.| |isEnabled|Boolean|Indicates whether the feature rollout is enabled.| -### stagedFeatureName values +### Prerequisites for enabled features ++The following are prerequisites for each of the features that are currently supported for rollout using this rollout policy. -|Member| -|:| -|passthroughAuthentication| -|seamlessSso| -|passwordHashSync| -|emailAsAlternateId| -|unknownFutureValue| +#### Passthrough Authentication ++* Identify a server running Windows Server 2012 R2 or later where you want the [PassthroughAuthentication](/azure/active-directory/hybrid/how-to-connect-pta) Agent to run. Ensure that the server is domain-joined, can authenticate selected users with Active Directory, and can communicate with Microsoft Entra ID on outbound ports / URLs. +* [Download](https://aka.ms/getauthagent) & install the Microsoft Entra Connect Authentication Agent on the server. +* To enable high availability, install additional Authentication Agents on other servers as described [here](/azure/active-directory/hybrid/how-to-connect-pta-quick-start#step-4-ensure-high-availability). +* Ensure that you've configured your [Smart Lockout](/azure/active-directory/authentication/howto-password-smart-lockout) settings appropriately. This is to ensure that your users' on-premises Active Directory accounts don't get locked out by bad actors. ++#### SeamlessSso ++* Enable [SeamlessSso](/azure/active-directory/hybrid/how-to-connect-sso) for the AD forests based on [these](/azure/active-directory/hybrid/tshoot-connect-sso#manual-reset-of-the-feature) instructions. ++#### PasswordHashSync ++* Enable [PasswordHashSync](/azure/active-directory/hybrid/whatis-phs) from the "Optional features" page in Microsoft Entra Connect. ++#### EmailAsAlternateId ++* Associate alternate email with user accounts. ## Relationships | Relationship | Type | Description | |:-|:|:|-|appliesTo|[directoryObject](directoryobject.md) collection| Nullable. Specifies a list of directoryObjects that feature is enabled for.| +|appliesTo|[directoryObject](directoryobject.md) collection| Nullable. Specifies a list of directoryObject resources that feature is enabled for.| ## JSON representation -The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", The following is a JSON representation of the resource. } ``` +## Related content ++- [Migrate to cloud authentication using Staged Rollout](/entra/identity/hybrid/connect/how-to-connect-staged-rollout) + <!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98 2019-02-04 14:57:30 UTC --> <!-- { |
v1.0 | Federatedidentitycredential | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/federatedidentitycredential.md | Inherits from [entity](../resources/entity.md). |[Create federatedIdentityCredential](../api/application-post-federatedidentitycredentials.md)|[federatedIdentityCredential](../resources/federatedidentitycredential.md)|Create a new [federatedIdentityCredential](../resources/federatedidentitycredential.md) object.| |[Get federatedIdentityCredential](../api/federatedidentitycredential-get.md)|[federatedIdentityCredential](../resources/federatedidentitycredential.md)|Read the properties and relationships of a [federatedIdentityCredential](../resources/federatedidentitycredential.md) object.| |[Update federatedIdentityCredential](../api/federatedidentitycredential-update.md)|None|Update the properties of a [federatedIdentityCredential](../resources/federatedidentitycredential.md) object.|+|[Upsert federatedIdentityCredential](../api/federatedidentitycredential-upsert.md)|[federatedIdentityCredential](../resources/federatedidentitycredential.md)|Create a new [federatedIdentityCredential](../resources/federatedidentitycredential.md) if it doesn't exist, or update the properties of an existing [federatedIdentityCredential](../resources/federatedidentitycredential.md) object.| |[Delete federatedIdentityCredential](../api/federatedidentitycredential-delete.md)|None|Deletes a [federatedIdentityCredential](../resources/federatedidentitycredential.md) object.| ## Properties Inherits from [entity](../resources/entity.md). | description | String | The unvalidated description of the federated identity credential, provided by the user. It has a limit of 600 characters. Optional. | | id| String | The unique identifier for the federated identity. Required. Read-only. | | issuer | String | The URL of the external identity provider, which must match the `issuer` claim of the external token being exchanged. The combination of the values of **issuer** and **subject** must be unique within the app. It has a limit of 600 characters. Required. |-| name | String | The unique identifier for the federated identity credential, which has a limit of 120 characters and must be URL friendly. The string is immutable after it's created. Required. Not nullable. Supports `$filter` (`eq`). | +| name | String | The unique identifier for the federated identity credential, which has a limit of 120 characters and must be URL friendly. The string is immutable after it's created. Alternate key. Required. Not nullable. Supports `$filter` (`eq`). | | subject | String | Required. The identifier of the external software workload within the external identity provider. Like the audience value, it has no fixed format; each identity provider uses their own - sometimes a GUID, sometimes a colon delimited identifier, sometimes arbitrary strings. The value here must match the `sub` claim within the token presented to Microsoft Entra ID. The combination of **issuer** and **subject** must be unique within the app. It has a limit of 600 characters. Supports `$filter` (`eq`). | |
v1.0 | Fido2combinationconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/fido2combinationconfiguration.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | File | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/file.md | In addition to other properties, files have a **content** relationship that cont ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Fileassessmentrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/fileassessmentrequest.md | The file can be a text file or Word document or binary file received in an email ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Fileattachment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/fileattachment.md | None. ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Filter | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/filter.md | Manages the filtering of a table's column. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Filterdatetime | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/filterdatetime.md | Title: "FilterDatetime resource type" + Title: "filterDatetime resource type" description: "Represents how to filter a date when filtering on values." ms.localizationpriority: medium -# FilterDatetime resource type +# filterDatetime resource type Namespace: microsoft.graph Represents how to filter a date when filtering on values. ## Properties | Property | Type |Description| |:|:--|:-|-|date|string|The date in ISO8601 format used to filter data.| -|specificity|string|How specific the date should be used to keep data. For example, if the date is 2005-04-02 and the specificity is set to "month", the filter operation will keep all rows with a date in the month of April 2009. The possible values are: `Year`, `Monday`, `Day`, `Hour`, `Minute`, `Second`.| +|date|String|The date in ISO 8601 format used to filter data.| +|specificity|String|Defines how specific you should use the **date** to keep data. For example, if the date is `2005-04-02` and the **specificity** property is set to `month`, the filter operation keeps all rows with a date in the month of April 2009. The possible values are: `Year`, `Month`, `Day`, `Hour`, `Minute`, `Second`.| ## Relationships-None +None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", Here's a JSON representation of the resource. ```json {- "date": "string", - "specificity": "string" + "date": "String", + "specificity": "String" }- ``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 |
v1.0 | Folder | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/folder.md | The **Folder** resource groups folder-related data on an item into a single stru ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Followupflag | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/followupflag.md | Allows setting a flag in an item for the user to follow up on later. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Formatprotection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/formatprotection.md | None. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Genericerror | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/genericerror.md | A general-purpose error. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", Here is a JSON representation of the resource. ```json {+ "@odata.type": "#microsoft.graph.genericError", "code": "String", "message": "String" } |
v1.0 | Geocoordinates | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/geocoordinates.md | If a [**DriveItem**](driveitem.md) has a non-null **location** facet, the item r ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Group | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/group.md | This resource supports: | [Get group](../api/group-get.md) | [group](group.md) | Read properties of a group object. | | [List groups](../api/group-list.md) | [group](group.md) collection | List group objects and their properties. | | [Update group](../api/group-update.md) | None | Update the properties of a group object. |+| [Upsert group](../api/group-upsert.md) | [group](group.md) | Create a new group if it doesn't exist, or update the properties of an existing group. | | [Delete group](../api/group-delete.md) | None | Delete group object. | | [delta](../api/group-delta.md) | group collection | Get incremental changes for groups. | | [Add members](../api/group-post-members.md) | None | Add a member to this group by posting to the **members** navigation property (supported for security groups and Microsoft 365 groups only). | This resource supports: | securityIdentifier | String | Security identifier of the group, used in Windows scenarios. <br><br>Returned by default. | | serviceProvisioningErrors | [serviceProvisioningError](serviceprovisioningerror.md) collection | Errors published by a federated service describing a non-transient, service-specific error regarding the properties or link from a group object . <br><br> Supports `$filter` (`eq`, `not`, for isResolved and serviceInstance). | | theme | string | Specifies a Microsoft 365 group's color theme. Possible values are `Teal`, `Purple`, `Green`, `Blue`, `Pink`, `Orange` or `Red`. <br><br>Returned by default. |+| uniqueName | String | The unique identifier that can be assigned to a group and used as an alternate key. Immutable. Read-only. | +| unseenConversationsCount | Int32 | Count of conversations delivered one or more new posts since the signed-in user's last visit to the group. This property is the same as **unseenCount**. <br><br>Returned only on `$select`. | | unseenCount | Int32 | Count of conversations that have received new posts since the signed-in user last visited the group. <br><br>Returned only on `$select`. Supported only on the Get group API (`GET /groups/{ID}`). | | visibility | String | Specifies the group join policy and group content visibility for groups. Possible values are: `Private`, `Public`, or `HiddenMembership`. `HiddenMembership` can be set only for Microsoft 365 groups when the groups are created. It can't be updated later. Other values of visibility can be updated after group creation.<br> If visibility value is not specified during group creation on Microsoft Graph, a security group is created as `Private` by default, and the Microsoft 365 group is `Public`. Groups assignable to roles are always `Private`. To learn more, see [group visibility options](#group-visibility-options). <br><br>Returned by default. Nullable. | The following is a JSON representation of the resource. ], "sites": [{ "@odata.type": "microsoft.graph.site" }], "threads": [{ "@odata.type": "microsoft.graph.conversationThread" }],+ "uniqueName": "String", "unseenCount": 1024, "visibility": "String" } |
v1.0 | Grouplifecyclepolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/grouplifecyclepolicy.md | None. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Groupsetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/groupsetting.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Groupsettingtemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/groupsettingtemplate.md | None. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Hashes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/hashes.md | The **hashes** resource groups available hashes into a single structure for an i ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Homerealmdiscoverypolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/homerealmdiscoverypolicy.md | The properties below form the JSON object that represents a token lifetime polic ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Horizontalsection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/horizontalsection.md | + + Title: "horizontalSection resource type" +description: Represents a horizontal section in a given SharePoint page ++ms.localizationpriority: medium +++# horizontalSection resource type ++Namespace: microsoft.graph ++++Represents a horizontal section in a given SharePoint page. ++Inherits from [entity](../resources/entity.md). ++## Methods ++| Method | Return type | Description | +| :- | :- | :-- | +| [List horizontalSections](../api/horizontalsection-list.md) | [horizontalSection](../resources/horizontalsection.md) collection | Get a list of the [horizontalSection](../resources/horizontalsection.md) objects and their properties. | +| [Create horizontalSection](../api/sitepage-post-horizontalsection.md) | [horizontalSection](../resources/horizontalsection.md) | Create a new [horizontalSection](../resources/horizontalsection.md) object. | +| [Get horizontalSection](../api/horizontalsection-get.md) | [horizontalSection](../resources/horizontalsection.md) | Read the properties and relationships of a [horizontalSection](../resources/horizontalsection.md) object. | +| [Update horizontalSection](../api/horizontalsection-update.md) | [horizontalSection](../resources/horizontalsection.md) | Update the properties of a [horizontalSection](../resources/horizontalsection.md) object. | +| [Delete horizontalSection](../api/horizontalsection-delete.md) | [horizontalSection](../resources/horizontalsection.md) | Delete a [horizontalSection](../resources/horizontalsection.md) object. | ++## Properties ++| Property | Type | Description | +| :- | :-- | :-- | +| emphasis | [sectionEmphasisType](../resources/horizontalsection.md#sectionemphasistype-values) | Enumeration value that indicates the emphasis of the section background. The possible values are: `none`, `netural`, `soft`, `strong`, `unknownFutureValue`. | +| id | String | Unique identifier of the resource. Inherited from [entity](../resources/entity.md). | +| layout | [horizontalSectionLayoutType](../resources/horizontalsection.md#horizontalsectionlayouttype-values) | Layout type of the section. The possible values are: `none`, `oneColumn`, `twoColumns`, `threeColumns`, `oneThirdLeftColumn`, `oneThirdRightColumn`, `fullWidth`, `unknownFutureValue`. | ++### sectionEmphasisType values ++| Member | Description | +| :-- | :- | +| none | The section has no background. | +| neutral | The section has a neutral emphasis in the background. | +| soft | The section has a soft emphasis in the background. | +| strong | The section has a strong emphasis in the background. | +| unknownFutureValue | Marker value for future compatibility. | ++### horizontalSectionLayoutType values ++| Member | Description | +| : | :-- | +| none | The section has no layout. | +| oneColumn | The section has only one column. | +| twoColumns | The section has two columns. | +| threeColumns | The section has three columns. | +| oneThirdLeftColumn | The section has a 1/3 column on the left and 2/3 column on the right. | +| oneThirdRightColumn | The section has a 2/3 column on the left and 1/3 column on the right. | +| fullWidth | The section has one full width column. | +| unknownFutureValue | Marker value for future compatibility. | ++## Relationships ++| Relationship | Type | Description | +| :-- | :- | :- | +| columns | [horizontalSectionColumn](../resources/horizontalsectioncolumn.md) collection | The set of vertical columns in this section. | ++## JSON representation ++The following is a JSON representation of the resource. ++<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.horizontalSection", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.horizontalSection", + "id": "String (identifier)", + "layout": "String", + "emphasis": "String" +} +``` |
v1.0 | Horizontalsectioncolumn | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/horizontalsectioncolumn.md | + + Title: "horizontalSectionColumn resource type" +description: Represents a vertical column in a given horizontal section ++ms.localizationpriority: medium +++# horizontalSectionColumn resource type ++Namespace: microsoft.graph ++++Represents a vertical column in a given horizontal section. ++Inherits from [entity](../resources/entity.md). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List horizontalSectionColumns](../api/horizontalsectioncolumn-list.md)|[horizontalSectionColumn](../resources/horizontalsectioncolumn.md) collection|Get a list of the [horizontalSectionColumn](../resources/horizontalsectioncolumn.md) objects and their properties.| +|[Get horizontalSectionColumn](../api/horizontalsectioncolumn-get.md)|[horizontalSectionColumn](../resources/horizontalsectioncolumn.md)|Read the properties and relationships of a [horizontalSectionColumn](../resources/horizontalsectioncolumn.md) object.| +|[List webParts](../api/webpart-list.md)|[webPart](../resources/webPart.md) Collection |Get a list of webparts associated with a [horizontalSectionColumn](../resources/horizontalsectioncolumn.md) object.| ++++## Properties +|Property|Type|Description| +|:|:|:| +|id|String|Unique identifier of the resource. Inherited from [entity](../resources/entity.md).| +|width|Int32|Width of the column. A horizontal section is divided into 12 grids. A column should have a value of 1-12 to represent its range spans. For example, there can be two columns both have a width of 6 in a section.| ++## Relationships +|Relationship|Type|Description| +|:|:|:| +|webparts|[webPart](../resources/webpart.md) collection|The collection of WebParts in this column.| ++## JSON representation +The following is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.horizontalSectionColumn", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.horizontalSectionColumn", + "id": "String (identifier)", + "width": "Integer" +} +``` + |
v1.0 | Hostsecuritystate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/hostsecuritystate.md | Contains stateful information about the host (including devices, computers, and ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Httprequestendpoint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/httprequestendpoint.md | + + Title: "httpRequestEndpoint resource type" +description: "The HTTP endpoint that a custom extension calls." ++ms.localizationpriority: medium ++++# httpRequestEndpoint resource type ++Namespace: microsoft.graph ++The HTTP endpoint that a custom extension calls. ++Inherits from [customExtensionEndpointConfiguration](../resources/customextensionendpointconfiguration.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|targetUrl|String|The HTTP endpoint that a custom extension calls.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.httpRequestEndpoint" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.httpRequestEndpoint", + "targetUrl": "String" +} +``` + |
v1.0 | Icon | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/icon.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Identity Network Access Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identity-network-access-overview.md | + + Title: "Manage Microsoft Entra identity and network access capabilities by using Microsoft Graph" +description: "Microsoft Graph provides REST APIs to help manage identity and network access capabilities, most of which are available through Microsoft Entra." +ms.localizationpriority: high ++++ Last updated : 04/30/2024+++# Manage Microsoft Entra identity and network access capabilities by using Microsoft Graph +++With Microsoft Graph, you can manage identity and network access capabilities, most of which are available through [Microsoft Entra](/entra/fundamentals/whatis). The APIs in Microsoft Graph help you to automate identity and network access management tasks and integrate with any application, and are the programmatic alternative to the administrator portals such as the Microsoft Entra admin center. ++Microsoft Entra is a family of identity and network access capabilities that are available in the following products. All these capabilities are available through Microsoft Graph APIs: +- Microsoft Entra ID that groups identity and access management (IAM) capabilities. +- Microsoft Entra ID Governance +- Microsoft Entra External ID +- Microsoft Entra Verified ID +- Microsoft Entra Permissions Management +- Microsoft Entra Internet Access and Network Access ++## Manage user identities ++Users are the main identities in any identity and access solution. You can manage the entire lifecycle of users in your organization, and their entitlements like licenses or group memberships, using Microsoft Graph APIs. For more information, see [Working with users in Microsoft Graph](/graph/api/resources/users). ++## Manage groups ++Groups are the containers that allow you to efficiently manage the entitlements for identities as a unit. For example, through a group, you can grant users access to a resource, such as a SharePoint site. Or you can grant them licenses to use a service. For more information, see [Working with groups in Microsoft Graph](/graph/api/resources/groups-overview). ++## Manage applications ++You can use Microsoft Graph APIs to register and manage your applications programmatically, enabling you to use Microsoft's IAM capabilities. For more information, see [Manage Microsoft Entra applications and service principals by using Microsoft Graph](/graph/api/resources/applications-api-overview). ++++## Tenant administration or directory management ++A core functionality of identity and access management is managing your tenant configuration, administrative roles, and settings. Microsoft Graph provides APIs to manage your Microsoft Entra tenant for the following scenarios: ++| Use cases | API operations | +|--|--| +| Manage administrative units including the following operations: <li>Create administrative units <li> Create and manage members and membership rules of administrative units <li> Assign administrator roles that are scoped to administrative units | [administrativeUnit resource type](administrativeunit.md) and its associated APIs | +| Retrieve BitLocker recovery keys | [bitlockerRecoveryKey resource type](bitlockerrecoverykey.md) and its associated APIs | +| Monitor licenses and subscriptions for the tenant | [subscribedSku resource type](subscribedsku.md) and its associated APIs | +| Manage custom security attributes | See [Overview of custom security attributes using the Microsoft Graph API](custom-security-attributes-overview.md) | +| Manage deleted directory objects. The functionality to store deleted objects in a "recycle bin" is supported for the following objects: <li> Administrative units <li> Applications <li> External user profiles <li> Groups <li> Pending external user profiles <li> Service principals <li> Users | <li> [Get](../api/directory-deleteditems-get.md) or [List](../api/directory-deleteditems-list.md) deleted objects <li> [Permanently delete](../api/directory-deleteditems-delete.md) a deleted object <li> [Restore a deleted item](../api/directory-deleteditems-restore.md) <li> [List deleted items owned by user](../api/directory-deleteditems-getuserownedobjects.md) | +| Manage devices in the cloud | [device resource type](device.md) and its associated APIs | +| View local administrator credential information for all device objects in Microsoft Entra ID that are enabled with Local Admin Password Solution (LAPS). This feature is the cloud-based LAPS solution | [deviceLocalCredentialInfo resource type](devicelocalcredentialinfo.md) and its associated APIs | +| Directory objects are the core objects in Microsoft Entra ID, such as users, groups, and applications. You can use the directoryObject resource type and its associated APIs to check memberships of directory objects, track changes for multiple directory objects, or validate that a Microsoft 365 group's display name or mail nickname complies with naming policies | [directoryObject resource type](directoryobject.md) and its associated APIs | +| Administrator roles, including Microsoft Entra administrator roles, are one of the most sensitive resources in a tenant. You can manage the lifecycle of their assignment in the tenant, including creating custom roles, assigning roles, tracking changes to role assignments, and removing assignees from roles | [directoryRole resource type](directoryrole.md) and [directoryRoleTemplate resource type](directoryroletemplate.md)and their associated APIs <br/><br/> [roleManagement resource type](rolemanagement.md) and its associated APIs <br/><br/> These APIs allow you to make direct role assignments. Alternatively, you can use Privileged Identity Management APIs for [Microsoft Entra roles](privilegedidentitymanagementv3-overview.md) and [groups](privilegedidentitymanagement-for-groups-api-overview.md) to make just-in-time and time-bound role assignments, instead of direct forever active assignments. | +| Define the following configurations that can be used to customize the tenant-wide and object-specific restrictions and allowed behavior. <li> Settings for Microsoft 365 groups such as guest user access, classifications, and naming policies <li> Password rule settings such as banned password lists and lockout duration <li> Prohibited names for applications, reserved words, and blocking trademark violations <li> Custom conditional access policy URL <li> Consent policies such as user consent requests, group-specific consent, and consent for risky apps | [groupSetting resource type](groupsetting.md) and [groupSettingTemplate resource type](groupsettingtemplate.md) and their associated APIs <br/><br/> For more information, see [Overview of group settings](/graph/group-directory-settings). | +| Domain management operations such as: <li> associating a domain with your tenant <li> retrieving DNS records <li> verifying domain ownership <li> associating specific services with specific domains <li> deleting domains | [domain resource type](domain.md) and its associated APIs | +| Configure and manage staged rollout of specific Microsoft Entra ID features | [featureRolloutPolicy resource type](featurerolloutpolicy.md) and its associated APIs | +| Configure options that are available in Microsoft Entra Cloud Sync such as preventing accidental deletions and managing group writebacks | [onPremisesDirectorySynchronization resource type](onpremisesdirectorysynchronization.md) and its associated APIs | +| Manage the base settings for your Microsoft Entra tenant | [organization resource type](organization.md) and its associated APIs | +| Retrieve the organizational contacts that might be synchronized from on-premises directories or from Exchange Online | [orgContact resource type](orgcontact.md) and its associated APIs | +| Discover the basic details of other Microsoft Entra tenants by querying using the tenant ID or the domain name | [tenantInformation resource type](tenantinformation.md) and its associated APIs | +| Manage the delegated permissions and their assignments to service principals in the tenant | [oAuth2PermissionGrant resource type](oauth2permissiongrant.md) and its associated APIs | ++++## Identity and sign-in ++| Use cases | API operations | +|--|--| +| Configure listeners that monitor events that should trigger or invoke custom logic, typically defined outside Microsoft Entra ID | [authenticationEventListener resource type](authenticationeventlistener.md) and its associated APIs | +| Manage authentication methods that are supported in Microsoft Entra ID | See [Microsoft Entra authentication methods API overview](authenticationmethods-overview.md) and [Microsoft Entra authentication methods policies API overview](authenticationmethodspolicies-overview.md) | +| Manage the authentication methods or combinations of authentication methods that you can apply as grant control in Microsoft Entra Conditional Access | See [Microsoft Entra authentication strengths API overview](authenticationstrengths-overview.md) | +|Manage tenant-wide authorization policies such as: <li> enable SSPR for administrator accounts <li>enable self-service join for guests <li> limit who can invite guests <li> whether users can consent to risky apps <li> block the use of MSOL <li> customize the default user permissions <li> identity private preview features enabled <li>Customize the guest user permissions between *User*, *Guest User*, and *Restricted Guest User*| [authorizationPolicy resource type](authorizationpolicy.md) and its associated APIs| +| Manage the policies for certificate-based authentication in the tenant | [certificateBasedAuthConfiguration resource type](certificatebasedauthconfiguration.md) and its associated APIs | +| Manage Microsoft Entra conditional access policies | [conditionalAccessRoot resource type](conditionalaccessroot.md) and its associated APIs | +| Manage cross-tenant access settings and manage outbound restrictions, inbound restrictions, tenant restrictions, and cross-tenant synchronization of users in multitenant organizations | See [Cross-tenant access settings API overview](crosstenantaccesspolicy-overview.md) | +| Configure how and which external systems interact with Microsoft Entra ID during a user authentication session | [customAuthenticationExtension resource type](customauthenticationextension.md) and its associated APIs | +| Manage requests against user data in the organization, such as exporting personal data | [dataPolicyOperation resource type](datapolicyoperation.md) and its associated APIs | +|Force autoacceleration sign-in to skip the username entry screen and automatically forward users to federated sign-in endpoints |[homeRealmDiscoveryPolicy resource type](homerealmdiscoverypolicy.md) resource type and its associated APIs| +| Detect, investigate, and remediate identity-based risks using Microsoft Entra ID Protection and feed the data into security information and event management (SIEM) tools for further investigation and correlation | See [Use the Microsoft Graph identity protection APIs](identityprotection-overview.md) | +| Manage identity providers for Microsoft Entra ID, Microsoft Entra External ID, and Azure AD B2C tenants. You can perform the following operations: <li> Manage identity providers for external identities, including social identity providers, OIDC, Apple, SAML/WS-Fed, and built-in providers <li> Manage configuration for federated domains and token validation | [identityProviderBase resource type](identityproviderbase.md) and its associated APIs | +| Invite external users to collaborate with your tenant by using Microsoft Entra External ID | [invitation resource type](invitation.md) and its associated APIs | +| Define a group of tenants belonging to your organization and streamline intra-organization cross-tenant collaboration | See [Multitenant organization API overview](multitenantorganization-overview.md) | +| Customize sign-in UIs to match your company branding, including applying branding that's based on the browser language | [organizationalBranding resource type](organizationalbranding.md) and its associated APIs | +| User flows for Microsoft Entra External ID for workforce | The following resource types and their associated APIs: <li>[b2xIdentityUserFlow](b2xidentityuserflow.md) to configure the base user flow and its properties such as identity providers <li> [identityUserFlowAttribute](identityuserflowattribute.md) to manage built-in and custom user flow attributes <li> [identityUserFlowAttributeAssignment](identityuserflowattributeassignment.md) to manage user flow attribute assignments <li> [userFlowLanguageConfiguration resource type](userflowlanguageconfiguration.md) to configure custom languages for user flows | +|Manage app consent policies and condition sets|[permissionGrantPolicy resource type](permissiongrantpolicy.md)| +|Enable or disable security defaults in Microsoft Entra ID|[identitySecurityDefaultsEnforcementPolicy resource type](identitysecuritydefaultsenforcementpolicy.md)| ++++## Identity governance ++For more information, see [Overview of Microsoft Entra ID Governance using Microsoft Graph](identitygovernance-overview.md). ++## Microsoft Entra External ID for external tenants ++The following API use cases ar supported to customize how users interact with your customer-facing applications. For administrators, most of the features available in Microsoft Entra ID and also supported for Microsoft Entra External ID for external tenants. For example, domain management, application management, and conditional access. ++| Use cases | API operations | +|--|--| +| Manage identity providers for Microsoft Entra External ID. You can identify the identity providers that are supported or configured in the tenant | See [identityProviderBase resoruce type](identityproviderbase.md) and its associated APIs | +| Customize sign-in UIs to match your company branding, including applying branding that's based on the browser language | [organizationalBranding resource type](organizationalbranding.md) and its associated APIs | +| Manage identity providers for Microsoft Entra External ID, such as social identities | [identityProviderBase resoruce type](identityproviderbase.md) and its associated APIs | +| Manage user profiles in Microsoft Entra External ID for customers | For more information, see [Default user permissions in customer tenants](/graph/api/resources/users#default-user-permissions-in-customer-tenants) | +| Add your own business logic to the authentication experiences by integrating with systems that are external to Microsoft Entra ID| [authenticationEventListener resource type](authenticationeventlistener.md) and [customAuthenticationExtension resource type](customauthenticationextension.md) and their associated APIs | ++## Partner tenant management ++With Microsoft Graph, you can access [Microsoft Entra](/entra/fundamentals/whatis) resources to enable scenarios like managing administrator (directory) roles, inviting external users to an organization, and, if you're a [Cloud Solution Provider (CSP)](https://partner.microsoft.com/cloud-solution-provider), managing your customer's data. Microsoft Graph also provides methods apps can use, for example, to discover information about users' transitive group and role memberships. +++| Use cases | API operations | +|--|| +| Manage contracts for the partner with its customers | [contract resource type](contract.md) and its associated APIs | +| Microsoft partners in the Cloud Solution Provider (CSP), Value Added Reseller (VAR), or Advisor programs can empower their customers to ensure the partners have least privileged access to their customers' tenants. This feature gives extra control to customers over their security posture while allowing them to receive support from the Microsoft resellers | See [Granular delegated admin privileges (GDAP) API overview](delegatedadminrelationships-api-overview.md) | ++++## Licensing ++Microsoft Entra licenses include Microsoft Entra ID Free, P1, P2, and Governance; Microsoft Entra Permissions Management; and Microsoft Entra Workload ID. ++For detailed information about licensing for different features, see [Microsoft Entra ID licensing](/entra/fundamentals/licensing). ++## Related content ++- [Implement identity standards with Microsoft Entra ID](/entra/standards/) +- [Microsoft Entra ID Guide for independent software developers](/entra/architecture/guide-for-independent-software-developers) |
v1.0 | Identitybuiltinuserflowattribute | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identitybuiltinuserflowattribute.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Identitycontainer | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identitycontainer.md | None. | Relationship | Type | Description | |:-|:|:| |apiConnectors|[identityApiConnector](identityApiConnector.md) collection|Represents entry point for API connectors.|+|authenticationEventListeners|[authenticationEventListener](authenticationeventlistener.md) collection| Represents listeners for custom authentication extension events in Azure AD for workforce and customers.| |b2xUserFlows|[b2xIdentityUserFlow](b2xIdentityUserFlow.md) collection| Represents entry point for B2X/self-service sign-up identity userflows.| |conditionalAccess|[conditionalAccessRoot](conditionalAccessRoot.md) collection| the entry point for the Conditional Access (CA) object model.|+|customAuthenticationExtensions|[customAuthenticationExtension](customauthenticationextension.md) collection| Represents custom extensions to authentication flows in Azure AD for workforce and customers.| |identityProvider|[identityProviderBase](identityProviderBase.md) collection| Represents entry point for identity provider base.| |userFlowAttributes|[identityUserFlowAttribute](identityUserFlowAttribute.md) collection| Represents entry point for identity userflow attributes.| ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.identityContainer", |
v1.0 | Identitycustomuserflowattribute | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identitycustomuserflowattribute.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Identitygovernance Lifecycleworkflows Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identitygovernance-lifecycleworkflows-overview.md | Title: "Overview of Lifecycle Workflows APIs" description: "Use Lifecycle Workflows to manage the lifecycle of users in your organization." ms.localizationpriority: medium + doc_type: conceptualPageType Last updated 03/12/2024 Lifecycle Workflows is an Identity Governance service in Microsoft Entra ID that 1. **Joiner**: When an individual comes into scope of needing access; for example, a new employee joining a company or organization. 2. **Mover**: When an individual moves between boundaries within an organization; for example, a user who was in marketing is now a member of the sales organization. This movement might require more access or authorization, or revocation of other privileges.-3. **Leaver**: When an individual leaves the scope of needing access, access might need to be revoked, and the user deprovisioned. For example, an employee who is retiring or has been terminated. +3. **Leaver**: When an individual leaves the scope of needing access, access might need to be revoked, and the user deprovisioned. For example, an employee who is retiring or terminated. -For this reason, Lifecycle Workflows can be referred to as the **Joiner-Mover-Leaver** (JML) workflow. Only the *joiner* and *leaver* processes are currently implemented. +For this reason, lifecycle workflows can be referred to as the **Joiner-Mover-Leaver** (JML) workflow. -The lifecycle workflows APIs in Microsoft Graph allow you to automate the Lifecycle Workflows capabilities for your organization. This article introduced the set of APIs that enable the Lifecycle Workflows service in Microsoft Entra ID. +The lifecycle workflow APIs in Microsoft Graph allow you to automate the lifecycle workflows capabilities for your organization. This article introduced the set of APIs that enable the Lifecycle Workflows service in Microsoft Entra ID. The lifecycle workflows APIs are defined in the OData subnamespace, microsoft.graph.identityGovernance. Each workflow contains general descriptive information such as its identifier, n ### Workflow tasks -Workflow tasks are specific actions that run automatically when a workflow is triggered. Lifecycle Workflows defines the following preconfigured and read-only tasks that are allowed for the specified workflow categories. These task definitions show the settings for the task type, guiding you as you create tasks for your workflow. +Workflow tasks are specific actions that run automatically when a workflow is triggered. Lifecycle workflows define the following preconfigured and read-only tasks allowed for the specified workflow categories. These task definitions show the settings for the task type, guiding you as you create tasks for your workflow. [!INCLUDE [lifecycle-workflows-tasks-table](../includes/identitygovernance-lifecycleworkflows-tasks-table.md)] -Use the [taskDefinition resource type](identitygovernance-taskdefinition.md) and its associated methods to discover all the predefined tasks that you can configure for your workflow and the settings for the properties. The [task](identitygovernance-task.md) resource type and its associated GET methods allow you to view the tasks that are configured for your workflow. +Use the [taskDefinition resource type](identitygovernance-taskdefinition.md) and its associated methods to discover all the predefined tasks that can be configured for your workflow and the settings for the properties. The [task](identitygovernance-task.md) resource type and its associated GET methods allow you to view the tasks configured for your workflow. ### Execution conditions When creating or updating a workflow, use the [workflowExecutionConditions resou ### Create and manage workflows -After identifying the tasks and execution conditions that you want to define for your workflow, use the [workflow resource type](identitygovernance-workflow.md), and its associated methods to create and manage the workflow. You can create up to 50 workflows in a tenant. The category of the task must match the category of the workflow. Each workflow can have up to 25 tasks. Therefore: +After identifying the tasks and execution conditions that you want to define for your workflow, use the [workflow resource type](identitygovernance-workflow.md), and its associated methods to create and manage the workflow. You can create up to 100 workflows in a tenant. The category of the task must match the category of the workflow. Each workflow can have up to 25 tasks. Therefore: -+ A task supported for only the "leaver" workflow category can't be specified in a "joiner" workflow scenario, and vice versa. -+ A task supported for both "leaver" and "joiner" workflow categories can be specified in either a "joiner" or "leaver" workflow scenario. ++ A task supported for only the "leaver" workflow category can't be specified in a "joiner" or "mover" workflow scenario, and vice versa.++ A task supported for "joiner", "mover", and "leaver" workflow categories can be specified in either a "joiner", "mover" or "leaver" workflow scenario. -You can schedule a workflow to run based on the [tenant-wide schedule](#settings) or run it on-demand. The tenant schedule can take care of regular new hires and terminations, while you can run a workflow on-demand to immediately terminate an employee's access if there was a sensitive event. +You can schedule a workflow to run based on the [tenant-wide schedule](#settings) or run it on-demand. The tenant schedule can take care of scheduled new hires and terminations, while you can run a workflow on-demand immediately to terminate an employee's access if there is a sensitive event. ### Workflow versions While a workflow is in use, you might need to update execution conditions and tasks for a workflow. However, Lifecycle Workflows doesn't allow you to update these properties for an existing workflow. -Instead of creating new workflows, use the [workflowVersion resource type](identitygovernance-workflowversion.md) and its associated methods to create and manage a new workflow version, based off an existing workflow object. The workflow version can have similar or a different set of tasks and execution conditions. +Instead of creating new workflows, use the [workflowVersion resource type](identitygovernance-workflowversion.md) and its associated methods to create and manage a new workflow version, based on an existing workflow object. The workflow version can have a similar or different set of tasks and execution conditions. ## Reports -Lifecycle Workflows supports extensive reporting capabilities to track the status of workflow processing at the workflow run-level, task-level, and user-level. +Lifecycle workflows support extensive reporting capabilities to track the status of workflow processing at the workflow run-level, task-level, and user-level. For more information about the reporting capabilities for Lifecycle Workflows, see the [overview of Lifecycle Workflows reporting APIs](identitygovernance-lifecycleworkflows-reporting-overview.md). |
v1.0 | Identitygovernance Workflow | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identitygovernance-workflow.md | Namespace: microsoft.graph.identityGovernance Represents workflows created using Lifecycle Workflows. Workflows, when triggered by execution conditions, automate parts of the lifecycle management process using tasks. These tasks can either be built-in tasks, or a custom task can be called using the custom task extension which integrate with Azure Logic Apps. -You can create up to 50 workflows in a tenant. +You can create up to 100 workflows in a tenant. Inherits from [workflowBase](../resources/identitygovernance-workflowbase.md). |
v1.0 | Identitygovernance Workflowbase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identitygovernance-workflowbase.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Identitygovernance Workflowexecutiontrigger | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identitygovernance-workflowexecutiontrigger.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.identityGovernance.workflowExecutionTrigger" |
v1.0 | Identitysecuritydefaultsenforcementpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identitysecuritydefaultsenforcementpolicy.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Identitysource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identitysource.md | None. ## Relationships None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.identitySource" |
v1.0 | Identityuserflow | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identityuserflow.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Identityuserflowattribute | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identityuserflowattribute.md | Configuring user flow attributes in your Microsoft Entra ID or Azure AD B2C tena ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Identityuserflowattributeassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identityuserflowattributeassignment.md | Represents how attributes are collected in an identity user flow. and allows cus ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Implicitgrantsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/implicitgrantsettings.md | Specifies whether this web application can request tokens using the OAuth 2.0 im |enableIdTokenIssuance| Boolean | Specifies whether this web application can request an ID token using the OAuth 2.0 implicit flow.| ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Inboundoutboundpolicyconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/inboundoutboundpolicyconfiguration.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.inboundOutboundPolicyConfiguration" |
v1.0 | Inferenceclassification | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/inferenceclassification.md | For more information, see [Manage Focused Inbox](manage-focused-inbox.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Inferenceclassificationoverride | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/inferenceclassificationoverride.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Informationalurl | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/informationalurl.md | Basic profile information of the application. |termsOfServiceUrl|String| Link to the application's terms of service statement. For example, https://www.contoso.com/app/termsofservice | ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Initiator | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/initiator.md | Describes who or what initiated the provisioning event. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Insights Insightidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/insights-insightidentity.md | Namespace: microsoft.graph Complex type containing properties of [sharedInsight](insights-shared.md) items. ## JSON representation-Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Insights Resourcereference | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/insights-resourcereference.md | Complex type containing properties of [officeGraphInsights](officegraphinsights. ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "optionalProperties": [ |
v1.0 | Insights Resourcevisualization | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/insights-resourcevisualization.md | Complex type containing properties of [officeGraphInsights](officegraphinsights. ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Insights Shared | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/insights-shared.md | An insight representing files shared with or by a specific user. The following s | resource | entity collection | Used for navigating to the item that was shared. For file attachments, the type is *fileAttachment*. For linked attachments, the type is *driveItem*. | ## JSON representation-Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!--{ "blockType":"resource", "keyProperty": "id", |
v1.0 | Insights Sharingdetail | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/insights-sharingdetail.md | Namespace: microsoft.graph Complex type containing properties of [sharedInsight](insights-shared.md) items. ## JSON representation-Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "optionalProperties": [ |
v1.0 | Insights Trending | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/insights-trending.md | Rich relationship connecting a user to documents that are trending around the us ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Insights Usagedetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/insights-usagedetails.md | Complex type containing properties of [Used](insights-used.md) items. Informatio ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Insights Used | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/insights-used.md | An insight representing documents used by a specific user. The insights return t | resource | [entity](entity.md) collection | Used for navigating to the item that was used. For file attachments, the type is *fileAttachment*. For linked attachments, the type is *driveItem*. | ## JSON representation-Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Internaldomainfederation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/internaldomainfederation.md | Title: "internalDomainFederation resource type" description: "Represents configurations of the domains in a tenant that are federated with Azure AD." ms.localizationpriority: medium-+ doc_type: resourcePageType Inherits from [samlOrWsFedProvider](../resources/samlorwsfedprovider.md). |signingCertificateUpdateStatus|[signingCertificateUpdateStatus](../resources/signingcertificateupdatestatus.md)|Provides status and timestamp of the last update of the signing certificate.| |signOutUri|String|URI that clients are redirected to when they sign out of Microsoft Entra services. Corresponds to the **LogOffUri** property of the [Set-MsolDomainFederationSettings MSOnline v1 PowerShell cmdlet](/powershell/module/msonline/set-msoldomainfederationsettings).| + ### federatedIdpMfaBehavior values | Member | Description | The following JSON representation shows the resource type. "federatedIdpMfaBehavior": "String" } ```++<!-- +{ + "type": "#page.annotation", + "description": "", + "keywords": "", + "section": "documentation", + "tocPath": "", + "suppressions": [ + "Error: /resources/internaldomainfederation.md: + Exception processing links. + Link Definition was null. Link text: !INCLUDE Azure AD PowerShell deprecation note (Parameter 'Definition')" + ] +} +--> |
v1.0 | Internalsponsors | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/internalsponsors.md | None. ## Relationships None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.internalSponsors", |
v1.0 | Internetmessageheader | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/internetmessageheader.md | For examples of an Internet message header, see ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Intune Devices Manageddevice | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/intune-devices-manageddevice.md | Devices that are managed or pre-enrolled through Intune |[Create managedDevice](../api/intune-devices-manageddevice-create.md)|[managedDevice](../resources/intune-devices-manageddevice.md)|Create a new [managedDevice](../resources/intune-devices-manageddevice.md) object.| |[Delete managedDevice](../api/intune-devices-manageddevice-delete.md)|None|Deletes a [managedDevice](../resources/intune-devices-manageddevice.md).| |[Update managedDevice](../api/intune-devices-manageddevice-update.md)|[managedDevice](../resources/intune-devices-manageddevice.md)|Update the properties of a [managedDevice](../resources/intune-devices-manageddevice.md) object.|-|[createDeviceLogCollectionRequest action](../api/intune-devices-manageddevice-createdevicelogcollectionrequest.md)|[deviceLogCollectionResponse](../resources/intune-devices-devicelogcollectionresponse.md)|Not yet documented| + |[retire action](../api/intune-devices-manageddevice-retire.md)|None|Retire a device| |[wipe action](../api/intune-devices-manageddevice-wipe.md)|None|Wipe a device| |[resetPasscode action](../api/intune-devices-manageddevice-resetpasscode.md)|None|Reset passcode| Devices that are managed or pre-enrolled through Intune |[cleanWindowsDevice action](../api/intune-devices-manageddevice-cleanwindowsdevice.md)|None|Clean Windows device| |[logoutSharedAppleDeviceActiveUser action](../api/intune-devices-manageddevice-logoutsharedappledeviceactiveuser.md)|None|Logout shared Apple device active user| |[deleteUserFromSharedAppleDevice action](../api/intune-devices-manageddevice-deleteuserfromsharedappledevice.md)|None|Delete user from shared Apple device|-|[syncDevice action](../api/intune-devices-manageddevice-syncdevice.md)|None|Not yet documented| -|[windowsDefenderScan action](../api/intune-devices-manageddevice-windowsdefenderscan.md)|None|Not yet documented| -|[windowsDefenderUpdateSignatures action](../api/intune-devices-manageddevice-windowsdefenderupdatesignatures.md)|None|Not yet documented| -|[updateWindowsDeviceAccount action](../api/intune-devices-manageddevice-updatewindowsdeviceaccount.md)|None|Not yet documented| +|[syncDevice action](../api/intune-devices-manageddevice-syncdevice.md)|None|| +|[windowsDefenderScan action](../api/intune-devices-manageddevice-windowsdefenderscan.md)|None|| +|[windowsDefenderUpdateSignatures action](../api/intune-devices-manageddevice-windowsdefenderupdatesignatures.md)|None|| +|[updateWindowsDeviceAccount action](../api/intune-devices-manageddevice-updatewindowsdeviceaccount.md)|None|| ## Properties |Property|Type|Description| Devices that are managed or pre-enrolled through Intune |notes|String|Notes on the device created by IT Admin. Default is null. To retrieve actual values GET call needs to be made, with device id and included in select parameter. Supports: $select. $Search is not supported.| |ethernetMacAddress|String|Indicates Ethernet MAC Address of the device. Default, is Null (Non-Default property) for this property when returned as part of managedDevice entity. Individual get call with select query options is needed to retrieve actual values. Example: deviceManagement/managedDevices({managedDeviceId})?$select=ethernetMacAddress Supports: $select. $Search is not supported. Read-only. This property is read-only.| |physicalMemoryInBytes|Int64|Total Memory in Bytes. Default is 0. To retrieve actual values GET call needs to be made, with device id and included in select parameter. Supports: $select. Read-only. This property is read-only.|+|enrollmentProfileName|String|Name of the enrollment profile assigned to the device. Default value is empty string, indicating no enrollment profile was assgined. This property is read-only.| ## Relationships |Relationship|Type|Description| Here is a JSON representation of the resource. "udid": "String", "notes": "String", "ethernetMacAddress": "String",- "physicalMemoryInBytes": 1024 + "physicalMemoryInBytes": 1024, + "enrollmentProfileName": "String" } ``` |
v1.0 | Intune Mstunnel Devicemanagement | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/intune-mstunnel-devicemanagement.md | - Title: "deviceManagement resource type" -description: "Singleton that acts as container for a collection of Resource Access entities." --localization_priority: Normal --doc_type: resourcePageType ---# deviceManagement resource type --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Singleton that acts as container for a collection of Resource Access entities. --## Methods -|Method|Return Type|Description| -|:|:|:| -|[Get deviceManagement](../api/intune-mstunnel-devicemanagement-get.md)|[deviceManagement](../resources/intune-mstunnel-devicemanagement.md)|Read properties and relationships of the [deviceManagement](../resources/intune-mstunnel-devicemanagement.md) object.| -|[Update deviceManagement](../api/intune-mstunnel-devicemanagement-update.md)|[deviceManagement](../resources/intune-mstunnel-devicemanagement.md)|Update the properties of a [deviceManagement](../resources/intune-mstunnel-devicemanagement.md) object.| --## Properties -|Property|Type|Description| -|:|:|:| -|id|String|Not yet documented| --## Relationships -|Relationship|Type|Description| -|:|:|:| -|microsoftTunnelConfigurations|[microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) collection|Collection of MicrosoftTunnelConfiguration settings associated with account.| -|microsoftTunnelSites|[microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) collection|Collection of MicrosoftTunnelSite settings associated with account.| -|microsoftTunnelHealthThresholds|[microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) collection|Collection of MicrosoftTunnelHealthThreshold settings associated with account.| -|microsoftTunnelServerLogCollectionResponses|[microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) collection|Collection of MicrosoftTunnelServerLogCollectionResponse settings associated with account.| --## JSON Representation -Here is a JSON representation of the resource. -<!-- { - "blockType": "resource", - "keyProperty": "id", - "@odata.type": "microsoft.graph.deviceManagement" -} >-``` json -{ - "@odata.type": "#microsoft.graph.deviceManagement", - "id": "String (identifier)" -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/intune-mstunnel-microsofttunnelconfiguration.md | - Title: "microsoftTunnelConfiguration resource type" -description: "Entity that represents a collection of Microsoft Tunnel settings" --localization_priority: Normal --doc_type: resourcePageType ---# microsoftTunnelConfiguration resource type --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Entity that represents a collection of Microsoft Tunnel settings --## Methods -|Method|Return Type|Description| -|:|:|:| -|[List microsoftTunnelConfigurations](../api/intune-mstunnel-microsofttunnelconfiguration-list.md)|[microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) collection|List properties and relationships of the [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) objects.| -|[Get microsoftTunnelConfiguration](../api/intune-mstunnel-microsofttunnelconfiguration-get.md)|[microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md)|Read properties and relationships of the [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) object.| -|[Create microsoftTunnelConfiguration](../api/intune-mstunnel-microsofttunnelconfiguration-create.md)|[microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md)|Create a new [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) object.| -|[Delete microsoftTunnelConfiguration](../api/intune-mstunnel-microsofttunnelconfiguration-delete.md)|None|Deletes a [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md).| -|[Update microsoftTunnelConfiguration](../api/intune-mstunnel-microsofttunnelconfiguration-update.md)|[microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md)|Update the properties of a [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) object.| --## Properties -|Property|Type|Description| -|:|:|:| -|id|String|The unique identifier for the configuration id. Supports: $delete, $update. $Insert, $skip, $top is not supported. Read-only.| -|displayName|String|The display name for the server configuration. This property is required when a server is created.| -|description|String|The configuration's description (optional)| -|network|String|The subnet that will be used to allocate virtual address for the clients| -|dnsServers|String collection|The DNS servers that will be used by the clients| -|defaultDomainSuffix|String|The Default Domain appendix that will be used by the clients| -|routeIncludes|String collection|The routes that will be routed by the server| -|routeExcludes|String collection|Subsets of the routes that will not be routed by the server| -|splitDNS|String collection|The domains that will be resolved using the provided dns servers| -|listenPort|Int32|The port that both TCP and UPD will listen over on the server| -|advancedSettings|[keyValuePair](../resources/intune-shared-keyvaluepair.md) collection|Additional settings that may be applied to the server| -|lastUpdateDateTime|DateTimeOffset|When the configuration was last updated| -|roleScopeTagIds|String collection|List of Scope Tags for this Entity instance| -|disableUdpConnections|Boolean|When DisableUdpConnections is set, the clients and VPN server will not use DTLS connections to transfer data.| --## Relationships -None --## JSON Representation -Here is a JSON representation of the resource. -<!-- { - "blockType": "resource", - "keyProperty": "id", - "@odata.type": "microsoft.graph.microsoftTunnelConfiguration" -} >-``` json -{ - "@odata.type": "#microsoft.graph.microsoftTunnelConfiguration", - "id": "String (identifier)", - "displayName": "String", - "description": "String", - "network": "String", - "dnsServers": [ - "String" - ], - "defaultDomainSuffix": "String", - "routeIncludes": [ - "String" - ], - "routeExcludes": [ - "String" - ], - "splitDNS": [ - "String" - ], - "listenPort": 1024, - "advancedSettings": [ - { - "@odata.type": "microsoft.graph.keyValuePair", - "name": "String", - "value": "String" - } - ], - "lastUpdateDateTime": "String (timestamp)", - "roleScopeTagIds": [ - "String" - ], - "disableUdpConnections": true -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelhealththreshold | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/intune-mstunnel-microsofttunnelhealththreshold.md | - Title: "microsoftTunnelHealthThreshold resource type" -description: "Entity that represents the health thresholds of a health metric" --localization_priority: Normal --doc_type: resourcePageType ---# microsoftTunnelHealthThreshold resource type --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Entity that represents the health thresholds of a health metric --## Methods -|Method|Return Type|Description| -|:|:|:| -|[List microsoftTunnelHealthThresholds](../api/intune-mstunnel-microsofttunnelhealththreshold-list.md)|[microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) collection|List properties and relationships of the [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) objects.| -|[Get microsoftTunnelHealthThreshold](../api/intune-mstunnel-microsofttunnelhealththreshold-get.md)|[microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md)|Read properties and relationships of the [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) object.| -|[Create microsoftTunnelHealthThreshold](../api/intune-mstunnel-microsofttunnelhealththreshold-create.md)|[microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md)|Create a new [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) object.| -|[Delete microsoftTunnelHealthThreshold](../api/intune-mstunnel-microsofttunnelhealththreshold-delete.md)|None|Deletes a [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md).| -|[Update microsoftTunnelHealthThreshold](../api/intune-mstunnel-microsofttunnelhealththreshold-update.md)|[microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md)|Update the properties of a [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) object.| --## Properties -|Property|Type|Description| -|:|:|:| -|id|String|The unique identifier for the metric name. Supports: $delete, $update. $Insert, $skip, $top is not supported. Read-only.| -|healthyThreshold|Int64|The threshold for being healthy based on default health status metrics: CPU usage healthy < 50%, Memory usage healthy < 50%, Disk space healthy > 5GB, Latency healthy < 10ms, health metrics can be customized.| -|unhealthyThreshold|Int64|The threshold for being unhealthy based on default health status metrics: CPU usage unhealthy > 75%, Memory usage unhealthy > 75%, Disk space < 3GB, Latency Unhealthy > 20ms, health metrics can be customized.| -|defaultHealthyThreshold|Int64|The threshold for being healthy based on default health status metrics: CPU usage healthy < 50%, Memory usage healthy < 50%, Disk space healthy > 5GB, Latency healthy < 10ms, health metrics can be customized. Read-only.| -|defaultUnhealthyThreshold|Int64|The threshold for being unhealthy based on default health status metrics: CPU usage unhealthy > 75%, Memory usage unhealthy > 75%, Disk space < 3GB, Latency unhealthy > 20ms, health metrics can be customized. Read-only.| --## Relationships -None --## JSON Representation -Here is a JSON representation of the resource. -<!-- { - "blockType": "resource", - "keyProperty": "id", - "@odata.type": "microsoft.graph.microsoftTunnelHealthThreshold" -} >-``` json -{ - "@odata.type": "#microsoft.graph.microsoftTunnelHealthThreshold", - "id": "String (identifier)", - "healthyThreshold": 1024, - "unhealthyThreshold": 1024, - "defaultHealthyThreshold": 1024, - "defaultUnhealthyThreshold": 1024 -} -``` |
v1.0 | Intune Mstunnel Microsofttunnellogcollectionstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/intune-mstunnel-microsofttunnellogcollectionstatus.md | - Title: "microsoftTunnelLogCollectionStatus enum type" -description: "Enum type that represent the status of log collection" --localization_priority: Normal --doc_type: enumPageType ---# microsoftTunnelLogCollectionStatus enum type --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Enum type that represent the status of log collection --## Members -|Member|Value|Description| -|:|:|:| -|pending|0|Indicates that the log collection is in progress| -|completed|1|Indicates that the log collection is completed| -|failed|2|Indicates that the log collection has failed| -|unknownFutureValue|3|Placeholder value for future expansion enums| |
v1.0 | Intune Mstunnel Microsofttunnelserver | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/intune-mstunnel-microsofttunnelserver.md | - Title: "microsoftTunnelServer resource type" -description: "Entity that represents a single Microsoft Tunnel server" --localization_priority: Normal --doc_type: resourcePageType ---# microsoftTunnelServer resource type --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Entity that represents a single Microsoft Tunnel server --## Methods -|Method|Return Type|Description| -|:|:|:| -|[List microsoftTunnelServers](../api/intune-mstunnel-microsofttunnelserver-list.md)|[microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) collection|List properties and relationships of the [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) objects.| -|[Get microsoftTunnelServer](../api/intune-mstunnel-microsofttunnelserver-get.md)|[microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md)|Read properties and relationships of the [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) object.| -|[Create microsoftTunnelServer](../api/intune-mstunnel-microsofttunnelserver-create.md)|[microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md)|Create a new [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) object.| -|[Delete microsoftTunnelServer](../api/intune-mstunnel-microsofttunnelserver-delete.md)|None|Deletes a [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md).| -|[Update microsoftTunnelServer](../api/intune-mstunnel-microsofttunnelserver-update.md)|[microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md)|Update the properties of a [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) object.| -|[generateServerLogCollectionRequest action](../api/intune-mstunnel-microsofttunnelserver-generateserverlogcollectionrequest.md)|[microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md)|Not yet documented| --## Properties -|Property|Type|Description| -|:|:|:| -|id|String|The unique identifier for the managed server. This id is assigned at enrollment time. Supports: $delete. $Update, $insert, $skip, $top is not supported. Read-only.| -|displayName|String|The display name for the server. This property is required when a server is created and cannot be cleared during updates.| -|tunnelServerHealthStatus|[microsoftTunnelServerHealthStatus](../resources/intune-mstunnel-microsofttunnelserverhealthstatus.md)|Indicates the server's health Status as of the last evaluation time. Health is evaluated every 60 seconds, and the possible values are: unknown, healthy, unhealthy, warning, offline, upgradeInProgress, upgradeFailed. Possible values are: `unknown`, `healthy`, `unhealthy`, `warning`, `offline`, `upgradeInProgress`, `upgradeFailed`, `unknownFutureValue`.| -|lastCheckinDateTime|DateTimeOffset|Indicates when the server last checked in| -|agentImageDigest|String|The digest of the current agent image running on this server| -|serverImageDigest|String|The digest of the current server image running on this server| --## Relationships -None --## JSON Representation -Here is a JSON representation of the resource. -<!-- { - "blockType": "resource", - "keyProperty": "id", - "@odata.type": "microsoft.graph.microsoftTunnelServer" -} >-``` json -{ - "@odata.type": "#microsoft.graph.microsoftTunnelServer", - "id": "String (identifier)", - "displayName": "String", - "tunnelServerHealthStatus": "String", - "lastCheckinDateTime": "String (timestamp)", - "agentImageDigest": "String", - "serverImageDigest": "String" -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelserverhealthstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/intune-mstunnel-microsofttunnelserverhealthstatus.md | - Title: "microsoftTunnelServerHealthStatus enum type" -description: "Enum of possible MicrosoftTunnelServer health status types" --localization_priority: Normal --doc_type: enumPageType ---# microsoftTunnelServerHealthStatus enum type --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Enum of possible MicrosoftTunnelServer health status types --## Members -|Member|Value|Description| -|:|:|:| -|unknown|0|Indicates that the health status of the server is unknown. This occurs when no health status has been reported, for example when the server is initialized, but has not yet been evaluated for its health.| -|healthy|1|Indicates that the health status of the server is healthy. This should be the normal operational health status.| -|unhealthy|2|Indicates that the health status of the server is unhealthy. This is normally a transient condition that will last up to 5 minutes. If the server cannot be remediated while reporting unhealthy state, the health state will change to 'warning'. If it can be remediated, the health state will return to 'healthy'.| -|warning|3|Indicates a warning based on the Tunnel Gateway server's CPU usage, memory usage, latency, TLS certificate, version| -|offline|4|Indicates the server state is offline| -|upgradeInProgress|5|Indicates the upgrade in progress during the upgrade cycle of when Intune begins upgrading servers, one server at a time| -|upgradeFailed|6|Indicates the failure of the upgrade during the upgrade cycle of when Intune begins upgrading servers, one server at a time| -|unknownFutureValue|7|Evolvable enumeration sentinel value. Do not use enums.| |
v1.0 | Intune Mstunnel Microsofttunnelserverlogcollectionresponse | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md | - Title: "microsoftTunnelServerLogCollectionResponse resource type" -description: "Entity that stores the server log collection status." --localization_priority: Normal --doc_type: resourcePageType ---# microsoftTunnelServerLogCollectionResponse resource type --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Entity that stores the server log collection status. --## Methods -|Method|Return Type|Description| -|:|:|:| -|[List microsoftTunnelServerLogCollectionResponses](../api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-list.md)|[microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) collection|List properties and relationships of the [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) objects.| -|[Get microsoftTunnelServerLogCollectionResponse](../api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-get.md)|[microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md)|Read properties and relationships of the [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) object.| -|[Create microsoftTunnelServerLogCollectionResponse](../api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-create.md)|[microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md)|Create a new [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) object.| -|[Delete microsoftTunnelServerLogCollectionResponse](../api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-delete.md)|None|Deletes a [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md).| -|[Update microsoftTunnelServerLogCollectionResponse](../api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-update.md)|[microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md)|Update the properties of a [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) object.| -|[generateDownloadUrl action](../api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-generatedownloadurl.md)|String|Not yet documented| --## Properties -|Property|Type|Description| -|:|:|:| -|id|String|The unique identifier for server log collection response. Read-only.| -|status|[microsoftTunnelLogCollectionStatus](../resources/intune-mstunnel-microsofttunnellogcollectionstatus.md)|The status of log collection. Possible values are: pending, completed, failed. Possible values are: `pending`, `completed`, `failed`, `unknownFutureValue`.| -|startDateTime|DateTimeOffset|The start time of the logs collected| -|endDateTime|DateTimeOffset|The end time of the logs collected| -|sizeInBytes|Int64|The size of the logs in bytes| -|serverId|String|ID of the server the log collection is requested upon| -|requestDateTime|DateTimeOffset|The time when the log collection was requested| -|expiryDateTime|DateTimeOffset|The time when the log collection is expired| --## Relationships -None --## JSON Representation -Here is a JSON representation of the resource. -<!-- { - "blockType": "resource", - "keyProperty": "id", - "@odata.type": "microsoft.graph.microsoftTunnelServerLogCollectionResponse" -} >-``` json -{ - "@odata.type": "#microsoft.graph.microsoftTunnelServerLogCollectionResponse", - "id": "String (identifier)", - "status": "String", - "startDateTime": "String (timestamp)", - "endDateTime": "String (timestamp)", - "sizeInBytes": 1024, - "serverId": "String", - "requestDateTime": "String (timestamp)", - "expiryDateTime": "String (timestamp)" -} -``` |
v1.0 | Intune Mstunnel Microsofttunnelsite | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/intune-mstunnel-microsofttunnelsite.md | - Title: "microsoftTunnelSite resource type" -description: "Entity that represents a Microsoft Tunnel site" --localization_priority: Normal --doc_type: resourcePageType ---# microsoftTunnelSite resource type --Namespace: microsoft.graph --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Entity that represents a Microsoft Tunnel site --## Methods -|Method|Return Type|Description| -|:|:|:| -|[List microsoftTunnelSites](../api/intune-mstunnel-microsofttunnelsite-list.md)|[microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) collection|List properties and relationships of the [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) objects.| -|[Get microsoftTunnelSite](../api/intune-mstunnel-microsofttunnelsite-get.md)|[microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md)|Read properties and relationships of the [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) object.| -|[Create microsoftTunnelSite](../api/intune-mstunnel-microsofttunnelsite-create.md)|[microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md)|Create a new [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) object.| -|[Delete microsoftTunnelSite](../api/intune-mstunnel-microsofttunnelsite-delete.md)|None|Deletes a [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md).| -|[Update microsoftTunnelSite](../api/intune-mstunnel-microsofttunnelsite-update.md)|[microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md)|Update the properties of a [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) object.| --## Properties -|Property|Type|Description| -|:|:|:| -|id|String|The unique identifier for the site id. $Insert, $skip, $top is not supported. Read-only.| -|displayName|String|The display name for the site. This property is required when a site is created.| -|description|String|The site's description (optional)| -|publicAddress|String|The site's public domain name or IP address| -|upgradeWindowUtcOffsetInMinutes|Int32|The site's timezone represented as a minute offset from UTC| -|upgradeWindowStartTime|TimeOfDay|The site's upgrade window start time of day| -|upgradeWindowEndTime|TimeOfDay|The site's upgrade window end time of day| -|upgradeAutomatically|Boolean|The site's automatic upgrade setting. True for automatic upgrades, false for manual control| -|upgradeAvailable|Boolean|The site provides the state of when an upgrade is available| -|internalNetworkProbeUrl|String|The site's Internal Network Access Probe URL| -|roleScopeTagIds|String collection|List of Scope Tags for this Entity instance| --## Relationships -|Relationship|Type|Description| -|:|:|:| -|microsoftTunnelConfiguration|[microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md)|The MicrosoftTunnelConfiguration that has been applied to this MicrosoftTunnelSite| -|microsoftTunnelServers|[microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) collection|A list of MicrosoftTunnelServers that are registered to this MicrosoftTunnelSite| --## JSON Representation -Here is a JSON representation of the resource. -<!-- { - "blockType": "resource", - "keyProperty": "id", - "@odata.type": "microsoft.graph.microsoftTunnelSite" -} >-``` json -{ - "@odata.type": "#microsoft.graph.microsoftTunnelSite", - "id": "String (identifier)", - "displayName": "String", - "description": "String", - "publicAddress": "String", - "upgradeWindowUtcOffsetInMinutes": 1024, - "upgradeWindowStartTime": "String (time of day)", - "upgradeWindowEndTime": "String (time of day)", - "upgradeAutomatically": true, - "upgradeAvailable": true, - "internalNetworkProbeUrl": "String", - "roleScopeTagIds": [ - "String" - ] -} -``` |
v1.0 | Invitation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/invitation.md | The invitation process uses the following flow: * The invited user clicks on the invitation link, signs in and redeems the invitation and creation of the user entity representing the invited user completes * The user is redirected to a specific page after redemption completes -Creating an invitation returns a redemption URL in the response (*inviteRedeemUrl*). The create invitation API can automatically send an email containing the redemption URL to the invited user, by setting the *sendInvitationMessage* to true. You can also customize the message that is sent to the invited user. Instead, if you wish to send the redemption URL through some other means, you can set the *sendInvitationMessage* to false and use the redeem URL from the response to craft your own communication. Currently, there's no API to perform the redemption process. The invited user has to click on the *inviteRedeemUrl* link sent in the communication in the step above, and go through the interactive redemption process in a browser. Once completed, the invited user becomes an external user in the organization. +Creating an invitation returns a redemption URL in the response (*inviteRedeemUrl*). The create invitation API can automatically send an email containing the redemption URL to the invited user, by setting the *sendInvitationMessage* to true. You can also customize the message that is sent to the invited user. Instead, if you wish to send the redemption URL through some other means, you can set the *sendInvitationMessage* to false and use the redeem URL from the response to craft your own communication. Currently, there's no API to perform the redemption process. The invited user has to click on the *inviteRedeemUrl* link sent in the communication step, and go through the interactive redemption process in a browser. Once completed, the invited user becomes an external user in the organization. ## Methods Creating an invitation returns a redemption URL in the response (*inviteRedeemUr | Property| Type|Description| |:|:|:| |invitedUserDisplayName|String|The display name of the user being invited.|-|invitedUserEmailAddress|String|The email address of the user being invited. Required. The following special characters aren't permitted in the email address:<br><ul><li>Tilde (`~`)</li><li>Exclamation point (`!`)</li><li>Number sign (`#`)</li><li>Dollar sign (`$`)</li><li>Percent (`%`)</li><li>Circumflex (`^`)</li><li>Ampersand (`&`)</li><li>Asterisk (`*`)</li><li>Parentheses (`( )`)</li><li>Plus sign (`+`)</li><li>Equal sign (`=`)</li><li>Brackets (`[ ]`)</li><li>Braces (`{ }`)</li><li>Backslash (`\`)</li><li>Slash mark (`/`)</li><li>Pipe (`\|`)</li><li>Semicolon (`;`)</li><li>Colon (`:`)</li><li>Quotation marks (`"`)</li><li>Angle brackets (`< >`)</li><li>Question mark (`?`)</li><li>Comma (`,`)</li></ul><br>However, the following exceptions apply:<br><ul><li>A period (`.`) or a hyphen (`-`) is permitted anywhere in the user name, except at the beginning or end of the name.</li><li>An underscore (`_`) is permitted anywhere in the user name. This includes at the beginning or end of the name.</li></ul>| -|invitedUserMessageInfo|[invitedUserMessageInfo](invitedusermessageinfo.md)|Additional configuration for the message being sent to the invited user, including customizing message text, language and cc recipient list.| +|invitedUserEmailAddress|String|The email address of the user being invited. Required. The following special characters aren't permitted in the email address:<br><ul><li>Tilde (`~`)</li><li>Exclamation point (`!`)</li><li>Number sign (`#`)</li><li>Dollar sign (`$`)</li><li>Percent (`%`)</li><li>Circumflex (`^`)</li><li>Ampersand (`&`)</li><li>Asterisk (`*`)</li><li>Parentheses (`( )`)</li><li>Plus sign (`+`)</li><li>Equal sign (`=`)</li><li>Brackets (`[ ]`)</li><li>Braces (`{ }`)</li><li>Backslash (`\`)</li><li>Slash mark (`/`)</li><li>Pipe (`\|`)</li><li>Semicolon (`;`)</li><li>Colon (`:`)</li><li>Quotation marks (`"`)</li><li>Angle brackets (`< >`)</li><li>Question mark (`?`)</li><li>Comma (`,`)</li></ul><br>However, the following exceptions apply:<br><ul><li>A period (`.`) or a hyphen (`-`) is permitted anywhere in the user name, except at the beginning or end of the name.</li><li>An underscore (`_`) is permitted anywhere in the user name, including at the beginning or end of the name.</li></ul>| +|invitedUserMessageInfo|[invitedUserMessageInfo](invitedusermessageinfo.md)|Additional configuration for the message being sent to the invited user, including customizing message text, language, and cc recipient list.| |invitedUserType|String|The userType of the user being invited. By default, this is `Guest`. You can invite as `Member` if you're a company administrator. | |inviteRedirectUrl|String|The URL the user should be redirected to once the invitation is redeemed. Required.| |inviteRedeemUrl|String|The URL the user can use to redeem their invitation. Read-only.| Creating an invitation returns a redemption URL in the response (*inviteRedeemUr | Relationship | Type |Description| |:|:--|:-| |invitedUser|[User](user.md)|The user created as part of the invitation creation. Read-Only|+|invitedUserSponsors|[directoryObject](../resources/directoryobject.md) collection|The users or groups who are sponsors of the invited user. Sponsors are users and groups that are responsible for guest users' privileges in the tenant and for keeping the guest users' information and access up to date. | ## JSON representation-Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "baseType": "microsoft.graph.entity", "@odata.type": "microsoft.graph.invitation" } --> ```json |
v1.0 | Invitationredemptionidentityproviderconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/invitationredemptionidentityproviderconfiguration.md | + + Title: "invitationRedemptionIdentityProviderConfiguration resource type" +description: "Defines the invitation redemption provider configuration base type to set redemption flow settings for Microsoft Entra ID B2B collaboration." ++ms.localizationpriority: medium ++++# invitationRedemptionIdentityProviderConfiguration resource type ++Namespace: microsoft.graph ++Defines the invitation redemption provider configuration base type to set redemption flow settings for Microsoft Entra ID B2B collaboration. ++Two types of identity providers are in the precedence order: primary identity providers and fallback identity providers. Fallback identity providers are used when no primary identity provider is available and must always be specified. ++The primary identity providers are: ++- azureActiveDirectory: Any user located in another Microsoft Entra ID tenant. +- externalFederation: Any user located in an identity provider associated with a SAML or WS-Federation relationship. +- socialIdentityProviders: Any user using a gmail.com account when Google Federation is configured. ++The fallback identity providers are: ++- defaultConfiguredIdp: Check for an existing Microsoft account, then use a one-time email passcode (if enabled), and finally, create a new Microsoft account if no primary identity providers are available for the user. +- emailOneTimePasscode: Always use one-time email passcode if no primary identity providers are available for the user. +- microsoftAccount: Always use an existing Microsoft account or create a new Microsoft account if no primary identity providers are available for the user. ++## Properties ++|Property|Type|Description| +|:|:|:| +| primaryIdentityProviderPrecedenceOrder | b2bIdentityProvidersType collection | Collection of identity providers in priority order of preference to be used for guest invitation redemption. Possible values are: `azureActiveDirectory`, `externalFederation`, or `socialIdentityProviders`. | +| fallbackIdentityProvider | b2bIdentityProvidersType | The fallback identity provider to be used in case no primary identity provider can be used for guest invitation redemption. Possible values are: `defaultConfiguredIdp`, `emailOneTimePasscode`, or `microsoftAccount`. | ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.invitationRedemptionIdentityProviderConfiguration" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.invitationRedemptionIdentityProviderConfiguration", + "primaryIdentityProviderPrecedenceOrder": [ + "String" + ], + "fallbackIdentityProvider": "String" +} +``` |
v1.0 | Invitedusermessageinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/invitedusermessageinfo.md | The invitedUserMessageInfo object allows you to configure the [invitation](invit |messageLanguage|String|The language you want to send the default message in. If the customizedMessageBody is specified, this property is ignored, and the message is sent using the customizedMessageBody. The language format should be in ISO 639. The default is en-US.| ## JSON representation-Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- {"blockType": "resource", "@odata.type": "microsoft.graph.invitedUserMessageInfo"} --> ```json |
v1.0 | Invitenewbotresponse | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/invitenewbotresponse.md | Contains a response to a request to have a participant joining notification sent ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Inviteparticipantsoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/inviteparticipantsoperation.md | Represents the status of a long-running participant invitation operation, trigge ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Ipnamedlocation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/ipnamedlocation.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Iprange | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/iprange.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Ipv4cidrrange | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/ipv4cidrrange.md | Inherits from [ipRange](../resources/iprange.md) ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Ipv6cidrrange | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/ipv6cidrrange.md | Inherits from [ipRange](../resources/iprange.md) ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Itemattachment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/itemattachment.md | Derived from [attachment](attachment.md). ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Itembody | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/itembody.md | Represents properties of the body of an item, such as a message, event or group ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Json | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/json.md | None. None. ## JSON Representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", "@odata.type": "microsoft.graph.Json" |
v1.0 | Keyvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/keyvalue.md | Represents a key-value pair. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Learningcontent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/learningcontent.md | Inherits from [entity](../resources/entity.md). |duration|Duration|The duration of the learning content in seconds. The value is represented in ISO 8601 format for durations. Optional.| |externalId|String|Unique external content ID for the learning content. Required.| |format|String|The format of the learning content. For example, `Course`, `Video`, `Book`, `Book Summary`, `Audiobook Summary`. Optional.|+|level|Level|The difficulty level of the learning content. Possible values are: `Beginner`, `Intermediate`, `Advanced`, `unknownFutureValue`. Optional.| |id|String|The unique identifier for the learning content. Not nullable. Read-only. Inherited from [entity](../resources/entity.md).| |isActive|Boolean|Indicates whether the content is active or not. Inactive content doesn't show up in the UI. The default value is `true`. Optional.| |isPremium|Boolean|Indicates whether the learning content requires the user to sign-in on the learning provider platform or not. The default value is `false`. Optional.| Inherits from [entity](../resources/entity.md). |thumbnailWebUrl|String|The URL of learning content thumbnail image. Optional.| |title|String|The title of the learning content. Required.| +## Level values +|Member|Description| +|:|:| +|Beginner|For learning content at a beginner level.| +|Intermediate|For learning content at an intermediate level.| +|Advanced|For learning content at an advanced level.| +|UnknownFutureValue|Evolvable enumeration sentinel value. Do not use.| + ## Relationships None. The following is a JSON representation of the resource. "duration": "String (duration)", "externalId": "String", "format": "String",+ "level": "String", "id": "String (identifier)", "isActive": "Boolean", "isPremium": "Boolean", |
v1.0 | Licenseassignmentstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/licenseassignmentstate.md | The **licenseAssignmentStates** property of the [user](user.md) entity is a coll ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. ```json { |
v1.0 | Licensedetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/licensedetails.md | Title: "licenseDetails resource type" description: "Contains information about a license assigned to a user." ms.localizationpriority: medium + doc_type: resourcePageType Contains information about a license assigned to a user. | Method | Return Type |Description| |:|:--|:-| |[List licenseDetails](../api/user-list-licensedetails.md) | [licenseDetails](../resources/licensedetails.md) collection |Retrieve a list of [licenseDetails](../resources/licensedetails.md) objects for a user.|+|[getTeamsLicensingDetails](../api/licensedetails-getteamslicensingdetails.md)|[teamsLicensingDetails](../resources/teamsLicensingDetails.md) object|Get the Microsoft Teams license details for the specified user.| <!--|[Get licenseDetails](../api/licensedetails-get.md) | licenseDetails |Read properties and relationships of a licenseDetails object.|--> |
v1.0 | Licenseunitsdetail | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/licenseunitsdetail.md | The **prepaidUnits** property of the [subscribedSku](subscribedsku.md) entity is ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Listinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/listinfo.md | The **listInfo** complex type provides additional information about a [list][]. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Listitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/listitem.md | - Title: listItem resource -description: Represents an item in a sharepoint list. ++ Title: "listItem resource" +description: "Represents an item in a SharePoint list." ms.localizationpriority: high doc_type: resourcePageType All examples are relative to a **[list][]**: `https://graph.microsoft.com/v1.0/s | [List documentSetVersions](../api/listitem-list-documentsetversions.md) | [documentSetVersion][] collection | Get a list of the versions of a document set item in a list. | | [Create documentSetVersion](../api/listitem-post-documentsetversions.md) | [documentSetVersion][] | Create a new version of a document set item in a list. | | [Restore documentSetVersion](../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. | [Get]: ../api/listitem-get.md [Get analytics]: ../api/itemanalytics-get.md The following properties are inherited from **[baseItem][]**. ## JSON representation -The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Localeinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/localeinfo.md | Information about the locale, including the preferred language and country/regio ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Locationconstraint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/locationconstraint.md | The conditions stated by a client for the location of a meeting. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Locationconstraintitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/locationconstraintitem.md | Derived from [location](location.md). ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Loginpagelayoutconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/loginpagelayoutconfiguration.md | Contains details of the layout of the sign-in page for a tenant. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.loginPageLayoutConfiguration" |
v1.0 | Mailassessmentrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/mailassessmentrequest.md | When you create a mail threat assessment request, the mail should be received by ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Mailboxsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/mailboxsettings.md | You can [get](../api/user-get-mailboxsettings.md) or [update](../api/user-update ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Mailfolder | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/mailfolder.md | By default, [listing mailFolders](../api/user-list-mailfolders.md) returns only ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Mailtips | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/mailtips.md | as an automatic reply for a message recipient. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Mailtipserror | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/mailtipserror.md | An error that occurs during an action. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Malwarestate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/malwarestate.md | Contains stateful information about the malware entity. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Mediainfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/mediainfo.md | The media information used in actions for prompts. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Mediastream | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/mediastream.md | This contains information about the media channel. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Meetingattendancereport | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/meetingattendancereport.md | doc_type: resourcePageType Namespace: microsoft.graph -Contains information associated with a meeting attendance report. +Contains information associated with a meeting attendance report for an [onlineMeeting](../resources/onlinemeeting.md) or a [virtualEvent](../resources/virtualevent.md). Meeting attendance reports are online meeting artifacts. For details, see [Online meeting artifacts and permissions](/graph/cloud-communications-online-meeting-artifacts). |
v1.0 | Meetingparticipantinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/meetingparticipantinfo.md | The following table lists the members of an [evolvable enumeration](/graph/best- ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Meetingtimesuggestion | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/meetingtimesuggestion.md | availability, and available meeting locations. ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Meetingtimesuggestionsresult | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/meetingtimesuggestionsresult.md | The following are the possible reasons that [findMeetingTimes](../api/user-findm ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Message | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/message.md | by providing a [delta](../api/message-delta.md) function. ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Messagerule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/messagerule.md | Title: "messageRule resource type" -description: "A rule that applies to messages in the Inbox of a user." +description: "Represents a rule that applies to messages in the Inbox of a user." ms.localizationpriority: medium doc_type: resourcePageType Namespace: microsoft.graph -A rule that applies to messages in the Inbox of a user. +Represents a rule that applies to messages in the Inbox of a user. In Outlook, you can set up rules for incoming messages in the Inbox to carry out specific actions upon certain conditions. and available rule conditions and exceptions are represented by the [messageRule | Property | Type |Description| |:|:--|:-| | actions | [messageRuleActions](messageruleactions.md) | Actions to be taken on a message when the corresponding conditions are fulfilled. |-| conditions | [messageRulePredicates](messagerulepredicates.md) | Conditions that when fulfilled, will trigger the corresponding actions for that rule. | +| conditions | [messageRulePredicates](messagerulepredicates.md) | Conditions that when fulfilled trigger the corresponding actions for that rule. | | displayName | String | The display name of the rule. | | exceptions | [messageRulePredicates](messagerulepredicates.md) | Exception conditions for the rule. | | hasError | Boolean | Indicates whether the rule is in an error condition. Read-only. | and available rule conditions and exceptions are represented by the [messageRule ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Messageruleactions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/messageruleactions.md | Represents the set of actions that are available to a rule. | stopProcessingRules | Boolean | Indicates whether subsequent rules should be evaluated. | ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Messagerulepredicates | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/messagerulepredicates.md | Represents the set of conditions and exceptions that are available for a rule. | withinSizeRange | [sizeRange](sizerange.md) | Represents the minimum and maximum sizes (in kilobytes) that an incoming message must fall in between in order for the condition or exception to apply. | ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Metadatakeystringpair | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/metadatakeystringpair.md | + + Title: 'metaDataKeyStringPair resource type' +description: Represents a key-value (string) pair of the metadata. ++ms.localizationpriority: medium +++# metaDataKeyStringPair resource type ++Namespace: microsoft.graph ++++Represents a key-value (string) pair of the metadata. ++## Properties ++| Property | Type | Description | +| :- | :-- | : | +| key | String | Key of the meta data. | +| value | String | Value of the meta data. | ++## Relationships ++None. ++## JSON representation ++The following is a JSON representation of the resource. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.metaDataKeyStringPair" +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.metaDataKeyStringPair", + "key": "String", + "value": "String" +} +``` |
v1.0 | Metadatakeyvaluepair | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/metadatakeyvaluepair.md | + + Title: 'metaDataKeyValuePair resource type' +description: Represents a key-value (object) pair of the metadata. ++ms.localizationpriority: medium +++# metaDataKeyValuePair resource type ++Namespace: microsoft.graph ++++Represents a key-value (object) pair of the metadata. ++## Properties ++| Property | Type | Description | +| :- | : | :- | +| key | String | Key of the metadata. | +| value | [Json](../resources/json.md) | Value of the metadata. Should be an object. | ++## Relationships ++None. ++## JSON representation ++The following is a JSON representation of the resource. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.metaDataKeyValuePair" +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.metaDataKeyValuePair", + "key": "String", + "value": { + "@odata.type": "microsoft.graph.Json" + } +} +``` |
v1.0 | Microsoftauthenticatorauthenticationmethod | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/microsoftauthenticatorauthenticationmethod.md | This is a derived type that inherits from the [authenticationMethod](authenticat |device|[device](../resources/device.md)|The registered device on which Microsoft Authenticator resides. This property is null if the device isn't registered for passwordless Phone Sign-In.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Microsoftauthenticatorfeaturesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/microsoftauthenticatorfeaturesettings.md | Represents Microsoft Authenticator settings such as application context and loca None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.microsoftAuthenticatorFeatureSettings" |
v1.0 | Modifiedproperty | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/modifiedproperty.md | Indicates all the properties on a Microsoft Entra resource that have been modifi ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Multitenantorganization Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/multitenantorganization-overview.md | + + Title: "Multitenant organization API overview" +description: "Multitenant organizations allow you to define an organization with more than one instance of Microsoft Entra ID." ++ms.localizationpriority: medium + Last updated : 04/23/2024+++# Multitenant organization API overview ++The multitenant organization feature allows you to define an organization with more than one instance of Microsoft Entra ID. A multitenant organization enables multiple tenants to collaborate like a single entity. ++## Multitenant organization setup ++In the directory, a multitenant organization represents a group of tenants that belong to your parent organization. This group of tenants is shared and agreed-upon between the tenant administrators through a collaborative setup process. ++One tenant creates the multitenant organization. The tenant that creates the multitenant organization is assigned the multitenant organization role of owner. A multitenant organization owner has permissions to add tenants into a pending state, remove tenants from the multitenant organization, and change the role of any multitenant organization tenant. ++To join the multitenant organization, pending tenants must submit a join request to join the multitenant organization and turn their multitenant organization status to active. Joined or active tenants typically start with the multitenant organization member role. Any multitenant organization member tenant has the permissions to leave the multitenant organization. ++## Cross-tenant access settings and templates ++Cross-tenant access [partner configurations](../resources/crosstenantaccesspolicyconfigurationpartner.md) and [user synchronization settings](../resources/crosstenantidentitysyncpolicypartner.md) are required between all tenant pairs in a multitenant organization. If they don't already exist at the time of any pending tenant joining a multitenant organization, partner configurations and user synchronization settings for any new tenant pairs will be autogenerated in an unconfigured state. ++Optional multitenant organization templates for partner configurations and user synchronization settings, if configured, allow for the automatic modification of existing or autogenerated partner configurations and user synchronization settings for any new tenant pairs, at the time of such joining. ++## Multitenant organization size limitation ++A multitenant organization has a default maximum of 100 active tenants, including owner tenants. If this maximum is exceeded by any submitted join request, the join request fails. ++If you need to increase this limit, you can submit a support request using the Azure portal or Microsoft Entra admin center. In your request, include the tenant ID of one owner tenant and a list of all tenant IDs that are intended to be part of the finalized multitenant organization. ++## Related content +++ [What is a multitenant organization in Microsoft Entra ID?](/entra/identity/multi-tenant-organizations/overview)++ [multiTenantOrganization resource type](../resources/multitenantorganization.md) |
v1.0 | Multitenantorganization | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/multitenantorganization.md | + + Title: "multiTenantOrganization resource type" +description: "Defines an organization with more than one instance of Microsoft Entra ID." ++ms.localizationpriority: medium ++++# multiTenantOrganization resource type ++Namespace: microsoft.graph ++Defines an organization with more than one instance of Microsoft Entra ID. A multitenant organization enables multiple tenants to collaborate like a single entity. ++There can only be one multitenant organization per active tenant. It is not possible to be part of multiple multitenant organizations. ++## Methods +|Method|Return type|Description| +|:|:|:| +|[Create multiTenantOrganization](../api/tenantrelationship-put-multitenantorganization.md)|[multiTenantOrganization](../resources/multitenantorganization.md)|Create a new multitenant organization.| +|[Get multiTenantOrganization](../api/multitenantorganization-get.md)|[multiTenantOrganization](../resources/multitenantorganization.md)|Get properties of the multitenant organization.| +|[Update multiTenantOrganization](../api/multitenantorganization-update.md)|[multiTenantOrganization](../resources/multitenantorganization.md)|Update the properties of a multitenant organization.| ++## Properties +|Property|Type|Description| +|:|:|:| +|createdDateTime|DateTimeOffset|Date when multitenant organization was created. Read-only.| +|description|String|Description of the multitenant organization.| +|displayName|String|Display name of the multitenant organization.| +|id|String|Tenant-specific object ID for the multitenant organization object. It is automatically generated when a multitenant organization object is created and stored in the local tenant. This ID is tenant-specific and doesn't match the object IDs of the same multitenant organization in other tenants. Read-only. Inherited from [entity](../resources/entity.md).| +|state|multiTenantOrganizationState|State of the multitenant organization. The possible values are: `active`, `inactive`, `unknownFutureValue`. `active` indicates the multitenant organization is created. `inactive` indicates the multitenant organization isn't created. Read-only.| ++## Relationships +|Relationship|Type|Description| +|:|:|:| +|joinRequest|[multiTenantOrganizationJoinRequestRecord](../resources/multitenantorganizationjoinrequestrecord.md)|Defines the status of a tenant joining a multitenant organization.| +|tenants|[multiTenantOrganizationMember](../resources/multitenantorganizationmember.md) collection|Defines tenants added to a multitenant organization.| ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.multiTenantOrganization", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.multiTenantOrganization", + "id": "String (identifier)", + "createdDateTime": "String (timestamp)", + "displayName": "String", + "description": "String", + "state": "String" +} +``` |
v1.0 | Multitenantorganizationidentitysyncpolicytemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/multitenantorganizationidentitysyncpolicytemplate.md | + + Title: "multiTenantOrganizationIdentitySyncPolicyTemplate resource type" +description: "Defines an optional cross-tenant access policy template with user synchronization settings for multitenant organization tenants." ++ms.localizationpriority: medium ++++# multiTenantOrganizationIdentitySyncPolicyTemplate resource type ++Namespace: microsoft.graph ++Defines an optional cross-tenant access policy template with user synchronization settings for multitenant organization tenants. Each tenant has its own template. For more information, see [crossTenantIdentitySyncPolicyPartner resource type](crosstenantidentitysyncpolicypartner.md). ++* If your tenant is joining a multitenant organization, the template is applicable to the user synchronization settings for all multitenant organization tenants. +* If another tenant joins your multitenant organization, the template is applicable only to the user synchronization settings of the newly joined multitenant organization tenant. ++Whether the template is applied to the user synchronization settings of relevant tenants is configurable with the `templateApplicationLevel` property. ++* If the template is configured to apply, it is only applied to user synchronization properties where the corresponding template property has a non-null value. ++In its default and unconfigured state, where all template properties (other than `templateApplicationLevel`) are null, the template has no effect on user synchronization settings. ++## Methods +|Method|Return type|Description| +|:|:|:| +|[Get multiTenantOrganizationIdentitySyncPolicyTemplate](../api/multitenantorganizationidentitysyncpolicytemplate-get.md)|[multiTenantOrganizationIdentitySyncPolicyTemplate](../resources/multitenantorganizationidentitysyncpolicytemplate.md)|Get the user synchronization settings of the template.| +|[Update multiTenantOrganizationIdentitySyncPolicyTemplate](../api/multitenantorganizationidentitysyncpolicytemplate-update.md)|[multiTenantOrganizationIdentitySyncPolicyTemplate](../resources/multitenantorganizationidentitysyncpolicytemplate.md)|Update the user synchronization settings of the template.| +|[resetToDefaultSettings](../api/multitenantorganizationidentitysyncpolicytemplate-resettodefaultsettings.md)|None|Reset the user synchronization settings of the template to the default values.| ++## Properties +|Property|Type|Description| +|:|:|:| +|id|String|ID of the template. Key.| +|templateApplicationLevel|templateApplicationLevel|Specifies whether the template will be applied to user synchronization settings of certain tenants. The possible values are: `none`, `newPartners`, `existingPartners`, `unknownFutureValue`. You can also specify multiple values like `newPartners,existingPartners` (default). `none` indicates the template isn't applied to any new or existing partner tenants. `newPartners` indicates the template is applied to new partner tenants. `existingPartners` indicates the template is applied to existing partner tenants, those who already had partner-specific user synchronization settings in place.| +|userSyncInbound|[crossTenantUserSyncInbound](../resources/crosstenantusersyncinbound.md)|Defines whether users can be synchronized from the partner tenant.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.multiTenantOrganizationIdentitySyncPolicyTemplate", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.multiTenantOrganizationIdentitySyncPolicyTemplate", + "templateApplicationLevel": "String", + "userSyncInbound": { + "@odata.type": "microsoft.graph.crossTenantUserSyncInbound" + } +} +``` + |
v1.0 | Multitenantorganizationjoinrequestrecord | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/multitenantorganizationjoinrequestrecord.md | + + Title: "multiTenantOrganizationJoinRequestRecord resource type" +description: "Defines the status of a tenant joining a multitenant organization." ++ms.localizationpriority: medium ++++# multiTenantOrganizationJoinRequestRecord resource type ++Namespace: microsoft.graph ++Defines the status of a tenant joining a multitenant organization. Before a tenant added to a multitenant organization can participate in the multitenant organization, the administrator of the tenant must join the multitenant organization. ++## Methods +|Method|Return type|Description| +|:|:|:| +|[Get multiTenantOrganizationJoinRequestRecord](../api/multitenantorganizationjoinrequestrecord-get.md)|[multiTenantOrganizationJoinRequestRecord](../resources/multitenantorganizationjoinrequestrecord.md)|Get the status of a tenant joining a multitenant organization.| +|[Update multiTenantOrganizationJoinRequestRecord](../api/multitenantorganizationjoinrequestrecord-update.md)|[multiTenantOrganizationJoinRequestRecord](../resources/multitenantorganizationjoinrequestrecord.md)|Join a multitenant organization.| ++## Properties +|Property|Type|Description| +|:|:|:| +|addedByTenantId|String|Tenant ID of the Microsoft Entra tenant that added a tenant to the multitenant organization. To reset a failed join request, set `addedByTenantId` to `00000000-0000-0000-0000-000000000000`. Required.| +|memberState|multiTenantOrganizationMemberState|State of the tenant in the multitenant organization. The possible values are: `pending`, `active`, `removed`, `unknownFutureValue`. Tenants in the pending state must [join the multitenant organization](../api/multitenantorganizationjoinrequestrecord-update.md) to participate in the multitenant organization. Tenants in the active state can participate in the multitenant organization. Tenants in the removed state are in the process of being removed from the multitenant organization. Read-only.| +|role|multiTenantOrganizationMemberRole|Role of the tenant in the multitenant organization. The possible values are: `owner`, `member` (default), `unknownFutureValue`. Tenants with the owner role can manage the multitenant organization. There can be multiple tenants with the owner role in a multitenant organization. Tenants with the member role can participate in a multitenant organization.| +|transitionDetails|[multiTenantOrganizationJoinRequestTransitionDetails](../resources/multitenantorganizationjoinrequesttransitiondetails.md)|Details of the processing status for a tenant joining a multitenant organization. Read-only.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.multiTenantOrganizationJoinRequestRecord", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.multiTenantOrganizationJoinRequestRecord", + "addedByTenantId": "String", + "memberState": "String", + "role": "String", + "transitionDetails": { + "@odata.type": "microsoft.graph.multiTenantOrganizationJoinRequestTransitionDetails" + } +} +``` |
v1.0 | Multitenantorganizationjoinrequesttransitiondetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/multitenantorganizationjoinrequesttransitiondetails.md | + + Title: "multiTenantOrganizationJoinRequestTransitionDetails resource type" +description: "Details of the processing status for a tenant joining a multitenant organization." ++ms.localizationpriority: medium ++++# multiTenantOrganizationJoinRequestTransitionDetails resource type ++Namespace: microsoft.graph ++Details of the processing status for a tenant joining a multitenant organization. ++## Properties +|Property|Type|Description| +|:|:|:| +|desiredMemberState|multiTenantOrganizationMemberState|State of the tenant in the multitenant organization currently being processed. The possible values are: `pending`, `active`, `removed`, `unknownFutureValue`. Read-only.| +|details|String|Details that explain the processing status if any. Read-only.| +|status|multiTenantOrganizationMemberProcessingStatus|Processing state of the asynchronous job. The possible values are: `notStarted`, `running`, `succeeded`, `failed`, `unknownFutureValue`. Read-only.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.multiTenantOrganizationJoinRequestTransitionDetails" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.multiTenantOrganizationJoinRequestTransitionDetails", + "desiredMemberState": "String", + "status": "String", + "details": "String" +} +``` + |
v1.0 | Multitenantorganizationmember | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/multitenantorganizationmember.md | + + Title: "multiTenantOrganizationMember resource type" +description: "Defines a tenant added to a multitenant organization." ++ms.localizationpriority: medium ++++# multiTenantOrganizationMember resource type ++Namespace: microsoft.graph ++Defines a tenant added to a multitenant organization. ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List multiTenantOrganizationMembers](../api/multitenantorganization-list-tenants.md)|[multiTenantOrganizationMember](../resources/multitenantorganizationmember.md) collection|List the tenants and their properties in the multitenant organization.| +|[Add multiTenantOrganizationMember](../api/multitenantorganization-post-tenants.md)|[multiTenantOrganizationMember](../resources/multitenantorganizationmember.md)|Add a tenant to a multitenant organization.| +|[Get multiTenantOrganizationMember](../api/multitenantorganizationmember-get.md)|[multiTenantOrganizationMember](../resources/multitenantorganizationmember.md)|Get a tenant and its properties in the multitenant organization.| +|[Update multiTenantOrganizationMember](../api/multitenantorganizationmember-update.md)|[multiTenantOrganizationMember](../resources/multitenantorganizationmember.md)|Update the properties of a tenant in a multitenant organization.| +|[Remove multiTenantOrganizationMember](../api/multitenantorganization-delete-tenants.md)|None|Remove a tenant from a multitenant organization.| ++## Properties +|Property|Type|Description| +|:|:|:| +|addedByTenantId|String|Tenant ID of the tenant that added the tenant to the multitenant organization. Read-only.| +|addedDateTime|DateTimeOffset|Date and time when the tenant was added to the multitenant organization. Read-only.| +|displayName|String|Display name of the tenant added to the multitenant organization.| +|joinedDateTime|DateTimeOffset|Date and time when the tenant joined the multitenant organization. Read-only.| +|role|multiTenantOrganizationMemberRole|Role of the tenant in the multitenant organization. The possible values are: `owner`, `member` (default), `unknownFutureValue`. Tenants with the owner role can manage the multitenant organization but tenants with the member role can only participate in a multitenant organization. There can be multiple tenants with the owner role in a multitenant organization. | +|state|multiTenantOrganizationMemberState|State of the tenant in the multitenant organization. The possible values are: `pending`, `active`, `removed`, `unknownFutureValue`. Tenants in the pending state must [join the multitenant organization](../api/multitenantorganizationjoinrequestrecord-update.md) to participate in the multitenant organization. Tenants in the active state can participate in the multitenant organization. Tenants in the removed state are in the process of being removed from the multitenant organization. Read-only.| +|tenantId|String|Tenant ID of the Microsoft Entra tenant added to the multitenant organization. Set at the time tenant is added.<br><br>Supports `$filter`. Key.| +|transitionDetails|[multiTenantOrganizationMemberTransitionDetails](../resources/multitenantorganizationmembertransitiondetails.md)|Details of the processing status for a tenant in a multitenant organization. Read-only. Nullable.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "tenantId", + "@odata.type": "microsoft.graph.multiTenantOrganizationMember", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.multiTenantOrganizationMember", + "tenantId": "String (identifier)", + "displayName": "String", + "addedDateTime": "String (timestamp)", + "joinedDateTime": "String (timestamp)", + "addedByTenantId": "String", + "role": "String", + "state": "String", + "transitionDetails": { + "@odata.type": "microsoft.graph.multiTenantOrganizationMemberTransitionDetails" + } +} +``` |
v1.0 | Multitenantorganizationmembertransitiondetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/multitenantorganizationmembertransitiondetails.md | + + Title: "multiTenantOrganizationMemberTransitionDetails resource type" +description: "Details of the processing status for a tenant in a multitenant organization." ++ms.localizationpriority: medium ++++# multiTenantOrganizationMemberTransitionDetails resource type ++Namespace: microsoft.graph ++Details of the processing status for a tenant in a multitenant organization. ++## Properties +|Property|Type|Description| +|:|:|:| +|desiredRole|multiTenantOrganizationMemberRole|Role of the tenant in the multitenant organization. The possible values are: `owner`, `member`, `unknownFutureValue`.| +|desiredState|multiTenantOrganizationMemberState|State of the tenant in the multitenant organization currently being processed. The possible values are: `pending`, `active`, `removed`, `unknownFutureValue`. Read-only.| +|details|String|Details that explain the processing status if any. Read-only.| +|status|multiTenantOrganizationMemberProcessingStatus|Processing state of the asynchronous job. The possible values are: `notStarted`, `running`, `succeeded`, `failed`, `unknownFutureValue`. Read-only.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.multiTenantOrganizationMemberTransitionDetails" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.multiTenantOrganizationMemberTransitionDetails", + "desiredState": "String", + "desiredRole": "String", + "status": "String", + "details": "String" +} +``` + |
v1.0 | Multitenantorganizationpartnerconfigurationtemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/multitenantorganizationpartnerconfigurationtemplate.md | + + Title: "multiTenantOrganizationPartnerConfigurationTemplate resource type" +description: "Defines an optional cross-tenant access policy template with inbound and outbound partner configuration settings for multitenant organization tenants." ++ms.localizationpriority: medium ++++# multiTenantOrganizationPartnerConfigurationTemplate resource type ++Namespace: microsoft.graph ++Defines an optional cross-tenant access policy template with inbound and outbound partner configuration settings for multitenant organization tenants. Each tenant has its own template. For more information, see [crossTenantAccessPolicyConfigurationPartner resource type](../resources/crosstenantaccesspolicyconfigurationpartner.md). ++* If your tenant is joining a multitenant organization, the template is applicable to the partner configuration settings for all multitenant organization tenants. +* If another tenant joins your multitenant organization, the template is applicable only to the partner configuration settings of the newly joined multitenant organization tenant. ++Whether the template is applied to the partner configuration settings of relevant tenants is configurable with the `templateApplicationLevel` property. ++* If the template is configured to apply, it's only applied to partner configuration properties where the corresponding template property has a non-null value. ++In its default and unconfigured state, where all template properties (other than `templateApplicationLevel`) are null, the template has no effect on partner configuration settings. ++## Methods +|Method|Return type|Description| +|:|:|:| +|[Get multiTenantOrganizationPartnerConfigurationTemplate](../api/multitenantorganizationpartnerconfigurationtemplate-get.md)|[multiTenantOrganizationPartnerConfigurationTemplate](../resources/multitenantorganizationpartnerconfigurationtemplate.md)|Get the inbound and outbound partner configuration settings of the template.| +|[Update multiTenantOrganizationPartnerConfigurationTemplate](../api/multitenantorganizationpartnerconfigurationtemplate-update.md)|[multiTenantOrganizationPartnerConfigurationTemplate](../resources/multitenantorganizationpartnerconfigurationtemplate.md)|Update the inbound and outbound partner configuration settings of the template.| +|[resetToDefaultSettings](../api/multitenantorganizationpartnerconfigurationtemplate-resettodefaultsettings.md)|None|Reset the inbound and outbound partner configuration settings of the template to the default values.| ++## Properties +|Property|Type|Description| +|:|:|:| +|id|String|ID of the template. Key.| +|automaticUserConsentSettings|[inboundOutboundPolicyConfiguration](../resources/inboundoutboundpolicyconfiguration.md)|Determines the partner-specific configuration for automatic user consent settings. Unless configured, the **inboundAllowed** and **outboundAllowed** properties are `null` and inherit from the default settings, which is always `false`.| +|b2bCollaborationInbound|[crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md)|Defines your partner-specific configuration for users from other organizations accessing your resources via Microsoft Entra B2B collaboration.| +|b2bCollaborationOutbound|[crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md)|Defines your partner-specific configuration for users in your organization going outbound to access resources in another organization via Microsoft Entra B2B collaboration.| +|b2bDirectConnectInbound|[crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md)|Defines your partner-specific configuration for users from other organizations accessing your resources via Azure B2B direct connect.| +|b2bDirectConnectOutbound|[crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md)|Defines your partner-specific configuration for users in your organization going outbound to access resources in another organization via Microsoft Entra B2B direct connect.| +|inboundTrust|[crossTenantAccessPolicyInboundTrust](../resources/crosstenantaccesspolicyinboundtrust.md)|Determines the partner-specific configuration for trusting other Conditional Access claims from external Microsoft Entra organizations.| +|templateApplicationLevel|templateApplicationLevel|Specifies whether the template will be applied to partner configuration settings of certain tenants. The possible values are: `none`, `newPartners`, `existingPartners`, `unknownFutureValue`. You can also specify multiple values like `newPartners,existingPartners` (default). `none` indicates the template isn't applied to any new or existing partner tenants. `newPartners` indicates the template is applied to new partner tenants. `existingPartners` indicates the template is applied to existing partner tenants, those who already had partner-specific partner configurations in place.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.multiTenantOrganizationPartnerConfigurationTemplate", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.multiTenantOrganizationPartnerConfigurationTemplate", + "inboundTrust": { + "@odata.type": "microsoft.graph.crossTenantAccessPolicyInboundTrust" + }, + "b2bCollaborationOutbound": { + "@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting" + }, + "b2bCollaborationInbound": { + "@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting" + }, + "b2bDirectConnectOutbound": { + "@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting" + }, + "b2bDirectConnectInbound": { + "@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting" + }, + "automaticUserConsentSettings": { + "@odata.type": "microsoft.graph.inboundOutboundPolicyConfiguration" + }, + "templateApplicationLevel": "String" +} +``` |
v1.0 | Multivaluelegacyextendedproperty | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/multivaluelegacyextendedproperty.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Nameditem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/nameditem.md | Represents a defined name for a range of cells or value. Names can be primitive ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Notebook | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/notebook.md | A OneNote notebook. ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Notebooklinks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/notebooklinks.md | Links for opening a OneNote notebook. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Objectidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/objectidentity.md | Title: "objectIdentity resource type" description: "Represents an identity used to sign in to a user account." ms.localizationpriority: medium doc_type: resourcePageType+ |
v1.0 | Officegraphinsights | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/officegraphinsights.md | Each insight is returned with a **resourceVisualization** and **resourceReferenc ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty":"id", |
v1.0 | Onenote | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/onenote.md | For information about the permissions required to work with OneNote APIs, see [N ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", "baseType": "microsoft.graph.entity", |
v1.0 | Onenotebasemodel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/onenotebasemodel.md | This is the base type for OneNote entities. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Onenoteentityhierarchymodel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/onenoteentityhierarchymodel.md | A base type for OneNote entities. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Onenoteentityschemaobjectmodel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/onenoteentityschemaobjectmodel.md | This is a base type for OneNote entities. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Onenoteoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/onenoteoperation.md | The status of certain long-running OneNote operations. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Onenoteoperationerror | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/onenoteoperationerror.md | An error from a failed OneNote operation. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Onlinemeetinginfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/onlinemeetinginfo.md | Details for an attendee to join the meeting online. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Onpremisesdirectorysynchronization | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/onpremisesdirectorysynchronization.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Onpremisesextensionattributes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/onpremisesextensionattributes.md | description: "The **onPremisesExtensionAttributes** property of the user entity ms.localizationpriority: medium + doc_type: resourcePageType The **extensionAttributes** property of the [device](device.md) entity is manage ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Onpremisesprovisioningerror | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/onpremisesprovisioningerror.md | Represents directory synchronization errors for the [user](user.md), [group](gro |value|String| Value of the property causing the error. | ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Ontokenissuancestartcustomextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/ontokenissuancestartcustomextension.md | + + Title: "onTokenIssuanceStartCustomExtension resource type" +description: "Custom extension to invoke when handling the event when a token is about to be issued to your application." ++ms.localizationpriority: medium ++++# onTokenIssuanceStartCustomExtension resource type ++Namespace: microsoft.graph ++Custom extension to invoke when handling the event when a token is about to be issued to your application. ++Inherits from [customAuthenticationExtension](../resources/customauthenticationextension.md). +++## Properties +|Property|Type|Description| +|:|:|:| +|authenticationConfiguration|[customExtensionAuthenticationConfiguration](../resources/customextensionauthenticationconfiguration.md)|The authentication configuration for this custom authentication extension. Inherited from [customCalloutExtension](../resources/customcalloutextension.md).| +|claimsForTokenConfiguration|[onTokenIssuanceStartReturnClaim](../resources/ontokenissuancestartreturnclaim.md) collection|Collection of claims to be returned by the API called by this custom authentication extension. Used to populate claims mapping experience in Microsoft Entra admin center. Optional. | +|clientConfiguration|[customExtensionClientConfiguration](../resources/customextensionclientconfiguration.md)|The connection settings for the custom authentication extension. Inherited from [customCalloutExtension](../resources/customcalloutextension.md).| +|description|String|Description for the custom authentication extension. Inherited from [customCalloutExtension](../resources/customcalloutextension.md).| +|displayName|String|Display name for the custom authentication extension. Inherited from [customCalloutExtension](../resources/customcalloutextension.md).| +|endpointConfiguration|[customExtensionEndpointConfiguration](../resources/customextensionendpointconfiguration.md)|Configuration for the API endpoint that the custom authentication extension will call. Inherited from [customCalloutExtension](../resources/customcalloutextension.md).| +|id|String|Identifier for onTokenIssuanceStartCustomExtension. Inherited from [entity](../resources/entity.md).| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.onTokenIssuanceStartCustomExtension", + "baseType": "microsoft.graph.customAuthenticationExtension", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.onTokenIssuanceStartCustomExtension", + "id": "String (identifier)", + "authenticationConfiguration": { + "@odata.type": "microsoft.graph.customExtensionAuthenticationConfiguration" + }, + "clientConfiguration": { + "@odata.type": "microsoft.graph.customExtensionClientConfiguration" + }, + "description": "String", + "displayName": "String", + "endpointConfiguration": { + "@odata.type": "microsoft.graph.customExtensionEndpointConfiguration" + }, + "claimsForTokenConfiguration": [ + { + "@odata.type": "microsoft.graph.onTokenIssuanceStartReturnClaim" + } + ] +} +``` + |
v1.0 | Ontokenissuancestartcustomextensionhandler | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/ontokenissuancestartcustomextensionhandler.md | + + Title: "onTokenIssuanceStartCustomExtensionHandler resource type" +description: "Custom extension handler for the event when a token is about to be issued to your application." ++ms.localizationpriority: medium ++++# onTokenIssuanceStartCustomExtensionHandler resource type ++Namespace: microsoft.graph ++Custom extension handler for the event when a token is about to be issued to your application. ++Inherits from [onTokenIssuanceStartHandler](../resources/ontokenissuancestarthandler.md). ++## Properties +None. ++## Relationships +|Relationship|Type|Description| +|:|:|:| +|customExtension|[onTokenIssuanceStartCustomExtension](../resources/ontokenissuancestartcustomextension.md)|The custom extension to invoke to handle the event when a token is about to be issued to your application. This object is autoexpanded.| +|configuration|[customExtensionOverwriteConfiguration](../resources/customExtensionOverwriteConfiguration.md)|Configuration regarding properties of the custom extension which can be overwritten per event listener. If no values are provided, the properties on the custom extension are used.| ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.onTokenIssuanceStartCustomExtensionHandler" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.onTokenIssuanceStartCustomExtensionHandler", + "customExtension": { + "@odata.type": "#microsoft.graph.onTokenIssuanceStartCustomExtension", + }, + "configuration": { + "@odata.type": "#microsoft.graph.customExtensionOverwriteConfiguration", + }, +} +``` + |
v1.0 | Ontokenissuancestarthandler | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/ontokenissuancestarthandler.md | + + Title: "onTokenIssuanceStartHandler resource type" +description: "Handler for the event when a token is about to be issued to your application." ++ms.localizationpriority: medium ++++# onTokenIssuanceStartHandler resource type ++Namespace: microsoft.graph ++Handler for the event when a token is about to be issued to your application. +This is an abstract type from which the [onTokenIssuanceStartCustomExtensionHandler](../resources/ontokenissuancestartcustomextensionhandler.md) resource type is derived. ++## Properties ++None. ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.onTokenIssuanceStartHandler" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.onTokenIssuanceStartHandler" +} +``` + |
v1.0 | Ontokenissuancestartlistener | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/ontokenissuancestartlistener.md | + + Title: "onTokenIssuanceStartListener resource type" +description: "A listener for when a token is about to be issued to your application." ++ms.localizationpriority: medium ++++# onTokenIssuanceStartListener resource type ++Namespace: microsoft.graph ++A listener for when a token is about to be issued to your application. ++Inherits from [authenticationEventListener](../resources/authenticationeventlistener.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|conditions|[authenticationConditions](../resources/authenticationconditions.md)|The conditions on which onTokenIssuanceStartListener should trigger. Inherited from [authenticationEventListener](../resources/authenticationeventlistener.md).| +|handler|[onTokenIssuanceStartHandler](../resources/ontokenissuancestarthandler.md)|The handler to invoke when conditions are met for this onTokenIssuanceStartListener.| +|id|String|Identifier for the onTokenIssuanceStartListener. Inherited from [entity](../resources/entity.md).| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.onTokenIssuanceStartListener", + "baseType": "microsoft.graph.authenticationEventListener", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.onTokenIssuanceStartListener", + "id": "String (identifier)", + "conditions": { + "@odata.type": "microsoft.graph.authenticationConditions" + }, + "handler": { + "@odata.type": "microsoft.graph.onTokenIssuanceStartHandler" + } +} +``` + |
v1.0 | Ontokenissuancestartreturnclaim | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/ontokenissuancestartreturnclaim.md | + + Title: "onTokenIssuanceStartReturnClaim resource type" +description: "A claim returned by an API that is to be added to a token after the event when a token is about to be issued to your application." ++ms.localizationpriority: medium ++++# onTokenIssuanceStartReturnClaim resource type ++Namespace: microsoft.graph ++A claim returned by an API that is to be added to a token after the event when a token is about to be issued to your application. ++## Properties +|Property|Type|Description| +|:|:|:| +|claimIdInApiResponse|String|The identifier of the claim returned by an API that is to be add to a token being issued.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.onTokenIssuanceStartReturnClaim" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.onTokenIssuanceStartReturnClaim", + "claimIdInApiResponse": "String" +} +``` + |
v1.0 | Opentypeextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/opentypeextension.md | Title: "openTypeExtension resource type (open extensions)" description: "Open extensions (formerly known as Office 365 data extensions) provide an easy way to directly add untyped properties to a resource in Microsoft Graph." ms.localizationpriority: high + doc_type: resourcePageType Namespace: microsoft.graph Represents open extensions (also known as open type extensions, and formerly known as Office 365 data extensions), an [extensibility option](/graph/extensibility-overview) that provides an easy way to directly add untyped properties to a resource in Microsoft Graph. -Any open extension added to a resource shows up in the **extensions** navigation property. Each extension has an **extensionName** property that is the only pre-defined, writable property for all extensions, along with your custom data. One way to help make sure extension names are unique is to use a reverse domain name system (DNS) format that is dependent on _your own domain_, for example, `com.contoso.ContactInfo`. **Don't use** the Microsoft domain (`com.microsoft` or `com.onmicrosoft`) in an extension name. +Any open extension added to a resource shows up in the **extensions** navigation property. Each extension has an **extensionName** property that is the only predefined, writable property for all extensions, along with your custom data. One way to help make sure extension names are unique is to use a reverse domain name system (DNS) format that is dependent on _your own domain_, for example, `com.contoso.ContactInfo`. **Don't use** the Microsoft domain (`com.microsoft` or `com.onmicrosoft`) in an extension name. Derives from the [extension](extension.md) abstract type. -Open extensions are supported by the following resources. +The following resources support open extension: + [user](/graph/api/resources/user) + [group](/graph/api/resources/group) For more information about Microsoft Graph extensibility including limits for op ### Outlook-specific considerations -Each open extension present on an Outlook resource (event, message, or personal contact) is stored in a [MAPI named property](/office/client-developer/outlook/mapi/mapi-named-properties). When you create open extensions for Outlook, consider that MAPI named properties are a finite resource in a user's mailbox. When a user's named property quota is exhausted, you can't create anymore named properties for that user. This can result in unexpected behavior from clients that rely on named properties to function. +Each open extension on an Outlook resource (event, message, or personal contact) is stored in a [MAPI named property](/office/client-developer/outlook/mapi/mapi-named-properties). When you create open extensions for Outlook, consider that MAPI named properties are a finite resource in a user's mailbox. When a user's named property quota is exhausted, you can't create anymore named properties for that user. This can result in unexpected behavior from clients that rely on named properties to function. Apply the following guidelines when you create open extensions on Outlook resources: -- Create the minimum number of extensions required. Most applications should require no more than one extension. Extensions have no set defined properties or structure, so you can store multiple values in a single extension.+- Create the minimum number of extensions required. Most applications should require no more than one extension. Extensions have no defined properties or structure, so you can store multiple values in a single extension. - Avoid naming extensions in a variable manner (such as based on user input, etc.). Each time an open extension is created with a new name that hasn't been used in a user's mailbox before, a new MAPI named property is created. Removing the extension doesn't remove the named property. ### Use open extensions (for Outlook resources) or extended properties exposes at https://graph.microsoft.com/v1.0/$metadata. | Method | Return Type | Description | |:|:--|:-|-|[Create](../api/opentypeextension-post-opentypeextension.md) | [openTypeExtension](../resources/opentypeextension.md)(in an existing resource instance), or a new [todoTask](todotask.md), [todotasklist](todotasklist.md)[contact](contact.md), [event](event.md), [message](message.md), [post](post.md), [todoTask](todotask.md), or [todoTaskList](todotasklist.md) that contains an openTypeExtension object. | Create an openTypeExtension object in an existing or new resource instance.| +|[Create](../api/opentypeextension-post-opentypeextension.md) | [openTypeExtension](../resources/opentypeextension.md)(in an existing resource instance), or a new [todoTask](todotask.md), [todoTaskList](todotasklist.md)[contact](contact.md), [event](event.md), [message](message.md), [post](post.md), [todoTask](todotask.md), or [todoTaskList](todotasklist.md) that contains an openTypeExtension object. | Create an openTypeExtension object in an existing or new resource instance.| |[Get](../api/opentypeextension-get.md) | [openTypeExtension](opentypeextension.md) |Read properties and relationships of openTypeExtension object.| |[Update](../api/opentypeextension-update.md) | [openTypeExtension](opentypeextension.md) |Update openTypeExtension object. | |[Delete](../api/opentypeextension-delete.md) | None |Delete openTypeExtension object. | exposes at https://graph.microsoft.com/v1.0/$metadata. | Property | Type | Description | |:|:--|:-| |extensionName|String|A unique text identifier for an open type data extension. Optional.|-|id|String| A fully qualified identifier that concatenates the extension type with the **extensionName**. Read-only. <br/><br/> The **id** must be defined during the Create operation via one of the following ways: <ul><li> Explicitly define the **id** property in the request body. <li> Define an **extensionName** property in the request body, and Microsoft Graph automatically assigns the same value to the **id** property. <ul><li> In subsequent updates, you can change the **extensionName** property value to one that's different from the **id** value. <li>In subsequent updates, specifying only the **id** property in the request body automatically deletes the **extensionName** property from the open extension.</ul></ul>| +|id|String| A fully qualified identifier that concatenates the extension type with the **extensionName**. Read-only. <br/><br/> The **id** must be defined during the *Create* operation via one of the following ways: <ul><li> Explicitly define the **id** property in the request body. <li> Define an **extensionName** property in the request body, and Microsoft Graph automatically assigns the same value to the **id** property. <ul><li> In subsequent updates, you can change the **extensionName** property value to one that's different from the **id** value. <li>In subsequent updates, specifying only the **id** property in the request body automatically deletes the **extensionName** property from the open extension.</ul></ul>| ## Relationships None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Operation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/operation.md | The status of a long-running operation. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Optionalclaims | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/optionalclaims.md | Application developers can configure optional claims in their Microsoft Entra ap |saml2Token|[optionalClaim](optionalclaim.md) collection| The optional claims returned in the SAML token.| ## JSON Representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", "@odata.type": "microsoft.graph.optionalClaims" |
v1.0 | Orgcontact | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/orgcontact.md | This resource supports using [delta query](/graph/delta-query-overview) to track ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Outlookgeocoordinates | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/outlookgeocoordinates.md | The geographic coordinates, elevation, and their degree of accuracy for a physic ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Outlookitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/outlookitem.md | Title: "outlookItem resource type" -description: "Here's a JSON representation of the resource" +description: "The following JSON representation shows the resource type." ms.localizationpriority: medium Namespace: microsoft.graph ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Page | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/page.md | A page in a OneNote notebook. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Pagelinks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/pagelinks.md | Links for opening a OneNote page. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Parentalcontrolsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/parentalcontrolsettings.md | Specifies parental control settings for an application. These settings control t |legalAgeGroupRule| String | Specifies the legal age group rule that applies to users of the app. Can be set to one of the following values: <table><tr><th>Value</th><th>Description</th></tr><tr><td>Allow</td><td>Default. Enforces the legal minimum. This means parental consent is required for minors in the European Union and Korea.</td></tr><tr><td>RequireConsentForPrivacyServices</td><td>Enforces the user to specify date of birth to comply with COPPA rules. </td></tr><tr><td>RequireConsentForMinors</td><td>Requires parental consent for ages below 18, regardless of country minor rules.</td></tr><tr><td>RequireConsentForKids</td><td>Requires parental consent for ages below 14, regardless of country minor rules.</td></tr><tr><td>BlockMinors</td><td>Blocks minors from using the app.</td></tr></table> | ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Participantinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/participantinfo.md | Contains additional properties about the participant identity ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Passwordprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/passwordprofile.md | description: "Contains the password profile associated with a user. The **passwo ms.localizationpriority: high + doc_type: resourcePageType |
v1.0 | Patchcontentcommand | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/patchcontentcommand.md | The changes to make to a OneNote page in a PATCH request. ## JSON representation -Here is a JSON representation of the resource, which is sent in the body of the [PATCH pages/{id}`](../api/page-update.md) request. +The following JSON representation shows the resource type., which is sent in the body of the [PATCH pages/{id}`](../api/page-update.md) request. <!-- { "blockType": "resource", |
v1.0 | Patternedrecurrence | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/patternedrecurrence.md | The recurrence pattern and range. This shared object is used to define the recur ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Permission | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/permission.md | OneDrive for Business and SharePoint document libraries don't return the **inher ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Permissiongrantpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/permissiongrantpolicy.md | A permission grant policy is used to specify the conditions under which consent A permission grant policy consists of a list of **includes** condition sets, and a list of **excludes** condition sets. For an event to match a permission grant policy, it must match *at least one* of the **includes** conditions sets, and *none* of the **excludes** condition sets. +For more information, see [Manage app consent policies](/entra/identity/enterprise-apps/manage-app-consent-policies). + ## Methods | Method | Return Type | Description | A permission grant policy consists of a list of **includes** condition sets, and |[Get permission grant policy](../api/permissiongrantpolicy-get.md) | [permissionGrantPolicy](permissiongrantpolicy.md) |Read properties and relationships of permissionGrantPolicy object.| |[Update permission grant policy](../api/permissiongrantpolicy-update.md) | [permissionGrantPolicy](permissiongrantpolicy.md) |Update permissionGrantPolicy object. | |**Include condition sets**| | |-|[List include condition sets](../api/permissiongrantpolicy-list-includes.md) |[permissionGrantConditionSet](permissiongrantconditionset.md) collection| Get the condition sets which are *included* in this permission grant policy.| -|[Add include condition set](../api/permissiongrantpolicy-post-includes.md) |[permissionGrantConditionSet](permissiongrantconditionset.md) | Add a condition set which is *included* from this permission grant policy. | -|[Remove include condition set](../api/permissiongrantpolicy-delete-includes.md) | None | Remove a condition set which is *excluded* from this permission grant policy.| +|[List include condition sets](../api/permissiongrantpolicy-list-includes.md) |[permissionGrantConditionSet](permissiongrantconditionset.md) collection| Get the condition sets that are *included* in this permission grant policy.| +|[Add include condition set](../api/permissiongrantpolicy-post-includes.md) |[permissionGrantConditionSet](permissiongrantconditionset.md) | Add a condition set that is *included* from this permission grant policy. | +|[Remove include condition set](../api/permissiongrantpolicy-delete-includes.md) | None | Remove a condition set that is *excluded* from this permission grant policy.| |**Exclude condition sets**| | |-|[List exclude condition sets](../api/permissiongrantpolicy-list-excludes.md) |[permissionGrantConditionSet](permissiongrantconditionset.md) collection| Get the condition sets which are *excluded* in this permission grant policy.| -|[Add exclude condition set](../api/permissiongrantpolicy-post-excludes.md) |[permissionGrantConditionSet](permissiongrantconditionset.md) | Add a condition set which is *excluded* from this permission grant policy. | -|[Remove exclude condition set](../api/permissiongrantpolicy-delete-excludes.md) | None | Remove a condition set which is *excluded* from this permission grant policy.| +|[List exclude condition sets](../api/permissiongrantpolicy-list-excludes.md) |[permissionGrantConditionSet](permissiongrantconditionset.md) collection| Get the condition sets that are *excluded* in this permission grant policy.| +|[Add exclude condition set](../api/permissiongrantpolicy-post-excludes.md) |[permissionGrantConditionSet](permissiongrantconditionset.md) | Add a condition set that is *excluded* from this permission grant policy. | +|[Remove exclude condition set](../api/permissiongrantpolicy-delete-excludes.md) | None | Remove a condition set that is *excluded* from this permission grant policy.| ## Properties A permission grant policy consists of a list of **includes** condition sets, and |:|:--|:-| | displayName | String |The display name for the permission grant policy.| | description |String| The description for the permission grant policy.|-| excludes |[permissionGrantConditionSet](permissiongrantconditionset.md) collection| Condition sets which are *excluded* in this permission grant policy. Automatically expanded on `GET`.| +| excludes |[permissionGrantConditionSet](permissiongrantconditionset.md) collection| Condition sets that are *excluded* in this permission grant policy. Automatically expanded on `GET`.| | id | String | The unique identifier for the permission grant policy. The **id** prefix `microsoft-` is reserved for built-in permission grant policies, and may not be used in a custom permission grant policy. Only letters, numbers, hyphens (`-`) and underscores (`_`) are allowed. Key. Not nullable. Required on create. Immutable. |-| includes | [permissionGrantConditionSet](permissiongrantconditionset.md) collection| Condition sets which are *included* in this permission grant policy. Automatically expanded on `GET`.| +| includes | [permissionGrantConditionSet](permissiongrantconditionset.md) collection| Condition sets that are *included* in this permission grant policy. Automatically expanded on `GET`.| ## Relationships | Relationship | Type |Description| |:|:--|:-|-|excludes|[permissionGrantConditionSet](permissiongrantconditionset.md) collection| Condition sets which are *excluded* in this permission grant policy. This navigation is automatically expanded on GET. | -|includes|[permissionGrantConditionSet](permissiongrantconditionset.md) collection| Condition sets which are *included* in this permission grant policy. This navigation is automatically expanded on GET. | +|excludes|[permissionGrantConditionSet](permissiongrantconditionset.md) collection| Condition sets that are *excluded* in this permission grant policy. This navigation is automatically expanded on GET. | +|includes|[permissionGrantConditionSet](permissiongrantconditionset.md) collection| Condition sets that are *included* in this permission grant policy. This navigation is automatically expanded on GET. | ## JSON representation +The following JSON representation shows the resource type. + <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Permissionscope | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/permissionscope.md | Delegated permissions can be requested by client applications needing an access ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Phone | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/phone.md | Represents a phone number. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Phoneauthenticationmethod | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/phoneauthenticationmethod.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Physicaladdress | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/physicaladdress.md | Represents the street address of a resource such as a contact or event. ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Physicalofficeaddress | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/physicalofficeaddress.md | Represents the business address of a resource such as an organizational contact. ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Pkcs12certificate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/pkcs12certificate.md | Inherits from [apiAuthenticationConfigurationBase](../resources/apiauthenticatio ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.pkcs12Certificate" |
v1.0 | Pkcs12certificateinformation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/pkcs12certificateinformation.md | Represents the public information of a Pkcs12 certificate. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.pkcs12CertificateInformation" |
v1.0 | Planner | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/planner.md | The **planner** resource is the entry point for the Planner object model. It ret |tasks|[plannerTask](plannertask.md) collection| Read-only. Nullable. Returns a collection of the specified tasks| ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannerappliedcategories | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/plannerappliedcategories.md | Properties of an Open Type can be defined by the client. In this case though, th ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannerassignedtotaskboardtaskformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/plannerassignedtotaskboardtaskformat.md | Represents the information used to render a task correctly in the **AssignedTo** None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Plannerassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/plannerassignment.md | The **plannerAssignment** resource represents the assignment of a task to a user |orderHint|String|Hint used to order assignees in a task. The format is defined as outlined [here](planner-order-hint-format.md).| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannerbucket | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/plannerbucket.md | Represents a bucket (or "custom column") for tasks in a plan in Microsoft 365. I |tasks|[plannerTask](plannertask.md) collection| Read-only. Nullable. The collection of tasks in the bucket.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannerbuckettaskboardtaskformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/plannerbuckettaskboardtaskformat.md | None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Plannerchecklistitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/plannerchecklistitem.md | The **plannerChecklistItem** resource represents an item in the checklist of a t |title|String|Title of the checklist item| ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannerchecklistitems | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/plannerchecklistitems.md | Properties of an Open Type can be defined by the client. In this case, the clien ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannerexternalreference | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/plannerexternalreference.md | The **plannerExternalReference** resource represents the metadata of a reference |type|String|Used to describe the type of the reference. Types include: `PowerPoint`, `Word`, `Excel`, `Other`.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannerexternalreferences | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/plannerexternalreferences.md | Properties of an Open Type can be defined by the client. In this case, the clien ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannergroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/plannergroup.md | The **plannerGroup** resource provides access to Planner resources for a [group] |plans|[plannerPlan](plannerplan.md) collection| Read-only. Nullable. Returns the [plannerPlans](plannerplan.md) owned by the group.| ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannerplan | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/plannerplan.md | Represents a plan in Microsoft 365. A plan can be owned by a [group](group.md) a ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannerplandetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/plannerplandetails.md | Represents the additional information about a plan. Each [plan](plannerplan.md) None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Plannerprogresstaskboardtaskformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/plannerprogresstaskboardtaskformat.md | None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Plannertask | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/plannertask.md | Represents a Planner task in Microsoft 365. A Planner task is contained in a [pl |progressTaskBoardFormat|[plannerProgressTaskBoardTaskFormat](plannerprogresstaskboardtaskformat.md)| Read-only. Nullable. Used to render the task correctly in the task board view when grouped by progress.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Plannertaskdetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/plannertaskdetails.md | None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Planneruser | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/planneruser.md | Provides access to Planner resources for a [user](user.md). It doesn't contain a |tasks|[plannerTask](plannertask.md) collection| Read-only. Nullable. Returns the [plannerPlans](plannerplan.md) shared with the user.| ## JSON representation-The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Planneruserids | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/planneruserids.md | The client defines the properties of an Open Type, and the client should provide ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Playpromptoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/playpromptoperation.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Policyroot | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/policyroot.md | Title: "policyRoot resource type" description: "Resource type exposing navigation properties for the policies singleton."-+ ms.localizationpriority: medium-+ doc_type: resourcePageType None ## JSON representation-The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Policytemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/policytemplate.md | + + Title: "policyTemplate resource type" +description: "Represents the base policy in the directory for multitenant organization settings." ++ms.localizationpriority: medium ++++# policyTemplate resource type ++Namespace: microsoft.graph ++Represents the base policy in the directory for multitenant organization settings. ++Inherits from [entity](../resources/entity.md). ++## Methods ++None. ++## Properties ++|Property|Type|Description| +|:|:|:| +|id|String|ID of the template. Key. Inherited from [entity](../resources/entity.md).| ++## Relationships ++|Relationship|Type|Description| +|:|:|:| +|multiTenantOrganizationIdentitySynchronization|[multiTenantOrganizationIdentitySyncPolicyTemplate](../resources/multitenantorganizationidentitysyncpolicytemplate.md)|Defines an optional cross-tenant access policy template with user synchronization settings for a multitenant organization.| +|multiTenantOrganizationPartnerConfiguration|[multiTenantOrganizationPartnerConfigurationTemplate](../resources/multitenantorganizationpartnerconfigurationtemplate.md)|Defines an optional cross-tenant access policy template with inbound and outbound partner configuration settings for a multitenant organization.| ++## JSON representation ++The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.policyTemplate", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.policyTemplate" +} +``` + |
v1.0 | Post | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/post.md | This resource lets you add your own data to custom properties using [extensions] ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Preauthorizedapplication | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/preauthorizedapplication.md | In some rare cases, an identifier listed in the `delegatedPermissionIds` propert |delegatedPermissionIds|String collection| The unique identifier for the [oauth2PermissionScopes](permissionscope.md) the application requires. | ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Presence | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/presence.md | Contains information about a user's presence, including their availability and u > **Note:** This resource is currently only supported for Microsoft Teams users. -This resource supports subscribing to [change notifications](/graph/webhooks). +This resource supports subscribing to [change notifications](/graph/changenotifications-for-presence). ## Methods None. ## JSON representation -The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Principalresourcemembershipsscope | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/principalresourcemembershipsscope.md | You must also specify the **@odata.type** type property with the value `#microso None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.principalResourceMembershipsScope" |
v1.0 | Printerbase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/printerbase.md | Represents a base type for [printer](printer.md) and [printerShare](printerShare |jobs|[printJob](printjob.md) collection|The list of jobs that are queued for printing by the printer/printerShare.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Printerstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/printerstatus.md | Represents the processing status of the printer, including any errors. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.printerStatus" |
v1.0 | Printjobstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/printjobstatus.md | Represents the current status of a print job. |interpreting|6|Job is in 'processing' state, but more specifically, document payload is being interpreted.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.printJobStatus" |
v1.0 | Printservice | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/printservice.md | Represents a Microsoft Entra tenant-specific description of a print service inst |endpoints|[printServiceEndpoint](printserviceendpoint.md) collection| Endpoints that can be used to access the service. Read-only. Nullable.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Printtasktrigger | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/printtasktrigger.md | For details about how to use this resource to add pull printing support to Unive |definition|[printTaskDefinition](printtaskdefinition.md)|An abstract definition that is used to create a [printTask](printtask.md) when triggered by a print event. Read-only.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Privacyprofile | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/privacyprofile.md | Title: "privacyProfile resource type" description: "Represents a company's privacy profile, which includes a privacy statement URL and a contact person for questions regarding the privacy statement." ms.localizationpriority: medium-+ doc_type: resourcePageType doc_type: resourcePageType Namespace: microsoft.graph -Represents a company's privacy profile, which includes a privacy statement URL and a contact person for questions regarding the privacy statement. +Represents a [company's](organization.md) privacy profile, which includes a privacy statement URL and a contact person for questions regarding the privacy statement. ## Properties | Property | Type|Description| Represents a company's privacy profile, which includes a privacy statement URL a ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Privilegedidentitymanagementv3 Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/privilegedidentitymanagementv3-overview.md | Privileged Identity Management (PIM) is a feature of [Microsoft Entra ID Governa The PIM for Microsoft Entra roles APIs allow you to govern privileged access and limit excessive access to Microsoft Entra roles. This article introduces the governance capabilities of PIM for Microsoft Entra roles APIs in Microsoft Graph. > [!NOTE]-> To manage Azure resource roles use the [Azure Resource Manager (ARM) APIs for PIM](/rest/api/authorization/privileged-role-eligibility-rest-sample). +> To manage Azure resource roles use the [Azure Resource Manager APIs for PIM](/rest/api/authorization/privileged-role-eligibility-rest-sample). > > PIM APIs for managing security alerts for Microsoft Entra roles are available on the `beta` endpoint only. For more information, see [Security alerts for Microsoft Entra roles](/graph/api/resources/privilegedidentitymanagementv3-overview?view=graph-rest-beta#security-alerts-for-azure-ad-roles&preserve-view=true). For more information about using Microsoft Graph to configure rules, see [Overvi [!INCLUDE [zero-trust](../../../includes/identity-zero-trust.md)] <!-- End of: Link to ZT guidance -->-<!-- -## Permissions and privileges --To call the [Create roleAssignmentScheduleRequests](../api/rbacapplication-post-roleassignmentschedulerequests.md) and [Create roleEligibilityScheduleRequests](../api/rbacapplication-post-roleeligibilityschedulerequests.md) APIs with admin actions, the calling app must: -+ Have a *Global Administrator* or *Privileged Role Administrator* role -+ Be granted one of the following permissions: - + RoleAssignmentSchedule.ReadWrite.Directory - + RoleEligibilitySchedule.ReadWrite.Directory - + RoleManagement.ReadWrite.Directory --The app must also be assigned the appropriate permissions to retrieve their role assignments and eligibilities, or call the [Create roleAssignmentScheduleRequests](../api/rbacapplication-post-roleassignmentschedulerequests.md) and [Create roleEligibilityScheduleRequests](../api/rbacapplication-post-roleeligibilityschedulerequests.md) APIs with user actions. --For more information about permissions to call PIM APIs, see the [Microsoft Graph permissions reference: Role management permissions](/graph/permissions-reference#role-management-permissions). -> ## Licensing |
v1.0 | Profilephoto | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/profilephoto.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Project Rome Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/project-rome-overview.md | doc_type: conceptualPageType [Project Rome](https://developer.microsoft.com/en-us/windows/project-rome) is a Microsoft initiative to build a cross-device experiences platform. Project Rome enables an app on a local client or service to interact with apps and services on a remote host when the user signs in with the same Microsoft account that they use to sign in on the client device. This allows you to program cross-device and cross-platform experiences that are centered around user tasks rather than devices. -A key component is exposed via Microsoft Graph to enable these experiences: activities. +The following key capabilities are exposed via Microsoft Graph to help you enable cross-device experiences. ## Activities You can use the following Microsoft Graph APIs to create and retrieve user activ - [Create or replace a history item](../api/projectrome-put-historyitem.md) - [Delete a history item](../api/projectrome-delete-historyitem.md) +## Roaming data ++Access Windows data stored in the cloud via the cloud clipboard and Windows settings APIs. ++The Cloud Clipboard feature in Windows enables users to copy and paste items such as text, images, and links across their applications and devices. You can use the cloud clipboard APIs in Microsoft Graph to: ++- [List cloud clipboard items for the signed-in user](/graph//api/cloudclipboardroot-list-items) +- [Get a cloud clipboard item for a user](/graph/api/cloudclipboarditem-get) ++The Windows setting API in Microsoft Graph enables users and authorized third parties acting on behalf of users to retrieve their Windows operating system settings data stored in the Microsoft cloud. For details about using the Windows setting API, see [Use the Windows settings API](/graph/api/resources/windows-setting-api-overview). |
v1.0 | Projectrome Activity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/projectrome-activity.md | Your user activities will be showcased in Cortana and Windows Timeline user expe ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Projectrome Imageinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/projectrome-imageinfo.md | A complex type for representing the **attribution** property in the [visualInfo] ## JSON Representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Provisionedidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/provisionedidentity.md | Describes the identity associated with the provisioning object summary event. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Provisionedplan | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/provisionedplan.md | Title: "provisionedPlan resource type" -description: "The **provisionedPlans** property of the user entity and the organization entity is a collection of **provisionedPlan**." +description: "The provisionedPlans property of the user entity and the organization entity is a collection of provisionedPlan objects." ms.localizationpriority: medium-+ doc_type: resourcePageType doc_type: resourcePageType Namespace: microsoft.graph -The **provisionedPlans** property of the [user](user.md) entity and the [organization](organization.md) entity is a collection of **provisionedPlan**. +Used by the **provisionedPlans** property of the [user](user.md) entity and the [organization](organization.md) entity. ## Properties The **provisionedPlans** property of the [user](user.md) entity and the [organiz ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Provisioningerrorinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/provisioningerrorInfo.md | Describes the status of the provisioning event and the associated errors. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Provisioningserviceprincipal | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/provisioningserviceprincipal.md | Represents the service principal used for provisioning. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Provisioningstatusinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/provisioningstatusinfo.md | Describes the status of the provisioning summary event. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Publicclientapplication | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/publicclientapplication.md | Specifies settings for nonweb app or nonweb API (for example, mobile or other pu |redirectUris|String collection| Specifies the URLs where user tokens are sent for sign-in, or the redirect URIs where OAuth 2.0 authorization codes and access tokens are sent. | ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Quota | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/quota.md | The **quota** resource provides details about space constraints on a [drive](dri ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Range | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/range.md | Range represents a set of one or more contiguous cells such as a cell, a row, a ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Rangeborder | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/rangeborder.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Rangefill | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/rangefill.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Rangefont | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/rangefont.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Rangeformat | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/rangeformat.md | A format object encapsulating the range's font, fill, borders, alignment, and ot ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Rangesort | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/rangesort.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { |
v1.0 | Reactionsfacet | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/reactionsfacet.md | + + Title: 'reactionsFacet resource type' +description: Provides counts of user reactions (likes, comments, and shares). ++ms.localizationpriority: medium +++# reactionsFacet resource type ++Namespace: microsoft.graph ++++Provides counts of user reactions (likes, comments, and shares). ++## Properties ++| Property | Type | Description | +| :-- | :- | :-- | +| commentCount | Int32 | Count of comments. | +| likeCount | Int32 | Count of likes. | +| shareCount | Int32 | Count of shares. | ++## Relationships ++None. ++## JSON representation ++The following is a JSON representation of the resource. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.reactionsFacet" +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.reactionsFacet", + "likeCount": "Integer", + "commentCount": "Integer", + "shareCount": "Integer" +} +``` |
v1.0 | Recipient | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/recipient.md | Represents information about a user in the sending or receiving end of an event, ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Recordoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/recordoperation.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Recurrencerange | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/recurrencerange.md | Use the **type** property to specify the different types of **recurrenceRange**. ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Referenceattachment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/referenceattachment.md | None ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Relyingpartydetailedsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/relyingpartydetailedsummary.md | + + Title: "relyingPartyDetailedSummary resource type" +description: "Represents the summary of AD FS relying parties' information on daily, weekly, or monthly frequency." ++ms.localizationpriority: medium ++++# relyingPartyDetailedSummary resource type ++Namespace: microsoft.graph ++Represents the summary of AD FS relying parties' information on daily, weekly, or monthly frequency. +++Inherits from [entity](../resources/entity.md). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List relyingPartyDetailedSummary](../api/reportroot-getrelyingpartydetailedsummary.md)| [relyingPartyDetailedSummary](../resources/relyingpartydetailedsummary.md) collection|Get a summary of AD FS relying parties information.| ++## Properties ++|Property|Type|Description| +|:|:|:| +|failedSignInCount|Int64|Number of failed sign ins on AD FS in the period specified.<br/><br/> Supports `$orderby`, `$filter` (`eq`).| +|id|String|Unique identifier for the report. Inherited from [entity](../resources/entity.md).| +|migrationStatus|migrationStatus|Indicates whether the app can be easily moved to Entra ID. The possible values are: `ready`, `needsReview`, `additionalStepsRequired`, `unknownFutureValue`.<br/><br/> Supports `$orderby`, `$filter` (`eq`).| +|migrationValidationDetails|[keyValuePair](../resources/keyvaluepair.md) collection|Specifies all the validations checks done on applications config details.| +|relyingPartyId|String|Identifies the relying party to this federation service. It's used when issuing claims to the relying party.<br/><br/> Supports `$orderby`, `$filter` (`eq`).| +|relyingPartyName|String|Name of the relying party's website or other entity on the Internet that uses an identity provider to authenticate a user who wants to log in.<br/><br/> Supports `$orderby`, `$filter` (`eq`).| +|replyUrls|String collection|Specifies where the relying party expects to receive the token.| +|serviceId|String|Uniquely identifies the Active Directory forest.<br/><br/> Supports `$orderby`, `$filter` (`eq`).| +|signInSuccessRate|Double|Calculated as `Number of successful / (Number of successful + Number of failed sign ins)` or `successfulSignInCount / totalSignInCount` on AD FS in the period specified.<br/><br/> Supports `$orderby`, `$filter` (`eq`).| +|successfulSignInCount|Int64|Number of successful sign ins on AD FS.<br/><br/> Supports `$orderby`, `$filter` (`eq`).| +|totalSignInCount|Int64|Number of successful + failed sign ins on AD FS in the period specified.<br/><br/> Supports `$orderby`, `$filter` (`eq`).| +|uniqueUserCount|Int64|Number of unique users that signed into the application.<br/><br/> Supports `$orderby`, `$filter` (`eq`).| +++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.relyingPartyDetailedSummary", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.relyingPartyDetailedSummary", + "id": "String (identifier)", + "relyingPartyId": "String", + "serviceId": "String", + "relyingPartyName": "String", + "successfulSignInCount": "Integer", + "failedSignInCount": "Integer", + "totalSignInCount": "Integer", + "signInSuccessRate": "Double", + "uniqueUserCount": "Integer", + "migrationStatus": "String", + "migrationValidationDetails": [ + { + "@odata.type": "microsoft.graph.keyValuePair" + } + ], + "replyUrls": [ + "String" + ] +} +``` + |
v1.0 | Reminder | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/reminder.md | A reminder for an [event](event.md) in a user [calendar](calendar.md). ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Removeaccessapplyaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/removeaccessapplyaction.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.removeAccessApplyAction" |
v1.0 | Reportroot | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/reportroot.md | Represents a container for Microsoft Entra reporting resources. ## Methods -| Method | Return type | Description | -| :- | : | : | -| [List userRegistrationDetails](../api/authenticationmethodsroot-list-userregistrationdetails.md) | [userRegistrationDetails](../resources/userregistrationdetails.md) collection | Get the state of authentication methods of all users in the tenant. | -| [Get userRegistrationDetails](../api/userregistrationdetails-get.md) | [userRegistrationDetails](../resources/userregistrationdetails.md) collection | Get the state of authentication methods of a user in the tenant. | +None. ## Properties |
v1.0 | Requestormanager | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/requestormanager.md | It's a subtype of [subjectSet](subjectset.md), in which the `@odata.type` value ## Relationships None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.requestorManager", |
v1.0 | Requestschedule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/requestschedule.md | In [PIM for Microsoft Entra roles](privilegedidentitymanagementv3-overview.md) a None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.requestSchedule" |
v1.0 | Requiredresourceaccess | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/requiredresourceaccess.md | Specifies the set of OAuth 2.0 permission scopes and app roles under the specifi ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Resourcedata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/resourcedata.md | description: "Represents the resouce data attached to the change notification se ms.localizationpriority: medium doc_type: resourcePageType+ # resourceData resource type |
v1.0 | Resultinfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/resultinfo.md | The subcodes provide supplementary information related to the type of success or ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Riskdetection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/riskdetection.md | Title: "riskDetection resource type" -description: "risk detections" +description: "Represents all risk detections in a Microsoft Entra tenant." ms.localizationpriority: medium For more information about risk detection, see [Microsoft Entra ID Protection](/ |location|[signInLocation](../resources/signinlocation.md)|Location of the sign-in.| |requestId|String|Request ID of the sign-in associated with the risk detection. This property is `null` if the risk detection is not associated with a sign-in.| |riskDetail|riskDetail|Details of the detected risk. The possible values are: `none`, `adminGeneratedTemporaryPassword`, `userPerformedSecuredPasswordChange`, `userPerformedSecuredPasswordReset`, `adminConfirmedSigninSafe`, `aiConfirmedSigninSafe`, `userPassedMFADrivenByRiskBasedPolicy`, `adminDismissedAllRiskForUser`, `adminConfirmedSigninCompromised`, `hidden`, `adminConfirmedUserCompromised`, `unknownFutureValue`, `m365DAdminDismissedDetection`. Note that you must use the `Prefer: include - unknown -enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `m365DAdminDismissedDetection`.|-|riskEventType|String|The type of risk event detected. The possible values are `adminConfirmedUserCompromised`, `anomalousToken`, `anomalousUserActivity`, `anonymizedIPAddress`, `generic`, `impossibleTravel`, `investigationsThreatIntelligence`, `leakedCredentials`, `maliciousIPAddress`,`malwareInfectedIPAddress`, `mcasSuspiciousInboxManipulationRules`, `newCountry`, `passwordSpray`,`riskyIPAddress`, `suspiciousAPITraffic`, `suspiciousBrowser`,`suspiciousInboxForwarding`, `suspiciousIPAddress`, `tokenIssuerAnomaly`, `unfamiliarFeatures`, `unlikelyTravel`. If the risk detection is a premium detection, will show `generic`. <br/>For more information about each value, see [Risk types and detection](/entra/id-protection/concept-identity-protection-risks#risk-types-and-detection).| +|riskEventType|String|The type of risk event detected. The possible values are `adminConfirmedUserCompromised`, `anomalousToken`, `anomalousUserActivity`, `anonymizedIPAddress`, `generic`, `impossibleTravel`, `investigationsThreatIntelligence`, `suspiciousSendingPatterns`, `leakedCredentials`, `maliciousIPAddress`,`malwareInfectedIPAddress`, `mcasSuspiciousInboxManipulationRules`, `newCountry`, `passwordSpray`,`riskyIPAddress`, `suspiciousAPITraffic`, `suspiciousBrowser`,`suspiciousInboxForwarding`, `suspiciousIPAddress`, `tokenIssuerAnomaly`, `unfamiliarFeatures`, `unlikelyTravel`. If the risk detection is a premium detection, will show `generic`. <br/>For more information about each value, see [Risk types and detection](/entra/id-protection/concept-identity-protection-risks#risk-types-and-detection).| |riskLevel|riskLevel|Level of the detected risk. Possible values are: `low`, `medium`, `high`, `hidden`, `none`, `unknownFutureValue`.| |riskState|riskState|The state of a detected risky user or sign-in. Possible values are: `none`, `confirmedSafe`, `remediated`, `dismissed`, `atRisk`, `confirmedCompromised`, `unknownFutureValue`.| |source|String|Source of the risk detection. For example, `activeDirectory`. | |
v1.0 | Rubriclevel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/rubriclevel.md | See [educationRubric](educationrubric.md) for a description of the relationship ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Samlsinglesignonsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/samlsinglesignonsettings.md | Represents a container for settings related to SAML single sign-on. ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Schemaextension | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/schemaextension.md | Title: "schemaExtension resource type (schema extensions)" description: "Schema extensions allow you to define a schema to extend and add strongly-typed custom data to a resource type. The custom data appears as a complex type on the extended resource. " ms.localizationpriority: high + doc_type: resourcePageType The owner app can move the extension through different states of a lifecycle, us ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Scopedrolemembership | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/scopedrolemembership.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Scoredemailaddress | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/scoredemailaddress.md | Represents a scored email address. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Searchalterationoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/searchalterationoptions.md | Provides the search alteration options for spelling correction. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Searchhitscontainer | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/searchhitscontainer.md | Represent the list of search results. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Section | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/section.md | A section in a OneNote notebook. Sections can contain pages. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Sectiongroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/sectiongroup.md | A section group in a OneNote notebook. Section groups can contain sections and s ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Sectionlinks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/sectionlinks.md | Links for opening a OneNote section. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Security Alert | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-alert.md | When a security provider detects a threat, it creates an alert in the system. Mi None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Alertevidence | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-alertevidence.md | This resource is the base type for the following evidence types: None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.security.alertEvidence" |
v1.0 | Security Api Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-api-overview.md | Alerts from the following security providers are available via these rich alerts ### Legacy alerts -These [alert](alert.md) resources federate calling of supported Azure and Microsoft 365 Defender security providers. They aggregate common alert data among the different domains to allow applications to unify and streamline management of security issues across all integrated solutions. They enable applications to correlate alerts and context to improve threat protection and response. +> [!NOTE] +> The legacy alerts API is deprecated and will be removed by April 2026. We recommend that you migrate to the new [alerts and incidents](/graph/api/resources/security-alert) API. ++The legacy [alert](alert.md) resources federate calling of supported Azure and Microsoft 365 Defender security providers. They aggregate common alert data among the different domains to allow applications to unify and streamline management of security issues across all integrated solutions. They enable applications to correlate alerts and context to improve threat protection and response. The legacy version of the security API offers the [alert](alert.md) resource which federates calling of supported Azure and Microsoft 365 Defender security providers. This **alert** resource aggregates alert data thatΓÇÖs common among the different domains to allow applications to unify and streamline management of security issues across all integrated solutions. This enables applications to correlate alerts and context to improve threat protection and response. With the alert update capability, you can sync the status of specific alerts across different security products and services that are integrated with the Microsoft Graph security API by updating your **alert** entity. -Alerts from the following providers are available via this **alert** resource. Support for GET alerts, PATCH alerts, and subscribe (via webhooks) is indicated in the following table. +Alerts from the following providers are available via the **alert** resource. Support for GET alerts, PATCH alerts, and subscribe (via webhooks) is indicated in the following table. | Security provider | <p align="center">GET alert</p>| <p align="center">PATCH alert</p>| <p align="center">Subscribe to alert</p>| |:|:|:--|:| Alerts from the following providers are available via this **alert** resource. S \*\* Microsoft Defender for Endpoint requires additional [user roles](/windows/security/threat-protection/microsoft-defender-atp/user-roles) to those required by the Microsoft Graph security API. Only the users in both Microsoft Defender for Endpoint and Microsoft Graph security API roles can access the Microsoft Defender for Endpoint data. Because application-only authentication is not limited by this, we recommend that you use an application-only authentication token. -\*\*\* Microsoft Defender for Identity alerts are available via the Microsoft Defender for Cloud Apps integration. This means you will get Microsoft Defender for Identity alerts only if you joined Unified SecOps and connected Microsoft Defender for Identity into Microsoft Defender for Cloud Apps. Learn more about [how to integrate Microsoft Defender for Identity and Microsoft Defender for Cloud Apps](/defender-for-identity/mcas-integration). +\*\*\* Microsoft Defender for Identity alerts are available via the Microsoft Defender for Cloud Apps integration. This means you get Microsoft Defender for Identity alerts only if you joined Unified SecOps and connected Microsoft Defender for Identity into Microsoft Defender for Cloud Apps. Learn more about [how to integrate Microsoft Defender for Identity and Microsoft Defender for Cloud Apps](/defender-for-identity/mcas-integration). ## Attack simulation and training TheΓÇ» [incident](security-incident.md) resource and its APIs allow you to sort The Microsoft Graph threat assessment API helps organizations to assess the threat received by any user in a tenant. This empowers customers to report spam emails, phishing URLs or malware attachments they receive to Microsoft. The policy check result and rescan result can help tenant administrators understand the threat scanning verdict and adjust their organizational policy. ++## Records management ++Most organizations need to manage data to proactively comply with industry regulations and internal policies, reduce risk in the event of litigation or a security breach, and let people effectively and agiley share knowledge that is current and relevant to them. You can use the [records management APIs](../resources/security-recordsmanagement-overview.md) to systematically apply [retention labels](security-retentionlabel.md) to different types of content that require different retention settings. For example, you can configure the start of retention period from when the content was created, last modified, labeled or when an event occurs for a particular event type. Further, you can use [file plan descriptors](security-fileplandescriptor.md) to improve the manageability of these retention labels. ++ ## Secure Score [Microsoft Secure Score](https://techcommunity.microsoft.com/t5/Security-Privacy-and-Compliance/A-new-home-and-an-all-new-look-for-Microsoft-Secure-Score/ba-p/529641) is a security analytics solution that gives you visibility into your security portfolio and how to improve it. With a single score, you can better understand what you did to reduce your risk in Microsoft solutions. You can also compare your score with other organizations and see how your score has been trending over time. The Microsoft Graph security [secureScore](securescore.md) and [secureScoreControlProfile](securescorecontrolprofile.md) entities help you balance your organization's security and productivity needs while enabling the appropriate mix of security features. You can also project what your score would be after you adopt security features. The threat intelligence APIs allow you to operationalize intelligence found with ## Common use cases -The following are some of the most popular requests for working with the Microsoft Graph security API: +The following are some of the most popular requests for working with the Microsoft Graph security API. | **Use cases** | **REST resources** | **Try it in Graph Explorer** | |:|:--|:-| |
v1.0 | Security Authoritytemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-authoritytemplate.md | + + Title: "authorityTemplate resource type" +description: "Specifies the underlying authority that describes the type of content to be retained and its retention schedule." ++ms.localizationpriority: medium +++# authorityTemplate resource type ++Namespace: microsoft.graph.security ++Specifies the underlying authority that describes the type of content to be retained and its retention schedule. This resource supports CRUD operations to apply and manage the [filePlanAuthority](security-fileplanauthority.md) descriptor for a [retentionLabel](security-retentionlabel.md). The **authority** file plan descriptor supplements a retention label to improve the manageability and organization of Microsoft 365 content. ++Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List authorities](../api/security-labelsroot-list-authorities.md)|[microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) collection|Get a list of the [microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) objects and their properties.| +|[Create authorities](../api/security-labelsroot-post-authorities.md)|[microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md)|Create a new [microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) object.| +|[Get authorities](../api/security-authoritytemplate-get.md)|[microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md)|Read the properties and relationships of a [microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) object.| +|[Delete authorities](../api/security-labelsroot-delete-authorities.md)|None|Delete a [microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) object.| ++## Properties +|Property|Type|Description| +|:|:|:| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the authority descriptor. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|createdDateTime|DateTimeOffset|Represents the date and time in which the authority descriptor is created. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|displayName|String|Unique string that defines an authority name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md).| +|id|String|Unique ID of the authority. Inherited from [microsoft.graph.entity](../resources/entity.md). Read-only.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.security.authorityTemplate", + "baseType": "microsoft.graph.security.filePlanDescriptor", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.authorityTemplate", + "id": "String (identifier)", + "displayName": "String", + "createdBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "createdDateTime": "String (timestamp)" +} +``` + |
v1.0 | Security Caseoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-caseoperation.md | Inherits from [entity](../resources/entity.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Categorytemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-categorytemplate.md | + + Title: "categoryTemplate resource type" +description: "Specifies a group of similar types of content in a particular department." ++ms.localizationpriority: medium +++# categoryTemplate resource type ++Namespace: microsoft.graph.security ++Specifies a group of similar types of content in a particular department. This resource supports CRUD operations to apply and manage the [filePlanAppliedCategory](security-fileplanappliedcategory.md) descriptor, and any [filePlanSubcategory](security-fileplansubcategory.md) descriptor for a [retentionLabel](security-retentionlabel.md). These file plan descriptors supplement a retention label to improve the manageability and organization of Microsoft 365 content. ++Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List categories](../api/security-labelsroot-list-categories.md)|[microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) collection|Get a list of the [microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) objects and their properties.| +|[Create categories](../api/security-labelsroot-post-categories.md)|[microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md)|Create a new [microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) object.| +|[Get categories](../api/security-categorytemplate-get.md)|[microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md)|Read the properties and relationships of a [microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) object.| +|[Delete categories](../api/security-labelsroot-delete-categories.md)|None|Delete a [microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) object.| +|[List subcategories](../api/security-categorytemplate-list-subcategories.md)|[microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md) collection|Get the subcategoryTemplate resources from the subcategories navigation property.| +|[Create subcategories](../api/security-categorytemplate-post-subcategories.md)|[microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md)|Create a new subcategoryTemplate object.| ++## Properties +|Property|Type|Description| +|:|:|:| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the category descriptor. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|createdDateTime|DateTimeOffset|Represents the date and time in which the category descriptor is created. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|displayName|String|Unique string that defines a category name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md).| +|id|String|Unique ID of the category. Inherited from [microsoft.graph.entity](../resources/entity.md). Read-only.| ++## Relationships +|Relationship|Type|Description| +|:|:|:| +|subcategories|[microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md) collection|Represents all subcategories under a particular category.| ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.security.categoryTemplate", + "baseType": "microsoft.graph.security.filePlanDescriptor", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.categoryTemplate", + "id": "String (identifier)", + "displayName": "String", + "createdBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "createdDateTime": "String (timestamp)" +} +``` + |
v1.0 | Security Citationtemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-citationtemplate.md | + + Title: "citationTemplate resource type" +description: "The specific rule or regulation created by a jurisdiction used to determine whether certain labels and content should be retained or deleted." ++ms.localizationpriority: medium +++# citationTemplate resource type ++Namespace: microsoft.graph.security ++Represents the specific rule or regulation created by a jurisdiction used to determine whether certain labels and content should be retained or deleted. This resource supports CRUD operations to apply and manage the [filePlanCitation](security-fileplancitation.md) descriptor for a [retentionLabel](security-retentionlabel.md). The **citation** file plan descriptor supplements a retention label to improve the manageability and organization of Microsoft 365 content. ++Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List citations](../api/security-labelsroot-list-citations.md)|[microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) collection|Get a list of the [microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) objects and their properties.| +|[Create citations](../api/security-labelsroot-post-citations.md)|[microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md)|Create a new [microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) object.| +|[Get citations](../api/security-citationtemplate-get.md)|[microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md)|Read the properties and relationships of a [microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) object.| +|[Delete citations](../api/security-labelsroot-delete-citations.md)|None|Delete a [microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) object.| ++## Properties +|Property|Type|Description| +|:|:|:| +|citationJurisdiction|String|Represents the jurisdiction or agency that published the citation.| +|citationUrl|String|Represents the URL to the published citation.| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the citation descriptor. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|createdDateTime|DateTimeOffset|Represents the date and time in which the citation descriptor is created. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|displayName|String|Unique string that defines a citation name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md).| +|id|String|Unique ID of the citation. Inherited from [microsoft.graph.entity](../resources/entity.md). Read-only.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.security.citationTemplate", + "baseType": "microsoft.graph.security.filePlanDescriptor", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.citationTemplate", + "id": "String (identifier)", + "displayName": "String", + "createdBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "createdDateTime": "String (timestamp)", + "citationUrl": "String", + "citationJurisdiction": "String" +} +``` + |
v1.0 | Security Datasource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-datasource.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Datasourcecontainer | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-datasourcecontainer.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Departmenttemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-departmenttemplate.md | + + Title: "departmentTemplate resource type" +description: "Specifies the department or business unit of an organization to which a label belongs." ++ms.localizationpriority: medium +++# departmentTemplate resource type ++Namespace: microsoft.graph.security ++Specifies the department or business unit of an organization to which a label belongs. This resource supports CRUD operations to apply and manage the [filePlanDepartment](security-fileplandepartment.md) descriptor for a [retentionLabel](security-retentionlabel.md). The **department** file plan descriptor supplements a retention label to improve the manageability and organization of Microsoft 365 content. ++Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List departments](../api/security-labelsroot-list-departments.md)|[microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) collection|Get a list of the [microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) objects and their properties.| +|[Create departments](../api/security-labelsroot-post-departments.md)|[microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md)|Create a new [microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) object.| +|[Get departments](../api/security-departmenttemplate-get.md)|[microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md)|Read the properties and relationships of a [microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) object.| +|[Delete departments](../api/security-labelsroot-delete-departments.md)|None|Delete a [microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) object.| ++## Properties +|Property|Type|Description| +|:|:|:| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the department descriptor. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|createdDateTime|DateTimeOffset|Represents the date and time in which the department descriptor is created. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|displayName|String|Unique string that defines a department name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md).| +|id|String|Unique ID of the department. Inherited from [microsoft.graph.entity](../resources/entity.md). Read-only.| ++## Relationships +None. ++## JSON representation +The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.security.departmentTemplate", + "baseType": "microsoft.graph.security.filePlanDescriptor", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.departmentTemplate", + "id": "String (identifier)", + "displayName": "String", + "createdBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "createdDateTime": "String (timestamp)" +} +``` + |
v1.0 | Security Deviceevidence | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-deviceevidence.md | Inherits from [alertEvidence](../resources/security-alertevidence.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.security.deviceEvidence" |
v1.0 | Security Dispositionreviewstage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-dispositionreviewstage.md | + + Title: "dispositionReviewStage resource type" +description: "Represents a multi-level review process where the reviewers indicate at each stage of the disposition whether to delete or further retain the content item.." ++ms.localizationpriority: medium +++# dispositionReviewStage resource type ++Namespace: microsoft.graph.security ++Represents a multi-level review process where the reviewers indicate at each stage of the disposition whether to delete or further retain the content item. +For details, see [Disposition of content](/microsoft-365/compliance/disposition). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[Create retentionLabel](../api/security-labelsroot-post-retentionlabel.md)|[microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md)|Create a new [retentionLabel](../resources/security-retentionlabel.md) object. | +|[Update retentionLabel](../api/security-retentionlabel-update.md)|[microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md)|Update the [retentionLabel](../resources/security-retentionlabel.md) object. | +++## Properties +|Property|Type|Description| +|:|:|:| +|id|String|Unique ID for each stage. | +|name|String|Name representing each stage within a collection. | +|reviewersEmailAddresses|String collection|A collection of reviewers at each stage. | +|stageNumber|String|The unique sequence number for each stage of the disposition review. | +++## Relationships +None. ++## JSON representation +Here's a JSON representation of the resource. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.security.dispositionReviewStage", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.dispositionReviewStage", + "id": "String (identifier)", + "stageNumber": "String", + "name": "String", + "reviewersEmailAddresses": [ + "String" + ] +} +``` |
v1.0 | Security Ediscoverycasesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-ediscoverycasesettings.md | Inherits from [entity](../resources/entity.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Ediscoveryexportoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-ediscoveryexportoperation.md | Inherits from [caseOperation](../resources/security-caseoperation.md). ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Ediscoveryholdoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-ediscoveryholdoperation.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Ediscoveryindexoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-ediscoveryindexoperation.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Ediscoverynoncustodialdatasource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-ediscoverynoncustodialdatasource.md | Inherits from [dataSourceContainer](../resources/security-datasourcecontainer.md |lastIndexOperation|[microsoft.graph.security.ediscoveryIndexOperation](../resources/security-ediscoveryindexoperation.md)|Operation entity that represents the latest indexing for the noncustodial data source.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Ediscoveryreviewtag | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-ediscoveryreviewtag.md | Represents an eDiscovery tag, which is used to mark documents during review to s |childTags|[microsoft.graph.security.ediscoveryReviewTag](../resources/security-ediscoveryreviewtag.md) collection|Returns the tags that are a child of a tag.| |parent|[microsoft.graph.security.ediscoveryReviewTag](../resources/security-ediscoveryreviewtag.md)|Returns the parent tag of the specified tag.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Filehash | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-filehash.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.security.fileHash" |
v1.0 | Security Fileplanappliedcategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-fileplanappliedcategory.md | + + Title: "filePlanAppliedCategory resource type" +description: "Represents the file plan descriptor of type category applied to a particular retention label." ++ms.localizationpriority: medium +++# filePlanAppliedCategory resource type ++Namespace: microsoft.graph.security ++Represents a file plan descriptor that specifies a group of similar types of content in a department. Used to supplement a [retention label](security-retentionlabel.md) for [record management purposes](security-recordsmanagement-overview.md). ++To create, get, or delete an **filePlanAppliedCategory** descriptor, use the [categoryTemplate](security-categorytemplate.md) resource. ++This resource is one of a set of file plan descriptors that an administrator can choose to supplement a retention label. To find out more about these optional descriptors, and how to get the descriptors that have been chosen for a retention label, see [file plan descriptor](security-fileplandescriptor.md). ++Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|displayName|String|Unique string that defines a file plan category name applied to the label. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| +|subcategory|[microsoft.graph.security.filePlanSubcategory](../resources/security-fileplansubcategory.md)|Represents the file plan descriptor for a subcategory under a specific category, which has been assigned to a particular retention label.| ++## Relationships +None. ++## JSON representation +Here's a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.security.filePlanAppliedCategory" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.filePlanAppliedCategory", + "displayName": "String", + "subcategory": { + "@odata.type": "microsoft.graph.security.filePlanSubcategory" + } +} +``` + |
v1.0 | Security Fileplanauthority | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-fileplanauthority.md | + + Title: "filePlanAuthority resource type" +description: "Represents the file plan descriptor of type authority applied to a particular retention label." ++ms.localizationpriority: medium +++# filePlanAuthority resource type ++Namespace: microsoft.graph.security ++Represents a file plan descriptor that specifies the type of the underlying authority which determines the content to be retained and its retention schedule. Used to supplement a [retention label](security-retentionlabel.md) for [record management purposes](security-recordsmanagement-overview.md). ++To create, get, or delete a **filePlanAuthority** descriptor, use the [authorityTemplate](security-authoritytemplate.md) resource. ++This resource is one of a set of file plan descriptors that an administrator can choose to supplement a retention label. To find out more about these optional descriptors, and how to get the descriptors that have been chosen for a retention label, see [file plan descriptor](security-fileplandescriptor.md). ++Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|displayName|String|Unique string that defines a filePlanAuthority name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| ++## Relationships +None. ++## JSON representation +Here's a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.security.filePlanAuthority" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.filePlanAuthority", + "displayName": "String" +} +``` + |
v1.0 | Security Fileplancitation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-fileplancitation.md | + + Title: "filePlanCitation resource type" +description: "Represents the file plan descriptor of type citation applied to a particular retention label." ++ms.localizationpriority: medium +++# filePlanCitation resource type ++Namespace: microsoft.graph.security ++Represents a file plan descriptor that specifies a rule or regulation created by a jurisdiction to determine whether certain content should be retained or deleted. Used to supplement a [retention label](security-retentionlabel.md) for [record management purposes](security-recordsmanagement-overview.md). ++To create, get, or delete a **filePlanCitation** descriptor, use the [citationTemplate](security-citationtemplate.md) resource. ++This resource is one of a set of file plan descriptors that an administrator can choose to supplement a retention label. To find out more about these optional descriptors, and how to get the descriptors that have been chosen for a retention label, see [file plan descriptor](security-fileplandescriptor.md). ++Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|citationJurisdiction|String|Represents the jurisdiction or agency that published the filePlanCitation.| +|citationUrl|String|Represents the URL to the published filePlanCitation.| +|displayName|String|Unique string that defines a filePlanCitation name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| ++## Relationships +None. ++## JSON representation +Here's a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.security.filePlanCitation" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.filePlanCitation", + "displayName": "String", + "citationUrl": "String", + "citationJurisdiction": "String" +} +``` + |
v1.0 | Security Fileplandepartment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-fileplandepartment.md | + + Title: "filePlanDepartment resource type" +description: "Represents the file plan descriptor of type department applied to a particular retention label." ++ms.localizationpriority: medium +++# filePlanDepartment resource type ++Namespace: microsoft.graph.security ++Represents a file plan descriptor that specifies the department or business unit of an organization to which a [retention label](security-retentionlabel.md) applies. Used to supplement a retention label for [record management purposes](security-recordsmanagement-overview.md). ++To create, get, or delete a **filePlanDepartment** descriptor, use the [departmentTemplate](security-departmenttemplate.md) resource. ++This resource is one of a set of file plan descriptors that an administrator can choose to supplement a retention label. To find out more about these optional descriptors, and how to get the descriptors that have been chosen for a retention label, see [file plan descriptor](security-fileplandescriptor.md). ++Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|displayName|String|Unique string that defines a filePlanDepartment name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| ++## Relationships +None. ++## JSON representation +Here's a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.security.filePlanDepartment" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.filePlanDepartment", + "displayName": "String" +} +``` + |
v1.0 | Security Fileplandescriptor | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-fileplandescriptor.md | + + Title: "filePlanDescriptor resource type" +description: "Represents a set of optional descriptors to supplement a retention label and improve the manageability and organization of content in Microsoft 365 for an organization." ++ms.localizationpriority: medium +++# filePlanDescriptor resource type ++Namespace: microsoft.graph.security ++Represents a _set_ of optional descriptors to supplement a [retention label](security-retentionlabel.md) and improve the manageability and organization of Microsoft 365 content. ++You can add a descriptor by using the POST operation of the corresponding file plan descriptor _template_, and specifying data for the descriptor. For example, to include a [filePlanCitation](security-fileplancitation.md) descriptor, use the [create citationTemplate](../api/security-labelsroot-post-citations.md) operation. Similarly, you can use the GET or DELETE operations on the template resource for the descriptor. ++To list the descriptors that supplement a retention label, use the [GET](../api/security-retentionlabel-get.md) operation on that [retentionLabel](security-retentionlabel.md) resource and apply `$expand` on the **descriptors** relationship. ++For information on how retention labels and file plan descriptors work in the [Microsoft Purview compliance portal](https://compliance.microsoft.com/), see [Use file plan to create and manage retention labels](/purview/file-plan-manager). ++Inherits from [microsoft.graph.entity](../resources/entity.md). ++## Methods +None. +++## Properties +|Property|Type|Description| +|:|:|:| +|authority|[microsoft.graph.security.filePlanAuthority](../resources/security-fileplanauthority.md)|Represents the file plan descriptor of type authority applied to a particular retention label.| +|appliedCategory|[microsoft.graph.security.filePlanAppliedCategory](../resources/security-fileplanappliedcategory.md)|Represents the file plan descriptor of type category applied to a particular retention label.| +|citation|[microsoft.graph.security.filePlanCitation](../resources/security-fileplancitation.md)|Represents the file plan descriptor of type citation applied to a particular retention label.| +|department|[microsoft.graph.security.filePlanDepartment](../resources/security-fileplandepartment.md)|Represents the file plan descriptor of type department applied to a particular retention label.| +|filePlanReference|[microsoft.graph.security.filePlanReference](../resources/security-fileplanreference.md)|Represents the file plan descriptor of type filePlanReference applied to a particular retention label. ΓÇ»| +++## Relationships +|Relationship|Type|Description| +|:|:|:| +|authorityTemplate|[microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md)| Specifies the underlying authority that describes the type of content to be retained and its retention schedule.| +|categoryTemplate|[microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md)|Specifies a group of similar types of content in a particular department.| +|citationTemplate|[microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md)|The specific rule or regulation created by a jurisdiction used to determine whether certain labels and content should be retained or deleted. | +|departmentTemplate|[microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md)|Specifies the department or business unit of an organization to which a label belongs.| +|filePlanReferenceTemplate|[microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md)|Specifies a unique alpha-numeric identifier for an organizationΓÇÖs retention schedule.| ++## JSON representation +Here's a JSON representation of the resource. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.security.filePlanDescriptor", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.filePlanDescriptor", + "id": "String (identifier)", + "authority": { + "@odata.type": "microsoft.graph.security.filePlanAuthority" + }, + "category": { + "@odata.type": "microsoft.graph.security.filePlanAppliedCategory" + }, + "citation": { + "@odata.type": "microsoft.graph.security.filePlanCitation" + }, + "department": { + "@odata.type": "microsoft.graph.security.filePlanDepartment" + }, + "filePlanReference": { + "@odata.type": "microsoft.graph.security.filePlanReference" + } +} +``` + |
v1.0 | Security Fileplandescriptorbase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-fileplandescriptorbase.md | + + Title: "filePlanDescriptorBase resource type" +description: "Specifies properties common to file plan descriptor resources." ++ms.localizationpriority: medium +++# filePlanDescriptorBase resource type ++Namespace: microsoft.graph.security ++Specifies properties common to file plan descriptor resources. Base type for each of the descriptors: [filePlanAppliedCategory](security-fileplanappliedcategory.md), [filePlanAuthority](security-fileplanauthority.md), [filePlanCitation](security-fileplancitation.md), [filePlanDepartment](security-fileplandepartment.md), [filePlanReference](security-fileplanreference.md), and [filePlanSubcategory](security-fileplansubcategory.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|displayName|String|Unique string that defines the name for the file plan descriptor associated with a particular retention label.| ++## Relationships +None. ++## JSON representation +Here's a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.security.filePlanDescriptorBase" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.filePlanDescriptorBase", + "displayName": "String" +} +``` + |
v1.0 | Security Fileplandescriptortemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-fileplandescriptortemplate.md | + + Title: "filePlanDescriptorTemplate resource type" +description: "Specifies the properties common to the template resources for file plan descriptors." ++ms.localizationpriority: medium +++# filePlanDescriptorTemplate resource type ++Namespace: microsoft.graph.security ++Specifies the properties common to the template resources for file plan descriptors. Base type for each of the template resources: [authorityTemplate](security-authoritytemplate.md), [categoryTemplate](security-categorytemplate.md), [citationTemplate](security-citationtemplate.md), [departmentTemplate](security-departmenttemplate.md), [filePlanReferenceTemplate](security-fileplanreferencetemplate.md), and [subcategoryTemplate](security-subcategorytemplate.md). ++Inherits from [microsoft.graph.entity](../resources/entity.md). ++## Methods +None. ++## Properties +|Property|Type|Description| +|:|:|:| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the filePlanDescriptorTemplate column.| +|createdDateTime|DateTimeOffset|Represents the date and time in which the filePlanDescriptorTemplate is created.| +|displayName|String|Unique string that defines a filePlanDescriptorTemplate name.| +|id|String|Unique ID of the filePlanDecriptorTemplate column. Read-only.| ++## Relationships +None. ++## JSON representation +Here's a JSON representation of the resource. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.security.filePlanDescriptorTemplate", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.filePlanDescriptorTemplate", + "id": "String (identifier)", + "displayName": "String", + "createdBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "createdDateTime": "String (timestamp)" +} +``` + |
v1.0 | Security Fileplanreference | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-fileplanreference.md | + + Title: "filePlanReference resource type" +description: "Represents the file plan descriptor of a reference ID, supplementing a specified retention label." ++ms.localizationpriority: medium +++# filePlanReference resource type ++Namespace: microsoft.graph.security ++Represents a file plan descriptor that specifies a unique alpha-numeric identifier for an organizationΓÇÖs retention schedule. Used to supplement a [retention label](security-retentionlabel.md) for [record management purposes](security-recordsmanagement-overview.md). ++To create, get, or delete a **filePlanReference** descriptor, use the [filePlanReferenceTemplate](security-fileplanreferencetemplate.md) resource. ++This resource is one of a set of file plan descriptors that an administrator can choose to supplement a retention label. To find out more about these optional descriptors, and how to get the descriptors that have been chosen for a retention label, see [file plan descriptor](security-fileplandescriptor.md). ++Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|displayName|String|Unique string that defines a reference ID. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| ++## Relationships +None. ++## JSON representation +Here's a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.security.filePlanReference" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.filePlanReference", + "displayName": "String" +} +``` + |
v1.0 | Security Fileplanreferencetemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-fileplanreferencetemplate.md | + + Title: "filePlanReferenceTemplate resource type" +description: "Specifies a unique alpha-numeric identifier for an organizationΓÇÖs retention schedule." ++ms.localizationpriority: medium +++# filePlanReferenceTemplate resource type ++Namespace: microsoft.graph.security ++Supports CRUD operations to apply and manage the [filePlanReference](security-fileplanreference.md) descriptor for a [retentionLabel](security-retentionlabel.md). The **filePlanReference** descriptor supplements a retention label to improve the manageability and organization of Microsoft 365 content. ++Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List filePlanReferences](../api/security-labelsroot-list-fileplanreferences.md)|[microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) collection|Get a list of the [microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) objects and their properties.| +|[Create filePlanReferences](../api/security-labelsroot-post-fileplanreferences.md)|[microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md)|Create a new [microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) object.| +|[Get filePlanReferences](../api/security-fileplanreferencetemplate-get.md)|[microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md)|Read the properties and relationships of a [microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) object.| +|[Delete filePlanReferences](../api/security-labelsroot-delete-fileplanreferences.md)|None|Delete a [microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) object.| ++## Properties +|Property|Type|Description| +|:|:|:| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the file plan reference descriptor. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|createdDateTime|DateTimeOffset|Represents the date and time in which the filePlanReference descriptor is created. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|displayName|String|Unique string that defines a filePlanReference name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md).| +|id|String|Unique ID of the filePlanReference. Inherited from [microsoft.graph.entity](../resources/entity.md). Read-only.| ++## Relationships +None. ++## JSON representation +Here's a JSON representation of the resource. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.security.filePlanReferenceTemplate", + "baseType": "microsoft.graph.security.filePlanDescriptor", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.filePlanReferenceTemplate", + "id": "String (identifier)", + "displayName": "String", + "createdBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "createdDateTime": "String (timestamp)" +} +``` + |
v1.0 | Security Fileplansubcategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-fileplansubcategory.md | + + Title: "filePlanSubcategory resource type" +description: "Represents a unique filePlanSubcategory applied to a retention label." ++ms.localizationpriority: medium +++# filePlanSubcategory resource type ++Namespace: microsoft.graph.security ++Represents a unique subcategory applied to a [retention label](security-retentionlabel.md). Used to supplement a retention label for [record management purposes](security-recordsmanagement-overview.md). ++To create, get, or delete a **filePlanSubcategory** descriptor, use the [subcategoryTemplate](security-subcategorytemplate.md) resource. ++This resource is one of a set of file plan descriptors that an administrator can choose to supplement a retention label. To find out more about these optional descriptors, and how to get the descriptors that have been chosen for a retention label, see [file plan descriptor](security-fileplandescriptor.md). ++Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|displayName|String|Unique string that defines a filePlanSubcategory name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| ++## Relationships +None. ++## JSON representation +Here's a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.security.filePlanSubcategory" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.filePlanSubcategory", + "displayName": "String" +} +``` + |
v1.0 | Security Hostcomponent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-hostcomponent.md | Inherits from [artifact](../resources/security-artifact.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Security Incident | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-incident.md | Because piecing the individual alerts together to gain insight into an attack ca |status|[microsoft.graph.security.incidentStatus](#incidentstatus-values)|The status of the incident. Possible values are: `active`, `resolved`, `inProgress`, `redirected`, `unknownFutureValue`, and `awaitingAction`.| |tenantId|String|The Microsoft Entra tenant in which the alert was created.| |systemTags|String collection|The system tags associated with the incident.|+|resolvingComment|String|User input that explains the resolution of the incident and the classification choice. This property contains free editable text.| ### incidentStatus values |
v1.0 | Security Indicator | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-indicator.md | This resource isn't directly addressable. You can interact with this resource th ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Security Ipevidence | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-ipevidence.md | Inherits from [alertEvidence](../resources/security-alertevidence.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.security.ipEvidence" |
v1.0 | Security Labelsroot | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-labelsroot.md | + + Title: "labelsRoot resource type" +description: "A root resource for capabilities that support records management for Microsoft 365 data in an organization." ++ms.localizationpriority: medium +++# labelsRoot resource type ++Namespace: microsoft.graph.security ++A root resource for capabilities that support records management for Microsoft 365 data in an organization. ++Those capabilities include using a [retention label](security-retentionlabel.md) to configure retention and deletion settings for a type of content in the Microsoft 365 data, and using one or more [file plan descriptors](security-fileplandescriptor.md) to supplement the retention label and provide additional options to better manage and organize the content. ++Inherits from [microsoft.graph.entity](../resources/entity.md). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List retentionLabels](../api/security-labelsroot-list-retentionlabel.md)|[microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md) collection |Get a list of the [retentionLabel](../resources/security-retentionlabel.md) objects and their properties.| +|[Create retentionLabel](../api/security-labelsroot-post-retentionlabel.md)|[microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md)|Create a new [retentionLabel](../resources/security-retentionlabel.md) object.| +|[List authorities](../api/security-labelsroot-list-authorities.md)|[microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) collection|Get the authorityTemplate resources from the authorities navigation property.| +|[Create authorities](../api/security-labelsroot-post-authorities.md)|[microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md)|Create a new authorityTemplate object.| +|[List categories](../api/security-labelsroot-list-categories.md)|[microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) collection|Get the categoryTemplate resources from the categories navigation property.| +|[Create categories](../api/security-labelsroot-post-categories.md)|[microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md)|Create a new categoryTemplate object.| +|[List citations](../api/security-labelsroot-list-citations.md)|[microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) collection|Get the citationTemplate resources from the citations navigation property.| +|[Create citations](../api/security-labelsroot-post-citations.md)|[microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md)|Create a new citationTemplate object.| +|[List departments](../api/security-labelsroot-list-departments.md)|[microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) collection|Get the departmentTemplate resources from the departments navigation property.| +|[Create departments](../api/security-labelsroot-post-departments.md)|[microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md)|Create a new departmentTemplate object.| +|[List filePlanReferences](../api/security-labelsroot-list-fileplanreferences.md)|[microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) collection|Get the filePlanReferenceTemplate resources from the filePlanReferences navigation property.| +|[Create filePlanReferences](../api/security-labelsroot-post-fileplanreferences.md)|[microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md)|Create a new filePlanReferenceTemplate object.| ++## Properties +None. ++++## Relationships +|Relationship|Type|Description| +|:|:|:| +|authorities|[microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) collection|Specifies the underlying authority that describes the type of content to be retained and its retention schedule.| +|categories|[microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) collection|Specifies a group of similar types of content in a particular department.| +|citations|[microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) collection|The specific rule or regulation created by a jurisdiction used to determine whether certain labels and content should be retained or deleted.| +|departments|[microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) collection|Specifies the department or business unit of an organization to which a label belongs.| +|filePlanReferences|[microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) collection|Specifies a unique alpha-numeric identifier for an organizationΓÇÖs retention schedule.| +|retentionLabels|[microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md) collection|Represents how customers can manage their data, whether and for how long to retain or delete it.| +++## JSON representation +Here's a JSON representation of the resource. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.security.labelsRoot", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.labelsRoot", + "id": "String (identifier)" +} +``` + |
v1.0 | Security Loggedonuser | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-loggedonuser.md | User that was loggen on the machine during the time of the alert. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.security.loggedOnUser" |
v1.0 | Security Recordsmanagement Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-recordsmanagement-overview.md | doc_type: conceptualPageType # Use the Microsoft Graph records management APIs +The Microsoft Purview records management APIs help organizations manage retention and deletion of data to meet their legal obligations and compliance regulations, and increases efficiency by enabling the regular disposition of items that no longer have to be retained. -The Microsoft Purview Records Management APIs help organizations manage retention and deletion of data to meet their legal obligations and compliance regulations. The APIs increase efficiency by enabling the regular disposition of items that no longer have to be retained. +## Manage retention labels +Many organizations need to manage their data to comply with industry regulations and internal policies, reduce risks of litigation or security breach, and let their employees effectively and agiley share knowledge that is current and relevant to them. Managing data commonly involves appropriately retaining or deleting different types of content. -The records management solution is a part of the Microsoft Purview compliance portal. +You can use [retention labels](security-retentionlabel.md) to configure retention and deletion settings for Microsoft 365 content. For example, you can set retention periods from when the content was labeled and you can set disposition review as the action at the end of the retention period. ++In addition, you can use [file plan descriptors](security-fileplandescriptor.md) to supplement a retention label and improve the manageability and organization of Microsoft 365 content. Examples of file plan descriptors include [authority](security-fileplanauthority.md), [citation](security-fileplancitation.md), and [department](security-fileplandepartment.md). ## Trigger events for an existing label-When an employee leaves a company, information is updated in the HR management system. From the leave date, confidential documents need to be retained for a period for seven years. These documents have the label `Employee_departure` applied. +Some scenarios require starting a retention period for certain documents upon a specific event, such as an employee leaving an organization, a contract expiring, or the fiscal year ending. ++You can use the [retentionLabel](security-retentionlabel.md) resource to support event-based retention, by setting the **retentionTrigger** property as `dateOfEvent` and associating the label with a [retentionEventType](security-retentioneventtype.md) resource. A [retentionEvent](security-retentionevent.md) is associated with a **retentionEventType** as well. When a triggering event happens, only content with that retention label applied is retained for the specified retention period. -Developers and compliance administrators can use records management APIs to read the label `Employee_departure` and look up the associated event type `Event-employee_departure`. +As an example: in an organization, when an employee leaves, employment records must be retained for 5 years. Use the **retentionLabel** and **retentionEvent** APIs to do the following for each employee record when the employee starts: +1. Apply a **retentionLabel** configured as follows: + - A display name of "Personnel information" + - A **retentionDuration** of 1827 days (5 years) + - Listening to the **retentionEventType** named "Employee departure" +2. Define a **retentionEvent** with the same **retentionEventType** named "Employee departure", and as part of its [eventQuery](security-eventquery.md) collection, an `Asset ID` with an employee ID value as the ID information associated with the event. -Compliance admins can use records management APIs to create an event for the associated event type. The retention period for the confidential documents starts after the creation of this event. +When an employee with an ID of 1234 leaves Contoso, the information is updated in the HR management system. The employee departure can trigger a new instance of **retentionEvent** with the "Employee departure" event type, and as part of its **eventQueries** property, an [eventQuery](security-eventquery.md) with a query string of 'AssetID:1234'. This way, employee record items using the "Personnel information" retention label and associated with the employee ID of 1234 get their 5 year retention period started from the date of the employee departure event. ## Entities The records management API includes the following key entities. | Name | Type | Use case | |:-|:-|:-|+| Label | [microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md) | Contains retention settings and actions that can be applied to an item at the end of a period. | +| File plan descriptors |[microsoft.graph.securty.fileplandescriptor](../resources/security-fileplandescriptor.md) | Represents a set of optional descriptors to supplement a retention label and improve their manageability for an organization. | | Retention event | [microsoft.graph.security.retentionEvent](../resources/security-retentionevent.md) | Represents a trigger for event-based retention, where a retention period starts after the event occurs. | | Retention event type | [microsoft.graph.security.retentionEventType](../resources/security-retentioneventtype.md) | Represents a single group for the same type of retention events. | |
v1.0 | Security Retentionduration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-retentionduration.md | + + Title: "retentionDuration resource type" +description: "An abstract type that represents how long an item will be retained before it can be deleted." ++ms.localizationpriority: medium +++# retentionDuration resource type ++Namespace: microsoft.graph.security ++An abstract type that represents how long an item will be retained before it can be deleted. ++Base type of +[retentionDurationForever](../resources/security-retentiondurationforever.md) and [retentionDurationInDays](../resources/security-retentiondurationindays.md). ++## Properties +None. ++## Relationships +None. ++## JSON representation for retentionDuration +Here's a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.security.retentionDuration" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.retentionDuration" +} +``` ++ |
v1.0 | Security Retentiondurationforever | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-retentiondurationforever.md | + + Title: "retentionDurationForever resource type" +description: "Represents that content will be retained permanently and will not be deleted." ++ms.localizationpriority: medium +++# retentionDurationForever resource type ++Namespace: microsoft.graph.security ++Indicates that content will be retained permanently and will not be deleted. +++Inherits from [retentionDuration](../resources/security-retentionduration.md). ++## Properties +None. ++## Relationships +None. ++## JSON representation +Here's a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.security.retentionDurationForever" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.retentionDurationForever" +} +``` |
v1.0 | Security Retentiondurationindays | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-retentiondurationindays.md | + + Title: "retentionDurationInDays resource type" +description: "Represents the number of days an item will be retained before it can be deleted" ++ms.localizationpriority: medium +++# retentionDurationInDays resource type ++Namespace: microsoft.graph.security ++Represents the number of days an item will be retained before it can be deleted. +++Inherits from [retentionDuration](../resources/security-retentionduration.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|days|Int32|Specifies the time period in days for which an item with the applied retention label will be retained for.| ++## Relationships +None. ++## JSON representation +Here's a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.security.retentionDurationInDays" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.retentionDurationInDays", + "days": "Integer" +} +``` |
v1.0 | Security Retentioneventstatus | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-retentioneventstatus.md | For event-based retention, this attribute provides the status of event propagati None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.security.retentionEventStatus" |
v1.0 | Security Retentioneventtype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-retentioneventtype.md | For details, see [Start retention when an event occurs](/microsoft-365/complianc None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Retentionlabel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-retentionlabel.md | + + Title: "retentionLabel resource type" +description: "Represents how customers can manage their data at an item level (email or document), including whether and for how long to retain or delete the item." ++ms.localizationpriority: medium +++# retentionLabel resource type ++Namespace: microsoft.graph.security ++Represents how organizations, for compliance and governance purposes, can manage their data at an item level (email or document), including whether and for how long to retain or delete the item. ++Organizations can use retention labels for different types of content that require different retention settings. For example, they can apply a retention label to tax forms and supporting documents to retain them for the period required by law. ++Organizations can configure retention labels with the retention periods and actions based on factors such as the date last modified or created. They can also start different retention periods by specifying an [event that can trigger retention](security-retentionevent.md) when the event occurs. ++For more information on how retention labels work, when to use them, and how Microsoft Purview supports retention labels to let you configure retention and deletion settings, see [Learn about retention policies and retention labels](/purview/retention). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List retentionLabels](../api/security-labelsroot-list-retentionlabel.md)|[microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md) collection|Get a list of the [retentionLabel](../resources/security-retentionlabel.md) objects and their properties.| +|[Create retentionLabel](../api/security-labelsroot-post-retentionlabel.md)|[microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md)|Create a new [retentionLabel](../resources/security-retentionlabel.md) object.| +|[Get retentionLabel](../api/security-retentionlabel-get.md)|[microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md)|Read the properties and relationships of a [retentionLabel](../resources/security-retentionlabel.md) object.| +|[Update retentionLabel](../api/security-retentionlabel-update.md)|[microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md)|Update the properties of a [retentionLabel](../resources/security-retentionlabel.md) object.| +|[Delete retentionLabel](../api/security-retentionlabel-delete.md)|None|Delete a [retentionLabel](../resources/security-retentionlabel.md) object.| +|[List retentionEventType](../api/security-retentioneventtype-list.md)|[microsoft.graph.security.retentionEventType](../resources/security-retentioneventtype.md) collection|Get the retentionEventType resources from the exapnd eventType navigation property.| +|[Add retentionEventType](../api/security-retentioneventtype-post.md)|[microsoft.graph.security.retentionEventType](../resources/security-retentioneventtype.md)|Add eventType by adding the relevant odata property when creating a label.| +++## Properties +|Property|Type|Description| +|:|:|:| +|actionAfterRetentionPeriod|microsoft.graph.security.actionAfterRetentionPeriod| Specifies the action to take on the labeled document after the period specified by the retentionDuration property expires. The possible values are: `none`, `delete`, `startDispositionReview`, `unknownFutureValue`.| +|behaviorDuringRetentionPeriod|microsoft.graph.security.behaviorDuringRetentionPeriod|Specifies how the behavior of a document with this label should be during the retention period. The possible values are: `doNotRetain`, `retain`, `retainAsRecord`, `retainAsRegulatoryRecord`, `unknownFutureValue`.| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the retentionLabel.| +|createdDateTime|DateTimeOffset|Represents the date and time in which the retentionLabel is created.| +|descriptionForAdmins|String|Provides label information for the admin. Optional.| +|descriptionForUsers|String|Provides the label information for the user. Optional.| +|displayName|String|Unique string that defines a label name.| +|id|String|Unique ID of the retentionLabel.| +|isInUse|Boolean|Specifies whether the label is currently being used.| +|lastModifiedBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|The user who last modified the retentionLabel.| +|lastModifiedDateTime|DateTimeOffset|The latest date time when the retentionLabel was modified.| +|retentionDuration|[microsoft.graph.security.retentionDuration](../resources/security-retentionduration.md)|Specifies the number of days to retain the content.| +|retentionTrigger|microsoft.graph.security.retentionTrigger|Specifies whether the retention duration is calculated from the content creation date, labeled date, or last modification date. The possible values are: `dateLabeled`, `dateCreated`, `dateModified`, `dateOfEvent`, `unknownFutureValue`.| +|defaultRecordBehavior|microsoft.graph.security.defaultRecordBehavior|Specifies the locked or unlocked state of a record label when it is created.The possible values are: `startLocked`, `startUnlocked`, `unknownFutureValue`.| +|labelToBeApplied|String|Specifies the replacement label to be applied automatically after the retention period of the current label ends. | +++## Relationships +|Relationship|Type|Description| +|:|:|:| +|dispositionReviewStages|[microsoft.graph.security.dispositionReviewStage](../resources/security-dispositionreviewstage.md) collection|When action at the end of retention is chosen as 'dispositionReview', dispositionReviewStages specifies a sequential set of stages with at least one reviewer in each stage.| +|retentionEventType|[microsoft.graph.security.retentionEventType](../resources/security-retentioneventtype.md)|Represents the type associated with a retention event.| +|descriptors|[microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md)|Represents out-of-the-box values that provide more options to improve the manageability and organization of the content you need to label.| ++++## JSON representation +Here's a JSON representation of the resource. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.security.retentionLabel", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.retentionLabel", + "id": "String (identifier)", + "displayName": "String", + "behaviorDuringRetentionPeriod": "String", + "actionAfterRetentionPeriod": "String", + "retentionTrigger": "String", + "retentionDuration": { + "@odata.type": "microsoft.graph.security.retentionDuration" + }, + "isInUse": "Boolean", + "descriptionForAdmins": "String", + "descriptionForUsers": "String", + "createdBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "createdDateTime": "String (timestamp)", + "lastModifiedBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "lastModifiedDateTime": "String (timestamp)", + "labelToBeApplied": "String", + "defaultRecordBehavior": "String" +} +``` |
v1.0 | Security Sitesource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-sitesource.md | None. |site|[site](../resources/site.md)|The SharePoint site associated with the **siteSource**.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Subcategorytemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-subcategorytemplate.md | + + Title: "subcategoryTemplate resource type" +description: "Represents the file plan descriptor of type subcategory for retention labels." ++ms.localizationpriority: medium +++# subcategoryTemplate resource type ++Namespace: microsoft.graph.security ++Supports CRUD operations to apply and manage the [filePlanSubcategory](security-fileplansubcategory.md) descriptor for a [retentionLabel](security-retentionlabel.md). The **subcategory** file plan descriptor supplements a retention label to improve the manageability and organization of Microsoft 365 content. ++Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List subcategories](../api/security-categorytemplate-list-subcategories.md)|[microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md) collection|Get a list of the [microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md) objects and their properties.| +|[Create subcategories](../api/security-categorytemplate-post-subcategories.md)|[microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md)|Create a new [microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md) object.| +|[Get subcategories](../api/security-subcategorytemplate-get.md)|[microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md)|Read the properties and relationships of a [microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md) object.| +|[Delete subcategories](../api/security-categorytemplate-delete-subcategories.md)|None|Delete a [microsoft.graph.security.subcategoryTemplate](../resources/security-subcategorytemplate.md) object.| ++## Properties +|Property|Type|Description| +|:|:|:| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the subcategory descriptor. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|createdDateTime|DateTimeOffset|Represents the date and time in which the subcategory descriptor is created. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|displayName|String|Unique string that defines a subcategory name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md).| +|id|String|Unique ID of the subcategory. Inherited from [microsoft.graph.entity](../resources/entity.md). Read-only.| ++## Relationships +None. ++## JSON representation +Here's JSON representation of the resource. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.security.subcategoryTemplate", + "baseType": "microsoft.graph.security.filePlanDescriptor", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.security.subcategoryTemplate", + "id": "String (identifier)", + "displayName": "String", + "createdBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "createdDateTime": "String (timestamp)" +} +``` + |
v1.0 | Security Threatintelligence | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-threatintelligence.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Security Unclassifiedartifact | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-unclassifiedartifact.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Security Unifiedgroupsource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-unifiedgroupsource.md | None. |group|[group](../resources/group.md)|Represents a group.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Usersource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-usersource.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Security Vmmetadata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-vmmetadata.md | Metadata of the virtual machine (VM) Microsoft Defender for Endpoint is running None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.security.vmMetadata" |
v1.0 | Security | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security.md | None ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Securityvendorinformation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/securityvendorinformation.md | Contains details about the security product/service vendor, provider, and subpro ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "optionalProperties": [ |
v1.0 | Selfservicesignupauthenticationflowconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/selfservicesignupauthenticationflowconfiguration.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.selfServiceSignUpAuthenticationFlowConfiguration" |
v1.0 | Sensitivitylabelassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/sensitivitylabelassignment.md | Provides details about a sensitivity label assigned to a [file](./driveitem.md) |labels|[extractSensitivityLabelsResult](./extractsensitivitylabelsresult.md)|List of sensitivity labels assigned to a file.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.sensitivityLabelAssignment" |
v1.0 | Serverprocessedcontent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/serverprocessedcontent.md | + + Title: "serverProcessedContent resource type" +description: Represents the server processed content of a given web part. ++ms.localizationpriority: medium +++# serverProcessedContent resource type ++Namespace: microsoft.graph ++++Represents the server processed content of a given web part. ++## Properties +|Property|Type|Description| +|:|:|:| +|componentDependencies|[metaDataKeyStringPair](../resources/metadatakeystringpair.md) collection|A key-value map where keys are string identifiers and values are component ids. SharePoint servers might decide to use this hint to preload the script for corresponding components for performance boost.| +|customMetadata|[metaDataKeyValuePair](../resources/metadatakeyvaluepair.md) collection|A key-value map where keys are string identifier and values are object of custom key-value pair. | +|htmlStrings|[metaDataKeyStringPair](../resources/metadatakeystringpair.md) collection|A key-value map where keys are string identifiers and values are rich text with HTML format. SharePoint servers treat the values as HTML content and run services like safety checks, search index and link fixup on them.| +|imageSources|[metaDataKeyStringPair](../resources/metadatakeystringpair.md) collection|A key-value map where keys are string identifiers and values are image sources. SharePoint servers treat the values as image sources and run services like search index and link fixup on them.| +|links|[metaDataKeyStringPair](../resources/metadatakeystringpair.md) collection|A key-value map where keys are string identifiers and values are links. SharePoint servers treat the values as links and run services like link fixup on them.| +|searchablePlainTexts|[metaDataKeyStringPair](../resources/metadatakeystringpair.md) collection|A key-value map where keys are string identifiers and values are strings that should be search indexed.| ++## Relationships +None. ++## JSON representation +The following is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.serverProcessedContent" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.serverProcessedContent", + "htmlStrings": [ + { + "@odata.type": "microsoft.graph.metaDataKeyStringPair" + } + ], + "searchablePlainTexts": [ + { + "@odata.type": "microsoft.graph.metaDataKeyStringPair" + } + ], + "links": [ + { + "@odata.type": "microsoft.graph.metaDataKeyStringPair" + } + ], + "imageSources": [ + { + "@odata.type": "microsoft.graph.metaDataKeyStringPair" + } + ], + "componentDependencies": [ + { + "@odata.type": "microsoft.graph.metaDataKeyStringPair" + } + ], + "customMetadata": [ + { + "@odata.type": "microsoft.graph.metaDataKeyValuePair" + } + ] +} +``` + |
v1.0 | Serviceannouncementbase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/serviceannouncementbase.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Servicehealth | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/servicehealth.md | Represents the health information of a service subscribed by a tenant. |issues|Collection([serviceHealthIssue](../resources/servicehealthissue.md))|A collection of issues that happened on the service, with detailed information for each issue.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Servicehostedmediaconfig | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/servicehostedmediaconfig.md | The media that's hosted remotely and is inherited from [mediaConfig](mediaconfig ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Serviceprincipal | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/serviceprincipal.md | This resource supports using [delta query](/graph/delta-query-overview) to track |[Create servicePrincipal](../api/serviceprincipal-post-serviceprincipals.md)| [servicePrincipal](serviceprincipal.md) | Creates a new servicePrincipal object. | |[Get servicePrincipal](../api/serviceprincipal-get.md) | [servicePrincipal](serviceprincipal.md) |Read properties and relationships of servicePrincipal object.| |[Update servicePrincipal](../api/serviceprincipal-update.md) | [servicePrincipal](serviceprincipal.md) |Update servicePrincipal object. |+|[Upsert servicePrincipal](../api/serviceprincipal-upsert.md) | [servicePrincipal](serviceprincipal.md) | Create a new servicePrincipal if it doesn't exist, or update the properties of an existing servicePrincipal.| |[Delete servicePrincipal](../api/serviceprincipal-delete.md) | None |Delete servicePrincipal object.| |[List deleted servicePrincipals](../api/directory-deleteditems-list.md) | [directoryObject](directoryobject.md) collection | Retrieve a list of recently deleted servicePrincipal objects. | |[Get deleted servicePrincipal](../api/directory-deleteditems-get.md) | [directoryObject](directoryobject.md) | Retrieve the properties of a recently deleted servicePrincipal object. | |
v1.0 | Serviceprincipalidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/serviceprincipalidentity.md | Inherits from [identity](../resources/identity.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.servicePrincipalIdentity" |
v1.0 | Serviceprincipallockconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/serviceprincipallockconfiguration.md | For more information about managing this object, see [Lock sensitive properties | tokenEncryptionKeyId | Boolean | Locks the tokenEncryptionKeyId property for modification on the service principal. | ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Settingtemplatevalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/settingtemplatevalue.md | Represents an individual template setting definition, including the default valu ### JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Settingvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/settingvalue.md | A setting represented by a name/value pair. ### JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Sharepointids | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/sharepointids.md | The **SharePointIds** resource groups the various identifiers for an item stored ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Sharepointonedriveoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/sharepointonedriveoptions.md | Provides the search content options when a search is performed using application ## JSON representation -The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", The following is a JSON representation of the resource. ```json {- "includeContent": "string" + "includeContent": "String" } ``` |
v1.0 | Sharinginvitation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/sharinginvitation.md | Groups invitation-related data items into a single structure. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Sharinglink | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/sharinglink.md | If a [**permission**](permission.md) resource has a non-null **sharingLink** fac ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Shiftactivity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/shiftactivity.md | Represents an activity in a [shift](shift.md). ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Shiftitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/shiftitem.md | Represents a version of a [shift](shift.md). ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Signinfrequencysessioncontrol | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/signinfrequencysessioncontrol.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Signinlocation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/signinlocation.md | Provides the city, state and country/region from where the sign-in happened. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Simulationautomation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/simulationautomation.md | Inherits from [entity](../resources/entity.md). |runs|[simulationAutomationRun](../resources/simulationautomationrun.md) collection|A collection of simulation automation runs. | ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Singlevaluelegacyextendedproperty | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/singlevaluelegacyextendedproperty.md | None ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Site | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/site.md | The **site** resource provides metadata and relationships for a SharePoint site. | [Delete permission][] | DELETE /sites/{site-id}/permissions/{permission-id} | [Update permission][] | PATCH /sites/{site-id}/permissions/{permission-id} | [List operations](../api/site-list-operations.md)|[richLongRunningOperation](../resources/richlongrunningoperation.md) collection|Get a list of [rich long-running operations](../resources/richlongrunningoperation.md) associated with a [site](../resources/site.md).+| [List pages][] | GET /sites/{site-id}/pages | [Get site]: ../api/site-get.md [Get root site]: ../api/site-get.md The **site** resource provides metadata and relationships for a SharePoint site. [Create permissions]: ../api/site-post-permissions.md [Delete permission]: ../api/site-delete-permission.md [Update permission]: ../api/site-update-permission.md+[List pages]: ../api/baseSitePage-list.md ## Properties The `root` identifier always references the root site for a given target, as fol | **lists** | Collection([list][]) | The collection of lists under this site. | **onenote** | [onenote][] | Calls the OneNote service for notebook related operations. | **operations** | [richLongRunningOperation](../resources/richlongrunningoperation.md) collection | The collection of long-running operations on the site.+| **pages** | Collection([baseSitePage][]) | The collection of pages in the baseSitePages list in this site. | | **permissions** | Collection([permission][]) | The permissions associated with the site. Nullable. | **sites** | Collection([site][]) | The collection of the sub-sites under this site. | **termStore** | [microsoft.graph.termStore.store] | The default termStore under this site. The `root` identifier always references the root site for a given target, as fol [columnDefinition]: columndefinition.md [baseItem]: baseitem.md [contentType]: contenttype.md+[baseSitePage]: baseSitePage.md [drive]: drive.md [identitySet]: identityset.md [itemAnalytics]: itemanalytics.md |
v1.0 | Sitepage | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/sitepage.md | + + Title: "sitePage resource type" +description: Represents a site page in the sitePages list. ++ms.localizationpriority: medium +++# sitePage resource type ++Namespace: microsoft.graph ++++This resource represents a page in the sitePages [list](../resources/list.md). +It contains the title, layout, and a collection of [webPart](../resources/webpart.md)s. ++Inherits from [baseSitePage](../resources/basesitepage.md). ++## Methods ++| Method | Return type | Description | +| :-- | :- | :- | +| [List sitePages](../api/sitepage-list.md) | [sitePage](../resources/sitepage.md) collection | Get a list of the [sitePage](../resources/sitepage.md) objects and their properties. | +| [Create sitePage](../api/sitepage-create.md) | [sitePage](../resources/sitepage.md) | Create a new [sitePage](../resources/sitepage.md) object. | +| [Get sitePage](../api/sitepage-get.md) | [sitePage](../resources/sitepage.md) | Read the properties and relationships of a [sitePage](../resources/sitepage.md) object. | +| [Update sitePage](../api/sitepage-update.md) | [sitePage](../resources/sitepage.md) | Update the properties of a [sitePage](../resources/sitepage.md) object. | +| [Delete sitePage](../api/basesitepage-delete.md) | None | Deletes a [sitePage](../resources/sitepage.md) object. | +| [Publish sitePage](../api/sitepage-publish.md) | None | Publish a [sitePage](../resources/sitepage.md) object. | +| [Get a collection of WebParts by position information](../api/sitepage-getwebpartsbyposition.md) | [webPart](../resources/webpart.md) collection | Get a collection of [WebPart](../resources/webpart.md) by providing [webPartPosition](../resources/webpartposition.md) information. | ++## Properties ++| Property | Type | Description | +| :- | : | : | +| contentType | [contentTypeInfo](../resources/contentTypeInfo.md) | The content type of this item. Inherited from [baseSitePage](../resources/basesitepage.md). | +| createdBy | [identitySet](../resources/identityset.md) | Identity of the creator of this item. Read-only. Inherited from [baseSitePage](../resources/basesitepage.md). | +| createdDateTime | DateTimeOffset | The date and time the item was created. Read-only. Inherited from [baseSitePage](../resources/basesitepage.md). | +| description | String | The descriptive text for the item. Inherited from [baseSitePage](../resources/basesitepage.md). | +| eTag | String | ETag for the item. Inherited from [baseSitePage](../resources/basesitepage.md). | +| id | String | The unique identifier of the item. Inherited from [baseSitePage](../resources/basesitepage.md). | +| lastModifiedBy | [identitySet](../resources/identityset.md) | TIdentity of the last modifier of this item. Read-only. Inherited from [baseSitePage](../resources/basesitepage.md). | +| lastModifiedDateTime | DateTimeOffset | The date and time the item was last modified. Read-only. Inherited from [baseSitePage](../resources/basesitepage.md). | +| name | String | The name of the item. Inherited from [baseSitePage](../resources/basesitepage.md). | +| pageLayout | [pageLayoutType](../resources/basesitepage.md#pagelayouttype-values) | The name of the page layout of the page. The possible values are: `microsoftReserved`, `article`, `home`, `unknownFutureValue`. Inherited from [baseSitePage](../resources/basesitepage.md). | +| parentReference | [itemReference](../resources/itemreference.md) | Parent information, if the item has a parent. Inherited from [baseSitePage](../resources/basesitepage.md). | +| promotionKind | [pagePromotionType](../resources/sitepage.md#pagepromotiontype-values) | Indicates the promotion kind of the sitePage. The possible values are: `microsoftReserved`, `page`, `newsPost`, `unknownFutureValue`. | +| publishingState | [publicationFacet](../resources/publicationfacet.md) | The publishing status and the MM.mm version of the page. Inherited from [baseSitePage](../resources/basesitepage.md). | +| reactions | [reactionsFacet](../resources/reactionsfacet.md) | Reactions information for the page. | +| showComments | Boolean | Determines whether or not to show comments at the bottom of the page. | +| showRecommendedPages | Boolean | Determines whether or not to show recommended pages at the bottom of the page. | +| thumbnailWebUrl | String | Url of the sitePage's thumbnail image | +| title | String | Title of the sitePage. Inherited from [baseSitePage](../resources/basesitepage.md). | +| titleArea | [titleArea](../resources/titlearea.md) | Title area on the SharePoint page. | +| webUrl | String | URL that displays the resource in the browser. Read-only. Inherited from [baseSitePage](../resources/basesitepage.md). | ++### pagePromotionType values ++| Value | Description | +| -- | -- | +| `microsoftReserved` | The page is a special type, reserved for use by Microsoft only. This value cannot be used when creating the page with [Create sitePage](../api/sitepage-create.md) method. | +| `page` | The page is promoted as a normal page | +| `newsPost` | The page is promoted as a news post | +| `unknownFutureValue` | Marker value for future compatibility. | ++## Relationships ++| Relationship | Type | Description | +| :-- | :-- | :-- | +| canvasLayout | [canvasLayout](../resources/canvaslayout.md) | Indicates the layout of the content in a given SharePoint page, including horizontal sections and vertical sections. | +| createdByUser | [user](../resources/user.md) | Identity of the creator of this item. Read-only. Inherited from [baseSitePage](../resources/basesitepage.md). | +| lastModifiedByUser | [user](../resources/user.md) | Identity of the last modifier of this item. Read-only. Inherited from [baseSitePage](../resources/basesitepage.md). | +| webParts | [webPart](../resources/webpart.md) collection | Collection of webparts on the SharePoint page. | ++## JSON representation ++The following is a JSON representation of the resource. ++<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.sitePage", + "baseType": "microsoft.graph.baseSitePage", + "openType": true +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.sitePage", + "id": "String (identifier)", + "createdBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "createdDateTime": "String (timestamp)", + "contentType": { + "@odata.type": "microsoft.graph.contentTypeInfo" + }, + "description": "String", + "eTag": "String", + "lastModifiedBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "lastModifiedDateTime": "String (timestamp)", + "name": "String", + "parentReference": { + "@odata.type": "microsoft.graph.itemReference" + }, + "webUrl": "String", + "title": "String", + "pageLayout": "String", + "promotionKind": "String", + "publishingState": { + "@odata.type": "microsoft.graph.publicationFacet" + }, + "reactions": { + "@odata.type": "microsoft.graph.reactionsFacet" + }, + "showComments": "Boolean", + "showRecommendedPages": "Boolean", + "thumbnailWebUrl": "String", + "titleArea": { + "@odata.type": "microsoft.graph.titleArea" + } +} +``` |
v1.0 | Sizerange | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/sizerange.md | Specifies the maximum and minimum sizes (in kilobytes) that an incoming message ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Smsauthenticationmethodconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/smsauthenticationmethodconfiguration.md | Inherits from [authenticationMethodConfiguration](../resources/authenticationmet |includeTargets|[smsAuthenticationMethodTarget](../resources/smsauthenticationmethodtarget.md) collection|A collection of groups that are enabled to use the authentication method.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Smsauthenticationmethodtarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/smsauthenticationmethodtarget.md | Inherits from [authenticationMethodConfiguration](../resources/authenticationmet None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Softwareoathauthenticationmethod | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/softwareoathauthenticationmethod.md | This resource type is a derived type that inherits from the [authenticationMetho None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Sortfield | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/sortfield.md | Represents a condition in a sorting operation. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Standardtimezoneoffset | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/standardtimezoneoffset.md | That means the transition from daylight saving time to standard occurs at 2 AM o ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Standardwebpart | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/standardwebpart.md | + + Title: 'standardWebPart resource type' +description: Represents a standard web part instance on a SharePoint page. ++ms.localizationpriority: medium +++# standardWebPart resource type ++Namespace: microsoft.graph ++++Represents a standard web part instance on a SharePoint page. ++Inherits from [webPart](../resources/webpart.md). ++## Properties ++| Property | Type | Description | +| : | :-- | :-- | +| containerTextWebPartId | string | The instance identifier of the container text webPart. It only works for inline standard webPart in rich text webParts. | +| data | [webPartData](../resources/webpartdata.md) | Data of the webPart. | +| id | String | Instance identifier of the webPart. Inherited from [entity](../resources/entity.md). | +| webPartType | String | A Guid that indicates the webPart type. | ++## Relationships ++None. ++## JSON representation ++The following is a JSON representation of the resource. ++<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.standardWebPart", + "baseType": "microsoft.graph.webPart", + "openType": false +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.standardWebPart", + "containerTextWebPartId": "String", + "id": "String (identifier)", + "webPartType": "String", + "data": { + "@odata.type": "microsoft.graph.webPartData" + } +} +``` |
v1.0 | Subjectset | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/subjectset.md | This object is an abstract base type from which the following resources are deri + [singleServicePrincipal](singleserviceprincipal.md) + [targetManager](targetmanager.md) + [targetApplicationOwners](targetapplicationowners.md)++ [targetUserSponsors](targetusersponsors.md) ## Properties |
v1.0 | Subscribedsku | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/subscribedsku.md | None ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Subscribetotoneoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/subscribetotoneoperation.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Subscription | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/subscription.md | Title: "subscription resource type" description: "Represents a subscription that allows a client app to receive change notifications about changes to data in Microsoft Graph." ms.localizationpriority: high +ms.sbservice: change-notifications doc_type: resourcePageType For more information about subscriptions and change notifications, including res | [List subscriptions](../api/subscription-list.md) | [subscription](subscription.md) | Lists active subscriptions. | | [Create subscription](../api/subscription-post-subscriptions.md) | [subscription](subscription.md) | Subscribes a listener application to receive change notifications when Microsoft Graph data changes. | | [Get subscription](../api/subscription-get.md) | [subscription](subscription.md) | Reads properties and relationships of subscription object. |-| [Update subscription](../api/subscription-update.md) | [subscription](subscription.md) | Renews a subscription by updating its expiration time. | +| [Update subscription](../api/subscription-update.md) | [subscription](subscription.md) | Updates a subscription expiration time for renewal and/or updates the notificationUrl for delivery. | | [Delete subscription](../api/subscription-delete.md) | None | Deletes a subscription object. | |[Reauthorize](../api/subscription-reauthorize.md)|None|Reauthorize a subscription when you receive a **reauthorizationRequired** challenge. | |
v1.0 | Synchronization Attributemappingsource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/synchronization-attributemappingsource.md | Expression extracting first eight characters from the source attribute. ``` ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.attributeMappingSource" |
v1.0 | Synchronization Bulkupload | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/synchronization-bulkupload.md | doc_type: resourcePageType Namespace: microsoft.graph -Represents the capability of the Microsoft Entra synchronization service to process bulk uploads. +Represents the capability of the Microsoft Entra synchronization service to process bulk uploads. For more information, see [API-driven inbound provisioning concepts](/entra/identity/app-provisioning/inbound-provisioning-api-concepts). ## Methods |
v1.0 | Synchronization Directorydefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/synchronization-directorydefinition.md | Inherits from [entity](../resources/entity.md). ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Synchronization Filter | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/synchronization-filter.md | For more information, see [Attribute-based application provisioning with scoping ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Synchronization Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/synchronization-overview.md | To work with the Microsoft Entra ID synchronization APIs, Microsoft Graph suppor - Application.Read.All - Application.ReadWrite.All -And the following [Microsoft Entra directory roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): +And the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): - Application Administrator - Cloud Application Administrator |
v1.0 | Synchronization Synchronization | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/synchronization-synchronization.md | Represents the capability for Microsoft Entra identity synchronization through t |templates|[synchronizationTemplate](../resources/synchronization-synchronizationtemplate.md) collection| Preconfigured synchronization settings for a particular application.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.synchronization", |
v1.0 | Synchronization Synchronizationjobrestartcriteria | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/synchronization-synchronizationjobrestartcriteria.md | Defines the scope of the [synchronizationJob: restart](../api/synchronization-sy ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Synchronization Synchronizationrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/synchronization-synchronizationrule.md | Synchronization rules are updated as part of the [synchronization schema](synchr ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Synchronization Synchronizationschedule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/synchronization-synchronizationschedule.md | Defines the schedule used to run a [synchronizationJob](synchronization-synchron ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Synchronization Synchronizationschema | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/synchronization-synchronizationschema.md | The following sections describe the high-level components of the synchronization |directories|[directoryDefinition](../resources/synchronization-directorydefinition.md) collection|Contains the collection of directories and all of their objects.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Synchronization Synchronizationsecretkeystringvaluepair | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/synchronization-synchronizationsecretkeystringvaluepair.md | Represents a single secret value. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Synchronization Synchronizationtemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/synchronization-synchronizationtemplate.md | You can provide multiple templates for an application, and designate a default t ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Table | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/table.md | Represents an Excel table. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Tablesort | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/tablesort.md | Manages sorting operations on Table objects. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Targetapplicationowners | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/targetapplicationowners.md | None. ## Relationships None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.targetApplicationOwners" |
v1.0 | Targetresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/targetresource.md | Represents target resource types associated with audit activity. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Targetusersponsors | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/targetusersponsors.md | + + Title: "targetUserSponsors complex type" +description: "Identifies a relationship to another user in the tenant who will be allowed as approver." ++ms.localizationpriority: medium ++++# targetUserSponsors complex type ++Namespace: microsoft.graph ++Identifies a relationship to another user in the tenant who will be allowed as approver. Used in the approval settings of an [access package assignment policy](accesspackageassignmentpolicy.md). +This resource is a subtype of [subjectSet](subjectset.md), in which the `@odata.type` value `#microsoft.graph.targetUserSponsors` indicates that a requesting user's sponsors are the approvers. When creating an access package assignment policy approval stage with **targetUserSponsors**, also include another approver, such as a single user or group member, in case the requesting user doesn't have sponsors. ++Inherits from [subjectSet](subjectset.md). ++## JSON representation ++The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.targetUserSponsors" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.targetUserSponsors", +} +``` |
v1.0 | Teaminfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teaminfo.md | Base type of [associatedTeamInfo](associatedteaminfo.md) and [sharedWithChannelT ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Teamslicensingdetails | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamslicensingdetails.md | + + Title: "teamsLicensingDetails resource type" +description: "A container where you can find all the different Microsoft Teams license details for each user in the tenant." ++ms.localizationpriority: high ++++# teamsLicensingDetails resource type ++Namespace: microsoft.graph ++A container where you can find all the different Microsoft Teams license details for each user in the tenant. ++## Properties ++| Property | Type | Description | +|:|:--|:-| +|hasTeamsLicense|Boolean|Indicates whether the user has a valid license to use Microsoft Teams.| ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.teamsLicensingDetails", + "baseType": "microsoft.graph.entity" +}--> ++```json +{ + "hasTeamsLicense": "Boolean", +} ++``` ++<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 +2015-10-25 14:57:30 UTC --> +<!-- +{ + "type": "#page.annotation", + "description": "teamslicensingdetails resource", + "keywords": "", + "section": "documentation", + "tocPath": "", + "suppressions": [] +} +--> ++## Related content ++- [teamwork resource type](teamwork.md) +- [userTeamwork resource type](userteamwork.md) |
v1.0 | Teamstab | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamstab.md | Title: "teamsTab resource type" -description: "A teamsTab is a tab that's pinned (attached) to a channel within a team. " +description: "Represents a tab pinned (attached) to a channel or a chat." ms.localizationpriority: medium doc_type: resourcePageType Namespace: microsoft.graph +Represents a tab pinned (attached) to a [channel](channel.md) or a [chat](chat.md). --A teamsTab is a [tab](../resources/teamstab.md) that's pinned (attached) to a [channel](channel.md) within a [team](team.md). +For more information about tabs, see [Build tabs for Teams](/microsoftteams/platform/tabs/what-are-tabs). ## Methods A teamsTab is a [tab](../resources/teamstab.md) that's pinned (attached) to a [c ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { |
v1.0 | Teamstemplate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamstemplate.md | A team template is a blueprint for creating a [team](../resources/team.md) in Mi <!-- { "blockType": "resource",+ "keyProperty": "id", "@odata.type": "microsoft.graph.teamsTemplate", "baseType": "microsoft.graph.entity" }--> |
v1.0 | Teamwork | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamwork.md | A container for the range of Microsoft Teams functionalities that are available |Method|Return type|Description| |:|:|:| |[List deletedTeams](../api/teamwork-list-deletedteams.md)|[deletedTeam](../resources/deletedteam.md) collection|Get a list of the [deletedTeam](../resources/deletedteam.md) objects and their properties.|+|[Get teamwork](../api/teamwork-get.md)|[teamwork](../resources/teamwork.md)|Get the properties and relationships of a teamwork object, such as the region of the organization and whether Microsoft Teams is enabled.| ## Properties | Property | Type | Description | |:|:--|:-|-|id|string| A unique identifier. | +|id|string|The default teamwork identifier.| +|isTeamsEnabled|Boolean|Indicates whether Microsoft Teams is enabled for the organization.| +|region|string|Represents the region of the organization. [!INCLUDE [supported-regions](../../includes/teamwork-supported-regions.md)]| ## Relationships The following JSON representation shows the resource type. ```json {- "id": "string" + "@odata.type": "#microsoft.graph.teamwork", + "id": "String", + "isTeamsEnabled": "boolean", + "region": "String" } ``` |
v1.0 | Teamworkactivitytopic | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamworkactivitytopic.md | Represents the topic of an activity feed notification. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.teamworkActivityTopic" |
v1.0 | Teamworkconversationidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamworkconversationidentity.md | Inherits from [identity](../resources/identity.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.teamworkConversationIdentity" |
v1.0 | Teamworkhostedcontent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamworkhostedcontent.md | Represents rich content like images and code snippets in Microsoft Teams. For ri None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Tenantrelationship | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/tenantrelationship.md | None. |:|:|:| |delegatedAdminCustomers|[delegatedAdminCustomer](../resources/delegatedadmincustomer.md) collection|The customer who has a delegated admin relationship with a Microsoft partner.| |delegatedAdminRelationships|[delegatedAdminRelationship](../resources/delegatedadminrelationship.md) collection|The details of the delegated administrative privileges that a Microsoft partner has in a customer tenant.|+|multiTenantOrganization|[multiTenantOrganization](../resources/multitenantorganization.md)|Defines an organization with more than one instance of Microsoft Entra ID.| ## JSON representation-The following is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Textwebpart | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/textwebpart.md | + + Title: 'textWebPart resource type' +description: Represents a text web part instance on a SharePoint page. ++ms.localizationpriority: medium +++# textWebPart resource type ++Namespace: microsoft.graph ++++Represents a text web part instance on a SharePoint page. ++Inherits from [webPart](../resources/webpart.md). ++## Properties ++| Property | Type | Description | +| :-- | :-- | :-- | +| id | String | Instance identifier of the web part. Inherited from [entity](../resources/entity.md). | +| innerHtml | String | The HTML string in text web part. | ++## Relationships ++None. ++## JSON representation ++The following is a JSON representation of the resource. ++<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.textWebPart", + "baseType": "microsoft.graph.webPart", + "openType": false +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.textWebPart", + "id": "String (identifier)", + "innerHtml": "String" +} +``` |
v1.0 | Thumbnailset | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/thumbnailset.md | It's used to represent a set of thumbnails associated with a DriveItem. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Timeconstraint | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/timeconstraint.md | Restricts meeting time suggestions to certain hours and days of the week accordi ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Timeoffitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/timeoffitem.md | Represents a version of the [timeOff](timeoff.md). ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Timeslot | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/timeslot.md | Represents a time slot for a meeting. ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Timestamp | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/timestamp.md | Date and time information for a point in time. ## JSON representation -Here is a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Timezonebase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/timezonebase.md | The basic representation of a time zone. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Timezoneinformation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/timezoneinformation.md | format as well when the current known problem is fixed. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Titlearea | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/titlearea.md | + + Title: 'titleArea resource type' +description: Represents the title area of a given SharePoint page. ++ms.localizationpriority: medium +++# titleArea resource type ++Namespace: microsoft.graph ++++Represents the title area of a given SharePoint page. ++## Properties ++| Property | Type | Description | +| :- | :- | : | +| alternativeText | String | Alternative text on the title area. | +| enableGradientEffect | Boolean | Indicates whether the title area has a gradient effect enabled. | +| imageWebUrl | String | URL of the image in the title area. | +| layout | [titleAreaLayoutType](../resources/titlearea.md#titlearealayouttype-values) | Enumeration value that indicates the layout of the title area. The possible values are: `imageAndTitle`, `plain`, `colorBlock`, `overlap`, `unknownFutureValue`. | +| serverProcessedContent | [serverProcessedContent](../resources/serverprocessedcontent.md) | Contains collections of data that can be processed by server side services like search index and link fixup. | +| showAuthor | Boolean | Indicates whether the author should be shown in title area. | +| showPublishedDate | Boolean | Indicates whether the published date should be shown in title area. | +| showTextBlockAboveTitle | Boolean | Indicates whether the text block above title should be shown in title area. | +| textAboveTitle | String | The text above title line. | +| textAlignment | [titleAreaTextAlignmentType](../resources/titlearea.md#titleareatextalignmenttype-values) | Enumeration value that indicates the text alignment of the title area. The possible values are: `left`, `center`, `unknownFutureValue`. | ++### titleAreaLayoutType values ++| Member | Description | +| :-- | :-- | +| imageAndTitle | The title area has an image and title layout. | +| plain | The title area has a plain layout. | +| colorBlock | The title area has a color block layout. | +| overlap | The title area has an overlap layout. | +| unknownFutureValue | Marker value for future compatibility. | ++### titleAreaTextAlignmentType values ++| Member | Description | +| :-- | :- | +| left | The text in title area is left-aligned. | +| center | The text in title area is center-aligned. | +| unknownFutureValue | Marker value for future compatibility. | ++## Relationships ++None. ++## JSON representation ++The following is a JSON representation of the resource. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.titleArea" +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.titleArea", + "alternativeText": "String", + "enableGradientEffect": "Boolean", + "imageWebUrl": "String", + "layout": "String", + "serverProcessedContent": { + "@odata.type": "microsoft.graph.serverProcessedContent" + }, + "showAuthor": "Boolean", + "showPublishedDate": "Boolean", + "showTextBlockAboveTitle": "Boolean", + "textAboveTitle": "String", + "textAlignment": "String" +} +``` |
v1.0 | Unifiedrolemanagementpolicyauthenticationcontextrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/unifiedrolemanagementpolicyauthenticationcontextrule.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Unifiedrolemanagementpolicyexpirationrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/unifiedrolemanagementpolicyexpirationrule.md | None. None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Unifiedrolemanagementpolicyrule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/unifiedrolemanagementpolicyrule.md | Inherits from [entity](../resources/entity.md). None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Updaterecordingstatusoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/updaterecordingstatusoperation.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Uploadsession | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/uploadsession.md | The **uploadSession** resource provides information about how to upload large fi ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Urlassessmentrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/urlassessmentrequest.md | Used to create and retrieve a URL threat assessment, derived from [threatAssessm ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | User | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/user.md | description: "Represents a Microsoft Entra user account. Inherits from directory ms.localizationpriority: high+ doc_type: resourcePageType This resource supports: | [List tasks](../api/planneruser-list-tasks.md) | [plannerTask](plannertask.md) collection | Get plannerTasks assigned to the user. | | **Schema extensions** | | | | [Add schema extension values](/graph/extensibility-schema-groups) | None | Create a schema extension definition and then use it to add custom typed data to a resource. |+| **Sponsors** | | | +| [Assign sponsors](../api/user-post-sponsors.md) | None | Assign a user a sponsor. | +| [List sponsors](../api/user-list-sponsors.md) | [directoryObject](../resources/directoryobject.md) collection | Get the users and groups who are this user's sponsors. | +| [Remove sponsors](../api/user-delete-sponsors.md) | None | Remove a user's sponsor. | | **Teamwork** | | | | [List apps installed for user](../api/userteamwork-list-installedapps.md) | [userScopeTeamsAppInstallation](userscopeteamsappinstallation.md) collection | Lists apps installed in the personal scope of a user. | | [Gets the installed app for user](../api/userteamwork-get-installedapps.md) | [userScopeTeamsAppInstallation](userscopeteamsappinstallation.md) | Lists the specified app installed in the personal scope of a user. | This resource supports: |surname|String|The user's surname (family name or last name). Maximum length is 64 characters. <br><br>Returned by default. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values).| |usageLocation|String|A two-letter country code (ISO standard 3166). Required for users that are assigned licenses due to legal requirements to check for availability of services in countries. Examples include: `US`, `JP`, and `GB`. Not nullable. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values).| |userPrincipalName|String|The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user's email name. The general format is alias@domain, where the domain must be present in the tenant's collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the **verifiedDomains** property of [organization](organization.md).<br>NOTE: This property can't contain accent characters. Only the following characters are allowed `A - Z`, `a - z`, `0 - 9`, ` ' . - _ ! # ^ ~`. For the complete list of allowed characters, see [username policies](/azure/active-directory/authentication/concept-sspr-policy#userprincipalname-policies-that-apply-to-all-user-accounts). <br><br>Returned by default. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, `endsWith`) and `$orderby`.-|userType|String|A string value that can be used to classify user types in your directory, such as `Member` and `Guest`. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `not`, `in`, and `eq` on `null` values). **NOTE:** For more information about the permissions for member and guest users, see [What are the default user permissions in Microsoft Entra ID?](/azure/active-directory/fundamentals/users-default-permissions?context=graph/context#member-and-guest-users) | +|userType|String|A string value that can be used to classify user types in your directory. The possible values are `Member` and `Guest`. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `not`, `in`, and `eq` on `null` values). **NOTE:** For more information about the permissions for member and guest users, see [What are the default user permissions in Microsoft Entra ID?](/azure/active-directory/fundamentals/users-default-permissions?context=graph/context#member-and-guest-users) | > [!TIP] > Directory and schema extensions and their associated data are returned only on `$select`; Open extensions and their associated data are returned only on `$expand`. For example: Cameron is the administrator of a directory for an elementary schoo |photos|[profilePhoto](profilephoto.md) collection| The collection of the user's profile photos in different sizes. Read-only.| |planner|[plannerUser](planneruser.md)| Entry-point to the Planner resource that might exist for a user. Read-only.| |registeredDevices|[directoryObject](directoryobject.md) collection|Devices that are registered for the user. Read-only. Nullable. Supports `$expand` and returns up to 100 objects.|+|sponsors|[directoryObject](../resources/directoryobject.md) collection|The users and groups responsible for this guest user's privileges in the tenant and keep the guest user's information and access updated. (HTTP Methods: GET, POST, DELETE.). Supports `$expand`.| |teamwork|[userTeamwork](userteamwork.md)| A container for Microsoft Teams features available for the user. Read-only. Nullable.| |todo|[todo](todo.md)|Represents the To Do services available to a user. | |transitiveMemberOf| [directoryObject](directoryobject.md) collection | The groups, including nested groups, and directory roles that a user is a member of. Nullable.| |
v1.0 | Userflowlanguageconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/userflowlanguageconfiguration.md | For [Microsoft Entra user flows](/azure/active-directory/external-identities/use ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Useridentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/useridentity.md | Title: "userIdentity resource type" description: "In the context of a Microsoft Entra audit log, the resource represents the user information that initiated or was affected by an audit activity." ms.localizationpriority: medium + doc_type: resourcePageType |
v1.0 | Userregistrationfeaturecount | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/userregistrationfeaturecount.md | None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Userregistrationfeaturesummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/userregistrationfeaturesummary.md | Represents the summary of users capable of multi-factor authentication, self-ser |userRoles|includedUserRoles|The role type of the user. Possible values are: `all`, `privilegedAdmin`, `admin`, `user`, `unknownFutureValue`.| |userTypes|includedUserTypes|User type. Possible values are: `all`, `member`, `guest`, `unknownFutureValue`.| -The value `privilegedAdmin` consists of the following privileged admin roles: +The value `privilegedAdmin` consists of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json).: * Global Administrator * Security Administrator None. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Userregistrationmethodsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/userregistrationmethodsummary.md | Represents the summary of number of users registered for each authentication met |userRoles|includedUserRoles|The role type of the user. Possible values are: `all`, `privilegedAdmin`, `admin`, `user`, `unknownFutureValue`.| |userTypes|includedUserTypes|User type. Possible values are: `all`, `member`, `guest`, `unknownFutureValue`.| -The value `privilegedAdmin` consists of the following privileged admin roles: +The value `privilegedAdmin` consists of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). * Global Administrator * Security Administrator |
v1.0 | Users | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/users.md | description: "Build compelling app experiences based on users, their relationshi ms.localizationpriority: high + doc_type: conceptualPageType Last updated 03/01/2024 |
v1.0 | Usersecuritystate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/usersecuritystate.md | description: "Contains stateful information about the user account." ms.localizationpriority: medium+ doc_type: resourcePageType |
v1.0 | Usersettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/usersettings.md | description: "The current user settings for content discovery. " ms.localizationpriority: high+ doc_type: resourcePageType This resource supports: ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.userSettings" |
v1.0 | Userteamwork | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/userteamwork.md | Namespace: microsoft.graph Represents a container for the range of Microsoft Teams functionalities that are available per user in the tenant. +## Methods ++|Method|Return type|Description| +|:|:|:| +|[Get userTeamwork](../api/userteamwork-get.md)|[userTeamwork](../resources/userteamwork.md)|Get userTeamwork settings for the specified [user](../resources/user.md), which includes the Microsoft Teams region and the locale chosen by the user.| + ## Properties | Property | Type | Description | |:|:--|:-|-|id|string| The unique identifier for the **userTeamwork** object. | +|id| String|The unique identifier for the **userTeamwork** object.| +|locale|String |The chosen locale of a user in Microsoft Teams.| +|region |String|The region of the user in Microsoft Teams.| ## Relationships The following JSON representation shows the resource type. ```json {- "id": "String (identifier)" + "id": "String (identifier)", + "locale" : "String", + "region" : "String" } ``` The following JSON representation shows the resource type. } --> +## Related content ++- [teamwork resource type](teamwork.md) |
v1.0 | Verifieddomain | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/verifieddomain.md | Title: "verifiedDomain resource type" description: "Specifies a domain for a tenant. The verifiedDomains property of the organization entity is a collection of verifiedDomain objects." ms.localizationpriority: medium-+ doc_type: resourcePageType Specifies a domain for a tenant. The **verifiedDomains** property of the [organi ## Properties-| Property | Type | Description | -|:-|:--|:-| -| capabilities | String | For example, `Email`, `OfficeCommunicationsOnline`. | -| isDefault | Boolean | `true` if this is the default domain associated with the tenant; otherwise, `false`. | -| isInitial | Boolean | `true` if this is the initial domain associated with the tenant; otherwise, `false`. | -| name | String | The domain name; for example, contoso.com`. | -| type | String | For example, `Managed`. | +| Property | Type | Description| +|||| +| capabilities | String | For example, `Email`, `OfficeCommunicationsOnline`. | +| isDefault | Boolean | `true` if this is the default domain associated with the tenant; otherwise, `false`. | +| isInitial | Boolean | `true` if this is the initial domain associated with the tenant; otherwise, `false`. | +| name | String | The domain name; for example, `contoso.com`. | +| type | String | For example, `Managed`. | ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Verifiedpublisher | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/verifiedpublisher.md | Represents the verified publisher of the [application](application.md). For more ## JSON representation-Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Verticalsection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/verticalsection.md | + + Title: 'verticalSection resource type' +description: Represents the vertical section in a given SharePoint page. ++ms.localizationpriority: medium +++# verticalSection resource type ++Namespace: microsoft.graph ++++Represents the vertical section in a given SharePoint page. ++Inherits from [entity](../resources/entity.md). ++## Methods ++| Method | Return type | Description | +| : | :- | :- | +| [List webParts](../api/webpart-list.md) | [webPart](../resources/webPart.md) Collection | Get a list of web parts associated with a [verticalSection](../resources/verticalSection.md) object. | +| [Create verticalSection](../api/sitepage-post-verticalsection.md) | [verticalSection](../resources/verticalsection.md) | Create a new [verticalSection](../resources/verticalsection.md) object. | +| [Get verticalSection](../api/verticalsection-get.md) | [verticalSection](../resources/verticalsection.md) | Read the properties and relationships of a [verticalSection](../resources/verticalsection.md) object. | +| [Update verticalSection](../api/verticalsection-update.md) | [verticalSection](../resources/verticalsection.md) | Update the properties of a [verticalSection](../resources/verticalsection.md) object. | +| [Delete verticalSection](../api/verticalsection-delete.md) | [verticalSection](../resources/verticalsection.md) | Delete a [verticalSection](../resources/verticalsection.md) object. | ++## Properties ++| Property | Type | Description | +| :- | :- | :-- | +| emphasis | [sectionEmphasisType](../resources/horizontalsection.md#sectionemphasistype-values) | Enumeration value that indicates the emphasis of the section background. The possible values are: `none`, `netural`, `soft`, `strong`, `unknownFutureValue`. | +| id | String | Unique identifier of the resource. Inherited from [entity](../resources/entity.md). | ++## Relationships ++| Relationship | Type | Description | +| :-- | :-- | : | +| webparts | [webPart](../resources/webpart.md) collection | The set of web parts in this section. | ++## JSON representation ++The following is a JSON representation of the resource. ++<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.verticalSection", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.verticalSection", + "id": "String (identifier)", + "emphasis": "String" +} +``` |
v1.0 | Virtualevent | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/virtualevent.md | Inherits from [entity](../resources/entity.md). |createdBy|[communicationsIdentitySet](communicationsidentityset.md)|Identity information for the creator of the virtual event. Inherited from [virtualEvent](../resources/virtualevent.md).| |description|[itemBody](../resources/itembody.md)|Description of the virtual event.| |displayName|String|Display name of the virtual event.|-|endDateTime|[dateTimeTimeZone](../resources/datetimetimezone.md)|End time of the virtual event. The **timeZone** property _can_ be set to any of the [time zones currently supported by Windows](/windows-hardware/manufacture/desktop/default-time-zones).| +|endDateTime|[dateTimeTimeZone](../resources/datetimetimezone.md)|End time of the virtual event. The **timeZone** property _can_ be set to any of the time zones currently supported by Windows. For details on how to get all available time zones using PowerShell, see [Get-TimeZone](/powershell/module/microsoft.powershell.management/get-timezone#example-3-get-all-available-time-zones).| |id|String|Unique identifier of the virtual event. Inherited from [entity](../resources/entity.md).|-|startDateTime|[dateTimeTimeZone](../resources/datetimetimezone.md)|Start time of the virtual event. The **timeZone** property _can_ be set to any of the [time zones currently supported by Windows](/windows-hardware/manufacture/desktop/default-time-zones).| +|startDateTime|[dateTimeTimeZone](../resources/datetimetimezone.md)|Start time of the virtual event. The **timeZone** property _can_ be set to any of the time zones currently supported by Windows. For details on how to get all available time zones using PowerShell, see [Get-TimeZone](/powershell/module/microsoft.powershell.management/get-timezone#example-3-get-all-available-time-zones).| |status|virtualEventStatus|Status of the virtual event. The possible values are: `draft`, `published`, `canceled`, `unknownFutureValue`.| ## Relationships |
v1.0 | Virtualeventwebinar | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/virtualeventwebinar.md | Inherits from [virtualEvent](../resources/virtualevent.md). | createdBy | [communicationsIdentitySet](communicationsidentityset.md) | Identity information for the creator of the webinar. Inherited from [virtualEvent](../resources/virtualevent.md). | | description | [itemBody](../resources/itembody.md) | Description of the webinar. Inherited from [virtualEvent](../resources/virtualevent.md). | | displayName | String | Display name of the webinar. Inherited from [virtualEvent](../resources/virtualevent.md). |-| endDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | End time of the webinar. The **timeZone** property _can_ be set to any of the [time zones currently supported by Windows](/windows-hardware/manufacture/desktop/default-time-zones). Inherited from [virtualEvent](../resources/virtualevent.md). | -| startDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | Start time of the webinar. The **timeZone** property _can_ be set to any of the [time zones currently supported by Windows](/windows-hardware/manufacture/desktop/default-time-zones). Inherited from [virtualEvent](../resources/virtualevent.md). | +| endDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | End time of the webinar. The **timeZone** property _can_ be set to any of the time zones currently supported by Windows. For details on how to get all available time zones using PowerShell, see [Get-TimeZone](/powershell/module/microsoft.powershell.management/get-timezone#example-3-get-all-available-time-zones).| +| startDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | Start time of the webinar. The **timeZone** property _can_ be set to any of the time zones currently supported by Windows. For details on how to get all available time zones using PowerShell, see [Get-TimeZone](/powershell/module/microsoft.powershell.management/get-timezone#example-3-get-all-available-time-zones).| | id | String | Unique identifier of the webinar. Inherited from [entity](../resources/entity.md).| | status | [virtualEventStatus](#virtualeventstatus-values) | Status of the webinar. | The following JSON representation shows the resource type. } ``` +## Related content ++[List meetingAttendanceReports](../api/meetingattendancereport-list.md) |
v1.0 | Viva Learning Api Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/viva-learning-api-overview.md | The employee learning API in Microsoft Graph enables apps to make content from a ## How do integrations work? As administrators, you can integrate your content and learner records (employee assignments and completed course records) from your LMS or learning provider with Viva Learning, by using out-of-the-box integrations where Viva Learning can pull content metadata and learning records from your LMS or learning provider. You can also [use the employee learning API](#use-cases-for-the-employee-learning-api-in-microsoft-graph) in Microsoft Graph to push content metadata from your LMS or learning provider into Viva Learning. -When the content metadata, employee assignments, and their completed course records are uploaded to Viva Learning, they appear in Viva Learning at the following locations: -- The content appears on the home page under the **Browse courses** ΓÇô **Providers** section.-- Assignments and completed course records appear on the **My Learning** page under the **Assigned to you** and **Completed** sections, respectively.+When the content metadata, employee assignments, and their completed course records are uploaded to Viva Learning, they appear in Viva Learning in the following locations: ++- When the content metadata is synchronized, the content appears on the home page under the **Browse courses** ΓÇô **Providers** section. +- When the learning course activities are synchronized, assignments, recommendations, and self-learning course records appear on the **My Learning** tab. Based on progression, the status will move from **In Progress** to **Completed**. ++The learning course activities for the learners can be discovered outside of Viva Learning via APIs. ## Authorization With the appropriate delegated or application [employee learning permissions](/graph/permissions-reference#employee-learning-permissions), your app can use the employee learning API to manage learning providers and their content for a learning hub in a tenant. For more information about access tokens, app registration, and delegated and application permissions, see [Authentication and authorization basics](/graph/auth/auth-concepts). |
v1.0 | Voiceauthenticationmethodtarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/voiceauthenticationmethodtarget.md | A collection of groups enabled to use voice call authentication via the [voice c None. ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "keyProperty": "id", |
v1.0 | Vulnerabilitystate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/vulnerabilitystate.md | Contains stateful information about the vulnerability. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Webapplication | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/webapplication.md | Specifies settings for a web application. | redirectUris | String collection | Specifies the URLs where user tokens are sent for sign-in, or the redirect URIs where OAuth 2.0 authorization codes and access tokens are sent. | ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Webpart | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/webpart.md | + + Title: 'webPart resource type' +description: Represents a specific web part instance on a SharePoint page. ++ms.localizationpriority: medium +++# webPart resource type ++Namespace: microsoft.graph ++++Represents a specific web part instance on a SharePoint page. ++This is an abstract type. ++Inherits from [entity](../resources/entity.md). ++## Methods ++| Method | Return type | Description | +| :-- | :- | : | +| [List webParts](../api/webpart-list.md) | [webPart](../resources/webpart.md) collection | Get a list of the [webPart](../resources/webpart.md) objects and their properties. | +| [Get webPart](../api/webpart-get.md) | [webPart](../resources/webpart.md) | Read the properties and relationships of a [webPart](../resources/webpart.md) object. | +| [Delete webPart](../api/webpart-delete.md) | [webPart](../resources/webpart.md) | Deletes a [webPart](../resources/webpart.md) object. | +| [Create webPart](../api/sitepage-create-webpart.md) | [webPart](../resources/webpart.md) | Create a new [webPart](../resources/webpart.md) object. | +| [Update webPart](../api/webpart-update.md) | [webPart](../resources/webpart.md) | Update the properties of a [webPart](../resources/webpart.md) object. | +| [Get webPart position](../api/webpart-getposition.md) | [webPartPosition](../resources/webpartposition.md) | Get the [webPartPosition](../resources/webpartposition.md) information of a [WebPart](../resources/webpart.md). | +| [Get webPart collection by position](../api/sitePage-getwebpartsbyposition.md) | [webPart](../resources/webpart.md) collection | Get a list of the [webPart](../resources/webpart.md) objects filtered by [webPartPosition](../resources/webpartposition.md) information. | ++## Properties ++| Property | Type | Description | +| :- | :-- | : | +| id | String | Unique instance identifier of the web part. 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.webPart", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.webPart", + "id": "String (identifier)" +} +``` |
v1.0 | Webpartdata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/webpartdata.md | + + Title: "webPartData resource type" +description: Represents the data of a given web part. ++ms.localizationpriority: medium +++# webPartData resource type ++Namespace: microsoft.graph ++++Represents the data of a given web part. ++## Properties ++| Property | Type | Description | +| : | : | :-- | +| audiences | String collection | Audience information of the web part. By using this property, specific content will be prioritized to specific audiences. | +| dataVersion | String | Data version of the web part. The value is defined by the web part developer. Different dataVersions usually refers to a different property structure. | +| description | String | Description of the web part. | +| properties | [Json](../resources/json.md) | Properties bag of the web part. | +| serverProcessedContent | [serverProcessedContent](../resources/serverprocessedcontent.md) | Contains collections of data that can be processed by server side services like search index and link fixup. | +| title | String | Title of the web part. | ++## Relationships ++None. ++## JSON representation ++The following is a JSON representation of the resource. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.webPartData" +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.webPartData", + "audiences": ["String"], + "dataVersion": "String", + "description": "String", + "properties": { + "@odata.type": "microsoft.graph.Json" + }, + "serverProcessedContent": { + "@odata.type": "microsoft.graph.serverProcessedContent" + }, + "title": "String" +} +``` |
v1.0 | Webpartposition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/webpartposition.md | + + Title: 'webPartPosition resource type' +description: Represents the position information of the given web part to the current page. ++ms.localizationpriority: medium +++# webPartPosition resource type ++Namespace: microsoft.graph ++++Represents the position information of the given web part to the current page. ++## Properties ++| Property | Type | Description | +| : | : | : | +| columnId | Double | Indicates the identifier of the column where the web part is located. | +| horizontalSectionId | Double | Indicates the horizontal section where the web part is located. | +| isInVerticalSection | boolean | Indicates whether the web part is located in the vertical section. | +| webPartIndex | Double | Index of the current web part. Represents the order of the web part in this column or section. | ++## Relationships ++None. ++## JSON representation ++The following is a JSON representation of the resource. ++<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.webPartPosition" +} +--> ++```json +{ + "@odata.type": "#microsoft.graph.webPartPosition", + "webPartIndex": "Double", + "horizontalSectionId": "Double", + "isInVerticalSection": "Boolean", + "columnId": "Double" +} +``` |
v1.0 | Windows Setting Api Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/windows-setting-api-overview.md | + + Title: "Use the Windows settings API in Microsoft Graph" +description: "The Windows setting API enables users and authorized third parties acting on behalf of users to retrieve their Windows operating system settings data stored in the Microsoft cloud." +ms.localizationpriority: medium ++++# Use the Windows settings API in Microsoft Graph ++The Windows setting API enables users and authorized third parties acting on behalf of users to retrieve their Windows operating system settings data stored in the Microsoft cloud. The Windows settings data is available in the Microsoft cloud only when users activate the feature. The scope of data available for each user depends on their backup settings selections. The default values for any settings remain local and aren't transferred to the cloud. The Windows settings API only shares settings data that the user uploads to the cloud. ++## Windows settings ++The [**windowsSetting**](windowssetting.md) resource represents various Windows operating system settings that are stored in the cloud for a given user. Windows settings are of two types: `roaming` and `backup`. The **settingType** property of a [windowsSetting](../resources/windowssetting.md) object indicates the type of the setting. ++| Setting type | Description | +| :-- | : | +| roaming | The Windows setting is associated with a user's account. The setting is consistent across all devices and any changes to the setting value are synced or applied to all Windows devices that the user owns.| +| backup | The Windows setting doesn't roam or sync across devices. This type of setting is used in device backup and restore scenarios.| ++ A [windowsSetting](../resources/windowssetting.md) object of type `backup` might have a **windowsDeviceId** property that links the setting to a specific device. ++ The [List Windows settings](../api/usersettings-list-windows.md) API returns a collection of [windowsSetting](../resources/windowssetting.md) objects and their properties. You can filter the results by the **windowsDeviceId** and **settingType** properties. ++The [Get windowsSetting](../api/windowssetting-get.md) API allows you to pass the ID of a [windowsSetting](../resources/windowssetting.md) in the URL to read a specific Windows setting object. ++The following JSON representation shows an example of a **windowsSetting** resource type. The instances collection represents **windowsSettingInstance** objects. ++<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.windowsSetting", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.windowsSetting", + "id": "{67585f9f-ee4b-4dd8-808e-d88375d66ef7}$windows.data.apps.devicemetadata", + "windowsDeviceId": "67585f9f-ee4b-4dd8-808e-d88375d66ef7", + "settingType": "backup", + "payloadType": "windows.data.apps.devicemetadata", + "instances": [ + { + "id": "14b50191-10e5-4da5-9099-8c909b8458bd", + "payload": "VGhpcyBpcyBqdXN0IGFuIGV4YW1wbGUh", + "lastModifiedDateTime": "2024-10-31T23:30:41Z", + "createdDateTime": "2024-02-12T19:34:35.223Z", + "expirationDateTime": "2034-02-09T19:34:33.771Z" + } + ] +} +``` ++> [!Warning] +> The structure of the ID of a [**windowsSetting**](../resources/windowssetting.md) object is not guaranteed and the caller should not take any dependency on it. The ID should be treated as an opaque string. ++## Windows setting instances ++A [**windowsSettingInstance**](../resources/windowssettinginstance.md) represents a setting instance from the Windows operating system that is stored in the cloud for a given user. A [windowsSettingInstance](../resources/windowssettinginstance.md) belongs to a [windowsSetting](../resources/windowssetting.md). ++The following JSON representation shows an example of a **windowsSettingInstance** resource type. ++<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.windowsSettingInstance", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.windowsSettingInstance", + "id": "6984732f-86b0-8e31-dc02-37fce0df6d61", + "payload": "VGhpcyBpcyBhbm90aGVyIGp1c3QgYW4gZXhhbXBsZSE=", + "lastModifiedDateTime": "2024-10-31T23:30:41Z", + "createdDateTime": "2024-02-12T19:34:35.223Z", + "expirationDateTime": "2034-02-09T19:34:33.771Z" +} +``` ++The [List Windows setting instances](../api/windowssetting-list-instances.md) API returns a collection of [windowsSettingInstance](../resources/windowssettinginstance.md) objects and their properties. The API requires the ID of a [windowsSetting](../resources/windowssetting.md) in the URL to read the setting instances. ++The [Get Windows setting instance](../api/windowssettinginstance-get.md) API allows you to pass the ID of a [windowsSetting](../resources/windowssetting.md) and [windowsSettingInstance](../resources/windowssettinginstance.md) in the URL to read a specific windows setting instance object. ++The **payload** property of a [**windowsSettingInstance**](../resources/windowssettinginstance.md) contains the actual setting value. The **payload** is a string in Base64-encoded format. The **payloadType** property of the [**windowsSetting**](../resources/windowssetting.md) object indicates the type of the setting value. The **payload** when decoded is a JSON object, which differs from setting to setting and is specific to the **payloadType**. ++### payloadType property +The **payloadType** defines the structure of a [windowsSettingInstance](./windowssettinginstance.md) payload. Windows includes a number of payload types that represent distinct setting structures used by different operating system experiences. As Windows evolves, more payload types are created and onboarded to the cloud. Querying the API and exploring the settings that are available is the best way to learn about the various payload types. The users and admins have control over which settings are uploaded to the cloud and most components don't upload default settings that the user hasn't customized. ++The following example shows a **windowsSettingsInstance** object returned by the API. ++```json +{ + "id": "default$windows.data.fileexplorerclassic.advancedsettings", + "settingType": "roaming", + "payloadType": "windows.data.fileexplorerclassic.advancedsettings", + "instances": [ + { + "id": "d9a7f6e2-8c4b-4e3a-bf7c-1e5a9d8c6f4b", + "payload": "eyJtaWdyYXRlZEZyb21TU0YiOmZhbHNlLCJhbHdheXNTaG93TWVudXMiOmZhbHNlLCJmb2xkZXJDb250ZW50c0luZm9UaXAiOmZhbHNlLCJoaWRlRHJpdmVzV2l0aE5vTWVkaWEiOmZhbHNlLCJuYXZQYW5lRXhwYW5kVG9DdXJyZW50Rm9sZGVyIjpmYWxzZSwibmF2UGFuZVNob3dBbGxGb2xkZXJzIjpmYWxzZSwibmF2UGFuZVNob3dGYXZvcml0ZXMiOmZhbHNlLCJwZXJzaXN0QnJvd3NlcnMiOmZhbHNlLCJzaGFyaW5nV2l6YXJkT24iOmZhbHNlLCJzaG93RHJpdmVMZXR0ZXJzIjpmYWxzZSwic2hvd1ByZXZpZXdIYW5kbGVycyI6ZmFsc2UsInR5cGVBaGVhZCI6ZmFsc2UsInNob3dTdGF0dXNCYXIiOmZhbHNlLCJzaG93TGlicmFyaWVzIjpmYWxzZSwic2hvd0NvbXBDb2xvciI6ZmFsc2V9", + "lastModifiedDateTime": "2022-06-27T00:53:00Z", + "createdDateTime": "2024-02-13T19:51:15.8217101Z", + "expirationDateTime": "2034-02-10T19:51:14.813Z" + } + ] +} +``` ++In this example, the **payloadType** `windows.data.fileexplorerclassic.advancedsettings` represents some of the settings that the File Explorer backs up to the cloud. The Base64 payload can be decoded to a UTF-8 string to see the JSON representation of this object. ++The following example shows the payload decoded. ++```json +{ + "migratedFromSSF": false, + "alwaysShowMenus": false, + "folderContentsInfoTip": false, + "hideDrivesWithNoMedia": false, + "navPaneExpandToCurrentFolder": false, + "navPaneShowAllFolders": false, + "navPaneShowFavorites": false, + "persistBrowsers": false, + "sharingWizardOn": false, + "showDriveLetters": false, + "showPreviewHandlers": false, + "typeAhead": false, + "showStatusBar": false, + "showLibraries": false, + "showCompColor": false +} +``` ++Properties in the object are commonly a subset of those that are available in the user experience of the component because component owners decide which settings provide the most value when uploaded to the cloud. ++#### Payload types ++The payload types described in this section have a special role in the Windows settings backup process. ++#### windows.data.platform.backuprestore.deviceprofile ++The windows.data.platform.backuprestore.deviceprofile payload type is not a setting the user applied; this type records information about devices that have opted into settings backup features. The following properties on this object are useful for understanding the rest of the settings: ++- **deviceDisplayName** - The name of the computer. This setting is found in Windows system settings at "**Start** > **Settings** > **System**". +- **profileId** - An identifier used to link [**windowsSetting**](../resources/windowssetting.md) items to the device that uploaded them. This property corresponds to **windowsSetting.windowsDeviceId** and can be used as a filter to get settings for a specific device from the [List Windows settings](../api/usersettings-list-windows.md) API. ++The following example shows this resource type. ++```json +{ + "id": "default$windows.data.platform.backuprestore.deviceprofile$deviceprofiles", + "settingType": "backup", + "payloadType": "windows.data.platform.backuprestore.deviceprofile", + "instances": [ + { + "id": "73b1a0b8-262a-4804-592a-b82a3a2a0c0d", + "payload": "ewogICAgInByb2ZpbGVJZCI6ICJ7OTViM2EyYzgtNDgyYS00YTA2LTdiM2EtZGEyYTVhNGIyYzBmfSIsCiAgICAiZGV2aWNlRGlzcGxheU5hbWUiOiAiRVhBTVBMRVVTRVJERVNLVE9QIiwKICAgICJjcmVhdGVkQnkiOiAid2luZG93cyIsCiAgICAic291cmNlUHJvZmlsZUlkIjogIiIsCiAgICAiY3JlYXRlZFRpbWUiOiAxNjY0NjgwNTg5LAogICAgIm1vZGlmaWVkVGltZSI6IDE2OTg3OTUwNDAsCiAgICAiaXNBY3RpdmUiOiB0cnVlLAogICAgImxhc3RGdWxsQmFja3VwQ29tcGxldGVkVGltZSI6IDE2OTgzMzIxMzcsCiAgICAib3NWZXJzaW9uIjogIjE4MDQ1LjM3NTAudmJfcmVsZWFzZSIKfQ==", + "lastModifiedDateTime": "2023-10-31T23:30:40Z", + "createdDateTime": "2024-02-13T22:49:02.376Z", + "expirationDateTime": "2034-02-10T22:49:03.365Z" + } + ] +} +``` +The following example shows the payload decoded. ++```json +{ + "profileId": "{95b3a2c8-482a-4a06-7b3a-da2a5a4b2c0f}", + "deviceDisplayName": "EXAMPLEUSERDESKTOP", + "createdBy": "windows", + "sourceProfileId": "", + "createdTime": 1664680589, + "modifiedTime": 1698795040, + "isActive": true, + "lastFullBackupCompletedTime": 1698332137, + "osVersion": "18045.3750.vb_release" +} +``` ++#### windows.data.platform.settingsbackup.backupunitstore ++The **backupUnitStore** payload type settings are unique in that the actual settings value is a **blob** in the data property. This is because **backupUnitStore** settings are collected directly from the Windows registry, on disk files, or other at rest locations throughout Windows. These settings weren't designed to be interoperable with experiences other than the components that created them. They are exposed in this API for comprehensive coverage of all Windows settings that are stored in the cloud. |
v1.0 | Workbookoperation | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/workbookoperation.md | None ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbookoperationerror | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/workbookoperationerror.md | Represents an error from a failed workbook operation. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbookpivottable | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/workbookpivottable.md | Represents an Excel PivotTable. |worksheet|[WorkbookWorksheet](worksheet.md)| The worksheet containing the current PivotTable. Read-only. | ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbookrangeview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/workbookrangeview.md | RangeView represents a set of visible cells of the parent range. |rows|[workbookRangeView](workbookrangeview.md) collection| Represents a collection of range views associated with the range. Read-only. Read-only.| ## JSON representation-Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", "baseType": "microsoft.graph.entity", |
v1.0 | Workbooksessioninfo | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/workbooksessioninfo.md | Provides information about workbook session. ## JSON representation -Here's a JSON representation of the resource +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workbooktablecolumn | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/workbooktablecolumn.md | Represents a column in a table. ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Workforceintegrationencryption | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/workforceintegrationencryption.md | An encryption entity defining the protocol and secret for a [workforceintegratio ## JSON representation -Here's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workinghours | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/workinghours.md | appropriate time zone. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Worksheet | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/worksheet.md | An Excel worksheet is a grid of cells. It can contain data, tables, charts, etc. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Worksheetprotection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/worksheetprotection.md | Represents the protection of a sheet object. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!--{ "blockType": "resource", |
v1.0 | Worksheetprotectionoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/worksheetprotectionoptions.md | Represents the options in sheet protection. ## JSON representation -Here is a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Toc.Yml | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/toc.yml | a/api-reference/v1.0/toc.yml items: href: resources/plannertask.md - name: List tasks href: api/planneruser-list-tasks.md+ - name: Sponsors + items: + - name: Add sponsor + href: api/user-post-sponsors.md + - name: List sponsors + href: api/user-list-sponsors.md + - name: Remove sponsor + href: api/user-delete-sponsors.md - name: Teamwork and communications items: - name: Installed app items: href: api/group-get.md - name: Update group href: api/group-update.md+ - name: Upsert group + href: api/group-upsert.md - name: Delete group href: api/group-delete.md - name: Renew group items: href: api/user-list-joinedteams.md - name: List associated teams href: api/associatedteaminfo-list.md- - name: Group setting - href: resources/groupsetting.md - items: - - name: Create - href: api/group-post-settings.md - - name: Get - href: api/groupsetting-get.md - - name: List - href: api/group-list-settings.md - - name: Update - href: api/groupsetting-update.md - - name: Delete - href: api/groupsetting-delete.md - - name: Group setting template - href: resources/groupsettingtemplate.md - items: - - name: List group setting templates - href: api/groupsettingtemplate-list.md - - name: Get group setting template - href: api/groupsettingtemplate-get.md - name: List lifecycle policies href: api/group-list-grouplifecyclepolicies.md - name: List photos items: href: api/application-get.md - name: Update application href: api/application-update.md+ - name: Upsert application + href: api/application-upsert.md - name: Delete application href: api/application-delete.md - name: Get delta items: href: api/federatedidentitycredential-get.md - name: Update href: api/federatedidentitycredential-update.md+ - name: Upsert + href: api/federatedidentitycredential-upsert.md - name: Delete href: api/federatedidentitycredential-delete.md - name: Owners items: href: api/serviceprincipal-get.md - name: Update href: api/serviceprincipal-update.md+ - name: Upsert + href: api/serviceprincipal-upsert.md - name: Delete href: api/serviceprincipal-delete.md - name: List deleted service principals items: - name: Get href: api/cloudclipboarditem-get.md - name: Windows settings- href: resources/windowssetting.md - items: - - name: List - href: api/usersettings-list-windows.md - - name: Get - href: api/windowssetting-get.md - - name: Windows setting instance - href: resources/windowssettinginstance.md items:- - name: List - href: api/windowssetting-list-instances.md - - name: Get - href: api/windowssettinginstance-get.md + - name: Overview + href: resources/windows-setting-api-overview.md + - name: Windows setting + href: resources/windowssetting.md + items: + - name: List + href: api/usersettings-list-windows.md + - name: Get + href: api/windowssetting-get.md + - name: Windows setting instance + href: resources/windowssettinginstance.md + items: + - name: List + href: api/windowssetting-list-instances.md + - name: Get + href: api/windowssettinginstance-get.md - name: Customer booking displayName: Bookings, Microsoft Bookings items: items: - name: Assignment href: resources/educationassignment.md items:- - name: Create assignment + - name: Create href: api/educationclass-post-assignment.md- - name: Get assignment + - name: Get href: api/educationassignment-get.md- - name: Update assignment + - name: Update href: api/educationassignment-update.md- - name: Delete assignment + - name: Delete href: api/educationassignment-delete.md+ - name: Publish + href: api/educationassignment-publish.md - name: Set up assignment resources folder href: api/educationassignment-setupresourcesfolder.md - name: Set up assignment feedback resources folder href: api/educationassignment-setupfeedbackresourcesfolder.md- - name: Publish assignment - href: api/educationassignment-publish.md - - name: List assignment resources - href: api/educationassignment-list-resources.md - - name: Create assignment resource - href: api/educationassignment-post-resource.md - - name: Get assignment resource - href: api/educationassignmentresource-get.md - - name: Delete resource from assignment - href: api/educationassignmentresource-delete.md - name: List submissions for assignment href: api/educationassignment-list-submissions.md - name: Get rubric attached to assignment href: api/educationassignment-get-rubric.md - name: List categories href: api/educationassignment-list-categories.md- - name: Add category + - name: Attach category to assignment href: api/educationassignment-post-categories.md- - name: Remove category + - name: Remove category from assignment href: api/educationassignment-remove-category.md - name: Attach rubric to assignment href: api/educationassignment-put-rubric.md items: href: api/educationassignment-delete-rubric.md - name: Get delta href: api/educationassignment-delta.md- - name: Add grading category + - name: Attach grading category to assignment href: api/educationassignment-post-gradingcategory.md- - name: Update grading category - href: api/educationgradingcategory-update.md - - name: Remove grading category + - name: Remove grading category from assignment href: api/educationassignment-delete-gradingcategory.md - name: Activate assignment href: api/educationassignment-activate.md - name: Deactivate assignment href: api/educationassignment-deactivate.md+ - name: Assignment resource + href: resources/educationassignmentresource.md + items: + - name: List + href: api/educationassignment-list-resources.md + - name: Create + href: api/educationassignment-post-resource.md + - name: Get + href: api/educationassignmentresource-get.md + - name: Delete from assignment + href: api/educationassignmentresource-delete.md - name: Assignment settings href: resources/educationassignmentsettings.md items: items: items: - name: Overview displayName: Azure AD, Microsoft identity platform, Identity and access- href: resources/azure-ad-overview.md + href: resources/identity-network-access-overview.md - name: Directory management items: - name: Administrative unit items: href: api/domain-verify.md - name: Promote domain href: api/domain-promote.md+ - name: Group setting + href: resources/groupsetting.md + items: + - name: Create + href: api/group-post-settings.md + - name: Get + href: api/groupsetting-get.md + - name: List + href: api/group-list-settings.md + - name: Update + href: api/groupsetting-update.md + - name: Delete + href: api/groupsetting-delete.md + - name: Group setting template + href: resources/groupsettingtemplate.md + items: + - name: List group setting templates + href: api/groupsettingtemplate-list.md + - name: Get group setting template + href: api/groupsettingtemplate-get.md - name: On-premises directory synchronization href: resources/onpremisesdirectorysynchronization.md items: items: href: api/authenticationstrengthroot-list-authenticationmethodmodes.md - name: Get authentication method modes href: api/authenticationmethodmodedetail-get.md+ - name: Authentication event listeners + href: resources/authenticationeventlistener.md + items: + - name: List + href: api/identitycontainer-list-authenticationeventlisteners.md + - name: Create + href: api/identitycontainer-post-authenticationeventlisteners.md + - name: Get + href: api/authenticationeventlistener-get.md + - name: Update + href: api/authenticationeventlistener-update.md + - name: Delete + href: api/authenticationeventlistener-delete.md + - name: Custom authentication extension + href: resources/customauthenticationextension.md + items: + - name: On token issuance start + href: resources/ontokenissuancestartcustomextension.md + - name: List + href: api/identitycontainer-list-customauthenticationextensions.md + - name: Create + href: api/identitycontainer-post-customauthenticationextensions.md + - name: Get + href: api/customauthenticationextension-get.md + - name: Update + href: api/customauthenticationextension-update.md + - name: Delete + href: api/customauthenticationextension-delete.md - name: Certificate-based auth configuration displayName: CBA href: resources/certificatebasedauthconfiguration.md items: items: - name: Create invitation href: api/invitation-post.md+ - name: Multitenant organization + items: + - name: Overview + displayName: Multitenant organization, MTO + href: resources/multitenantorganization-overview.md + - name: Multitenant organization + items: + - name: Multitenant organization + href: resources/multitenantorganization.md + - name: Create + href: api/tenantrelationship-put-multitenantorganization.md + - name: Get + href: api/multitenantorganization-get.md + - name: Update + href: api/multitenantorganization-update.md + - name: Tenant + items: + - name: Tenant + href: resources/multitenantorganizationmember.md + - name: List + href: api/multitenantorganization-list-tenants.md + - name: Add + href: api/multitenantorganization-post-tenants.md + - name: Get + href: api/multitenantorganizationmember-get.md + - name: Update + href: api/multitenantorganizationmember-update.md + - name: Remove + href: api/multitenantorganization-delete-tenants.md + - name: Join request + items: + - name: Join request + href: resources/multitenantorganizationjoinrequestrecord.md + - name: Get + href: api/multitenantorganizationjoinrequestrecord-get.md + - name: Update + href: api/multitenantorganizationjoinrequestrecord-update.md + - name: Partner configuration template + items: + - name: Partner configuration template + href: resources/multitenantorganizationpartnerconfigurationtemplate.md + - name: Get + href: api/multitenantorganizationpartnerconfigurationtemplate-get.md + - name: Update + href: api/multitenantorganizationpartnerconfigurationtemplate-update.md + - name: Reset + href: api/multitenantorganizationpartnerconfigurationtemplate-resettodefaultsettings.md + - name: Identity sync policy template + items: + - name: Identity sync policy template + href: resources/multitenantorganizationidentitysyncpolicytemplate.md + - name: Get + href: api/multitenantorganizationidentitysyncpolicytemplate-get.md + - name: Update + href: api/multitenantorganizationidentitysyncpolicytemplate-update.md + - name: Reset + href: api/multitenantorganizationidentitysyncpolicytemplate-resettodefaultsettings.md - name: Organizational branding href: resources/organizationalbranding.md items: items: items: - name: Microsoft Entra activity reports items:+ - name: AD FS application activity + items: + - name: Relying party detailed summary + href: resources/relyingpartydetailedsummary.md + items: + - name: Get relying party detailed summary + href: api/reportroot-getrelyingpartydetailedsummary.md - name: Registration and usage items: - name: Overview items: href: api/informationprotection-post-threatassessmentrequests.md - name: Get href: api/threatassessmentrequest-get.md- - name: Legacy alert + - name: Legacy alert (deprecated) items: - name: Alert href: resources/alert.md items: href: api/alert-update.md - name: Records management items:- - name: Overview - href: resources/security-recordsManagement-overview.md - - name: Retention event - href: resources/security-retentionevent.md - items: + - name: Overview + href: resources/security-recordsmanagement-overview.md + - name: Retention label + href: resources/security-retentionlabel.md + items: + - name: List + href: api/security-labelsroot-list-retentionlabel.md + - name: Create + href: api/security-labelsroot-post-retentionlabel.md + - name: Get + href: api/security-retentionlabel-get.md + - name: Update + href: api/security-retentionlabel-update.md + - name: Delete + href: api/security-retentionlabel-delete.md + - name: File plan descriptors + items: + - name: File plan descriptors + items: + - name: File plan descriptor set + href: resources/security-fileplandescriptor.md + - name: Applied category + href: resources/security-fileplanappliedcategory.md + - name: Authority + href: resources/security-fileplanauthority.md + - name: Citation + href: resources/security-fileplancitation.md + - name: Department + href: resources/security-fileplandepartment.md + - name: File plan reference + href: resources/security-fileplanreference.md + - name: Subcategory + href: resources/security-fileplansubcategory.md + - name: File plan descriptor templates + items: + - name: Applied category template + items: + - name: Category template + href: resources/security-categorytemplate.md - name: List- href: api/security-retentionevent-list.md + href: api/security-labelsroot-list-categories.md - name: Create- href: api/security-retentionevent-post.md + href: api/security-labelsroot-post-categories.md - name: Get- href: api/security-retentionevent-get.md + href: api/security-categorytemplate-get.md - name: Delete- href: api/security-retentionevent-delete.md - - name: Retention event type - href: resources/security-retentioneventtype.md - items: + href: api/security-labelsroot-delete-categories.md + - name: Authority template + items: + - name: Authority template + href: resources/security-authoritytemplate.md - name: List- href: api/security-retentioneventtype-list.md + href: api/security-labelsroot-list-authorities.md - name: Create- href: api/security-retentioneventtype-post.md + href: api/security-labelsroot-post-authorities.md - name: Get- href: api/security-retentioneventtype-get.md - - name: Update - href: api/security-retentioneventtype-update.md + href: api/security-authoritytemplate-get.md + - name: Delete + href: api/security-labelsroot-delete-authorities.md + - name: Citation template + items: + - name: Citation template + href: resources/security-citationtemplate.md + - name: List + href: api/security-labelsroot-list-citations.md + - name: Create + href: api/security-labelsroot-post-citations.md + - name: Get + href: api/security-citationtemplate-get.md + - name: Delete + href: api/security-labelsroot-delete-citations.md + - name: Department template + items: + - name: Department template + href: resources/security-departmenttemplate.md + - name: List + href: api/security-labelsroot-list-departments.md + - name: Create + href: api/security-labelsroot-post-departments.md + - name: Get + href: api/security-departmenttemplate-get.md + - name: Delete + href: api/security-labelsroot-delete-departments.md + - name: File plan reference template + items: + - name: File plan reference template + href: resources/security-fileplanreferencetemplate.md + - name: List + href: api/security-labelsroot-list-fileplanreferences.md + - name: Create + href: api/security-labelsroot-post-fileplanreferences.md + - name: Get + href: api/security-fileplanreferencetemplate-get.md - name: Delete- href: api/security-retentioneventtype-delete.md + href: api/security-labelsroot-delete-fileplanreferences.md + - name: Subcategory template + items: + - name: Subcategory template + href: resources/security-subcategorytemplate.md + - name: List + href: api/security-categorytemplate-list-subcategories.md + - name: Create + href: api/security-categorytemplate-post-subcategories.md + - name: Get + href: api/security-subcategorytemplate-get.md + - name: Delete + href: api/security-categorytemplate-delete-subcategories.md + - name: Retention event + href: resources/security-retentionevent.md + items: + - name: List + href: api/security-retentionevent-list.md + - name: Create + href: api/security-retentionevent-post.md + - name: Get + href: api/security-retentionevent-get.md + - name: Delete + href: api/security-retentionevent-delete.md + - name: Retention event type + href: resources/security-retentioneventtype.md + items: + - name: List + href: api/security-retentioneventtype-list.md + - name: Create + href: api/security-retentioneventtype-post.md + - name: Get + href: api/security-retentioneventtype-get.md + - name: Update + href: api/security-retentioneventtype-update.md + - name: Delete + href: api/security-retentioneventtype-delete.md - name: Secure score href: resources/securescore.md items: items: - name: List item href: resources/listitem.md items:- - name: Get item - href: api/listitem-get.md - name: Create item href: api/listitem-create.md- - name: Update item + - name: Get + href: api/listitem-get.md + - name: Update href: api/listitem-update.md- - name: Delete item + - name: Delete href: api/listitem-delete.md- - name: List versions - href: api/listitem-list-versions.md + - name: Get delta + href: api/listitem-delta.md - name: Get item analytics href: api/itemanalytics-get.md+ - name: List versions + href: api/listitem-list-versions.md - name: Document set version items: - name: Document set version items: href: api/documentsetversion-delete.md - name: Restore href: api/documentsetversion-restore.md+ - name: Pages + items: + - name: Base site page + href: resources/basesitepage.md + items: + - name: List + href: api/basesitepage-list.md + - name: Get + href: api/basesitepage-get.md + - name: Delete + href: api/basesitepage-delete.md + - name: Site page + href: resources/sitepage.md + items: + - name: List + href: api/sitepage-list.md + - name: Create + href: api/sitepage-create.md + - name: Get + href: api/sitepage-get.md + - name: Update + href: api/sitepage-update.md + - name: Delete + href: api/basesitepage-delete.md + - name: Publish + href: api/sitepage-publish.md + - name: Horizontal section + items: + - name: Horizontal section + href: resources/horizontalsection.md + - name: List + href: api/horizontalsection-list.md + - name: Create + href: api/sitepage-post-horizontalsection.md + - name: Get + href: api/horizontalsection-get.md + - name: Update + href: api/horizontalsection-update.md + - name: Delete + href: api/horizontalsection-delete.md + - name: Column + items: + - name: Horizontal section column + href: resources/horizontalsectioncolumn.md + - name: List + href: api/horizontalsectioncolumn-list.md + - name: Get + href: api/horizontalsectioncolumn-get.md + - name: Vertical section + items: + - name: Vertical section + href: resources/verticalsection.md + - name: Create + href: api/sitepage-post-verticalsection.md + - name: Get + href: api/verticalsection-get.md + - name: Update + href: api/verticalsection-update.md + - name: Delete + href: api/verticalsection-delete.md + - name: Web part + items: + - name: Web part + href: resources/webpart.md + - name: Text web part + href: resources/textwebpart.md + - name: Standard web part + href: resources/standardwebpart.md + - name: List + href: api/webpart-list.md + - name: Create + href: api/sitepage-create-webpart.md + - name: Get + href: api/webpart-get.md + - name: Update + href: api/webpart-update.md + - name: Delete + href: api/webpart-delete.md + - name: Get position + href: api/webpart-getposition.md + - name: Get by position + href: api/sitepage-getwebpartsbyposition.md - name: Rich long-running operation items: - name: Rich long-running operation items: href: api/virtualevent-list-sessions.md - name: Get href: api/virtualeventsession-get.md+ - name: Settings + items: + - name: License details + href: resources/licensedetails.md + items: + - name: Get + href: api/licenseDetails-getteamslicensingdetails.md + - name: Organization settings + items: + - name: Teamwork + href: resources/teamwork.md + items: + - name: Get + href: api/teamwork-get.md + - name: User settings + items: + - name: User teamwork + href: resources/userteamwork.md + items: + - name: Get + href: api/userteamwork-get.md - name: Employee learning displayName: Viva Learning items: |