Updates from: 01/19/2022 06:49:24
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Administrativeunit Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/administrativeunit-get.md
One of the following permissions is required to call this API. To learn more, in
GET /administrativeUnits/{id} ``` ## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response.
## Request headers | Name |Description|
v1.0 Administrativeunit List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/administrativeunit-list.md
One of the following permissions is required to call this API. To learn more, in
GET /administrativeUnits ``` ## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+This method supports the `$count`, `$select`, `$search`, `$filter`, and `$expand` [OData query parameters](/graph/query-parameters) to help customize the response.
+ ## Request headers | Name |Description|
v1.0 Cloudpc Changeuseraccounttype https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/cloudpc-changeuseraccounttype.md
+
+ Title: "cloudPC: changeUserAccountType"
+description: "Change the account type of the user on a specific Cloud PC."
+
+ms.localizationpriority: medium
++
+# cloudPC: changeUserAccountType
+Namespace: microsoft.graph
++
+Change the account type of the user on a specific Cloud PC.
+
+## 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.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|CloudPC.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/changeUserAccountType
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a JSON representation of the parameters.
+
+The following table shows the parameters that can be used with this action.
+
+|Parameter|Type|Description|
+|:|:|:|
+|userAccountType|[cloudPcUserAccountType](../resources/cloudpcorganizationsettings.md#cloudpcuseraccounttype-values)|The account type of the user on provisioned Cloud PCs. Possible values are: `standardUser`, `administrator`, and `unknownFutureValue`.|
++
+## Response
+
+If successful, this action returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "cloudpc_changeuseraccounttype"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/4b5ad5e0-6a0b-4ffc-818d-36bb23cf4dbd/changeUserAccountType
+Content-Type: application/json
+Content-length: 35
+
+{
+ "userAccountType": "administrator"
+}
+```
++
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Cloudpc Reprovision https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/cloudpc-reprovision.md
POST /deviceManagement/virtualEndpoint/cloudPCs/{id}/reprovision
|Name|Description| |:|:| |Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
## Request body
-Do not supply a request body for this method.
+In the request body, supply a JSON representation of the parameters.
+
+The following table shows the parameters that can be used with this action.
+
+|Parameter|Type|Description|
+|:|:|:|
+|osVersion|[cloudPcOperatingSystem](../resources/cloudpcorganizationsettings.md#cloudpcoperatingsystem-values)|The version of the operating system (OS) to provision on Cloud PCs. Possible values are: `windows10`, `windows11`, and `unknownFutureValue`.|
+|userAccountType|[cloudPcUserAccountType](../resources/cloudpcorganizationsettings.md#cloudpcuseraccounttype-values)|The account type of the user on provisioned Cloud PCs. Possible values are: `standardUser`, `administrator`, and `unknownFutureValue`.|
## Response
If successful, this method returns a `204 No Content` response code.
### Request -
-# [HTTP](#tab/http)
<!-- { "blockType": "request",
- "name": "cloudpconpremisesconnection_runhealthcheck_1"
+ "name": "cloudpc_reprovision"
} --> ``` http
-POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/{id}/reprovision
-```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
-
-# [Go](#tab/go)
--
+POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/4b5ad5e0-6a0b-4ffc-818d-36bb23cf4dbd/reprovision
+Content-Type: application/json
+Content-length: 61
+{
+ "userAccountType": "administrator",
+ "osVersion": "windows10"
+}
+```
### Response
v1.0 Cloudpcorganizationsettings Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/cloudpcorganizationsettings-get.md
+
+ Title: "Get cloudPcOrganizationSettings"
+description: "Read the properties and relationships of a cloudPcOrganizationSettings object."
+
+ms.localizationpriority: medium
++
+# Get cloudPcOrganizationSettings
+Namespace: microsoft.graph
++
+Read the properties and relationships of the [cloudPcOrganizationSettings](../resources/cloudpcorganizationsettings.md) from the current tenant. A tenant has only one **cloudPcOrganizationSettings** 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|CloudPC.Read.All, CloudPC.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /deviceManagement/virtualEndpoint/cloudPcOrganizationSettings
+```
+
+## Optional query parameters
+This method supports the `$select` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [cloudPcOrganizationSettings](../resources/cloudpcorganizationsettings.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_cloudpcorganizationsettings"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPcOrganizationSettings
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.cloudPcOrganizationSettings"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.cloudPcOrganizationSettings",
+ "id": "8660bf17-bf17-8660-17bf-608617bfffff",
+ "userAccountType": "standardUser",
+ "osVersion": "windows11"
+ }
+}
+```
v1.0 Cloudpcorganizationsettings Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/cloudpcorganizationsettings-update.md
+
+ Title: "Update cloudPcOrganizationSettings"
+description: "Update the properties of a cloudPcOrganizationSettings object."
+
+ms.localizationpriority: medium
++
+# Update cloudPcOrganizationSettings
+Namespace: microsoft.graph
++
+Update the properties of the [cloudPcOrganizationSettings](../resources/cloudpcorganizationsettings.md) object in a tenant.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|CloudPC.Read.All, CloudPC.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|CloudPC.Read.All, CloudPC.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /deviceManagement/virtualEndpoint/cloudPcOrganizationSettings
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
++
+|Property|Type|Description|
+|:|:|:|
+|osVersion|cloudPcOperatingSystem|The version of the operating system (OS) to provision on Cloud PCs. The possible values are: `windows10`, `windows11`, `unknownFutureValue`. Optional.|
+|userAccountType|cloudPcUserAccountType|The account type of the user on provisioned Cloud PCs. The possible values are: `standardUser`, `administrator`, `unknownFutureValue`. Optional.|
++
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "update_cloudpcorganizationsettings"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/organizationSettings
+Content-Type: application/json
+Content-length: 127
+
+{
+ "@odata.type": "#microsoft.graph.cloudPcOrganizationSettings",
+ "userAccountType": "standardUser",
+ "osVersion": "windows11"
+}
+```
++
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Directoryrole Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryrole-get.md
GET /directoryRoles/{role-id}
GET /directoryRoles/roleTemplateId={roleTemplateId} ``` ## Optional query parameters
-This method does **not** support any [OData query parameters](/graph/query-parameters) to help customize the response (for example, `$filter` is not supported here).
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response.
## Request headers | Name | Description|
v1.0 Directoryrole List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryrole-list.md
One of the following permissions is required to call this API. To learn more, in
GET /directoryRoles ``` ## Optional query parameters
-This method does **not** support the [OData Query Parameters](/graph/query-parameters) to help customize the response (e.g. $filter is not supported here).
+This method supports the `$count`, `$select`, `$search`, `$filter` (`eq`), and `$expand` [OData query parameters](/graph/query-parameters) to help customize the response.
## Request headers | Name | Description|
v1.0 Serviceannouncement List Healthoverviews https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceannouncement-list-healthoverviews.md
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and a collection of [serviceHealth](../resources/servicehealth.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [serviceHealth](../resources/servicehealth.md) objects in the response body. The response is paginated and each page contains 100 objects.
## Examples
v1.0 Serviceannouncement List Issues https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceannouncement-list-issues.md
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and a collection of [serviceHealthIssue](../resources/servicehealthissue.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [serviceHealthIssue](../resources/servicehealthissue.md) objects in the response body. The response is paginated and each page contains 100 objects.
## Example
Content-Type: application/json
{ "@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/serviceAnnouncement/issues",
+ "@odata.nextLink": "https://graph.microsoft.com/beta/admin/serviceAnnouncement/issues?$skip=100",
"value": [ { "startDateTime": "2020-11-13T21:00:00Z",
v1.0 Serviceannouncement List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceannouncement-list-messages.md
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and a collection of [serviceUpdateMessage](../resources/serviceupdatemessage.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [serviceUpdateMessage](../resources/serviceupdatemessage.md) objects in the response body. The response is paginated and each page contains 100 objects.
## Example
Content-Type: application/json
{ "@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/serviceAnnouncement/messages",
+ "@odata.nextLink": "https://graph.microsoft.com/beta/admin/serviceAnnouncement/messages?$skip=100",
"value": [ { "startDateTime": "2019-02-01T18:51:00Z",
v1.0 Serviceannouncementattachment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceannouncementattachment-get.md
+
+ Title: "Get serviceAnnouncementAttachment"
+description: "Read the properties and relationships of a serviceAnnouncementAttachment object."
+
+ms.localizationpriority: medium
++
+# Get serviceAnnouncementAttachment
+Namespace: microsoft.graph
++
+Read the properties and relationships of a [serviceAnnouncementAttachment](../resources/serviceannouncementattachment.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)|ServiceMessage.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|ServiceMessage.Read.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/serviceAnnouncement/messages/{serviceUpdateMessageId}/attachments/{serviceAnnouncementAttachmentId}
+```
+
+## Optional query parameters
+This method supports the [OData query parameters](/graph/query-parameters) to help customize the response.
+
+## 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 [serviceAnnouncementAttachment](../resources/serviceannouncementattachment.md) object in the response body.
+
+## Examples
+
+### Example 1: Get an attachment with message ID
+
+The following request returns a [serviceAnnouncementAttachment](../resources/serviceannouncementattachment.md) resource.
+
+#### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_serviceannouncementattachment"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/admin/serviceAnnouncement/messages/MC54091/attachments/30356a46-ffad-47e1-acf6-40a99b1538c1
+```
+
+#### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.serviceAnnouncementAttachment"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "@odata.context": "https://graph.microsoft-ppe.com/beta/$metadata#admin/serviceAnnouncement/messages('MC54091')/attachments/$entity",
+ "contentType": "application/csv",
+ "isInline": false,
+ "lastModifiedDateTime": "2021-09-21T04:07:15.9720778Z",
+ "name": "An attachment for a Data Privacy message regarding your organization is available within Message Center. The contents of this attachment can be accessed within Message Center by a Global Administrator or someone designated as a Message Center Privacy Reader. Please sign in to Admin Center to view the details of this message in the Microsoft 365 Message center.",
+ "size": 44583,
+ "id": "30356a46-ffad-47e1-acf6-40a99b1538c1"
+ }
+}
+```
+
+### Example 2: Return a file stream of an attachment content for a message
+
+#### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_serviceannouncementattachment"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/admin/serviceAnnouncement/messages/MC54091/attachments/30356a46-ffad-47e1-acf6-40a99b1538c1/content
+```
+
+#### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.serviceAnnouncementAttachment"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": "An attachment for a Data Privacy message regarding your organization is available within Message Center. The contents of this attachment can be accessed within Message Center by a Global Administrator or someone designated as a Message Center Privacy Reader. Please sign in to Admin Center to view the details of this message in the Microsoft 365 Message center."
+}
+```
v1.0 Servicehealthissue Incidentreport https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/servicehealthissue-incidentreport.md
Namespace: microsoft.graph
Provide the Post-Incident Review (PIR) document of a specified service issue for tenant.
-The operation returns an error if the specified issue doesn't exist for the tenant.
+An issue only with status of `PostIncidentReviewPublished` indicates that the PIR document exists for the issue. The operation returns an error if the specified issue doesn't exist for the tenant or if PIR document does not exist for the issue.
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Serviceupdatemessage List Attachments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceupdatemessage-list-attachments.md
+
+ Title: "List attachments"
+description: "Get the list of attachments associated with a service message."
+
+ms.localizationpriority: medium
++
+# List attachments
+Namespace: microsoft.graph
++
+Get a list of attachments associated with a service message.
+
+## 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)|ServiceMessage.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|ServiceMessage.Read.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/serviceAnnouncement/messages/{serviceUpdateMessageId}/attachments
+```
+
+## Optional query parameters
+This method supports the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [serviceAnnouncementAttachment](../resources/serviceannouncementattachment.md) objects in the response body.
+
+## Examples
+
+### Example 1: Get all attachments of a message in a collection
+
+#### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_serviceannouncementattachment"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/admin/serviceAnnouncement/messages/MC54091/attachments
+```
+
+#### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.serviceAnnouncementAttachment)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft-ppe.com/beta/$metadata#admin/serviceAnnouncement/messages('MC54091')/attachments",
+ "value": [
+ {
+ "contentType": "application/csv",
+ "isInline": false,
+ "lastModifiedDateTime": "2021-09-21T04:07:15.9720778Z",
+ "name": "An attachment for a Data Privacy message regarding your organization is available within Message Center. The contents of this attachment can be accessed within Message Center by a Global Administrator or someone designated as a Message Center Privacy Reader. Please sign in to Admin Center to view the details of this message in the Microsoft 365 Message center.",
+ "size": 44583,
+ "id": "30356a46-ffad-47e1-acf6-40a99b1538c1"
+ },
+ {
+ "contentType": "application/csv",
+ "isInline": false,
+ "lastModifiedDateTime": "2021-09-21T04:07:15.9720778Z",
+ "name": "An attachment for a Data Privacy message regarding your organization is available within Message Center. The contents of this attachment can be accessed within Message Center by a Global Administrator or someone designated as a Message Center Privacy Reader. Please sign in to Admin Center to view the details of this message in the Microsoft 365 Message center.",
+ "size": 288849,
+ "id": "fdd33417-37b9-49cc-95c1-7af90f2366c8"
+ }
+ ]
+}
+```
+
+### Example 2: Get a zip file of all attachments in stream for a message
+
+#### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_serviceannouncementattachment"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/admin/serviceAnnouncement/messages/MC54091/attachmentsArchive
+```
+
+#### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Edm.Stream"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft-ppe.com/beta/$metadata#admin/serviceAnnouncement/messages('MC54091')/attachmentsArchive",
+ "value": "Stream"
+}
+```
v1.0 Administrativeunit https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/administrativeunit.md
This topic provides descriptions of the declared properties and navigation prope
|**Schema 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.|
+> [!NOTE]
+> The URL endpoint for calling the **administrativeUnits** API is `/administrativeUnits` in the `beta` endpoint but `/directory/administrativeUnits` in the `v1.0` endpoint.
+ ## Properties > [!IMPORTANT]
This topic provides descriptions of the declared properties and navigation prope
| Property | Type |Description| |:|:--|:-|
-|description|string|An optional description for the administrative unit. Supports `$filter` (`eq`, `ne`, `in`, `startsWith`).|
+|description|string|An optional description for the administrative unit. Supports `$filter` (`eq`, `ne`, `in`, `startsWith`), `$search`.|
|displayName|string|Display name for the administrative unit. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values), `$search`, and `$orderBy`.| |id|string|Unique identifier for the administrative unit. Read-only. Supports `$filter` (`eq`).| |visibility|string|Controls whether the administrative unit and its members are hidden or public. Can be set to `HiddenMembership` or `Public`. If not set, default behavior is `Public`. When set to `HiddenMembership`, only members of the administrative unit can list other members of the administrative unit.|
This topic provides descriptions of the declared properties and navigation prope
| Relationship | Type |Description| |:|:--|:-| |extensions|[extension](extension.md) collection|The collection of open extensions defined for this administrative unit. Nullable.|
-|members|[directoryObject](directoryobject.md) collection|Users and groups that are members of this administrative unit. HTTP Methods: GET (list members), POST (add members), DELETE (remove members).|
-|scopedRoleMembers|[scopedRoleMembership](scopedrolemembership.md) collection| Scoped-role members of this administrative unit. HTTP Methods: GET (list scopedRoleMemberships), POST (add scopedRoleMembership), DELETE (remove scopedRoleMembership). |
+|members|[directoryObject](directoryobject.md) collection|Users and groups that are members of this administrative unit. Supports `$expand`.|
+|scopedRoleMembers|[scopedRoleMembership](scopedrolemembership.md) collection| Scoped-role members of this administrative unit.|
## JSON representation
v1.0 Cloudpc https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/cloudpc.md
Represents a cloud-managed virtual desktop. This Cloud PC is also enrolled into
|:|:|:| |[List cloudPCs](../api/virtualendpoint-list-cloudpcs.md)|[cloudPC](../resources/cloudpc.md) collection|List properties and relationships of the [cloudPC](../resources/cloudpc.md) objects.| |[Get cloudPC](../api/cloudpc-get.md)|[cloudPC](../resources/cloudpc.md)|Read the properties and relationships of a [cloudPC](../resources/cloudpc.md) object.|
-|[Reprovision](../api/cloudpc-reprovision.md)|None|Reprovision a [cloudPC](../resources/cloudpc.md) object.|
+|[Change user account type](../api/cloudpc-changeuseraccounttype.md)|None|Change the account type of the user on a specific Cloud PC.|
|[End grace period](../api/cloudpc-endgraceperiod.md)|None|End the grace period for a [cloudPC](../resources/cloudpc.md) object.|
+|[Get remote action results](../api/manageddevice-getcloudpcremoteactionresults.md)|[cloudPcRemoteActionResult](../resources/cloudpcremoteactionresult.md)|Check the [Cloud PC-specified remote action results](../resources/cloudpcremoteactionresult.md) for a Cloud PC device.|
|[Reboot](../api/cloudpc-reboot.md)|None|Reboot a specific [cloudPC](../resources/cloudpc.md) object.| |[Rename](../api/cloudpc-rename.md)|None|Rename a specific [cloudPC](../resources/cloudpc.md) object. Use this API to update the **displayName** for the Cloud PC entity.|
-|[Troubleshoot](../api/cloudpc-troubleshoot.md)|None|Troubleshoot a specific [cloudPC](../resources/cloudpc.md) object. Use this API to check the health status of the Cloud PC and the session host.|
-|[Reprovision remote action](../api/manageddevice-reprovisioncloudpc.md)|None|Reprovision a Cloud PC with an Intune [managed device](../resources/cloudpc.md) ID.|
+|[Reprovision](../api/cloudpc-reprovision.md)|None|Reprovision a [cloudPC](../resources/cloudpc.md) object.|
+|[Reprovision remote action](../api/manageddevice-reprovisioncloudpc.md)|None|Reprovision a Cloud PC with an Intune [managed device](../resources/cloudpc.md) ID.|
|[Bulk reprovision remote action](../api/manageddevice-bulkreprovisioncloudpc.md)|None|Bulk reprovision a set of Cloud PC devices with Intune managed device IDs.| |[Resize remote action](../api/manageddevice-resizecloudpc.md)|None|Upgrade or downgrade an existing Cloud PC to another configuration with new vCPU and storage size through Intune managed device ID.|
-|[Get remote action results](../api/manageddevice-getcloudpcremoteactionresults.md)|[cloudPcRemoteActionResult](../resources/cloudpcremoteactionresult.md)|Check the [Cloud PC-specified remote action results](../resources/cloudpcremoteactionresult.md) for a Cloud PC device.|
+|[Troubleshoot](../api/cloudpc-troubleshoot.md)|None|Troubleshoot a specific [cloudPC](../resources/cloudpc.md) object. Use this API to check the health status of the Cloud PC and the session host.|
## Properties
Represents a cloud-managed virtual desktop. This Cloud PC is also enrolled into
|managedDeviceId|String|The Intune device ID of the Cloud PC.| |managedDeviceName|String|The Intune device name of the Cloud PC.| |onPremisesConnectionName|String|The on-premises connection that is applied during the provisioning of Cloud PCs.|
+|osVersion|[cloudPcOperatingSystem](../resources/cloudpcorganizationsettings.md#cloudpcoperatingsystem-values)|The version of the operating system (OS) to provision on Cloud PCs. Possible values are: `windows10`, `windows11`, and `unknownFutureValue`.|
|provisioningPolicyId|String|The provisioning policy ID of the Cloud PC.| |provisioningPolicyName|String|The provisioning policy that is applied during the provisioning of Cloud PCs.| |servicePlanId|String|The service plan ID of the Cloud PC.|
Represents a cloud-managed virtual desktop. This Cloud PC is also enrolled into
|servicePlanType|[cloudPcServicePlanType](../resources/cloudpcserviceplan.md#cloudpcserviceplantype-values)|The service plan type of the Cloud PC.| |status|[cloudPcStatus](#cloudpcstatus-values)|The status of the Cloud PC. Possible values are: `notProvisioned`, `provisioning`, `provisioned`, `upgrading`, `inGracePeriod`, `deprovisioning`, `failed`.| |statusDetails|[cloudPcStatusDetails](../resources/cloudpcstatusdetails.md)|The details of the Cloud PC status.|
+|userAccountType|[cloudPcUserAccountType](../resources/cloudpcorganizationsettings.md#cloudpcuseraccounttype-values)|The account type of the user on provisioned Cloud PCs. Possible values are: `standardUser`, `administrator`, and `unknownFutureValue`.|
|userPrincipalName|String|The user principal name (UPN) of the user assigned to the Cloud PC.| ### cloudPcStatus values
Represents a cloud-managed virtual desktop. This Cloud PC is also enrolled into
|failed|The operation on Cloud PC has failed.| |provisionedWithWarnings|The Cloud PC is provisioned and can be accessed by end users but with some warnings. The user can continue to use this Cloud PC.| |resizing|The Cloud PC is resizing.|
+|pendingProvision|The provisioning is pending on the Cloud PC. In this case, the number of Cloud PCs in grace period is more than the number of total available licenses. |
|unknownFutureValue|Evolvable enumeration sentinel value. Do not use.| ## Relationships
The following is a JSON representation of the resource.
"userPrincipalName": "String", "lastModifiedDateTime": "String (timestamp)", "gracePeriodEndDateTime": "String (timestamp)",
+ "userAccountType": "String",
+ "osVersion": "String",
"lastRemoteActionResult": "String", "lastLoginResult": "String" }
v1.0 Cloudpconpremisesconnectionhealthcheck https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/cloudpconpremisesconnectionhealthcheck.md
The result of a cloud PC on-premises connection health check.
|Member|Description| |:|:| |dnsCheckFqdnNotFound|The DNS resolution failed for the domain name. Possible error causes: 1. The specified Azure vNet's DNS server can't resolve the domain name. Please update the vNet with an appropriate DNS server; 2. The domain name provided doesn't exist or isn't correct. Please update the on-premises network connection with the correct domain name. Please make sure that the vNet defined in the on-premises network connection can resolve the domain name.|
+|dnsCheckNameWithInvalidCharacter|The DNS check failed because the domain name entered contains an unsupported character. Please make sure the domain name only contains supported characters.|
|dnsCheckUnknownError|The DNS resolution failed for the domain name. Possible error causes: 1. The specified Azure vNet's DNS server can't resolve the domain name. Please update the vNet with an appropriate DNS server; 2. The domain name provided doesn't exist or isn't correct. Please update the on-premises network connection with the correct domain name. Please make sure that the vNet defined in the on-premises network connection can resolve the domain name.| |adJoinCheckFqdnNotFound|The domain join check failed because the domain name couldn't be found. Please make sure a domain controller for the domain name can be contacted by the vNet defined in the on-premises network connection.| |adJoinCheckIncorrectCredentials|The domain join check failed because the credentials provided for the domain aren't correct. Please update the on-premises network connection with correct credentials.|
The result of a cloud PC on-premises connection health check.
|azureAdDeviceSyncCheckLongSyncCircle|The check whether the cloud PC computer object has been synced to Azure Active Directory (Azure AD) has timed out. Please make sure that Azure AD connect works and syncs frequently so that the cloud PC computer objects are synced to Azure AD. Azure AD device sync must be enabled and synced within the last 60 minutes.| |azureAdDeviceSyncCheckConnectDisabled|The Azure Active Directory (Azure AD) device sync check failed because the Azure AD Connect is disabled. Please make sure the Azure AD Connect is enabled and it syncs frequently. If the Azure AD Connect doesn't sync the computer within 60 minutes, then the check will fail.| |azureAdDeviceSyncCheckDurationExceeded|The Azure Active Directory (Azure AD) device sync check failed because the Azure AD Connect sync didn't sync within 60 minutes. Please make sure the Azure AD Connect is enabled and it syncs frequently. If the Azure AD Connect doesn't sync the computer within 60 minutes, then the check will fail.|
+|azureAdDeviceSyncCheckScpNotConfigured|The Hybrid Azure Active Directory (Azure AD) join failed due to misconfiguration in the Service Configuration Point (SCP). Please make sure your SCP configuration is valid and available to perform a Hybrid Azure AD join. Your SCP can be created and configured in the Azure AD Connect wizard.|
|azureAdDeviceSyncCheckTransientServiceError|The Azure Active Directory (Azure AD) device sync check failed due to a transient error. Please try it again. If the issue persists, please contact customer support.| |azureAdDeviceSyncCheckUnknownError|Hybrid Azure Active Directory (Azure AD) connectivity check failed. Please make sure that Azure AD connect works and syncs frequently so that the cloud PC computer objects are synced to Azure AD. Azure AD device sync must be enabled and synced within the last 60 minutes.| |resourceAvailabilityCheckNoSubnetIP|The subnet provided doesn't have IP addresses available. Please make sure that the subnet provided in the on-premises network connection has sufficient IP addresses available. Please expand the current selected subnet or select a different subnet to be used for provisioning.|
v1.0 Cloudpcorganizationsettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/cloudpcorganizationsettings.md
+
+ Title: "cloudPcOrganizationSettings resource type"
+description: "Represents the Cloud PC organization settings for a tenant."
+
+ms.localizationpriority: medium
++
+# cloudPcOrganizationSettings resource type
+
+Namespace: microsoft.graph
++
+Represents the Cloud PC organization settings for a tenant. A tenant has only one **cloudPcOrganizationSettings** object.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[Get cloudPcOrganizationSettings](../api/cloudpcorganizationsettings-get.md)|[cloudPcOrganizationSettings](../resources/cloudpcorganizationsettings.md)|Read the properties and relationships of a [cloudPcOrganizationSettings](../resources/cloudpcorganizationsettings.md) object.|
+|[Update cloudPcOrganizationSettings](../api/cloudpcorganizationsettings-update.md)|[cloudPcOrganizationSettings](../resources/cloudpcorganizationsettings.md)|Update the properties of a [cloudPcOrganizationSettings](../resources/cloudpcorganizationsettings.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|The ID of the organization settings.|
+|osVersion|[cloudPcOperatingSystem](#cloudpcoperatingsystem-values)|The account type of the user on provisioned Cloud PCs. The possible values are: `windows10`, `windows11`, `unknownFutureValue`.|
+|userAccountType|[cloudPcUserAccountType](#cloudpcuseraccounttype-values)|The version of the operating system (OS) to provision on Cloud PCs. The possible values are: `standardUser`, `administrator`, `unknownFutureValue`.|
+
+### cloudPcOperatingSystem values
+
+|Member|Description|
+|:|:|
+|windows10|The Windows 10 operating system.|
+|windows11|The Windows 11 operating system.|
+|unknownFutureValue|Evolvable enumeration sentinel value. Do not use.|
+
+### cloudPcUserAccountType values
+
+|Member|Description|
+|:|:|
+|standardUser|A user without local administrative permissions on the Cloud PC. Standard users can only install content from the Microsoft Store app but they cannot modify Windows settings that require local administrative privileges.|
+|administrator|A user with full local administrative permissions on the Cloud PC. Administrators can install any software and modify any file or setting on the Cloud PC.|
+|unknownFutureValue|Evolvable enumeration sentinel value. Do not use.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.cloudPcOrganizationSettings",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.cloudPcOrganizationSettings",
+ "id": "String (identifier)",
+ "osVersion": "String",
+ "userAccountType": "String"
+}
+```
v1.0 Directoryrole https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/directoryrole.md
This resource supports:
## Properties | Property | Type |Description| |:|:--|:-|
-|description|String|The description for the directory role. Read-only. |
-|displayName|String|The display name for the directory role. Read-only. |
-|id|String|The unique identifier for the directory role. Inherited from [directoryObject](directoryobject.md). Key, Not nullable, Read-only.|
-|roleTemplateId|String| The **id** of the [directoryRoleTemplate](directoryroletemplate.md) that this role is based on. The property must be specified when activating a directory role in a tenant with a POST operation. After the directory role has been activated, the property is read only. |
+|description|String|The description for the directory role. Read-only. Supports `$filter` (`eq`), `$search`, `$select`.|
+|displayName|String|The display name for the directory role. Read-only. Supports `$filter` (`eq`), `$search`, `$select`. |
+|id|String|The unique identifier for the directory role. Inherited from [directoryObject](directoryobject.md). Key, Not nullable, Read-only. Supports `$filter` (`eq`), `$select`.|
+|roleTemplateId|String| The **id** of the [directoryRoleTemplate](directoryroletemplate.md) that this role is based on. The property must be specified when activating a directory role in a tenant with a POST operation. After the directory role has been activated, the property is read only. Supports `$filter` (`eq`), `$select`. |
## Relationships | Relationship | Type |Description| |:|:--|:-|
-|members|[directoryObject](directoryobject.md) collection|Users that are members of this directory role. HTTP Methods: GET, POST, DELETE. Read-only. Nullable.|
+|members|[directoryObject](directoryobject.md) collection|Users that are members of this directory role. HTTP Methods: GET, POST, DELETE. Read-only. Nullable. Supports `$expand`.|
|scopedMembers|[scopedRoleMembership](scopedrolemembership.md) collection| Members of this directory role that are scoped to [administrative units](administrativeunit.md). Read-only. Nullable.| ## JSON representation
v1.0 Report https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/report.md
The following table shows the availability for each API across all cloud deploym
| [Microsoft 365 groups activity](/graph/api/resources/office-365-groups-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | | [Microsoft Teams device usage](/graph/api/resources/microsoft-teams-device-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ₧û | Γ₧û | | [Microsoft Teams user activity](/graph/api/resources/microsoft-teams-user-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ₧û | Γ₧û |
-| [Outlook activity](/graph/api/resources/email-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
-| [Outlook app usage](/graph/api/resources/email-app-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
-| [Outlook mailbox usage](/graph/api/resources/mailbox-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
-| [OneDrive activity](/graph/api/resources/onedrive-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
-| [OneDrive usage](/graph/api/resources/onedrive-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
-| [SharePoint activity](/graph/api/resources/sharepoint-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
-| [SharePoint site usage](/graph/api/resources/sharepoint-site-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
+| [Outlook activity](/graph/api/resources/email-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û |
+| [Outlook app usage](/graph/api/resources/email-app-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û |
+| [Outlook mailbox usage](/graph/api/resources/mailbox-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û |
+| [OneDrive activity](/graph/api/resources/onedrive-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û |
+| [OneDrive usage](/graph/api/resources/onedrive-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û |
+| [SharePoint activity](/graph/api/resources/sharepoint-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û |
+| [SharePoint site usage](/graph/api/resources/sharepoint-site-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û |
| [Skype for Business activity](/graph/api/resources/skype-for-business-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | | [Skype for Business device usage](/graph/api/resources/skype-for-business-device-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | | [Skype for Business organizer activity](/graph/api/resources/skype-for-business-organizer-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
v1.0 Service Communications Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/service-communications-api-overview.md
That service communications API is available in all Microsoft national cloud dep
|Microsoft Graph Germany|https://graph.microsoft.de/beta/admin/serviceAnnouncement/| |Microsoft Graph China operated by 21Vianet|https://microsoftgraph.chinacloudapi.cn/beta/admin/serviceAnnouncement/|
+## Service communications limits
+
+To guarantee the service performance, the service communications API has throttling limits for the requests per tenant per application. For details about the limits, see [throttling limits for the service communications service](/graph/throttling#service-communications-service-limits).
++ ## What's new Find out about the [latest new features and updates](/graph/whats-new-overview) for this API set.
v1.0 Serviceannouncementattachment https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/serviceannouncementattachment.md
+
+ Title: "serviceAnnouncementAttachment resource type"
+description: "Represents an attachment associated with a serviceUpdateMessage object."
+
+ms.localizationpriority: medium
++
+# serviceAnnouncementAttachment resource type
+
+Namespace: microsoft.graph
++
+Represents an attachment associated with a [serviceUpdateMessage](../resources/serviceupdatemessage.md) object.
+
+Inherits from [attachment](../resources/attachment.md).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[Get serviceAnnouncementAttachment](../api/serviceannouncementattachment-get.md)|[serviceAnnouncementAttachment](../resources/serviceannouncementattachment.md)|Read the properties and relationships of a [serviceAnnouncementAttachment](../resources/serviceannouncementattachment.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|content|Stream|The attachment content.|
+|contentType|String|The content type of the attachment.|
+|id|String|The attachment ID. Inherited from [entity](../resources/entity.md).|
+|lastModifiedDateTime|DateTimeOffset|The date and time when the attachment was last modified.|
+|name|String|The attachment name.|
+|size|Int32|The size in bytes of the attachment.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.serviceAnnouncementAttachment",
+ "baseType": "microsoft.graph.attachment",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.serviceAnnouncementAttachment",
+ "id": "String (identifier)",
+ "lastModifiedDateTime": "String (timestamp)",
+ "name": "String",
+ "contentType": "String",
+ "size": "Integer",
+ "isInline": "Boolean",
+ "content": "Stream"
+}
+```
v1.0 Servicehealth https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/servicehealth.md
Represents the health information of a service subscribed by a tenant.
## Properties |Property|Type|Description| |:|:|:|
-|id|String|The service id.|
+|id|String|The service ID.|
|service|String|The service name. Use the [list healthOverviews](../api/serviceannouncement-list-healthoverviews.md) operation to get exact string names for services subscribed by the tenant.|
-|status|serviceHealthStatus|Show the overral service health status. Possible values are: `serviceOperational`, `investigating`, `restoringService`, `verifyingService`, `serviceRestored`, `postIncidentReviewPublished`, `serviceDegradation`, `serviceInterruption`, `extendedRecovery`, `falsePositive`, `investigationSuspended`, `resolved`, `mitigatedExternal`, `mitigated`, `resolvedExternal`, `confirmed`, `reported`, `unknownFutureValue`.|
+|status|serviceHealthStatus|Show the overall service health status. Possible values are: `serviceOperational`, `investigating`, `restoringService`, `verifyingService`, `serviceRestored`, `postIncidentReviewPublished`, `serviceDegradation`, `serviceInterruption`, `extendedRecovery`, `falsePositive`, `investigationSuspended`, `resolved`, `mitigatedExternal`, `mitigated`, `resolvedExternal`, `confirmed`, `reported`, `unknownFutureValue`. For more details, see [serviceHealthStatus values](../resources/servicehealthissue.md#servicehealthstatus-values).|
## Relationships |Relationship|Type|Description| |:|:|:|
-|issues|Collection([serviceHealthIssue](../resources/servicehealthissue.md))|A collection of issues happened on the service, with detailed information for each issue.|
+|issues|Collection([serviceHealthIssue](../resources/servicehealthissue.md))|A collection of issues that happened on the service, with detailed information for each issue.|
## JSON representation The following is a JSON representation of the resource.
v1.0 Servicehealthissue https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/servicehealthissue.md
Inherits from [serviceAnnouncementBase](../resources/serviceannouncementbase.md)
|Method|Return type|Description| |:|:|:| |[Get serviceHealthIssue](../api/servicehealthissue-get.md)|[serviceHealthIssue](../resources/servicehealthissue.md)|Retrieve the properties and relationships of a [serviceHealthIssue](../resources/servicehealthissue.md) object. |
-|[Get post-incident review report](../api/servicehealthissue-incidentreport.md)|Stream|Provides the post incident report (PIR) document of a specified service issue for tenant. |
+|[Get post-incident review report](../api/servicehealthissue-incidentreport.md)|Stream|Get the post incident report (PIR) document of a specified service issue for tenant. |
## Properties |Property|Type|Description| |:|:|:| |classification|serviceHealthClassificationType|The type of service health issue. Possible values are: `advisory`, `incident`, `unknownFutureValue`.|
-|details|Collection([keyValuePair](../resources/keyvaluepair.md))|Additional details about service health issue. This property doesn't support filters. Inherited from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).|
+|details|Collection([keyValuePair](../resources/keyvaluepair.md))|Additional details about the service health issue. This property doesn't support filters. Inherited from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).|
|endDateTime|DateTimeOffset|The end time of the service issue. Inherited from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).| |feature|String|The feature name of the service issue.| |featureGroup|String|The feature group name of the service issue.|
Inherits from [serviceAnnouncementBase](../resources/serviceannouncementbase.md)
|posts|Collection([serviceHealthIssuePost](../resources/servicehealthissuepost.md))|Collection of historical posts for the service issue.| |service|String|Indicates the service affected by the issue.| |startDateTime|DateTimeOffset|The start time of the service issue. Inherited from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).|
-|status|serviceHealthStatus|The status of the service issue. Possible values are: `serviceOperational`, `investigating`, `restoringService`, `verifyingService`, `serviceRestored`, `postIncidentReviewPublished`, `serviceDegradation`, `serviceInterruption`, `extendedRecovery`, `falsePositive`, `investigationSuspended`, `resolved`, `mitigatedExternal`, `mitigated`, `resolvedExternal`, `confirmed`, `reported`, `unknownFutureValue`.|
+|status|serviceHealthStatus|The status of the service issue. Possible values are: `serviceOperational`, `investigating`, `restoringService`, `verifyingService`, `serviceRestored`, `postIncidentReviewPublished`, `serviceDegradation`, `serviceInterruption`, `extendedRecovery`, `falsePositive`, `investigationSuspended`, `resolved`, `mitigatedExternal`, `mitigated`, `resolvedExternal`, `confirmed`, `reported`, `unknownFutureValue`. For more details, see [serviceHealthStatus values](#servicehealthstatus-values).|
|title|String|The title of the service issue. Inherited from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).|
+### serviceHealthStatus values
+|Member|Description|
+|:|:|
+|serviceOperational|The service is healthy and no issues have been identified.|
+|investigating|A potential issue was identified and more information is being gathered about what's going on and the scope of impact.|
+|restoringService|The cause of the issue has been identified, and action is being taken to bring the service back to a healthy state.|
+|verifyingService|The action has been taken to mitigate the issue and we're verify that the service is healthy.|
+|serviceRestored|The corrective action has resolved the underlying problem and the service has been restored to a healthy state. To find out what went wrong, view the issue details.|
+|postIncidentReviewPublished|A post-incident report for a specific issue that includes root cause information has been published, with next steps to ensure a similar issue doesn't reoccur.|
+|serviceDegradation|An issue is confirmed that may affect use of a service or feature. You might see this status if a service is performing more slowly than usual, there are intermittent interruptions, or if a feature isn't working, for example.|
+|serviceInterruption|You'll see this status if an issue is determined to affect the ability for users to access the service. In this case, the issue is significant and can be reproduced consistently.|
+|extendedRecovery|This status indicates that corrective action is in progress to restore the service to most users but will take some time to reach all the affected systems. You might also see this status if a temporary fix is made to reduce impact while a permanent fix is waiting to be applied.|
+|falsePositive|After a detailed investigation, the service is confirmed to be healthy and operating as designed. No impact to the service was observed or the cause of the incident originated outside of the service. Incidents and advisories with this status appear in the history view until they expire (after the period of time stated in the final post for that event).|
+|investigationSuspended|If our detailed investigation of a potential issue results in a request for additional information from customers to allow the service team to investigate further, you'll see this status. If service team need you to act, they'll let you know what data or logs they need.|
+|resolved|The Microsoft Windows service status that corresponds to service restored.|
+|mitigatedExternal|The Windows service status that corresponds to restoring service.|
+|mitigated|The Windows service status that corresponds to extended recovery.|
+|resolvedExternal|The Windows service status that corresponds to investigation suspended.|
+|confirmed|The Windows service status that corresponds to service interruption.|
+|reported|The Windows service status that corresponds to investigating.|
++ ## Relationships None.
v1.0 Serviceupdatemessage https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/serviceupdatemessage.md
Inherits from [serviceAnnouncementBase](../resources/serviceannouncementbase.md)
|[unarchive](../api/serviceupdatemessage-unarchive.md)|Boolean|Unarchive a list of [serviceUpdateMessage](../resources/serviceupdatemessage.md)s for the signed in user.| |[favorite](../api/serviceupdatemessage-favorite.md)|Boolean|Change the status of a list of [serviceUpdateMessage](../resources/serviceupdatemessage.md)s to favorite for the signed in user.| |[unfavorite](../api/serviceupdatemessage-unfavorite.md)|Boolean|Remove the favorite status of [serviceUpdateMessage](../resources/serviceupdatemessage.md)s for the signed in user.|
+|[List attachments](../api/serviceupdatemessage-list-attachments.md)|[serviceAnnouncementAttachment](../resources/serviceannouncementattachment.md) collection|Get a list of attachments associated with a service message.|
## Properties |Property|Type|Description| |:|:|:| |actionRequiredByDateTime|DateTimeOffset|The expected deadline of the action for the message.|
+|attachmentsArchive|Stream|The zip file of all attachments for a message.|
|body|[itemBody](../resources/itembody.md)|The content type and content of the service message body.| |category|serviceUpdateCategory|The service message category. Possible values are: `preventOrFixIssue`, `planForChange`, `stayInformed`, `unknownFutureValue`.| |details|Collection([keyValuePair](../resources/keyvaluepair.md))|Additional details about service message. This property doesn't support filters. Inherited from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).| |endDateTime|DateTimeOffset|The end time of the service message. Inherited from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).|
+|hasAttachments|Boolean|Indicates whether the message has any attachment.|
|id|String|The id of the service message. Inherited from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).| |isMajorChange|Boolean|Indicates whether the message describes a major update for the service.| |lastModifiedDateTime|DateTimeOffset|The last modified time of the service message. Inherited from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).| |services|Collection(string)|The affected services by the service message.| |severity|serviceUpdateSeverity|The severity of the service message. Possible values are: `normal`, `high`, `critical`, `unknownFutureValue`.| |startDateTime|DateTimeOffset|The start time of the service message. Inherited from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).|
-|tags|Collection(string)|A collection of tags for the service message.|
+|tags|Collection(string)|A collection of tags for the service message. Tags are provided by the service team/support team who post the message to tell whether this message contains privacy data, or whether this message is for a service new feature update, and so on.|
|title|String|The title of the service message. Inherited from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).|
-|viewPoint|[serviceUpdateMessageViewpoint](../resources/serviceupdatemessageviewpoint.md)|Represents user view points data of the service message. This data includes message status such as whether the user has archived, read, or marked the message as favorite. This property is null when accessed with application permissions.|
+|viewPoint|[serviceUpdateMessageViewpoint](../resources/serviceupdatemessageviewpoint.md)|Represents user viewpoints data of the service message. This data includes message status such as whether the user has archived, read, or marked the message as favorite. This property is null when accessed with application permissions.|
## Relationships
-None.
+|Relationship|Type|Description|
+|:|:|:|
+|attachments|Collection([serviceAnnouncementAttachment](../resources/serviceannouncementattachment.md))|A collection of [serviceAnnouncementAttachments](../resources/serviceannouncementattachment.md).|
## JSON representation The following is a JSON representation of the resource.
The following is a JSON representation of the resource.
"blockType": "resource", "keyProperty": "id", "@odata.type": "microsoft.graph.serviceUpdateMessage",
+ "baseType": "microsoft.graph.serviceAnnouncementBase",
"openType": false } -->
The following is a JSON representation of the resource.
], "viewPoint": { "@odata.type": "microsoft.graph.serviceUpdateMessageViewpoint"
- }
+ },
+ "hasAttachments": "Boolean",
+ "attachmentsArchive": "Stream"
} ```
v1.0 Virtualendpoint https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/virtualendpoint.md
Use the Cloud PC API to provision and manage virtual desktops for employees in a
|auditEvents|[cloudPcAuditEvent](../resources/cloudpcauditevent.md) collection|Cloud PC audit event.| |supportedRegions|[cloudPcSupportedRegion](../resources/cloudpcsupportedregion.md) collection|Cloud PC supported regions.| |servicePlans|[cloudPcServicePlan](../resources/cloudpcserviceplan.md) collection|Cloud PC service plans.|
+|organizationSettings|[cloudPcOrganizationSettings](../resources/cloudpcorganizationsettings.md) |The Cloud PC organization settings for a tenant. |
## JSON representation
v1.0 Administrativeunit Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/administrativeunit-get.md
One of the following permissions is required to call this API. To learn more, in
GET /directory/administrativeUnits/{id} ``` ## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response.
## Request headers | Name |Description|
v1.0 Administrativeunit List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/administrativeunit-list.md
One of the following permissions is required to call this API. To learn more, in
GET /directory/administrativeUnits ``` ## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+This method supports the `$count`, `$select`, `$search`, `$filter` (`eq`), and `$expand` [OData query parameters](/graph/query-parameters) to help customize the response.
## Request headers | Name |Description|
v1.0 Directoryrole Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/directoryrole-get.md
GET /directoryRoles/{role-id}
GET /directoryRoles/roleTemplateId={roleTemplateId} ``` ## Optional query parameters
-This method does **not** support any [OData query parameters](/graph/query-parameters) to help customize the response (for example, `$filter` is not supported here).
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response.
## Request headers | Name | Type | Description|
v1.0 Directoryrole List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/directoryrole-list.md
One of the following permissions is required to call this API. To learn more, in
GET /directoryRoles ``` ## Optional query parameters
-This method does **not** support the [OData Query Parameters](/graph/query-parameters) to help customize the response (e.g. $filter is not supported here).
+This method supports the `$count`, `$select`, `$search`, `$filter` (`eq`), and `$expand` [OData query parameters](/graph/query-parameters) to help customize the response.
## Request headers | Name | Description|
v1.0 Serviceannouncement List Healthoverviews https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceannouncement-list-healthoverviews.md
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and a collection of [serviceHealth](../resources/servicehealth.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [serviceHealth](../resources/servicehealth.md) objects in the response body. The response is paginated and each page contains 100 objects.
## Examples
v1.0 Serviceannouncement List Issues https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceannouncement-list-issues.md
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and a collection of [serviceHealthIssue](../resources/servicehealthissue.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [serviceHealthIssue](../resources/servicehealthissue.md) objects in the response body. The response is paginated and each page contains 100 objects.
## Example
Content-Type: application/json
{ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#admin/serviceAnnouncement/issues",
+ "@odata.nextLink": "https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/issues?$skip=100",
"value": [ { "startDateTime": "2020-11-13T21:00:00Z",
v1.0 Serviceannouncement List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceannouncement-list-messages.md
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and a collection of [serviceUpdateMessage](../resources/serviceupdatemessage.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [serviceUpdateMessage](../resources/serviceupdatemessage.md) objects in the response body. The response is paginated and each page contains 100 objects.
## Example
Content-Type: application/json
{ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#admin/serviceAnnouncement/messages",
+ "@odata.nextLink": "https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/messages?$skip=100",
"value": [ { "startDateTime": "2019-02-01T18:51:00Z",
v1.0 Serviceannouncementattachment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceannouncementattachment-get.md
+
+ Title: "Get serviceAnnouncementAttachment"
+description: "Read the properties and relationships of a serviceAnnouncementAttachment object."
+
+ms.localizationpriority: medium
++
+# Get serviceAnnouncementAttachment
+Namespace: microsoft.graph
+
+Read the properties and relationships of a [serviceAnnouncementAttachment](../resources/serviceannouncementattachment.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)|ServiceMessage.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|ServiceMessage.Read.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/serviceAnnouncement/messages/{serviceUpdateMessageId}/attachments/{serviceAnnouncementAttachmentId}
+```
+
+## Optional query parameters
+This method supports the [OData query parameters](/graph/query-parameters) to help customize the response.
+
+## 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 [serviceAnnouncementAttachment](../resources/serviceannouncementattachment.md) object in the response body.
+
+## Examples
+
+### Example 1: Get an attachment message ID
+
+The following request returns an [serviceAnnouncementAttachment](../resources/serviceannouncementattachment.md) resource.
+
+#### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_serviceannouncementattachment"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/messages/MC54091/attachments/30356a46-ffad-47e1-acf6-40a99b1538c1
+```
+
+#### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.serviceAnnouncementAttachment"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "@odata.context": "https://graph.microsoft-ppe.com/v1.0/$metadata#admin/serviceAnnouncement/messages('MC54091')/attachments/$entity",
+ "contentType": "application/csv",
+ "isInline": false,
+ "lastModifiedDateTime": "2021-09-21T04:07:15.9720778Z",
+ "name": "An attachment for a Data Privacy message regarding your organization is available within Message Center. The contents of this attachment can be accessed within Message Center by a Global Administrator or someone designated as a Message Center Privacy Reader. Please sign in to Admin Center to view the details of this message in the Microsoft 365 Message center.",
+ "size": 44583,
+ "id": "30356a46-ffad-47e1-acf6-40a99b1538c1"
+ }
+}
+```
+
+### Example 2: Return a file stream of an attachment content for a message
+
+#### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_serviceannouncementattachment"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/messages/MC54091/attachments/30356a46-ffad-47e1-acf6-40a99b1538c1/content
+```
+
+#### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.serviceAnnouncementAttachment"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": "An attachment for a Data Privacy message regarding your organization is available within Message Center. The contents of this attachment can be accessed within Message Center by a Global Administrator or someone designated as a Message Center Privacy Reader. Please sign in to Admin Center to view the details of this message in the Microsoft 365 Message center."
+}
+```
v1.0 Servicehealthissue Incidentreport https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/servicehealthissue-incidentreport.md
doc_type: apiPageType
# serviceHealthIssue: incidentReport Namespace: microsoft.graph
-Provide the Post-Incident Review (PIR) document of a specified service issue for tenant.
+Provide the Post-Incident Review (PIR) document of a specified service issue for tenant.
-The operation returns an error if the specified issue doesn't exist for the tenant.
+An issue only with status of `PostIncidentReviewPublished` indicates that the PIR document exists for the issue. The operation returns an error if the specified issue doesn't exist for the tenant or if PIR document does not exist for the issue.
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Serviceprincipal Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceprincipal-update.md
In the request body, supply the values for relevant fields that should be update
|:|:--|:-| |accountEnabled|Boolean| **true** if the service principal account is enabled; otherwise, **false**.| |addIns| [addIn](../resources/addin.md) | 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 Microsoft 365 call the application in the context of a document the user is working on.|
-|alternativeNames|String collection| Used to retrieve service principals by subscription, identify resource group and full resource ids for [managed identities](https://aka.ms/azuremanagedidentity).|
+|alternativeNames|String collection| Used to retrieve service principals by subscription, identify resource group and full resource ids for [managed identities](/azure/active-directory/managed-identities-azure-resources/overview).|
|appRoleAssignmentRequired|Boolean|Specifies whether an **appRoleAssignment** to a user or group is required before Azure AD will issue a user or access token to the application. Not nullable. | |appRoles|[appRole](../resources/approle.md) collection|The application roles exposed by the associated application. For more information see the **appRoles** property definition on the [application](../resources/application.md) resource. Not nullable. | |displayName|String|The display name for the service principal.|
HTTP/1.1 204 No Content
"suppressions": [ ] }>-
+-->
v1.0 Serviceupdatemessage List Attachments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceupdatemessage-list-attachments.md
+
+ Title: "List attachments"
+description: "Get the list of attachments associated with a service message."
+
+ms.localizationpriority: medium
++
+# List attachments
+Namespace: microsoft.graph
+
+Get the list of attachments associated with a service message.
+
+## 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)|ServiceMessage.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|ServiceMessage.Read.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/serviceAnnouncement/messages/{serviceUpdateMessageId}/attachments
+```
+
+## Optional query parameters
+This method supports the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [serviceAnnouncementAttachment](../resources/serviceannouncementattachment.md) objects in the response body.
+
+## Examples
+
+### Example 1: Get all attachments of a message in a collection
+
+#### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_serviceannouncementattachment"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/messages/MC54091/attachments
+```
+
+#### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.serviceAnnouncementAttachment)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft-ppe.com/v1.0/$metadata#admin/serviceAnnouncement/messages('MC54091')/attachments",
+ "value": [
+ {
+ "contentType": "application/csv",
+ "isInline": false,
+ "lastModifiedDateTime": "2021-09-21T04:07:15.9720778Z",
+ "name": "An attachment for a Data Privacy message regarding your organization is available within Message Center. The contents of this attachment can be accessed within Message Center by a Global Administrator or someone designated as a Message Center Privacy Reader. Please sign in to Admin Center to view the details of this message in the Microsoft 365 Message center.",
+ "size": 44583,
+ "id": "30356a46-ffad-47e1-acf6-40a99b1538c1"
+ },
+ {
+ "contentType": "application/csv",
+ "isInline": false,
+ "lastModifiedDateTime": "2021-09-21T04:07:15.9720778Z",
+ "name": "An attachment for a Data Privacy message regarding your organization is available within Message Center. The contents of this attachment can be accessed within Message Center by a Global Administrator or someone designated as a Message Center Privacy Reader. Please sign in to Admin Center to view the details of this message in the Microsoft 365 Message center.",
+ "size": 288849,
+ "id": "fdd33417-37b9-49cc-95c1-7af90f2366c8"
+ }
+ ]
+}
+```
+
+### Example 2: Get a zip file of all attachments in stream for a message
+
+#### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_serviceannouncementattachment"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/messages/MC54091/attachmentsArchive
+```
+
+#### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Edm.Stream"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft-ppe.com/v1.0/$metadata#admin/serviceAnnouncement/messages('MC54091')/attachmentsArchive",
+ "value": "Stream"
+}
+```
v1.0 Team Get Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/team-get-installedapps.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | TeamsAppInstallation.Read.Group*, TeamsAppInstallation.ReadWriteSelfForTeam.All, TeamsAppInstallation.ReadForTeam.All, TeamsAppInstallation.ReadWriteForTeam.All, Group.Read.All**, Group.ReadWrite.All**, Directory.Read.All**, Directory.ReadWrite.All** |
-> **Note**: Permissions marked with * use [resource-specific consent](https://aka.ms/teams-rsc). Permissions marked with ** are deprecated and should not be used.
+> **Note**: Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). Permissions marked with ** are deprecated and should not be used.
## HTTP request
Content-type: application/json
"tocPath": "", "suppressions": [ ]
-}-->
+}-->
v1.0 Team Get Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/team-get-members.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application| TeamMember.Read.Group*, TeamMember.Read.All, TeamMember.ReadWrite.All |
-> **Note**: Permissions marked with * use [resource-specific consent](https://aka.ms/teams-rsc).
+> **Note**: Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent).
> [!NOTE] > Before calling this API with application permissions, you must request access. For details, see [Protected APIs in Microsoft Teams](/graph/teams-protected-apis).
Content-type: application/json
## See also -- [Get member of channel](channel-get-members.md)-
+- [Get member of channel](channel-get-members.md)
v1.0 Team Sendactivitynotification https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/team-sendactivitynotification.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not Supported.| |Application|TeamsActivity.Send.Group*, TeamsActivity.Send|
->**Note:** Permissions marked with * use [resource-specific consent](https://aka.ms/teams-rsc).
+>**Note:** Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent).
## HTTP request
Content-Type: application/json
--> ``` http HTTP/1.1 204 No Content
-```
+```
v1.0 Team Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/team-update.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | TeamSettings.ReadWrite.Group*, TeamSettings.ReadWrite.All, Group.ReadWrite.All**, Directory.ReadWrite.All** |
-> **Note**: Permissions marked with * use [resource-specific consent](https://aka.ms/teams-rsc). Permissions marked with ** are deprecated and should not be used.
+> **Note**: Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). Permissions marked with ** are deprecated and should not be used.
> **Note**: This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of.
HTTP/1.1 204 No Content
"tocPath": "", "suppressions": [ ]
-}-->
-
+}-->
v1.0 Administrativeunit https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/administrativeunit.md
This topic provides descriptions of the declared properties and navigation prope
| Property | Type |Description| |:|:--|:-|
-|description|string|An optional description for the administrative unit. Supports `$filter` (`eq`, `ne`, `in`, `startsWith`).|
+|description|string|An optional description for the administrative unit. Supports `$filter` (`eq`, `ne`, `in`, `startsWith`), `$search`.|
|displayName|string|Display name for the administrative unit. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values), `$search`, and `$orderBy`.| |id|string|Unique identifier for the administrative unit. Read-only. Supports `$filter` (`eq`).| |visibility|string|Controls whether the administrative unit and its members are hidden or public. Can be set to `HiddenMembership` or `Public`. If not set, default behavior is `Public`. When set to `HiddenMembership`, only members of the administrative unit can list other members of the administrative unit.|
This topic provides descriptions of the declared properties and navigation prope
| Relationship | Type |Description| |:|:--|:-| |extensions|[extension](extension.md) collection|The collection of open extensions defined for this administrative unit. Nullable.|
-|members|[directoryObject](directoryobject.md) collection|Users and groups that are members of this administrative unit. HTTP Methods: GET (list members), POST (add members), DELETE (remove members).|
-|scopedRoleMembers|[scopedRoleMembership](scopedrolemembership.md) collection| Scoped-role members of this administrative unit. HTTP Methods: GET (list scopedRoleMemberships), POST (add scopedRoleMembership), DELETE (remove scopedRoleMembership). |
+|members|[directoryObject](directoryobject.md) collection|Users and groups that are members of this administrative unit. Supports `$expand`.|
+|scopedRoleMembers|[scopedRoleMembership](scopedrolemembership.md) collection| Scoped-role members of this administrative unit. |
## JSON representation
v1.0 Directoryrole https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/directoryrole.md
This resource supports:
## Properties | Property | Type | Description | |:|:--|:-|
-|description|String|The description for the directory role. Read-only. |
-|displayName|String|The display name for the directory role. Read-only. |
-|id|String|The unique identifier for the directory role. Inherited from [directoryObject](directoryobject.md). Key, Not nullable, Read-only.|
-|roleTemplateId|String| The **id** of the [directoryRoleTemplate](directoryroletemplate.md) that this role is based on. The property must be specified when activating a directory role in a tenant with a POST operation. After the directory role has been activated, the property is read only. |
+|description|String|The description for the directory role. Read-only. Supports `$filter` (`eq`), `$search`, `$select`. |
+|displayName|String|The display name for the directory role. Read-only. Supports `$filter` (`eq`), `$search`, `$select`. |
+|id|String|The unique identifier for the directory role. Inherited from [directoryObject](directoryobject.md). Key, Not nullable, Read-only. Supports `$filter` (`eq`), `$select`.|
+|roleTemplateId|String| The **id** of the [directoryRoleTemplate](directoryroletemplate.md) that this role is based on. The property must be specified when activating a directory role in a tenant with a POST operation. After the directory role has been activated, the property is read only. Supports `$filter` (`eq`), `$select`. |
## Relationships | Relationship | Type |Description| |:|:--|:-|
-|members|[directoryObject](directoryobject.md) collection|Users that are members of this directory role. HTTP Methods: GET, POST, DELETE. Read-only. Nullable.|
+|members|[directoryObject](directoryobject.md) collection|Users that are members of this directory role. HTTP Methods: GET, POST, DELETE. Read-only. Nullable. Supports `$expand`.|
|scopedMembers|[scopedRoleMembership](scopedrolemembership.md) collection| Members of this directory role that are scoped to [administrative units](administrativeunit.md). Read-only. Nullable.| ## JSON representation
v1.0 Security Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/security-api-overview.md
Need more ideas? See [how some of our partners are using Microsoft Graph](https:
Explore other options to connect with the Microsoft Graph Security API: -- [Microsoft Graph Security connectors for Logic Apps, Flow and Power Apps](https://aka.ms/graphsecurityconnectors)
+- [Microsoft Graph Security connectors for Logic Apps, Flow and Power Apps](/azure/connectors/connectors-integrate-security-operations-create-api-microsoft-graph-security)
- [Jupyter Notebook samples](https://aka.ms/graphsecurityjupyternotebooks) Engage with the community: - [Join the tech community](https://techcommunity.microsoft.com/t5/microsoft-graph-security-api/bd-p/SecurityGraphAPI)-- [Discuss on StackOverflow](https://stackoverflow.com/questions/tagged/microsoft-graph-security)-
+- [Discuss on StackOverflow](https://stackoverflow.com/questions/tagged/microsoft-graph-security)
v1.0 Service Communications Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/service-communications-api-overview.md
Service communications API is available on Microsoft Graph national clouds as we
|Microsoft Graph Germany|https://graph.microsoft.de/v1.0/admin/serviceAnnouncement/| |Microsoft Graph China operated by 21Vianet|https://microsoftgraph.chinacloudapi.cn/v1.0/admin/serviceAnnouncement/|
+## Service communications limits
+
+To guarantee the service performance, the service communications API has throttling limits for the requests per tenant per application. For details about the limits, see [throttling limits for the service communications service](/graph/throttling#service-communications-service-limits).
+ ## What's new Find out about the [latest new features and updates](/graph/whats-new-overview) for this API set.
v1.0 Serviceannouncementattachment https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/serviceannouncementattachment.md
+
+ Title: "serviceAnnouncementAttachment resource type"
+description: "Represents an attachment associated with a serviceUpdateMessage object."
+
+ms.localizationpriority: medium
++
+# serviceAnnouncementAttachment resource type
+
+Namespace: microsoft.graph
+
+Represents an attachment associated with a [serviceUpdateMessage](../resources/serviceupdatemessage.md) object.
+
+Inherits from [attachment](../resources/attachment.md).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[Get serviceAnnouncementAttachment](../api/serviceannouncementattachment-get.md)|[serviceAnnouncementAttachment](../resources/serviceannouncementattachment.md)|Read the properties and relationships of a [serviceAnnouncementAttachment](../resources/serviceannouncementattachment.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|content|Stream|The attachment content.|
+|contentType|String|The content type of the attachment.|
+|id|String|The attachment ID. Inherited from [entity](../resources/entity.md).|
+|lastModifiedDateTime|DateTimeOffset|The date and time when the attachment was last modified.|
+|name|String|The attachment name.|
+|size|Int32|The size in bytes of the attachment.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.serviceAnnouncementAttachment",
+ "baseType": "microsoft.graph.attachment",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.serviceAnnouncementAttachment",
+ "id": "String (identifier)",
+ "lastModifiedDateTime": "String (timestamp)",
+ "name": "String",
+ "contentType": "String",
+ "size": "Integer",
+ "isInline": "Boolean",
+ "content": "Stream"
+}
+```
v1.0 Servicehealth https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/servicehealth.md
Represents the health information of a service subscribed by a tenant.
|:|:|:| |id|String|The service id.| |service|String|The service name. Use the [list healthOverviews](../api/serviceannouncement-list-healthoverviews.md) operation to get exact string names for services subscribed by the tenant.|
-|status|serviceHealthStatus|Show the overral service health status. Possible values are: `serviceOperational`, `investigating`, `restoringService`, `verifyingService`, `serviceRestored`, `postIncidentReviewPublished`, `serviceDegradation`, `serviceInterruption`, `extendedRecovery`, `falsePositive`, `investigationSuspended`, `resolved`, `mitigatedExternal`, `mitigated`, `resolvedExternal`, `confirmed`, `reported`, `unknownFutureValue`.|
+|status|serviceHealthStatus|Show the overral service health status. Possible values are: `serviceOperational`, `investigating`, `restoringService`, `verifyingService`, `serviceRestored`, `postIncidentReviewPublished`, `serviceDegradation`, `serviceInterruption`, `extendedRecovery`, `falsePositive`, `investigationSuspended`, `resolved`, `mitigatedExternal`, `mitigated`, `resolvedExternal`, `confirmed`, `reported`, `unknownFutureValue`. For more details, see [serviceHealthStatus values](../resources/servicehealthissue.md#servicehealthstatus-values).|
## Relationships |Relationship|Type|Description| |:|:|:|
-|issues|Collection([serviceHealthIssue](../resources/servicehealthissue.md))|A collection of issues happened on the service, with detailed information for each issue.|
+|issues|Collection([serviceHealthIssue](../resources/servicehealthissue.md))|A collection of issues that happened on the service, with detailed information for each issue.|
## JSON representation The following is a JSON representation of the resource.
v1.0 Servicehealthissue https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/servicehealthissue.md
Inherits from [serviceAnnouncementBase](../resources/serviceannouncementbase.md)
|posts|Collection([serviceHealthIssuePost](../resources/servicehealthissuepost.md))|Collection of historical posts for the service issue.| |service|String|Indicates the service affected by the issue.| |startDateTime|DateTimeOffset|The start time of the service issue. Inherited from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).|
-|status|serviceHealthStatus|The status of the service issue. Possible values are: `serviceOperational`, `investigating`, `restoringService`, `verifyingService`, `serviceRestored`, `postIncidentReviewPublished`, `serviceDegradation`, `serviceInterruption`, `extendedRecovery`, `falsePositive`, `investigationSuspended`, `resolved`, `mitigatedExternal`, `mitigated`, `resolvedExternal`, `confirmed`, `reported`, `unknownFutureValue`.|
+|status|serviceHealthStatus|The status of the service issue. Possible values are: `serviceOperational`, `investigating`, `restoringService`, `verifyingService`, `serviceRestored`, `postIncidentReviewPublished`, `serviceDegradation`, `serviceInterruption`, `extendedRecovery`, `falsePositive`, `investigationSuspended`, `resolved`, `mitigatedExternal`, `mitigated`, `resolvedExternal`, `confirmed`, `reported`, `unknownFutureValue`. See more in the [table below](#servicehealthstatus-values).|
|title|String|The title of the service issue. Inherited from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).|
+### serviceHealthStatus values
+|Member|Description|
+|:|:|
+|serviceOperational|The service is healthy and no issues have been identified.|
+|investigating|A potential issue was identified and more information is being gathered about what's going on and the scope of impact.|
+|restoringService|The cause of the issue has been identified, and action is being taken to bring the service back to a healthy state.|
+|verifyingService|The action has been taken to mitigate the issue and we're verify that the service is healthy.|
+|serviceRestored|The corrective action has resolved the underlying problem and the service has been restored to a healthy state. To find out what went wrong, view the issue details.|
+|postIncidentReviewPublished|A post-incident report for a specific issue that includes root cause information has been published, with next steps to ensure a similar issue doesn't reoccur.|
+|serviceDegradation|An issue is confirmed that may affect use of a service or feature. You might see this status if a service is performing more slowly than usual, there are intermittent interruptions, or if a feature isn't working, for example.|
+|serviceInterruption|You'll see this status if an issue is determined to affect the ability for users to access the service. In this case, the issue is significant and can be reproduced consistently.|
+|extendedRecovery|This status indicates that corrective action is in progress to restore the service to most users but will take some time to reach all the affected systems. You might also see this status if a temporary fix is made to reduce impact while a permanent fix is waiting to be applied.|
+|falsePositive|After a detailed investigation, the service is confirmed to be healthy and operating as designed. No impact to the service was observed or the cause of the incident originated outside of the service. Incidents and advisories with this status appear in the history view until they expire (after the period of time stated in the final post for that event).|
+|investigationSuspended|If our detailed investigation of a potential issue results in a request for additional information from customers to allow the service team to investigate further, you'll see this status. If service team need you to act, they'll let you know what data or logs they need.|
+|resolved|The Microsoft Windows service status that corresponds to service restored.|
+|mitigatedExternal|The Windows service status that corresponds to restoring service.|
+|mitigated|The Windows service status that corresponds to extended recovery.|
+|resolvedExternal|The Windows service status that corresponds to investigation suspended.|
+|confirmed|The Windows service status that corresponds to service interruption.|
+|reported|The Windows service status that corresponds to investigating.|
+ ## Relationships None.
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
|:|:--|:-| | accountEnabled |Boolean| `true` if the service principal account is enabled; otherwise, `false`. Supports `$filter` (`eq`, `ne`, `not`, `in`).| | 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&preserve-view=true) for its "FileHandler" functionality. This will let services like Microsoft 365 call the application in the context of a document the user is working on.|
-|alternativeNames|String collection| Used to retrieve service principals by subscription, identify resource group and full resource ids for [managed identities](https://aka.ms/azuremanagedidentity). Supports `$filter` (`eq`, `not`, `ge`, `le`, `startsWith`).|
+|alternativeNames|String collection| Used to retrieve service principals by subscription, identify resource group and full resource ids for [managed identities](/azure/active-directory/managed-identities-azure-resources/overview). Supports `$filter` (`eq`, `not`, `ge`, `le`, `startsWith`).|
|appDescription|String|The description exposed by the associated application.| |appDisplayName|String|The display name exposed by the associated application.| |appId|String|The unique identifier for the associated application (its **appId** property). Supports `$filter` (`eq`, `ne`, `not`, `in`, `startsWith`).|
Here is a JSON representation of the resource
"suppressions": [ ] }>
+-->
v1.0 Serviceupdatemessage https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/serviceupdatemessage.md
Inherits from [serviceAnnouncementBase](../resources/serviceannouncementbase.md)
|[unarchive](../api/serviceupdatemessage-unarchive.md)|Boolean|Unarchive a list of [serviceUpdateMessage](../resources/serviceupdatemessage.md)s for the signed in user.| |[favorite](../api/serviceupdatemessage-favorite.md)|Boolean|Change the status of a list of [serviceUpdateMessage](../resources/serviceupdatemessage.md)s to favorite for the signed in user.| |[unfavorite](../api/serviceupdatemessage-unfavorite.md)|Boolean|Remove the favorite status of [serviceUpdateMessage](../resources/serviceupdatemessage.md)s for the signed in user.|
+|[List attachments](../api/serviceupdatemessage-list-attachments.md)|[serviceAnnouncementAttachment](../resources/serviceannouncementattachment.md) collection|Get a list of attachments associated with a service message.|
## Properties |Property|Type|Description| |:|:|:| |actionRequiredByDateTime|DateTimeOffset|The expected deadline of the action for the message.|
+|attachmentsArchive|Stream|The zip file that contains all attachments for a message.|
|body|[itemBody](../resources/itembody.md)|The content type and content of the service message body.| |category|serviceUpdateCategory|The service message category. Possible values are: `preventOrFixIssue`, `planForChange`, `stayInformed`, `unknownFutureValue`.| |details|Collection([keyValuePair](../resources/keyvaluepair.md))|Additional details about service message. This property doesn't support filters. Inherited from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).| |endDateTime|DateTimeOffset|The end time of the service message. Inherited from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).|
+|hasAttachments|Boolean|Indicates whether the message has any attachment.|
|id|String|The id of the service message. Inherited from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).| |isMajorChange|Boolean|Indicates whether the message describes a major update for the service.| |lastModifiedDateTime|DateTimeOffset|The last modified time of the service message. Inherited from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).| |services|Collection(string)|The affected services by the service message.| |severity|serviceUpdateSeverity|The severity of the service message. Possible values are: `normal`, `high`, `critical`, `unknownFutureValue`.| |startDateTime|DateTimeOffset|The start time of the service message. Inherited from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).|
-|tags|Collection(string)|A collection of tags for the service message.|
+|tags|Collection(string)|A collection of tags for the service message. Tags are provided by the service team/support team who post the message to tell whether this message contains privacy data, or whether this message is for a service new feature update, and so on.|
|title|String|The title of the service message. Inherited from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).|
-|viewPoint|[serviceUpdateMessageViewpoint](../resources/serviceupdatemessageviewpoint.md)|Represents user view points data of the service message. This data includes message status such as whether the user has archived, read, or marked the message as favorite. This property is null when accessed with application permissions.|
+|viewPoint|[serviceUpdateMessageViewpoint](../resources/serviceupdatemessageviewpoint.md)|Represents user viewpoints data of the service message. This data includes message status such as whether the user has archived, read, or marked the message as favorite. This property is null when accessed with application permissions.|
## Relationships
-None.
+|Relationship|Type|Description|
+|:|:|:|
+|attachments|Collection([serviceAnnouncementAttachment](../resources/serviceannouncementattachment.md))|A collection of [serviceAnnouncementAttachments](../resources/serviceannouncementattachment.md).|
## JSON representation The following is a JSON representation of the resource.
The following is a JSON representation of the resource.
"blockType": "resource", "keyProperty": "id", "@odata.type": "microsoft.graph.serviceUpdateMessage",
+ "baseType": "microsoft.graph.serviceAnnouncementBase",
"openType": false } -->
The following is a JSON representation of the resource.
], "viewPoint": { "@odata.type": "microsoft.graph.serviceUpdateMessageViewpoint"
- }
+ },
+ "hasAttachments": "Boolean",
+ "attachmentsArchive": "Stream"
} ```
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:
href: resources/calendar.md displayName: Outlook, Outlook calendar items:
- - name: Create calendar
+ - name: Create
href: api/user-post-calendars.md - name: Create calendar group href: api/user-post-calendargroups.md
items:
href: api/user-findmeetingtimes.md - name: Get free/busy schedule href: api/calendar-getschedule.md
- - name: List calendars
+ - name: List
href: api/user-list-calendars.md - name: List calendar groups href: api/user-list-calendargroups.md
items:
- name: Contacts href: resources/contact.md items:
- - name: Create contact
+ - name: Create
href: api/user-post-contacts.md - name: Create contact folder href: api/user-post-contactfolders.md
- - name: List contacts
+ - name: List
href: api/user-list-contacts.md - name: List contact folders href: api/user-list-contactfolders.md
items:
href: api/serviceupdatemessage-favorite.md - name: Remove favorite status href: api/serviceupdatemessage-unfavorite.md
+ - name: List message attachments
+ href: api/serviceupdatemessage-list-attachments.md
+ - name: Service announcement attachment
+ href: resources/serviceannouncementattachment.md
+ items:
+ - name: Get
+ href: api/serviceannouncementattachment-get.md
- name: Education items: - name: Overview
items:
- name: Team href: resources/team.md items:
- - name: Create team
+ - name: Create
href: api/team-post.md - name: Create team from group href: api/team-put-teams.md
- - name: Get team
+ - name: Get
href: api/team-get.md
- - name: Update team
+ - name: Update
href: api/team-update.md
- - name: Delete team
+ - name: Delete
href: api/group-delete.md - name: List members href: api/team-list-members.md
items:
- name: Group (team) href: resources/group.md items:
- - name: Create group
+ - name: Create
href: api/group-post-groups.md
- - name: Get group
+ - name: Get
href: api/group-get.md
- - name: List groups
+ - name: List
href: api/group-list.md
- - name: Update group
+ - name: Update
href: api/group-update.md
- - name: Delete group
+ - name: Delete
href: api/group-delete.md - name: List joined teams href: api/user-list-joinedteams.md