Availability Statuses - List By Subscription Id

Lists the current availability status for all the resources in the subscription. Use the nextLink property in the response to get the next page of availability statuses.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.ResourceHealth/availabilityStatuses?api-version=2015-01-01
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.ResourceHealth/availabilityStatuses?api-version=2015-01-01&$filter={$filter}&$expand={$expand}

URI Parameters

Name In Required Type Description
subscriptionId
path True
  • string

Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call.

api-version
query True
  • string

Client Api Version.

$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

$expand
query
  • string

Setting $expand=recommendedactions in url query expands the recommendedactions in the response.

Responses

Name Type Description
200 OK

The body contains the list of the current availability status for all the resources in the subscription

Other Status Codes

DefaultErrorResponse

Examples

ListHealthBySubscriptionId

Sample Request

GET https://management.azure.com/subscriptions/subscriptionId/providers/Microsoft.ResourceHealth/availabilityStatuses?api-version=2015-01-01&$expand=recommendedactions

Sample Response

{
  "value": [
    {
      "id": "/providers/Microsoft.ResourceHealth/AvailabilityStatueses/current",
      "name": "current",
      "type": "Microsoft.ResourceHealth/AvailabilityStatuses",
      "location": "eastus",
      "properties": {
        "availabilityState": "Available",
        "summary": "Vm is available",
        "reasonType": "Unplanned",
        "reasonChronicity": "Persistent",
        "detailedStatus": "We have not seen any issues with your virtual machine",
        "occuredTime": "2016-03-29T09:12:00Z",
        "reportedTime": "2016-05-04T14:11:29.7598931Z",
        "RecentlyResolved": {
          "UnavailableOccuredTime": "2017-02-28T00:48:00Z",
          "ResolvedTime": "2017-02-28T00:49:00Z",
          "UnavailableSummary": "We are sorry your SQL database is unavailable"
        },
        "RecommendedActions": [
          {
            "Action": "To start this virtualmachine, open the resource blade and click Start",
            "ActionUrl": "<#resourceblade>",
            "ActionUrlText": "resourceblade"
          }
        ]
      }
    },
    {
      "id": "/providers/Microsoft.ResourceHealth/AvailabilityStatueses/current",
      "name": "current",
      "type": "Microsoft.ResourceHealth/AvailabilityStatuses",
      "location": "eastus",
      "properties": {
        "availabilityState": "Unavailable",
        "summary": "We are sorry, we couldn't automatically recovery our virtualmachine",
        "reasonType": "Unplanned",
        "reasonChronicity": "Persistent",
        "detailedStatus": "Diskproblemsarepreventingusfromautomaticallyrecoveringyourvirtualmachine",
        "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 virtualmachine, open the resource blade",
            "ActionUrl": "<#resourceblade>",
            "ActionUrlText": "resourceblade"
          },
          {
            "Action": "If you are experiencing problems you believe are caused by Azure, contact support",
            "ActionUrl": "<#supportcase>",
            "ActionUrlText": "contactsupport"
          }
        ]
      }
    }
  ],
  "nextLink": "{originalRequestUrl}?$skipToken={OpaquePageNumber}"
}

Definitions

AvailabilityStateValues

Availability status of the resource.

availabilityStatus

availabilityStatus of a resource.

availabilityStatusListResult

The List availabilityStatus operation response.

ErrorResponse

Error details.

IncidentProperties

Properties of the service impacting event.

Properties

Properties of availability state.

reasonChronicityTypes

Chronicity of the availability transition.

RecentlyResolvedState

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

Availability status of the resource.

Name Type Description
Available
  • string
Unavailable
  • string
Unknown
  • string

availabilityStatus

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 of availability state.

type
  • string

Microsoft.ResourceHealth/AvailabilityStatuses.

availabilityStatusListResult

The List availabilityStatus operation response.

Name Type Description
nextLink
  • string

The URI to fetch the next page of availabilityStatuses. Call ListNext() with this URI to fetch the next page of availabilityStatuses.

value

The list of availabilityStatuses.

ErrorResponse

Error details.

Name Type Description
code
  • string

The error code.

details
  • string

The error details.

message
  • string

The error message.

IncidentProperties

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

Properties of availability state.

Name Type Description
availabilityState

Availability status of the resource.

detailedStatus
  • string

Details of the availability status.

occuredTime
  • string

Timestamp for when last change in health status occurred.

reasonChronicity

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.

recentlyResolvedState

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

recommendedActions

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

reportedTime
  • string

Timestamp for when the health was last checked.

resolutionETA
  • string

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

When the resource's availabilityState is Unavailable, it provides the Timestamp for when the health impacting event was received.

serviceImpactingEvents

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

summary
  • string

Summary description of the availability state.

reasonChronicityTypes

Chronicity of the availability transition.

Name Type Description
Persistent
  • string
Transient
  • string

RecentlyResolvedState

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

Name Type Description
resolvedTime
  • string

Timestamp when the availabilityState changes to Available.

unavailabilitySummary
  • string

Brief description of cause of the resource becoming unavailable.

unavailableOccurredTime
  • string

Timestamp for when the availabilityState changed to Unavailable

recommendedAction

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

Name Type Description
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

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

Timestamp for when the event started.

eventStatusLastModifiedTime
  • string

Timestamp for when event was submitted/detected.

incidentProperties

Properties of the service impacting event.

status

Status of the service impacting event.

Status

Status of the service impacting event.

Name Type Description
value
  • string

Current status of the event