Freigeben über


Availability Statuses - Get By Resource

Ruft die aktuelle Verfügbarkeit status für eine einzelne Ressource ab.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
resourceUri
path True

string

Die vollständig qualifizierte ID der Ressource, einschließlich des Ressourcennamens und des Ressourcentyps. Derzeit unterstützt die API nicht geschachtelte ressourcentypen und eine Schachtelungsebene: /subscriptions/{subscriptionId}/resourceGroups/{resource-group-name}/providers/{resource-provider-name}/{resource-type}/{resource-name} und /subscriptions/{resourceId}/resourceGroups/{resourceGroupName}/providers/{resource-provider-name}/{parentResourceType}/{parentResourceName}/{resourceType}/{resourceType}/{resourceName}

api-version
query True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

$expand
query

string

Durch Festlegen von $expand=recommendedactions in der URL-Abfrage werden die empfohlenen Aktionen in der Antwort erweitert.

$filter
query

string

Der Filter, der auf den Vorgang angewendet werden soll. Weitere Informationen finden Sie unter https://docs.microsoft.com/en-us/rest/api/apimanagement/apis?redirectedfrom=MSDN

Antworten

Name Typ Beschreibung
200 OK

availabilityStatus

Die aktuelle Verfügbarkeit status für eine einzelne Ressource

Other Status Codes

ErrorResponse

DefaultErrorResponse

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

GetCurrentHealthByResource

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
AvailabilityStateValues

Die betroffenen Ressourcen status der Ressource.

availabilityStatus

availabilityStatus einer Ressource.

ErrorResponse

Fehlerdetails.

IncidentProperties

Eigenschaften des dienstbeeinflussenden Ereignisses.

Properties

Eigenschaften des Verfügbarkeitszustands.

reasonChronicityTypes

Chronizität des Verfügbarkeitsübergangs.

RecentlyResolved

Eine Anmerkung, die eine Änderung von availabilityState in Available from Unavailable with a reasonType vom Typ Unplanned beschreibt.

recommendedAction

Listen Aktionen, die der Benutzer basierend auf dem aktuellen availabilityState der Ressource ausführen kann.

serviceImpactingEvent

Listen den Dienst, der Sich auf Ereignisse auswirkt, die sich möglicherweise auf die Integrität der Ressource auswirken.

Status

Status des Diensts, der sich auf das Ereignis auswirkt.

AvailabilityStateValues

Die betroffenen Ressourcen status der Ressource.

Name Typ Beschreibung
Available

string

Degraded

string

Unavailable

string

Unknown

string

availabilityStatus

availabilityStatus einer Ressource.

Name Typ Beschreibung
id

string

Azure Resource Manager Identity für die Ressource availabilityStatuses.

location

string

Azure Resource Manager geografischen Standort der Ressource.

name

string

Aktuellen.

properties

Properties

Eigenschaften des Verfügbarkeitszustands.

type

string

Microsoft.ResourceHealth/AvailabilityStatuses.

ErrorResponse

Fehlerdetails.

Name Typ Beschreibung
code

string

Der Fehlercode.

details

string

Die Fehlerdetails.

message

string

Die Fehlermeldung.

IncidentProperties

Eigenschaften des dienstbeeinflussenden Ereignisses.

Name Typ Beschreibung
incidentType

string

Ereignistyp.

region

string

Region, die vom Ereignis betroffen ist.

service

string

Dienst, der vom Ereignis betroffen ist.

title

string

Titel des Vorfalls.

Properties

Eigenschaften des Verfügbarkeitszustands.

Name Typ Beschreibung
articleId

string

Artikel-ID

availabilityState

AvailabilityStateValues

Verfügbarkeit status der Ressource. Wenn es NULL ist, stellt dieses availabilityStatus-Objekt ein Verfügbarkeitsereignis dar, das sich auf die Verfügbarkeit auswirkt.

category

string

Wenn ein Kontextfeld auf Plattform festgelegt ist, gibt dieses Feld an, ob das Ereignis geplant oder ungeplant war. Wenn das Kontextfeld keinen Wert von Platform aufweist, wird dieses Feld ignoriert.

context

string

Wenn ein Ereignis erstellt wird, kann es entweder von einem Kunden oder von der Plattform der Ressource ausgelöst werden, und dieses Feld veranschaulicht dies. Dieses Feld ist mit dem Kategoriefeld in diesem Objekt verbunden.

detailedStatus

string

Details zur Verfügbarkeit status.

healthEventCategory

string

