Availability Statuses - Get By Resource

Service:: Resource Health

API Version:: 2025-05-01

Gets current availability status for a single resource

GET https://management.azure.com/{resourceUri}/providers/Microsoft.ResourceHealth/availabilityStatuses/current?api-version=2025-05-01

With optional parameters:

GET https://management.azure.com/{resourceUri}/providers/Microsoft.ResourceHealth/availabilityStatuses/current?api-version=2025-05-01&$filter={$filter}&$expand={$expand}

URI Parameters

Name	In	Required	Type	Description
resourceUri	path	True	string	The fully qualified ID of the resource, including the resource name and resource type. Currently the API support not nested and one nesting level resource types : /subscriptions/{subscriptionId}/resourceGroups/{resource-group-name}/providers/{resource-provider-name}/{resource-type}/{resource-name} and /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resource-provider-name}/{parentResourceType}/{parentResourceName}/{resourceType}/{resourceName}
api-version	query	True	string minLength: 1	The API version to use for this operation.
$expand	query		string	Setting $expand=recommendedactions in url query expands the recommendedactions in the response.
$filter	query		string	The filter to apply on the operation. For more information please see https://docs.microsoft.com/en-us/rest/api/apimanagement/apis?redirectedfrom=MSDN

Responses

Name	Type	Description
200 OK	availabilityStatus	The current availability status for a single resource
Other Status Codes	ErrorResponse	DefaultErrorResponse

Security

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

GetCurrentHealthByResource

Sample request

HTTP

GET https://management.azure.com/resourceUri/providers/Microsoft.ResourceHealth/availabilityStatuses/current?api-version=2025-05-01&$expand=recommendedactions

Sample response

Status code:: 200

{
  "id": "/subscriptions/4abcdefgh-ijkl-mnop-qrstuvwxyz/resourceGroups/rhctestenv/providers/Microsoft.ClassicCompute/virtualMachines /rhctestenvV1PI/providers/Microsoft.ResourceHealth/availabilityStatuses/current",
  "name": "current",
  "type": "Microsoft.ResourceHealth/AvailabilityStatuses",
  "location": "eastus",
  "properties": {
    "availabilityState": "Unavailable",
    "title": "Unavailable",
    "summary": "We're sorry, we couldn't automatically recover your virtual machine",
    "reasonType": "Unplanned",
    "context": "Platform Initiated",
    "category": "Unplanned",
    "reasonChronicity": "Persistent",
    "detailedStatus": "Disk problems are preventing us from automatically recovering your virtual machine",
    "occuredTime": "2016-03-29T09:12:00Z",
    "reportedTime": "2016-05-04T14:11:29.7598931Z",
    "rootCauseAttributionTime": "2016-03-29T09:13:00Z",
    "resolutionETA": "2016-03-29T09:37:00Z",
    "recommendedActions": [
      {
        "action": "To start this virtual machine, open the resource blade and click Start",
        "actionUrl": "<#ResourceBlade>",
        "actionUrlText": "resource blade"
      },
      {
        "action": "If you are experiencing problems you believe are caused by Azure, contact support",
        "actionUrl": "<#SupportCase>",
        "actionUrlText": "contact support"
      }
    ]
  }
}

Definitions

Name	Description
AvailabilityStateValues	Impacted resource status of the resource.
availabilityStatus	availabilityStatus of a resource.
ErrorResponse	Error details.
IncidentProperties	Properties of the service impacting event.
Properties	Properties of availability state.
reasonChronicityTypes	Chronicity of the availability transition.
RecentlyResolved	An annotation describing a change in the availabilityState to Available from Unavailable with a reasonType of type Unplanned
recommendedAction	Lists actions the user can take based on the current availabilityState of the resource.
serviceImpactingEvent	Lists the service impacting events that may be affecting the health of the resource.
Status	Status of the service impacting event.

AvailabilityStateValues

Enumeration

Impacted resource status of the resource.

Value	Description
Available
Unavailable
Degraded
Unknown

availabilityStatus

Object

availabilityStatus of a resource.

Name	Type	Description
id	string	Azure Resource Manager Identity for the availabilityStatuses resource.
location	string	Azure Resource Manager geo location of the resource.
name	string	current.
properties	Properties	Properties of availability state.
type	string	Microsoft.ResourceHealth/AvailabilityStatuses.

