Activity Logs - List
Stellt die Liste der Datensätze aus den Aktivitätsprotokollen bereit.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Insights/eventtypes/management/values?api-version=2015-04-01&$filter={$filter}
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Insights/eventtypes/management/values?api-version=2015-04-01&$filter={$filter}&$select={$select}
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
subscription
|
path | True |
string minLength: 1 |
Die ID des Zielabonnements. |
|
$filter
|
query | True |
string |
Reduziert die Menge der gesammelten Daten. |
|
api-version
|
query | True |
string minLength: 1 |
Die API-Version, die für diesen Vorgang verwendet werden soll. |
|
$select
|
query |
string |
Wird verwendet, um Ereignisse nur mit den angegebenen Eigenschaften abzurufen. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Erfolgreiche Anforderung zum Abrufen einer Seite von Ereignissen in den Aktivitätsprotokollen |
|
| Other Status Codes |
Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist. |
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 Activity Logs with filter |
| Get Activity Logs with filter and select |
Get Activity Logs with filter
Beispielanforderung
GET https://management.azure.com/subscriptions/089bd33f-d4ec-47fe-8ba5-0753aa5c5b33/providers/Microsoft.Insights/eventtypes/management/values?api-version=2015-04-01&$filter=eventTimestamp ge '2015-01-21T20:00:00Z' and eventTimestamp le '2015-01-23T20:00:00Z' and resourceGroupName eq 'MSSupportGroup'
Beispiel für eine Antwort
{
"value": [
{
"authorization": {
"action": "microsoft.support/supporttickets/write",
"role": "Subscription Admin",
"scope": "/subscriptions/089bd33f-d4ec-47fe-8ba5-0753aa5c5b33/resourceGroups/MSSupportGroup/providers/microsoft.support/supporttickets/115012112305841"
},
"caller": "admin@contoso.com",
"claims": {
"aud": "https://management.core.windows.net/",
"iss": "https://sts.windows.net/72f988bf-86f1-41af-91ab-2d7cd011db47/",
"iat": "1421876371",
"nbf": "1421876371",
"exp": "1421880271",
"ver": "1.0",
"http://schemas.microsoft.com/identity/claims/tenantid": "1e8d8218-c5e7-4578-9acc-9abbd5d23315",
"http://schemas.microsoft.com/claims/authnmethodsreferences": "pwd",
"http://schemas.microsoft.com/identity/claims/objectidentifier": "2468adf0-8211-44e3-95xq-85137af64708",
"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn": "admin@contoso.com",
"puid": "20030000801A118C",
"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier": "9vckmEGF7zDKk1YzIY8k0t1_EAPaXoeHyPRn6f413zM",
"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname": "John",
"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname": "Smith",
"name": "John Smith",
"groups": "cacfe77c-e058-4712-83qw-f9b08849fd60,7f71d11d-4c41-4b23-99d2-d32ce7aa621c,31522864-0578-4ea0-9gdc-e66cc564d18c",
"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name": "admin@contoso.com",
"appid": "c44b4083-3bq0-49c1-b47d-974e53cbdf3c",
"appidacr": "2",
"http://schemas.microsoft.com/identity/claims/scope": "user_impersonation",
"http://schemas.microsoft.com/claims/authnclassreference": "1"
},
"correlationId": "1e121103-0ba6-4300-ac9d-952bb5d0c80f",
"description": "",
"eventDataId": "44ade6b4-3813-45e6-ae27-7420a95fa2f8",
"eventName": {
"value": "EndRequest",
"localizedValue": "End request"
},
"httpRequest": {
"clientRequestId": "27003b25-91d3-418f-8eb1-29e537dcb249",
"clientIpAddress": "192.168.35.115",
"method": "PUT"
},
"id": "/subscriptions/089bd33f-d4ec-47fe-8ba5-0753aa5c5b33/resourceGroups/MSSupportGroup/providers/microsoft.support/supporttickets/115012112305841/events/44ade6b4-3813-45e6-ae27-7420a95fa2f8/ticks/635574752669792776",
"level": "Informational",
"resourceGroupName": "MSSupportGroup",
"resourceProviderName": {
"value": "microsoft.support",
"localizedValue": "microsoft.support"
},
"operationId": "1e121103-0ba6-4300-ac9d-952bb5d0c80f",
"operationName": {
"value": "microsoft.support/supporttickets/write",
"localizedValue": "microsoft.support/supporttickets/write"
},
"properties": {
"statusCode": "Created"
},
"status": {
"value": "Succeeded",
"localizedValue": "Succeeded"
},
"subStatus": {
"value": "Created",
"localizedValue": "Created (HTTP Status Code: 201)"
},
"eventTimestamp": "2015-01-21T22:14:26.9792776Z",
"submissionTimestamp": "2015-01-21T22:14:39.9936304Z",
"subscriptionId": "089bd33f-d4ec-47fe-8ba5-0753aa5c5b33"
}
],
"nextLink": "https://management.azure.com/########-####-####-####-############$skiptoken=######"
}
Get Activity Logs with filter and select
Beispielanforderung
GET https://management.azure.com/subscriptions/089bd33f-d4ec-47fe-8ba5-0753aa5c5b33/providers/Microsoft.Insights/eventtypes/management/values?api-version=2015-04-01&$filter=eventTimestamp ge '2015-01-21T20:00:00Z' and eventTimestamp le '2015-01-23T20:00:00Z' and resourceGroupName eq 'MSSupportGroup'&$select=eventName,id,resourceGroupName,resourceProviderName,operationName,status,eventTimestamp,correlationId,submissionTimestamp,level
Beispiel für eine Antwort
{
"value": [
{
"correlationId": "1e121103-0ba6-4300-ac9d-952bb5d0c80f",
"eventName": {
"value": "EndRequest",
"localizedValue": "End request"
},
"id": "/subscriptions/089bd33f-d4ec-47fe-8ba5-0753aa5c5b33/resourceGroups/MSSupportGroup/providers/microsoft.support/supporttickets/115012112305841/events/44ade6b4-3813-45e6-ae27-7420a95fa2f8/ticks/635574752669792776",
"resourceGroupName": "MSSupportGroup",
"resourceProviderName": {
"value": "microsoft.support",
"localizedValue": "microsoft.support"
},
"operationName": {
"value": "microsoft.support/supporttickets/write",
"localizedValue": "microsoft.support/supporttickets/write"
},
"status": {
"value": "Succeeded",
"localizedValue": "Succeeded"
},
"eventTimestamp": "2015-01-21T22:14:26.9792776Z",
"submissionTimestamp": "2015-01-21T22:14:39.9936304Z",
"level": "Informational"
}
],
"nextLink": "https://management.azure.com/########-####-####-####-############$skiptoken=######"
}
Definitionen
| Name | Beschreibung |
|---|---|
|
Error |
Beschreibt das Format der Fehlerantwort. |
|
Event |
Die Azure-Ereignisprotokolleinträge sind vom Typ "EventData" |
|
Event |
Stellt eine Auflistung von Ereignissen dar. |
|
Event |
Die Ereignisebene |
|
Http |
Die Http-Anforderungsinformationen. |
|
Localizable |
Die lokalisierbare Zeichenfolgenklasse. |
|
Sender |
die Autorisierung des Benutzers, der den Vorgang ausgeführt hat, der zu diesem Ereignis geführt hat. Dadurch werden die RBAC-Eigenschaften des Ereignisses erfasst. Dazu gehören in der Regel die "Aktion", "Rolle" und der "Bereich" |
ErrorResponse
Beschreibt das Format der Fehlerantwort.
| Name | Typ | Beschreibung |
|---|---|---|
| code |
string |
Fehlercode |
| message |
string |
Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist. |
EventData
Die Azure-Ereignisprotokolleinträge sind vom Typ "EventData"
| Name | Typ | Beschreibung |
|---|---|---|
| authorization |
Die Autorisierungsinformationen des Absenders. |
|
| caller |
string |
die E-Mail-Adresse des Benutzers, der den Vorgang ausgeführt hat, den UPN-Anspruch oder den SPN-Anspruch basierend auf der Verfügbarkeit. |
| category |
die Ereigniskategorie. |
|
| claims |
object |
Schlüsselwertpaare zum Identifizieren von ARM-Berechtigungen. |
| correlationId |
string |
die Korrelations-ID, in der Regel eine GUID im Zeichenfolgenformat. Die Korrelations-ID wird von den Ereignissen geteilt, die zum gleichen Uber-Betrieb gehören. |
| description |
string |
die Beschreibung des Ereignisses. |
| eventDataId |
string |
die Ereignisdaten-ID. Dies ist ein eindeutiger Bezeichner für ein Ereignis. |
| eventName |
der Ereignisname. Dieser Wert sollte nicht mit OperationName verwechselt werden. Für praktische Zwecke kann OperationName für Endbenutzer attraktiver sein. |
|
| eventTimestamp |
string (date-time) |
der Zeitstempel, zu dem das Ereignis vom Azure-Dienst generiert wurde, der die Anforderung verarbeitet, die dem Ereignis entspricht. Es im ISO 8601-Format. |
| httpRequest |
die HTTP-Anforderungsinformationen. Enthält in der Regel die "clientRequestId", "clientIpAddress" (IP-Adresse des Benutzers, der das Ereignis initiiert hat) und "method" (HTTP-Methode z. B. PUT). |
|
| id |
string |
die ID dieses Ereignisses nach Bedarf von ARM für RBAC. Sie enthält die EventDataID und eine Zeitstempelinformationen. |
| level |
Die Ereignisebene |
|
| operationId |
string |
Es handelt sich in der Regel um eine GUID, die zwischen den Ereignissen geteilt wird, die einem einzelnen Vorgang entsprechen. Dieser Wert sollte nicht mit EventName verwechselt werden. |
| operationName |
der Vorgangsname. |
|
| properties |
object |
die Gruppe von <Schlüssel-, Wert->-Paaren (in der Regel ein Wörterbuch<Zeichenfolge, Zeichenfolge>), die Details zum Ereignis enthält. |
| resourceGroupName |
string |
der Ressourcengruppenname der betroffenen Ressource. |
| resourceId |
string |
der Ressourcen-URI, der die Ressource identifiziert, die dieses Ereignis verursacht hat. |
| resourceProviderName |
der Name des Ressourcenanbieters der betroffenen Ressource. |
|
| resourceType |
der Ressourcentyp |
|
| status |
eine Zeichenfolge, die den Status des Vorgangs beschreibt. Einige typische Werte sind: "Gestartet", "In Bearbeitung", "Erfolgreich", "Fehlgeschlagen", "Gelöst". |
|
| subStatus |
der Unterstatus des Ereignisses. In den meisten Fällen erfasst dies den HTTP-Statuscode des REST-Aufrufs. Allgemeine Werte sind: OK (HTTP-Statuscode: 200), Created (HTTP Status Code: 201), Accepted (HTTP Status Code: 202), No Content (HTTP Status Code: 204), Bad Request(HTTP Status Code: 400 Nicht gefunden (HTTP-Statuscode: 404), Konflikt (HTTP-Statuscode: 409), Interner Serverfehler (HTTP-Statuscode: 500), Dienst nicht verfügbar (HTTP-Statuscode:503), Gatewaytimeout (HTTP-Statuscode: 504) |
|
| submissionTimestamp |
string (date-time) |
der Zeitstempel, zu dem das Ereignis für die Abfrage über diese API verfügbar wurde. Es ist im ISO 8601-Format vorhanden. Dieser Wert sollte nicht verwechselt werden eventTimestamp. Da es möglicherweise eine Verzögerung zwischen dem Auftreten des Ereignisses und dem Zeitpunkt gibt, zu dem das Ereignis an die Azure-Protokollierungsinfrastruktur übermittelt wird. |
| subscriptionId |
string |
die Azure-Abonnement-ID in der Regel eine GUID. |
| tenantId |
string |
die Azure-Mandanten-ID |
EventDataCollection
Stellt eine Auflistung von Ereignissen dar.
| Name | Typ | Beschreibung |
|---|---|---|
| nextLink |
string |
Stellt den Link zum Abrufen des nächsten Satzes von Ereignissen bereit. |
| value |
diese Liste, die die Azure-Überwachungsprotokolle enthält. |
EventLevel
Die Ereignisebene
| Wert | Beschreibung |
|---|---|
| Critical | |
| Error | |
| Warning | |
| Informational | |
| Verbose |
HttpRequestInfo
Die Http-Anforderungsinformationen.
| Name | Typ | Beschreibung |
|---|---|---|
| clientIpAddress |
string |
die Client-IP-Adresse |
| clientRequestId |
string |
die Clientanforderungs-ID. |
| method |
string |
die Http-Anforderungsmethode. |
| uri |
string |
der URI. |
LocalizableString
Die lokalisierbare Zeichenfolgenklasse.
| Name | Typ | Beschreibung |
|---|---|---|
| localizedValue |
string |
den gebietsschemaspezifischen Wert. |
| value |
string |
der invariante Wert. |
SenderAuthorization
die Autorisierung des Benutzers, der den Vorgang ausgeführt hat, der zu diesem Ereignis geführt hat. Dadurch werden die RBAC-Eigenschaften des Ereignisses erfasst. Dazu gehören in der Regel die "Aktion", "Rolle" und der "Bereich"
| Name | Typ | Beschreibung |
|---|---|---|
| action |
string |
die zulässigen Aktionen. Beispiel: microsoft.support/supporttickets/write |
| role |
string |
die Rolle des Benutzers. Beispiel: Abonnementadministrator |
| scope |
string |
der Bereich. |