Im Falle eines Verfügbarkeitsereignisses, das sich auf die Verfügbarkeit auswirkt, wird die Kategorie eines PlatformInitiated-Integritätsereignisses beschrieben. Beispiele sind Geplant, Ungeplant usw.

healthEventCause

string

Im Fall eines Verfügbarkeitsereignisses, das sich auf die Verfügbarkeit auswirkt, wird beschrieben, wo das Ereignis entstanden ist, das sich auf die Integrität auswirkt. Beispiele sind PlatformInitiated, UserInitiated usw.

healthEventId

string

Es handelt sich um eine eindeutige ID, die das Ereignis identifiziert.

healthEventType

string

Im Fall eines Verfügbarkeitsereignisses, das sich auf die Verfügbarkeit auswirkt, wird beschrieben, wann das Integritätsereignis entstanden ist. Beispiele sind Lebenszyklus, Downtime, Fehleranalyse usw.

occuredTime

string

Zeitstempel für den Zeitpunkt, an dem die letzte Änderung der Integrität status aufgetreten ist.

reasonChronicity

reasonChronicityTypes

Chronizität des Verfügbarkeitsübergangs.

reasonType

string

Wenn "availabilityState" der Ressource nicht verfügbar ist, wird beschrieben, wo das ereignis mit Auswirkungen auf die Integrität entstanden ist. Beispiele sind geplante, ungeplante, vom Benutzer initiierte oder ein Ausfall usw.

recentlyResolved

RecentlyResolved

Eine Anmerkung, die eine Änderung von availabilityState in Available from Unavailable with a reasonType vom Typ Unplanned beschreibt.

recommendedActions

recommendedAction[]

Listen Aktionen, die der Benutzer basierend auf dem aktuellen availabilityState der Ressource ausführen kann.

reportedTime

string

Zeitstempel für den Zeitpunkt, an dem die Integrität zuletzt überprüft wurde.

resolutionETA

string

Wenn der availabilityState der Ressource nicht verfügbar ist und der reasonType nicht vom Benutzer initiiert ist, gibt er das Datum und die Uhrzeit an, zu dem das Problem voraussichtlich behoben werden soll.

rootCauseAttributionTime

string

Wenn der availabilityState der Ressource nicht verfügbar ist, stellt er den Zeitstempel für den Zeitpunkt bereit, zu dem das Ereignis empfangen wurde, das sich auf die Integrität auswirkt.

serviceImpactingEvents

serviceImpactingEvent[]

Listen den Dienst, der Sich auf Ereignisse auswirkt, die sich möglicherweise auf die Integrität der Ressource auswirken.

summary

string

Zusammenfassende Beschreibung der Verfügbarkeit status.

title

string

Titelbeschreibung der Verfügbarkeit status.

reasonChronicityTypes

Chronizität des Verfügbarkeitsübergangs.

Name Typ Beschreibung
Persistent

string

Transient

string

RecentlyResolved

Eine Anmerkung, die eine Änderung von availabilityState in Available from Unavailable with a reasonType vom Typ Unplanned beschreibt.

Name Typ Beschreibung
resolvedTime

string

Zeitstempel, wenn sich availabilityState in Available ändert.

unavailableOccuredTime

string

Zeitstempel für den Zeitpunkt der Änderung des AvailabilityState in Nicht verfügbar

unavailableSummary

string

Kurze Beschreibung der Ursache für die Nichtverfügbarkeit der Ressource.

recommendedAction

Listen Aktionen, die der Benutzer basierend auf dem aktuellen availabilityState der Ressource ausführen kann.

Name Typ Beschreibung
_ActionUrl.Comment

string

der Kommentar für die Aktion

action

string

Empfohlene Aktion.

actionUrl

string

Link zur Aktion

actionUrlText

string

Die Teilzeichenfolge der Aktion beschreibt, welcher Text die Aktions-URL hosten soll.

serviceImpactingEvent

Listen den Dienst, der Sich auf Ereignisse auswirkt, die sich möglicherweise auf die Integrität der Ressource auswirken.

Name Typ Beschreibung
correlationId

string

Korrelations-ID für das Ereignis

eventStartTime

string

Zeitstempel für den Zeitpunkt, zu dem das Ereignis gestartet wurde.

eventStatusLastModifiedTime

string

Zeitstempel für den Zeitpunkt, an dem das Ereignis übermittelt/erkannt wurde.

incidentProperties

IncidentProperties

Eigenschaften des dienstbeeinflussenden Ereignisses.

status

Status

Status des Diensts, der sich auf das Ereignis auswirkt.

Status

Status des Diensts, der sich auf das Ereignis auswirkt.

Name Typ Beschreibung
value

string

Aktuelle status des Ereignisses