Network Status - List By Service

Ruft den Verbindungsstatus an die externen Ressourcen ab, von denen der Api-Verwaltungsdienst von dem Clouddienst abhängt. Dadurch werden auch die DNS-Server als sichtbar für den CloudService zurückgegeben.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/networkstatus?api-version=2021-12-01-preview

URI-Parameter

Name In Required Type Description
resourceGroupName
path True
  • string

Der Name der Ressourcengruppe.

serviceName
path True
  • string

Der Name des API Management Diensts.

Regex pattern: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$

subscriptionId
path True
  • string

Abonnementanmeldeinformationen, die Microsoft Azure Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

api-version
query True
  • string

Version der API, die mit der Clientanforderung verwendet werden soll.

Antworten

Name Type Description
200 OK

Ruft die Listennetzwerkstatusdetails für alle Regionen ab, in denen der Dienst bereitgestellt wird.

Other Status Codes

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

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 Identitätswechsel Ihres Benutzerkontos

Beispiele

ApiManagementServiceGetNetworkStatus

Sample Request

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/networkstatus?api-version=2021-12-01-preview

Sample Response

[
  {
    "location": "West US",
    "networkStatus": {
      "dnsServers": [
        "10.82.98.10"
      ],
      "connectivityStatus": [
        {
          "name": "apimgmtst6xxxxxxxxxxx.blob.core.windows.net",
          "status": "success",
          "error": "",
          "lastUpdated": "2020-11-24T22:55:14.7035899Z",
          "lastStatusChange": "2020-11-20T07:54:55.9365931Z",
          "resourceType": "BlobStorage",
          "isOptional": false
        },
        {
          "name": "apimgmtst6xxxxxxxxxxx.file.core.windows.net",
          "status": "success",
          "error": "",
          "lastUpdated": "2020-11-24T22:55:41.5322463Z",
          "lastStatusChange": "2020-11-20T07:54:55.9265938Z",
          "resourceType": "FileStorage",
          "isOptional": true
        },
        {
          "name": "apimgmtst6xxxxxxxxxxx.queue.core.windows.net",
          "status": "success",
          "error": "",
          "lastUpdated": "2020-11-24T22:55:30.645994Z",
          "lastStatusChange": "2020-11-20T07:54:55.8410477Z",
          "resourceType": "Queue",
          "isOptional": true
        },
        {
          "name": "apimgmtst6xxxxxxxxxxx.table.core.windows.net",
          "status": "success",
          "error": "",
          "lastUpdated": "2020-11-24T22:55:23.8789171Z",
          "lastStatusChange": "2020-11-20T07:54:55.9365931Z",
          "resourceType": "TableStorage",
          "isOptional": false
        },
        {
          "name": "gcs.prod.monitoring.core.windows.net",
          "status": "success",
          "error": "",
          "lastUpdated": "2020-11-24T22:57:34.8666833Z",
          "lastStatusChange": "2020-11-20T08:07:37.5486932Z",
          "resourceType": "Monitoring",
          "isOptional": true
        },
        {
          "name": "https://gcs.ppe.warm.ingestion.monitoring.azure.com",
          "status": "success",
          "error": "",
          "lastUpdated": "2020-11-24T22:56:26.1870188Z",
          "lastStatusChange": "2020-11-20T07:54:56.1060523Z",
          "resourceType": "Monitoring",
          "isOptional": true
        },
        {
          "name": "https://global.metrics.nsatc.net/",
          "status": "success",
          "error": "",
          "lastUpdated": "2020-11-24T22:56:35.9620612Z",
          "lastStatusChange": "2020-11-20T07:54:56.0510519Z",
          "resourceType": "Monitoring",
          "isOptional": true
        },
        {
          "name": "https://login.windows.net",
          "status": "success",
          "error": "",
          "lastUpdated": "2020-11-24T22:56:30.8047708Z",
          "lastStatusChange": "2020-11-20T07:54:56.1060523Z",
          "resourceType": "AzureActiveDirectory",
          "isOptional": true
        },
        {
          "name": "https://prod2.metrics.nsatc.net:1886/RecoveryService",
          "status": "success",
          "error": "",
          "lastUpdated": "2020-11-24T22:56:45.2095302Z",
          "lastStatusChange": "2020-11-20T07:54:56.2796235Z",
          "resourceType": "Metrics",
          "isOptional": true
        },
        {
          "name": "LocalGatewayRedis",
          "status": "success",
          "error": "",
          "lastUpdated": "2020-11-24T22:55:15.1345836Z",
          "lastStatusChange": "2020-11-20T07:54:55.9365931Z",
          "resourceType": "InternalCache",
          "isOptional": true
        },
        {
          "name": "prod.warmpath.msftcloudes.com",
          "status": "success",
          "error": "",
          "lastUpdated": "2020-11-24T22:55:57.8992141Z",
          "lastStatusChange": "2020-11-20T07:54:55.8410477Z",
          "resourceType": "Monitoring",
          "isOptional": false
        },
        {
          "name": "Scm",
          "status": "success",
          "error": "",
          "lastUpdated": "2020-11-24T23:01:24.0553684Z",
          "lastStatusChange": "2019-07-20T02:25:48.7066996Z",
          "resourceType": "SourceControl",
          "isOptional": true
        },
        {
          "name": "smtpi-ch1.msn.com:25028",
          "status": "success",
          "error": "",
          "lastUpdated": "2020-11-24T22:58:22.2430074Z",
          "lastStatusChange": "2020-11-20T07:54:56.3510577Z",
          "resourceType": "Email",
          "isOptional": true
        },
        {
          "name": "zwcvuxxxx.database.windows.net",
          "status": "success",
          "error": "",
          "lastUpdated": "2020-11-24T22:55:44.3582171Z",
          "lastStatusChange": "2020-11-20T07:54:56.0410467Z",
          "resourceType": "SQLDatabase",
          "isOptional": false
        }
      ]
    }
  }
]

