Updates from: 08/04/2021 03:16:53
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Keycredential https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/keycredential.md
Contains a key credential associated with an application or a service principal.
|:|:--|:-| |customKeyIdentifier|Binary| Custom key identifier | | displayName | String | Friendly name for the key. Optional. |
-|endDateTime|DateTimeOffset|The date and time at which the credential expires.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`|
-|keyId|Guid|The unique identifier (GUID) for the key.|
-|startDateTime|DateTimeOffset|The date and time at which the credential becomes valid.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`|
-|type|String|The type of key credential; for example, ΓÇ£SymmetricΓÇ¥.|
-|usage|String|A string that describes the purpose for which the key can be used; for example, ΓÇ£VerifyΓÇ¥.|
+|endDateTime|DateTimeOffset|The date and time at which the credential expires.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.|
|key|Binary| Value for the key credential. Should be a base 64 encoded value. |
+|keyId|Guid|The unique identifier for the key.|
+|startDateTime|DateTimeOffset|The date and time at which the credential becomes valid.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.|
+|type|String|The type of key credential; for example, `Symmetric`.|
+|usage|String|A string that describes the purpose for which the key can be used; for example, `Verify`.|
+ ## JSON representation
Here is a JSON representation of the resource
```json {
- "customKeyIdentifier": "binary",
+ "@odata.type": "#microsoft.graph.keyCredential",
+ "customKeyIdentifier": "Binary",
"displayName": "String", "endDateTime": "String (timestamp)",
- "keyId": "guid",
+ "key": "Binary",
+ "keyId": "Guid",
"startDateTime": "String (timestamp)",
- "type": "string",
- "usage": "string",
- "key": "binary"
+ "type": "String",
+ "usage": "String"
} ```
v1.0 Policyroot https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/policyroot.md
None
## Relationships | Relationship | Type | Description | |:|:-|:|
-| authenticationMethodsPolicy | [authenticationMethodsPolicy](authenticationmethodspolicy.md) | The authentication methods and the users that are allowed to use them to sign in and perform multi-factor authentication (MFA) in Azure Active Directory (Azure AD). |
-| authenticationFlowsPolicy | [authenticationFlowsPolicy](authenticationflowspolicy.md) | The policy configuration of the self-service sign-up experience of external users. |
-| b2cAuthenticationMethodsPolicy | [b2cAuthenticationMethodsPolicy](b2cauthenticationmethodspolicy.md) | The Azure AD B2C policies that define how end users register via local accounts. |
+| accessReviewPolicy | [accessReviewPolicy](accessreviewpolicy.md) | The policy that contains directory-level access review settings. |
| activityBasedTimeoutPolicies | [activityBasedTimeoutPolicy](activitybasedtimeoutpolicy.md) collection | The policy that controls the idle time out for web sessions for applications. |
+| adminConsentRequestPolicy | [adminConsentRequestPolicy](adminconsentrequestpolicy.md) | The policy by which consent requests are created and managed for the entire tenant. |
+| appManagementPolicies | [appManagementPolicy](appmanagementpolicy.md) collection | The policies that enforce app management restrictions for specific applications and service principals, overriding the defaultAppManagementPolicy. |
+| authenticationFlowsPolicy | [authenticationFlowsPolicy](authenticationflowspolicy.md) | The policy configuration of the self-service sign-up experience of external users. |
+| authenticationMethodsPolicy | [authenticationMethodsPolicy](authenticationmethodspolicy.md) | The authentication methods and the users that are allowed to use them to sign in and perform multi-factor authentication (MFA) in Azure Active Directory (Azure AD). |
| authorizationPolicy | [authorizationPolicy](authorizationpolicy.md) collection | The policy that controls Azure AD authorization settings. |
+| b2cAuthenticationMethodsPolicy | [b2cAuthenticationMethodsPolicy](b2cauthenticationmethodspolicy.md) | The Azure AD B2C policies that define how end users register via local accounts. |
| claimsMappingPolicies | [claimsMappingPolicy](claimsmappingpolicy.md) collection | The claim-mapping policies for WS-Fed, SAML, OAuth 2.0, and OpenID Connect protocols, for tokens issued to a specific application. |
-| homeRealmDiscoveryPolicies | [homeRealmDiscoveryPolicy](homerealmdiscoverypolicy.md) collection | The policy to control Azure AD authentication behavior for federated users. |
-| permissionGrantPolicies | [permissionGrantPolicy](permissiongrantpolicy.md) collection | The policy that specifies the conditions under which consent can be granted. |
-| tokenIssuancePolicies | [tokenIssuancePolicy](tokenissuancepolicy.md) collection | The policy that specifies the characteristics of SAML tokens issued by Azure AD. |
-| tokenLifetimePolicies | [tokenLifetimePolicy](tokenlifetimepolicy.md) collection | The policy that controls the lifetime of a JWT access token, an ID token, or a SAML 1.1/2.0 token issued by Azure AD. |
-| featureRolloutPolicies | [featureRolloutPolicy](featurerolloutpolicy.md) collection | The feature rollout policy associated with a directory object. |
-| accessReviewPolicy | [accessReviewPolicy](accessreviewpolicy.md) | The policy that contains directory-level access review settings. |
-| adminConsentRequestPolicy | [adminConsentRequestPolicy](adminconsentrequestpolicy.md) | The policy by which consent requests are created and managed for the entire tenant. |
| conditionalAccessPolicies | [conditionalAccessPolicy](conditionalaccesspolicy.md) | The custom rules that define an access scenario. |
+| defaultAppManagementPolicy | [tenantAppManagementPolicy](tenantappmanagementpolicy.md) | The tenant-wide policy that enforces app management restrictions for all applications and service principals. |
+| featureRolloutPolicies | [featureRolloutPolicy](featurerolloutpolicy.md) collection | The feature rollout policy associated with a directory object. |
+| homeRealmDiscoveryPolicies | [homeRealmDiscoveryPolicy](homerealmdiscoverypolicy.md) collection | The policy to control Azure AD authentication behavior for federated users. |
| identitySecurityDefaultsEnforcementPolicy | [identitySecurityDefaultsEnforcementPolicy](identitysecuritydefaultsenforcementpolicy.md) | The policy that represents the security defaults that protect against common attacks. | | mobileAppManagementPolicies | [mobilityManagementPolicy](mobilitymanagementpolicy.md) collection | The policy that defines auto-enrollment configuration for a mobility management (MDM or MAM) application. |
+| permissionGrantPolicies | [permissionGrantPolicy](permissiongrantpolicy.md) collection | The policy that specifies the conditions under which consent can be granted. |
| roleManagementPolicies | [unifiedRoleManagementPolicy](../resources/unifiedrolemanagementpolicy.md) collection | Represents the role management policies. | | roleManagementPolicyAssignments | [unifiedRoleManagementPolicyAssignment](../resources/unifiedrolemanagementpolicyassignment.md) collection | Represents the role management policy assignments. |-
+| tokenIssuancePolicies | [tokenIssuancePolicy](tokenissuancepolicy.md) collection | The policy that specifies the characteristics of SAML tokens issued by Azure AD. |
+| tokenLifetimePolicies | [tokenLifetimePolicy](tokenlifetimepolicy.md) collection | The policy that controls the lifetime of a JWT access token, an ID token, or a SAML 1.1/2.0 token issued by Azure AD. |
## JSON representation The following is a JSON representation of the resource.
v1.0 Service Communications Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/service-communications-api-overview.md
Application permissions are needed to access the service communications API with
| Get a specific service message for tenant | [Get message](/graph/api/serviceupdatemessage-get?view=graph-rest-beta&preserve-view=true) | _ServiceMessage.Read.All_ | Delegated and application | | Update service message status for signed in user | For a list of status operations, see [serviceUpdateMessage](/graph/api/resources/serviceupdatemessage?view=graph-rest-beta&preserve-view=true).| _ServiceMessageViewpoint.Write_ | Delegated |
+## Availability in national clouds
+That service communications API is available in all Microsoft national cloud deployments. You can get service health and communications data for any tenants in Microsoft national clouds. For details, see [national cloud deployments](/graph/deployments).
+
+|National clouds|API URL (partial)|
+|:--|:--|
+|Microsoft Graph global service| https://graph.microsoft.com/beta/admin/serviceAnnouncement/|
+|Microsoft Graph for US Government L4 (GccHigh)|https://graph.microsoft.us/beta/admin/serviceAnnouncement/|
+|Microsoft Graph for US Government L5 (DoD)|https://dod-graph.microsoft.us/beta/admin/serviceAnnouncement/|
+|Microsoft Graph Germany|https://graph.microsoft.de/beta/admin/serviceAnnouncement/|
+|Microsoft Graph China operated by 21Vianet|https://microsoftgraph.chinacloudapi.cn/beta/admin/serviceAnnouncement/|
+ ## What's new Find out about the [latest new features and updates](/graph/whats-new-overview) for this API set.
The service communications API can open up new ways for you to engage with users
- [Overview for accessing service health and communications in Microsoft Graph](/graph/service-communications-concept-overview) - Try the API in the [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer).
-Need more ideas? See [how some of our partners are using Microsoft Graph](https://developer.microsoft.com/en-us/graph/partners).
+Need more ideas? See [how some of our partners are using Microsoft Graph](https://developer.microsoft.com/en-us/graph/partners).
v1.0 Servicehealth https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/servicehealth.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents the health information of a service.
+Represents the health information of a service subscribed by a tenant.
## Methods |Method|Return type|Description|
Represents the health information of a service.
|Property|Type|Description| |:|:|:| |id|String|The service id.|
-|service|String|The service name.|
+|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`.| ## Relationships
v1.0 Serviceupdatemessage https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/serviceupdatemessage.md
Inherits from [serviceAnnouncementBase](../resources/serviceannouncementbase.md)
|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.| |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.|
+|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.|
## Relationships None.
v1.0 Serviceannouncement List Healthoverviews https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceannouncement-list-healthoverviews.md
+
+ Title: "List healthOverviews"
+description: "Retrieve the serviceHealth resources from the healthOverviews navigation property."
+
+localization_priority: Normal
++
+# List healthOverviews
+Namespace: microsoft.graph
+
+Retrieve the [serviceHealth](../resources/servicehealth.md) resources from the **healthOverviews** navigation property.
+
+This operation provides the health report of all subscribed services for 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)|ServiceHealth.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|ServiceHealth.Read.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/serviceAnnouncement/healthOverviews
+```
+
+## 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 collection of [serviceHealth](../resources/servicehealth.md) objects in the response body.
+
+## Examples
+
+### Example 1: Get serviceHealth resources
+
+#### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "list_healthoverviews"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/healthOverviews
+```
+
+#### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.serviceHealth",
+ "isCollection": true
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#admin/serviceAnnouncement/healthOverviews",
+ "value": [
+ {
+ "service": "Exchange Online",
+ "status": "ServicaOperational",
+ "id": "Exchange"
+ },
+ {
+ "service": "Identity Service",
+ "status": "ServiceRestored",
+ "id": "OrgLiveID"
+ },
+ {
+ "service": "Microsoft 365 suite",
+ "status": "ServiceOperational",
+ "id": "OSDPPlatform"
+ }
+ ]
+}
+```
+
+### Example 2: Include navigation property issues
+
+#### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "list_healthoverviews_with_issues"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/healthOverviews?$expand=issues
+```
+
+#### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.serviceHealth",
+ "isCollection": true
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#admin/serviceAnnouncement/healthOverviews(issues())",
+ "value": [
+ {
+ "service": "Exchange Online",
+ "status": "ServiceOperational",
+ "id": "Exchange",
+ "issues": [
+ {
+ "startDateTime": "2020-11-04T00:00:00Z",
+ "endDateTime": "2020-11-20T17:00:00Z",
+ "lastModifiedDateTime": "2020-11-20T17:56:31.39Z",
+ "title": "Admins are unable to migrate some user mailboxes from IMAP using the Exchange admin center or PowerShell",
+ "id": "EX226574",
+ "impactDescription": "Admins attempting to migrate some user mailboxes using the Exchange admin center or PowerShell experienced failures.",
+ "classification": "Advisory",
+ "origin": "Microsoft",
+ "status": "ServiceRestored",
+ "service": "Exchange Online",
+ "feature": "Tenant Administration (Provisioning, Remote PowerShell)",
+ "featureGroup": "Management and Provisioning",
+ "isResolved": true,
+ "details": [],
+ "posts": [
+ {
+ "createdDateTime": "2020-11-12T07:07:38.97Z",
+ "postType": "Regular",
+ "description": {
+ "contentType": "Text",
+ "content": "Title: Exchange Online service has login issue. We'll provide an update within 30 minutes."
+ }
+ }
+ ]
+ }
+ ]
+ }
+ ]
+}
+```
v1.0 Serviceannouncement List Issues https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceannouncement-list-issues.md
+
+ Title: "List issues"
+description: "Retrieve the serviceHealthIssue resources from the issues navigation property."
+
+localization_priority: Normal
++
+# List issues
+Namespace: microsoft.graph
+
+Retrieve [serviceHealthIssue](../resources/servicehealthissue.md) resources from the **issues** navigation property.
+
+This operation retrieves information about all service health issues that exist for the tenant.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|ServiceHealth.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|ServiceHealth.Read.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/serviceAnnouncement/issues
+```
+
+## 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 collection of [serviceHealthIssue](../resources/servicehealthissue.md) objects in the response body.
+
+## Example
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "list_servicehealthissue"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/issues
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.serviceHealthIssue",
+ "isCollection": true
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#admin/serviceAnnouncement/issues",
+ "value": [
+ {
+ "startDateTime": "2020-11-13T21:00:00Z",
+ "endDateTime": "2020-11-14T17:15:00Z",
+ "lastModifiedDateTime": "2020-11-14T18:20:24.767Z",
+ "title": "Limited number of users unable to send or receive email through the Exchange Online service",
+ "id": "EX226792",
+ "impactDescription": "Users may have been unable to send or receive email through the Exchange Online service.",
+ "classification": "Incident",
+ "origin": "Microsoft",
+ "status": "ServiceRestored",
+ "service": "Exchange Online",
+ "feature": "Mailflow - delayed delivery from Internet",
+ "featureGroup": "E-Mail timely delivery",
+ "isResolved": true,
+ "details": [
+ {
+ "name": "NotifyInApp",
+ "value": "True"
+ }
+ ],
+ "posts": [
+ {
+ "createdDateTime": "2020-11-12T07:07:38.97Z",
+ "postType": "Regular",
+ "description": {
+ "contentType": "Text",
+ "content": "Title: Limited number of users unable to send or receive email through the Exchange Online service\n\nUser Impact: Users may be unable to send or receive email through the Exchange Online service."
+ }
+ }
+ ]
+ }
+ ]
+}
+```
+
v1.0 Serviceannouncement List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceannouncement-list-messages.md
+
+ Title: "List serviceAnnouncement messages"
+description: "Retrieve the serviceUpdateMessage resources from the messages navigation property."
+
+localization_priority: Normal
++
+# List serviceAnnouncement messages
+Namespace: microsoft.graph
+
+Retrieve the [serviceUpdateMessage](../resources/serviceupdatemessage.md) resources from the **messages** navigation property.
+
+This operation retrieves all service update messages that exist for the tenant.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|ServiceMessage.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|ServiceMessage.Read.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/serviceAnnouncement/messages
+```
+
+## 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 collection of [serviceUpdateMessage](../resources/serviceupdatemessage.md) objects in the response body.
+
+## Example
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "list_serviceupdatemessage"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/messages
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.serviceUpdateMessage",
+ "isCollection": true
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#admin/serviceAnnouncement/messages",
+ "value": [
+ {
+ "startDateTime": "2019-02-01T18:51:00Z",
+ "endDateTime": "2019-06-01T08:00:00Z",
+ "lastModifiedDateTime": "2021-01-08T01:10:06.843Z",
+ "title": "(Updated) New feature: Changes to PowerPoint and Word to open files faster",
+ "id": "MC172851",
+ "category": "StayInformed",
+ "severity": "Normal",
+ "tags": [
+ "Updated message"
+ ],
+ "isMajorChange": true,
+ "actionRequiredByDateTime": null,
+ "services": [
+ "SharePoint Online",
+ "OneDrive for Business"
+ ],
+ "details": [
+ {
+ "name": "ExternalLink",
+ "value": "https://support.office.com/article/office-document-cache-settings-4b497318-ae4f-4a99-be42-b242b2e8b692"
+ }
+ ],
+ "body": {
+ "contentType": "Text",
+ "content": "Updated January 07, 2021: Based on learnings from our early rings, we have made the decision to make additional changes to the code before we proceed with the rollout. We will update the Message center post once we re-start the rollout......"
+ },
+ "viewPoint": null
+ }
+ ]
+}
+```
+
v1.0 Servicehealth Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/servicehealth-get.md
+
+ Title: "Get serviceHealth"
+description: "Retrieve the properties and relationships of a serviceHealth object."
+
+localization_priority: Normal
++
+# Get serviceHealth
+Namespace: microsoft.graph
+
+Retrieve the properties and relationships of a [serviceHealth](../resources/servicehealth.md) object.
+
+This operation provides the health information of a specified service for 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)|ServiceHealth.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|ServiceHealth.Read.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+GET /admin/serviceAnnouncement/healthOverviews/{ServiceName}
+```
+
+## 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 [serviceHealth](../resources/servicehealth.md) object in the response body.
+
+## Examples
+
+### Example 1: Get the properties of a serviceHealth object
+
+#### Request
+
+<!-- {
+ "blockType": "request",
+ "sampleKeys": ["Microsoft 365 suite"],
+ "name": "get_servicehealth"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/healthOverviews/Microsoft 365 suite
+```
+
+#### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.serviceHealth"
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#admin/serviceAnnouncement/healthOverviews/$entity",
+ "service": "Microsoft 365 suite",
+ "status": "RestoringService",
+ "id": "OSDPPlatform"
+}
+```
+
+### Example 2: Include navigation property issues
+
+#### Request
+
+<!-- {
+ "blockType": "request",
+ "sampleKeys": ["Microsoft 365 suite"],
+ "name": "get_servicehealth_with_issues"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/healthOverviews/Microsoft 365 suite?$expand=issues
+```
+
+#### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.serviceHealth"
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#admin/serviceAnnouncement/healthOverviews(issues())/$entity",
+ "service": "Microsoft 365 suite",
+ "status": "ServiceOperational",
+ "id": "OSDPPlatform",
+ "issues": [
+ {
+ "startDateTime": "2020-11-04T00:00:00Z",
+ "endDateTime": "2020-11-20T17:00:00Z",
+ "lastModifiedDateTime": "2020-11-20T17:56:31.39Z",
+ "title": "Intermittently unable to access some Microsoft 365 services",
+ "id": "MO226574",
+ "impactDescription": "Users may have been intermittently unable to access some Microsoft 365 services.",
+ "classification": "Advisory",
+ "origin": "Microsoft",
+ "status": "ServiceRestored",
+ "service": "Exchange Online",
+ "feature": "Tenant Administration (Provisioning, Remote PowerShell)",
+ "featureGroup": "Management and Provisioning",
+ "isResolved": true,
+ "details": [],
+ "posts": [
+ {
+ "createdDateTime": "2020-11-12T07:07:38.97Z",
+ "postType": "Regular",
+ "description": {
+ "contentType": "Text",
+ "content": "Users may have been intermittently unable to access some Microsoft 365 services. We'll provide an update within 30 minutes."
+ }
+ }
+ ]
+ }
+ ]
+}
+```
v1.0 Servicehealthissue Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/servicehealthissue-get.md
+
+ Title: "Get serviceHealthIssue"
+description: "Retrieve the properties and relationships of a serviceHealthIssue object."
+
+localization_priority: Normal
++
+# Get serviceHealthIssue
+Namespace: microsoft.graph
+
+Retrieve the properties and relationships of a [serviceHealthIssue](../resources/servicehealthissue.md) object.
+
+This operation retrieves a specified service health issue for tenant. The operation returns an error if the issue does not exist for the tenant.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|ServiceHealth.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|ServiceHealth.Read.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/serviceAnnouncement/issues/{serviceHealthIssueId}
+```
+
+## 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 [serviceHealthIssue](../resources/servicehealthissue.md) object in the response body.
+
+## Example
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "sampleKeys": ["MO226784"],
+ "name": "get_servicehealthissue"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/issues/MO226784
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.serviceHealthIssue"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#admin/serviceAnnouncement/issues/$entity",
+ "startDateTime": "2020-11-14T08:15:00Z",
+ "endDateTime": "2020-11-14T09:45:00Z",
+ "lastModifiedDateTime": "2020-11-14T11:06:53.353Z",
+ "title": "Intermittently unable to access some Microsoft 365 services",
+ "id": "MO226784",
+ "impactDescription": "Users may have been intermittently unable to access some Microsoft 365 services.",
+ "classification": "Advisory",
+ "origin": "Microsoft",
+ "status": "ServiceRestored",
+ "service": "Microsoft 365 suite",
+ "feature": "Access",
+ "featureGroup": "Portal",
+ "isResolved": true,
+ "details": [],
+ "posts": [
+ {
+ "createdDateTime": "2020-11-12T07:07:38.97Z",
+ "postType": "Regular",
+ "description": {
+ "contentType": "Text",
+ "content": "Title: Intermittently unable to invite partners to meetings using some Microsoft 365 services\n\nUser Impact: Users may have been intermittently unable to invite partners to meetings using some Microsoft 365 services."
+ }
+ }
+ ]
+}
+```
+
v1.0 Servicehealthissue Incidentreport https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/servicehealthissue-incidentreport.md
+
+ Title: "serviceHealthIssue: incidentReport"
+description: "Provide the Post-Incident Review (PIR) document of a specified service issue for tenant."
+
+localization_priority: Normal
++
+# serviceHealthIssue: incidentReport
+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.
+
+## Permissions
+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)|ServiceHealth.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|ServiceHealth.Read.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/serviceAnnouncement/issues/{serviceHealthIssueId}/incidentReport
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this function returns a `200 OK` response code and a file stream in the response body.
+
+## Example
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "sampleKeys": ["MO248163"],
+ "name": "servicehealthissue_incidentreport"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/issues/MO248163/incidentReport
+```
+
+### 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
+
+{
+ "value": "Stream"
+}
+```
+
v1.0 Serviceupdatemessage Archive https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceupdatemessage-archive.md
+
+ Title: "serviceUpdateMessage: archive"
+description: "Archive a list of service update messages for the signed in user."
+
+localization_priority: Normal
++
+# serviceUpdateMessage: archive
+Namespace: microsoft.graph
+
+Archive a list of [serviceUpdateMessages](../resources/serviceupdatemessage.md) for the signed in user.
+
+## Permissions
+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)|ServiceMessageViewpoint.Write|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /admin/serviceAnnouncement/messages/archive
+```
+
+## 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|
+|:|:|:|
+|messageIds|String collection|List of message IDs to archive.|
+
+## Response
+
+If successful, this action returns a `200 OK` response code and a Boolean value `true` in the response body. Otherwise, will return `false` in the response body.
+
+## Example
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "serviceupdatemessage_archive"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/messages/archive
+Content-Type: application/json
+
+{
+ "messageIds": ["MC172851", "MC167983"]
+}
+```
+
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "string"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": true
+}
+```
v1.0 Serviceupdatemessage Favorite https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceupdatemessage-favorite.md
+
+ Title: "serviceUpdateMessage: favorite"
+description: "Change the status of a list of service update messages to favorited for the signed in user."
+
+localization_priority: Normal
++
+# serviceUpdateMessage: favorite
+Namespace: microsoft.graph
+
+Change the status of a list of [serviceUpdateMessages](../resources/serviceupdatemessage.md) to favorite for the signed in user.
+
+## Permissions
+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)|ServiceMessageViewpoint.Write|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /admin/serviceAnnouncement/messages/favorite
+```
+
+## 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|
+|:|:|:|
+|messageIds|String collection|List of message IDs to save as favorite.|
+
+## Response
+
+If successful, this action returns a `200 OK` response code and a Boolean value `true` in the response body. Otherwise, will return `false` in the response body.
+
+## Example
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "serviceupdatemessage_favorite"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/messages/favorite
+Content-Type: application/json
+
+{
+ "messageIds": ["MC172851", "MC167983"]
+}
+```
+
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "string"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": true
+}
+```
v1.0 Serviceupdatemessage Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceupdatemessage-get.md
+
+ Title: "Get serviceUpdateMessage"
+description: "Retrieve the properties and relationships of a serviceUpdateMessage object."
+
+localization_priority: Normal
++
+# Get serviceUpdateMessage
+Namespace: microsoft.graph
+
+Retrieve the properties and relationships of a [serviceUpdateMessage](../resources/serviceupdatemessage.md) object.
+
+This operation retrieves a specified service update message for the tenant. The operation returns an error if the message does not exist for the tenant.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|ServiceMessage.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|ServiceMessage.Read.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/serviceAnnouncement/messages/{serviceUpdateMessageId}
+```
+
+## 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 [serviceUpdateMessage](../resources/serviceupdatemessage.md) object in the response body.
+
+## Example
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "sampleKeys": ["MC172851"],
+ "name": "get_serviceupdatemessage"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/messages/MC172851
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.serviceUpdateMessage"
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#admin/serviceAnnouncement/messages/$entity",
+ "startDateTime": "2019-02-01T18:51:00Z",
+ "endDateTime": "2019-06-01T08:00:00Z",
+ "lastModifiedDateTime": "2021-01-08T01:10:06.843Z",
+ "title": "(Updated) New feature: Changes to PowerPoint and Word to open files faster",
+ "id": "MC172851",
+ "category": "StayInformed",
+ "severity": "Normal",
+ "tags": [
+ "Updated message"
+ ],
+ "isMajorChange": true,
+ "actionRequiredByDateTime": null,
+ "services": [
+ "SharePoint Online",
+ "OneDrive for Business"
+ ],
+ "details": [
+ {
+ "name": "ExternalLink",
+ "value": "https://support.office.com/article/office-document-cache-settings-4b497318-ae4f-4a99-be42-b242b2e8b692"
+ }
+ ],
+ "body": {
+ "contentType": "Text",
+ "content": "Updated January 07, 2021: Based on learnings from our early rings, we have made the decision to make additional changes to the code before we proceed with the rollout. We will update the Message center post once we re-start the rollout. Thank you for your patience........"
+ },
+ "viewPoint": null
+}
+```
v1.0 Serviceupdatemessage Markread https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceupdatemessage-markread.md
+
+ Title: "serviceUpdateMessage: markRead"
+description: "Mark a list of service update messages as read for the signed in user."
+
+localization_priority: Normal
++
+# serviceUpdateMessage: markRead
+Namespace: microsoft.graph
+
+Mark a list of [serviceUpdateMessages](../resources/serviceupdatemessage.md) as **read** for the signed in user.
+
+## Permissions
+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)|ServiceMessageViewpoint.Write|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /admin/serviceAnnouncement/messages/markRead
+```
+
+## 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|
+|:|:|:|
+|messageIds|String collection|List of message IDs to mark as read.|
++
+## Response
+
+If successful, this action returns a `200 OK` response code and a Boolean value `true` in the response body. Otherwise, will return `false` in the response body.
+
+## Example
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "serviceupdatemessage_markread"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/messages/markRead
+Content-Type: application/json
+
+{
+ "messageIds": ["MC172851", "MC167983"]
+}
+```
+
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "string"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": true
+}
+```
v1.0 Serviceupdatemessage Markunread https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceupdatemessage-markunread.md
+
+ Title: "serviceUpdateMessage: markUnread"
+description: "Mark a list of service update messages as unread for the signed in user."
+
+localization_priority: Normal
++
+# serviceUpdateMessage: markUnread
+Namespace: microsoft.graph
+
+Mark a list of [serviceUpdateMessages](../resources/serviceupdatemessage.md) as **unread** for the signed in user.
+
+## Permissions
+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)|ServiceMessageViewpoint.Write|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /admin/serviceAnnouncement/messages/markUnread
+```
+
+## 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|
+|:|:|:|
+|messageIds|String collection|List of message IDs to mark as unread.|
+
+## Response
+
+If successful, this action returns a `200 OK` response code and a Boolean value `true` in the response body. Otherwise, will return `false` in the response body.
+
+## Example
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "serviceupdatemessage_markunread"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/messages/markUnread
+Content-Type: application/json
+
+{
+ "messageIds": ["MC172851", "MC167983"]
+}
+```
+
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "string"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": true
+}
+```
v1.0 Serviceupdatemessage Unarchive https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceupdatemessage-unarchive.md
+
+ Title: "serviceUpdateMessage: unarchive"
+description: "Unarchive a list of service update messages for the signed in user."
+
+localization_priority: Normal
++
+# serviceUpdateMessage: unarchive
+Namespace: microsoft.graph
+
+Unarchive a list of [serviceUpdateMessages](../resources/serviceupdatemessage.md) for the signed in user.
+
+## Permissions
+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)|ServiceMessageViewpoint.Write|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /admin/serviceAnnouncement/messages/unarchive
+```
+
+## 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|
+|:|:|:|
+|messageIds|String collection|List of message IDs to unarchive.|
+
+## Response
+
+If successful, this action returns a `200 OK` response code and a Boolean value `true` in the response body. Otherwise, will return `false` in the response body.
+
+## Example
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "serviceupdatemessage_unarchive"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/messages/unarchive
+Content-Type: application/json
+
+{
+ "messageIds": ["MC172851", "MC167983"]
+}
+```
+
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "string"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": true
+}
+```
v1.0 Serviceupdatemessage Unfavorite https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceupdatemessage-unfavorite.md
+
+ Title: "serviceUpdateMessage: unfavorite"
+description: "Remove the favorite status of serviceUpdateMessage for the signed in user."
+
+localization_priority: Normal
++
+# serviceUpdateMessage: unfavorite
+Namespace: microsoft.graph
+
+Remove the favorite status of [serviceUpdateMessages](../resources/serviceupdatemessage.md) for the signed in user.
+
+## Permissions
+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)|ServiceMessageViewpoint.Write|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /admin/serviceAnnouncement/messages/unfavorite
+```
+
+## 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|
+|:|:|:|
+|messageIds|String collection|List of message IDs to remove from favorite.|
+
+## Response
+
+If successful, this action returns a `200 OK` response code and a Boolean value `true` in the response body. Otherwise, will return `false` in the response body.
+
+## Example
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "serviceupdatemessage_unfavorite"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/messages/unfavorite
+Content-Type: application/json
+
+{
+ "messageIds": ["MC172851", "MC167983"]
+}
+```
+
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "string"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": true
+}
+```
v1.0 Enums https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/enums.md
Possible values for user account types (group membership), per Windows definitio
|personalMicrosoftAccountUser| |skypeUser| |phoneUser|
-|unknownFutureValue|
+|unknownFutureValue|
+
+### postType values
+
+|Member|
+|:|
+|regular|
+|quick|
+|strategic|
+|unknownFutureValue|
+
+### serviceHealthClassificationType values
+
+|Member|
+|:|
+|advisory|
+|incident|
+|unknownFutureValue|
+
+### serviceHealthOrigin values
+
+|Member|
+|:|
+|microsoft|
+|thirdParty|
+|customer|
+|unknownFutureValue|
+
+### serviceHealthStatus values
+
+|Member|
+|:|
+|serviceOperational|
+|investigating|
+|restoringService|
+|verifyingService|
+|serviceRestored|
+|postIncidentReviewPublished|
+|serviceDegradation|
+|serviceInterruption|
+|extendedRecovery|
+|falsePositive|
+|investigationSuspended|
+|resolved|
+|mitigatedExternal|
+|mitigated|
+|resolvedExternal|
+|confirmed|
+|reported|
+|unknownFutureValue|
+
+### serviceUpdateCategory values
+
+|Member|
+|:|
+|preventOrFixIssue|
+|planForChange|
+|stayInformed|
+|unknownFutureValue|
+
+### serviceUpdateSeverity values
+
+|Member|
+|:|
+|normal|
+|high|
+|critical|
+|unknownFutureValue|
v1.0 Keycredential https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/keycredential.md
Contains a key credential associated with an application <!--or a service princi
|:|:--|:-| |customKeyIdentifier|Binary| Custom key identifier | | displayName | String | Friendly name for the key. Optional. |
-|endDateTime|DateTimeOffset|The date and time at which the credential expires.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`|
-|keyId|Guid|The unique identifier (GUID) for the key.|
-|startDateTime|DateTimeOffset|The date and time at which the credential becomes valid.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`|
-|type|String|The type of key credential; for example, ΓÇ£SymmetricΓÇ¥.|
-|usage|String|A string that describes the purpose for which the key can be used; for example, ΓÇ£VerifyΓÇ¥.|
+|endDateTime|DateTimeOffset|The date and time at which the credential expires.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.|
|key|Binary| The certificate's raw data in byte array converted to Base64 string; for example, `[System.Convert]::ToBase64String($Cert.GetRawCertData())`. |
+|keyId|Guid|The unique identifier (GUID) for the key.|
+|startDateTime|DateTimeOffset|The date and time at which the credential becomes valid.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.|
+|type|String|The type of key credential; for example, `Symmetric`.|
+|usage|String|A string that describes the purpose for which the key can be used; for example, `Verify`.|
## JSON representation
Here is a JSON representation of the resource
```json {
- "customKeyIdentifier": "binary",
+ "@odata.type": "#microsoft.graph.keyCredential",
+ "customKeyIdentifier": "Binary",
"displayName": "String", "endDateTime": "String (timestamp)",
- "keyId": "guid",
+ "key": "Binary",
+ "keyId": "Guid",
"startDateTime": "String (timestamp)",
- "type": "string",
- "usage": "string",
- "key": "binary"
+ "type": "String",
+ "usage": "String"
}- ``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
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
+
+ Title: "Working with service communications APIs in Microsoft Graph"
+description: You can use the service communications API in Microsoft Graph to access the health status and message center posts about Microsoft services."
+
+localization_priority: Normal
++
+# Working with service communications API in Microsoft Graph
+The service communications API provides service health and message center posts pertaining to the Microsoft cloud services subscribed by your tenant. You can get current and historical health data of a Microsoft service (for example, the Exchange Online service is down). You can check the service health to determine if an issue is tracked and a resolution is in progress before calling support or spending time troubleshooting. Message center posts let you keep track of upcoming changes, including new features, updates, and other important announcements (for example, Exchange Online is getting a new feature).
+
+## Authorization
+Microsoft Graph lets applications get authorized access to health and change communications about a Microsoft cloud service subscribed by a tenant.
+With the appropriate delegated or application [permissions](/graph/permissions-reference#service-communications-permissions), your app can access the communications data on behalf of a signed-in user, or without any signed-in user in the tenant. Both delegated and application types of these permissions are granted by only an administrator.
+
+For more information on access tokens, app registration, and delegated and application permissions, see [Authentication and authorization basics](/graph/auth/auth-concepts).
+
+### Access service communications API on behalf of signed-in user
+
+Delegated permissions are needed to access the service communications API on behalf of a signed-in user. Customer-facing canvas applications, such as the [Microsoft 365 admin center](https://admin.microsoft.com/Adminportal/Home?source=applauncher#/homepage) (accessible only to admin roles), can call the service communications API to get the service health and service announcements data for the signed-in user's tenant, _on behalf of the signed-in user_. Users can find out whether their subscribed servies are healthy or have issues. They can also learn about any current service issues affecting their tenants.
+
+### Access service communications API without user
+
+Application permissions are needed to access the service communications API without a signed-in user. Applications that run as backend services, such as monitoring or alert services, can call the service communications API with their own identity and not on behalf of a user. These backend services can build custom monitoring/alert pipelines and call the service communications API to get service health and service announcements data.
++
+## Common use cases and required permissions
+
+|Use cases|API requests| Required permissions| Supported permission types|
+|:--|:--|:--|:--|
+| List health overviews for tenant | [List healthOverviews](/graph/api/serviceannouncement-list-healthoverviews?view=graph-rest-1.0&preserve-view=true) | _ServiceHealth.Read.All_ | Delegated and application |
+| Get specific service health information for tenant | [Get serviceHealth](/graph/api/servicehealth-get?view=graph-rest-1.0&preserve-view=true) | _ServiceHealth.Read.All_ | Delegated and application |
+| List all service issues for tenant | [List issues](/graph/api/serviceannouncement-list-issues?view=graph-rest-1.0&preserve-view=true) | _ServiceHealth.Read.All_ | Delegated and application |
+| Get a specific service issue for tenant | [Get issue](/graph/api/servicehealthissue-get?view=graph-rest-1.0&preserve-view=true) | _ServiceHealth.Read.All_ | Delegated and application |
+| Get a post-incident review report for tenant | [Get incident report](/graph/api/servicehealthissue-incidentreport?view=graph-rest-1.0&preserve-view=true)| _ServiceHealth.Read.All_ | Delegated and application |
+| List all service messages for tenant | [List messages](/graph/api/serviceannouncement-list-messages?view=graph-rest-1.0&preserve-view=true) | _ServiceMessage.Read.All_ | Delegated and application |
+| Get a specific service message for tenant | [Get message](/graph/api/serviceupdatemessage-get?view=graph-rest-1.0&preserve-view=true) | _ServiceMessage.Read.All_ | Delegated and application |
+| Update service message status for signed in user | For a list of status operations, see [serviceUpdateMessage](/graph/api/resources/serviceupdatemessage?view=graph-rest-1.0&preserve-view=true).| _ServiceMessageViewpoint.Write_ | Delegated |
+
+## API on Microsoft Graph national clouds
+Service communications API is available on Microsoft Graph national clouds as well. You could get service health and communications data for your national clouds tenants. More information about [Microsoft Graph national clouds](/graph/deployments).
+
+|National clouds|API url (partial)|
+|:--|:--|
+|Microsoft Graph global service| https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/|
+|Microsoft Graph for US Government L4 (GccHigh)|https://graph.microsoft.us/v1.0/admin/serviceAnnouncement/|
+|Microsoft Graph for US Government L5 (DoD)|https://dod-graph.microsoft.us/v1.0/admin/serviceAnnouncement/|
+|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/|
+
+## What's new
+Find out about the [latest new features and updates](/graph/whats-new-overview) for this API set.
+
+## Next steps
+
+The service communications API can open up new ways for you to engage with users:
+
+- [Overview for accessing service health and communications in Microsoft Graph](/graph/service-communications-concept-overview)
+- Try the API in the [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer).
+
+Need more ideas? See [how some of our partners are using Microsoft Graph](https://developer.microsoft.com/en-us/graph/partners).
v1.0 Serviceannouncement https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/serviceannouncement.md
+
+ Title: "serviceAnnouncement resource type"
+description: "A top-level container for service communications resources"
+
+localization_priority: Normal
++
+# serviceAnnouncement resource type
+
+Namespace: microsoft.graph
+
+A top-level container for service communications resources.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List healthOverviews](../api/serviceannouncement-list-healthoverviews.md)|[serviceHealth](../resources/servicehealth.md) collection|Get the serviceHealth resources from the healthOverviews navigation property.|
+|[List issues](../api/serviceannouncement-list-issues.md)|[serviceHealthIssue](../resources/servicehealthissue.md) collection|Get the serviceHealthIssue resources from the issues navigation property.|
+|[List messages](../api/serviceannouncement-list-messages.md)|[serviceUpdateMessage](../resources/serviceupdatemessage.md) collection|Get the serviceUpdateMessage resources from the messages navigation property.|
+
+## Properties
+None.
+
+## Relationships
+|Property|Type|Description|
+|-|-|-|
+|messages|Collection([serviceUpdateMessage](serviceupdatemessage.md))|A collection of service messages for tenant. This property is a contained navigation property, it is nullable and readonly.|
+|healthOverviews|Collection([serviceHealth](servicehealth.md))|A collection of service health information for tenant. This property is a contained navigation property, it is nullable and readonly.|
+|issues|Collection([serviceHealthIssue](servicehealthissue.md))|A collection of service issues for tenant. This property is a contained navigation property, it is nullable and readonly.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.serviceAnnouncement",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.serviceAnnouncement"
+}
+```
v1.0 Serviceannouncementbase https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/serviceannouncementbase.md
+
+ Title: "serviceAnnouncementBase resource type"
+description: "This is an abstract base type for serviceHealthIssue and serviceUpdateMessage."
+
+localization_priority: Normal
++
+# serviceAnnouncementBase resource type
+
+Namespace: microsoft.graph
+
+This is an abstract base type for [serviceHealthIssue](../resources/servicehealthissue.md) and [serviceUpdateMessage](../resources/serviceupdatemessage.md).
+
+Inherits from [entity](../resources/entity.md).
+
+## Methods
+None.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|details|Collection([keyValuePair](../resources/keyvaluepair.md))|Additional details about service event. This property doesn't support filters.|
+|endDateTime|DateTimeOffset|The end time of the service event.|
+|id|String|The id of the service event.|
+|lastModifiedDateTime|DateTimeOffset|The last modified time of the service event.|
+|startDateTime|DateTimeOffset|The start time of the service event.|
+|title|String|The title of the service event.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.serviceAnnouncementBase",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.serviceAnnouncementBase",
+ "id": "String (identifier)",
+ "startDateTime": "String (timestamp)",
+ "endDateTime": "String (timestamp)",
+ "lastModifiedDateTime": "String (timestamp)",
+ "title": "String",
+ "details": [
+ {
+ "@odata.type": "microsoft.graph.keyValuePair"
+ }
+ ]
+}
+```
v1.0 Servicehealth https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/servicehealth.md
+
+ Title: "serviceHealth resource type"
+description: "Represents the health information of a service."
+
+localization_priority: Normal
++
+# serviceHealth resource type
+
+Namespace: microsoft.graph
+
+Represents the health information of a service subscribed by a tenant.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[Get serviceHealth](../api/servicehealth-get.md)|[serviceHealth](../resources/servicehealth.md)|Retrieve the properties and relationships of a [serviceHealth](../resources/servicehealth.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|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`.|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|issues|Collection([serviceHealthIssue](../resources/servicehealthissue.md))|A collection of issues happened on the service, with detailed information for each issue.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.serviceHealth",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.serviceHealth",
+ "service": "String",
+ "status": "String",
+ "id": "String (identifier)"
+}
+```
+
v1.0 Servicehealthissue https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/servicehealthissue.md
+
+ Title: "serviceHealthIssue resource type"
+description: "Represents a service health issue in a service."
+
+localization_priority: Normal
++
+# serviceHealthIssue resource type
+
+Namespace: microsoft.graph
+
+Represents a service health issue in a service.
+
+The service health issue can be a service incident or service advisory. For example:
+
+* Service incident: "Exchange mailbox service is down".
+* Service advisory: "Users may experience delays in emails reception".
+
+Inherits from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).
+
+## Methods
+|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. |
+
+## 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).|
+|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.|
+|id|String|The id of the service issue. Inherited from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).|
+|impactDescription|String|The description of the service issue impact.|
+|isResolved|Boolean|Indicates whether the issue is resolved.|
+|lastModifiedDateTime|DateTimeOffset|The last modified time of the issue. Inherited from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).|
+|origin|serviceHealthOrigin|Indicates the origin of the service issue. Possible values are: `microsoft`, `thirdParty`, `customer`, `unknownFutureValue`.|
+|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`.|
+|title|String|The title of the service issue. Inherited from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.serviceHealthIssue",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.serviceHealthIssue",
+ "startDateTime": "String (timestamp)",
+ "endDateTime": "String (timestamp)",
+ "lastModifiedDateTime": "String (timestamp)",
+ "title": "String",
+ "details": [
+ {
+ "@odata.type": "microsoft.graph.keyValuePair"
+ }
+ ],
+ "id": "String (identifier)",
+ "impactDescription": "String",
+ "classification": "String",
+ "origin": "String",
+ "posts": [
+ {
+ "@odata.type": "microsoft.graph.serviceHealthIssuePost"
+ }
+ ],
+ "status": "String",
+ "service": "String",
+ "feature": "String",
+ "featureGroup": "String",
+ "isResolved": "Boolean"
+}
+```
+
v1.0 Servicehealthissuepost https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/servicehealthissuepost.md
+
+ Title: "serviceHealthIssuePost resource type"
+description: "Represents a historical post in a service health issue."
+
+localization_priority: Normal
++
+# serviceHealthIssuePost resource type
+
+Namespace: microsoft.graph
+
+Represents a historical post in a [service health issue](../resources/servicehealthissue.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|createdDateTime|DateTimeOffset|The published time of the post.|
+|description|[itemBody](../resources/itembody.md)|The content of the service issue post.|
+|postType|postType|The post type of the service issue historical post. Possible values are: `regular`, `quick`, `strategic`, `unknownFutureValue`.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.serviceHealthIssuePost"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.serviceHealthIssuePost",
+ "createdDateTime": "String (timestamp)",
+ "postType": "String",
+ "description": {
+ "@odata.type": "microsoft.graph.itemBody"
+ }
+}
+```
+
v1.0 Serviceupdatemessage https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/serviceupdatemessage.md
+
+ Title: "serviceUpdateMessage resource type"
+description: "Represents the announcements of changes in a service."
+
+localization_priority: Normal
++
+# serviceUpdateMessage resource type
+
+Namespace: microsoft.graph
+
+Represents the announcements about changes in a service.
+
+Represents announcements such as major updates, new features in a product; for example, the publication of a new Windows feature.
+
+Inherits from [serviceAnnouncementBase](../resources/serviceannouncementbase.md).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[Get serviceUpdateMessage](../api/serviceupdatemessage-get.md)|[serviceUpdateMessage](../resources/serviceupdatemessage.md)|Retrieve the properties and relationships of a [serviceUpdateMessage](../resources/serviceupdatemessage.md) object. |
+|[markRead](../api/serviceupdatemessage-markread.md)|Boolean|Mark a list of [serviceUpdateMessage](../resources/serviceupdatemessage.md)s as **read** for the signed in user.|
+|[markUnread](../api/serviceupdatemessage-markunread.md)|Boolean|Mark a list of [serviceUpdateMessage](../resources/serviceupdatemessage.md)s as **unread** for the signed in user.|
+|[archive](../api/serviceupdatemessage-archive.md)|Boolean|Archive a list of [serviceUpdateMessage](../resources/serviceupdatemessage.md)s for the signed in user.|
+|[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.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|actionRequiredByDateTime|DateTimeOffset|The expected deadline of the action for the 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).|
+|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.|
+|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.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.serviceUpdateMessage",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.serviceUpdateMessage",
+ "startDateTime": "String (timestamp)",
+ "endDateTime": "String (timestamp)",
+ "lastModifiedDateTime": "String (timestamp)",
+ "title": "String",
+ "details": [
+ {
+ "@odata.type": "microsoft.graph.keyValuePair"
+ }
+ ],
+ "id": "String (identifier)",
+ "body": {
+ "@odata.type": "microsoft.graph.itemBody"
+ },
+ "category": "String",
+ "severity": "String",
+ "tags": [
+ "String"
+ ],
+ "isMajorChange": "Boolean",
+ "actionRequiredByDateTime": "String (timestamp)",
+ "services": [
+ "String"
+ ],
+ "viewPoint": {
+ "@odata.type": "microsoft.graph.serviceUpdateMessageViewpoint"
+ }
+}
+```
+
v1.0 Serviceupdatemessageviewpoint https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/serviceupdatemessageviewpoint.md
+
+ Title: "serviceUpdateMessageViewpoint resource type"
+description: Represents user view points data for a serviceUpdateMessage."
+
+localization_priority: Normal
++
+# serviceUpdateMessageViewpoint resource type
+
+Namespace: microsoft.graph
+
+Represents user view points data for a [serviceUpdateMessage](../resources/serviceupdatemessage.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|isArchived|Boolean|Indicates whether the user archived the message.|
+|isFavorited|Boolean|Indicates whether the user marked the message as favorite.|
+|isRead|Boolean|Indicates whether the user read the message.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.serviceUpdateMessageViewpoint"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.serviceUpdateMessageViewpoint",
+ "isRead": "Boolean",
+ "isArchived": "Boolean",
+ "isFavorited": "Boolean"
+}
+```
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: api/intune-tem-telecomexpensemanagementpartner-delete.md - name: Update href: api/intune-tem-telecomexpensemanagementpartner-update.md
+ - name: Service health and communications
+ items:
+ - name: Overview
+ href: resources/service-communications-api-overview.md
+ - name: Service announcement
+ href: resources/serviceannouncement.md
+ - name: Service health
+ href: resources/servicehealth.md
+ items:
+ - name: List health overviews
+ href: api/serviceannouncement-list-healthoverviews.md
+ - name: Get service health
+ href: api/servicehealth-get.md
+ - name: Service health issue
+ href: resources/servicehealthissue.md
+ items:
+ - name: List issues
+ href: api/serviceannouncement-list-issues.md
+ - name: Get issue
+ href: api/servicehealthissue-get.md
+ - name: Get post-incident review report
+ href: api/servicehealthissue-incidentreport.md
+ - name: Service update message
+ href: resources/serviceupdatemessage.md
+ items:
+ - name: List messages
+ href: api/serviceannouncement-list-messages.md
+ - name: Get message
+ href: api/serviceupdatemessage-get.md
+ - name: Mark read status
+ href: api/serviceupdatemessage-markread.md
+ - name: Mark unread status
+ href: api/serviceupdatemessage-markunread.md
+ - name: Archive status
+ href: api/serviceupdatemessage-archive.md
+ - name: Unarchive status
+ href: api/serviceupdatemessage-unarchive.md
+ - name: Mark favorite status
+ href: api/serviceupdatemessage-favorite.md
+ - name: Remove favorite status
+ href: api/serviceupdatemessage-unfavorite.md
- name: Education items: - name: Overview