Network Status - List By Service
Gets the Connectivity Status to the external resources on which the Api Management service depends from inside the Cloud Service. This also returns the DNS Servers as visible to the CloudService.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/networkstatus?api-version=2022-08-01
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
resource
|
path | True |
string |
The name of the resource group. The name is case insensitive. |
service
|
path | True |
string |
The name of the API Management service. Regex pattern: |
subscription
|
path | True |
string |
The ID of the target subscription. |
api-version
|
query | True |
string |
The API version to use for this operation. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
Gets the list Network status details for all regions in which service is deployed. |
|
Other Status Codes |
Error response describing why the operation failed. |
Security
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 | impersonate your user account |
Examples
ApiManagementServiceGetNetworkStatus
Sample Request
GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/networkstatus?api-version=2022-08-01
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
}
]
}
}
]
Definitions
Name | Description |
---|---|
Connectivity |
Details about connectivity to a resource. |
Connectivity |
Resource Connectivity Status Type identifier. |
Error |
Error Field contract. |
Error |
Error Response. |
Network |
Network Status details. |
Network |
Network Status in the Location |
ConnectivityStatusContract
Details about connectivity to a resource.
Name | Type | Description |
---|---|---|
error |
string |
Error details of the connectivity to the resource. |
isOptional |
boolean |
Whether this is optional. |
lastStatusChange |
string |
The date when the resource connectivity status last Changed from success to failure or vice-versa. The date conforms to the following format: |
lastUpdated |
string |
The date when the resource connectivity status was last updated. This status should be updated every 15 minutes. If this status has not been updated, then it means that the service has lost network connectivity to the resource, from inside the Virtual Network.The date conforms to the following format: |
name |
string |
The hostname of the resource which the service depends on. This can be the database, storage or any other azure resource on which the service depends upon. |
resourceType |
string |
Resource Type. |
status |
Resource Connectivity Status Type identifier. |
ConnectivityStatusType
Resource Connectivity Status Type identifier.
Name | Type | Description |
---|---|---|
failure |
string |
|
initializing |
string |
|
success |
string |
ErrorFieldContract
Error Field contract.
Name | Type | Description |
---|---|---|
code |
string |
Property level error code. |
message |
string |
Human-readable representation of property-level error. |
target |
string |
Property name. |
ErrorResponse
Error Response.
Name | Type | Description |
---|---|---|
error.code |
string |
Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. |
error.details |
The list of invalid fields send in request, in case of validation error. |
|
error.message |
string |
Human-readable representation of the error. |
NetworkStatusContract
Network Status details.
Name | Type | Description |
---|---|---|
connectivityStatus |
Gets the list of Connectivity Status to the Resources on which the service depends upon. |
|
dnsServers |
string[] |
Gets the list of DNS servers IPV4 addresses. |
NetworkStatusContractByLocation
Network Status in the Location
Name | Type | Description |
---|---|---|
location |
string |
Location of service |
networkStatus |
Network status in Location |