ServiceHealth.Read.All

Allows the app to read your tenant's service health information on behalf of the signed-in user. Health information may include service issues or service health overviews.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the ServiceHealth.Read.All permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	79c261e0-fe76-4144-aad5-bdc68fbe4037	55896846-df78-47a7-aa94-8d3d4442ca7f
DisplayText	Read service health	Read service health
Description	Allows the app to read your tenant's service health information, without a signed-in user. Health information may include service issues or service health overviews.	Allows the app to read your tenant's service health information on behalf of the signed-in user. Health information may include service issues or service health overviews.
AdminConsentRequired	Yes	Yes

Graph Methods

• API [v1.0]
• API [beta]
• PowerShell [v1.0]
• PowerShell [beta]

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	GET /admin/serviceAnnouncement/healthOverviews
	GET /admin/serviceAnnouncement/healthOverviews/{ServiceName}
	GET /admin/serviceAnnouncement/issues
	GET /admin/serviceAnnouncement/issues/{serviceHealthIssueId}
	GET /admin/serviceAnnouncement/issues/{serviceHealthIssueId}/incidentReport

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

• serviceHealth
• serviceHealthIssue

Graph reference: serviceHealth

Property	Type	Description
id	String	The service ID.
service	String	The service name. Use the list healthOverviews operation to get exact string names for services subscribed by the tenant.
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 information, see serviceHealthStatus values.