Web Apps - Get Instance Info
Beschreibung für Ruft alle Instanzen einer App mit horizontaler Skalierung ab.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/instances/{instanceId}?api-version=2025-03-01
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
instance
|
path | True |
string |
|
|
name
|
path | True |
string |
Name der App. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet. |
|
subscription
|
path | True |
string (uuid) |
Die ID des Zielabonnements. Der Wert muss eine UUID sein. |
|
api-version
|
query | True |
string minLength: 1 |
Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Der Azure-Vorgang wurde erfolgreich abgeschlossen. |
|
| Other Status Codes |
Unerwartete Fehlerantwort. |
Sicherheit
azure_auth
Azure Active Directory OAuth2-Fluss.
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
| Name | Beschreibung |
|---|---|
| user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
Get site instance info
Beispielanforderung
GET https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/tests346/instances/134987120?api-version=2025-03-01
Beispiel für eine Antwort
{
"name": "134987120",
"type": "Microsoft.Web/sites/instances",
"id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/tests346/slot/staging/instances/134987120",
"properties": {
"containers": {
"c1": {
"currentTimeStamp": "2013-10-21T13:28:06.419Z"
}
},
"detectorUrl": "testsec579",
"state": "READY",
"statusUrl": "https://sampleurl"
}
}
Definitionen
| Name | Beschreibung |
|---|---|
|
Container |
|
|
Container |
|
|
Container |
|
|
Container |
|
|
Container |
|
|
Container |
|
|
created |
Der Identitätstyp, der die Ressource erstellt hat. |
|
Default |
Fehlerantwort des App-Diensts. |
|
Default |
Fehlermodell. |
|
Default |
Detaillierte Fehler. |
|
Site |
|
|
system |
Metadaten zur Erstellung und letzten Änderung der Ressource. |
|
Web |
Konkrete Proxyressourcentypen können durch Aliasing dieses Typs mithilfe eines bestimmten Eigenschaftstyps erstellt werden. |
ContainerCpuStatistics
| Name | Typ | Beschreibung |
|---|---|---|
| cpuUsage | ||
| onlineCpuCount |
integer (int32) |
|
| systemCpuUsage |
integer (int64) |
|
| throttlingData |
ContainerCpuUsage
| Name | Typ | Beschreibung |
|---|---|---|
| kernelModeUsage |
integer (int64) |
|
| perCpuUsage |
integer[] (int64) |
|
| totalUsage |
integer (int64) |
|
| userModeUsage |
integer (int64) |
ContainerInfo
| Name | Typ | Beschreibung |
|---|---|---|
| currentCpuStats | ||
| currentTimeStamp |
string (date-time) |
|
| eth0 | ||
| id |
string |
|
| memoryStats | ||
| name |
string |
|
| previousCpuStats | ||
| previousTimeStamp |
string (date-time) |
ContainerMemoryStatistics
| Name | Typ | Beschreibung |
|---|---|---|
| limit |
integer (int64) |
|
| maxUsage |
integer (int64) |
|
| usage |
integer (int64) |
ContainerNetworkInterfaceStatistics
| Name | Typ | Beschreibung |
|---|---|---|
| rxBytes |
integer (int64) |
|
| rxDropped |
integer (int64) |
|
| rxErrors |
integer (int64) |
|
| rxPackets |
integer (int64) |
|
| txBytes |
integer (int64) |
|
| txDropped |
integer (int64) |
|
| txErrors |
integer (int64) |
|
| txPackets |
integer (int64) |
ContainerThrottlingData
| Name | Typ | Beschreibung |
|---|---|---|
| periods |
integer (int32) |
|
| throttledPeriods |
integer (int32) |
|
| throttledTime |
integer (int32) |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
| Wert | Beschreibung |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DefaultErrorResponse
Fehlerantwort des App-Diensts.
| Name | Typ | Beschreibung |
|---|---|---|
| error |
Fehlermodell. |
DefaultErrorResponseError
Fehlermodell.
| Name | Typ | Beschreibung |
|---|---|---|
| code |
string |
Standardisierte Zeichenfolge zur programmgesteuerten Identifizierung des Fehlers. |
| details |
Detaillierte Fehler. |
|
| innererror |
string |
Weitere Informationen zum Debuggen von Fehlern. |
| message |
string |
Detaillierte Fehlerbeschreibung und Informationen zum Debuggen. |
| target |
string |
Detaillierte Fehlerbeschreibung und Informationen zum Debuggen. |
DefaultErrorResponseErrorDetailsItem
Detaillierte Fehler.
| Name | Typ | Beschreibung |
|---|---|---|
| code |
string |
Standardisierte Zeichenfolge zur programmgesteuerten Identifizierung des Fehlers. |
| message |
string |
Detaillierte Fehlerbeschreibung und Informationen zum Debuggen. |
| target |
string |
Detaillierte Fehlerbeschreibung und Informationen zum Debuggen. |
SiteRuntimeState
| Wert | Beschreibung |
|---|---|
| READY | |
| STOPPED | |
| UNKNOWN |
systemData
Metadaten zur Erstellung und letzten Änderung der Ressource.
| Name | Typ | Beschreibung |
|---|---|---|
| createdAt |
string (date-time) |
Der Zeitstempel der Ressourcenerstellung (UTC). |
| createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
| createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
| lastModifiedAt |
string (date-time) |
Der Zeitstempel der letzten Änderung der Ressource (UTC) |
| lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
| lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |
WebSiteInstanceStatus
Konkrete Proxyressourcentypen können durch Aliasing dieses Typs mithilfe eines bestimmten Eigenschaftstyps erstellt werden.
| Name | Typ | Beschreibung |
|---|---|---|
| id |
string (arm-id) |
Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| kind |
string |
Art der Ressource. |
| name |
string |
Der Name der Ressource |
| properties.consoleUrl |
string |
Link zur Konsole zur Web-App-Instanz |
| properties.containers |
<string,
Container |
Wörterbuch von <ContainerInfo> |
| properties.detectorUrl |
string |
Link zum Diagnose- und Lösungsportal |
| properties.healthCheckUrl |
string |
Link zur Konsole zur Web-App-Instanz |
| properties.physicalZone |
string |
Die physische Zone, in der sich die Instanz befindet |
| properties.state | ||
| properties.statusUrl |
string |
Link zur GetStatusApi in Kudu |
| systemData |
Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen. |
|
| type |
string |
Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |