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 |
---|---|---|---|---|
resource
|
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 |
Die aktuelle Verfügbarkeit status für eine einzelne Ressource |
|
Other Status Codes |
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 |
---|---|
Availability |
Die betroffenen Ressourcen status der Ressource. |
availability |
availabilityStatus einer Ressource. |
Error |
Fehlerdetails. |
Incident |
Eigenschaften des dienstbeeinflussenden Ereignisses. |
Properties |
Eigenschaften des Verfügbarkeitszustands. |
reason |
Chronizität des Verfügbarkeitsübergangs. |
Recently |
Eine Anmerkung, die eine Änderung von availabilityState in Available from Unavailable with a reasonType vom Typ Unplanned beschreibt. |
recommended |
Listen Aktionen, die der Benutzer basierend auf dem aktuellen availabilityState der Ressource ausführen kann. |
service |
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 |
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 |
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 |
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 |
Eine Anmerkung, die eine Änderung von availabilityState in Available from Unavailable with a reasonType vom Typ Unplanned beschreibt. |
|
recommendedActions |
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 |
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 |
Eigenschaften des dienstbeeinflussenden Ereignisses. |
|
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 |