Updates from: 07/14/2021 03:10:12
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Accesspackage Delete Incompatibleaccesspackage https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-delete-incompatibleaccesspackage.md
+
+ Title: "Remove accessPackage from incompatibleAccessPackages"
+description: "Remove a link that indicates an access package is incompatible with a specified access package."
+localization_priority: Normal
+++
+# Remove accessPackage from incompatibleAccessPackages
+
+Namespace: microsoft.graph
++
+Remove an [access package](../resources/accesspackage.md) from the list of access packages that have been marked as incompatible on an [accessPackage](../resources/accesspackage.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) | EntitlementManagement.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | EntitlementManagement.ReadWrite.All |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+DELETE /identityGovernance/entitlementManagement/accessPackages/{id}/incompatibleAccessPackages/{id}/$ref
+```
+
+## Request headers
+
+| Name | Description |
+|:--|:--|
+| Authorization | Bearer {token}. Required. |
+| Content-Type | application/json. Required. |
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "remove_incompatibleaccesspackage_from_accesspackage"
+}-->
+```http
+DELETE https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackages/{id}/incompatibleAccessPackages/{id}/$ref
+```
++
+### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response"
+} -->
+
+```http
+HTTP/1.1 204 No Content
+```
+
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2019-02-04 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "Remove incompatibleAccessPackage",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
+
v1.0 Accesspackage Delete Incompatiblegroup https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-delete-incompatiblegroup.md
+
+ Title: "Remove group from incompatibleGroups"
+description: "Remove a link that indicates a group is incompatible with a specified access package."
+localization_priority: Normal
+++
+# Remove group from incompatibleGroups
+
+Namespace: microsoft.graph
++
+Remove a [group](../resources/group.md) from the list of groups that have been marked as incompatible on an [accessPackage](../resources/accesspackage.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) | EntitlementManagement.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | EntitlementManagement.ReadWrite.All |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+DELETE /identityGovernance/entitlementManagement/accessPackages/{id}/incompatibleGroups/{id}/$ref
+```
+
+## Request headers
+
+| Name | Description |
+|:--|:--|
+| Authorization | Bearer {token}. Required. |
+| Content-Type | application/json. Required. |
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "remove_incompatiblegroup_from_accesspackage"
+}-->
+```http
+DELETE https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackages/{id}/incompatibleGroups/{id}/$ref
+```
++
+### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response"
+} -->
+
+```http
+HTTP/1.1 204 No Content
+```
+
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2019-02-04 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "Remove incompatibleGroup",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
++
v1.0 Accesspackage List Accesspackagesincompatiblewith https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-list-accesspackagesincompatiblewith.md
+
+ Title: "List accessPackagesIncompatibleWith"
+description: "Retrieve a list of accesspackages which have indicated that their access rights are incompatible with a specific access package."
+localization_priority: Normal
+++
+# List accessPackagesIncompatibleWith
+
+Namespace: microsoft.graph
++
+Retrieve a list of the [accessPackage](../resources/accesspackage.md) objects that have marked a specified [accessPackage](../resources/accesspackage.md) as incompatible.
+
+## 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) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+GET /identityGovernance/entitlementManagement/accessPackage/{id}/accessPackagesIncompatibleWith
+```
+
+## Optional query parameters
+
+This method supports the OData query parameters for server-side paging through a large response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+| Name |Description|
+|:-|:-|
+| Authorization | Bearer \{token\}. Required. |
+
+## 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 [accessPackage](../resources/accesspackage.md) objects in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_accesspackagesincompatiblewith"
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackages/{id}/accessPackagesIncompatibleWith
+```
++
+### Response
+
+The following is an example of the response.
+
+> **Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.accessPackage",
+ "isCollection": true
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "value": [
+ {
+ "id": "c0a74b4d-2694-4d5d-a964-1bee4ff0aaf2",
+ "catalogId": "c955f54f-e248-4155-b314-0bdd63f5aae9",
+ "displayName": "accesspackage"
+ }
+ ]
+}
+```
+
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2019-02-04 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "List accessPackagesIncompatibleWith",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
++
v1.0 Accesspackage List Incompatibleaccesspackages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-list-incompatibleaccesspackages.md
+
+ Title: "List incompatibleAccessPackages"
+description: "Retrieve a list of accesspackages whose access rights are incompatible with a specific access package."
+localization_priority: Normal
+++
+# List incompatibleAccessPackages
+
+Namespace: microsoft.graph
++
+Retrieve a list of the [accessPackage](../resources/accesspackage.md) objects that have been marked as incompatible on an [accessPackage](../resources/accesspackage.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) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+GET /identityGovernance/entitlementManagement/accessPackage/{id}/incompatibleAccessPackages
+```
+
+## Optional query parameters
+
+This method supports the OData query parameters for server-side paging through a large response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+| Name |Description|
+|:-|:-|
+| Authorization | Bearer \{token\}. Required. |
+
+## 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 [accessPackage](../resources/accesspackage.md) objects in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_incompatibleaccesspackages"
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackages/{id}/incompatibleAccessPackages
+### Response
+
+The following is an example of the response.
+
+> **Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.accessPackage",
+ "isCollection": true
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "value": [
+ {
+ "id": "c0a74b4d-2694-4d5d-a964-1bee4ff0aaf2",
+ "catalogId": "c955f54f-e248-4155-b314-0bdd63f5aae9",
+ "displayName": "accesspackage"
+ }
+ ]
+}
+```
+
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2019-02-04 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "List incompatibleAccessPackages",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
+
v1.0 Accesspackage List Incompatiblegroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-list-incompatiblegroups.md
+
+ Title: "List incompatibleGroups"
+description: "Retrieve a list of groups whose access rights are incompatible with a specific access package."
+localization_priority: Normal
+++
+# List incompatibleGroups
+
+Namespace: microsoft.graph
++
+Retrieve a list of the [group](../resources/group.md) objects that have been marked as incompatible on an [accessPackage](../resources/accesspackage.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) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+GET /identityGovernance/entitlementManagement/accessPackage/{id}/incompatibleGroups
+```
+
+## Optional query parameters
+
+This method supports the OData query parameters for server-side paging through a large response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+| Name |Description|
+|:-|:-|
+| Authorization | Bearer \{token\}. Required. |
+
+## 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 [group](../resources/group.md) objects in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_incompatiblegroups"
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackages/{id}/incompatibleGroups
+```
+
+### Response
+
+The following is an example of the response.
+
+> **Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.group",
+ "isCollection": true
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "value": [
+ {
+ "id": "a743348f-5667-41a4-89a3-5ad8a94da5d2",
+ "displayName": "group"
+ }
+ ]
+}
+```
+
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2019-02-04 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "List incompatibleGroups",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
+
v1.0 Accesspackage Post Incompatibleaccesspackage https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-post-incompatibleaccesspackage.md
+
+ Title: "Add accessPackage to incompatibleAccessPackages"
+description: "Add a link to indicate an access package is incompatible with a specified access package."
+localization_priority: Normal
+++
+# Add accessPackage to incompatibleAccessPackages
+
+Namespace: microsoft.graph
++
+Add an [accessPackage](../resources/accesspackage.md) to the list of access packages that have been marked as incompatible on an [accessPackage](../resources/accesspackage.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) | EntitlementManagement.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | EntitlementManagement.ReadWrite.All |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+POST /identityGovernance/entitlementManagement/accessPackages/{id}/incompatibleAccessPackages/$ref
+```
+
+## Request headers
+
+| Name | Description |
+|:--|:--|
+| Authorization | Bearer {token}. Required. |
+| Content-Type | application/json. Required. |
+
+## Request body
+
+In the request body, supply a JSON representation of a structure with the OData id of the URI of an [accessPackage](../resources/accesspackage.md) object.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "add_incompatibleaccesspackage_to_accesspackage"
+}-->
+```http
+POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackages/{id}/incompatibleAccessPackages/$ref
+Content-type: application/json
+
+{
+ "@odata.id": "https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackages/c0a74b4d-2694-4d5d-a964-1bee4ff0aaf2"
+}
+```
+
+### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response"
+} -->
+```http
+HTTP/1.1 204 Created
+```
+
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2019-02-04 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "Add incompatibleAccessPackage",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
+
v1.0 Accesspackage Post Incompatiblegroup https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-post-incompatiblegroup.md
+
+ Title: "Add group to incompatibleGroups"
+description: "Add a link to indicate a group is incompatible with a specified access package."
+localization_priority: Normal
+++
+# Add group to incompatibleGroups
+
+Namespace: microsoft.graph
++
+Add a [group](../resources/group.md) to the list of groups that have been marked as incompatible on an [accessPackage](../resources/accesspackage.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) | EntitlementManagement.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | EntitlementManagement.ReadWrite.All |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+POST /identityGovernance/entitlementManagement/accessPackages/{id}/incompatibleGroups/$ref
+```
+
+## Request headers
+
+| Name | Description |
+|:--|:--|
+| Authorization | Bearer {token}. Required. |
+| Content-Type | application/json. Required. |
+
+## Request body
+
+In the request body, supply a JSON representation of a structure with the OData id of the URI of a [group](../resources/group.md) object.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "add_incompatiblegroup_to_accesspackage"
+}-->
+```http
+POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackages/{id}/incompatibleGroups/$ref
+Content-type: application/json
+
+{
+ "@odata.id": "https://graph.microsoft.com/beta/groups/c0a74b4d-2694-4d5d-a964-1bee4ff0aaf2"
+}
+
+### Response
+
+The following is an example of the response.
+
+> **Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response"
+} -->
+```http
+HTTP/1.1 204 Created
+```
+
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2019-02-04 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "Add incompatibleGroup",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
+
v1.0 Accesspackage Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-post.md
Namespace: microsoft.graph
Create a new [accessPackage](../resources/accesspackage.md) object.
+The access package will be added to an existing [accessPackageCatalog](../resources/accesspackagecatalog.md). After the access package is created, you can then create [accessPackageAssignmentPolicies](../resources/accesspackageassignmentpolicy.md) which specify how users are assigned to the access package.
++ ## 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).
POST /identityGovernance/entitlementManagement/accessPackages
| Name | Description | |:--|:--| | Authorization | Bearer \{token\}. Required. |
-| Content-Type | application/json |
+| Content-type | application/json. Required. |
## Request body
-In the request body, supply a JSON representation of [accessPackage](../resources/accesspackage.md) object.
+In the request body, supply a JSON representation of an [accessPackage](../resources/accesspackage.md) object.
## Response
v1.0 Application List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-list.md
GET /applications
``` ## Optional query parameters
-This method supports the [OData query parameters](/graph/query-parameters) to help customize the response, including `$search`, `$count`, and `$filter`. You can use `$search` on the **displayName** property. When items are added or updated for this resource, they are specially indexed for use with the `$count` and `$search` query parameters. There can be a slight delay between when an item is added or updated and when it is available in the index.
+This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+ ## Request headers | Name | Description | |:- |:-- | | Authorization | Bearer {token}. Required. |
-| ConsistencyLevel | eventual. This header and `$count` are required when using `$search`, or when using `$filter` with the `$orderby` query parameter. It uses an index that may not be up-to-date with recent changes to the object. |
+| ConsistencyLevel | eventual. This header and `$count` are required when using `$search`, or in specific usage of `$filter`. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). |
## Request body
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$count` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- { "blockType": "ignored",
The following is an example of the response.
```http HTTP/1.1 200 OK Content-type: text/plain
-```
893
+```
### Example 3: Use $filter and $top to get one application with a display name that starts with 'a' including a count of returned objects #### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string because the request has both the `$orderBy` and `$filter` query parameters. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_a_count" }--> ```msgraph-interactive
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` and the `$count=true` query string is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_web_count" }--> ```msgraph-interactive
v1.0 B2cidentityuserflow Delete Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cidentityuserflow-delete-identityproviders.md
Title: "Delete identityProvider from a b2cIdentityUserFlow"
-description: "Delete an identityProvider from a b2cIdentityUserFlow."
+ Title: "Delete identityProvider from a b2cIdentityUserFlow (deprecated)"
+description: "Delete an identityProvider from a b2cIdentityUserFlow. (deprecated)"
localization_priority: Normal doc_type: apiPageType-+ ms.prod: "identity-and-sign-in"
-# Delete an identityProvider from a b2cIdentityUserFlow
+# Delete an identityProvider from a b2cIdentityUserFlow (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Delete an identity provider from a [b2cIdentityUserFlow](../resources/b2cidentityuserflow.md) object. For more information about identity providers available for user flows, see the [identityProviders](../resources/identityprovider.md) API reference.
If successful, this method returns a `204 No Content` response code. If unsucces
The following is an example of the request. -
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_b2xUserFlows_identityProviders_1"
The following is an example of the request.
``` http DELETE https://graph.microsoft.com/beta/identity/b2cUserFlows/B2C_1_CustomerSignUp/identityProviders/Facebook-OAUTH/$ref ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--- ### Response
The following is an example of the response.
```http HTTP/1.1 204 No Content ```--
v1.0 B2cidentityuserflow Delete Userflowidentityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cidentityuserflow-delete-userflowidentityproviders.md
+
+ Title: "Delete a userflowidentityproviders"
+description: "Delete an identityProvider from a b2cIdentityUserFlow."
+localization_priority: Normal
+++
+# Delete a userflowidentityproviders
+
+Namespace: microsoft.graph
++
+Delete an identity provider from a [b2cIdentityUserFlow](../resources/b2cidentityuserflow.md) object. For more information about identity providers available for user flows, see the [identityProviders](../resources/identityproviderbase.md) API reference.
+
+## 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)|IdentityUserFlow.ReadWrite.All|
+|Delegated (personal Microsoft account)| Not supported.|
+|Application| IdentityUserFlow.ReadWrite.All|
+
+The work or school account needs to belong to one of the following roles:
+
+* Global administrator
+* External ID user flow administrator
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+DELETE /identity/b2cUserFlows/{userflow-id}/userflowIdentityProviders/{identityProvider-id}/$ref
+```
+
+## Request headers
+
+|Name|Description|
+|:|:-|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code. If unsuccessful, a `4xx` error will be returned with specific details.
+
+## Example
+
+### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "delete_b2xUserFlows_userflowIdentityProviders"
+}
+-->
+
+``` http
+DELETE https://graph.microsoft.com/beta/identity/b2cUserFlows/B2C_test_signin_signup/userflowIdentityProviders/MSA-OIDC/$ref
+```
+
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+} -->
+
+```http
+HTTP/1.1 204 No Content
+```
v1.0 B2cidentityuserflow List Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cidentityuserflow-list-identityproviders.md
Title: "List all identityProviders in a b2cIdentityUserFlow"
-description: "List all identityProviders in a b2cIdentityUserFlow."
+ Title: "List all identityProviders in a b2cIdentityUserFlow (deprecated)"
+description: "List all identityProviders in a b2cIdentityUserFlow. (deprecated)"
localization_priority: Normal doc_type: apiPageType ms.prod: "identity-and-sign-in"
-# List all identityProviders in a b2cIdentityUserFlow
+# List all identityProviders in a b2cIdentityUserFlow (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Get the identity providers in a [b2cIdentityUserFlow](../resources/b2cidentityuserflow.md) object.
If successful, this method returns a `200 OK` response code and a JSON represent
The following is an example of the request. -
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_b2cUserFlow_list_identityProviders"
The following is an example of the request.
``` http GET https://graph.microsoft.com/beta/identity/b2cUserFlows/{id}/identityProviders ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--- ### Response
Content-type: application/json
] } ```--
v1.0 B2cidentityuserflow List Userflowidentityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cidentityuserflow-list-userflowidentityproviders.md
+
+ Title: "List a userflowidentityproviders"
+description: "List all identity providers in a b2cIdentityUserFlow."
+localization_priority: Normal
+++
+# List a userflowidentityproviders
+
+Namespace: microsoft.graph
++
+Get the identity providers in a [b2cIdentityUserFlow](../resources/b2cidentityuserflow.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)|IdentityUserFlow.ReadWrite.All|
+|Delegated (personal Microsoft account)| Not supported.|
+|Application| IdentityUserFlow.ReadWrite.All|
+
+The work or school account needs to belong to one of the following roles:
+
+* Global administrator
+* External ID user flow administrator
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+GET /identity/b2cUserFlows/{userflow-id}/userflowIdentityProviders
+```
+
+## Request headers
+
+|Name|Description|
+|:|:-|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a JSON representation of the [identityProviders](../resources/identityproviderbase.md) in the response body.
+
+## Example
+
+### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_b2cUserFlow_list_userflowidentityProviders"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/beta/identity/b2cUserFlows/B2C_test_signin_signup/userflowIdentityProviders
+```
+
+### Response
+
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.identityProviderBase"
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.identityProviderBase)",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.openIdConnectIdentityProvider",
+ "id": "OIDC-V1-AD_Test-3e393390-ed2d-4794-97f6-5c1a1ccc61f7",
+ "displayName": "OIDC AD Test",
+ "clientId": "fe1b1576-adca-4bef-b321-076fde19950b",
+ "clientSecret": "******",
+ "scope": "openid",
+ "metadataUrl": "https://login.microsoftonline.com/contoso.com/.well-known/openid-configuration",
+ "domainHint": "",
+ "responseType": "code",
+ "responseMode": "form_post",
+ "claimsMapping": {
+ "userId": "oid",
+ "displayName": "samuel",
+ "givenName": "samuel",
+ "surname": "emmense",
+ "email": "sam.e@contoso.com"
+ }
+ },
+ {
+ "@odata.type": "#microsoft.graph.socialIdentityProvider",
+ "id": "Apple-Managed-OIDC",
+ "displayName": "Sign in with Apple",
+ "identityProviderType": "AppleManaged",
+ "clientId": "com.contoso.client",
+ "clientSecret": "******"
+ },
+ {
+ "@odata.type": "#microsoft.graph.socialIdentityProvider",
+ "id": "MSA-OIDC",
+ "displayName": "Microsoft Account",
+ "identityProviderType": "Microsoft",
+ "clientId": "1e02ac8a-0c37-4046-abe4-35098a840090",
+ "clientSecret": "******"
+ },
+ {
+ "@odata.type": "#microsoft.graph.socialIdentityProvider",
+ "id": "Facebook-OAUTH",
+ "displayName": "Facebook",
+ "identityProviderType": "Facebook",
+ "clientId": "576628889930009",
+ "clientSecret": "******"
+ }
+ ]
+}
+```
v1.0 B2cidentityuserflow Post Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cidentityuserflow-post-identityproviders.md
Title: "Add identityProvider to a b2cIdentityUserFlow"
-description: "Add identityProvider to a b2cIdentityUserFlow."
+ Title: "Add identityProvider to a b2cIdentityUserFlow (deprecated)"
+description: "Add identityProvider to a b2cIdentityUserFlow. (deprecated)"
localization_priority: Normal doc_type: apiPageType-+ ms.prod: "identity-and-sign-in"
-# Add identityProvider to a b2cIdentityUserFlow
+# Add identityProvider to a b2cIdentityUserFlow (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Add identity providers in a [b2cIdentityUserFlow](../resources/b2cidentityuserflow.md) object.
If successful, this method returns a `204 No Content` response code. If unsucces
The following is an example of the request. -
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_b2cuserflows_identityprovider"
Content-length: 30
"@odata.id": "https://graph.microsoft.com/beta/identityProviders/{id}" } ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--- ### Response
v1.0 B2cidentityuserflow Userflowidentityproviders Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cidentityuserflow-userflowidentityproviders-update.md
+
+ Title: "Add a userFlowIdentityProvider"
+description: "Add an identityProvider to a b2cIdentityUserFlow."
+localization_priority: Normal
+++
+# Add a userFlowIdentityProvider
+
+Namespace: microsoft.graph
++
+Add an identity providers in a [b2cIdentityUserFlow](../resources/b2cidentityuserflow.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)|IdentityUserFlow.ReadWrite.All|
+|Delegated (personal Microsoft account)| Not supported.|
+|Application| IdentityUserFlow.ReadWrite.All|
+
+The work or school account needs to belong to one of the following roles:
+
+* Global administrator
+* External ID user flow administrator
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+PATCH /identity/b2cUserFlows/{userflow-id}/userflowIdentityProviders/$ref
+```
+
+## Request headers
+
+|Name|Description|
+|:|:-|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+In the request body, provide a JSON representation with the `id` of the [identityProvider](../resources/identityproviderbase.md) you want to add. For more information about identity providers available for user flows, see the [identityProviders](../resources/identityproviderbase.md) resource.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code. If unsuccessful, a `4xx` error is returned with the specific error details.
+
+## Example
+
+### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "update_b2cuserflows_userflowIdentityProviders"
+}
+-->
+
+``` http
+PATCH https://graph.microsoft.com/beta/identity/b2cUserFlows/B2C_test_signin_signup/userflowIdentityProviders/$ref
+Content-type: application/json
+
+{
+ "@odata.id": "https://graph.microsoft.com/beta/identity/identityProviders/{id}"
+}
+```
+
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+} -->
+
+```http
+HTTP/1.1 204 No Content
+```
v1.0 B2xidentityuserflow Delete Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2xidentityuserflow-delete-identityproviders.md
Title: "Delete identityProvider from b2xIdentityUserFlow"
-description: "Delete an identityProvider from a b2xIdentityUserFlow."
+ Title: "Delete identityProvider from b2xIdentityUserFlow (deprecated)"
+description: "Delete an identityProvider from a b2xIdentityUserFlow. (deprecated)"
localization_priority: Normal doc_type: apiPageType-+ ms.prod: "identity-and-sign-in"
-# Delete identityProvider from b2xIdentityUserFlow
+# Delete identityProvider from b2xIdentityUserFlow (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Delete an identity provider from a [b2xIdentityUserFlow](../resources/b2xidentityuserflow.md) object. For self-service sign up user flows, the values can be `Google-OAUTH` or `Facebook-OAUTH`.
If successful, this method returns a `204 No Content` response code. If unsucces
The following is an example of the request. -
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_b2xUserFlows_identityProviders_2"
The following is an example of the request.
``` http DELETE https://graph.microsoft.com/beta/identity/b2xUserFlows/B2X_1_PartnerSignUp/identityProviders/Facebook-OAUTH/$ref ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--- ### Response
The following is an example of the response.
```http HTTP/1.1 204 No Content ```--
v1.0 B2xidentityuserflow Delete Userflowidentityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2xidentityuserflow-delete-userflowidentityproviders.md
+
+ Title: "Delete a userFlowIdentityProvider"
+description: "Delete an identityProvider from a b2xIdentityUserFlow."
+localization_priority: Normal
+++
+# Delete a userFlowIdentityProvider
+
+Namespace: microsoft.graph
++
+Delete an identity provider from a [b2xIdentityUserFlow](../resources/b2xidentityuserflow.md) object. For self-service sign up user flows, the values can be `Google-OAUTH` or `Facebook-OAUTH`.
+
+## 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)|IdentityUserFlow.ReadWrite.All|
+|Delegated (personal Microsoft account)| Not supported.|
+|Application| IdentityUserFlow.ReadWrite.All|
+
+The work or school account needs to belong to one of the following roles:
+
+* Global administrator
+* External ID user flow administrator
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+DELETE/identity/b2xUserFlows/{userflow-id}/userflowIdentityProviders/{id}/$ref
+```
+
+## Request headers
+
+|Name|Description|
+|:|:-|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code. If unsuccessful, a `4xx` error is returned with the specific error details.
+
+## Example
+
+### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "delete_b2xUserFlows_userflowIdentityProviders"
+}
+-->
+
+``` http
+DELETE https://graph.microsoft.com/beta/identity/b2xUserFlows/{userflow-id}/userflowIdentityProviders/{identityProvider-id}/$ref
+```
+
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+} -->
+
+```http
+HTTP/1.1 204 No Content
+```
v1.0 B2xidentityuserflow List Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2xidentityuserflow-list-identityproviders.md
Title: "List all identityProviders in a b2xIdentityUserFlow"
-description: "List all identityProviders in a b2xIdentityUserFlow."
+ Title: "List all identityProviders in a b2xIdentityUserFlow (deprecated)"
+description: "List all identityProviders in a b2xIdentityUserFlow (deprecated)."
localization_priority: Normal doc_type: apiPageType-+ ms.prod: "identity-and-sign-in"
-# List all identityProviders in a b2xIdentityUserFlow
+# List all identityProviders in a b2xIdentityUserFlow (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Get the identity providers in a [b2xIdentityUserFlow](../resources/b2xidentityuserflow.md) object.
If successful, this method returns a `200 OK` response code and a JSON represent
The following is an example of the request. -
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_b2xUserFlow_list_identityProviders"
The following is an example of the request.
``` http GET https://graph.microsoft.com/beta/identity/b2xUserFlows/{id}/identityProviders ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--- ### Response
Content-type: application/json
] } ```--
v1.0 B2xidentityuserflow List Userflowidentityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2xidentityuserflow-list-userflowidentityproviders.md
+
+ Title: "List a userflowidentityproviders"
+description: "List all identityProviders in a b2xIdentityUserFlow."
+localization_priority: Normal
+++
+# List a userflowidentityproviders
+
+Namespace: microsoft.graph
++
+Get the identity providers in a [b2xIdentityUserFlow](../resources/b2xidentityuserflow.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)|IdentityUserFlow.ReadWrite.All|
+|Delegated (personal Microsoft account)| Not supported.|
+|Application| IdentityUserFlow.ReadWrite.All|
+
+The work or school account needs to belong to one of the following roles:
+
+* Global administrator
+* External ID user flow administrator
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+GET /identity/b2xUserFlows/{userflow-id}/userflowIdentityProviders
+```
+
+## Request headers
+
+|Name|Description|
+|:|:-|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a JSON representation of the [identityProviders](../resources/identityproviderbase.md) in the response body.
+
+## Example
+
+### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_b2xUserFlow_list_userflowIdentityProviders"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/beta/identity/b2xUserFlows/B2X_1_Test/userflowIdentityProviders
+```
+
+### Response
+
+The following is an example of the response.
+
+**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.identityProviderBase"
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.identityProviderBase)",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.builtInIdentityProvider",
+ "id": "AADSignup-OAUTH",
+ "displayName": "Azure Active Directory Sign up",
+ "identityProviderType": "AADSignup"
+ },
+ {
+ "@odata.type": "#microsoft.graph.builtInIdentityProvider",
+ "id": "MSASignup-OAUTH",
+ "displayName": "Microsoft Account (Preview)",
+ "identityProviderType": "MicrosoftAccount"
+ },
+ {
+ "@odata.type": "#microsoft.graph.builtInIdentityProvider",
+ "id": "EmailOtpSignup-OAUTH",
+ "displayName": "Email one-time passcode (Preview)",
+ "identityProviderType": "EmailOTP"
+ },
+ {
+ "@odata.type": "#microsoft.graph.socialIdentityProvider",
+ "id": "Facebook-OAUTH",
+ "displayName": "Facebook",
+ "identityProviderType": "Facebook",
+ "clientId": "clientIdFromFacebook",
+ "clientSecret": "******"
+ },
+ {
+ "@odata.type": "#microsoft.graph.socialIdentityProvider",
+ "id": "Google-OAuth",
+ "type": "Google",
+ "name": "Google",
+ "clientId": "clientIdFromGoogle",
+ "clientSecret": "*****"
+ }
+ ]
+}
+
+```
v1.0 B2xidentityuserflow Post Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2xidentityuserflow-post-identityproviders.md
Title: "Add identityProvider to a b2xIdentityUserFlow"
-description: "Add identityProvider in a b2xIdentityUserFlow."
+ Title: "Add identityProvider to a b2xIdentityUserFlow (deprecated)"
+description: "Add identityProvider in a b2xIdentityUserFlow (deprecated)."
localization_priority: Normal doc_type: apiPageType-+ ms.prod: "identity-and-sign-in"
-# Add identityProvider to a b2xIdentityUserFlow
+# Add identityProvider to a b2xIdentityUserFlow (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Update the identity providers in a [b2xIdentityUserFlow](../resources/b2xidentityuserflow.md) object.
If successful, this method returns a `204 No Content` response code. If unsucces
The following is an example of the request. -
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_b2xuserflows_identityprovider"
Content-length: 30
"@odata.id": "https://graph.microsoft.com/beta/identityProviders/{id}" } ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--- ### Response
The following is an example of the response.
```http HTTP/1.1 204 No Content ```--
v1.0 B2xidentityuserflow Userflowidentityproviders Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2xidentityuserflow-userflowidentityproviders-update.md
+
+ Title: "Update a userFlowIdentityProvider"
+description: "Update an identityProvider in a b2xIdentityUserFlow."
+localization_priority: Normal
+++
+# Update a userFlowIdentityProvider
+
+Namespace: microsoft.graph
++
+Update an identity providers in a [b2xIdentityUserFlow](../resources/b2xidentityuserflow.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)|IdentityUserFlow.ReadWrite.All|
+|Delegated (personal Microsoft account)| Not supported.|
+|Application| IdentityUserFlow.ReadWrite.All|
+
+The work or school account needs to belong to one of the following roles:
+
+* Global administrator
+* External ID user flow administrator
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+PATCH /identity/b2xUserFlows/{userflow-id}/userflowIdentityProviders/$ref
+```
+
+## Request headers
+
+|Name|Description|
+|:|:-|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+In the request body, provide a JSON representation with the `id` of the [identityProvider](../resources/identityproviderbase.md) you want to add. For self-service sign up user flows, the values can be `Google-OAUTH` or `Facebook-OAUTH`.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code. If unsuccessful, a `4xx` error is returned with the specific error details.
+
+## Example
+
+### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "update_b2xuserflows_userflowidentityprovider"
+}
+-->
+
+``` http
+PATCH https://graph.microsoft.com/beta/identity/b2xUserFlows/B2X_1_Test/userflowIdentityProviders/$ref
+Content-type: application/json
+
+{
+ "@odata.id": "https://graph.microsoft.com/beta/identity/identityProviders/B2X_1_Test"
+}
+```
+
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+} -->
+
+```http
+HTTP/1.1 204 No Content
+```
v1.0 Chat Post Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-post-members.md
content-type: application/json
{ "@odata.type": "#microsoft.graph.aadUserConversationMember", "user@odata.bind": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5",
- "visibleHistoryStartDateTime": "2019-04-18T23:51:43.255Z"
+ "visibleHistoryStartDateTime": "2019-04-18T23:51:43.255Z",
+ "roles": ["owner"]
} ``` # [JavaScript](#tab/javascript)
Content-type: application/json
{ "@odata.type": "#microsoft.graph.aadUserConversationMember",
- "user@odata.bind": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5"
+ "user@odata.bind": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "roles": ["owner"]
} ```
content-type: application/json
{ "@odata.type": "#microsoft.graph.aadUserConversationMember", "user@odata.bind": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5",
- "visibleHistoryStartDateTime": "0001-01-01T00:00:00Z"
+ "visibleHistoryStartDateTime": "0001-01-01T00:00:00Z",
+ "roles": ["owner"]
} ``` # [JavaScript](#tab/javascript)
v1.0 Chatmessage Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chatmessage-post.md
Content-type: application/json
} ```
+### Example 7 : @mention a channel in a channel message
+
+#### Request
+The following is an example of the request. For information about how to get a list of channels in a team, see [List channels](../api/channel-list.md).
+
+> Note: **conversationIdentityType** must be set to `channel` to @mention a channel.
+
+<!-- {
+ "blockType": "request",
+ "name": "post_chatmessage_atmentionchannel"
+}-->
+```http
+POST https://graph.microsoft.com/beta/teams/68a3e365-f7d9-4a56-b499-24332a9cc572/channels/19:0b50940236084d258c97b21bd01917b0@thread.skype/messages
+Content-type: application/json
+
+{
+ "body": {
+ "contentType": "html",
+ "content": "<div><div><at id=\"0\">General</at>&nbsp;Hello there!</div></div>"
+ },
+ "mentions": [
+ {
+ "id": 0,
+ "mentionText": "General",
+ "mentioned": {
+ "conversation": {
+ "id": "19:0b50940236084d258c97b21bd01917b0@thread.skype",
+ "displayName": "General",
+ "conversationIdentityType": "channel"
+ }
+ }
+ }
+ ]
+}
+```
+
+#### Response
+
+The following is an example of 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/beta/$metadata#teams('68a3e365-f7d9-4a56-b499-24332a9cc572')/channels('19%3A0b50940236084d258c97b21bd01917b0%40thread.skype')/messages/$entity",
+ "id": "1625727486746",
+ "replyToId": null,
+ "etag": "1625727486746",
+ "messageType": "message",
+ "createdDateTime": "2021-07-08T06:58:06.746Z",
+ "lastModifiedDateTime": "2021-07-08T06:58:06.746Z",
+ "lastEditedDateTime": null,
+ "deletedDateTime": null,
+ "subject": null,
+ "summary": null,
+ "chatId": null,
+ "importance": "normal",
+ "locale": "en-us",
+ "webUrl": "https://teams.microsoft.com/l/message/19%3A0b50940236084d258c97b21bd01917b0%40thread.skype/1625727486746?groupId=68a3e365-f7d9-4a56-b499-24332a9cc572&tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34&createdTime=1625727486746&parentMessageId=1625727486746",
+ "policyViolation": null,
+ "eventDetail": null,
+ "from": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "8ea0e38b-efb3-4757-924a-5f94061cf8c2",
+ "displayName": "Robin Kline",
+ "userIdentityType": "aadUser"
+ }
+ },
+ "body": {
+ "contentType": "html",
+ "content": "<div><div><at id=\"0\">General</at>&nbsp;Hello there!</div></div>"
+ },
+ "channelIdentity": {
+ "teamId": "68a3e365-f7d9-4a56-b499-24332a9cc572",
+ "channelId": "19:0b50940236084d258c97b21bd01917b0@thread.skype"
+ },
+ "attachments": [],
+ "mentions": [
+ {
+ "id": 0,
+ "mentionText": "General",
+ "mentioned": {
+ "application": null,
+ "device": null,
+ "user": null,
+ "tag": null,
+ "conversation": {
+ "id": "19:0b50940236084d258c97b21bd01917b0@thread.skype",
+ "displayName": "General",
+ "conversationIdentityType": "channel"
+ }
+ }
+ }
+ ],
+ "reactions": []
+}
+```
+
+### Example 8 : @mention a team in a channel message
+
+#### Request
+The following is an example of the request.
+
+> Note: **conversationIdentityType** must be set to `team` to @mention a team.
+
+<!-- {
+ "blockType": "request",
+ "name": "post_chatmessage_atmentionteam"
+}-->
+```http
+POST https://graph.microsoft.com/beta/teams/68a3e365-f7d9-4a56-b499-24332a9cc572/channels/19:0b50940236084d258c97b21bd01917b0@thread.skype/messages
+Content-type: application/json
+
+{
+ "body": {
+ "contentType": "html",
+ "content": "<div><div><at id=\"0\">GraphTesting</at>&nbsp;Hello team</div></div>"
+ },
+ "mentions": [
+ {
+ "id": 0,
+ "mentionText": "GraphTesting",
+ "mentioned": {
+ "conversation": {
+ "id": "68a3e365-f7d9-4a56-b499-24332a9cc572",
+ "displayName": "GraphTesting",
+ "conversationIdentityType": "team"
+ }
+ }
+ }
+ ],
+ "reactions": []
+}
+```
+
+#### Response
+
+The following is an example of 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/beta/$metadata#teams('68a3e365-f7d9-4a56-b499-24332a9cc572')/channels('19%3A0b50940236084d258c97b21bd01917b0%40thread.skype')/messages/$entity",
+ "id": "1625727671938",
+ "replyToId": null,
+ "etag": "1625727671938",
+ "messageType": "message",
+ "createdDateTime": "2021-07-08T07:01:11.938Z",
+ "lastModifiedDateTime": "2021-07-08T07:01:11.938Z",
+ "lastEditedDateTime": null,
+ "deletedDateTime": null,
+ "subject": null,
+ "summary": null,
+ "chatId": null,
+ "importance": "normal",
+ "locale": "en-us",
+ "webUrl": "https://teams.microsoft.com/l/message/19%3A0b50940236084d258c97b21bd01917b0%40thread.skype/1625727671938?groupId=68a3e365-f7d9-4a56-b499-24332a9cc572&tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34&createdTime=1625727671938&parentMessageId=1625727671938",
+ "policyViolation": null,
+ "eventDetail": null,
+ "from": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "8ea0e38b-efb3-4757-924a-5f94061cf8c2",
+ "displayName": "Robin Kline",
+ "userIdentityType": "aadUser"
+ }
+ },
+ "body": {
+ "contentType": "html",
+ "content": "<div><div><at id=\"0\">GraphTesting</at>&nbsp;Hello team</div></div>"
+ },
+ "channelIdentity": {
+ "teamId": "68a3e365-f7d9-4a56-b499-24332a9cc572",
+ "channelId": "19:0b50940236084d258c97b21bd01917b0@thread.skype"
+ },
+ "attachments": [],
+ "mentions": [
+ {
+ "id": 0,
+ "mentionText": "GraphTesting",
+ "mentioned": {
+ "application": null,
+ "device": null,
+ "user": null,
+ "tag": null,
+ "conversation": {
+ "id": "68a3e365-f7d9-4a56-b499-24332a9cc572",
+ "displayName": "GraphTesting",
+ "conversationIdentityType": "team"
+ }
+ }
+ }
+ ],
+ "reactions": []
+}
+```
+
+### Example 9 : @mention a tag in a channel message
+
+#### Request
+The following is an example of the request. For information about how to get a list of tags in a team, see [List teamworkTags](../api/teamworktag-list.md).
+
+<!-- {
+ "blockType": "request",
+ "name": "post_chatmessage_atmentiontag"
+}-->
+```http
+POST https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/channels/19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2/messages
+Content-type: application/json
+
+{
+ "body": {
+ "contentType": "html",
+ "content": "<div><div><at id=\"0\">TestTag</at>&nbsp;Testing Tags</div></div>"
+ },
+ "mentions": [
+ {
+ "id": 0,
+ "mentionText": "TestTag",
+ "mentioned": {
+ "tag": {
+ "id": "MjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyM2OGEzZTM2NS1mN2Q5LTRhNTYtYjQ5OS0yNDMzMmE5Y2M1NzIjI3RTMERJZ1Z1ZQ==",
+ "displayName": "TestTag"
+ }
+ }
+ }
+ ]
+}
+```
+
+#### Response
+
+The following is an example of 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/beta/$metadata#teams('fbe2bf47-16c8-47cf-b4a5-4b9b187c508b')/channels('19%3A4a95f7d8db4c4e7fae857bcebe0623e6%40thread.tacv2')/messages/$entity",
+ "id": "1625726986373",
+ "replyToId": null,
+ "etag": "1625726986373",
+ "messageType": "message",
+ "createdDateTime": "2021-07-08T06:49:46.373Z",
+ "lastModifiedDateTime": "2021-07-08T06:49:46.373Z",
+ "lastEditedDateTime": null,
+ "deletedDateTime": null,
+ "subject": null,
+ "summary": null,
+ "chatId": null,
+ "importance": "normal",
+ "locale": "en-us",
+ "webUrl": "https://teams.microsoft.com/l/message/19%3A4a95f7d8db4c4e7fae857bcebe0623e6%40thread.tacv2/1625726986373?groupId=fbe2bf47-16c8-47cf-b4a5-4b9b187c508b&tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34&createdTime=1625726986373&parentMessageId=1625726986373",
+ "policyViolation": null,
+ "eventDetail": null,
+ "from": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "8ea0e38b-efb3-4757-924a-5f94061cf8c2",
+ "displayName": "Robin Kline",
+ "userIdentityType": "aadUser"
+ }
+ },
+ "body": {
+ "contentType": "html",
+ "content": "<div><div><at id=\"0\">TestTag</at>&nbsp;Testing Tags</div></div>"
+ },
+ "channelIdentity": {
+ "teamId": "fbe2bf47-16c8-47cf-b4a5-4b9b187c508b",
+ "channelId": "19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2"
+ },
+ "attachments": [],
+ "mentions": [
+ {
+ "id": 0,
+ "mentionText": "TestTag",
+ "mentioned": {
+ "application": null,
+ "device": null,
+ "user": null,
+ "conversation": null,
+ "tag": {
+ "id": "MjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyM2OGEzZTM2NS1mN2Q5LTRhNTYtYjQ5OS0yNDMzMmE5Y2M1NzIjI3RTMERJZ1Z1ZQ==",
+ "displayName": "TestTag"
+ }
+ }
+ }
+ ],
+ "reactions": []
+}
+```
+ ## See also - [Cards reference](/microsoftteams/platform/concepts/cards/cards-reference)
v1.0 Contenttype List Columns https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contenttype-list-columns.md
GET https://graph.microsoft.com/beta/sites/{site-id}/contentTypes/{contentType-i
<!-- { "blockType": "response", "truncated": true,
- "@odata.type": "Collection(microsoft.graph.columnDefinition)"
+ "@odata.type": "microsoft.graph.columnDefinition",
+ "isCollection": true
} -->
v1.0 Contenttype Post Columns https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contenttype-post-columns.md
POST https://graph.microsoft.com/beta/sites/{site-id}/contentTypes/{contentType-
Content-Type: application/json {
- "sourceColumn@odata.bind": "https://graph.microsoft.com/beta/sites/root/columns/99ddcf45-e2f7-4f17-82b0-6fba34445103",
+ "sourceColumn@odata.bind": "https://graph.microsoft.com/beta/sites/root/columns/99ddcf45-e2f7-4f17-82b0-6fba34445103"
} ```
v1.0 Device List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/device-list.md
GET /devices
## Optional query parameters
-This method supports the [OData query parameters](/graph/query_parameters) to help customize the response, including `$search`, `$count`, and `$filter`. You can use `$search` on the **displayName** property. When items are added or updated for this resource, they are specially indexed for use with the `$count` and `$search` query parameters. There can be a slight delay between when an item is added or updated and when it is available in the index.
+This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
## Request headers | Name | Description | |:- |:-- | | Authorization | Bearer {token}. Required. |
-| ConsistencyLevel | eventual. This header and `$count` are required when using `$search`, or when using `$filter` with the `$orderby` query parameter. It uses an index that may not be up-to-date with recent changes to the object. |
+| ConsistencyLevel | eventual. This header and `$count` are required when using `$search`, or in specific usage of `$filter`. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). |
## Request body
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$count` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- { "blockType": "ignored",
Content-type: text/plain
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string because the request has both the `$orderBy` and `$filter` query parameters. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- { "blockType": "ignored",
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` and the `$count=true` query string is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+ <!-- { "blockType": "ignored",
v1.0 Group List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-list.md
GET /groups
## Optional query parameters
+This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+ To list only Microsoft 365 groups (aka unified groups), apply a filter on **groupTypes**: <!-- { "blockType": "ignored" } --> ```http GET https://graph.microsoft.com/beta/groups?$filter=groupTypes/any(c:c+eq+'Unified') ```
-You can use the OData query option `$orderby` to sort groups in an organization by the **displayName**
-values, as shown in the following example:
-<!-- { "blockType": "ignored" } -->
-```http
-GET https://graph.microsoft.com/beta/groups?$orderby=displayName
-```
-You can also use the `$count` and `$search` query parameters to limit the response. The `$search` query parameter supports tokenization only on the **displayName** and **description** fields. Other fields default to `$filter` behavior. When items are added or updated for this resource, they are specially indexed for use with the `$count` and `$search` query parameters. There can be a slight delay between when an item is added or updated and when it is available in the index.
+The `$search` query parameter supports tokenization only on the **displayName** and **description** fields and requires the **ConsistencyLevel** header. Fields other than **displayName** and **description** default to `$filter` `startswith` behavior.
-For more information, see [OData query parameters](/graph/query-parameters).
+For more information on OData query options, see [OData query parameters](/graph/query-parameters). For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
## Request headers | Name | Description | |:- |:-- | | Authorization | Bearer {token}. Required. |
-| ConsistencyLevel | eventual. This header and `$count` are required when using `$search`, or when using `$filter` with the `$orderby` query parameter. It uses an index that may not be up-to-date with recent changes to the object. |
+| ConsistencyLevel | eventual. This header and `$count` are required when using `$search`, or in specific usage of `$filter`. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). |
## Request body
Content-type: application/json
#### Request
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$count` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+ <!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_groups_withlicenseerrors_count" }--> ```msgraph-interactive
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$count` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- { "blockType": "ignored",
Content-type: text/plain
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string because the request has both the `$orderBy` and `$filter` query parameters. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_a_count" }--> ```msgraph-interactive
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_video_count" }--> ```msgraph-interactive
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_video_count" }--> ```msgraph-interactive
v1.0 Managedtenants Cloudpcconnection Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-cloudpcconnection-get.md
+
+ Title: "Get cloudPcConnection"
+description: "Read the properties and relationships of a cloudPcConnection object."
+
+localization_priority: Normal
++
+# Get cloudPcConnection
+Namespace: microsoft.graph.managedTenants
++
+Read the properties and relationships of a [cloudPcConnection](../resources/managedtenants-cloudpcconnection.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)|CloudPC.Read.All, CloudPC.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/cloudPcConnections/{cloudPcConnectionId}
+```
+
+## Optional query parameters
+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.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [cloudPcConnection](../resources/managedtenants-cloudpcconnection.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "sampleKeys": ["86789ee0-e31d-4bee-98e6-6f310bd327bb"],
+ "name": "get_cloudpcconnection"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/cloudPcConnections/86789ee0-e31d-4bee-98e6-6f310bd327bb
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.cloudPcConnection"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.managedTenants.cloudPcConnection",
+ "id": "86789ee0-e31d-4bee-98e6-6f310bd327bb",
+ "lastUpdated": "2021-07-11T15:46:28.1243279Z",
+ "displayName": "Az-Connection-93ac6d62-7d78-4477-bd43-db5e2013864d",
+ "healthCheckStatus": "Failed",
+ "tenantId": "aa060093-1e81-45b4-bebc-652713194ef7",
+ "tenantDisplayName": "Lucerne Publishing",
+ "lastRefreshedDateTime": "2021-07-11T15:46:28.1243279Z"
+}
+```
v1.0 Managedtenants Cloudpcdevice Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-cloudpcdevice-get.md
+
+ Title: "Get cloudPcDevice"
+description: "Read the properties and relationships of a cloudPcDevice object."
+
+localization_priority: Normal
++
+# Get cloudPcDevice
+Namespace: microsoft.graph.managedTenants
++
+Read the properties and relationships of a [cloudPcDevice](../resources/managedtenants-cloudpcdevice.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)|CloudPC.Read.All, CloudPC.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/cloudPcDevices/{cloudPcDeviceId}
+```
+
+## Optional query parameters
+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.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [cloudPcDevice](../resources/managedtenants-cloudpcdevice.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_cloudpcdevice"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/cloudPcDevices/{cloudPcDeviceId}
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.cloudPcDevice"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.managedTenants.cloudPcDevice",
+ "id": "1307ab1b-63ee-4942-bdef-bcd4f415c635",
+ "lastUpdated": "2021-07-10T23:05:03.2564744Z",
+ "policyId": "",
+ "displayName": "device01",
+ "managedDeviceId": "",
+ "managedDeviceName": "",
+ "userPrincipalName": "sally@lucernepublishing001.onmicrosoft.com",
+ "servicePlanName": "CloudPC_Standard",
+ "status": "NotProvisioned",
+ "tenantId": "aa060093-1e81-45b4-bebc-652713194ef7",
+ "tenantDisplayName": "Lucerne Publishing",
+ "lastRefreshedDateTime": "2021-07-10T23:05:03.2564744Z",
+ "provisioningPolicyId": "",
+ "cloudPcStatus": "NotProvisioned"
+}
+```
v1.0 Managedtenants Cloudpcoverview Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-cloudpcoverview-get.md
+
+ Title: "Get cloudPcOverview"
+description: "Read the properties and relationships of a cloudPcOverview object."
+
+localization_priority: Normal
++
+# Get cloudPcOverview
+Namespace: microsoft.graph.managedTenants
++
+Read the properties and relationships of a [cloudPcOverview](../resources/managedtenants-cloudpcoverview.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)|CloudPC.Read.All, CloudPC.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/cloudPcsOverview/{cloudPcOverviewId}
+```
+
+## Optional query parameters
+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.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [cloudPcOverview](../resources/managedtenants-cloudpcoverview.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_cloudpcoverview"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/cloudPcsOverview/{cloudPcOverviewId}
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.cloudPcOverview"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.managedTenants.cloudPcOverview",
+ "id": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantDisplayName": "Fourth Coffee",
+ "totalCloudPcStatus": 18,
+ "numberOfCloudPcStatusNotProvisioned": 4,
+ "numberOfCloudPcStatusProvisioning": 0,
+ "numberOfCloudPcStatusProvisioned": 14,
+ "numberOfCloudPcStatusUpgrading": 0,
+ "numberOfCloudPcStatusInGracePeriod": 0,
+ "numberOfCloudPcStatusDeprovisioning": 0,
+ "numberOfCloudPcStatusFailed": 0,
+ "numberOfCloudPcStatusUnknown": 0,
+ "totalCloudPcConnectionStatus": 25,
+ "numberOfCloudPcConnectionStatusPending": 0,
+ "numberOfCloudPcConnectionStatusRunning": 0,
+ "numberOfCloudPcConnectionStatusPassed": 17,
+ "numberOfCloudPcConnectionStatusFailed": 6,
+ "numberOfCloudPcConnectionStatusUnkownFutureValue": 0,
+ "lastRefreshedDateTime": "2021-07-11T17:18:46.4830816Z"
+}
+```
v1.0 Managedtenants Conditionalaccesspolicycoverage Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-conditionalaccesspolicycoverage-get.md
+
+ Title: "Get conditionalAccessPolicyCoverage"
+description: "Read the properties and relationships of a conditionalAccessPolicyCoverage object."
+
+localization_priority: Normal
++
+# Get conditionalAccessPolicyCoverage
+Namespace: microsoft.graph.managedTenants
++
+Read the properties and relationships of a [conditionalAccessPolicyCoverage](../resources/managedtenants-conditionalaccesspolicycoverage.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)|Policy.Read.All, Policy.ReadWrite.ConditionalAccess, and Application.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/conditionalAccessPolicyCoverages/{conditionalAccessPolicyCoverageId}
+```
+
+## Optional query parameters
+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.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [conditionalAccessPolicyCoverage](../resources/managedtenants-conditionalaccesspolicycoverage.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_conditionalaccesspolicycoverage"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/conditionalAccessPolicyCoverages/{conditionalAccessPolicyCoverageId}
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.conditionalAccessPolicyCoverage"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.managedTenants.conditionalAccessPolicyCoverage",
+ "id": "38227791-a88b-4fcc-81c5-58cf77668320",
+ "conditionalAccessPolicyState": "enabled",
+ "requiresDeviceCompliance": false,
+ "latestPolicyModifiedDateTime": "2021-07-11T14:56:13.598304Z",
+ "tenantDisplayName": "Consolidated Messenger"
+}
+```
v1.0 Managedtenants Credentialuserregistrationssummary Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-credentialuserregistrationssummary-get.md
+
+ Title: "Get credentialUserRegistrationsSummary"
+description: "Read the properties and relationships of a credentialUserRegistrationsSummary object."
+
+localization_priority: Normal
++
+# Get credentialUserRegistrationsSummary
+Namespace: microsoft.graph.managedTenants
++
+Read the properties and relationships of a [credentialUserRegistrationsSummary](../resources/managedtenants-credentialuserregistrationssummary.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)|Reports.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/credentialUserRegistrationsSummaries/{credentialUserRegistrationsSummaryId}
+```
+
+## Optional query parameters
+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.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [credentialUserRegistrationsSummary](../resources/managedtenants-credentialuserregistrationssummary.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_credentialuserregistrationssummary"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/credentialUserRegistrationsSummaries/{credentialUserRegistrationsSummaryId}
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.credentialUserRegistrationsSummary"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.managedTenants.credentialUserRegistrationsSummary",
+ "id": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "mfaAndSsprCapableUserCount": 0,
+ "ssprEnabledUserCount": 1,
+ "mfaRegisteredUserCount": 0,
+ "ssprRegisteredUserCount": 0,
+ "totalUserCount": 7,
+ "securityDefaultsEnabled": false,
+ "mfaConditionalAccessPolicyState": "enabledForReportingButNotEnforced",
+ "lastRefreshedDateTime": "2021-07-11T11:15:52.9375367Z",
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantDisplayName": "Fourth Coffee"
+}
+```
v1.0 Managedtenants Devicecompliancepolicysettingstatesummary Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-devicecompliancepolicysettingstatesummary-get.md
+
+ Title: "Get deviceCompliancePolicySettingStateSummary"
+description: "Read the properties and relationships of a deviceCompliancePolicySettingStateSummary object."
+
+localization_priority: Normal
++
+# Get deviceCompliancePolicySettingStateSummary
+Namespace: microsoft.graph.managedTenants
++
+Read the properties and relationships of a [deviceCompliancePolicySettingStateSummary](../resources/managedtenants-devicecompliancepolicysettingstatesummary.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|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/deviceCompliancePolicySettingStateSummarys/{deviceCompliancePolicySettingStateSummaryId}
+```
+
+## Optional query parameters
+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.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [deviceCompliancePolicySettingStateSummary](../resources/managedtenants-devicecompliancepolicysettingstatesummary.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_devicecompliancepolicysettingstatesummary"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/deviceCompliancePolicySettingStateSummarys/{deviceCompliancePolicySettingStateSummaryId}
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.deviceCompliancePolicySettingStateSummary"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.managedTenants.deviceCompliancePolicySettingStateSummary",
+ "id": "34298981-4fc8-4974-9486-c8909ed1521b_277f9230-81f7-ffc3-af78-4662ec3dca09",
+ "intuneAccountId": "6f3e6534-b466-4fac-9a31-4c305cc40833",
+ "intuneSettingId": "277f9230-81f7-ffc3-af78-4662ec3dca09",
+ "policyType": "DefaultDeviceCompliancePolicy",
+ "settingName": "RequireDeviceCompliancePolicyAssigned",
+ "failedDeviceCount": 0,
+ "errorDeviceCount": 4,
+ "conflictDeviceCount": 0,
+ "lastRefreshedDateTime": "2021-07-11T00:00:00Z",
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantDisplayName": "Fourth Coffee"
+}
+```
v1.0 Managedtenants Manageddevicecompliance Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-manageddevicecompliance-get.md
+
+ Title: "Get managedDeviceCompliance"
+description: "Read the properties and relationships of a managedDeviceCompliance object."
+
+localization_priority: Normal
++
+# Get managedDeviceCompliance
+Namespace: microsoft.graph.managedTenants
++
+Read the properties and relationships of a [managedDeviceCompliance](../resources/managedtenants-manageddevicecompliance.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)|DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/managedDeviceCompliances/{managedDeviceComplianceId}
+```
+
+## Optional query parameters
+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.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [managedDeviceCompliance](../resources/managedtenants-manageddevicecompliance.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_manageddevicecompliance"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/managedDeviceCompliances/{managedDeviceComplianceId}
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.managedDeviceCompliance"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/managedTenants/managedDeviceCompliances/$entity",
+ "id": "34298981-4fc8-4974-9486-c8909ed1521b_95378ac4-eded-4671-8fa2-4e42e5de3463",
+ "managedDeviceId": "95378ac4-eded-4671-8fa2-4e42e5de3463",
+ "managedDeviceName": "vm11",
+ "complianceStatus": "Compliant",
+ "osDescription": "Windows",
+ "osVersion": "10.0.19042.1083",
+ "lastSyncDateTime": "2021-07-09T14:41:21.9130091Z",
+ "ownerType": "Company",
+ "model": "Virtual Machine",
+ "manufacturer": "Microsoft Corporation",
+ "inGracePeriodUntilDateTime": "9999-12-31T23:59:59.9999999Z",
+ "lastRefreshedDateTime": "2021-07-11T07:12:41.0336556Z",
+ "deviceType": "WindowsRT",
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantDisplayName": "Fourth Coffee"
+}
+```
v1.0 Managedtenants Manageddevicecompliancetrend Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-manageddevicecompliancetrend-get.md
+
+ Title: "Get managedDeviceComplianceTrend"
+description: "Read the properties and relationships of a managedDeviceComplianceTrend object."
+
+localization_priority: Normal
++
+# Get managedDeviceComplianceTrend
+Namespace: microsoft.graph.managedTenants
++
+Read the properties and relationships of a [managedDeviceComplianceTrend](../resources/managedtenants-manageddevicecompliancetrend.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)|DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/managedDeviceComplianceTrends/{managedDeviceComplianceTrendId}
+```
+
+## Optional query parameters
+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.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [managedDeviceComplianceTrend](../resources/managedtenants-manageddevicecompliancetrend.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_manageddevicecompliancetrend"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/managedDeviceComplianceTrends/{managedDeviceComplianceTrendId}
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.managedDeviceComplianceTrend"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.managedTenants.managedDeviceComplianceTrend",
+ "id": "34298981-4fc8-4974-9486-c8909ed1521b_2021-07-11T00:00:00Z",
+ "tenantDisplayName": "Fourth Coffee",
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "unknownDeviceCount": 2,
+ "compliantDeviceCount": 0,
+ "noncompliantDeviceCount": 41,
+ "errorDeviceCount": 1,
+ "inGracePeriodDeviceCount": 0,
+ "configManagerDeviceCount": 0,
+ "totalDeviceCount": 44,
+ "countDateTime": "2021-07-11T00:00:00Z"
+}
+```
v1.0 Managedtenants Managedtenant List Aggregatedpolicycompliances https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managedtenant-list-aggregatedpolicycompliances.md
+
+ Title: "List aggregatedPolicyCompliances"
+description: "Get a list of the aggregatedPolicyCompliance objects and their properties."
+
+localization_priority: Normal
++
+# List aggregatedPolicyCompliances
+Namespace: microsoft.graph.managedTenants
++
+Get a list of the [aggregatedPolicyCompliance](../resources/managedtenants-aggregatedpolicycompliance.md) objects and their properties.
+
+## 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|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/aggregatedPolicyCompliances
+```
+
+## Optional query parameters
+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.|
+
+## 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 [aggregatedPolicyCompliance](../resources/managedtenants-aggregatedpolicycompliance.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_aggregatedpolicycompliance"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/aggregatedPolicyCompliances
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.aggregatedPolicyCompliance)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#aggregatedPolicyCompliances",
+ "value": [
+ {
+ "id": "34298981-4fc8-4974-9486-c8909ed1521b_19a8d6a6-d87e-4059-85b3-c73bfc5cea15",
+ "compliancePolicyId": "19a8d6a6-d87e-4059-85b3-c73bfc5cea15",
+ "compliancePolicyName": "Baseline - Setup Compliance Policy for Windows devices",
+ "compliancePolicyType": "Unknown",
+ "compliancePolicyPlatform": "Windows10",
+ "numberOfCompliantDevices": 0,
+ "numberOfNonCompliantDevices": 0,
+ "numberOfErrorDevices": 0,
+ "policyModifiedDateTime": "2021-06-22T17:01:46Z",
+ "lastRefreshedDateTime": "2021-07-11T01:02:33.4452876Z",
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantDisplayName": "Fourth Coffee"
+ },
+ {
+ "id": "34298981-4fc8-4974-9486-c8909ed1521b_3e4b612f-5ce0-42f6-9e21-a172adc5100d",
+ "compliancePolicyId": "3e4b612f-5ce0-42f6-9e21-a172adc5100d",
+ "compliancePolicyName": "Windows Level 2 Compliance Policy",
+ "compliancePolicyType": "Unknown",
+ "compliancePolicyPlatform": "Windows10",
+ "numberOfCompliantDevices": 4,
+ "numberOfNonCompliantDevices": 0,
+ "numberOfErrorDevices": 0,
+ "policyModifiedDateTime": "2021-04-20T22:27:20Z",
+ "lastRefreshedDateTime": "2021-07-11T01:02:33.4452876Z",
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantDisplayName": "Fourth Coffee"
+ }
+ ]
+}
+```
v1.0 Managedtenants Managedtenant List Cloudpcconnections https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managedtenant-list-cloudpcconnections.md
+
+ Title: "List cloudPcConnections"
+description: "Get a list of the cloudPcConnection objects and their properties."
+
+localization_priority: Normal
++
+# List cloudPcConnections
+Namespace: microsoft.graph.managedTenants
++
+Get a list of the [cloudPcConnection](../resources/managedtenants-cloudpcconnection.md) objects and their properties.
+
+## 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)|CloudPC.Read.All, CloudPC.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/cloudPcConnections
+```
+
+## Optional query parameters
+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.|
+
+## 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 [cloudPcConnection](../resources/managedtenants-cloudpcconnection.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_cloudpcconnection"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/cloudPcConnections
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.cloudPcConnection)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/managedTenants/cloudPcConnections",
+ "value": [
+ {
+ "id": "021bd3a9-59c6-4503-b408-c326a98f238f",
+ "lastUpdated": "2021-07-11T18:02:16.6450704Z",
+ "displayName": "RunnerPlus-Az-Connection",
+ "organizationId": "0b9701e1-f1ae-4f15-bd67-f4f591595454",
+ "organizationDisplayName": "Terra Firm",
+ "healthCheckStatus": "Passed",
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantDisplayName": "Fourth Coffee",
+ "lastRefreshedDateTime": "2021-07-11T18:02:16.6450704Z"
+ }
+ ]
+}
+```
v1.0 Managedtenants Managedtenant List Cloudpcdevices https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managedtenant-list-cloudpcdevices.md
+
+ Title: "List cloudPcDevices"
+description: "Get a list of the cloudPcDevice objects and their properties."
+
+localization_priority: Normal
++
+# List cloudPcDevices
+Namespace: microsoft.graph.managedTenants
++
+Get a list of the [cloudPcDevice](../resources/managedtenants-cloudpcdevice.md) objects and their properties.
+
+## 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)|CloudPC.Read.All, CloudPC.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/cloudPcDevices
+```
+
+## Optional query parameters
+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.|
+
+## 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 [cloudPcDevice](../resources/managedtenants-cloudpcdevice.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_cloudpcdevice"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/cloudPcDevices
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.cloudPcDevice)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "id": "00089754-92d2-483c-a073-420723aac8bc_6b97ad6a-be15-4cbe-afbb-4eb74ecb0243",
+ "lastUpdated": "2021-07-10T23:05:03.2565097Z",
+ "policyId": "2b142388-f36c-40ee-a5cb-7e8871a658a0",
+ "displayName": "ImageProd - ImageRunner4PROD",
+ "managedDeviceId": "f3a8e53b-0a9f-42f1-be73-4fd30d801f62",
+ "managedDeviceName": "A0000060000",
+ "userPrincipalName": "ImageRunner4PROD@fourthcoffee001.onmicrosoft.com",
+ "servicePlanName": "CloudPC_Lite",
+ "status": "Provisioned",
+ "tenantId": "aa060093-1e81-45b4-bebc-652713194ef7",
+ "tenantDisplayName": "Fourth Coffee Publishing",
+ "lastRefreshedDateTime": "2021-07-10T23:05:03.2565097Z",
+ "provisioningPolicyId": "2b142388-f36c-40ee-a5cb-7e8871a658a0",
+ "cloudPcStatus": "Provisioned"
+ }
+ ]
+}
+```
v1.0 Managedtenants Managedtenant List Cloudpcsoverview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managedtenant-list-cloudpcsoverview.md
+
+ Title: "List cloudPcOverviews"
+description: "Get a list of the cloudPcOverview objects and their properties."
+
+localization_priority: Normal
++
+# List cloudPcOverviews
+Namespace: microsoft.graph.managedTenants
++
+Get a list of the [cloudPcOverview](../resources/managedtenants-cloudpcoverview.md) objects and their properties.
+
+## 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)|CloudPC.Read.All, CloudPC.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/cloudPcsOverview
+```
+
+## Optional query parameters
+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.|
+
+## 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 [cloudPcOverview](../resources/managedtenants-cloudpcoverview.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_cloudpcoverview"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/cloudPcsOverview
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.cloudPcOverview)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.managedTenants.cloudPcOverview",
+ "id": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantDisplayName": "Fourth Coffee",
+ "totalCloudPcStatus": 18,
+ "numberOfCloudPcStatusNotProvisioned": 4,
+ "numberOfCloudPcStatusProvisioning": 0,
+ "numberOfCloudPcStatusProvisioned": 14,
+ "numberOfCloudPcStatusUpgrading": 0,
+ "numberOfCloudPcStatusInGracePeriod": 0,
+ "numberOfCloudPcStatusDeprovisioning": 0,
+ "numberOfCloudPcStatusFailed": 0,
+ "numberOfCloudPcStatusUnknown": 0,
+ "totalCloudPcConnectionStatus": 25,
+ "numberOfCloudPcConnectionStatusPending": 0,
+ "numberOfCloudPcConnectionStatusRunning": 0,
+ "numberOfCloudPcConnectionStatusPassed": 17,
+ "numberOfCloudPcConnectionStatusFailed": 6,
+ "numberOfCloudPcConnectionStatusUnkownFutureValue": 0,
+ "lastRefreshedDateTime": "2021-07-11T17:18:46.4830816Z"
+ }
+ ]
+}
+```
v1.0 Managedtenants Managedtenant List Conditionalaccesspolicycoverages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managedtenant-list-conditionalaccesspolicycoverages.md
+
+ Title: "List conditionalAccessPolicyCoverages"
+description: "Get a list of the conditionalAccessPolicyCoverage objects and their properties."
+
+localization_priority: Normal
++
+# List conditionalAccessPolicyCoverages
+Namespace: microsoft.graph.managedTenants
++
+Get a list of the [conditionalAccessPolicyCoverage](../resources/managedtenants-conditionalaccesspolicycoverage.md) objects and their properties. Use this operation to list of Azure Active Directory conditional access policy coverage across all tenants that are being managed by the multi-tenant management platform.
+
+## 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)|Policy.Read.All, Policy.ReadWrite.ConditionalAccess, and Application.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/conditionalAccessPolicyCoverages
+```
+
+## Optional query parameters
+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.|
+
+## 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 [conditionalAccessPolicyCoverage](../resources/managedtenants-conditionalaccesspolicycoverage.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_conditionalaccesspolicycoverage"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/conditionalAccessPolicyCoverages
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.conditionalAccessPolicyCoverage)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.managedTenants.conditionalAccessPolicyCoverage",
+ "id": "38227791-a88b-4fcc-81c5-58cf77668320",
+ "conditionalAccessPolicyState": "enabled",
+ "requiresDeviceCompliance": false,
+ "latestPolicyModifiedDateTime": "2021-07-11T14:56:13.598304Z",
+ "tenantDisplayName": "Consolidated Messenger"
+ }
+ ]
+}
+```
v1.0 Managedtenants Managedtenant List Credentialuserregistrationssummaries https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managedtenant-list-credentialuserregistrationssummaries.md
+
+ Title: "List credentialUserRegistrationsSummaries"
+description: "Get a list of the credentialUserRegistrationsSummary objects and their properties."
+
+localization_priority: Normal
++
+# List credentialUserRegistrationsSummaries
+Namespace: microsoft.graph.managedTenants
++
+Get a list of the [credentialUserRegistrationsSummary](../resources/managedtenants-credentialuserregistrationssummary.md) objects and their properties.
+
+## 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)|Reports.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/credentialUserRegistrationsSummaries
+```
+
+## Optional query parameters
+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.|
+
+## 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 [credentialUserRegistrationsSummary](../resources/managedtenants-credentialuserregistrationssummary.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_credentialuserregistrationssummary"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/credentialUserRegistrationsSummaries
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.credentialUserRegistrationsSummary)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#credentialUserRegistrationsSummaries",
+ "value": [
+ {
+ "id": "38227791-a88b-4fcc-81c5-58cf77668320",
+ "mfaAndSsprCapableUserCount": 2,
+ "ssprEnabledUserCount": 9,
+ "mfaRegisteredUserCount": 3,
+ "ssprRegisteredUserCount": 2,
+ "totalUserCount": 9,
+ "securityDefaultsEnabled": false,
+ "mfaConditionalAccessPolicyState": "enabled",
+ "lastRefreshedDateTime": "2021-07-11T09:58:11.5730661Z",
+ "tenantId": "38227791-a88b-4fcc-81c5-58cf77668320",
+ "tenantDisplayName": "Consolidated Messenger"
+ },
+ {
+ "id": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "mfaAndSsprCapableUserCount": 0,
+ "ssprEnabledUserCount": 1,
+ "mfaRegisteredUserCount": 0,
+ "ssprRegisteredUserCount": 0,
+ "totalUserCount": 7,
+ "securityDefaultsEnabled": false,
+ "mfaConditionalAccessPolicyState": "enabledForReportingButNotEnforced",
+ "lastRefreshedDateTime": "2021-07-11T11:15:52.9375367Z",
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantDisplayName": "Fourth Coffee"
+ }
+ ]
+}
+```
v1.0 Managedtenants Managedtenant List Devicecompliancepolicysettingstatesummary https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managedtenant-list-devicecompliancepolicysettingstatesummary.md
+
+ Title: "List deviceCompliancePolicySettingStateSummary"
+description: "Get a list of the deviceCompliancePolicySettingStateSummary objects and their properties."
+
+localization_priority: Normal
++
+# List deviceCompliancePolicySettingStateSummary
+Namespace: microsoft.graph.managedTenants
++
+Get a list of the [deviceCompliancePolicySettingStateSummary](../resources/managedtenants-devicecompliancepolicysettingstatesummary.md) objects and their properties.
+
+## 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)|DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/deviceCompliancePolicySettingStateSummary
+```
+
+## Optional query parameters
+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.|
+
+## 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 [deviceCompliancePolicySettingStateSummary](../resources/managedtenants-devicecompliancepolicysettingstatesummary.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_devicecompliancepolicysettingstatesummary"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/deviceCompliancePolicySettingStateSummary
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.deviceCompliancePolicySettingStateSummary)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.managedTenants.deviceCompliancePolicySettingStateSummary",
+ "id": "9f6922d9-5a58-4f4d-b6e3-708f7659e5b2",
+ "tenantId": "String",
+ "tenantDisplayName": "String",
+ "conflictDeviceCount": "Integer",
+ "errorDeviceCount": "Integer",
+ "failedDeviceCount": "Integer",
+ "intuneAccountId": "String",
+ "intuneSettingId": "String",
+ "notApplicableDeviceCount": "Integer",
+ "pendingDeviceCount": "Integer",
+ "policyType": "String",
+ "settingName": "String",
+ "succeededDeviceCount": "Integer",
+ "lastRefreshedDateTime": "String (timestamp)"
+ }
+ ]
+}
+```
v1.0 Managedtenants Managedtenant List Manageddevicecompliances https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managedtenant-list-manageddevicecompliances.md
+
+ Title: "List managedDeviceCompliances"
+description: "Get a list of the managedDeviceCompliance objects and their properties."
+
+localization_priority: Normal
++
+# List managedDeviceCompliances
+Namespace: microsoft.graph.managedTenants
++
+Get a list of the [managedDeviceCompliance](../resources/managedtenants-manageddevicecompliance.md) objects and their properties.
+
+## 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)|DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/managedDeviceCompliances
+```
+
+## Optional query parameters
+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.|
+
+## 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 [managedDeviceCompliance](../resources/managedtenants-manageddevicecompliance.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_manageddevicecompliance"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/managedDeviceCompliances
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.managedDeviceCompliance)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#managedDeviceCompliances",
+ "value": [
+ {
+ "id": "38227791-a88b-4fcc-81c5-58cf77668320_6dd4fe4b-5ea2-4ab2-8ac4-7dd2995f1649",
+ "managedDeviceId": "6dd4fe4b-5ea2-4ab2-8ac4-7dd2995f1649",
+ "managedDeviceName": "VM2688",
+ "complianceStatus": "Noncompliant",
+ "osDescription": "Windows",
+ "osVersion": "10.0.19042.1083",
+ "lastSyncDateTime": "2021-07-09T14:38:56.379702Z",
+ "ownerType": "Company",
+ "model": "Virtual Machine",
+ "manufacturer": "Microsoft Corporation",
+ "inGracePeriodUntilDateTime": "2021-06-14T14:35:24.8225Z",
+ "lastRefreshedDateTime": "2021-07-11T07:03:54.0326474Z",
+ "deviceType": "WindowsRT",
+ "tenantId": "38227791-a88b-4fcc-81c5-58cf77668320",
+ "tenantDisplayName": "Consolidated Messenger"
+ },
+ {
+ "id": "38227791-a88b-4fcc-81c5-58cf77668320_49ed91f1-32ac-4881-9c1b-b709ba29e31b",
+ "managedDeviceId": "49ed91f1-32ac-4881-9c1b-b709ba29e31b",
+ "managedDeviceName": "VM4511",
+ "complianceStatus": "Noncompliant",
+ "osDescription": "Windows",
+ "osVersion": "10.0.19042.1052",
+ "lastSyncDateTime": "2021-07-09T14:41:57.8785122Z",
+ "ownerType": "Company",
+ "model": "Virtual Machine",
+ "manufacturer": "Microsoft Corporation",
+ "inGracePeriodUntilDateTime": "2021-06-14T14:36:09.1851Z",
+ "lastRefreshedDateTime": "2021-07-11T06:53:35.8484421Z",
+ "deviceType": "WindowsRT",
+ "tenantId": "38227791-a88b-4fcc-81c5-58cf77668320",
+ "tenantDisplayName": "Consolidated Messenger"
+ }
+ ]
+}
+```
v1.0 Managedtenants Managedtenant List Manageddevicecompliancetrends https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managedtenant-list-manageddevicecompliancetrends.md
+
+ Title: "List managedDeviceComplianceTrends"
+description: "Get a list of the managedDeviceComplianceTrend objects and their properties."
+
+localization_priority: Normal
++
+# List managedDeviceComplianceTrends
+Namespace: microsoft.graph.managedTenants
++
+Get a list of the [managedDeviceComplianceTrend](../resources/managedtenants-manageddevicecompliancetrend.md) objects and their properties.
+
+## 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)|DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/managedDeviceComplianceTrends
+```
+
+## Optional query parameters
+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.|
+
+## 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 [managedDeviceComplianceTrend](../resources/managedtenants-manageddevicecompliancetrend.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_manageddevicecompliancetrend"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/tenantRelationships/managedTenants/managedDeviceComplianceTrends
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.managedDeviceComplianceTrend)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/managedTenants/managedDeviceComplianceTrends",
+ "value": [
+ {
+ "id": "34298981-4fc8-4974-9486-c8909ed1521b_2021-06-12",
+ "unknownDeviceCount": 0,
+ "compliantDeviceCount": 4,
+ "noncompliantDeviceCount": 0,
+ "errorDeviceCount": 0,
+ "inGracePeriodDeviceCount": 0,
+ "configManagerDeviceCount": 0,
+ "countDateTime": "2021-06-12",
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantDisplayName": "Fourth Coffee"
+ },
+ {
+ "id": "38227791-a88b-4fcc-81c5-58cf77668320_2021-06-16",
+ "unknownDeviceCount": 0,
+ "compliantDeviceCount": 1,
+ "noncompliantDeviceCount": 4,
+ "errorDeviceCount": 0,
+ "inGracePeriodDeviceCount": 0,
+ "configManagerDeviceCount": 0,
+ "countDateTime": "2021-06-16",
+ "tenantId": "38227791-a88b-4fcc-81c5-58cf77668320",
+ "tenantDisplayName": "Consolidated Messenger"
+ }
+ ]
+}
+```
v1.0 Managedtenants Managedtenant List Managementactions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managedtenant-list-managementactions.md
+
+ Title: "List managementActions"
+description: "Get a list of the managementAction objects and their properties."
+
+localization_priority: Normal
++
+# List managementActions
+Namespace: microsoft.graph.managedTenants
++
+Get a list of the [managementAction](../resources/managedtenants-managementaction.md) objects and their properties.
+
+## 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)|ManagedTenants.Read.All, ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/managementActions
+```
+
+## Optional query parameters
+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.|
+
+## 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 [managementAction](../resources/managedtenants-managementaction.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_managementaction"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/managementActions
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.managementAction)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/managedTenants/managementActions",
+ "value": [
+ {
+ "id": "4274db74-99c4-40be-bbeb-da4351136be2",
+ "referenceTemplateId": "21230aa5-d5a9-4403-b179-baf2de242aca",
+ "displayName": "Baseline - Require MFA for end users",
+ "description": null,
+ "category": "identity",
+ "workloadActions": [
+ {
+ "actionId": "fcb7ace7-3ea6-4474-912a-00ee78554445",
+ "category": "automated",
+ "displayName": "ConditionalAccessPolicy",
+ "description": null,
+ "service": "AAD",
+ "settings": [
+ {
+ "valueType": "string",
+ "displayName": "DisplayName",
+ "overwriteAllowed": false,
+ "jsonValue": "\"Baseline - Require MFA for end users\""
+ },
+ {
+ "valueType": "string",
+ "displayName": "State",
+ "overwriteAllowed": false,
+ "jsonValue": "\"enabledForReportingButNotEnforced\""
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "ClientAppTypes",
+ "overwriteAllowed": false,
+ "jsonValue": "[\"All\"]"
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "IncludeApplications",
+ "overwriteAllowed": false,
+ "jsonValue": "[\"All\"]"
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "IncludeUsers",
+ "overwriteAllowed": false,
+ "jsonValue": "[\"None\"]"
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "IncludeLocations",
+ "overwriteAllowed": false,
+ "jsonValue": "[\"All\"]"
+ },
+ {
+ "valueType": "string",
+ "displayName": "GrantControls.Operator",
+ "overwriteAllowed": false,
+ "jsonValue": "\"OR\""
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "GrantControls.BuiltInControls",
+ "overwriteAllowed": false,
+ "jsonValue": "[\"mfa\"]"
+ }
+ ]
+ }
+ ]
+ }
+ ]
+}
+```
v1.0 Managedtenants Managedtenant List Managementactiontenantdeploymentstatuses https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managedtenant-list-managementactiontenantdeploymentstatuses.md
+
+ Title: "List managementActionTenantDeploymentStatus"
+description: "Get a list of the managementActionTenantDeploymentStatus objects and their properties."
+
+localization_priority: Normal
++
+# List managementActionTenantDeploymentStatus
+Namespace: microsoft.graph.managedTenants
++
+Get a list of the [managementActionTenantDeploymentStatus](../resources/managedtenants-managementactiontenantdeploymentstatus.md) objects and their properties.
+
+## 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)|ManagedTenants.Read.All, ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/managementActionTenantDeploymentStatuses
+```
+
+## Optional query parameters
+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.|
+
+## 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 [managementActionTenantDeploymentStatus](../resources/managedtenants-managementactiontenantdeploymentstatus.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_managementactiontenantdeploymentstatus"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/managementActionTenantDeploymentStatuses
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.managementActionTenantDeploymentStatus)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/managedTenants/managementActionTenantDeploymentStatuses",
+ "value": [
+ {
+ "id": "df7aed9c-c05a-4fc9-b958-64fafaed911d_34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantGroupId": "df7aed9c-c05a-4fc9-b958-64fafaed911d",
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "statuses": [
+ {
+ "managementTemplateId": "21230aa5-d5a9-4403-b179-baf2de242aca",
+ "managementActionId": "4274db74-99c4-40be-bbeb-da4351136be2",
+ "status": "completed",
+ "workloadActionDeploymentStatuses": [
+ {
+ "actionId": "fcb7ace7-3ea6-4474-912a-00ee78554445",
+ "status": "completed",
+ "deployedPolicyId": "949e8893-68fb-4c9d-b8a0-13c229a7e397",
+ "lastDeploymentDateTime": "2021-06-22T04:09:20.3054223Z",
+ "error": null
+ }
+ ]
+ },
+ {
+ "managementTemplateId": "31d57d29-2d54-4074-84bd-51c008c2e6b2",
+ "managementActionId": "f104bb7f-4854-4209-ba09-c3788f9894c5",
+ "status": "completed",
+ "workloadActionDeploymentStatuses": [
+ {
+ "actionId": "00a9a585-f51c-4b68-b4f5-f0c3165df8ac",
+ "status": "completed",
+ "deployedPolicyId": "19a8d6a6-d87e-4059-85b3-c73bfc5cea15",
+ "lastDeploymentDateTime": "2021-06-22T17:01:44.851214Z",
+ "error": null
+ }
+ ]
+ }
+ ]
+ },
+ {
+ "id": "df7aed9c-c05a-4fc9-b958-64fafaed911d_38227791-a88b-4fcc-81c5-58cf77668320",
+ "tenantGroupId": "df7aed9c-c05a-4fc9-b958-64fafaed911d",
+ "tenantId": "38227791-a88b-4fcc-81c5-58cf77668320",
+ "statuses": [
+ {
+ "managementTemplateId": "12524106-036f-457f-b7a6-b003509d29c8",
+ "managementActionId": "eac82706-9f32-4274-ba5b-cf1f8ecf042b",
+ "status": "completed",
+ "workloadActionDeploymentStatuses": [
+ {
+ "actionId": "7fff5ebb-10bd-4493-b0bb-2d0cf6172f16",
+ "status": "completed",
+ "deployedPolicyId": "062107b4-236d-465a-ae62-3bb4bd31f276",
+ "lastDeploymentDateTime": "2021-06-17T13:19:47.3003079Z",
+ "error": null
+ }
+ ]
+ },
+ {
+ "managementTemplateId": "b2d6d189-ea31-4cf8-b75e-41210c583127",
+ "managementActionId": "55f8da1a-4eec-4fb2-9c58-4c4b3cdf7222",
+ "status": "completed",
+ "workloadActionDeploymentStatuses": [
+ {
+ "actionId": "4a1c5d34-c2f7-4fd5-a7b5-4bedd95bb8f9",
+ "status": "completed",
+ "deployedPolicyId": "606cf367-2075-40c4-a587-7914b6d83dc7",
+ "lastDeploymentDateTime": "2021-06-17T15:21:17.5296126Z",
+ "error": null
+ }
+ ]
+ },
+ {
+ "managementTemplateId": "31d57d29-2d54-4074-84bd-51c008c2e6b2",
+ "managementActionId": "f104bb7f-4854-4209-ba09-c3788f9894c5",
+ "status": "completed",
+ "workloadActionDeploymentStatuses": [
+ {
+ "actionId": "00a9a585-f51c-4b68-b4f5-f0c3165df8ac",
+ "status": "completed",
+ "deployedPolicyId": "60148b3e-39a2-4c0c-95a6-375a939aa756",
+ "lastDeploymentDateTime": "2021-06-22T05:54:42.7087204Z",
+ "error": null
+ }
+ ]
+ },
+ {
+ "managementTemplateId": "21230aa5-d5a9-4403-b179-baf2de242aca",
+ "managementActionId": "4274db74-99c4-40be-bbeb-da4351136be2",
+ "status": "riskAccepted",
+ "workloadActionDeploymentStatuses": []
+ },
+ {
+ "managementTemplateId": "e5834405-43d2-4815-867d-3dd600308d1c",
+ "managementActionId": "e96a8cdb-0435-4808-9956-cf6b8ae77aa6",
+ "status": "toAddress",
+ "workloadActionDeploymentStatuses": []
+ }
+ ]
+ },
+ {
+ "id": "df7aed9c-c05a-4fc9-b958-64fafaed911d_4d262a25-c70a-430b-9e8e-46c31dec116b",
+ "tenantGroupId": "df7aed9c-c05a-4fc9-b958-64fafaed911d",
+ "tenantId": "4d262a25-c70a-430b-9e8e-46c31dec116b",
+ "statuses": [
+ {
+ "managementTemplateId": "31d57d29-2d54-4074-84bd-51c008c2e6b2",
+ "managementActionId": "f104bb7f-4854-4209-ba09-c3788f9894c5",
+ "status": "completed",
+ "workloadActionDeploymentStatuses": [
+ {
+ "actionId": "00a9a585-f51c-4b68-b4f5-f0c3165df8ac",
+ "status": "completed",
+ "deployedPolicyId": "aee50adb-9445-44a8-baaf-7d16b388d708",
+ "lastDeploymentDateTime": "2021-06-18T20:21:00.0934112Z",
+ "error": null
+ }
+ ]
+ },
+ {
+ "managementTemplateId": "12524106-036f-457f-b7a6-b003509d29c8",
+ "managementActionId": "eac82706-9f32-4274-ba5b-cf1f8ecf042b",
+ "status": "completed",
+ "workloadActionDeploymentStatuses": [
+ {
+ "actionId": "7fff5ebb-10bd-4493-b0bb-2d0cf6172f16",
+ "status": "completed",
+ "deployedPolicyId": "67635cbb-6519-44dd-bf7f-fd8752d1339b",
+ "lastDeploymentDateTime": "2021-07-09T18:53:07.113328Z",
+ "error": null
+ }
+ ]
+ },
+ {
+ "managementTemplateId": "21230aa5-d5a9-4403-b179-baf2de242aca",
+ "managementActionId": "4274db74-99c4-40be-bbeb-da4351136be2",
+ "status": "completed",
+ "workloadActionDeploymentStatuses": [
+ {
+ "actionId": "fcb7ace7-3ea6-4474-912a-00ee78554445",
+ "status": "completed",
+ "deployedPolicyId": "f296e4d5-7b4a-4c7b-977f-cd4e5bbbc0ea",
+ "lastDeploymentDateTime": "2021-07-09T20:12:33.6197104Z",
+ "error": null
+ }
+ ]
+ }
+ ]
+ },
+ {
+ "id": "df7aed9c-c05a-4fc9-b958-64fafaed911d_791fae7d-ffda-4187-ba69-14ed55bdb026",
+ "tenantGroupId": "df7aed9c-c05a-4fc9-b958-64fafaed911d",
+ "tenantId": "791fae7d-ffda-4187-ba69-14ed55bdb026",
+ "statuses": [
+ {
+ "managementTemplateId": "12524106-036f-457f-b7a6-b003509d29c8",
+ "managementActionId": "eac82706-9f32-4274-ba5b-cf1f8ecf042b",
+ "status": "completed",
+ "workloadActionDeploymentStatuses": [
+ {
+ "actionId": "7fff5ebb-10bd-4493-b0bb-2d0cf6172f16",
+ "status": "completed",
+ "deployedPolicyId": "2e628607-5908-4dea-89c3-61438dd77805",
+ "lastDeploymentDateTime": "2021-06-17T05:14:12.671197Z",
+ "error": null
+ }
+ ]
+ },
+ {
+ "managementTemplateId": "21230aa5-d5a9-4403-b179-baf2de242aca",
+ "managementActionId": "4274db74-99c4-40be-bbeb-da4351136be2",
+ "status": "completed",
+ "workloadActionDeploymentStatuses": [
+ {
+ "actionId": "fcb7ace7-3ea6-4474-912a-00ee78554445",
+ "status": "completed",
+ "deployedPolicyId": "deebefee-f378-4d2e-ab1a-a7f2bf1a010e",
+ "lastDeploymentDateTime": "2021-06-17T05:15:08.801992Z",
+ "error": null
+ }
+ ]
+ },
+ {
+ "managementTemplateId": "e5834405-43d2-4815-867d-3dd600308d1c",
+ "managementActionId": "e96a8cdb-0435-4808-9956-cf6b8ae77aa6",
+ "status": "completed",
+ "workloadActionDeploymentStatuses": [
+ {
+ "actionId": "6a3ad0bc-5d7e-4a49-a105-c559aa4633e1",
+ "status": "completed",
+ "deployedPolicyId": "e14428f4-9890-4f6b-8416-ec40d9a59646",
+ "lastDeploymentDateTime": "2021-06-17T05:15:57.5564366Z",
+ "error": null
+ }
+ ]
+ },
+ {
+ "managementTemplateId": "b2d6d189-ea31-4cf8-b75e-41210c583127",
+ "managementActionId": "55f8da1a-4eec-4fb2-9c58-4c4b3cdf7222",
+ "status": "completed",
+ "workloadActionDeploymentStatuses": [
+ {
+ "actionId": "4a1c5d34-c2f7-4fd5-a7b5-4bedd95bb8f9",
+ "status": "completed",
+ "deployedPolicyId": "220bbe5d-2167-4ba1-8c7d-67bd56b0e068",
+ "lastDeploymentDateTime": "2021-06-17T05:16:35.1968434Z",
+ "error": null
+ }
+ ]
+ },
+ {
+ "managementTemplateId": "31d57d29-2d54-4074-84bd-51c008c2e6b2",
+ "managementActionId": "f104bb7f-4854-4209-ba09-c3788f9894c5",
+ "status": "completed",
+ "workloadActionDeploymentStatuses": [
+ {
+ "actionId": "00a9a585-f51c-4b68-b4f5-f0c3165df8ac",
+ "status": "completed",
+ "deployedPolicyId": "50553bd7-560e-4c0e-9c80-78f4ae9560e5",
+ "lastDeploymentDateTime": "2021-06-17T05:17:46.2079328Z",
+ "error": null
+ }
+ ]
+ },
+ {
+ "managementTemplateId": "e2cadc41-a08f-45e7-8eb1-942d224dfb9a",
+ "managementActionId": "b22a4713-8428-4952-8cac-d48962ecbdc9",
+ "status": "completed",
+ "workloadActionDeploymentStatuses": [
+ {
+ "actionId": "46b80b42-06c7-45b4-b6fb-aa0aecace87b",
+ "status": "completed",
+ "deployedPolicyId": null,
+ "lastDeploymentDateTime": "2021-06-17T05:18:16.7581968Z",
+ "error": null
+ }
+ ]
+ }
+ ]
+ }
+ ]
+}
+```
v1.0 Managedtenants Managedtenant List Managementintents https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managedtenant-list-managementintents.md
+
+ Title: "List managementIntents"
+description: "Get a list of the managementIntent objects and their properties."
+
+localization_priority: Normal
++
+# List managementIntents
+Namespace: microsoft.graph.managedTenants
++
+Get a list of the [managementIntent](../resources/managedtenants-managementintent.md) objects and their properties.
+
+## 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)|ManagedTenants.Read.All, ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/managementIntents
+```
+
+## Optional query parameters
+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.|
+
+## 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 [managementIntent](../resources/managedtenants-managementintent.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_managementintent"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/managementIntents
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.managementIntent)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/managedTenants/managementIntents",
+ "value": [
+ {
+ "id": "586895ab-8a59-4b79-be25-b06949a819bb",
+ "displayName": "Default Baseline",
+ "isGlobal": true,
+ "managementTemplates": [
+ {
+ "managementTemplateId": "e5834405-43d2-4815-867d-3dd600308d1c",
+ "displayName": "Baseline - Block Legacy Authentication",
+ "category": "identity"
+ },
+ {
+ "managementTemplateId": "12524106-036f-457f-b7a6-b003509d29c8",
+ "displayName": "Baseline - Require MFA for Admins",
+ "category": "identity"
+ },
+ {
+ "managementTemplateId": "21230aa5-d5a9-4403-b179-baf2de242aca",
+ "displayName": "Baseline - Require MFA for end users",
+ "category": "identity"
+ },
+ {
+ "managementTemplateId": "e2cadc41-a08f-45e7-8eb1-942d224dfb9a",
+ "displayName": "Baseline - Enroll devices in MEM",
+ "category": "devices"
+ },
+ {
+ "managementTemplateId": "31d57d29-2d54-4074-84bd-51c008c2e6b2",
+ "displayName": "Baseline - Setup Compliance Policy for Windows 10 devices",
+ "category": "devices"
+ },
+ {
+ "managementTemplateId": "b2d6d189-ea31-4cf8-b75e-41210c583127",
+ "displayName": "Baseline - Setup Microsoft Defender Antivirus Policy for Windows 10 devices",
+ "category": "devices"
+ }
+ ]
+ }
+ ]
+}
+```
v1.0 Managedtenants Managedtenant List Managementtemplates https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managedtenant-list-managementtemplates.md
+
+ Title: "List managementTemplates"
+description: "Get a list of the managementTemplate objects and their properties."
+
+localization_priority: Normal
++
+# List managementTemplates
+Namespace: microsoft.graph.managedTenants
++
+Get a list of the [managementTemplate](../resources/managedtenants-managementtemplate.md) objects and their properties.
+
+## 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)|ManagedTenants.Read.All, ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/managementTemplates
+```
+
+## Optional query parameters
+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.|
+
+## 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 [managementTemplate](../resources/managedtenants-managementtemplate.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_managementtemplate"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/managementTemplates
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.managementTemplate)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/managedTenants/managementTemplates",
+ "value": [
+ {
+ "id": "e5834405-43d2-4815-867d-3dd600308d1c_1",
+ "displayName": "Baseline - Block Legacy Authentication",
+ "description": null,
+ "category": "identity",
+ "parameters": [
+ {
+ "valueType": "string",
+ "displayName": "DisplayName",
+ "description": null,
+ "jsonDefaultValue": "\"Baseline - Block Legacy Authentication\"",
+ "jsonAllowedValues": "null"
+ },
+ {
+ "valueType": "string",
+ "displayName": "State",
+ "description": null,
+ "jsonDefaultValue": "\"enabledForReportingButNotEnforced\"",
+ "jsonAllowedValues": "[\"enabled\",\"disabled\",\"enabledForReportingButNotEnforced\"]"
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "ClientAppTypes",
+ "description": null,
+ "jsonDefaultValue": "[\"exchangeActiveSync\",\"other\"]",
+ "jsonAllowedValues": "[\"exchangeActiveSync\",\"other\"]"
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "IncludeApplications",
+ "description": null,
+ "jsonDefaultValue": "[\"All\"]",
+ "jsonAllowedValues": "[\"All\"]"
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "IncludeUsers",
+ "description": null,
+ "jsonDefaultValue": "[\"None\"]",
+ "jsonAllowedValues": "[\"All\",\"None\"]"
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "IncludeLocations",
+ "description": null,
+ "jsonDefaultValue": "[\"All\"]",
+ "jsonAllowedValues": "[\"All\",\"AllTrusted\"]"
+ },
+ {
+ "valueType": "string",
+ "displayName": "GrantControls.Operator",
+ "description": null,
+ "jsonDefaultValue": "\"OR\"",
+ "jsonAllowedValues": "[\"OR\",\"AND\"]"
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "GrantControls.BuiltInControls",
+ "description": null,
+ "jsonDefaultValue": "[\"block\"]",
+ "jsonAllowedValues": "[\"block\"]"
+ }
+ ],
+ "workloadActions": [
+ {
+ "actionId": "6a3ad0bc-5d7e-4a49-a105-c559aa4633e1",
+ "category": "automated",
+ "displayName": "ConditionalAccessPolicy",
+ "description": null,
+ "service": "AAD",
+ "settings": [
+ {
+ "valueType": "string",
+ "displayName": "DisplayName",
+ "overwriteAllowed": false,
+ "jsonValue": "\"Baseline - Block Legacy Authentication\""
+ },
+ {
+ "valueType": "string",
+ "displayName": "State",
+ "overwriteAllowed": false,
+ "jsonValue": "\"enabledForReportingButNotEnforced\""
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "ClientAppTypes",
+ "overwriteAllowed": false,
+ "jsonValue": "[\"exchangeActiveSync\",\"other\"]"
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "IncludeApplications",
+ "overwriteAllowed": false,
+ "jsonValue": "[\"All\"]"
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "IncludeUsers",
+ "overwriteAllowed": false,
+ "jsonValue": "[\"None\"]"
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "IncludeLocations",
+ "overwriteAllowed": false,
+ "jsonValue": "[\"All\"]"
+ },
+ {
+ "valueType": "string",
+ "displayName": "GrantControls.Operator",
+ "overwriteAllowed": false,
+ "jsonValue": "\"OR\""
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "GrantControls.BuiltInControls",
+ "overwriteAllowed": false,
+ "jsonValue": "[\"block\"]"
+ }
+ ]
+ }
+ ]
+ }
+ ]
+}
+```
v1.0 Managedtenants Managedtenant List Riskyusers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managedtenant-list-riskyusers.md
+
+ Title: "List riskyUsers"
+description: "Get a list of the riskyUser objects and their properties."
+
+localization_priority: Normal
++
+# List riskyUsers
+Namespace: microsoft.graph.managedTenants
++
+Get a list of the [riskyUser](../resources/managedtenants-riskyuser.md) objects and their properties.
+
+## 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)|IdentityRiskyUser.Read.All, IdentityRiskyUser.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/riskyUsers
+```
+
+## Optional query parameters
+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.|
+
+## 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 [riskyUser](../resources/managedtenants-riskyuser.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_riskyuser"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/riskyUsers
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.riskyUser)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#riskyUsers",
+ "value": [
+ {
+ "id": "34298981-4fc8-4974-9486-c8909ed1521b_ae8d3a3f-be95-429c-8063-635ccc16e899",
+ "userId": "ae8d3a3f-be95-429c-8063-635ccc16e899",
+ "userDisplayName": "Cynthia Becker",
+ "userPrincipalName": "cynthia@fourthcoffee002.onmicrosoft.com",
+ "riskState": "atRisk",
+ "riskLevel": "hidden",
+ "riskDetail": "hidden",
+ "isDeleted": false,
+ "riskLastUpdatedDateTime": "2021-06-10T13:58:34.5171907Z",
+ "lastRefreshedDateTime": "2021-07-11T11:32:55.2168558Z",
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantDisplayName": "Fourth Coffee"
+ },
+ {
+ "id": "38227791-a88b-4fcc-81c5-58cf77668320_05ec33c0-471d-4b1a-901c-093fc65c6401",
+ "userId": "05ec33c0-471d-4b1a-901c-093fc65c6401",
+ "userDisplayName": "Ina Anthony",
+ "userPrincipalName": "ianthony@consolidatedmessenger001.onmicrosoft.com",
+ "riskState": "atRisk",
+ "riskLevel": "hidden",
+ "riskDetail": "hidden",
+ "isDeleted": false,
+ "riskLastUpdatedDateTime": "2021-06-11T14:35:29.8061797Z",
+ "lastRefreshedDateTime": "2021-07-11T14:42:10.8700665Z",
+ "tenantId": "38227791-a88b-4fcc-81c5-58cf77668320",
+ "tenantDisplayName": "Consolidated Messenger"
+ }
+ ]
+}
+```
v1.0 Managedtenants Managedtenant List Tenantgroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managedtenant-list-tenantgroups.md
+
+ Title: "List tenantGroups"
+description: "Get a list of the tenantGroup objects and their properties."
+
+localization_priority: Normal
++
+# List tenantGroups
+Namespace: microsoft.graph.managedTenants
++
+Get a list of the [tenantGroup](../resources/managedtenants-tenantgroup.md) objects and their properties.
+
+## 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)|ManagedTenants.Read.All, ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/tenantGroups
+```
+
+## Optional query parameters
+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.|
+
+## 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 [tenantGroup](../resources/managedtenants-tenantgroup.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_tenantgroup"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/tenantGroups
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.tenantGroup)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/managedTenants/tenantGroups",
+ "value": [
+ {
+ "id": "df7aed9c-c05a-4fc9-b958-64fafaed911d",
+ "displayName": "Default",
+ "allTenantsIncluded": true,
+ "tenantIds": [],
+ "managementIntents": [
+ {
+ "managementIntentId": "586895ab-8a59-4b79-be25-b06949a819bb",
+ "managementIntentDisplayName": "Default Baseline",
+ "managementTemplates": [
+ {
+ "managementTemplateId": "e5834405-43d2-4815-867d-3dd600308d1c",
+ "displayName": "Baseline - Block Legacy Authentication",
+ "category": "identity"
+ },
+ {
+ "managementTemplateId": "12524106-036f-457f-b7a6-b003509d29c8",
+ "displayName": "Baseline - Require MFA for Admins",
+ "category": "identity"
+ },
+ {
+ "managementTemplateId": "21230aa5-d5a9-4403-b179-baf2de242aca",
+ "displayName": "Baseline - Require MFA for end users",
+ "category": "identity"
+ },
+ {
+ "managementTemplateId": "e2cadc41-a08f-45e7-8eb1-942d224dfb9a",
+ "displayName": "Baseline - Enroll devices in MEM",
+ "category": "devices"
+ },
+ {
+ "managementTemplateId": "31d57d29-2d54-4074-84bd-51c008c2e6b2",
+ "displayName": "Baseline - Setup Compliance Policy for Windows 10 devices",
+ "category": "devices"
+ },
+ {
+ "managementTemplateId": "b2d6d189-ea31-4cf8-b75e-41210c583127",
+ "displayName": "Baseline - Setup Microsoft Defender Antivirus Policy for Windows 10 devices",
+ "category": "devices"
+ }
+ ]
+ }
+ ],
+ "managementActions": [
+ {
+ "managementTemplateId": "12524106-036f-457f-b7a6-b003509d29c8",
+ "managementActionId": "eac82706-9f32-4274-ba5b-cf1f8ecf042b"
+ },
+ {
+ "managementTemplateId": "31d57d29-2d54-4074-84bd-51c008c2e6b2",
+ "managementActionId": "f104bb7f-4854-4209-ba09-c3788f9894c5"
+ },
+ {
+ "managementTemplateId": "21230aa5-d5a9-4403-b179-baf2de242aca",
+ "managementActionId": "4274db74-99c4-40be-bbeb-da4351136be2"
+ },
+ {
+ "managementTemplateId": "e5834405-43d2-4815-867d-3dd600308d1c",
+ "managementActionId": "e96a8cdb-0435-4808-9956-cf6b8ae77aa6"
+ },
+ {
+ "managementTemplateId": "b2d6d189-ea31-4cf8-b75e-41210c583127",
+ "managementActionId": "55f8da1a-4eec-4fb2-9c58-4c4b3cdf7222"
+ },
+ {
+ "managementTemplateId": "e2cadc41-a08f-45e7-8eb1-942d224dfb9a",
+ "managementActionId": "b22a4713-8428-4952-8cac-d48962ecbdc9"
+ }
+ ]
+ }
+ ]
+}
+```
v1.0 Managedtenants Managedtenant List Tenants https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managedtenant-list-tenants.md
+
+ Title: "List tenants"
+description: "Get a list of the tenant objects and their properties."
+
+localization_priority: Normal
++
+# List tenants
+Namespace: microsoft.graph.managedTenants
++
+Get a list of the [tenant](../resources/managedtenants-tenant.md) objects and their properties.
+
+## 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)|ManagedTenants.Read.All, ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/tenants
+```
+
+## Optional query parameters
+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.|
+
+## 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 [tenant](../resources/managedtenants-tenant.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_tenant"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/tenants
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.tenant)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "id": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "contract": {
+ "displayName": "Fourth Coffee",
+ "defaultDomainName": "fourthcoffe01.onmicrosoft.com",
+ "contractType": 2
+ },
+ "tenantStatusInformation": {
+ "onboardingStatus": "ineligible",
+ "onboardingDateTime": "2012-02-20T00:00:00Z",
+ "onboardedByUserId": "",
+ "offboardedDateTime": "2012-02-20T00:00:00Z",
+ "offboardedBy": "",
+ "delegatedPrivilegeStatus": "delegatedAdminPrivileges",
+ "workloadStatuses": [
+ {
+ "displayName": "Device Management",
+ "onboardingStatus": "onboarded",
+ "onboardedDateTime": "2012-02-20T00:00:00Z",
+ "offboardedDateTime": null
+ },
+ {
+ "displayName": "Cloud PC",
+ "onboardingStatus": "notOnboarded",
+ "onboardedDateTime": "2012-02-20T00:00:00Z",
+ "offboardedDateTime": null
+ }
+ ]
+ },
+ "createdDateTime": "2012-02-20T00:00:00Z",
+ "lastUpdatedDatetime": "2021-02-20T00:00:00Z"
+ }
+ ]
+}
+```
v1.0 Managedtenants Managedtenant List Tenantscustomizedinformation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managedtenant-list-tenantscustomizedinformation.md
+
+ Title: "List tenantCustomizedInformation"
+description: "Get a list of the tenantCustomizedInformation objects and their properties."
+
+localization_priority: Normal
++
+# List tenantCustomizedInformation
+Namespace: microsoft.graph.managedTenants
++
+Get a list of the [tenantCustomizedInformation](../resources/managedtenants-tenantcustomizedinformation.md) objects and their properties.
+
+## 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)|ManagedTenants.Read.All, ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/tenantsCustomizedInformation
+```
+
+## Optional query parameters
+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.|
+
+## 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 [tenantCustomizedInformation](../resources/managedtenants-tenantcustomizedinformation.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_tenantcustomizedinformation"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/tenantsCustomizedInformation
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.tenantCustomizedInformation)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/tenantRelationships/managedTenants/$metadata#tenantCustomizedInformation",
+ "value": [
+ {
+ "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"
+ }
+ ]
+ },
+ {
+ "id": "38227791-a88b-4fcc-81c5-58cf77668320",
+ "tenantId": "38227791-a88b-4fcc-81c5-58cf77668320\",",
+ "website": "https://www.consolidatedmessenger.com",
+ "contacts": [
+ {
+ "name": "Cynthia",
+ "email": "cynthia@consolidatedmessenger.com",
+ "phone": "5558001370"
+ },
+ {
+ "name": "Timothy",
+ "email": "timothy@consolidatedmessenger.com",
+ "phone": "5558001379"
+ }
+ ]
+ }
+ ]
+}
+```
v1.0 Managedtenants Managedtenant List Tenantsdetailedinformation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managedtenant-list-tenantsdetailedinformation.md
+
+ Title: "List tenantDetailedInformation"
+description: "Get a list of the tenantDetailedInformation objects and their properties."
+
+localization_priority: Normal
++
+# List tenantDetailedInformation
+Namespace: microsoft.graph.managedTenants
++
+Get a list of the [tenantDetailedInformation](../resources/managedtenants-tenantdetailedinformation.md) objects and their properties.
+
+## 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)|ManagedTenants.Read.All, ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/tenantsDetailedInformation
+```
+
+## Optional query parameters
+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.|
+
+## 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 [tenantDetailedInformation](../resources/managedtenants-tenantdetailedinformation.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_tenantdetailedinformation"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/tenantsDetailedInformation
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.tenantDetailedInformation)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/tenantRelationships/managedTenants/$metadata#tenantDetailedInformation",
+ "value": [
+ {
+ "id": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "companyName": "Fourth Coffee",
+ "defaultDomainName": "fourthcoffee001.onmicrosoft.com",
+ "countryName": "United States",
+ "countryCode": "US",
+ "city": "Redmond",
+ "region": "NA",
+ "verticalName": "Software",
+ "industryName": "Computer",
+ "segmentName": "Service"
+ },
+ {
+ "id": "38227791-a88b-4fcc-81c5-58cf77668320",
+ "tenantId": "38227791-a88b-4fcc-81c5-58cf77668320",
+ "companyName": "Consolidated Messenger",
+ "defaultDomainName": "consoldiatedmessenger001.onmicrosoft.com",
+ "countryName": "United States",
+ "countryCode": "US",
+ "city": "Redmond",
+ "region": "NA",
+ "verticalName": "Software",
+ "industryName": "Computer",
+ "segmentName": "Service"
+ }
+ ]
+}
+```
v1.0 Managedtenants Managedtenant List Tenanttags https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managedtenant-list-tenanttags.md
+
+ Title: "List tenantTags"
+description: "Get a list of the tenantTag objects and their properties."
+
+localization_priority: Normal
++
+# List tenantTags
+Namespace: microsoft.graph.managedTenants
++
+Get a list of the [tenantTag](../resources/managedtenants-tenanttag.md) objects and their properties.
+
+## 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)|ManagedTenants.Read.All, ManagedTenants.WriteRead.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/tenantTags
+```
+
+## Optional query parameters
+This method supports the [OData query parameters](/graph/query-parameters) to help customize the response, including `$count`, `$filter`, `$orderBy`, `$select`, `$skip`, and `$top`.
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## 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 [tenantTag](../resources/managedtenants-tenanttag.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_tenanttag"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/tenantTags
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.tenantTag)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/managedTenants/tenantTags",
+ "value": [
+ {
+ "id": "913391c0-5466-42b4-900d-0a7501399cb0",
+ "displayName": "Onboarding",
+ "description": "Tenants that we are currently onboarding",
+ "properties": null,
+ "tenantIds": [
+ "38227791-a88b-4fcc-81c5-58cf77668320",
+ "34298981-4fc8-4974-9486-c8909ed1521b",
+ "4d262a25-c70a-430b-9e8e-46c31dec116b"
+ ],
+ "isDeleted": null,
+ "createdDateTime": "2021-06-16T20:36:31.086644Z",
+ "createdByUserId": "9bf6a5ad-aecb-4194-a16b-38e02702a602",
+ "lastActionDateTime": "2021-06-28T20:46:09.0071888Z",
+ "lastActionByUserId": "08ea0285-30cb-46cc-abc8-3d8422e21ecb",
+ "tenants": [
+ {
+ "tenantId": "38227791-a88b-4fcc-81c5-58cf77668320"
+ },
+ {
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b"
+ },
+ {
+ "tenantId": "4d262a25-c70a-430b-9e8e-46c31dec116b"
+ }
+ ]
+ },
+ {
+ "id": "bfd883e8-10f3-40ee-994c-111fa1c5d1db",
+ "displayName": "ExtendedSupport",
+ "description": "Tenants that have purchased extended support.",
+ "properties": null,
+ "tenantIds": [
+ "38227791-a88b-4fcc-81c5-58cf77668320",
+ "4d262a25-c70a-430b-9e8e-46c31dec116b"
+ ],
+ "isDeleted": null,
+ "createdDateTime": "2021-06-16T20:43:31.8917383Z",
+ "createdByUserId": "43a2424c-0fa3-446d-bee9-4ab500bb1603",
+ "lastActionDateTime": "2021-06-17T03:23:31.3531635Z",
+ "lastActionByUserId": "248f617e-a6a7-4d31-922d-726c24074bb6",
+ "tenants": [
+ {
+ "tenantId": "38227791-a88b-4fcc-81c5-58cf77668320"
+ },
+ {
+ "tenantId": "4d262a25-c70a-430b-9e8e-46c31dec116b"
+ }
+ ]
+ }
+ ]
+}
+```
v1.0 Managedtenants Managedtenant List Windowsdevicemalwarestates https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managedtenant-list-windowsdevicemalwarestates.md
+
+ Title: "List windowsDeviceMalwareStates"
+description: "Get a list of the windowsDeviceMalwareState objects and their properties."
+
+localization_priority: Normal
++
+# List windowsDeviceMalwareStates
+Namespace: microsoft.graph.managedTenants
++
+Get a list of the [windowsDeviceMalwareState](../resources/managedtenants-windowsdevicemalwarestate.md) objects and their properties.
+
+## 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)|DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/windowsDeviceMalwareStates
+```
+
+## Optional query parameters
+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.|
+
+## 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 [windowsDeviceMalwareState](../resources/managedtenants-windowsdevicemalwarestate.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_windowsdevicemalwarestate"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/windowsDeviceMalwareStates
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.windowsDeviceMalwareState)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#windowsDeviceMalwareStates",
+ "value": [
+ {
+ "id": "34298981-4fc8-4974-9486-c8909ed1521b_c9c8328e-7be6-48f6-8ddc-be3aae112f0d_2147714402",
+ "managedDeviceId": "c9c8328e-7be6-48f6-8ddc-be3aae112f0d",
+ "managedDeviceName": "vm12",
+ "malwareId": "2147714402",
+ "malwareExecutionState": "Unknown",
+ "malwareThreatState": "Active",
+ "initialDetectionDateTime": "2021-07-09T14:33:49Z",
+ "lastStateChangeDateTime": "2021-07-09T14:33:49Z",
+ "detectionCount": 9,
+ "deviceDeleted": false,
+ "malwareCategory": "TrojanDownloader",
+ "malwareSeverity": "Severe",
+ "malwareDisplayName": "TrojanDownloader:Win32/Vigorf.A",
+ "lastRefreshedDateTime": "2021-07-11T00:02:20.7750537Z",
+ "additionalInformationUrl": "https://go.microsoft.com/fwlink/?linkid=37020&name=TrojanDownloader%3AWin32%2FVigorf%2EA&threatid=2147714402&enterprise=1",
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantDisplayName": "Fourth Coffee"
+ },
+ {
+ "id": "38227791-a88b-4fcc-81c5-58cf77668320_956410b3-af0d-4a55-82c6-3962cca172fb_2147694182",
+ "managedDeviceId": "956410b3-af0d-4a55-82c6-3962cca172fb",
+ "managedDeviceName": "VM9166",
+ "malwareId": "2147694182",
+ "malwareExecutionState": "Unknown",
+ "malwareThreatState": "Active",
+ "initialDetectionDateTime": "2021-07-09T14:36:46Z",
+ "lastStateChangeDateTime": "2021-07-09T14:36:46Z",
+ "detectionCount": 7,
+ "deviceDeleted": false,
+ "malwareCategory": "Trojan",
+ "malwareSeverity": "Severe",
+ "malwareDisplayName": "Trojan:Win32/Skeeyah.A!rfn",
+ "lastRefreshedDateTime": "2021-07-11T00:02:20.7750537Z",
+ "additionalInformationUrl": "https://go.microsoft.com/fwlink/?linkid=37020&name=Trojan%3AWin32%2FSkeeyah%2EA%21rfn&threatid=2147694182&enterprise=1",
+ "tenantId": "38227791-a88b-4fcc-81c5-58cf77668320",
+ "tenantDisplayName": "Consolidated Messenger"
+ }
+ ]
+}
+```
v1.0 Managedtenants Managedtenant List Windowsprotectionstates https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managedtenant-list-windowsprotectionstates.md
+
+ Title: "List windowsProtectionStates"
+description: "Get a list of the windowsProtectionState objects and their properties."
+
+localization_priority: Normal
++
+# List windowsProtectionStates
+Namespace: microsoft.graph.managedTenants
++
+Get a list of the [windowsProtectionState](../resources/managedtenants-windowsprotectionstate.md) objects and their properties.
+
+## 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)|DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/windowsProtectionStates
+```
+
+## Optional query parameters
+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.|
+
+## 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 [windowsProtectionState](../resources/managedtenants-windowsprotectionstate.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_windowsprotectionstate"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/windowsProtectionStates
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.windowsProtectionState)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/managedTenants/windowsProtectionStates",
+ "value": [
+ {
+ "id": "34298981-4fc8-4974-9486-c8909ed1521b_95378ac4-eded-4671-8fa2-4e42e5de3463",
+ "managedDeviceId": "95378ac4-eded-4671-8fa2-4e42e5de3463",
+ "managedDeviceName": "vm11",
+ "malwareProtectionEnabled": true,
+ "managedDeviceHealthState": "Clean",
+ "realTimeProtectionEnabled": true,
+ "networkInspectionSystemEnabled": true,
+ "quickScanOverdue": false,
+ "fullScanOverdue": false,
+ "signatureUpdateOverdue": false,
+ "rebootRequired": false,
+ "attentionRequired": false,
+ "fullScanRequired": false,
+ "engineVersion": "1.1.18300.4",
+ "signatureVersion": "1.343.642.0",
+ "antiMalwareVersion": "4.18.2106.6",
+ "lastQuickScanDateTime": "2021-06-24T14:50:28Z",
+ "lastFullScanDateTime": null,
+ "lastQuickScanSignatureVersion": "1.341.1288.0",
+ "lastFullScanSignatureVersion": "0.0.0.0",
+ "lastReportedDateTime": "2021-07-09T14:43:45Z",
+ "devicePropertiesRefreshTime": "2021-07-09T14:44:28Z",
+ "deviceDeleted": false,
+ "lastRefreshedDateTime": "2021-07-11T02:02:35.9816065Z",
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantDisplayName": "Fourth Coffee",
+ "devicePropertiesRefreshDateTime": "2021-07-09T14:44:28Z"
+ },
+ {
+ "id": "38227791-a88b-4fcc-81c5-58cf77668320_49ed91f1-32ac-4881-9c1b-b709ba29e31b",
+ "managedDeviceId": "49ed91f1-32ac-4881-9c1b-b709ba29e31b",
+ "managedDeviceName": "VM4511",
+ "malwareProtectionEnabled": true,
+ "managedDeviceHealthState": "Clean",
+ "realTimeProtectionEnabled": true,
+ "networkInspectionSystemEnabled": true,
+ "quickScanOverdue": false,
+ "fullScanOverdue": false,
+ "signatureUpdateOverdue": false,
+ "rebootRequired": false,
+ "attentionRequired": false,
+ "fullScanRequired": false,
+ "engineVersion": "1.1.18300.4",
+ "signatureVersion": "1.343.618.0",
+ "antiMalwareVersion": "4.18.2105.5",
+ "lastQuickScanDateTime": "2021-06-21T15:05:41Z",
+ "lastFullScanDateTime": "2021-04-19T20:03:26Z",
+ "lastQuickScanSignatureVersion": "1.341.1157.0",
+ "lastFullScanSignatureVersion": "1.303.25.0",
+ "lastReportedDateTime": "2021-07-09T14:43:52Z",
+ "devicePropertiesRefreshTime": "2021-07-09T14:44:28Z",
+ "deviceDeleted": false,
+ "lastRefreshedDateTime": "2021-07-11T02:02:35.9816065Z",
+ "tenantId": "38227791-a88b-4fcc-81c5-58cf77668320",
+ "tenantDisplayName": "Consolidated Messenger",
+ "devicePropertiesRefreshDateTime": "2021-07-09T14:44:28Z"
+ }
+ ]
+}
+```
v1.0 Managedtenants Managedtenant Post Tenanttags https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managedtenant-post-tenanttags.md
+
+ Title: "Create tenantTag"
+description: "Create a new tenantTag object."
+
+localization_priority: Normal
++
+# Create tenantTag
+Namespace: microsoft.graph.managedTenants
++
+Create a new [tenantTag](../resources/managedtenants-tenanttag.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)|ManagedTenants.WriteRead.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /tenantRelationships/managedTenants/tenantTags
+```
+
+## 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 [tenantTag](../resources/managedtenants-tenanttag.md) object.
+
+The following table shows the properties that are required when you create the [tenantTag](../resources/managedtenants-tenanttag.md).
+
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|The display name for the tenant tag.|
+|description|String|The description for the tenant tag.|
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a [tenantTag](../resources/managedtenants-tenanttag.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "create_tenanttag_from_"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/tenantRelationships/managedTenants/tenantTags
+Content-Type: application/json
+Content-length: 382
+
+{
+ "displayName": "Support",
+ "description": "Tenants that have purchased extended support"
+}
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.tenantTag"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantTags/$entity",
+ "id": "11103b2b-0e28-456b-901d-45f98890ab1d",
+ "displayName": "Support",
+ "description": "Tenants that have purchased extended support",
+ "tenantIds": [],
+ "isDeleted": null,
+ "createdDateTime": "2021-07-11T19:31:49.807267Z",
+ "createdByUserId": "cad28f13-0158-43c5-9c59-952f2caa62c0",
+ "lastActionDateTime": "2021-07-11T19:31:49.8072716Z",
+ "lastActionByUserId": "cad28f13-0158-43c5-9c59-952f2caa62c0"
+}
+```
v1.0 Managedtenants Managementaction Apply https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managementaction-apply.md
+
+ Title: "managementAction: apply"
+description: "Applies a management action against a specific managed tenant. By performing this operation the appropriate configurations will be made and policies created. As example when applying the require multi-factor authentication for admins management action will create an Azure Active Directory conditional access policy that requires multi-factor authentication for all users that have been assigned an administrative directory role."
+
+localization_priority: Normal
++
+# managementAction: apply
+Namespace: microsoft.graph.managedTenants
++
+Applies a management action against a specific managed tenant. By performing this operation the appropriate configurations will be made and policies created. As example when applying the require multi-factor authentication for admins management action will create an Azure Active Directory conditional access policy that requires multi-factor authentication for all users that have been assigned an administrative directory role.
+
+## 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)|ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /tenantRelationships/managedTenants/managementActions/{managementActionId}/apply
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## 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.
+
+|Parameter|Type|Description|
+|:|:|:|
+|tenantId|String|The Azure Active Directory tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md).|
+|tenantGroupId|String|The identifier of the tenant group.|
+|managementTemplateId|String|The identifier of the [management template](../resources/managedtenants-managementtemplate.md).|
+
+## Response
+
+If successful, this action returns a `200 OK` response code and a [managementActionDeploymentStatus](../resources/managedtenants-managementactiondeploymentstatus.md) in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "managementaction_apply"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/tenantRelationships/managedTenants/managementActions/{managementActionId}/apply
+Content-Type: application/json
+Content-length: 95
+
+{
+ "tenantId": "String",
+ "tenantGroupId": "String",
+ "managementTemplateId": "String"
+}
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.managementActionDeploymentStatus"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.managedTenants.ManagementActionDeploymentStatus",
+ "managementTemplateId": "e2cadc41-a08f-45e7-8eb1-942d224dfb9a",
+ "managementActionId": "b22a4713-8428-4952-8cac-d48962ecbdc9",
+ "status": "completed",
+ "workloadActionDeploymentStatuses": [
+ {
+ "actionId": "46b80b42-06c7-45b4-b6fb-aa0aecace87b",
+ "status": "completed",
+ "deployedPolicyId": null,
+ "lastDeploymentDateTime": "2021-07-11T19:35:10.4463799Z",
+ "error": null
+ }
+ ]
+}
+```
v1.0 Managedtenants Managementaction Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managementaction-get.md
+
+ Title: "Get managementAction"
+description: "Read the properties and relationships of a managementAction object."
+
+localization_priority: Normal
++
+# Get managementAction
+Namespace: microsoft.graph.managedTenants
++
+Read the properties and relationships of a [managementAction](../resources/managedtenants-managementaction.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)|ManagedTenants.Read.All, ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/managementActions/{managementActionId}
+```
+
+## Optional query parameters
+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.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [managementAction](../resources/managedtenants-managementaction.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_managementaction"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/managementActions/{managementActionId}
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.managementAction"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/managedTenants/managementActions/$entity",
+ "id": "4274db74-99c4-40be-bbeb-da4351136be2",
+ "referenceTemplateId": "21230aa5-d5a9-4403-b179-baf2de242aca",
+ "displayName": "Baseline - Require MFA for end users",
+ "description": null,
+ "category": "identity",
+ "workloadActions": [
+ {
+ "actionId": "fcb7ace7-3ea6-4474-912a-00ee78554445",
+ "category": "automated",
+ "displayName": "ConditionalAccessPolicy",
+ "description": null,
+ "service": "AAD",
+ "settings": [
+ {
+ "valueType": "string",
+ "displayName": "DisplayName",
+ "overwriteAllowed": false,
+ "jsonValue": "\"Baseline - Require MFA for end users\""
+ },
+ {
+ "valueType": "string",
+ "displayName": "State",
+ "overwriteAllowed": false,
+ "jsonValue": "\"enabledForReportingButNotEnforced\""
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "ClientAppTypes",
+ "overwriteAllowed": false,
+ "jsonValue": "[\"All\"]"
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "IncludeApplications",
+ "overwriteAllowed": false,
+ "jsonValue": "[\"All\"]"
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "IncludeUsers",
+ "overwriteAllowed": false,
+ "jsonValue": "[\"None\"]"
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "IncludeLocations",
+ "overwriteAllowed": false,
+ "jsonValue": "[\"All\"]"
+ },
+ {
+ "valueType": "string",
+ "displayName": "GrantControls.Operator",
+ "overwriteAllowed": false,
+ "jsonValue": "\"OR\""
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "GrantControls.BuiltInControls",
+ "overwriteAllowed": false,
+ "jsonValue": "[\"mfa\"]"
+ }
+ ]
+ }
+ ]
+}
+```
v1.0 Managedtenants Managementactiontenantdeploymentstatus Changedeploymentstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managementactiontenantdeploymentstatus-changedeploymentstatus.md
+
+ Title: "managementActionTenantDeploymentStatus: changeDeploymentStatus"
+description: "Changes the tenant level deployment status for the management action. This information is used to provide insights into what management actions are in a specific state. As example there might be a plan to apply the require multi-factor authentication for admins, so it would be ideal to change the status to planned to reflect the appropriate status."
+
+localization_priority: Normal
++
+# managementActionTenantDeploymentStatus: changeDeploymentStatus
+Namespace: microsoft.graph.managedTenants
++
+Changes the tenant level deployment status for the management action. This information is used to provide insights into what management actions are in a specific state. As example there might be a plan to apply the require multi-factor authentication for admins, so it would be ideal to change the status to planned to reflect the appropriate status.
+
+## 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)|ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /tenantRelationships/managedTenants/managementActionTenantDeploymentStatuses/changeDeploymentStatus
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## 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.
+
+|Parameter|Type|Description|
+|:|:|:|
+|tenantGroupId|String|The identifier for the tenant group.|
+|tenantId|String|The Azure Active Directory tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md).|
+|managementActionId|String|The identifier for the [management action](../resources/managedtenants-managementaction.md).|
+|managementTemplateId|String|The identifier for the [management template](../resources/managedtenants-managementtemplate.md).|
+|status|String|The new status for the [management action](../resources/managedtenants-managementaction.md) tenant deployment.|
+
+## Response
+
+If successful, this action returns a `200 OK` response code and a [managementActionDeploymentStatus](../resources/managedtenants-managementactiondeploymentstatus.md) in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "managementactiontenantdeploymentstatus_changedeploymentstatus"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/tenantRelationships/managedTenants/managementActionTenantDeploymentStatuses/changeDeploymentStatus
+Content-Type: application/json
+Content-length: 153
+
+{
+ "tenantGroupId": "String",
+ "tenantId": "String",
+ "managementActionId": "String",
+ "managementTemplateId": "String",
+ "status": "String"
+}
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.managementActionDeploymentStatus"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.managedTenants.ManagementActionDeploymentStatus",
+ "managementTemplateId": "e5834405-43d2-4815-867d-3dd600308d1c",
+ "managementActionId": "e96a8cdb-0435-4808-9956-cf6b8ae77aa6",
+ "status": "planned",
+ "workloadActionDeploymentStatuses": []
+}
+```
v1.0 Managedtenants Managementactiontenantdeploymentstatus Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managementactiontenantdeploymentstatus-get.md
+
+ Title: "Get managementActionTenantDeploymentStatus"
+description: "Read the properties and relationships of a managementActionTenantDeploymentStatus object."
+
+localization_priority: Normal
++
+# Get managementActionTenantDeploymentStatus
+Namespace: microsoft.graph.managedTenants
++
+Read the properties and relationships of a [managementActionTenantDeploymentStatus](../resources/managedtenants-managementactiontenantdeploymentstatus.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)|ManagedTenants.Read.All, ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/managementActionTenantDeploymentStatuses/{managementActionTenantDeploymentStatusId}
+```
+
+## Optional query parameters
+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.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [managementActionTenantDeploymentStatus](../resources/managedtenants-managementactiontenantdeploymentstatus.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_managementactiontenantdeploymentstatus"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/managementActionTenantDeploymentStatuses/{managementActionTenantDeploymentStatusId}
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.managementActionTenantDeploymentStatus"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/managedTenants/managementActionTenantDeploymentStatuses/$entity",
+ "id": "df7aed9c-c05a-4fc9-b958-64fafaed911d_34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantGroupId": "df7aed9c-c05a-4fc9-b958-64fafaed911d",
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "statuses": [
+ {
+ "managementTemplateId": "21230aa5-d5a9-4403-b179-baf2de242aca",
+ "managementActionId": "4274db74-99c4-40be-bbeb-da4351136be2",
+ "status": "completed",
+ "workloadActionDeploymentStatuses": [
+ {
+ "actionId": "fcb7ace7-3ea6-4474-912a-00ee78554445",
+ "status": "completed",
+ "deployedPolicyId": "949e8893-68fb-4c9d-b8a0-13c229a7e397",
+ "lastDeploymentDateTime": "2021-06-22T04:09:20.3054223Z",
+ "error": null
+ }
+ ]
+ },
+ {
+ "managementTemplateId": "31d57d29-2d54-4074-84bd-51c008c2e6b2",
+ "managementActionId": "f104bb7f-4854-4209-ba09-c3788f9894c5",
+ "status": "completed",
+ "workloadActionDeploymentStatuses": [
+ {
+ "actionId": "00a9a585-f51c-4b68-b4f5-f0c3165df8ac",
+ "status": "completed",
+ "deployedPolicyId": "19a8d6a6-d87e-4059-85b3-c73bfc5cea15",
+ "lastDeploymentDateTime": "2021-06-22T17:01:44.851214Z",
+ "error": null
+ }
+ ]
+ }
+ ]
+}
+```
v1.0 Managedtenants Managementintent Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managementintent-get.md
+
+ Title: "Get managementIntent"
+description: "Read the properties and relationships of a managementIntent object."
+
+localization_priority: Normal
++
+# Get managementIntent
+Namespace: microsoft.graph.managedTenants
++
+Read the properties and relationships of a [managementIntent](../resources/managedtenants-managementintent.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)|ManagedTenants.Read.All, ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/managementIntents/{managementIntentId}
+```
+
+## Optional query parameters
+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.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [managementIntent](../resources/managedtenants-managementintent.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_managementintent"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/managementIntents/{managementIntentId}
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.managementIntent"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/managedTenants/managementIntents/$entity",
+ "id": "586895ab-8a59-4b79-be25-b06949a819bb",
+ "displayName": "Default Baseline",
+ "isGlobal": true,
+ "managementTemplates": [
+ {
+ "managementTemplateId": "e5834405-43d2-4815-867d-3dd600308d1c",
+ "displayName": "Baseline - Block Legacy Authentication",
+ "category": "identity"
+ },
+ {
+ "managementTemplateId": "12524106-036f-457f-b7a6-b003509d29c8",
+ "displayName": "Baseline - Require MFA for Admins",
+ "category": "identity"
+ },
+ {
+ "managementTemplateId": "21230aa5-d5a9-4403-b179-baf2de242aca",
+ "displayName": "Baseline - Require MFA for end users",
+ "category": "identity"
+ },
+ {
+ "managementTemplateId": "e2cadc41-a08f-45e7-8eb1-942d224dfb9a",
+ "displayName": "Baseline - Enroll devices in MEM",
+ "category": "devices"
+ },
+ {
+ "managementTemplateId": "31d57d29-2d54-4074-84bd-51c008c2e6b2",
+ "displayName": "Baseline - Setup Compliance Policy for Windows 10 devices",
+ "category": "devices"
+ },
+ {
+ "managementTemplateId": "b2d6d189-ea31-4cf8-b75e-41210c583127",
+ "displayName": "Baseline - Setup Microsoft Defender Antivirus Policy for Windows 10 devices",
+ "category": "devices"
+ }
+ ]
+}
+```
v1.0 Managedtenants Managementtemplate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-managementtemplate-get.md
+
+ Title: "Get managementTemplate"
+description: "Read the properties and relationships of a managementTemplate object."
+
+localization_priority: Normal
++
+# Get managementTemplate
+Namespace: microsoft.graph.managedTenants
++
+Read the properties and relationships of a [managementTemplate](../resources/managedtenants-managementtemplate.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)|ManagedTenants.Read.All, ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/managementTemplates/{managementTemplateId}
+```
+
+## Optional query parameters
+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.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [managementTemplate](../resources/managedtenants-managementtemplate.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_managementtemplate"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/managementTemplates/{managementTemplateId}
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.managementTemplate"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/managedTenants/managementTemplates/$entity",
+ "displayName": "Baseline - Block Legacy Authentication",
+ "description": null,
+ "category": "identity",
+ "parameters": [
+ {
+ "valueType": "string",
+ "displayName": "DisplayName",
+ "description": null,
+ "jsonDefaultValue": "\"Baseline - Block Legacy Authentication\"",
+ "jsonAllowedValues": "null"
+ },
+ {
+ "valueType": "string",
+ "displayName": "State",
+ "description": null,
+ "jsonDefaultValue": "\"enabledForReportingButNotEnforced\"",
+ "jsonAllowedValues": "[\"enabled\",\"disabled\",\"enabledForReportingButNotEnforced\"]"
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "ClientAppTypes",
+ "description": null,
+ "jsonDefaultValue": "[\"exchangeActiveSync\",\"other\"]",
+ "jsonAllowedValues": "[\"exchangeActiveSync\",\"other\"]"
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "IncludeApplications",
+ "description": null,
+ "jsonDefaultValue": "[\"All\"]",
+ "jsonAllowedValues": "[\"All\"]"
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "IncludeUsers",
+ "description": null,
+ "jsonDefaultValue": "[\"None\"]",
+ "jsonAllowedValues": "[\"All\",\"None\"]"
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "IncludeLocations",
+ "description": null,
+ "jsonDefaultValue": "[\"All\"]",
+ "jsonAllowedValues": "[\"All\",\"AllTrusted\"]"
+ },
+ {
+ "valueType": "string",
+ "displayName": "GrantControls.Operator",
+ "description": null,
+ "jsonDefaultValue": "\"OR\"",
+ "jsonAllowedValues": "[\"OR\",\"AND\"]"
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "GrantControls.BuiltInControls",
+ "description": null,
+ "jsonDefaultValue": "[\"block\"]",
+ "jsonAllowedValues": "[\"block\"]"
+ }
+ ],
+ "workloadActions": [
+ {
+ "actionId": "6a3ad0bc-5d7e-4a49-a105-c559aa4633e1",
+ "category": "automated",
+ "displayName": "ConditionalAccessPolicy",
+ "description": null,
+ "service": "AAD",
+ "settings": [
+ {
+ "valueType": "string",
+ "displayName": "DisplayName",
+ "overwriteAllowed": false,
+ "jsonValue": "\"Baseline - Block Legacy Authentication\""
+ },
+ {
+ "valueType": "string",
+ "displayName": "State",
+ "overwriteAllowed": false,
+ "jsonValue": "\"enabledForReportingButNotEnforced\""
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "ClientAppTypes",
+ "overwriteAllowed": false,
+ "jsonValue": "[\"exchangeActiveSync\",\"other\"]"
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "IncludeApplications",
+ "overwriteAllowed": false,
+ "jsonValue": "[\"All\"]"
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "IncludeUsers",
+ "overwriteAllowed": false,
+ "jsonValue": "[\"None\"]"
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "IncludeLocations",
+ "overwriteAllowed": false,
+ "jsonValue": "[\"All\"]"
+ },
+ {
+ "valueType": "string",
+ "displayName": "GrantControls.Operator",
+ "overwriteAllowed": false,
+ "jsonValue": "\"OR\""
+ },
+ {
+ "valueType": "stringCollection",
+ "displayName": "GrantControls.BuiltInControls",
+ "overwriteAllowed": false,
+ "jsonValue": "[\"block\"]"
+ }
+ ]
+ }
+ ]
+}
+```
v1.0 Managedtenants Riskyuser Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-riskyuser-get.md
+
+ Title: "Get riskyUser"
+description: "Read the properties and relationships of a riskyUser object."
+
+localization_priority: Normal
++
+# Get riskyUser
+Namespace: microsoft.graph.managedTenants
++
+Read the properties and relationships of a [riskyUser](../resources/managedtenants-riskyuser.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)|IdentityRiskyUser.Read.All, IdentityRiskyUser.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/riskyUsers/{riskyUserId}
+```
+
+## Optional query parameters
+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.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [riskyUser](../resources/managedtenants-riskyuser.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_riskyuser"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/riskyUsers/{riskyUserId}
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.riskyUser"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.managedTenants.riskyUser",
+ "id": "34298981-4fc8-4974-9486-c8909ed1521b_ae8d3a3f-be95-429c-8063-635ccc16e899",
+ "userId": "ae8d3a3f-be95-429c-8063-635ccc16e899",
+ "userDisplayName": "Cynthia Becker",
+ "userPrincipalName": "cynthia@fourthcoffee002.onmicrosoft.com",
+ "riskState": "atRisk",
+ "riskLevel": "hidden",
+ "riskDetail": "hidden",
+ "isDeleted": false,
+ "riskLastUpdatedDateTime": "2021-06-10T13:58:34.5171907Z",
+ "lastRefreshedDateTime": "2021-07-11T11:32:55.2168558Z",
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantDisplayName": "Fourth Coffee"
+}
+```
v1.0 Managedtenants Tenant Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-tenant-get.md
+
+ Title: "Get tenant"
+description: "Read the properties and relationships of a tenant object."
+
+localization_priority: Normal
++
+# Get tenant
+Namespace: microsoft.graph.managedTenants
++
+Read the properties and relationships of a [tenant](../resources/managedtenants-tenant.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)|ManagedTenants.Read.All, ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/tenants/{tenantId}
+```
+
+## Optional query parameters
+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.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [tenant](../resources/managedtenants-tenant.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_tenant"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/tenants/{tenantId}
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.tenant"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.managedTenants.tenant",
+ "id": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "contract": {
+ "displayName": "Fourth Coffee",
+ "defaultDomainName": "fourthcoffe001.onmicrosoft.com",
+ "contractType": 2
+ },
+ "tenantStatusInformation": {
+ "onboardingStatus": "ineligible",
+ "onboardingDateTime": "2012-02-20T00:00:00Z",
+ "onboardedByUserId": "",
+ "offboardedDateTime": "2012-02-20T00:00:00Z",
+ "offboardedBy": "",
+ "delegatedPrivilegeStatus": "delegatedAdminPrivileges",
+ "workloadStatuses": [
+ {
+ "displayName": "Device Management",
+ "onboardingStatus": "onboarded",
+ "onboardedDateTime": "2012-02-20T00:00:00Z",
+ "offboardedDateTime": null
+ },
+ {
+ "displayName": "Cloud PC",
+ "onboardingStatus": "notOnboarded",
+ "onboardedDateTime": "2012-02-20T00:00:00Z",
+ "offboardedDateTime": null
+ }
+ ]
+ },
+ "createdDateTime": "2012-02-20T00:00:00Z",
+ "lastUpdatedDatetime": "2021-02-20T00:00:00Z"
+}
+```
v1.0 Managedtenants Tenant Offboardtenant https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-tenant-offboardtenant.md
+
+ Title: "tenant: offboardTenant"
+description: "Carries out the appropriate procedures to remove a managed tenant from the multi-tenant management platform. No relationships, such as commerce and delegate administrative privileges, will be impacted. The only change made by invoking this action is the tenant will be deprovisioned from the multi-tenant management platform."
+
+localization_priority: Normal
++
+# tenant: offboardTenant
+Namespace: microsoft.graph.managedTenants
++
+Carries out the appropriate procedures to remove a managed tenant from the multi-tenant management platform. No relationships, such as commerce and delegate administrative privileges, will be impacted. The only change made by invoking this action is the tenant will be deprovisioned from the multi-tenant management platform.
+
+## 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)|ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /tenantRelationships/managedTenants/tenants/{tenantId}/offboardTenant
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this action returns a `200 OK` response code and a [tenant](../resources/managedtenants-tenant.md) in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "tenant_offboardtenant"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/tenantRelationships/managedTenants/tenants/{tenantId}/offboardTenant
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.tenant"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.managedTenants.tenant",
+ "id": "String (identifier)",
+ "tenantId": "String",
+ "displayName": "String",
+ "contract": {
+ "@odata.type": "microsoft.graph.managedTenants.tenantContract"
+ },
+ "tenantStatusInformation": {
+ "@odata.type": "microsoft.graph.managedTenants.tenantStatusInformation"
+ },
+ "lastUpdatedDateTime": "String (timestamp)",
+ "createdDateTime": "String (timestamp)"
+ }
+}
+```
v1.0 Managedtenants Tenant Resettenantonboardingstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-tenant-resettenantonboardingstatus.md
+
+ Title: "tenant: resetTenantOnboardingStatus"
+description: "Carries out the appropriate procedures to reset the onboarding status for the managed tenant that was removed from the multi-tenant management platform using the offboardTenant action. By invoking this action the platform will attempt to onboard the managed tenant for management."
+
+localization_priority: Normal
++
+# tenant: resetTenantOnboardingStatus
+Namespace: microsoft.graph.managedTenants
++
+Carries out the appropriate procedures to reset the onboarding status for the managed tenant that was removed from the multi-tenant management platform using the [offboardTenant](../api/managedtenants-tenant-offboardtenant.md) action. By invoking this action the platform will attempt to onboard the managed tenant for management.
+
+## 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)|ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /tenantRelationships/managedTenants/tenants/{tenantId}/resetTenantOnboardingStatus
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this action returns a `200 OK` response code and a [tenant](../resources/managedtenants-tenant.md) in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "tenant_resettenantonboardingstatus"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/tenantRelationships/managedTenants/tenants/{tenantId}/resetTenantOnboardingStatus
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.tenant"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.managedTenants.tenant",
+ "id": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "contract": {
+ "displayName": "Fourth Coffee",
+ "defaultDomainName": "fourthcoffe001.onmicrosoft.com",
+ "contractType": 2
+ },
+ "tenantStatusInformation": {
+ "onboardingStatus": "inactive",
+ "onboardingDateTime": "2012-02-20T00:00:00Z",
+ "onboardedByUserId": "",
+ "offboardedDateTime": "2012-02-20T00:00:00Z",
+ "offboardedBy": "",
+ "delegatedPrivilegeStatus": "delegatedAdminPrivileges",
+ "workloadStatuses": []
+ },
+ "createdDateTime": "2012-02-20T00:00:00Z",
+ "lastUpdatedDatetime": "2021-02-20T00:00:00Z"
+}
+```
v1.0 Managedtenants Tenantcustomizedinformation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-tenantcustomizedinformation-get.md
+
+ Title: "Get tenantCustomizedInformation"
+description: "Read the properties and relationships of a tenantCustomizedInformation object."
+
+localization_priority: Normal
++
+# Get tenantCustomizedInformation
+Namespace: microsoft.graph.managedTenants
++
+Read the properties and relationships of a [tenantCustomizedInformation](../resources/managedtenants-tenantcustomizedinformation.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)|ManagedTenants.Read.All, ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/tenantsCustomizedInformation/{tenantCustomizedInformationId}
+```
+
+## Optional query parameters
+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.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [tenantCustomizedInformation](../resources/managedtenants-tenantcustomizedinformation.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_tenantcustomizedinformation"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/tenantsCustomizedInformation/{tenantCustomizedInformationId}
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.tenantCustomizedInformation"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.managedTenants.tenantCustomizedInformation",
+ "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"
+ }
+ ]
+}
+```
v1.0 Managedtenants Tenantcustomizedinformation Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-tenantcustomizedinformation-update.md
+
+ Title: "Update tenantCustomizedInformation"
+description: "Update the properties of a tenantCustomizedInformation object."
+
+localization_priority: Normal
++
+# Update tenantCustomizedInformation
+Namespace: microsoft.graph.managedTenants
++
+Update the properties of a [tenantCustomizedInformation](../resources/managedtenants-tenantcustomizedinformation.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)|ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /tenantRelationships/managedTenants/tenantsCustomizedInformation/{tenantCustomizedInformationId}
+```
+
+## 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 [tenantCustomizedInformation](../resources/managedtenants-tenantcustomizedinformation.md) object.
+
+The following table shows the properties that are required when you update the [tenantCustomizedInformation](../resources/managedtenants-tenantcustomizedinformation.md).
+
+|Property|Type|Description|
+|:|:|:|
+|id|String|The Azure Active Directory tenant identifier for the managed tenant.|
+|tenantId|String|The Azure Active Directory tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md).|
+|contacts|[microsoft.graph.managedTenants.tenantContactInformation](../resources/managedtenants-tenantcontactinformation.md) collection|The collection of contacts associated with the managed tenant.|
+|website|String|The website for the managed tenant.|
+
+## Response
+
+If successful, this method returns a `200 OK` response code and an updated [tenantCustomizedInformation](../resources/managedtenants-tenantcustomizedinformation.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "update_tenantcustomizedinformation"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/tenantRelationships/managedTenants/tenantsCustomizedInformation/{tenantCustomizedInformationId}
+Content-Type: application/json
+Content-length: 278
+
+{
+ "@odata.type": "#microsoft.graph.managedTenants.tenantCustomizedInformation",
+ "tenantId": "String",
+ "contacts": [
+ {
+ "@odata.type": "microsoft.graph.managedTenants.tenantContactInformation"
+ }
+ ],
+ "website": "String"
+}
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.tenantCustomizedInformation"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.managedTenants.tenantCustomizedInformation",
+ "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"
+ }
+ ]
+}
+```
v1.0 Managedtenants Tenantdetailedinformation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-tenantdetailedinformation-get.md
+
+ Title: "Get tenantDetailedInformation"
+description: "Read the properties and relationships of a tenantDetailedInformation object."
+
+localization_priority: Normal
++
+# Get tenantDetailedInformation
+Namespace: microsoft.graph.managedTenants
++
+Read the properties and relationships of a [tenantDetailedInformation](../resources/managedtenants-tenantdetailedinformation.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)|ManagedTenants.Read.All, ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/tenantsDetailedInformation/{tenantDetailedInformationId}
+```
+
+## Optional query parameters
+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.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [tenantDetailedInformation](../resources/managedtenants-tenantdetailedinformation.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_tenantdetailedinformation"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/tenantsDetailedInformation/{tenantDetailedInformationId}
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.tenantDetailedInformation"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.managedTenants.tenantDetailedInformation",
+ "id": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "companyName": "Fourth Coffee",
+ "defaultDomainName": "fourthcoffee001.onmicrosoft.com",
+ "countryName": "United States",
+ "countryCode": "US",
+ "city": "Redmond",
+ "region": "NA",
+ "verticalName": "Software",
+ "industryName": "Computer",
+ "segmentName": "Service"
+}
+```
v1.0 Managedtenants Tenantgroup Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-tenantgroup-get.md
+
+ Title: "Get tenantGroup"
+description: "Read the properties and relationships of a tenantGroup object."
+
+localization_priority: Normal
++
+# Get tenantGroup
+Namespace: microsoft.graph.managedTenants
++
+Read the properties and relationships of a [tenantGroup](../resources/managedtenants-tenantgroup.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)|ManagedTenants.Read.All, ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/tenantGroups/{tenantGroupId}
+```
+
+## Optional query parameters
+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.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [tenantGroup](../resources/managedtenants-tenantgroup.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_tenantgroup"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/tenantGroups/{tenantGroupId}
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.tenantGroup"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/managedTenants/tenantGroups/$entity",
+ "id": "df7aed9c-c05a-4fc9-b958-64fafaed911d",
+ "displayName": "Default",
+ "allTenantsIncluded": true,
+ "tenantIds": [],
+ "managementIntents": [
+ {
+ "managementIntentId": "586895ab-8a59-4b79-be25-b06949a819bb",
+ "managementIntentDisplayName": "Default Baseline",
+ "managementTemplates": [
+ {
+ "managementTemplateId": "e5834405-43d2-4815-867d-3dd600308d1c",
+ "displayName": "Baseline - Block Legacy Authentication",
+ "category": "identity"
+ },
+ {
+ "managementTemplateId": "12524106-036f-457f-b7a6-b003509d29c8",
+ "displayName": "Baseline - Require MFA for Admins",
+ "category": "identity"
+ },
+ {
+ "managementTemplateId": "21230aa5-d5a9-4403-b179-baf2de242aca",
+ "displayName": "Baseline - Require MFA for end users",
+ "category": "identity"
+ },
+ {
+ "managementTemplateId": "e2cadc41-a08f-45e7-8eb1-942d224dfb9a",
+ "displayName": "Baseline - Enroll devices in MEM",
+ "category": "devices"
+ },
+ {
+ "managementTemplateId": "31d57d29-2d54-4074-84bd-51c008c2e6b2",
+ "displayName": "Baseline - Setup Compliance Policy for Windows 10 devices",
+ "category": "devices"
+ },
+ {
+ "managementTemplateId": "b2d6d189-ea31-4cf8-b75e-41210c583127",
+ "displayName": "Baseline - Setup Microsoft Defender Antivirus Policy for Windows 10 devices",
+ "category": "devices"
+ }
+ ]
+ }
+ ],
+ "managementActions": [
+ {
+ "managementTemplateId": "12524106-036f-457f-b7a6-b003509d29c8",
+ "managementActionId": "eac82706-9f32-4274-ba5b-cf1f8ecf042b"
+ },
+ {
+ "managementTemplateId": "31d57d29-2d54-4074-84bd-51c008c2e6b2",
+ "managementActionId": "f104bb7f-4854-4209-ba09-c3788f9894c5"
+ },
+ {
+ "managementTemplateId": "21230aa5-d5a9-4403-b179-baf2de242aca",
+ "managementActionId": "4274db74-99c4-40be-bbeb-da4351136be2"
+ },
+ {
+ "managementTemplateId": "e5834405-43d2-4815-867d-3dd600308d1c",
+ "managementActionId": "e96a8cdb-0435-4808-9956-cf6b8ae77aa6"
+ },
+ {
+ "managementTemplateId": "b2d6d189-ea31-4cf8-b75e-41210c583127",
+ "managementActionId": "55f8da1a-4eec-4fb2-9c58-4c4b3cdf7222"
+ },
+ {
+ "managementTemplateId": "e2cadc41-a08f-45e7-8eb1-942d224dfb9a",
+ "managementActionId": "b22a4713-8428-4952-8cac-d48962ecbdc9"
+ }
+ ]
+}
+```
v1.0 Managedtenants Tenantgroup Tenantsearch https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-tenantgroup-tenantsearch.md
+
+ Title: "tenantGroup: tenantSearch"
+description: "Searches for the specified managed tenants across tenant groups."
+
+localization_priority: Normal
++
+# tenantGroup: tenantSearch
+Namespace: microsoft.graph.managedTenants
++
+Searches for the specified managed tenants across tenant groups.
+
+## 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)|ManagedTenants.Read.All, ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /tenantRelationships/managedTenants/tenantGroups/tenantSearch
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## 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.
+
+|Parameter|Type|Description|
+|:|:|:|
+|tenantId|String|The Azure Active Directory tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md).|
+++
+## Response
+
+If successful, this action returns a `200 OK` response code and a [microsoft.graph.managedTenants.tenantGroup](../resources/managedtenants-tenantgroup.md) collection in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "tenantgroup_tenantsearch"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/tenantRelationships/managedTenants/tenantGroups/tenantSearch
+Content-Type: application/json
+Content-length: 28
+
+{
+ "tenantId": "String"
+}
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.tenantGroup)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantGroups",
+ "value": [
+ {
+ "id": "2e6a0c9f-986d-480e-ad4b-bdfddc047aba",
+ "displayName": "Default",
+ "allTenantsIncluded": true,
+ "tenantIds": [],
+ "managementIntents": [
+ {
+ "managementIntentId": "586895ab-8a59-4b79-be25-b06949a819bb",
+ "managementIntentDisplayName": "Default Baseline",
+ "managementTemplates": [
+ {
+ "managementTemplateId": "e5834405-43d2-4815-867d-3dd600308d1c",
+ "displayName": "Baseline - Block Legacy Authentication",
+ "category": "identity"
+ },
+ {
+ "managementTemplateId": "12524106-036f-457f-b7a6-b003509d29c8",
+ "displayName": "Baseline - Require MFA for Admins",
+ "category": "identity"
+ },
+ {
+ "managementTemplateId": "21230aa5-d5a9-4403-b179-baf2de242aca",
+ "displayName": "Baseline - Require MFA for end users",
+ "category": "identity"
+ },
+ {
+ "managementTemplateId": "e2cadc41-a08f-45e7-8eb1-942d224dfb9a",
+ "displayName": "Baseline - Enroll devices in MEM",
+ "category": "devices"
+ },
+ {
+ "managementTemplateId": "31d57d29-2d54-4074-84bd-51c008c2e6b2",
+ "displayName": "Baseline - Setup Compliance Policy for Windows 10 devices",
+ "category": "devices"
+ },
+ {
+ "managementTemplateId": "b2d6d189-ea31-4cf8-b75e-41210c583127",
+ "displayName": "Baseline - Setup Microsoft Defender Antivirus Policy for Windows 10 devices",
+ "category": "devices"
+ }
+ ]
+ }
+ ],
+ "managementActions": []
+ }
+ ]
+}
+```
v1.0 Managedtenants Tenanttag Assigntag https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-tenanttag-assigntag.md
+
+ Title: "tenantTag: assignTag"
+description: "Assign the tenant tag to the specified managed tenants."
+
+localization_priority: Normal
++
+# tenantTag: assignTag
+Namespace: microsoft.graph.managedTenants
++
+Assign the tenant tag to the specified managed tenants.
+
+## 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)|ManagedTenants.WriteRead.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /tenantRelationships/managedTenants/tenantTags/{tenantTagId}/assignTag
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## 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.
+
+|Parameter|Type|Description|
+|:|:|:|
+|tenantIds|String collection|The collection of Azure Active Directory tenant identifiers where the tenant tag should be assigned.|
+
+## Response
+
+If successful, this action returns a `200 OK` response code and a [tenantTag](../resources/managedtenants-tenanttag.md) in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "tenanttag_assigntag"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/tenantRelationships/managedTenants/tenantTags/{tenantTagId}/assignTag
+Content-Type: application/json
+Content-length: 41
+
+{
+ "tenantIds": [
+ "String"
+ ]
+}
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.tenantTag"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantTags/$entity",
+ "id": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "displayName": "Support",
+ "description": "Tenants that have purchased support",
+ "tenants": [
+ {
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b"
+ }
+ ],
+ "isDeleted": null,
+ "createdDateTime": "2021-06-26T13:51:23.3927236Z",
+ "createdByUserId": "65ca7649-4ccb-4823-9c39-42bd75191bf8",
+ "lastActionDateTime": "2021-07-11T19:55:19.7230386Z",
+ "lastActionByUserId": "50bf7bd8-1b3a-4d1d-94c5-86d27e68857f"
+}
+```
v1.0 Managedtenants Tenanttag Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-tenanttag-delete.md
+
+ Title: "Delete tenantTag"
+description: "Deletes a tenantTag object."
+
+localization_priority: Normal
++
+# Delete tenantTag
+Namespace: microsoft.graph.managedTenants
++
+Deletes a [tenantTag](../resources/managedtenants-tenanttag.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)|ManagedTenants.WriteRead.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /tenantRelationships/managedTenants/tenantTags/{tenantTagId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "delete_tenanttag"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/beta/tenantRelationships/managedTenants/tenantTags/{tenantTagId}
+```
++
+### 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 Managedtenants Tenanttag Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-tenanttag-get.md
+
+ Title: "Get tenantTag"
+description: "Read the properties and relationships of a tenantTag object."
+
+localization_priority: Normal
++
+# Get tenantTag
+Namespace: microsoft.graph.managedTenants
++
+Read the properties and relationships of a [tenantTag](../resources/managedtenants-tenanttag.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)|ManagedTenants.Read.All, ManagedTenants.WriteRead.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/tenantTags/{tenantTagId}
+```
+
+## Optional query parameters
+This method supports the [OData query parameters](/graph/query-parameters) to help customize the response, including `$count`, `$filter`, `$orderBy`, `$select`, `$skip`, and `$top`.
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [tenantTag](../resources/managedtenants-tenanttag.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_tenanttag"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/tenantTags/{tenantTagId}
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.tenantTag"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/managedTenants/tenantTags/$entity",
+ "id": "913391c0-5466-42b4-900d-0a7501399cb0",
+ "displayName": "Onboarding",
+ "description": "Tenants that we are currently onboarding",
+ "tenantIds": [
+ "38227791-a88b-4fcc-81c5-58cf77668320",
+ "34298981-4fc8-4974-9486-c8909ed1521b",
+ "4d262a25-c70a-430b-9e8e-46c31dec116b"
+ ],
+ "isDeleted": null,
+ "createdDateTime": "2021-06-16T20:36:31.086644Z",
+ "createdByUserId": "9bf6a5ad-aecb-4194-a16b-38e02702a602",
+ "lastActionDateTime": "2021-06-28T20:46:09.0071888Z",
+ "lastActionByUserId": "08ea0285-30cb-46cc-abc8-3d8422e21ecb",
+ "tenants": [
+ {
+ "tenantId": "38227791-a88b-4fcc-81c5-58cf77668320"
+ },
+ {
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b"
+ },
+ {
+ "tenantId": "4d262a25-c70a-430b-9e8e-46c31dec116b"
+ }
+ ]
+}
+```
v1.0 Managedtenants Tenanttag Unassigntag https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-tenanttag-unassigntag.md
+
+ Title: "tenantTag: unassignTag"
+description: "Un-assigns the tenant tag from the specified managed tenants."
+
+localization_priority: Normal
++
+# tenantTag: unassignTag
+Namespace: microsoft.graph.managedTenants
++
+Un-assigns the tenant tag from the specified managed tenants.
+
+## 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)|ManagedTenants.WriteRead.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /tenantRelationships/managedTenants/tenantTags/{tenantTagId}/unassignTag
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## 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.
+
+|Parameter|Type|Description|
+|:|:|:|
+|tenantIds|String collection|The collection of Azure Active Directory tenant identifiers for managed tenants.|
+
+## Response
+
+If successful, this action returns a `200 OK` response code and a [tenantTag](../resources/managedtenants-tenanttag.md) in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "tenanttag_unassigntag"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/tenantRelationships/managedTenants/tenantTags/{tenantTagId}/unassignTag
+Content-Type: application/json
+Content-length: 41
+
+{
+ "tenantIds": [
+ "String"
+ ]
+}
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.tenantTag"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantTags/$entity",
+ "id": "2a66c69f-87ec-4fb3-a797-dd500cc3454d",
+ "displayName": "Support",
+ "description": "Tenants that has purcahsed support",
+ "tenants": [],
+ "isDeleted": null,
+ "createdDateTime": "2021-06-26T13:51:23.3927236Z",
+ "createdByUserId": "65ca7649-4ccb-4823-9c39-42bd75191bf8",
+ "lastActionDateTime": "2021-07-11T19:57:56.4242898Z",
+ "lastActionByUserId": "50bf7bd8-1b3a-4d1d-94c5-86d27e68857f"
+}
+```
v1.0 Managedtenants Tenanttag Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-tenanttag-update.md
+
+ Title: "Update tenantTag"
+description: "Update the properties of a tenantTag object."
+
+localization_priority: Normal
++
+# Update tenantTag
+Namespace: microsoft.graph.managedTenants
++
+Update the properties of a [tenantTag](../resources/managedtenants-tenanttag.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)|ManagedTenants.WriteRead.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /tenantRelationships/managedTenants/tenantTags/{tenantTagId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply the values for relevant [tenantTag](../resources/managedtenants-tenanttag.md) fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+
+Following properties can be updated:
+
+| Property | Type | Description |
+|:-|:|:|
+|displayName|String|The display name for the tenant tag.|
+|description|String|The description for the tenant tag.|
+|tenants|[microsoft.graph.managedTenants.tenantInfo](../resources/managedtenants-tenantinfo.md) collection|The collection of managed tenants associated with the tenant tag.|
+
+## Response
+
+If successful, this method returns a `200 OK` response code and an updated [tenantTag](../resources/managedtenants-tenanttag.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "update_tenanttag"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/tenantRelationships/managedTenants/tenantTags/{tenantTagId}
+Content-Type: application/json
+Content-length: 382
+
+{
+ "displayName": "Onboarding",
+ "description": "Tenants that we are currently onboarding"
+}
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.tenantTag"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantTags/$entity",
+ "id": "913391c0-5466-42b4-900d-0a7501399cb0",
+ "displayName": "Onboarding",
+ "description": "Tenants that we are currently onboarding",
+ "tenantIds": [
+ {
+ "tenantId": "38227791-a88b-4fcc-81c5-58cf77668320"
+ }
+ ],
+ "isDeleted": null,
+ "createdDateTime": "2021-06-16T20:36:31.086644Z",
+ "createdByUserId": "9bf6a5ad-aecb-4194-a16b-38e02702a602",
+ "lastActionDateTime": "2021-07-11T18:54:44.5262828Z",
+ "lastActionByUserId": "cad28f13-0158-43c5-9c59-952f2caa62c0"
+}
+```
v1.0 Managedtenants Windowsdevicemalwarestate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-windowsdevicemalwarestate-get.md
+
+ Title: "Get windowsDeviceMalwareState"
+description: "Read the properties and relationships of a windowsDeviceMalwareState object."
+
+localization_priority: Normal
++
+# Get windowsDeviceMalwareState
+Namespace: microsoft.graph.managedTenants
++
+Read the properties and relationships of a [windowsDeviceMalwareState](../resources/managedtenants-windowsdevicemalwarestate.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)|DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/windowsDeviceMalwareStates/{windowsDeviceMalwareStateId}
+```
+
+## Optional query parameters
+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.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [windowsDeviceMalwareState](../resources/managedtenants-windowsdevicemalwarestate.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_windowsdevicemalwarestate"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/windowsDeviceMalwareStates/{windowsDeviceMalwareStateId}
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.windowsDeviceMalwareState"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.managedTenants.windowsDeviceMalwareState",
+ "id": "34298981-4fc8-4974-9486-c8909ed1521b_c9c8328e-7be6-48f6-8ddc-be3aae112f0d_2147714402",
+ "managedDeviceId": "c9c8328e-7be6-48f6-8ddc-be3aae112f0d",
+ "managedDeviceName": "vm12",
+ "malwareId": "2147714402",
+ "malwareExecutionState": "Unknown",
+ "malwareThreatState": "Active",
+ "initialDetectionDateTime": "2021-07-09T14:33:49Z",
+ "lastStateChangeDateTime": "2021-07-09T14:33:49Z",
+ "detectionCount": 9,
+ "deviceDeleted": false,
+ "malwareCategory": "TrojanDownloader",
+ "malwareSeverity": "Severe",
+ "malwareDisplayName": "TrojanDownloader:Win32/Vigorf.A",
+ "lastRefreshedDateTime": "2021-07-11T00:02:20.7750537Z",
+ "additionalInformationUrl": "https://go.microsoft.com/fwlink/?linkid=37020&name=TrojanDownloader%3AWin32%2FVigorf%2EA&threatid=2147714402&enterprise=1",
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantDisplayName": "Fourth Coffee"
+}
+```
v1.0 Managedtenants Windowsprotectionstate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/managedtenants-windowsprotectionstate-get.md
+
+ Title: "Get windowsProtectionState"
+description: "Read the properties and relationships of a windowsProtectionState object."
+
+localization_priority: Normal
++
+# Get windowsProtectionState
+Namespace: microsoft.graph.managedTenants
++
+Read the properties and relationships of a [windowsProtectionState](../resources/managedtenants-windowsprotectionstate.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)|DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/windowsProtectionStates/{windowsProtectionStateId}
+```
+
+## Optional query parameters
+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.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [windowsProtectionState](../resources/managedtenants-windowsprotectionstate.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_windowsprotectionstate"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/windowsProtectionStates/{windowsProtectionStateId}
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.managedTenants.windowsProtectionState"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/managedTenants/windowsProtectionStates/$entity",
+ "id": "34298981-4fc8-4974-9486-c8909ed1521b_95378ac4-eded-4671-8fa2-4e42e5de3463",
+ "managedDeviceId": "95378ac4-eded-4671-8fa2-4e42e5de3463",
+ "managedDeviceName": "vm11",
+ "malwareProtectionEnabled": true,
+ "managedDeviceHealthState": "Clean",
+ "realTimeProtectionEnabled": true,
+ "networkInspectionSystemEnabled": true,
+ "quickScanOverdue": false,
+ "fullScanOverdue": false,
+ "signatureUpdateOverdue": false,
+ "rebootRequired": false,
+ "attentionRequired": false,
+ "fullScanRequired": false,
+ "engineVersion": "1.1.18300.4",
+ "signatureVersion": "1.343.642.0",
+ "antiMalwareVersion": "4.18.2106.6",
+ "lastQuickScanDateTime": "2021-06-24T14:50:28Z",
+ "lastFullScanDateTime": null,
+ "lastQuickScanSignatureVersion": "1.341.1288.0",
+ "lastFullScanSignatureVersion": "0.0.0.0",
+ "lastReportedDateTime": "2021-07-09T14:43:45Z",
+ "devicePropertiesRefreshTime": "2021-07-09T14:44:28Z",
+ "deviceDeleted": false,
+ "lastRefreshedDateTime": "2021-07-11T02:02:35.9816065Z",
+ "tenantId": "34298981-4fc8-4974-9486-c8909ed1521b",
+ "tenantDisplayName": "Fourth Coffee",
+ "devicePropertiesRefreshDateTime": "2021-07-09T14:44:28Z"
+}
+```
v1.0 Mobileappmanagementpolicies Delete Includedgroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/mobileappmanagementpolicies-delete-includedgroups.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|Policy.ReadWrite.All|
+|Delegated (work or school account)|Policy.ReadWrite.MobilityManagement|
|Delegated (personal Microsoft account) | Not supported.| |Application | Not supported.|
v1.0 Mobileappmanagementpolicies Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/mobileappmanagementpolicies-delete.md
+
+ Title: "Delete mobileAppManagementPolicy"
+description: "Delete a mobile app management policy."
+
+localization_priority: Normal
++
+# Delete mobileAppManagementPolicy
+
+Namespace: microsoft.graph
++
+Delete a [mobilityManagementPolicy](../resources/mobilitymanagementpolicy.md) object.
+
+> [!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
+
+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)|Policy.ReadWrite.MobilityManagement|
+|Delegated (personal Microsoft account) | Not supported.|
+|Application | Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+DELETE /policies/mobileAppManagementPolicies/{id}
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "delete_mobilitymanagementpolicy"
+}
+-->
+
+``` http
+DELETE https://graph.microsoft.com/beta/policies/mobileAppManagementPolicies/ab90bacf-55a3-4a3e-839a-aa4b74e4f020
+```
+
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Mobileappmanagementpolicies Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/mobileappmanagementpolicies-get.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.All|
+|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.MobilityManagement|
|Delegated (personal Microsoft account) | Not supported.| |Application | Not supported.|
v1.0 Mobileappmanagementpolicies List Includedgroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/mobileappmanagementpolicies-list-includedgroups.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.All|
+|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.MobilityManagement|
|Delegated (personal Microsoft account) | Not supported.| |Application | Not supported.|
v1.0 Mobileappmanagementpolicies List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/mobileappmanagementpolicies-list.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.All|
+|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.MobilityManagement|
|Delegated (personal Microsoft account) | Not supported.| |Application | Not supported.|
v1.0 Mobileappmanagementpolicies Post Includedgroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/mobileappmanagementpolicies-post-includedgroups.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.All|
+|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.MobilityManagement|
|Delegated (personal Microsoft account) | Not supported.| |Application | Not supported.|
v1.0 Mobileappmanagementpolicies Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/mobileappmanagementpolicies-update.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.All|
+|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.MobilityManagement|
|Delegated (personal Microsoft account) | Not supported.| |Application | Not supported.|
v1.0 Mobiledevicemanagementpolicies Delete Includedgroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/mobiledevicemanagementpolicies-delete-includedgroups.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|Policy.ReadWrite.All|
+|Delegated (work or school account)|Policy.ReadWrite.MobilityManagement|
|Delegated (personal Microsoft account) | Not supported.| |Application | Not supported.|
v1.0 Mobiledevicemanagementpolicies Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/mobiledevicemanagementpolicies-delete.md
+
+ Title: "Delete mobileDeviceManagementPolicy"
+description: "Delete a mobile device management policy."
+
+localization_priority: Normal
++
+# Delete mobileDeviceManagementPolicy
+
+Namespace: microsoft.graph
++
+Delete a [mobilityManagementPolicy](../resources/mobilitymanagementpolicy.md) object.
+
+> [!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
+
+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)|Policy.ReadWrite.MobilityManagement|
+|Delegated (personal Microsoft account) | Not supported.|
+|Application | Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+DELETE /policies/mobileDeviceManagementPolicies/{id}
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "delete_mobilitymanagementpolicy"
+}
+-->
+
+``` http
+DELETE https://graph.microsoft.com/beta/policies/mobileDeviceManagementPolicies/ab90bacf-55a3-4a3e-839a-aa4b74e4f020
+```
+
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Mobiledevicemanagementpolicies Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/mobiledevicemanagementpolicies-get.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.All|
+|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.MobilityManagement|
|Delegated (personal Microsoft account) | Not supported.| |Application | Not supported.|
v1.0 Mobiledevicemanagementpolicies List Includedgroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/mobiledevicemanagementpolicies-list-includedgroups.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.All|
+|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.MobilityManagement|
|Delegated (personal Microsoft account) | Not supported.| |Application | Not supported.|
v1.0 Mobiledevicemanagementpolicies List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/mobiledevicemanagementpolicies-list.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.All|
+|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.MobilityManagement|
|Delegated (personal Microsoft account) | Not supported.| |Application | Not supported.|
v1.0 Mobiledevicemanagementpolicies Post Includedgroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/mobiledevicemanagementpolicies-post-includedgroups.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.All|
+|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.MobilityManagement|
|Delegated (personal Microsoft account) | Not supported.| |Application | Not supported.|
v1.0 Mobiledevicemanagementpolicies Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/mobiledevicemanagementpolicies-update.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.All|
+|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.MobilityManagement|
|Delegated (personal Microsoft account) | Not supported.| |Application | Not supported.|
v1.0 Orgcontact List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/orgcontact-list.md
One of the following permissions is required to call this API. To learn more, in
GET /contacts ``` ## Optional query parameters
-This method supports the [OData query parameters](/graph/query_parameters) to help customize the response, including `$search`, `$count`, and `$filter`. You can use `$search` on the **displayName** property. When items are added or updated for this resource, they are specially indexed for use with the `$count` and `$search` query parameters. There can be a slight delay between when an item is added or updated and when it is available in the index.
+This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
## Request headers | Name | Description| |:--|:-| | Authorization | Bearer {token}. Required. |
-| ConsistencyLevel | eventual. This header and `$count` are required when using `$search`, or when using `$filter` with the `$orderby` query parameter. It uses an index that may not be up-to-date with recent changes to the object. |
+| ConsistencyLevel | eventual. This header and `$count` are required when using `$search`, or in specific usage of `$filter`. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). |
## Request body Do not supply a request body for this method.
Content-length: 222
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$count` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- { "blockType": "ignored",
The following is an example of the response.
```http HTTP/1.1 200 OK Content-type: text/plain
-```
893
+```
+ ### Example 3: Use $filter and $top to get one organizational contact with a display name that starts with 'a' including a count of returned objects #### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string because the request has both the `$orderBy` and `$filter` query parameters. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_a_count" }--> ```msgraph-interactive
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` and the `$count=true` query string is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_phone_count" }--> ```msgraph-interactive
v1.0 Serviceprincipal List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-list.md
GET /servicePrincipals
## Optional query parameters
-This method supports the [OData query parameters](/graph/query_parameters) to help customize the response, including `$search`, `$count`, and `$filter`. You can use `$search` on the **displayName** property. When items are added or updated for this resource, they are specially indexed for use with the `$count` and `$search` query parameters. There can be a slight delay between when an item is added or updated and when it is available in the index.
+This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
## Request headers | Name | Description | |:- |:-- | | Authorization | Bearer {token}. Required. |
-| ConsistencyLevel | eventual. This header and `$count` are required when using `$search`, or when using `$filter` with the `$orderby` query parameter. It uses an index that may not be up-to-date with recent changes to the object. |
+| ConsistencyLevel | eventual. This header and `$count` are required when using `$search`, or in specific usage of `$filter`. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). |
## Request body
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$count` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- { "blockType": "ignored",
Content-type: text/plain
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string because the request has both the `$orderBy` and `$filter` query parameters. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_a_count" }--> ```msgraph-interactive
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` and the `$count=true` query string is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_team_count" }--> ```msgraph-interactive
v1.0 Accesspackage https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accesspackage.md
To assign a user to an access package, [create an accessPackageAssignmentRequest
| [Delete accessPackage](../api/accesspackage-delete.md) |None | Delete an **accesspackage**. | | [List accessPackageResourceRoleScopes](../api/accesspackage-list-accesspackageresourcerolescopes.md) | [accessPackageResourceRoleScope](accesspackageresourcerolescope.md) collection | Retrieve a list of **accessPackageResourceRoleScope** objects for this access package. | | [Create accessPackageResourceRoleScope](../api/accesspackage-post-accesspackageresourcerolescopes.md) |None | Create a new **accessPackageResourceRoleScope** object for this access package. |
+| [List incompatibleAccessPackages](../api/accesspackage-list-incompatibleaccesspackages.md) | [accessPackage](accesspackage.md) collection | Retrieve a list of the incompatible **accesspackage** objects for this access package. |
+| [Add accessPackage to incompatibleAccessPackages](../api/accesspackage-post-incompatibleaccesspackage.md) | None | Add a link to indicate another **accesspackage** is incompatible with a specified access package. |
+| [Remove accessPackage from incompatibleAccessPackages](../api/accesspackage-delete-incompatibleaccesspackage.md) | None | Remove a link that indicated an **accesspackage** was incompatible. |
+| [List incompatibleGroups](../api/accesspackage-list-incompatiblegroups.md) | [group](group.md) collection | Retrieve a list of the incompatible **group** objects for this access package. |
+| [Add group to incompatibleGroups](../api/accesspackage-post-incompatiblegroup.md) | None | Add a link to indicate membership of a **group** is incompatible with a specified access package. |
+| [Remove group from incompatibleGroups](../api/accesspackage-delete-incompatiblegroup.md) | None | Remove a link that indicated a **group** membership was incompatible.|
+| [List accessPackagesIncompatibleWith](../api/accesspackage-list-accesspackagesincompatiblewith.md) | [accessPackage](accesspackage.md) collection | Retrieve a list of the **accesspackage** objects which list this access package as incompatible. |
|[filterByCurrentUser](../api/accesspackage-filterbycurrentuser.md)|[accessPackage](../resources/accesspackage.md) collection|Retrieve the list of **accessPackage** objects filtered on the signed-in user.| ## Properties
To assign a user to an access package, [create an accessPackageAssignmentRequest
|accessPackageAssignmentPolicies|[accessPackageAssignmentPolicy](accesspackageassignmentpolicy.md) collection| Read-only. Nullable.| |accessPackageCatalog|[accessPackageCatalog](accesspackagecatalog.md)| Read-only. Nullable.| |accessPackageResourceRoleScopes|[accessPackageResourceRoleScope](accesspackageresourcerolescope.md) collection| Nullable.|
+| incompatibleAccessPackages | [accessPackage](accesspackagecatalog.md) collection | The access packages whose assigned users are ineligible to be assigned this access package. |
+| accessPackagesIncompatibleWith | [accessPackage](accesspackagecatalog.md) collection | The access packages that are incompatible with this package. Read-only. |
+| incompatibleGroups | [group](group.md) collection | The groups whose members are ineligible to be assigned this access package. |
+ ## JSON representation
v1.0 Application https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/application.md
This resource supports using [delta query](/graph/delta-query-overview) to track
## Properties
+> [!IMPORTANT]
+> Specific usage of `$filter` and the `$search` query parameter is supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+ | Property | Type | Description | |:|:--|:-| | addIns | [addIn](addin.md) collection | Defines custom behavior that a consuming service can use to call an app in specific contexts. For example, applications that can render file streams [may set the addIns property](/onedrive/developer/file-handlers/?view=odsp-graph-online) for its "FileHandler" functionality. This will let services like Office 365 call the application in the context of a document the user is working on. |
v1.0 B2cidentityuserflow https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/b2cidentityuserflow.md
To help you set up the most common identity tasks for your applications, Azure A
|[Create user flow](../api/identitycontainer-post-b2cuserflows.md)|b2cIdentityUserFlow|Create a new B2C user flow.| |[Update user flow](../api/b2cidentityuserflow-update.md)|b2cIdentityUserFlow|Update the properties of a B2C user flow.| |[Delete user flow](../api/b2cidentityuserflow-delete.md)|None|Delete a B2C user flow.|
-|[List identity providers](../api/b2cidentityuserflow-list-identityproviders.md)|[identityProvider](../resources/identityProvider.md) collection|Retrieve all identity providers in a B2C user flow.|
-|[Add identity provider](../api/b2cidentityuserflow-post-identityproviders.md)|None|Add an identity provider to a B2C user flow.|
-|[Remove identity provider](../api/b2cidentityuserflow-delete-identityproviders.md)|None|Remove an identity provider from a B2C user flow.|
+|[List identity providers](../api/b2cidentityuserflow-list-userflowidentityproviders.md)|[identityProvider](../resources/identityProviderbase.md) collection|Retrieve all identity providers in a B2C user flow.|
+|[Add identity provider](../api/b2cidentityuserflow-userflowidentityproviders-update.md)|None|Add an identity provider to a B2C user flow.|
+|[Delete identity provider](../api/b2cidentityuserflow-delete-userflowidentityproviders.md)|None|Remove an identity provider from a B2C user flow|
|[List user attribute assignments](../api/b2cidentityuserflow-list-userattributeassignments.md)|[identityUserFlowAttributeAssignment](../resources/identityuserflowattributeassignment.md) collection|Retrieve all user attribute assignments in a B2C user flow.| |[Create user attribute assignment](../api/b2cidentityuserflow-post-userattributeassignments.md)|[identityUserFlowAttributeAssignment](../resources/identityuserflowattributeassignment.md)|Create a user attribute assignment in a B2C user flow.| |[List languages](../api/b2cidentityuserflow-list-languages.md)|[userFlowLanguageConfiguration](../resources/userflowlanguageconfiguration.md) collection|Retrieve all languages within a B2C user flow.| |[Create language](../api/b2cidentityuserflow-put-languages.md)|[userFlowLanguageConfiguration](../resources/userflowlanguageconfiguration.md)|Creates a custom language in a B2C user flow.| |[Get API connectors configuration for user flow](../api/b2cidentityuserflow-get-apiConnectorConfiguration.md)|[userFlowApiConnectorConfiguration](../resources/userflowapiconnectorconfiguration.md)| Get the configuration for API connectors used in the user flow. The $expand query parameter is not supported for this method.| |[Configure an API connector in a user flow](../api/b2cidentityuserflow-put-apiConnectorConfiguration.md)|None| Configure an API connector for specific steps in a user flow by updating the [apiConnectorConfiguration](../resources/userflowapiconnectorconfiguration.md) property.|
+|[List identity providers](../api/b2cidentityuserflow-list-identityproviders.md) (deprecated)|[identityProvider](../resources/identityProvider.md) collection|Retrieve all identity providers in a B2C user flow.|
+|[Add identity provider](../api/b2cidentityuserflow-post-identityproviders.md) (deprecated)|None|Add an identity provider to a B2C user flow.|
+|[Delete identity provider](../api/b2cidentityuserflow-delete-identityproviders.md) (deprecated)|None|Remove an identity provider from a B2C user flow|
## Properties
To help you set up the most common identity tasks for your applications, Azure A
| Relationship | Type |Description| |:|:--|:-|
-|identityProviders|[identityProvider](../resources/identityprovider.md) collection|The identity providers included in the user flow.|
+|userflowIdentityProviders|[identityProviderBase](../resources/identityproviderbase.md) collection|The identity providers included in the user flow.|
+|identityProviders (deprecated)|[identityProvider](../resources/identityprovider.md) collection|The identity providers included in the user flow.|
|userAttributeAssignments|[identityUserFlowAttributeAssignment](../resources/identityuserflowattributeassignment.md) collection|The user attribute assignments included in the user flow.| |languages|[userFlowLanguageConfiguration](../resources/userflowlanguageconfiguration.md) collection|The languages supported for customization within the user flow. Language customization is not enabled by default in B2C user flows.|
The following is a JSON representation of the resource.
"userFlowTypeVersion": "Single", "isLanguageCustomizationEnabled": "Boolean", "defaultLanguageTag": "String",
+ "userflowidentityProviders": [{"@odata.type": "microsoft.graph.identityProviderBase"}],
"identityProviders": [{"@odata.type": "microsoft.graph.identityProvider"}], "userAttributeAssignments": [{"@odate.type": "microsoft.graph.identityUserFlowAttributeAssignment"}], "languages": [{"@odata.type": "microsoft.graph.userFlowLanguageConfiguration"}],
v1.0 B2xidentityuserflow https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/b2xidentityuserflow.md
User flows are used to enable a [self-service sign up](/azure/active-directory/e
| Method | Return Type |Description| |:|:--|:-|
-|[List user flows](../api/identitycontainer-list-b2xuserflows.md)|b2xIdentityUserFlow collection|Retrieve all self-service sign up user flows.|
-|[Get user flow](../api/b2xidentityuserflow-get.md)|b2xIdentityUserFlow|Retrieve properties of a self-service sign up user flow.|
-|[Create user flow](../api/identitycontainer-post-b2xuserflows.md)|b2xIdentityUserFlow|Create a new self-service sign up user flow.|
-|[Delete user flow](../api/b2xidentityuserflow-delete.md)|None|Delete a self-service sign up user flow.|
-|[List identity providers](../api/b2xidentityuserflow-list-identityproviders.md)|[identityProvider](../resources/identityProvider.md) collection|Retrieve all identity providers in a self-service sign up user flow.|
-|[Add identity provider](../api/b2xidentityuserflow-post-identityproviders.md)|None|Add an identity provider to a self-service sign up user flow.|
-|[Remove identity provider](../api/b2xidentityuserflow-delete-identityproviders.md)|None|Remove an identity provider from a self-service sign up user flow.|
-|[List user attribute assignments](../api/b2xidentityuserflow-list-userattributeassignments.md)|[identityUserFlowAttributeAssignment](../resources/identityuserflowattributeassignment.md) collection|Retrieve all user attribute assignments in a self-service sign up user flow.|
-|[Create user attribute assignment](../api/b2xidentityuserflow-post-userattributeassignments.md)|[identityUserFlowAttributeAssignment](../resources/identityuserflowattributeassignment.md)|Create a user attribute assignment in a self-service sign up user flow.|
-|[List languages](../api/b2xidentityuserflow-list-languages.md)|[userFlowLanguageConfiguration](../resources/userflowlanguageconfiguration.md) collection|Retrieve all languages within a self-service sign up user flow.|
-|[Get API connectors configuration for user flow](../api/b2xidentityuserflow-get-apiConnectorConfiguration.md)|[userFlowApiConnectorConfiguration](../resources/userflowapiconnectorconfiguration.md)| Get the configuration for API connectors used in the self-service sign up user flow. The $expand query parameter is not supported for this method.|
-|[Configure an API connector in a user flow](../api/b2xidentityuserflow-put-apiConnectorConfiguration.md)|None| Configure an API connector for specific steps in a self-service sign up user flow by updating the [apiConnectorConfiguration](../resources/userflowapiconnectorconfiguration.md) property.|
+|[List user flows](../api/identitycontainer-list-b2xuserflows.md)|b2xIdentityUserFlow collection|Retrieve all B2X user flows.|
+|[Get user flow](../api/b2xidentityuserflow-get.md)|b2xIdentityUserFlow|Retrieve properties of a B2X user flow.|
+|[Create user flow](../api/identitycontainer-post-b2xuserflows.md)|b2xIdentityUserFlow|Create a new B2X user flow.|
+|[Delete user flow](../api/b2xidentityuserflow-delete.md)|None|Delete a B2X user flow.|
+|[List identity providers](../api/b2xidentityuserflow-list-userflowidentityproviders.md)|[identityProvider](../resources/identityproviderbase.md) collection|Retrieve all identity providers in a B2X user flow.|
+|[Add identity provider](../api/b2xidentityuserflow-userflowidentityproviders-update.md)|None|Add an identity provider to a B2X user flow.|
+|[Remove identity provider](../api/b2xidentityuserflow-delete-userflowidentityproviders.md)|None|Remove an identity provider from a B2X user flow.|
+|[List identity providers](../api/b2xidentityuserflow-list-identityproviders.md) (deprecated)|[identityProvider](../resources/identityProvider.md) collection|Retrieve all identity providers in a B2X user flow.|
+|[Add identity provider](../api/b2xidentityuserflow-post-identityproviders.md) (deprecated)|None|Add an identity provider to a B2X user flow.|
+|[Remove identity provider](../api/b2xidentityuserflow-delete-identityproviders.md) (deprecated)|None|Remove an identity provider from a B2X user flow.|
+|[List user attribute assignments](../api/b2xidentityuserflow-list-userattributeassignments.md)|[identityUserFlowAttributeAssignment](../resources/identityuserflowattributeassignment.md) collection|Retrieve all user attribute assignments in a B2X user flow.|
+|[Create user attribute assignment](../api/b2xidentityuserflow-post-userattributeassignments.md)|[identityUserFlowAttributeAssignment](../resources/identityuserflowattributeassignment.md)|Create a user attribute assignment in a B2X user flow.|
+|[List languages](../api/b2xidentityuserflow-list-languages.md)|[userFlowLanguageConfiguration](../resources/userflowlanguageconfiguration.md) collection|Retrieve all languages within a B2X user flow.|
+|[Get API connectors configuration for user flow](../api/b2xidentityuserflow-get-apiConnectorConfiguration.md)|[userFlowApiConnectorConfiguration](../resources/userflowapiconnectorconfiguration.md)| Get the configuration for API connectors used in the user flow. The $expand query parameter is not supported for this method.|
+|[Configure an API connector in a user flow](../api/b2xidentityuserflow-put-apiConnectorConfiguration.md)|None| Configure an API connector for specific steps in a user flow by updating the [apiConnectorConfiguration](../resources/userflowapiconnectorconfiguration.md) property.|
## Properties
User flows are used to enable a [self-service sign up](/azure/active-directory/e
| Relationship | Type |Description| |:|:--|:-|
-|identityProviders|[identityProvider](../resources/identityprovider.md) collection|The identity providers included in the user flow.|
+|userflowIdentityProviders|[identityProviderBase](../resources/identityproviderbase.md) collection|The identity providers included in the user flow.|
+|identityProviders (deprecated)|[identityProvider](../resources/identityprovider.md) collection|The identity providers included in the user flow.|
|userAttributeAssignments|[identityUserFlowAttributeAssignment](../resources/identityuserflowattributeassignment.md) collection|The user attribute assignments included in the user flow.| |languages|[userFlowLanguageConfiguration](../resources/userflowlanguageconfiguration.md) collection|The languages supported for customization within the user flow. Language customization is enabled by default in self-service sign up user flow. You cannot create custom languages in self-service sign up user flows.|
The following is a JSON representation of the resource.
"id": "String (identifier)", "userFlowType": "String", "userFlowTypeVersion": "Single",
+ "userflowIdentityProviders": [{"@odata.type": "microsoft.graph.identityProviderBase"}],
"identityProviders": [{"@odata.type": "microsoft.graph.identityProvider"}], "userAttributeAssignments": [{"@odate.type": "microsoft.graph.identityUserFlowAttributeAssignment"}], "languages": [{"@odata.type": "microsoft.graph.userFlowLanguageConfiguration"}],
v1.0 Device https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/device.md
This resource lets you add your own data to custom properties using [extensions]
|[Add schema extension values](/graph/extensibility-schema-groups) || Create a schema extension definition and then use it to add custom typed data to a resource.| ## Properties+
+> [!IMPORTANT]
+> Specific usage of `$filter` and the `$search` query parameter is supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+ | Property | Type |Description| |:|:--|:-| |accountEnabled|Boolean| `true` if the account is enabled; otherwise, `false`. Default is `true`. Supports `$filter` (`eq`, `ne`, `NOT`, `in`).|
v1.0 Entitlementmanagement Root https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/entitlementmanagement-root.md
The following table lists the methods that you can use to interact with entitlem
| [FilterByCurrentUser](../api/accesspackage-filterbycurrentuser.md) | [accessPackage](accesspackage.md) collection | Retrieve a list of **accessPackage** objects filtered on the signed-in user. | | [List accessPackageResourceRoleScopes](../api/accesspackage-list-accesspackageresourcerolescopes.md) | [accessPackageResourceRoleScope](accesspackageresourcerolescope.md) collection | Retrieve a list of **accessPackageResourceRoleScope** objects for an access package. | | [Create accessPackageResourceRoleScope](../api/accesspackage-post-accesspackageresourcerolescopes.md) | | Create a new **accessPackageResourceRoleScope** object for an access package. |
+| [List incompatibleAccessPackages](../api/accesspackage-list-incompatibleaccesspackages.md) | [accessPackage](accesspackage.md) collection | Retrieve a list of the incompatible **accesspackage** objects for this access package. |
+| [Add accessPackage to incompatibleAccessPackages](../api/accesspackage-post-incompatibleaccesspackage.md) | None | Add a link to indicate another **accesspackage** is incompatible with a specified access package. |
+| [Remove accessPackage from incompatibleAccessPackages](../api/accesspackage-delete-incompatibleaccesspackage.md) | None | Remove a link that indicated an **accesspackage** was incompatible. |
+| [List incompatibleGroups](../api/accesspackage-list-incompatiblegroups.md) | [group](group.md) collection | Retrieve a list of the incompatible **group** objects for this access package. |
+| [Add group to incompatibleGroups](../api/accesspackage-post-incompatiblegroup.md) | None | Add a link to indicate membership of a **group** is incompatible with a specified access package. |
+| [Remove group from incompatibleGroups](../api/accesspackage-delete-incompatiblegroup.md) | None | Remove a link that indicated a **group** membership was incompatible.|
+| [List accessPackagesIncompatibleWith](../api/accesspackage-list-accesspackagesincompatiblewith.md) | [accessPackage](accesspackage.md) collection | Retrieve a list of the **accesspackage** objects which list this access package as incompatible. |
| [List accessPackageAssignmentPolicies](../api/accesspackageassignmentpolicy-list.md) | [accessPackageAssignmentPolicy](accesspackageassignmentpolicy.md) collection | Retrieve a list of **accessPackageAssignmentPolicy** objects. | | [Create accessPackageAssignmentPolicy](../api/accesspackageassignmentpolicy-post.md) | [accessPackageAssignmentPolicy](accesspackageassignmentpolicy.md)| Create a new **accessPackageAssignmentPolicy** object. | | [Get accessPackageAssignmentPolicy](../api/accesspackageassignmentpolicy-get.md) | [accessPackageAssignmentPolicy](accesspackageassignmentpolicy.md) | Read properties and relationships of an **accessPackageAssignmentPolicy** object. |
v1.0 Enums Managedtenants https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/enums-managedtenants.md
+
+ Title: "Multi-tenant management enumeration values"
+description: "Microsoft Graph multi-tenant management enumeration values"
+
+localization_priority: Normal
++
+# Multi-tenant management enumeration values
+
+### delegatedPrivilegeStatus values
+
+|Member|
+|:|
+|none|
+|delegatedAdminPrivileges|
+|unknownFutureValue|
+
+### managementActionStatus values
+
+|Member|
+|:|
+|toAddress|
+|completed|
+|error|
+|timeOut|
+|inProgress|
+|planned|
+|resolvedBy3rdParty|
+|resolvedThroughAlternateMitigation|
+|riskAccepted|
+|unknownFutureValue|
+
+### managementCategory values
+
+|Member|
+|:|
+|custom|
+|devices|
+|identity|
+|unknownFutureValue|
+
+### managementParameterValueType values
+
+|Member|
+|:|
+|string|
+|integer|
+|boolean|
+|guid|
+|stringCollection|
+|integerCollection|
+|booleanCollection|
+|guidCollection|
+|unknownFutureValue|
+
+### tenantOnboardingStatus values
+
+|Member|
+|:|
+|ineligible|
+|inProcess|
+|active|
+|inactive|
+|unknownFutureValue|
+
+### workloadActionCategory values
+
+|Member|
+|:|
+|automated|
+|manual|
+|unknownFutureValue|
+
+### workloadActionStatus values
+
+|Member|
+|:|
+|toAddress|
+|completed|
+|error|
+|timeOut|
+|inProgress|
+|unknownFutureValue|
+
+### workloadOnboardingStatus values
+
+|Member|
+|:|
+|notOnboarded|
+|onboarded|
+|unknownFutureValue|
v1.0 Enums https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/enums.md
Namespace: microsoft.graph
+### synchronizationSecret values
+
+|Member|
+|:-|
+|None|
+|UserName|
+|Password|
+|SecretToken|
+|AppKey|
+|BaseAddress|
+|ClientIdentifier|
+|ClientSecret|
+|SingleSignOnType|
+|Sandbox|
+|Url|
+|Domain|
+|ConsumerKey|
+|ConsumerSecret|
+|TokenKey|
+|TokenExpiration|
+|Oauth2AccessToken|
+|Oauth2AccessTokenCreationTime|
+|Oauth2RefreshToken|
+|SyncAll|
+|InstanceName|
+|Oauth2ClientId|
+|Oauth2ClientSecret|
+|CompanyId|
+|UpdateKeyOnSoftDelete|
+|SynchronizationSchedule|
+|SystemOfRecord|
+|SandboxName|
+|EnforceDomain|
+|SyncNotificationSettings|
+|SkipOutOfScopeDeletions|
+|Oauth2AuthorizationCode|
+|Oauth2RedirectUri|
+|ApplicationTemplateIdentifier|
+|Server|
+|PerformInboundEntitlementGrants|
+|HardDeletesEnabled|
+|SyncAgentCompatibilityKey|
+|SyncAgentADContainer|
+|ValidateDomain|
+|TestReferences|
+ ### filterMode values |Member|
Namespace: microsoft.graph
|updated| |deleted| + ### countryLookupMethodType values |Member|
Possible values for user account types (group membership), per Windows definitio
|skypeUser| |phoneUser| |unknownFutureValue|+
v1.0 Group https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/group.md
This resource supports:
## Properties
+> [!IMPORTANT]
+> Specific usage of `$filter` and the `$search` query parameter is supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+ | Property | Type |Description| |:|:--|:-| |allowExternalSenders|Boolean| Indicates if people external to the organization can send messages to the group. Default value is `false`. <br><br>Returned only on `$select`. Supported only on the Get group API (`GET /groups/{ID}`). |
v1.0 Managedtenants Aggregatedpolicycompliance https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-aggregatedpolicycompliance.md
+
+ Title: "aggregatedPolicyCompliance resource type"
+description: "Represents an aggregate view of device compliance for a managed tenant."
+
+localization_priority: Normal
++
+# aggregatedPolicyCompliance resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents an aggregate view of device compliance for a managed tenant.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List aggregatedPolicyCompliances](../api/managedtenants-managedtenant-list-aggregatedpolicycompliances.md)|[microsoft.graph.managedTenants.aggregatedPolicyCompliance](../resources/managedtenants-aggregatedpolicycompliance.md) collection|Get a list of the [aggregatedPolicyCompliance](../resources/managedtenants-aggregatedpolicycompliance.md) objects and their properties.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|compliancePolicyId|String|Identifier for the device compliance policy. Optional. Read-only.|
+|compliancePolicyName|String|Name of the device compliance policy. Optional. Read-only.|
+|compliancePolicyPlatform|String|Platform for the device compliance policy. Possible values are: `android`, `androidForWork`, `iOS`, `macOS`, `windowsPhone81`, `windows81AndLater`, `windows10AndLater`, `androidWorkProfile`, `androidAOSP`, `all`. Optional. Read-only.|
+|compliancePolicyType|String|The type of compliance policy. Optional. Read-only.|
+|id|String|Unique identifier for the aggregate device compliance policy. Required. Read-only|
+|lastRefreshedDateTime|DateTimeOffset|Date and time the entity was last updated in the multi-tenant management platform. Optional. Read-only.|
+|numberOfCompliantDevices|Int64|The number of devices that are in a compliant status. Optional. Read-only.|
+|numberOfErrorDevices|Int64|The number of devices that are in an error status. Optional. Read-only.|
+|numberOfNonCompliantDevices|Int64|The number of device that are in a non-compliant status. Optional. Read-only.|
+|policyModifiedDateTime|DateTimeOffset|The date and time the device policy was last modified. Optional. Read-only.|
+|tenantDisplayName|String|The display name for the managed tenant. Optional. Read-only.|
+|tenantId|String|The Azure Active Directory tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md). Optional. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.aggregatedPolicyCompliance",
+ "baseType": "microsoft.graph.entity",
+ "openType": true
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.aggregatedPolicyCompliance",
+ "id": "String (identifier)",
+ "tenantId": "String",
+ "tenantDisplayName": "String",
+ "compliancePolicyId": "String",
+ "compliancePolicyName": "String",
+ "compliancePolicyType": "String",
+ "compliancePolicyPlatform": "String",
+ "numberOfCompliantDevices": "Integer",
+ "numberOfNonCompliantDevices": "Integer",
+ "numberOfErrorDevices": "Integer",
+ "policyModifiedDateTime": "String (timestamp)",
+ "lastRefreshedDateTime": "String (timestamp)"
+}
+```
v1.0 Managedtenants Cloudpcconnection https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-cloudpcconnection.md
+
+ Title: "cloudPcConnection resource type"
+description: "Represents a cloud PC connection for a given managed tenant."
+
+localization_priority: Normal
++
+# cloudPcConnection resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents a cloud PC connection for a given managed tenant.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List cloudPcConnections](../api/managedtenants-managedtenant-list-cloudpcconnections.md)|[microsoft.graph.managedTenants.cloudPcConnection](../resources/managedtenants-cloudpcconnection.md) collection|Get a list of the [cloudPcConnection](../resources/managedtenants-cloudpcconnection.md) objects and their properties.|
+|[Get cloudPcConnection](../api/managedtenants-cloudpcconnection-get.md)|[microsoft.graph.managedTenants.cloudPcConnection](../resources/managedtenants-cloudpcconnection.md)|Read the properties and relationships of a [cloudPcConnection](../resources/managedtenants-cloudpcconnection.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|The display name of the cloud PC connection. Required. Read-only.|
+|healthCheckStatus|String|The health status of the cloud PC connection. Possible values are: `pending`, `running`, `passed`, `failed`, `unknownFutureValue`. Required. Read-only.|
+|id|String|The unique identifier for the cloud PC connection. Required. Read-only.|
+|lastRefreshedDateTime|DateTimeOffset|Date and time the entity was last updated in the multi-tenant management platform. Required. Read-only.|
+|tenantDisplayName|String|The display name for the managed tenant. Required. Read-only.|
+|tenantId|String|The Azure Active Directory tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md). Required. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.cloudPcConnection",
+ "baseType": "microsoft.graph.entity",
+ "openType": true
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.cloudPcConnection",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "tenantId": "String",
+ "tenantDisplayName": "String",
+ "healthCheckStatus": "String",
+ "lastRefreshedDateTime": "String (timestamp)"
+}
+```
v1.0 Managedtenants Cloudpcdevice https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-cloudpcdevice.md
+
+ Title: "cloudPcDevice resource type"
+description: "Represents a cloud PC device that belongs to a given managed tenant."
+
+localization_priority: Normal
++
+# cloudPcDevice resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents a cloud PC device that belongs to a given managed tenant.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List cloudPcDevices](../api/managedtenants-managedtenant-list-cloudpcdevices.md)|[microsoft.graph.managedTenants.cloudPcDevice](../resources/managedtenants-cloudpcdevice.md) collection|Get a list of the [cloudPcDevice](../resources/managedtenants-cloudpcdevice.md) objects and their properties.|
+|[Get cloudPcDevice](../api/managedtenants-cloudpcdevice-get.md)|[microsoft.graph.managedTenants.cloudPcDevice](../resources/managedtenants-cloudpcdevice.md)|Read the properties and relationships of a [cloudPcDevice](../resources/managedtenants-cloudpcdevice.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|cloudPcStatus|String|The status of the cloud PC. Possible values are: `notProvisioned`, `provisioning`, `provisioned`, `upgrading`, `inGracePeriod`, `deprovisioning`, `failed`. Required. Read-only.|
+|displayName|String|The display name for the cloud PC. Required. Read-only.|
+|id|String|The unique identifier for the cloud PC. Required. Read-only.|
+|lastRefreshedDateTime|DateTimeOffset|Date and time the entity was last updated in the multi-tenant management platform. Required. Read-only.|
+|managedDeviceId|String|The managed device identifier for the cloud PC. Optional. Read-only.|
+|managedDeviceName|String|The managed device display name for the cloud PC. Optional. Read-only.|
+|provisioningPolicyId|String|The provisioning policy identifier for the cloud PC. Required. Read-only.|
+|servicePlanName|String|The service plan name for the cloud PC. Required. Read-only.|
+|tenantDisplayName|String|The display name for the managed tenant. Required. Read-only.|
+|tenantId|String|The Azure Active Directory tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md). Required. Read-only.|
+|userPrincipalName|String|The user principal name (UPN) of the user assigned to the cloud PC. Required. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.cloudPcDevice",
+ "baseType": "microsoft.graph.entity",
+ "openType": true
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.cloudPcDevice",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "tenantId": "String",
+ "tenantDisplayName": "String",
+ "managedDeviceId": "String",
+ "managedDeviceName": "String",
+ "userPrincipalName": "String",
+ "servicePlanName": "String",
+ "cloudPcStatus": "String",
+ "provisioningPolicyId": "String",
+ "lastRefreshedDateTime": "String (timestamp)"
+}
+```
v1.0 Managedtenants Cloudpcoverview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-cloudpcoverview.md
+
+ Title: "cloudPcOverview resource type"
+description: "Represents an overview of cloud PCs for a given managed tenant."
+
+localization_priority: Normal
++
+# cloudPcOverview resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents an overview of cloud PCs for a given managed tenant.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List cloudPcOverviews](../api/managedtenants-managedtenant-list-cloudpcsoverview.md)|[microsoft.graph.managedTenants.cloudPcOverview](../resources/managedtenants-cloudpcoverview.md) collection|Get a list of the [cloudPcOverview](../resources/managedtenants-cloudpcoverview.md) objects and their properties.|
+|[Get cloudPcOverview](../api/managedtenants-cloudpcoverview-get.md)|[microsoft.graph.managedTenants.cloudPcOverview](../resources/managedtenants-cloudpcoverview.md)|Read the properties and relationships of a [cloudPcOverview](../resources/managedtenants-cloudpcoverview.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|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.|
+|numberOfCloudPcConnectionStatusPassed|Int32|The number of cloud PC connections that have a status of `passed`. Optional. Read-only.|
+|numberOfCloudPcConnectionStatusPending|Int32|The number of cloud PC connections that have a status of `pending`. Optional. Read-only.|
+|numberOfCloudPcConnectionStatusRunning|Int32|The number of cloud PC connections that have a status of `running`. Optional. Read-only.|
+|numberOfCloudPcConnectionStatusUnkownFutureValue|Int32|The number of cloud PC connections that have a status of `unknownFutureValue`. Optional. Read-only.|
+|numberOfCloudPcStatusDeprovisioning|Int32|The number of cloud PCs that have a status of `deprovisioning`. Optional. Read-only.|
+|numberOfCloudPcStatusFailed|Int32|The number of cloud PCs that have a status of `failed`. Optional. Read-only.|
+|numberOfCloudPcStatusInGracePeriod|Int32|The number of cloud PCs that have a status of `inGracePeriod`. Optional. Read-only.|
+|numberOfCloudPcStatusNotProvisioned|Int32|The number of cloud PCs that have a status of `notProvisioned`. Optional. Read-only.|
+|numberOfCloudPcStatusProvisioned|Int32|The number of cloud PCs that have a status of `provisioned`. Optional. Read-only.|
+|numberOfCloudPcStatusProvisioning|Int32|The number of cloud PCs that have a status of `provisioning`. Optional. Read-only.|
+|numberOfCloudPcStatusUnknown|Int32|The number of cloud PCs that have a status of `unknown`. Optional. Read-only.|
+|numberOfCloudPcStatusUpgrading|Int32|The number of cloud PCs that have a status of `upgrading`. Optional. Read-only.|
+|tenantDisplayName|String|The display name for the managed tenant. Optional. Read-only.|
+|totalCloudPcConnectionStatus|Int32|The total number of cloud PC connection statuses for the given managed tenant. Optional. Read-only.|
+|totalCloudPcStatus|Int32|The total number of cloud PC statues for the given managed tenant. Optional. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.cloudPcOverview",
+ "baseType": "microsoft.graph.entity",
+ "openType": true
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.cloudPcOverview",
+ "id": "String (identifier)",
+ "tenantDisplayName": "String",
+ "totalCloudPcStatus": "Integer",
+ "numberOfCloudPcStatusNotProvisioned": "Integer",
+ "numberOfCloudPcStatusProvisioning": "Integer",
+ "numberOfCloudPcStatusProvisioned": "Integer",
+ "numberOfCloudPcStatusUpgrading": "Integer",
+ "numberOfCloudPcStatusInGracePeriod": "Integer",
+ "numberOfCloudPcStatusDeprovisioning": "Integer",
+ "numberOfCloudPcStatusFailed": "Integer",
+ "numberOfCloudPcStatusUnknown": "Integer",
+ "totalCloudPcConnectionStatus": "Integer",
+ "numberOfCloudPcConnectionStatusPending": "Integer",
+ "numberOfCloudPcConnectionStatusRunning": "Integer",
+ "numberOfCloudPcConnectionStatusPassed": "Integer",
+ "numberOfCloudPcConnectionStatusFailed": "Integer",
+ "numberOfCloudPcConnectionStatusUnkownFutureValue": "Integer",
+ "lastRefreshedDateTime": "String (timestamp)"
+}
+```
v1.0 Managedtenants Conditionalaccesspolicycoverage https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-conditionalaccesspolicycoverage.md
+
+ Title: "conditionalAccessPolicyCoverage resource type"
+description: "Represents information about any Azure Active Directory policy that defines access rules of a resource for a given managed tenant."
+
+localization_priority: Normal
++
+# conditionalAccessPolicyCoverage resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents information about any Azure Active Directory policy that defines access rules of a resource for a given managed tenant.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List conditionalAccessPolicyCoverages](../api/managedtenants-managedtenant-list-conditionalaccesspolicycoverages.md)|[microsoft.graph.managedTenants.conditionalAccessPolicyCoverage](../resources/managedtenants-conditionalaccesspolicycoverage.md) collection|Get a list of the [conditionalAccessPolicyCoverage](../resources/managedtenants-conditionalaccesspolicycoverage.md) objects and their properties.|
+|[Get conditionalAccessPolicyCoverage](../api/managedtenants-conditionalaccesspolicycoverage-get.md)|[microsoft.graph.managedTenants.conditionalAccessPolicyCoverage](../resources/managedtenants-conditionalaccesspolicycoverage.md)|Read the properties and relationships of a [conditionalAccessPolicyCoverage](../resources/managedtenants-conditionalaccesspolicycoverage.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|conditionalAccessPolicyState|String|The state for the conditional access policy. Possible values are: `enabled`, `disabled`, `enabledForReportingButNotEnforced`. Required. Read-only.|
+|id|String|The unique identifier for this entity. Required. Read-only.|
+|latestPolicyModifiedDateTime|DateTimeOffset|The date and time the conditional access policy was last modified. Required. Read-only.|
+|requiresDeviceCompliance|Boolean|A flag indicating whether the conditional access policy requires device compliance. Required. Read-only.|
+|tenantDisplayName|String|The display name for the managed tenant. Required. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.conditionalAccessPolicyCoverage",
+ "baseType": "microsoft.graph.entity",
+ "openType": true
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.conditionalAccessPolicyCoverage",
+ "id": "String (identifier)",
+ "tenantDisplayName": "String",
+ "conditionalAccessPolicyState": "String",
+ "requiresDeviceCompliance": "Boolean",
+ "latestPolicyModifiedDateTime": "String (timestamp)"
+}
+```
v1.0 Managedtenants Credentialuserregistrationssummary https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-credentialuserregistrationssummary.md
+
+ Title: "credentialUserRegistrationsSummary resource type"
+description: "Represents a summary of Azure Active Directory credential user registrations for a given managed tenant."
+
+localization_priority: Normal
++
+# credentialUserRegistrationsSummary resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents a summary of Azure Active Directory credential user registrations for a given managed tenant.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List credentialUserRegistrationsSummaries](../api/managedtenants-managedtenant-list-credentialuserregistrationssummaries.md)|[microsoft.graph.managedTenants.credentialUserRegistrationsSummary](../resources/managedtenants-credentialuserregistrationssummary.md) collection|Get a list of the [credentialUserRegistrationsSummary](../resources/managedtenants-credentialuserregistrationssummary.md) objects and their properties.|
+|[Get credentialUserRegistrationsSummary](../api/managedtenants-credentialuserregistrationssummary-get.md)|[microsoft.graph.managedTenants.credentialUserRegistrationsSummary](../resources/managedtenants-credentialuserregistrationssummary.md)|Read the properties and relationships of a [credentialUserRegistrationsSummary](../resources/managedtenants-credentialuserregistrationssummary.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|The unique identifier for this entity. Required. Read-only.|
+|lastRefreshedDateTime|DateTimeOffset|Date and time the entity was last updated in the multi-tenant management platform. Optional. Read-only.|
+|mfaAndSsprCapableUserCount|Int32|The number of users that are capable of performing multi-factor authentication or self service password reset. Optional. Read-only.|
+|mfaConditionalAccessPolicyState|String|The state of a conditional access policy that enforces multi-factor authentication. Optional. Read-only.|
+|mfaRegisteredUserCount|Int32|The number of users registered for multi-factor authentication. Optional. Read-only.|
+|securityDefaultsEnabled|Boolean|A flag indicating whether Identity Security Defaults is enabled. Optional. Read-only.|
+|ssprEnabledUserCount|Int32|The number of users enabled for self service password reset. Optional. Read-only.|
+|ssprRegisteredUserCount|Int32|The number of users registered for self service password reset. Optional. Read-only.|
+|tenantDisplayName|String|The display name for the managed tenant. Required. Read-only.|
+|tenantId|String|The Azure Active Directory tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md). Required. Read-only.|
+|totalUserCount|Int32|The total number of users in the given managed tenant. Optional. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.credentialUserRegistrationsSummary",
+ "baseType": "microsoft.graph.entity",
+ "openType": true
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.credentialUserRegistrationsSummary",
+ "id": "String (identifier)",
+ "tenantId": "String",
+ "tenantDisplayName": "String",
+ "mfaAndSsprCapableUserCount": "Integer",
+ "ssprEnabledUserCount": "Integer",
+ "mfaRegisteredUserCount": "Integer",
+ "ssprRegisteredUserCount": "Integer",
+ "totalUserCount": "Integer",
+ "securityDefaultsEnabled": "Boolean",
+ "mfaConditionalAccessPolicyState": "String",
+ "lastRefreshedDateTime": "String (timestamp)"
+}
+```
v1.0 Managedtenants Devicecompliancepolicysettingstatesummary https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-devicecompliancepolicysettingstatesummary.md
+
+ Title: "deviceCompliancePolicySettingStateSummary resource type"
+description: "Represents a summary of device compliance policy setting states for a given managed tenant."
+
+localization_priority: Normal
++
+# deviceCompliancePolicySettingStateSummary resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents a summary of device compliance policy setting states for a given managed tenant.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List deviceCompliancePolicySettingStateSummary](../api/managedtenants-managedtenant-list-devicecompliancepolicysettingstatesummary.md)|[microsoft.graph.managedTenants.deviceCompliancePolicySettingStateSummary](../resources/managedtenants-devicecompliancepolicysettingstatesummary.md) collection|Get a list of the [deviceCompliancePolicySettingStateSummary](../resources/managedtenants-devicecompliancepolicysettingstatesummary.md) objects and their properties.|
+|[Get deviceCompliancePolicySettingStateSummary](../api/managedtenants-devicecompliancepolicysettingstatesummary-get.md)|[microsoft.graph.managedTenants.deviceCompliancePolicySettingStateSummary](../resources/managedtenants-devicecompliancepolicysettingstatesummary.md)|Read the properties and relationships of a [deviceCompliancePolicySettingStateSummary](../resources/managedtenants-devicecompliancepolicysettingstatesummary.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|The unique identifier for this entity. Required. Read-only.|
+|conflictDeviceCount|Int32|The number of devices in a conflict state. Optional. Read-only.|
+|errorDeviceCount|Int32|The number of devices in an error state. Optional. Read-only.|
+|failedDeviceCount|Int32|The number of devices in a failed state. Optional. Read-only.|
+|intuneAccountId|String|The identifer for the Microsoft Intune account. Required. Read-only.|
+|intuneSettingId|String|The identifier for the Intune setting. Optional. Read-only.|
+|lastRefreshedDateTime|DateTimeOffset|Date and time the entity was last updated in the multi-tenant management platform. Optional. Read-only.|
+|notApplicableDeviceCount|Int32|The number of devices in a not applicable state. Optional. Read-only.|
+|pendingDeviceCount|Int32|The number of devices in a pending state. Optional. Read-only.|
+|policyType|String|The type for the device compliance policy. Optional. Read-only.|
+|settingName|String|The name for the setting within the device compliance policy. Optional. Read-only.|
+|succeededDeviceCount|Int32|The number of devices in a succeeded state. Optional. Read-only.|
+|tenantDisplayName|String|The display name for the managed tenant. Required. Read-only.|
+|tenantId|String|The Azure Active Directory tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md). Required. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.deviceCompliancePolicySettingStateSummary",
+ "baseType": "microsoft.graph.entity",
+ "openType": true
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.deviceCompliancePolicySettingStateSummary",
+ "id": "String (identifier)",
+ "tenantId": "String",
+ "tenantDisplayName": "String",
+ "conflictDeviceCount": "Integer",
+ "errorDeviceCount": "Integer",
+ "failedDeviceCount": "Integer",
+ "intuneAccountId": "String",
+ "intuneSettingId": "String",
+ "notApplicableDeviceCount": "Integer",
+ "pendingDeviceCount": "Integer",
+ "policyType": "String",
+ "settingName": "String",
+ "succeededDeviceCount": "Integer",
+ "lastRefreshedDateTime": "String (timestamp)"
+}
+```
v1.0 Managedtenants Manageddevicecompliance https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-manageddevicecompliance.md
+
+ Title: "managedDeviceCompliance resource type"
+description: "Represents the state of device compliance for each managed device belonging to a given managed tenant."
+
+localization_priority: Normal
++
+# managedDeviceCompliance resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents the state of device compliance for each managed device belonging to a given managed tenant.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List managedDeviceCompliances](../api/managedtenants-managedtenant-list-manageddevicecompliances.md)|[microsoft.graph.managedTenants.managedDeviceCompliance](../resources/managedtenants-manageddevicecompliance.md) collection|Get a list of the [managedDeviceCompliance](../resources/managedtenants-manageddevicecompliance.md) objects and their properties.|
+|[Get managedDeviceCompliance](../api/managedtenants-manageddevicecompliance-get.md)|[microsoft.graph.managedTenants.managedDeviceCompliance](../resources/managedtenants-manageddevicecompliance.md)|Read the properties and relationships of a [managedDeviceCompliance](../resources/managedtenants-manageddevicecompliance.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|complianceStatus|String|Compliance state of the device. This property is read-only. Possible values are: `unknown`, `compliant`, `noncompliant`, `conflict`, `error`, `inGracePeriod`, `configManager`. Optional. Read-only.|
+|deviceType|String|Platform of the device. 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`. Optional. Read-only.|
+|id|String|The unique identity for this entity. Required. Read-only.|
+|inGracePeriodUntilDateTime|DateTimeOffset|The date and time when the grace period will expire. Optional. Read-only.|
+|lastRefreshedDateTime|DateTimeOffset|Date and time the entity was last updated in the multi-tenant management platform. Optional. Read-only.|
+|lastSyncDateTime|DateTimeOffset|The date and time that the device last completed a successful sync with Microsoft Endpoint Manager. Optional. Read-only.|
+|managedDeviceId|String|The identifier for the managed device in Microsoft Endpoint Manager. Optional. Read-only.|
+|managedDeviceName|String|The display name for the managed device. Optional. Read-only.|
+|manufacturer|String|The manufacture for the device. Optional. Read-only.|
+|model|String|The model for the device. Optional. Read-only.|
+|osDescription|String|The description of the operating system for the managed device. Optional. Read-only.|
+|osVersion|String|The version of the operating system for the managed device. Optional. Read-only.|
+|ownerType|String|The type of owner for the managed device. Optional. Read-only.|
+|tenantDisplayName|String|The display name for the managed tenant. Optional. Read-only.|
+|tenantId|String|The Azure Active Directory tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md). Optional. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.managedDeviceCompliance",
+ "baseType": "microsoft.graph.entity",
+ "openType": true
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.managedDeviceCompliance",
+ "id": "String (identifier)",
+ "tenantId": "String",
+ "tenantDisplayName": "String",
+ "managedDeviceId": "String",
+ "managedDeviceName": "String",
+ "complianceStatus": "String",
+ "osDescription": "String",
+ "osVersion": "String",
+ "lastSyncDateTime": "String (timestamp)",
+ "ownerType": "String",
+ "model": "String",
+ "manufacturer": "String",
+ "inGracePeriodUntilDateTime": "String (timestamp)",
+ "lastRefreshedDateTime": "String (timestamp)",
+ "deviceType": "String"
+}
+```
v1.0 Managedtenants Manageddevicecompliancetrend https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-manageddevicecompliancetrend.md
+
+ Title: "managedDeviceComplianceTrend resource type"
+description: "Represents a trend of compliant and non-compliant devices for a given managed tenant."
+
+localization_priority: Normal
++
+# managedDeviceComplianceTrend resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents a trend of compliant and non-compliant devices for a given managed tenant.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List managedDeviceComplianceTrends](../api/managedtenants-managedtenant-list-manageddevicecompliancetrends.md)|[microsoft.graph.managedTenants.managedDeviceComplianceTrend](../resources/managedtenants-manageddevicecompliancetrend.md) collection|Get a list of the [managedDeviceComplianceTrend](../resources/managedtenants-manageddevicecompliancetrend.md) objects and their properties.|
+|[Get managedDeviceComplianceTrend](../api/managedtenants-manageddevicecompliancetrend-get.md)|[microsoft.graph.managedTenants.managedDeviceComplianceTrend](../resources/managedtenants-manageddevicecompliancetrend.md)|Read the properties and relationships of a [managedDeviceComplianceTrend](../resources/managedtenants-manageddevicecompliancetrend.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|compliantDeviceCount|Int32|The number of devices with a compliant status. Required. Read-only.|
+|configManagerDeviceCount|Int32|The number of devices manged by Configuration Manager. Required. Read-only.|
+|countDateTime|String|The date and time compliance snapshot was performed. Required. Read-only.|
+|errorDeviceCount|Int32|The number of devices with an error status. Required. Read-only.|
+|id|String|The unique identifier for this entity. Required. Read-only.|
+|inGracePeriodDeviceCount|Int32|The number of devices that are in a grace period status. Required. Read-only.|
+|noncompliantDeviceCount|Int32|The number of devices that are in a non-compliant status. Required. Read-only.|
+|tenantDisplayName|String|The display name for the managed tenant. Optional. Read-only.|
+|tenantId|String|The Azure Active Directory tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md). Optional. Read-only.|
+|unknownDeviceCount|Int32|The number of devices in an unknown status. Required. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.managedDeviceComplianceTrend",
+ "baseType": "microsoft.graph.entity",
+ "openType": true
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.managedDeviceComplianceTrend",
+ "id": "String (identifier)",
+ "tenantId": "String",
+ "tenantDisplayName": "String",
+ "unknownDeviceCount": "Integer",
+ "compliantDeviceCount": "Integer",
+ "noncompliantDeviceCount": "Integer",
+ "errorDeviceCount": "Integer",
+ "inGracePeriodDeviceCount": "Integer",
+ "configManagerDeviceCount": "Integer",
+ "countDateTime": "String"
+}
+```
v1.0 Managedtenants Managedtenant https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-managedtenant.md
+
+ Title: "managedTenant resource type"
+description: "Represent the available operations that interact with the multi-tenant management platform."
+
+localization_priority: Normal
++
+# managedTenant resource type
+
+Namespace: microsoft.graph.managedTenants
++
+As the root resource of the Microsoft 365 Lighthouse API, **managedTenant** represents the capabilities available to a Managed Service Provider (MSP) to scale the remote management of its customer tenants to help get them into a healthy and secure state.
+
+The Microsoft 365 Lighthouse API is defined in the OData subnamespace, `microsoft.graph.managedTenants`.
+
+## Properties
+None.
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|aggregatedPolicyCompliances|[microsoft.graph.managedTenants.aggregatedPolicyCompliance](../resources/managedtenants-aggregatedpolicycompliance.md) collection|Aggregate view of device compliance policies across managed tenants.|
+|cloudPcConnections|[microsoft.graph.managedTenants.cloudPcConnection](../resources/managedtenants-cloudpcconnection.md) collection|The collection of cloud PC connections across managed tenants.|
+|cloudPcDevices|[microsoft.graph.managedTenants.cloudPcDevice](../resources/managedtenants-cloudpcdevice.md) collection|The collection of cloud PC devices across managed tenants.|
+|cloudPcsOverview|[microsoft.graph.managedTenants.cloudPcOverview](../resources/managedtenants-cloudpcoverview.md) collection|Overview of cloud PC information across managed tenants.|
+|conditionalAccessPolicyCoverages|[microsoft.graph.managedTenants.conditionalAccessPolicyCoverage](../resources/managedtenants-conditionalaccesspolicycoverage.md) collection|Aggregate view of conditional access policy coverage across managed tenants.|
+|credentialUserRegistrationsSummaries|[microsoft.graph.managedTenants.credentialUserRegistrationsSummary](../resources/managedtenants-credentialuserregistrationssummary.md) collection|Summary information for user registration for multi-factor authentication and self service password reset across managed tenants.|
+|deviceCompliancePolicySettingStateSummaries|[microsoft.graph.managedTenants.deviceCompliancePolicySettingStateSummary](../resources/managedtenants-devicecompliancepolicysettingstatesummary.md) collection|Summary information for device compliance policy setting states across managed tenants.|
+|managedDeviceCompliances|[microsoft.graph.managedTenants.managedDeviceCompliance](../resources/managedtenants-manageddevicecompliance.md) collection|The collection of compliance for managed devices across managed tenants.|
+|managedDeviceComplianceTrends|[microsoft.graph.managedTenants.managedDeviceComplianceTrend](../resources/managedtenants-manageddevicecompliancetrend.md) collection|Trend insights for device compliance across managed tenants.|
+|managementActions|[microsoft.graph.managedTenants.managementAction](../resources/managedtenants-managementaction.md) collection|The collection of baseline management actions across managed tenants.|
+|managementActionTenantDeploymentStatuses|[microsoft.graph.managedTenants.managementActionTenantDeploymentStatus](../resources/managedtenants-managementactiontenantdeploymentstatus.md) collection|The tenant level status of management actions across managed tenants.|
+|managementIntents|[microsoft.graph.managedTenants.managementIntent](../resources/managedtenants-managementintent.md) collection|The collection of baseline management intents across managed tenants.|
+|managementTemplates|[microsoft.graph.managedTenants.managementTemplate](../resources/managedtenants-managementtemplate.md) collection|The collection of baseline management templates across managed tenants.|
+|riskyUsers|[microsoft.graph.managedTenants.riskyUser](../resources/managedtenants-riskyuser.md) collection|The collection of users flagged for risk across managed tenants.|
+|tenantGroups|[microsoft.graph.managedTenants.tenantGroup](../resources/managedtenants-tenantgroup.md) collection|The collection of a logical grouping of managed tenants used by the multi-tenant management platform.|
+|tenants|[microsoft.graph.managedTenants.tenant](../resources/managedtenants-tenant.md) collection|The collection of tenants associated with the managing entity.|
+|tenantsCustomizedInformation|[microsoft.graph.managedTenants.tenantCustomizedInformation](../resources/managedtenants-tenantcustomizedinformation.md) collection|The collection of tenant level customized information across managed tenants.|
+|tenantsDetailedInformation|[microsoft.graph.managedTenants.tenantDetailedInformation](../resources/managedtenants-tenantdetailedinformation.md) collection|The collection tenant level detailed information across managed tenants.|
+|tenantTags|[microsoft.graph.managedTenants.tenantTag](../resources/managedtenants-tenanttag.md) collection|The collection of tenant tags across managed tenants.|
+|windowsDeviceMalwareStates|[microsoft.graph.managedTenants.windowsDeviceMalwareState](../resources/managedtenants-windowsdevicemalwarestate.md) collection|The state of malware for Windows devices, registered with Microsoft Endpoint Manager, across managed tenants.|
+|windowsProtectionStates|[microsoft.graph.managedTenants.windowsProtectionState](../resources/managedtenants-windowsprotectionstate.md) collection|The protection state for Windows devices, registered with Microsoft Endpoint Manager, across managed tenants.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.managedTenant",
+ "baseType": "microsoft.graph.entity",
+ "openType": true
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.managedTenant",
+ "id": "String (identifier)"
+}
+```
v1.0 Managedtenants Managedtenantexecutionerror https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-managedtenantexecutionerror.md
+
+ Title: "managedTenantExecutionError resource type"
+description: "Represents an exception for a managed tenant operation."
+
+localization_priority: Normal
++
+# managedTenantExecutionError resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents an exception for a managed tenant operation.
+
+Inherits from [managedTenantOperationError](../resources/managedtenants-managedtenantoperationerror.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|error|String|The error message for the exception. Inherited from [managedTenantOperationError](../resources/managedtenants-managedtenantoperationerror.md). Required. Read-only.|
+|errorDetails|String|Additional error information for the exception. Optional. Read-only.|
+|nodeId|Int32|The node identifier where the exception occurred. Required. Read-only.|
+|rawToken|String|The token for the exception. Optional. Read-only.|
+|statementIndex|Int32|The statement index for the exception. Required. Read-only.|
+|tenantId|String|The Azure Active Directory tenant identifier for the managed tenant. Inherited from [managedTenantOperationError](../resources/managedtenants-managedtenantoperationerror.md). Required. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.managedTenants.managedTenantExecutionError"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.managedTenantExecutionError",
+ "tenantId": "String",
+ "error": "String",
+ "rawToken": "String",
+ "statementIndex": "Integer",
+ "nodeId": "Integer",
+ "errorDetails": "String"
+}
+```
v1.0 Managedtenants Managedtenantgenericerror https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-managedtenantgenericerror.md
+
+ Title: "managedTenantGenericError resource type"
+description: "Represents a generic error for a managed tenant."
+
+localization_priority: Normal
++
+# managedTenantGenericError resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents a generic error for a managed tenant.
+
+Inherits from [managedTenantOperationError](../resources/managedtenants-managedtenantoperationerror.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|error|String|The error message for the exception. Inherited from [managedTenantOperationError](../resources/managedtenants-managedtenantoperationerror.md). Required. Read-only.|
+|tenantId|String|The Azure Active Directory tenant identifier for the managed tenant. Inherited from [managedTenantOperationError](../resources/managedtenants-managedtenantoperationerror.md). Optional. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.managedTenants.managedTenantGenericError"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.managedTenantGenericError",
+ "tenantId": "String",
+ "error": "String"
+}
+```
v1.0 Managedtenants Managedtenantoperationerror https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-managedtenantoperationerror.md
+
+ Title: "managedTenantOperationError resource type"
+description: "An abstract type that represents an error for a managed tenant operation."
+
+localization_priority: Normal
++
+# managedTenantOperationError resource type
+
+Namespace: microsoft.graph.managedTenants
++
+An abstract type that represents an error for a managed tenant operation.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|error|String|The error message for the exception.|
+|tenantId|String|The Azure Active Directory tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md).|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.managedTenants.managedTenantOperationError"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.managedTenantOperationError",
+ "tenantId": "String",
+ "error": "String"
+}
+```
v1.0 Managedtenants Managementaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-managementaction.md
+
+ Title: "managementAction resource type"
+description: "Represents a baseline management action for a given managed tenant."
+
+localization_priority: Normal
++
+# managementAction resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents a baseline management action for a given managed tenant. Examples of management actions are device encryption, perform configurations to allow Azure Active Directory device enrollment, and require multi-factor authentication for admins.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List managementActions](../api/managedtenants-managedtenant-list-managementactions.md)|[microsoft.graph.managedTenants.managementAction](../resources/managedtenants-managementaction.md) collection|Get a list of the [managementAction](../resources/managedtenants-managementaction.md) objects and their properties.|
+|[Get managementAction](../api/managedtenants-managementaction-get.md)|[microsoft.graph.managedTenants.managementAction](../resources/managedtenants-managementaction.md)|Read the properties and relationships of a [managementAction](../resources/managedtenants-managementaction.md) object.|
+|[apply](../api/managedtenants-managementaction-apply.md)|[microsoft.graph.managedTenants.managementActionDeploymentStatus](../resources/managedtenants-managementactiondeploymentstatus.md)|Applies the management actions against the managed tenant.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|category|managementCategory|The category for the management action. Possible values are: `custom`, `devices`, `identity`, `unknownFutureValue`. Optional. Read-only.|
+|description|String|The description for the management action. Optional. Read-only.|
+|displayName|String|The display name for the management action. Optional. Read-only.|
+|id|String|The unique identifier for the management action. Required. Read-only.|
+|referenceTemplateId|String|The reference for the management template used to generate the management action. Required. Read-only.|
+|workloadActions|[microsoft.graph.managedTenants.workloadAction](../resources/managedtenants-workloadaction.md) collection|The collection of workload actions associated with the management action. Required. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.managementAction",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.managementAction",
+ "id": "String (identifier)",
+ "referenceTemplateId": "String",
+ "displayName": "String",
+ "description": "String",
+ "category": "String",
+ "workloadActions": [
+ {
+ "@odata.type": "microsoft.graph.managedTenants.workloadAction"
+ }
+ ]
+}
+```
v1.0 Managedtenants Managementactiondeploymentstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-managementactiondeploymentstatus.md
+
+ Title: "managementActionDeploymentStatus resource type"
+description: "Represents the deployment status for a given managed tenant."
+
+localization_priority: Normal
++
+# managementActionDeploymentStatus resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents the deployment status for a given managed tenant.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|managementActionId|String|The identifier for the management action. Required. Read-only.|
+|managementTemplateId|String|The management template identifier that was used to generate the management action. Required. Read-only.|
+|status|managementActionStatus|The status of the management action. Possible values are: `toAddress`, `completed`, `error`, `timeOut`, `inProgress`, `planned`, `resolvedBy3rdParty`, `resolvedThroughAlternateMitigation`, `riskAccepted`, `unknownFutureValue`. Required.|
+|workloadActionDeploymentStatuses|[microsoft.graph.managedTenants.workloadActionDeploymentStatus](../resources/managedtenants-workloadactiondeploymentstatus.md) collection|The collection of workload action deployment statues for the given management action. Optional.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.managedTenants.managementActionDeploymentStatus"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.managementActionDeploymentStatus",
+ "managementTemplateId": "String",
+ "managementActionId": "String",
+ "status": "String",
+ "workloadActionDeploymentStatuses": [
+ {
+ "@odata.type": "microsoft.graph.managedTenants.workloadActionDeploymentStatus"
+ }
+ ]
+}
+```
v1.0 Managedtenants Managementactioninfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-managementactioninfo.md
+
+ Title: "managementActionInfo resource type"
+description: "Represents reference information for a management action."
+
+localization_priority: Normal
++
+# managementActionInfo resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents reference information for a management action.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|managementActionId|String|The identifier for the management action. Required. Read-only.|
+|managementTemplateId|String|The identifier for the management template. Required. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.managedTenants.managementActionInfo"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.managementActionInfo",
+ "managementTemplateId": "String",
+ "managementActionId": "String"
+}
+```
v1.0 Managedtenants Managementactiontenantdeploymentstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-managementactiontenantdeploymentstatus.md
+
+ Title: "managementActionTenantDeploymentStatus resource type"
+description: "Represents tenant level deployment status for the management action."
+
+localization_priority: Normal
++
+# managementActionTenantDeploymentStatus resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents tenant level deployment status for the management action.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List managementActionTenantDeploymentStatus](../api/managedtenants-managedtenant-list-managementactiontenantdeploymentstatuses.md)|[microsoft.graph.managedTenants.managementActionTenantDeploymentStatus](../resources/managedtenants-managementactiontenantdeploymentstatus.md) collection|Get a list of the [managementActionTenantDeploymentStatus](../resources/managedtenants-managementactiontenantdeploymentstatus.md) objects and their properties.|
+|[Get managementActionTenantDeploymentStatus](../api/managedtenants-managementactiontenantdeploymentstatus-get.md)|[microsoft.graph.managedTenants.managementActionTenantDeploymentStatus](../resources/managedtenants-managementactiontenantdeploymentstatus.md)|Read the properties and relationships of a [managementActionTenantDeploymentStatus](../resources/managedtenants-managementactiontenantdeploymentstatus.md) object.|
+|[changeDeploymentStatus](../api/managedtenants-managementactiontenantdeploymentstatus-changedeploymentstatus.md)|[microsoft.graph.managedTenants.managementActionDeploymentStatus](../resources/managedtenants-managementactiondeploymentstatus.md)|Changes the deployment status for the management action.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|The unique identifier for the tenant level deployment status. Required. Read-only.|
+|statuses|[microsoft.graph.managedTenants.managementActionDeploymentStatus](../resources/managedtenants-managementactiondeploymentstatus.md) collection|The collection of deployment status for each instance of a management action. Optional.|
+|tenantGroupId|String|The identifier for the tenant group that is associated with the management action. Required. Read-only.|
+|tenantId|String|The Azure Active Directory tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md). Required. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.managementActionTenantDeploymentStatus",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.managementActionTenantDeploymentStatus",
+ "id": "String (identifier)",
+ "tenantGroupId": "String",
+ "tenantId": "String",
+ "statuses": [
+ {
+ "@odata.type": "microsoft.graph.managedTenants.managementActionDeploymentStatus"
+ }
+ ]
+}
+```
v1.0 Managedtenants Managementintent https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-managementintent.md
+
+ Title: "managementIntent resource type"
+description: "Represents metadata for a baseline and what management templates are included."
+
+localization_priority: Normal
++
+# managementIntent resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents metadata for a baseline and what management templates are included.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List managementIntents](../api/managedtenants-managedtenant-list-managementintents.md)|[microsoft.graph.managedTenants.managementIntent](../resources/managedtenants-managementintent.md) collection|Get a list of the [managementIntent](../resources/managedtenants-managementintent.md) objects and their properties.|
+|[Get managementIntent](../api/managedtenants-managementintent-get.md)|[microsoft.graph.managedTenants.managementIntent](../resources/managedtenants-managementintent.md)|Read the properties and relationships of a [managementIntent](../resources/managedtenants-managementintent.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|The display name for the management intent. Optional. Read-only.|
+|id|String|The unique identifier for the management intent. Required. Read-only.|
+|isGlobal|Boolean|A flag indicating whether the management intent is global. Required. Read-only.|
+|managementTemplates|[microsoft.graph.managedTenants.managementTemplateDetailedInfo](../resources/managedtenants-managementtemplatedetailedinfo.md) collection|The collection of management templates associated with the management intent. Optional. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.managementIntent",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.managementIntent",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "isGlobal": "Boolean",
+ "managementTemplates": [
+ {
+ "@odata.type": "microsoft.graph.managedTenants.managementTemplateDetailedInfo"
+ }
+ ]
+}
+```
v1.0 Managedtenants Managementintentinfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-managementintentinfo.md
+
+ Title: "managementIntentInfo resource type"
+description: "Represents relationship information for a management intent."
+
+localization_priority: Normal
++
+# managementIntentInfo resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents relationship information for a management intent.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|managementIntentDisplayName|String|The display name for the management intent. Optional. Read-only.|
+|managementIntentId|String|The identifier for the management intent. Required. Read-only.|
+|managementTemplates|[microsoft.graph.managedTenants.managementTemplateDetailedInfo](../resources/managedtenants-managementtemplatedetailedinfo.md) collection|The collection of management template information associated with the management intent. Optional. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.managedTenants.managementIntentInfo"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.managementIntentInfo",
+ "managementIntentId": "String",
+ "managementIntentDisplayName": "String",
+ "managementTemplates": [
+ {
+ "@odata.type": "microsoft.graph.managedTenants.managementTemplateDetailedInfo"
+ }
+ ]
+}
+```
v1.0 Managedtenants Managementtemplate https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-managementtemplate.md
+
+ Title: "managementTemplate resource type"
+description: "Represents a group of actions and setting that can be performed against a managed tenant."
+
+localization_priority: Normal
++
+# managementTemplate resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents a group of actions and setting that can be performed against a managed tenant.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List managementTemplates](../api/managedtenants-managedtenant-list-managementtemplates.md)|[microsoft.graph.managedTenants.managementTemplate](../resources/managedtenants-managementtemplate.md) collection|Get a list of the [managementTemplate](../resources/managedtenants-managementtemplate.md) objects and their properties.|
+|[Get managementTemplate](../api/managedtenants-managementtemplate-get.md)|[microsoft.graph.managedTenants.managementTemplate](../resources/managedtenants-managementtemplate.md)|Read the properties and relationships of a [managementTemplate](../resources/managedtenants-managementtemplate.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|category|managementCategory|The management category for the management template. Possible values are: `custom`, `devices`, `identity`, `unknownFutureValue`. Required. Read-only.|
+|description|String|The description for the management template. Optional. Read-only.|
+|displayName|String|The display name for the management template. Required. Read-only.|
+|id|String|The unique identifier for the management template. Required. Read-only.|
+|parameters|[microsoft.graph.managedTenants.templateParameter](../resources/managedtenants-templateparameter.md) collection|The collection of parameters used by the management template. Optional. Read-only.|
+|workloadActions|[microsoft.graph.managedTenants.workloadAction](../resources/managedtenants-workloadaction.md) collection|The collection of workload actions associated with the management template. Optional. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.managementTemplate",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.managementTemplate",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "description": "String",
+ "category": "String",
+ "parameters": [
+ {
+ "@odata.type": "microsoft.graph.managedTenants.templateParameter"
+ }
+ ],
+ "workloadActions": [
+ {
+ "@odata.type": "microsoft.graph.managedTenants.workloadAction"
+ }
+ ]
+}
+```
v1.0 Managedtenants Managementtemplatedetailedinfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-managementtemplatedetailedinfo.md
+
+ Title: "managementTemplateDetailedInfo resource type"
+description: "Represents detailed information for the management template."
+
+localization_priority: Normal
++
+# managementTemplateDetailedInfo resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents detailed information for the management template.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|category|managementCategory|The management category for the management template. Possible values are: `custom`, `devices`, `identity`, `unknownFutureValue`. Required. Read-only.|
+|displayName|String|The display name for the management template. Required. Read-only.|
+|managementTemplateId|String|The unique identifier for the management template. Required. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.managedTenants.managementTemplateDetailedInfo"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.managementTemplateDetailedInfo",
+ "managementTemplateId": "String",
+ "displayName": "String",
+ "category": "String"
+}
+```
v1.0 Managedtenants Riskyuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-riskyuser.md
+
+ Title: "riskyUser resource type"
+description: "Represents an account flagged for risk across each managed tenants."
+
+localization_priority: Normal
++
+# riskyUser resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents an account flagged for risk across each managed tenants.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List riskyUsers](../api/managedtenants-managedtenant-list-riskyusers.md)|[microsoft.graph.managedTenants.riskyUser](../resources/managedtenants-riskyuser.md) collection|Get a list of the [riskyUser](../resources/managedtenants-riskyuser.md) objects and their properties.|
+|[Get riskyUser](../api/managedtenants-riskyuser-get.md)|[microsoft.graph.managedTenants.riskyUser](../resources/managedtenants-riskyuser.md)|Read the properties and relationships of a [riskyUser](../resources/managedtenants-riskyuser.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|The unique identifier for this entity. Required. Read-only.|
+|isDeleted|Boolean|A flag indicating whether the account has been deleted. Optional. Read-only.|
+|lastRefreshedDateTime|DateTimeOffset|Date and time the entity was last updated in the multi-tenant management platform. Optional. Read-only.|
+|riskDetail|String|The risk details for the account flagged for risk. Optional. Read-only.|
+|riskLastUpdatedDateTime|DateTimeOffset|The date and time when the risk information was last updated. Optional. Read-only.|
+|riskLevel|String|The level of risk that was detected. Possible values are: `low`, `medium`, `high`, `hidden`, `none`, `unknownFutureValue`. Optional. Read-only.|
+|riskState|String|The state of risk that was detected. Possible values are: `none`, `confirmedSafe`, `remediated`, `dismissed`, `atRisk`, `confirmedCompromised`, `unknownFutureValue`. Optional. Read-only.|
+|tenantDisplayName|String|The display name for the managed tenant. Optional. Read-only.|
+|tenantId|String|The Azure Active Directory tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md). Required. Read-only.|
+|userDisplayName|String|The display name for the account where risk was detected. Optional. Read-only.|
+|userId|String|The identifier for the user account where risk was detected. Required. Read-only.|
+|userPrincipalName|String|The user principal name (UPN) for the account where risk was detected. Optional. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.riskyUser",
+ "baseType": "microsoft.graph.entity",
+ "openType": true
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.riskyUser",
+ "id": "String (identifier)",
+ "userId": "String",
+ "tenantId": "String",
+ "tenantDisplayName": "String",
+ "userDisplayName": "String",
+ "userPrincipalName": "String",
+ "riskState": "String",
+ "riskLevel": "String",
+ "riskDetail": "String",
+ "isDeleted": "Boolean",
+ "riskLastUpdatedDateTime": "String (timestamp)",
+ "lastRefreshedDateTime": "String (timestamp)"
+}
+```
v1.0 Managedtenants Setting https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-setting.md
+
+ Title: "setting resource type"
+description: "Represents a setting that is used within a baseline."
+
+localization_priority: Normal
++
+# setting resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents a setting that is used within a baseline.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|The display name for the setting. Required. Read-only.|
+|jsonValue|String|The value for the setting serialized as string of JSON. Required. Read-only.|
+|overwriteAllowed|Boolean|A flag indicating whether the setting can be override existing configurations when applied. Required. Read-only.|
+|valueType|managementParameterValueType|The data type for the setting. Possible values are: `string`, `integer`, `boolean`, `guid`, `stringCollection`, `integerCollection`, `booleanCollection`, `guidCollection`, `unknownFutureValue`. Required. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.managedTenants.setting"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.setting",
+ "displayName": "String",
+ "overwriteAllowed": "Boolean",
+ "valueType": "String",
+ "jsonValue": "String"
+}
+```
v1.0 Managedtenants Templateparameter https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-templateparameter.md
+
+ Title: "templateParameter resource type"
+description: "Represents a parameter utilized in a management template."
+
+localization_priority: Normal
++
+# templateParameter resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents a parameter utilized in a management template.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|description|String|The description for the template parameter. Optional. Read-only.|
+|displayName|String|The display name for the template parameter. Required. Read-only.|
+|jsonAllowedValues|String|The allowed values for the template parameter represented by a serialized string of JSON. Optional. Read-only.|
+|jsonDefaultValue|String|The default value for the template parameter represented by a serialized string of JSON. Required. Read-only.|
+|valueType|managementParameterValueType|The data type for the template parameter.. Possible values are: `string`, `integer`, `boolean`, `guid`, `stringCollection`, `integerCollection`, `booleanCollection`, `guidCollection`, `unknownFutureValue`. Required. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.managedTenants.templateParameter"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.templateParameter",
+ "displayName": "String",
+ "description": "String",
+ "valueType": "String",
+ "jsonDefaultValue": "String",
+ "jsonAllowedValues": "String"
+}
+```
v1.0 Managedtenants Tenant https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-tenant.md
+
+ Title: "tenant resource type"
+description: "Represents a tenant associated with the managing entity."
+
+localization_priority: Normal
++
+# tenant resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents a tenant associated with the managing entity.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List tenants](../api/managedtenants-managedtenant-list-tenants.md)|[microsoft.graph.managedTenants.tenant](../resources/managedtenants-tenant.md) collection|Get a list of the [tenant](../resources/managedtenants-tenant.md) objects and their properties.|
+|[Get tenant](../api/managedtenants-tenant-get.md)|[microsoft.graph.managedTenants.tenant](../resources/managedtenants-tenant.md)|Read the properties and relationships of a [tenant](../resources/managedtenants-tenant.md) object.|
+|[offboardTenant](../api/managedtenants-tenant-offboardtenant.md)|[microsoft.graph.managedTenants.tenant](../resources/managedtenants-tenant.md)|Off boards a tenant from the multi-tenant management platform.|
+|[resetTenantOnboardingStatus](../api/managedtenants-tenant-resettenantonboardingstatus.md)|[microsoft.graph.managedTenants.tenant](../resources/managedtenants-tenant.md)|Resets the tenant onboarding status with the multi-tenant management platform.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|contract|[microsoft.graph.managedTenants.tenantContract](../resources/managedtenants-tenantcontract.md)|The relationship details for the tenant with the managing entity.|
+|createdDateTime|DateTimeOffset|The date and time the tenant was created in the multi-tenant management platform. Optional. Read-only.|
+|displayName|String|The display name for the tenant. Required. Read-only.|
+|id|String|The Azure Active Directory tenant identifier for the tenant. Required. Read-only.|
+|lastUpdatedDateTime|DateTimeOffset|The date and time the tenant was last updated within the multi-tenant management platform. Optional. Read-only.|
+|tenantId|String|The Azure Active Directory tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md). Optional. Read-only.|
+|tenantStatusInformation|[microsoft.graph.managedTenants.tenantStatusInformation](../resources/managedtenants-tenantstatusinformation.md)|The onboarding status information for the tenant. Optional. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.tenant",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.tenant",
+ "id": "String (identifier)",
+ "tenantId": "String",
+ "displayName": "String",
+ "contract": {
+ "@odata.type": "microsoft.graph.managedTenants.tenantContract"
+ },
+ "tenantStatusInformation": {
+ "@odata.type": "microsoft.graph.managedTenants.tenantStatusInformation"
+ },
+ "lastUpdatedDateTime": "String (timestamp)",
+ "createdDateTime": "String (timestamp)"
+}
+```
v1.0 Managedtenants Tenantcontactinformation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-tenantcontactinformation.md
+
+ Title: "tenantContactInformation resource type"
+description: "Represents a contact at a managed tenant."
+
+localization_priority: Normal
++
+# tenantContactInformation resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents a contact at a managed tenant.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|email|String|The email address for the contact. Optional|
+|name|String|The name for the contact. Required.|
+|notes|String|The notes associated with the contact. Optional|
+|phone|String|The phone number for the contact. Optional.|
+|title|String|The title for the contact. Required.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.managedTenants.tenantContactInformation"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.tenantContactInformation",
+ "name": "String",
+ "title": "String",
+ "email": "String",
+ "phone": "String",
+ "notes": "String"
+}
+```
v1.0 Managedtenants Tenantcontract https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-tenantcontract.md
+
+ Title: "tenantContract resource type"
+description: "Represents relationship information between a tenant and the managing entity."
+
+localization_priority: Normal
++
+# tenantContract resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents relationship information between a tenant and the managing entity.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|contractType|Int32|The type of relationship that exists between the managing entity and tenant. Optional. Read-only.|
+|defaultDomainName|String|The default domain name for the tenant. Required. Read-only.|
+|displayName|String|The display name for the tenant. Optional. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.managedTenants.tenantContract"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.tenantContract",
+ "contractType": "Integer",
+ "displayName": "String",
+ "defaultDomainName": "String"
+}
+```
v1.0 Managedtenants Tenantcustomizedinformation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-tenantcustomizedinformation.md
+
+ Title: "tenantCustomizedInformation resource type"
+description: "Represents customizable information for a managed tenant."
+
+localization_priority: Normal
++
+# tenantCustomizedInformation resource type
+
+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.|
+
+## 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 Azure Active Directory tenant identifier for the managed tenant. Required. Read-only.|
+|tenantId|String|The Azure Active Directory tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md). Optional. Read-only.|
+|website|String|The website for the managed tenant. Required.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.tenantCustomizedInformation",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.tenantCustomizedInformation",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "tenantId": "String",
+ "contacts": [
+ {
+ "@odata.type": "microsoft.graph.managedTenants.tenantContactInformation"
+ }
+ ],
+ "website": "String"
+}
+```
v1.0 Managedtenants Tenantdetailedinformation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-tenantdetailedinformation.md
+
+ Title: "tenantDetailedInformation resource type"
+description: "Represents detailed information for a managed tenant."
+
+localization_priority: Normal
++
+# tenantDetailedInformation resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents detailed information for a managed tenant.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List tenantDetailedInformation](../api/managedtenants-managedtenant-list-tenantsdetailedinformation.md)|[microsoft.graph.managedTenants.tenantDetailedInformation](../resources/managedtenants-tenantdetailedinformation.md) collection|Get a list of the [tenantDetailedInformation](../resources/managedtenants-tenantdetailedinformation.md) objects and their properties.|
+|[Get tenantDetailedInformation](../api/managedtenants-tenantdetailedinformation-get.md)|[microsoft.graph.managedTenants.tenantDetailedInformation](../resources/managedtenants-tenantdetailedinformation.md)|Read the properties and relationships of a [tenantDetailedInformation](../resources/managedtenants-tenantdetailedinformation.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|city|String|The city where the managed tenant is located. Optional. Read-only.|
+|countryCode|String|The code for the country where the managed tenant is located. Optional. Read-only.|
+|countryName|String|The name for the country where the managed tenant is located. Optional. Read-only.|
+|defaultDomainName|String|The default domain name for the managed tenant. Optional. Read-only.|
+|displayName|String|The display name for the managed tenant.|
+|id|String|The unique identifier for this entity. Required. Read-only.|
+|industryName|String|The business industry associated with the managed tenant. Optional. Read-only.|
+|region|String|The region where the managed tenant is located. Optional. Read-only.|
+|segmentName|String|The business segment associated with the managed tenant. Optional. Read-only.|
+|tenantId|String|The Azure Active Directory tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md).|
+|verticalName|String|The vertical associated with the managed tenant. Optional. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.tenantDetailedInformation",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.tenantDetailedInformation",
+ "id": "String (identifier)",
+ "tenantId": "String",
+ "displayName": "String",
+ "defaultDomainName": "String",
+ "countryName": "String",
+ "countryCode": "String",
+ "city": "String",
+ "region": "String",
+ "verticalName": "String",
+ "industryName": "String",
+ "segmentName": "String"
+}
+```
+
v1.0 Managedtenants Tenantgroup https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-tenantgroup.md
+
+ Title: "tenantGroup resource type"
+description: "Represents a logical group of managed tenants."
+
+localization_priority: Normal
++
+# tenantGroup resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents a logical group of managed tenants.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List tenantGroups](../api/managedtenants-managedtenant-list-tenantgroups.md)|[microsoft.graph.managedTenants.tenantGroup](../resources/managedtenants-tenantgroup.md) collection|Get a list of the [tenantGroup](../resources/managedtenants-tenantgroup.md) objects and their properties.|
+|[Get tenantGroup](../api/managedtenants-tenantgroup-get.md)|[microsoft.graph.managedTenants.tenantGroup](../resources/managedtenants-tenantgroup.md)|Read the properties and relationships of a [tenantGroup](../resources/managedtenants-tenantgroup.md) object.|
+|[tenantSearch](../api/managedtenants-tenantgroup-tenantsearch.md)|[microsoft.graph.managedTenants.tenantGroup](../resources/managedtenants-tenantgroup.md) collection|Searches for the specific managed tenant across tenant groups.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|allTenantsIncluded|Boolean|A flag indicating whether all managed tenant are included in the tenant group. Required. Read-only.|
+|displayName|String|The display name for the tenant group. Optional. Read-only.|
+|id|String|The unique identifier for the tenant group. Required. Read-only.|
+|managementActions|[microsoft.graph.managedTenants.managementActionInfo](../resources/managedtenants-managementactioninfo.md) collection|The collection of management action associated with the tenant group. Optional. Read-only.|
+|managementIntents|[microsoft.graph.managedTenants.managementIntentInfo](../resources/managedtenants-managementintentinfo.md) collection|The collection of management intents associated with the tenant group. Optional. Read-only.|
+|tenantIds|String collection|The collection of managed tenant identifiers include in the tenant group. Optional. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.tenantGroup",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.tenantGroup",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "allTenantsIncluded": "Boolean",
+ "tenantIds": [
+ "String"
+ ],
+ "managementIntents": [
+ {
+ "@odata.type": "microsoft.graph.managedTenants.managementIntentInfo"
+ }
+ ],
+ "managementActions": [
+ {
+ "@odata.type": "microsoft.graph.managedTenants.managementActionInfo"
+ }
+ ]
+}
+```
v1.0 Managedtenants Tenantinfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-tenantinfo.md
+
+ Title: "tenantInfo resource type"
+description: "Represents information for a managed tenant."
+
+localization_priority: Normal
++
+# tenantInfo resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents information for a managed tenant.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|tenantId|String|The Azure Active Directory tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md). Optional.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.managedTenants.tenantInfo"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.tenantInfo",
+ "tenantId": "String"
+}
+```
v1.0 Managedtenants Tenantstatusinformation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-tenantstatusinformation.md
+
+ Title: "tenantStatusInformation resource type"
+description: "Represents onboarding status information for a managed tenant."
+
+localization_priority: Normal
++
+# tenantStatusInformation resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents onboarding status information for a managed tenant.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|delegatedPrivilegeStatus|delegatedPrivilegeStatus|The status of the delegated admin privilege relationship between the managing entity and the managed tenant. Possible values are: `none`, `delegatedAdminPrivileges`, `unknownFutureValue`. Optional. Read-only.|
+|lastDelegatedPrivilegeRefreshDateTime|DateTimeOffset|The date and time the delegated admin privileges status was updated. Optional. Read-only.|
+|offboardedByUserId|String|The identifier for the account that offboarded the managed tenant. Optional. Read-only.|
+|offboardedDateTime|DateTimeOffset|The date and time when the managed tenant was offboarded. Optional. Read-only.|
+|onboardedByUserId|String|The identifier for the account that onboarded the managed tenant. Optional. Read-only.|
+|onboardedDateTime|DateTimeOffset|The date and time when the managed tenant was onboarded. Optional. Read-only.|
+|onboardingStatus|tenantOnboardingStatus|The onboarding status for the managed tenant.. Possible values are: `ineligible`, `inProcess`, `active`, `inactive`, `unknownFutureValue`. Optional. Read-only.|
+|workloadStatuses|[microsoft.graph.managedTenants.workloadStatus](../resources/managedtenants-workloadstatus.md) collection|The collection of workload statues for the managed tenant. Optional. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.managedTenants.tenantStatusInformation"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.tenantStatusInformation",
+ "onboardingStatus": "String",
+ "onboardedDateTime": "String (timestamp)",
+ "onboardedByUserId": "String",
+ "offboardedDateTime": "String (timestamp)",
+ "offboardedByUserId": "String",
+ "delegatedPrivilegeStatus": "String",
+ "lastDelegatedPrivilegeRefreshDateTime": "String (timestamp)",
+ "workloadStatuses": [
+ {
+ "@odata.type": "microsoft.graph.managedTenants.workloadStatus"
+ }
+ ]
+}
+```
v1.0 Managedtenants Tenanttag https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-tenanttag.md
+
+ Title: "tenantTag resource type"
+description: "Represents a tag that can be assigned to managed tenant."
+
+localization_priority: Normal
++
+# tenantTag resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents a tag that can be assigned to managed tenant.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List tenantTags](../api/managedtenants-managedtenant-list-tenanttags.md)|[microsoft.graph.managedTenants.tenantTag](../resources/managedtenants-tenanttag.md) collection|Get a list of the [tenantTag](../resources/managedtenants-tenanttag.md) objects and their properties.|
+|[Create tenantTag](../api/managedtenants-managedtenant-post-tenanttags.md)|[microsoft.graph.managedTenants.tenantTag](../resources/managedtenants-tenanttag.md)|Create a new [tenantTag](../resources/managedtenants-tenanttag.md) object.|
+|[Get tenantTag](../api/managedtenants-tenanttag-get.md)|[microsoft.graph.managedTenants.tenantTag](../resources/managedtenants-tenanttag.md)|Read the properties and relationships of a [tenantTag](../resources/managedtenants-tenanttag.md) object.|
+|[Update tenantTag](../api/managedtenants-tenanttag-update.md)|[microsoft.graph.managedTenants.tenantTag](../resources/managedtenants-tenanttag.md)|Update the properties of a [tenantTag](../resources/managedtenants-tenanttag.md) object.|
+|[Delete tenantTag](../api/managedtenants-tenanttag-delete.md)|None|Deletes a [tenantTag](../resources/managedtenants-tenanttag.md) object.|
+|[assignTag](../api/managedtenants-tenanttag-assigntag.md)|[microsoft.graph.managedTenants.tenantTag](../resources/managedtenants-tenanttag.md)|Assigns the tenant tag to the specified managed tenants.|
+|[unassignTag](../api/managedtenants-tenanttag-unassigntag.md)|[microsoft.graph.managedTenants.tenantTag](../resources/managedtenants-tenanttag.md)|Un-assigns the tenant tag from the specified managed tenants.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|createdByUserId|String|The identifier for the account that created the tenant tag. Required. Read-only.|
+|createdDateTime|DateTimeOffset|The date and time when the tenant tag was created. Required. Read-only.|
+|deletedDateTime|DateTimeOffset|The date and time when the tenant tag was deleted. Required. Read-only.|
+|description|String|The description for the tenant tag. Optional. Read-only.|
+|displayName|String|The display name for the tenant tag. Required. Read-only.|
+|id|String|The unique identifier for the tenant tag. Required. Read-only.|
+|lastActionByUserId|String|The identifier for the account that lasted on the tenant tag. Optional. Read-only.|
+|lastActionDateTime|DateTimeOffset|The date and time the last action was performed against the tenant tag. Optional. Read-only.|
+|tenants|[microsoft.graph.managedTenants.tenantInfo](../resources/managedtenants-tenantinfo.md) collection|The collection of managed tenants associated with the tenant tag. Optional.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.tenantTag",
+ "baseType": "microsoft.graph.entity",
+ "openType": true
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.tenantTag",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "description": "String",
+ "createdByUserId": "String",
+ "lastActionByUserId": "String",
+ "tenants": [
+ {
+ "@odata.type": "microsoft.graph.managedTenants.tenantInfo"
+ }
+ ],
+ "lastActionDateTime": "String (timestamp)",
+ "createdDateTime": "String (timestamp)",
+ "deletedDateTime": "String (timestamp)"
+}
+```
v1.0 Managedtenants Windowsdevicemalwarestate https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-windowsdevicemalwarestate.md
+
+ Title: "windowsDeviceMalwareState resource type"
+description: "Represents the state of discovered malware for devices runnings Windows that have been registered for management."
+
+localization_priority: Normal
++
+# windowsDeviceMalwareState resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents the state of discovered malware for devices runnings Windows that have been registered for management.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List windowsDeviceMalwareStates](../api/managedtenants-managedtenant-list-windowsdevicemalwarestates.md)|[microsoft.graph.managedTenants.windowsDeviceMalwareState](../resources/managedtenants-windowsdevicemalwarestate.md) collection|Get a list of the [windowsDeviceMalwareState](../resources/managedtenants-windowsdevicemalwarestate.md) objects and their properties.
+|[Get windowsDeviceMalwareState](../api/managedtenants-windowsdevicemalwarestate-get.md)|[microsoft.graph.managedTenants.windowsDeviceMalwareState](../resources/managedtenants-windowsdevicemalwarestate.md)|Read the properties and relationships of a [windowsDeviceMalwareState](../resources/managedtenants-windowsdevicemalwarestate.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|additionalInformationUrl|String|The additional information URL for the discovered malware. Optional. Read-only.|
+|detectionCount|Int32|The number of times the piece of malware has been detected. Optional. Read-only.|
+|deviceDeleted|Boolean|A flag indicating whether the device has been deleted. Optional. Read-only.|
+|id|String|The unique identifier for the device malware state. Required. Read-only.|
+|initialDetectionDateTime|DateTimeOffset|The date and time the piece of malware was initially detected. Optional. Read-only.|
+|lastRefreshedDateTime|DateTimeOffset|Date and time the entity was last updated in the multi-tenant management platform. Optional. Read-only.|
+|lastStateChangeDateTime|DateTimeOffset|The date and time the malware state was last changed. Optional. Read-only.|
+|malwareCategory|String|The category for the detected malware. Optional. Read-only.|
+|malwareDisplayName|String|The display name for the detected malware. Optional. Read-only.|
+|malwareExecutionState|String|The execution state for the detected malware. Optional. Read-only.|
+|malwareId|String|The unique identifier for the detected malware. Optional. Read-only.|
+|malwareSeverity|String|The severity for the detected malware. Optional. Read-only.|
+|malwareThreatState|String|The threat state for the detected malware. Optional. Read-only.|
+|managedDeviceId|String|The identifier for the managed device where the malware was detected. Optional. Read-only.|
+|managedDeviceName|String|The display name for the managed device where the malware was detected. Optional. Read-only.|
+|tenantDisplayName|String|The display name for the managed tenant. Optional. Read-only.|
+|tenantId|String|The Azure Active Directory tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md). Optional. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.windowsDeviceMalwareState",
+ "baseType": "microsoft.graph.entity",
+ "openType": true
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.windowsDeviceMalwareState",
+ "id": "String (identifier)",
+ "tenantId": "String",
+ "tenantDisplayName": "String",
+ "managedDeviceId": "String",
+ "managedDeviceName": "String",
+ "malwareId": "String",
+ "malwareExecutionState": "String",
+ "malwareThreatState": "String",
+ "initialDetectionDateTime": "String (timestamp)",
+ "lastStateChangeDateTime": "String (timestamp)",
+ "detectionCount": "Integer",
+ "deviceDeleted": "Boolean",
+ "malwareCategory": "String",
+ "malwareSeverity": "String",
+ "malwareDisplayName": "String",
+ "lastRefreshedDateTime": "String (timestamp)",
+ "additionalInformationUrl": "String"
+}
+```
v1.0 Managedtenants Windowsprotectionstate https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-windowsprotectionstate.md
+
+ Title: "windowsProtectionState resource type"
+description: "Represent the Windows protection state for managed devices running Windows."
+
+localization_priority: Normal
++
+# windowsProtectionState resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represent the Windows protection state for managed devices running Windows.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List windowsProtectionStates](../api/managedtenants-managedtenant-list-windowsprotectionstates.md)|[microsoft.graph.managedTenants.windowsProtectionState](../resources/managedtenants-windowsprotectionstate.md) collection|Get a list of the [windowsProtectionState](../resources/managedtenants-windowsprotectionstate.md) objects and their properties.|
+|[Get windowsProtectionState](../api/managedtenants-windowsprotectionstate-get.md)|[microsoft.graph.managedTenants.windowsProtectionState](../resources/managedtenants-windowsprotectionstate.md)|Read the properties and relationships of a [windowsProtectionState](../resources/managedtenants-windowsprotectionstate.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|antiMalwareVersion|String|The anti-malware version for the managed device. Optional. Read-only.|
+|attentionRequired|Boolean|A flag indicating whether attention is required for the managed device. Optional. Read-only.|
+|deviceDeleted|Boolean|A flag indicating whether the managed device has been deleted. Optional. Read-only.|
+|devicePropertyRefreshDateTime|DateTimeOffset|The date and time the device property has been refreshed. Optional. Read-only.|
+|engineVersion|String|The anti-virus engine version for the managed device. Optional. Read-only.|
+|fullScanOverdue|Boolean|A flag indicating whether quick scan is overdue for the managed device. Optional. Read-only.|
+|fullScanRequired|Boolean|A flag indicating whether full scan is overdue for the managed device. Optional. Read-only.|
+|id|String|The unique identifier for the Windows protection state. Required. Read-only.|
+|lastFullScanDateTime|DateTimeOffset|The date and time a full scan was completed. Optional. Read-only.|
+|lastFullScanSignatureVersion|String|The version anti-malware version used to perform the last full scan. Optional. Read-only.|
+|lastQuickScanDateTime|DateTimeOffset|The date and time a quick scan was completed. Optional. Read-only.|
+|lastQuickScanSignatureVersion|String|The version anti-malware version used to perform the last full scan. Optional. Read-only.|
+|lastRefreshedDateTime|DateTimeOffset|Date and time the entity was last updated in the multi-tenant management platform. Optional. Read-only.|
+|lastReportedDateTime|DateTimeOffset|The date and time the protection state was last reported for the managed device. Optional. Read-only.|
+|malwareProtectionEnabled|Boolean|A flag indicating whether malware protection is enabled for the managed device. Optional. Read-only.|
+|managedDeviceHealthState|String|The health state for the managed device. Optional. Read-only.|
+|managedDeviceId|String|The unique identifier for the managed device. Optional. Read-only.|
+|managedDeviceName|String|The display name for the managed device. Optional. Read-only.|
+|networkInspectionSystemEnabled|Boolean|A flag indicating whether the network inspection system is enabled. Optional. Read-only.|
+|quickScanOverdue|Boolean|A flag indicating weather a quick scan is overdue. Optional. Read-only.|
+|realTimeProtectionEnabled|Boolean|A flag indicating whether real time protection is enabled. Optional. Read-only.|
+|rebootRequired|Boolean|A flag indicating whether a reboot is required. Optional. Read-only.|
+|signatureUpdateOverdue|Boolean|A flag indicating whether an signature update is overdue. Optional. Read-only.|
+|signatureVersion|String|The signature version for the managed device. Optional. Read-only.|
+|tenantDisplayName|String|The display name for the managed tenant. Optional. Read-only.|
+|tenantId|String|The Azure Active Directory tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md). Optional. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.windowsProtectionState",
+ "baseType": "microsoft.graph.entity",
+ "openType": true
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.windowsProtectionState",
+ "id": "String (identifier)",
+ "tenantId": "String",
+ "tenantDisplayName": "String",
+ "managedDeviceId": "String",
+ "managedDeviceName": "String",
+ "malwareProtectionEnabled": "Boolean",
+ "managedDeviceHealthState": "String",
+ "realTimeProtectionEnabled": "Boolean",
+ "networkInspectionSystemEnabled": "Boolean",
+ "quickScanOverdue": "Boolean",
+ "fullScanOverdue": "Boolean",
+ "signatureUpdateOverdue": "Boolean",
+ "rebootRequired": "Boolean",
+ "attentionRequired": "Boolean",
+ "fullScanRequired": "Boolean",
+ "engineVersion": "String",
+ "signatureVersion": "String",
+ "antiMalwareVersion": "String",
+ "lastQuickScanDateTime": "String (timestamp)",
+ "lastFullScanDateTime": "String (timestamp)",
+ "lastQuickScanSignatureVersion": "String",
+ "lastFullScanSignatureVersion": "String",
+ "lastReportedDateTime": "String (timestamp)",
+ "devicePropertyRefreshDateTime": "String (timestamp)",
+ "deviceDeleted": "Boolean",
+ "lastRefreshedDateTime": "String (timestamp)"
+}
+```
v1.0 Managedtenants Workloadaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-workloadaction.md
+
+ Title: "workloadAction resource type"
+description: "Represents an action that will be performed for a specific workload."
+
+localization_priority: Normal
++
+# workloadAction resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents an action that will be performed for a specific workload.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|actionId|String|The unique identifier for the workload action. Required. Read-only.|
+|category|workloadActionCategory|The category for the workload action. Possible values are: `automated`, `manual`, `unknownFutureValue`. Optional. Read-only.|
+|description|String|The description for the workload action. Optional. Read-only.|
+|displayName|String|The display name for the workload action. Optional. Read-only.|
+|service|String|The service associated with workload action. Optional. Read-only.|
+|settings|[microsoft.graph.managedTenants.setting](../resources/managedtenants-setting.md) collection|The collection of settings associated with the workload action. Optional. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.managedTenants.workloadAction"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.workloadAction",
+ "actionId": "String",
+ "category": "String",
+ "displayName": "String",
+ "description": "String",
+ "service": "String",
+ "settings": [
+ {
+ "@odata.type": "microsoft.graph.managedTenants.setting"
+ }
+ ]
+}
+```
v1.0 Managedtenants Workloadactiondeploymentstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-workloadactiondeploymentstatus.md
+
+ Title: "workloadActionDeploymentStatus resource type"
+description: "Represents the deployment status for the workload action."
+
+localization_priority: Normal
++
+# workloadActionDeploymentStatus resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents the deployment status for the workload action.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|actionId|String|The unique identifier for the workload action. Required. Read-only.|
+|deployedPolicyId|String|The identifier of any policy that was created by applying the workload action. Optional. Read-only.|
+|error|[microsoft.graph.genericError](../resources/genericerror.md)|The detailed information for exceptions that occur when deploying the workload action. Optional. Required.|
+|lastDeploymentDateTime|DateTimeOffset|The date and time the workload action was last deployed. Optional.|
+|status|workloadActionStatus|The status of the workload action deployment. Possible values are: `toAddress`, `completed`, `error`, `timeOut`, `inProgress`, `unknownFutureValue`. Required. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.managedTenants.workloadActionDeploymentStatus"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.workloadActionDeploymentStatus",
+ "actionId": "String",
+ "status": "String",
+ "error": {
+ "@odata.type": "microsoft.graph.genericError"
+ },
+ "deployedPolicyId": "String",
+ "lastDeploymentDateTime": "String (timestamp)"
+}
+```
v1.0 Managedtenants Workloadstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/managedtenants-workloadstatus.md
+
+ Title: "workloadStatus resource type"
+description: "Represent the status for a workload."
+
+localization_priority: Normal
++
+# workloadStatus resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represent the status for a workload.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|The display name for the workload. Required. Read-only.|
+|offboardedDateTime|DateTimeOffset|The date and time the workload was offboarded. Optional. Read-only.|
+|onboardedDateTime|DateTimeOffset|The date and time the workload was onboarded. Optional. Read-only.|
+|onboardingStatus|workloadOnboardingStatus|The onboarding status for the workload. Possible values are: `notOnboarded`, `onboarded`, `unknownFutureValue`. Optional. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.managedTenants.workloadStatus"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.workloadStatus",
+ "onboardingStatus": "String",
+ "onboardedDateTime": "String (timestamp)",
+ "displayName": "String",
+ "offboardedDateTime": "String (timestamp)"
+}
+```
v1.0 Mobilitymanagementpolicy https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/mobilitymanagementpolicy.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-In Azure AD, a mobility management policy represents an auto-enrollment configuration for a mobility management (MDM or MAM) application. These policies are only applicable to devices based on Windows 10 OS and its derivatives (Surface Hub, Hololens etc.). [Auto-enrollment](https://docs.microsoft.com/windows/client-management/mdm/azure-ad-and-microsoft-intune-automatic-mdm-enrollment-in-the-new-portal) enables organizations to automatically enroll devices into their chosen mobility management application as part of [Azure AD join](https://docs.microsoft.com/azure/active-directory/devices/concept-azure-ad-join) or [Azure AD register](https://docs.microsoft.com/azure/active-directory/devices/concept-azure-ad-register) process on Windows 10 devices.
+In Azure AD, a mobility management policy represents an auto-enrollment configuration for a mobility management (MDM or MAM) application. These policies are only applicable to devices based on Windows 10 OS and its derivatives (Surface Hub, Hololens etc.). [Auto-enrollment](/windows/client-management/mdm/azure-ad-and-microsoft-intune-automatic-mdm-enrollment-in-the-new-portal) enables organizations to automatically enroll devices into their chosen mobility management application as part of [Azure AD join](/azure/active-directory/devices/concept-azure-ad-join) or [Azure AD register](/azure/active-directory/devices/concept-azure-ad-register) process on Windows 10 devices.
## Methods
In Azure AD, a mobility management policy represents an auto-enrollment configur
|discoveryUrl|String|Discovery URL of the mobility management application.| |displayName|String|Display name of the mobility management application.| |id|String|Object Id of the mobility management application.|
+|isValid|Boolean|Whether policy is valid. Invalid policies may not be updated and should be deleted.|
|termsOfUseUrl|String|Terms of Use URL of the mobility management application.| ## Relationships
The following is a JSON representation of the resource.
"description": "String", "discoveryUrl": "String", "displayName": "String",
+ "isValid": "Boolean",
"termsOfUseUrl": "String" } ```
v1.0 Orgcontact https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/orgcontact.md
This resource supports using [delta query](/graph/delta-query-overview) to track
## Properties
+> [!IMPORTANT]
+> Specific usage of `$filter` and the `$search` query parameter is supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+ | Property | Type | Description | | -- | - | -- | | addresses | [physicalOfficeAddress](physicalofficeaddress.md) collection | Postal addresses for this organizational contact. For now a contact can only have one physical address. |
v1.0 Serviceprincipal https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/serviceprincipal.md
This resource supports using [delta query](/graph/delta-query-overview) to track
## Properties
+> [!IMPORTANT]
+> Specific usage of `$filter` and the `$search` query parameter is supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+ | Property | Type |Description| |:|:--|:-| | accountEnabled |Boolean| `true` if the service principal account is enabled; otherwise, `false`. Supports `$filter` (`eq`, `ne`, `NOT`, `in`). |
v1.0 Synchronization Secretkeystringvaluepair https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/synchronization-secretkeystringvaluepair.md
Represents a single secret value.
## Properties | Property | Type |Description| |:|:--|:-|
-|key|String| Possible values are: `None`, `UserName`, `Password`, `SecretToken`, `AppKey`, `BaseAddress`, `ClientIdentifier`, `ClientSecret`, `SingleSignOnType`, `Sandbox`, `Url`, `Domain`, `ConsumerKey`, `ConsumerSecret`, `TokenKey`, `TokenExpiration`, `Oauth2AccessToken`, `Oauth2AccessTokenCreationTime`, `Oauth2RefreshToken`, `SyncAll`, `InstanceName`, `Oauth2ClientId`, `Oauth2ClientSecret`, `CompanyId`, `UpdateKeyOnSoftDelete`, `SynchronizationSchedule`, `SystemOfRecord`, `SandboxName`, `EnforceDomain`, `SyncNotificationSettings`, `Server`, `PerformInboundEntitlementGrants`, `HardDeletesEnabled`, `SyncAgentCompatibilityKey`, `SyncAgentADContainer`, `ValidateDomain`, `TestReferences`.|
+|key|synchronizationSecret| Possible values are: `None`, `UserName`, `Password`, `SecretToken`, `AppKey`, `BaseAddress`, `ClientIdentifier`, `ClientSecret`, `SingleSignOnType`, `Sandbox`, `Url`, `Domain`, `ConsumerKey`, `ConsumerSecret`, `TokenKey`, `TokenExpiration`, `Oauth2AccessToken`, `Oauth2AccessTokenCreationTime`, `Oauth2RefreshToken`, `SyncAll`, `InstanceName`, `Oauth2ClientId`, `Oauth2ClientSecret`, `CompanyId`, `UpdateKeyOnSoftDelete`, `SynchronizationSchedule`, `SystemOfRecord`, `SandboxName`, `EnforceDomain`, `SyncNotificationSettings`, `Server`, `PerformInboundEntitlementGrants`, `HardDeletesEnabled`, `SyncAgentCompatibilityKey`, `SyncAgentADContainer`, `ValidateDomain`, `Oauth2TokenExchangeUri`, `Oauth2AuthorizationUri`, `AuthenticationType`, `TestReferences`, `ConnectionString`.|
|value|String|The value of the secret.| ## JSON representation
v1.0 Tenantrelationship https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/tenantrelationship.md
+
+ Title: "tenantRelationship resource type"
+description: "Represent the various type of tenant relationships."
+
+localization_priority: Normal
++
+# tenantRelationship resource type
+
+Namespace: microsoft.graph
+
+Represent the various type of tenant relationships.
+
+## Methods
+
+None.
+
+## Properties
+
+None.
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|managedTenants|[microsoft.graph.managedTenants.managedTenant](../resources/managedtenants-managedtenant.md)|The operations available to interact with the multi-tenant management platform.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.tenantRelationship",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.tenantRelationship"
+}
+```
v1.0 Application List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/application-list.md
GET /applications
``` ## Optional query parameters
-This method supports the [OData query parameters](/graph/query-parameters) to help customize the response, including `$search`, `$count`, and `$filter`. You can use `$search` on the **displayName** and **description** properties. When items are added or updated for this resource, they are specially indexed for use with the `$count` and `$search` query parameters. There can be a slight delay between when an item is added or updated and when it is available in the index.
+This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
## Request headers | Name | Description | |:|:| | Authorization | Bearer {token}. Required. |
-| ConsistencyLevel | eventual. This header and `$count` are required when using `$search`, or when using `$filter` with the `$orderby` query parameter. It uses an index that may not be up to date with recent changes to the object. |
+| ConsistencyLevel | eventual. This header and `$count` are required when using `$search`, or in specific usage of `$filter`. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). |
## Request body Do not supply a request body for this method.
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$count` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- { "blockType": "ignored",
The following is an example of the response.
```http HTTP/1.1 200 OK Content-type: text/plain+
+893
```
-`893`
### Example 3: Use $filter and $top to get one application with a display name that starts with 'a' including a count of returned objects #### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string because the request has both the `$orderBy` and `$filter` query parameters. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_a_count" }--> ```msgraph-interactive
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` and the `$count=true` query string is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_web_count" }--> ```msgraph-interactive
v1.0 Call Answer https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/call-answer.md
In the request body, provide a JSON object with the following parameters.
| Parameter | Type |Description | |:--|:--|:-|
-|callbackUri |String |Allows bots to provide a specific callback URI for the current call to receive later notifications. If this property has not been set, the bot's global callback URI will be used instead. This must be `https`. |
+|callbackUri |String |Allows bots to provide a specific callback URI for the concurrent call to receive later notifications. If this property has not been set, the bot's global callback URI will be used instead. This must be `https`. |
|acceptedModalities|String collection |The list of accept modalities. Possible values are: `audio`, `video`, `videoBasedScreenSharing`. Required for answering a call. | |mediaConfig | [appHostedMediaConfig](../resources/apphostedmediaconfig.md) or [serviceHostedMediaConfig](../resources/servicehostedmediaconfig.md) |The media configuration. (Required) |
+| participantCapacity | Int | The number of participant that the application can handle for the call, for [Teams policy-based recording](/MicrosoftTeams/teams-recording-policy) scenario. |
## Response This method returns a `202 Accepted` response code.
Content-Length: 211
}, "acceptedModalities": [ "audio"
- ]
+ ],
+ "participantCapacity": 200
} ``` This blob is the serialized configuration for media sessions which is generated from the media SDK.
Content-Type: application/json
Under the [Policy-based recording scenario](/microsoftteams/teams-recording-policy), before a participant under policy joins a call, an incoming call notification will be sent to the bot associated with the policy. The join information can be found under the **botData** property. The bot can then choose to answer the call and [update the recording status](call-updaterecordingstatus.md) accordingly.
+When `participantCapacity` is specified in the `Answer` request for a policy-based recording notification, subsequent participant joining event belonging to the same policy group will be sent out as [participantJoiningNotification](../resources/participantJoiningNotification.md) instead of
+new incoming call notification, until number of participants that current call instance is handling has reached the number specified in `participantCapacity`.
+ Here is an example of the incoming call notification that a bot would recieve in this case. ```json
v1.0 Chat Post Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/chat-post-members.md
content-type: application/json
{ "@odata.type": "#microsoft.graph.aadUserConversationMember", "user@odata.bind": "https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5",
- "visibleHistoryStartDateTime": "2019-04-18T23:51:43.255Z"
+ "visibleHistoryStartDateTime": "2019-04-18T23:51:43.255Z",
+ "roles": ["owner"]
} ``` # [C#](#tab/csharp)
Content-type: application/json
{ "@odata.type": "#microsoft.graph.aadUserConversationMember",
- "user@odata.bind": "https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5"
+ "user@odata.bind": "https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "roles": ["owner"]
} ``` # [C#](#tab/csharp)
content-type: application/json
{ "@odata.type": "#microsoft.graph.aadUserConversationMember", "user@odata.bind": "https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5",
- "visibleHistoryStartDateTime": "0001-01-01T00:00:00Z"
+ "visibleHistoryStartDateTime": "0001-01-01T00:00:00Z",
+ "roles": ["owner"]
} ``` # [C#](#tab/csharp)
v1.0 Chatmessage Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/chatmessage-post.md
Content-type: application/json
} ```
+### Example 7 : @mention a channel in a channel message
+
+#### Request
+The following is an example of the request. For information about how to get a list of channels in a team, see [List channels](../api/channel-list.md).
+
+> Note: **conversationIdentityType** must be set to `channel` to @mention a channel.
+
+<!-- {
+ "blockType": "request",
+ "name": "post_chatmessage_atmentionchannel"
+}-->
+```http
+POST https://graph.microsoft.com/v1.0/teams/68a3e365-f7d9-4a56-b499-24332a9cc572/channels/19:0b50940236084d258c97b21bd01917b0@thread.skype/messages
+Content-type: application/json
+
+{
+ "body": {
+ "contentType": "html",
+ "content": "<div><div><at id=\"0\">General</at>&nbsp;Hello there!</div></div>"
+ },
+ "mentions": [
+ {
+ "id": 0,
+ "mentionText": "General",
+ "mentioned": {
+ "conversation": {
+ "id": "19:0b50940236084d258c97b21bd01917b0@thread.skype",
+ "displayName": "General",
+ "conversationIdentityType": "channel"
+ }
+ }
+ }
+ ]
+}
+```
+
+#### Response
+
+The following is an example of 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('68a3e365-f7d9-4a56-b499-24332a9cc572')/channels('19%3A0b50940236084d258c97b21bd01917b0%40thread.skype')/messages/$entity",
+ "id": "1625727486746",
+ "replyToId": null,
+ "etag": "1625727486746",
+ "messageType": "message",
+ "createdDateTime": "2021-07-08T06:58:06.746Z",
+ "lastModifiedDateTime": "2021-07-08T06:58:06.746Z",
+ "lastEditedDateTime": null,
+ "deletedDateTime": null,
+ "subject": null,
+ "summary": null,
+ "chatId": null,
+ "importance": "normal",
+ "locale": "en-us",
+ "webUrl": "https://teams.microsoft.com/l/message/19%3A0b50940236084d258c97b21bd01917b0%40thread.skype/1625727486746?groupId=68a3e365-f7d9-4a56-b499-24332a9cc572&tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34&createdTime=1625727486746&parentMessageId=1625727486746",
+ "policyViolation": null,
+ "eventDetail": null,
+ "from": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "8ea0e38b-efb3-4757-924a-5f94061cf8c2",
+ "displayName": "Robin Kline",
+ "userIdentityType": "aadUser"
+ }
+ },
+ "body": {
+ "contentType": "html",
+ "content": "<div><div><at id=\"0\">General</at>&nbsp;Hello there!</div></div>"
+ },
+ "channelIdentity": {
+ "teamId": "68a3e365-f7d9-4a56-b499-24332a9cc572",
+ "channelId": "19:0b50940236084d258c97b21bd01917b0@thread.skype"
+ },
+ "attachments": [],
+ "mentions": [
+ {
+ "id": 0,
+ "mentionText": "General",
+ "mentioned": {
+ "application": null,
+ "device": null,
+ "user": null,
+ "tag": null,
+ "conversation": {
+ "id": "19:0b50940236084d258c97b21bd01917b0@thread.skype",
+ "displayName": "General",
+ "conversationIdentityType": "channel"
+ }
+ }
+ }
+ ],
+ "reactions": []
+}
+```
+
+### Example 8 : @mention a team in a channel message
+
+#### Request
+The following is an example of the request.
+
+> Note: **conversationIdentityType** must be set to `team` to @mention a team.
+
+<!-- {
+ "blockType": "request",
+ "name": "post_chatmessage_atmentionteam"
+}-->
+```http
+POST https://graph.microsoft.com/v1.0/teams/68a3e365-f7d9-4a56-b499-24332a9cc572/channels/19:0b50940236084d258c97b21bd01917b0@thread.skype/messages
+Content-type: application/json
+
+{
+ "body": {
+ "contentType": "html",
+ "content": "<div><div><at id=\"0\">GraphTesting</at>&nbsp;Hello team</div></div>"
+ },
+ "mentions": [
+ {
+ "id": 0,
+ "mentionText": "GraphTesting",
+ "mentioned": {
+ "conversation": {
+ "id": "68a3e365-f7d9-4a56-b499-24332a9cc572",
+ "displayName": "GraphTesting",
+ "conversationIdentityType": "team"
+ }
+ }
+ }
+ ],
+ "reactions": []
+}
+```
+
+#### Response
+
+The following is an example of 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('68a3e365-f7d9-4a56-b499-24332a9cc572')/channels('19%3A0b50940236084d258c97b21bd01917b0%40thread.skype')/messages/$entity",
+ "id": "1625727671938",
+ "replyToId": null,
+ "etag": "1625727671938",
+ "messageType": "message",
+ "createdDateTime": "2021-07-08T07:01:11.938Z",
+ "lastModifiedDateTime": "2021-07-08T07:01:11.938Z",
+ "lastEditedDateTime": null,
+ "deletedDateTime": null,
+ "subject": null,
+ "summary": null,
+ "chatId": null,
+ "importance": "normal",
+ "locale": "en-us",
+ "webUrl": "https://teams.microsoft.com/l/message/19%3A0b50940236084d258c97b21bd01917b0%40thread.skype/1625727671938?groupId=68a3e365-f7d9-4a56-b499-24332a9cc572&tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34&createdTime=1625727671938&parentMessageId=1625727671938",
+ "policyViolation": null,
+ "eventDetail": null,
+ "from": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "8ea0e38b-efb3-4757-924a-5f94061cf8c2",
+ "displayName": "Robin Kline",
+ "userIdentityType": "aadUser"
+ }
+ },
+ "body": {
+ "contentType": "html",
+ "content": "<div><div><at id=\"0\">GraphTesting</at>&nbsp;Hello team</div></div>"
+ },
+ "channelIdentity": {
+ "teamId": "68a3e365-f7d9-4a56-b499-24332a9cc572",
+ "channelId": "19:0b50940236084d258c97b21bd01917b0@thread.skype"
+ },
+ "attachments": [],
+ "mentions": [
+ {
+ "id": 0,
+ "mentionText": "GraphTesting",
+ "mentioned": {
+ "application": null,
+ "device": null,
+ "user": null,
+ "tag": null,
+ "conversation": {
+ "id": "68a3e365-f7d9-4a56-b499-24332a9cc572",
+ "displayName": "GraphTesting",
+ "conversationIdentityType": "team"
+ }
+ }
+ }
+ ],
+ "reactions": []
+}
+```
+ ## See also - [Cards reference](/microsoftteams/platform/concepts/cards/cards-reference)
v1.0 Device List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/device-list.md
GET /devices
``` ## Optional query parameters
-This method supports the [OData query parameters](/graph/query-parameters) to help customize the response, including `$search`, `$count`, and `$filter`. You can use `$search` on the **displayName** and **description** properties. When items are added or updated for this resource, they are specially indexed for use with the `$count` and `$search` query parameters. There can be a slight delay between when an item is added or updated and when it is available in the index.
+This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
## Request headers | Name | Description| |:--|:| | Authorization | Bearer {token}. Required. |
-| ConsistencyLevel | eventual. This header and `$count` are required when using `$search`, or when using `$filter` with the `$orderby` query parameter. It uses an index that may not be up-to-date with recent changes to the object. |
+| ConsistencyLevel | eventual. This header and `$count` are required when using `$search`, or in specific usage of `$filter`. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). |
## Request body Do not supply a request body for this method.
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$count` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- { "blockType": "ignored",
The following is an example of the response.
```http HTTP/1.1 200 OK Content-type: text/plain+
+294
```
-`294`
### Example 3: Use $filter and $top to get one device with a display name that starts with 'a' including a count of returned objects #### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string because the request has both the `$orderBy` and `$filter` query parameters. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_a_count" }--> ```msgraph-interactive
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` and the `$count=true` query string is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_android_count" }--> ```msgraph-interactive
v1.0 Group List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-list.md
GET /groups
``` ## Optional query parameters
+This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+ To list only Microsoft 365 groups (aka unified groups), apply a filter on **groupTypes**: <!-- { "blockType": "ignored" } --> ```http GET https://graph.microsoft.com/v1.0/groups?$filter=groupTypes/any(c:c+eq+'Unified') ```
-You can use the OData query option `$orderby` to sort groups in an organization by the **displayName**
-values, as shown in the following example:
-<!-- { "blockType": "ignored" } -->
-```http
-GET https://graph.microsoft.com/v1.0/groups?$orderby=displayName
-```
-
-You can also use the `$count` and `$search` query parameters to limit the response. The `$search` query parameter supports tokenization only on the **displayName** and **description** fields. Other fields default to `$filter` behavior. When items are added or updated for this resource, they are specially indexed for use with the `$count` and `$search` query parameters. There can be a slight delay between when an item is added or updated and when it is available in the index.
+The `$search` query parameter supports tokenization only on the **displayName** and **description** fields and requires the **ConsistencyLevel** header. Fields other than **displayName** and **description** default to `$filter` `startswith` behavior.
-For more information on OData query options, see [OData query parameters](/graph/query-parameters).
+For more information on OData query options, see [OData query parameters](/graph/query-parameters). For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
## Request headers | Name | Description | |:- |:-- | | Authorization | Bearer {token}. Required. |
-| ConsistencyLevel | eventual. This header and `$count` are required when using `$search`, or when using `$filter` with the `$orderby` query parameter. It uses an index that may not be up-to-date with recent changes to the object. |
+| ConsistencyLevel | eventual. This header and `$count` are required when using `$search`, or in specific usage of `$filter`. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). |
## Request body Do not supply a request body for this method.
Content-type: application/json
### Example 2: Get a filtered list of groups including the count of returned objects
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$count` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
#### Request <!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_groups_withlicenseerrors_count" }--> ```msgraph-interactive
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$count` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- { "blockType": "ignored",
Content-type: text/plain
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string because the request has both the `$orderBy` and `$filter` query parameters. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_a_count" }--> ```msgraph-interactive
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_video_count" }--> ```msgraph-interactive
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- { "blockType": "request",
v1.0 Orgcontact List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/orgcontact-list.md
One of the following permissions is required to call this API. To learn more, in
GET /contacts ``` ## Optional query parameters
-This method supports the [OData query parameters](/graph/query-parameters) to help customize the response, including `$count`, `$expand`, `$filter`, `$search`,`$select`, and `$top`. You can use `$search` on the **displayName** property. When items are added or updated for this resource, they are specially indexed for use with the `$count` and `$search` query parameters. There can be a slight delay between when an item is added or updated and when it is available in the index.
+This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
## Request headers | Header | Value | |:--|:-| | Authorization |Bearer {token}. Required. |
-| ConsistencyLevel | eventual. This header and `$count` are required when using `$search`, or when using `$filter` with the `$orderby` query parameter. It uses an index that may not be up-to-date with recent changes to the object. |
+| ConsistencyLevel | eventual. This header and `$count` are required when using `$search`, or in specific usage of `$filter`. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). |
## Request body Do not supply a request body for this method.
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$count` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- { "blockType": "ignored",
The following is an example of the response.
```http HTTP/1.1 200 OK Content-type: text/plain+
+893
```
-`893`
### Example 3: Use $filter and $top to get one organizational contact with a display name that starts with 'a' including a count of returned objects #### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string because the request has both the `$orderBy` and `$filter` query parameters. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_a_count" }--> ```msgraph-interactive
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` and the `$count=true` query string is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_phone_count" }--> ```msgraph-interactive
v1.0 Serviceprincipal List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceprincipal-list.md
GET /servicePrincipals
``` ## Optional query parameters
-This method supports the [OData query parameters](/graph/query-parameters) to help customize the response, including `$search`, `$count`, and `$filter`. You can use `$search` on the **displayName** property. When items are added or updated for this resource, they are specially indexed for use with the `$count` and `$search` query parameters. There can be a slight delay between when an item is added or updated and when it is available in the index.
+This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
## Request headers | Name | Description |
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$count` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- { "blockType": "ignored",
Content-type: text/plain
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string because the request has both the `$orderBy` and `$filter` query parameters. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_a_count" }--> ```msgraph-interactive
Content-type: application/json
#### Request
-The following is an example of the request.
+The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` and the `$count=true` query string is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
<!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_team_count" }--> ```msgraph-interactive
v1.0 Acceptjoinresponse https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/acceptjoinresponse.md
+
+ Title: "acceptJoinResponse resource type"
+description: "Represents a response to accept a participant who tries to join the meeting."
+
+localization_priority: Normal
++
+# acceptJoinResponse resource type
+
+Namespace: microsoft.graph
+
+Represents a response to accept a participant who tries to join the meeting.
+
+## Properties
+
+None.
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [],
+ "@odata.type": "microsoft.graph.acceptJoinResponse"
+}-->
+```json
+{
+}
+```
+
+<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
+2015-10-25 14:57:30 UTC -->
+<!--
+{
+ "type": "#page.annotation",
+ "description": "acceptJoinResponse resource",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": []
+}
+-->
v1.0 Application https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/application.md
This resource supports using [delta query](/graph/delta-query-overview) to track
## Properties
+> [!IMPORTANT]
+> Specific usage of `$filter` and the `$search` query parameter is supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+ | Property | Type | Description | |:|:--|:-| | addIns | [addIn](addin.md) collection| Defines custom behavior that a consuming service can use to call an app in specific contexts. For example, applications that can render file streams [may set the addIns property](/onedrive/developer/file-handlers/?view=odsp-graph-online) for its "FileHandler" functionality. This will let services like Office 365 call the application in the context of a document the user is working on. |
v1.0 Device https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/device.md
This resource lets you add your own data to custom properties using [extensions]
|[Add schema extension values](/graph/extensibility-schema-groups) || Create a schema extension definition and then use it to add custom typed data to a resource.| ## Properties+
+> [!IMPORTANT]
+> Specific usage of `$filter` and the `$search` query parameter is supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+ | Property | Type |Description| |:|:--|:-| |accountEnabled|Boolean| `true` if the account is enabled; otherwise, `false`. Required. Default is `true`. Supports `$filter` (`eq`, `ne`, `NOT`, `in`).|
v1.0 Group https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/group.md
This resource supports:
| [resetUnseenCount](../api/group-resetunseencount.md) | None | Reset the unseenCount to 0 of all the posts that the signed-in user has not seen since their last visit. Supported for only Microsoft 365 groups. | ## Properties+
+> [!IMPORTANT]
+> Specific usage of `$filter` and the `$search` query parameter is supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+ | Property | Type |Description| |:|:--|:-| |allowExternalSenders|Boolean| Indicates if people external to the organization can send messages to the group. Default value is `false`. <br><br>Returned only on `$select`. Supported only on the Get group API (`GET /groups/{ID}`). |
v1.0 Invitenewbotresponse https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/invitenewbotresponse.md
+
+ Title: "inviteNewBotResponse resource type"
+description: "Contains a response to a request to have a participant joining notification sent out again as a incoming call notification to the desired location."
+
+localization_priority: Normal
++
+# inviteNewBotResponse resource type
+
+Namespace: microsoft.graph
+
+Contains a response to a request to have a participant joining notification sent out again as a incoming call notification to the desired location.
+
+## Properties
+
+| Property | Type | Description |
+| : | : | :-- |
+| inviteUri | String | URI to receive new incoming call notification. |
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [],
+ "@odata.type": "microsoft.graph.inviteNewBotResponse"
+}-->
+```json
+{
+ "inviteUri": "uri"
+}
+```
+
+<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
+2015-10-25 14:57:30 UTC -->
+<!--
+{
+ "type": "#page.annotation",
+ "description": "inviteNewBotResponse resource",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": []
+}
+-->
v1.0 Orgcontact https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/orgcontact.md
This resource supports using [delta query](/graph/delta-query-overview) to track
## Properties
+> [!IMPORTANT]
+> Specific usage of `$filter` and the `$search` query parameter is supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+ | Property | Type | Description | |:--|:-|:--| | addresses | [physicalOfficeAddress](physicalofficeaddress.md) collection | Postal addresses for this organizational contact. For now a contact can only have one physical address. |
v1.0 Participantjoiningnotification https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/participantjoiningnotification.md
+
+ Title: "participantJoiningNotification resource type"
+description: "Contains details about the policy-based participant joining a call."
+
+localization_priority: Normal
++
+# participantJoiningNotification resource type
+
+Namespace: microsoft.graph
+
+Contains details about the policy-based participant joining a call.
+
+Under the [Policy-based recording scenario](/microsoftteams/teams-recording-policy), before a participant under the policy joins a call, a `participantJoiningNotification` will be sent to the bot associated with the policy that has available capacity to handle the new participant.
+
+A [participantJoiningResponse](participantjoiningResponse.md) in the response payload is expected from the bot.
+
+## Properties
+| Property | Type | Description |
+| -- | -- | - |
+| call | [call](call.md) | The call object that contains details about the participant joining event. |
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [],
+ "@odata.type": "microsoft.graph.participantJoiningNotification"
+}-->
+```json
+{
+ "call": {"@odata.type": "#microsoft.graph.call"}
+}
+```
+
+<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
+2015-10-25 14:57:30 UTC -->
+<!--
+{
+ "type": "#page.annotation",
+ "description": "participantJoiningNotification resource",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": []
+}
+-->
v1.0 Participantjoiningresponse https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/participantjoiningresponse.md
+
+ Title: "participantJoiningResponse resource type"
+description: "An abstract base class that contains the response to a participant joining notification."
+
+localization_priority: Normal
++
+# participantJoiningResponse resource type
+
+Namespace: microsoft.graph
+
+An abstract base class that contains the response to a participant joining notification.
+
+## Derived types
+
+| Type | Description |
+| :-- | :-- |
+| [acceptJoinResponse](./acceptjoinresponse.md) | Response to accept participant to the call. |
+| [rejectJoinResponse](./rejectjoinresponse.md) | Response to reject participant to the call. |
+| [inviteNewBotResponse](./invitenewbotresponse.md) | Response to request participant joining notification sent out again as an incoming call notification. |
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [],
+ "abstract": true,
+ "@odata.type": "microsoft.graph.participantJoiningResponse"
+}-->
+```json
+{
+}
+```
+
+<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
+2015-10-25 14:57:30 UTC -->
+<!--
+{
+ "type": "#page.annotation",
+ "description": "participantJoiningResponse resource",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": []
+}
+-->
v1.0 Participantleftnotification https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/participantleftnotification.md
+
+ Title: "participantLeftNotification resource type"
+description: "Contains details about the policy-based participant who has left the call."
+
+localization_priority: Normal
++
+# participantLeftNotification resource type
+
+Namespace: microsoft.graph
+
+Contains details about the policy-based participant who has left the call.
+
+Under the [Policy-based recording](/microsoftteams/teams-recording-policy) scenario, when a participant who is managed by the bot call has left the meeting, a `participantLeftNotification` will be sent to the bot to notify the bot with details of the participant left event.
+
+## Properties
+| Property | Type | Description |
+| -- | -- | - |
+| call | [call](call.md) | The call object that contains details about the participant joining event. |
+| participantId | String | ID of the participant under the policy who has left the meeting. |
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [],
+ "@odata.type": "microsoft.graph.participantLeftNotification"
+}-->
+```json
+{
+ "participantId": "String",
+ "call": {"@odata.type": "#microsoft.graph.call"}
+}
+```
+
+<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
+2015-10-25 14:57:30 UTC -->
+<!--
+{
+ "type": "#page.annotation",
+ "description": "participantLeftNotification resource",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": []
+}
+-->
v1.0 Rejectjoinresponse https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/rejectjoinresponse.md
+
+ Title: "rejectJoinResponse resource type"
+description: "Contains a response to reject a participant who tries to join the meeting."
+
+localization_priority: Normal
++
+# rejectJoinResponse resource type
+
+Namespace: microsoft.graph
+
+Contains a response to reject a participant who tries to join the meeting.
+
+This has the same effect as rejecting a policy recording incoming call notification using the [reject-call](../api/call-reject.md) method. The bot will continue to receive a participant joining notification for a new user joining until its capacity has been reached.
+
+## Properties
+
+| Property | Type | Description |
+| : | : | :-- |
+| reason | String | The rejection reason. Possible values are `None`, `Busy`, and `Forbidden`. |
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [],
+ "@odata.type": "microsoft.graph.rejectJoinResponse"
+}-->
+```json
+{
+ "reason": "None | Busy | Forbidden"
+}
+```
+
+<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
+2015-10-25 14:57:30 UTC -->
+<!--
+{
+ "type": "#page.annotation",
+ "description": "rejectJoinResponse resource",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": []
+}
+-->
v1.0 Serviceprincipal https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/serviceprincipal.md
This resource supports using [delta query](/graph/delta-query-overview) to track
|[Remove tokenLifetimePolicy](../api/application-delete-tokenlifetimepolicies.md)| [tokenLifetimePolicy](tokenlifetimepolicy.md) collection| Remove a tokenLifetimePolicy from this object.| ## Properties+
+> [!IMPORTANT]
+> Specific usage of `$filter` and the `$search` query parameter is supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+ | Property | Type |Description| |:|:--|:-| | accountEnabled |Boolean| `true` if the service principal account is enabled; otherwise, `false`. Supports `$filter` (`eq`, `ne`, `NOT`, `in`).|
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/toc.yml a/api-reference/v1.0/toc.yml
items:
- name: Delete a history item href: api/projectrome-delete-historyitem.md - name: Devices and apps
- expanded: false
+ expanded: true
items: - name: Cloud printing items: