Availability Statuses - Get By Resource

Referencia

Servicio:: Resource Health

Versión de la API:: 2024-02-01

Obtiene el estado de disponibilidad actual de un único recurso.

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

Con parámetros opcionales:

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceUri	path	True	string	Identificador completo del recurso, incluido el nombre del recurso y el tipo de recurso. Actualmente, la API no admite tipos de recursos anidados y de nivel de anidamiento: /subscriptions/{subscriptionId}/resourceGroups/{resource-group-name}/providers/{resource-provider-name}/{resource-type}/{resource-name}/{resource-name} y /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resource-provider-name}/{parentResourceType}/{parentResourceName}/{resourceType}/{resourceName}
api-version	query	True	string	Versión de API que se usará para la operación.
$expand	query		string	Al establecer $expand=recommendedactions en la consulta url, se expanden las acciones recomendadas en la respuesta.
$filter	query		string	Filtro que se va a aplicar en la operación. Para obtener más información, consulte https://docs.microsoft.com/en-us/rest/api/apimanagement/apis?redirectedfrom=MSDN

Respuestas

Nombre	Tipo	Description
200 OK	availabilityStatus	Estado de disponibilidad actual de un único recurso
Other Status Codes	ErrorResponse	DefaultErrorResponse

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

GetCurrentHealthByResource

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

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"
      }
    ]
  }
}

Definiciones

Nombre	Description
AvailabilityStateValues	Estado de recurso afectado del recurso.
availabilityStatus	availabilityStatus de un recurso.
ErrorResponse	Detalles del error.
IncidentProperties	Propiedades del evento que afecta al servicio.
Properties	Propiedades del estado de disponibilidad.
reasonChronicityTypes	Cronicidad de la transición de disponibilidad.
RecentlyResolved	Anotación que describe un cambio en availabilityState a Available from Unavailable with a reasonType of type Unplanned
recommendedAction	Listas acciones que el usuario puede realizar en función del valor availabilityState actual del recurso.
serviceImpactingEvent	Listas el servicio que afecta a eventos que pueden afectar al estado del recurso.
Status	Estado del evento que afecta al servicio.

AvailabilityStateValues

Estado de recurso afectado del recurso.

Nombre	Tipo	Description
Available	string
Degraded	string
Unavailable	string
Unknown	string

availabilityStatus

availabilityStatus de un recurso.

Nombre	Tipo	Description
id	string	Azure Resource Manager Identity para el recurso availabilityStatuses.
location	string	Azure Resource Manager ubicación geográfica del recurso.
name	string	Actual.
properties	Properties	Propiedades del estado de disponibilidad.
type	string	Microsoft.ResourceHealth/AvailabilityStatuses.

ErrorResponse

Detalles del error.

Nombre	Tipo	Description
code	string	Código de error.
details	string	Los detalles del error.
message	string	El mensaje de error.

IncidentProperties

Propiedades del evento que afecta al servicio.

Nombre	Tipo	Description
incidentType	string	Tipo de evento.
region	string	Región afectada por el evento.
service	string	Servicio afectado por el evento.
title	string	Título del incidente.

Properties

Propiedades del estado de disponibilidad.

Nombre	Tipo	Description
articleId	string	Identificador del artículo
availabilityState	AvailabilityStateValues	Estado de disponibilidad del recurso. Cuando es null, este objeto availabilityStatus representa un evento que afecta a la disponibilidad.
category	string	Cuando un campo de contexto se establece en Plataforma, este campo reflejará si el evento estaba planeado o no planeado. Si el campo de contexto no tiene un valor de Platform, este campo se omitirá.
context	string	Cuando se crea un evento, un cliente o la plataforma del recurso pueden desencadenarlo y este campo lo ilustrará. Este campo está conectado al campo de categoría de este objeto.
detailedStatus	string	Detalles del estado de disponibilidad.
healthEventCategory	string	En el caso de un evento que afecta a la disponibilidad, describe la categoría de un evento de impacto en el estado platformInitiated. Algunos ejemplos son Planeado, No planeado, etc.
healthEventCause	string	En el caso de un evento que afecta a la disponibilidad, describe dónde se originó el evento que afecta al estado. Algunos ejemplos son PlatformInitiated, UserInitiated, etc.
healthEventId	string	Es un identificador único que identifica el evento.
healthEventType	string	En el caso de un evento que afecta a la disponibilidad, se describe cuándo se originó el evento que afecta al estado. Algunos ejemplos son ciclo de vida, tiempo de inactividad, análisis de errores, etc.
occuredTime	string	Marca de tiempo para cuando se produjo el último cambio en el estado de mantenimiento.
reasonChronicity	reasonChronicityTypes	Cronicidad de la transición de disponibilidad.
reasonType	string	Cuando availabilityState del recurso no está disponible, describe dónde se originó el evento que afecta al estado. Algunos ejemplos son planeados, no planeados, iniciados por el usuario o por una interrupción, etc.
recentlyResolved	RecentlyResolved	Anotación que describe un cambio en availabilityState a Available from Unavailable with a reasonType of type Unplanned
recommendedActions	recommendedAction[]	Listas acciones que el usuario puede realizar en función del valor availabilityState actual del recurso.
reportedTime	string	Marca de tiempo para cuándo se ha comprobado por última vez el estado.
resolutionETA	string	Cuando availabilityState del recurso no está disponible y reasonType no es Iniciado por el usuario, proporciona la fecha y hora para cuando se espera que se resuelva el problema.
rootCauseAttributionTime	string	Cuando availabilityState del recurso no está disponible, proporciona la marca de tiempo para cuando se recibió el evento que afecta al estado.
serviceImpactingEvents	serviceImpactingEvent[]	Listas el servicio que afecta a eventos que pueden afectar al estado del recurso.
summary	string	Descripción resumida del estado de disponibilidad.
title	string	Descripción del título del estado de disponibilidad.

reasonChronicityTypes

Cronicidad de la transición de disponibilidad.

Nombre	Tipo	Description
Persistent	string
Transient	string

RecentlyResolved

Anotación que describe un cambio en availabilityState a Available from Unavailable with a reasonType of type Unplanned

Nombre	Tipo	Description
resolvedTime	string	Marca de tiempo cuando availabilityState cambia a Disponible.
unavailableOccuredTime	string	Marca de tiempo para cuando availabilityState cambió a No disponible
unavailableSummary	string	Breve descripción de la causa de que el recurso no esté disponible.

recommendedAction

Listas acciones que el usuario puede realizar en función del valor availabilityState actual del recurso.

Nombre	Tipo	Description
_ActionUrl.Comment	string	el comentario de la acción
action	string	Acción recomendada.
actionUrl	string	Vínculo a la acción
actionUrlText	string	Subcadena de acción, describe qué texto debe hospedar la dirección URL de la acción.

serviceImpactingEvent

Listas el servicio que afecta a eventos que pueden afectar al estado del recurso.

Nombre	Tipo	Description
correlationId	string	Id. de correlación para el evento
eventStartTime	string	Marca de tiempo para cuando se inició el evento.
eventStatusLastModifiedTime	string	Marca de tiempo para cuándo se envió o detectó el evento.
incidentProperties	IncidentProperties	Propiedades del evento que afecta al servicio.
status	Status	Estado del evento que afecta al servicio.

Status

Estado del evento que afecta al servicio.

Nombre	Tipo	Description
value	string	Estado actual del evento

Compartir a través de