ErrorResponse

Object

Error details.

Name	Type	Description
code	string	The error code.
details	string	The error details.
message	string	The error message.

IncidentProperties

Object

Properties of the service impacting event.

Name	Type	Description
incidentType	string	Type of Event.
region	string	Region impacted by the event.
service	string	Service impacted by the event.
title	string	Title of the incident.

Properties

Object

Properties of availability state.

Name	Type	Description
articleId	string	The Article Id
availabilityState	AvailabilityStateValues	Availability status of the resource. When it is null, this availabilityStatus object represents an availability impacting event
category	string	When a context field is set to Platform, this field will reflect if the event was planned or unplanned. If the context field does not have a value of Platform, then this field will be ignored.
context	string	When an event is created, it can either be triggered by a customer or the platform of the resource and this field will illustrate that. This field is connected to the category field in this object.
detailedStatus	string	Details of the availability status.
healthEventCategory	string	In case of an availability impacting event, it describes the category of a PlatformInitiated health impacting event. Examples are Planned, Unplanned etc.
healthEventCause	string	In case of an availability impacting event, it describes where the health impacting event was originated. Examples are PlatformInitiated, UserInitiated etc.
healthEventId	string	It is a unique Id that identifies the event
healthEventType	string	In case of an availability impacting event, it describes when the health impacting event was originated. Examples are Lifecycle, Downtime, Fault Analysis etc.
occuredTime	string (date-time)	Timestamp for when last change in health status occurred.
reasonChronicity	reasonChronicityTypes	Chronicity of the availability transition.
reasonType	string	When the resource's availabilityState is Unavailable, it describes where the health impacting event was originated. Examples are planned, unplanned, user initiated or an outage etc.
recentlyResolved	RecentlyResolved	An annotation describing a change in the availabilityState to Available from Unavailable with a reasonType of type Unplanned
recommendedActions	recommendedAction[]	Lists actions the user can take based on the current availabilityState of the resource.
reportedTime	string (date-time)	Timestamp for when the health was last checked.
resolutionETA	string (date-time)	When the resource's availabilityState is Unavailable and the reasonType is not User Initiated, it provides the date and time for when the issue is expected to be resolved.
rootCauseAttributionTime	string (date-time)	When the resource's availabilityState is Unavailable, it provides the Timestamp for when the health impacting event was received.
serviceImpactingEvents	serviceImpactingEvent[]	Lists the service impacting events that may be affecting the health of the resource.
summary	string	Summary description of the availability status.
title	string	Title description of the availability status.

reasonChronicityTypes

Enumeration

Chronicity of the availability transition.

Value	Description
Transient
Persistent

RecentlyResolved

Object

An annotation describing a change in the availabilityState to Available from Unavailable with a reasonType of type Unplanned

Name	Type	Description
resolvedTime	string (date-time)	Timestamp when the availabilityState changes to Available.
unavailableOccuredTime	string (date-time)	Timestamp for when the availabilityState changed to Unavailable
unavailableSummary	string	Brief description of cause of the resource becoming unavailable.

recommendedAction

Object

Lists actions the user can take based on the current availabilityState of the resource.

Name	Type	Description
_ActionUrl.Comment	string	the comment for the Action
action	string	Recommended action.
actionUrl	string	Link to the action
actionUrlText	string	Substring of action, it describes which text should host the action URL.

serviceImpactingEvent

Object

Lists the service impacting events that may be affecting the health of the resource.

Name	Type	Description
correlationId	string	Correlation id for the event
eventStartTime	string (date-time)	Timestamp for when the event started.
eventStatusLastModifiedTime	string (date-time)	Timestamp for when event was submitted/detected.
incidentProperties	IncidentProperties	Properties of the service impacting event.
status	Status	Status of the service impacting event.

Status

Object

Status of the service impacting event.

Name	Type	Description
value	string	Current status of the event

Share via

Availability Statuses - Get By Resource

URI Parameters

Responses

Security

azure_auth

Scopes

Examples

GetCurrentHealthByResource

Sample request

Sample response

Definitions

AvailabilityStateValues

availabilityStatus

ErrorResponse

IncidentProperties

Properties

reasonChronicityTypes

RecentlyResolved

recommendedAction

serviceImpactingEvent

Status