Definitionen

ConnectivityStatusContract

Details zur Konnektivität zu einer Ressource.

ConnectivityStatusType

Statusbezeichner des Ressourcenkonnektivitätsstatus.

ErrorFieldContract

Fehlerfeldvertrag.

ErrorResponse

Fehlerantwort.

NetworkStatusContract

Details zum Netzwerkstatus.

NetworkStatusContractByLocation

Netzwerkstatus am Speicherort

ConnectivityStatusContract

Details zur Konnektivität zu einer Ressource.

Name Type Description
error
  • string

Fehlerdetails der Verbindung mit der Ressource.

isOptional
  • boolean

Gibt an, ob dies optional ist.

lastStatusChange
  • string

Das Datum, an dem der Status der Ressourcenkonnektivität zuletzt von Erfolg zu Fehler oder umgekehrt geändert wurde. Das Datum entspricht dem folgenden Format: yyyy-MM-ddTHH:mm:ssZ wie durch den ISO 8601-Standard angegeben.

lastUpdated
  • string

Das Datum, an dem der Status der Ressourcenkonnektivität zuletzt aktualisiert wurde. Dieser Status sollte alle 15 Minuten aktualisiert werden. Wenn dieser Status nicht aktualisiert wurde, bedeutet dies, dass der Dienst die Netzwerkkonnektivität an die Ressource verloren hat, von innerhalb der Virtual Network. Das Datum entspricht dem folgenden Format: yyyy-MM-ddTHH:mm:ssZ wie durch den ISO 8601-Standard angegeben.

name
  • string

Der Hostname der Ressource, von der der Dienst abhängt. Dies kann die Datenbank, der Speicher oder eine andere Azure-Ressource sein, von der der Dienst abhängt.

resourceType
  • string

Ressourcentyp.

status

Statusbezeichner des Ressourcenkonnektivitätsstatus.

ConnectivityStatusType

Statusbezeichner des Ressourcenkonnektivitätsstatus.

Name Type Description
failure
  • string
initializing
  • string
success
  • string

ErrorFieldContract

Fehlerfeldvertrag.

Name Type Description
code
  • string

Fehlercode auf Eigenschaftsebene.

message
  • string

Humanlesbare Darstellung des Fehlers auf Eigenschaftsebene.

target
  • string

Der Eigenschaftsname.

ErrorResponse

Fehlerantwort.

Name Type Description
error.code
  • string

Der vom Dienst definierte Fehlercode. Dieser Code dient als Unterstatus für den in der Antwort angegebenen HTTP-Fehlercode.

error.details

Die Liste der ungültigen Felder, die in Anforderung gesendet werden, im Falle eines Überprüfungsfehlers.

error.message
  • string

Lesbare Darstellung des Fehlers.

NetworkStatusContract

Details zum Netzwerkstatus.

Name Type Description
connectivityStatus

Ruft die Liste der Verbindungsstatus an die Ressourcen ab, von denen der Dienst abhängt.

dnsServers
  • string[]

Ruft die Liste der DNS-Server IPV4-Adressen ab.

NetworkStatusContractByLocation

Netzwerkstatus am Speicherort

Name Type Description
location
  • string

Standort des Dienstes

networkStatus

Netzwerkstatus am Standort