Freigeben über


Tenant Activity Logs - List

Ruft die Aktivitätsprotokolle für den Mandanten ab.
Alles, was für die API gilt, um die Aktivitätsprotokolle für das Abonnement abzurufen, gilt für diese API (die Parameter, $filter usw.).
Es muss darauf hingewiesen werden, dass diese API nicht die Protokolle im einzelnen Abonnement des Mandanten abrufen, sondern nur die Protokolle anzeigt, die auf Mandantenebene generiert wurden.

GET https://management.azure.com/providers/Microsoft.Insights/eventtypes/management/values?api-version=2015-04-01
GET https://management.azure.com/providers/Microsoft.Insights/eventtypes/management/values?api-version=2015-04-01&$filter={$filter}&$select={$select}

URI-Parameter

Name In Erforderlich Typ Beschreibung
api-version
query True

string

minLength: 1

Die API-Version, die für diesen Vorgang verwendet werden soll.

$filter
query

string

Reduziert die Menge der gesammelten Daten.
Die $filter ist sehr eingeschränkt und lässt nur die folgenden Muster zu.
- Listenereignisse für eine Ressourcengruppe: $filter=eventTimestamp ge '' und eventTimestamp le '' und eventChannels eq 'Admin, Operation' und resourceGroupName eq ''.
- Listenereignisse für Ressource: $filter=eventTimestamp ge '' und eventTimestamp le '' und eventChannels eq 'Admin, Operation' und resourceUri eq ''.
- Ereignisse für ein Abonnement auflisten: $filter=eventTimestamp ge '' und eventTimestamp le '' und eventChannels eq 'Admin, Operation'.
- Listenereignisse für einen Ressourcenanbieter: $filter=eventTimestamp ge '' und eventTimestamp le '' und eventChannels eq 'Admin, Operation' und resourceProvider eq ''.
- Auflisten von Ereignissen für eine Korrelations-ID: api-version=2014-04-01&$filter=eventTimestamp ge '2014-07-16T04:36:37.6407 898Z' und eventTimestamp le '2014-07-20T04:36:37.6407898Z' und eventChannels eq 'Admin, Operation' und correlationId eq ''.
HINWEIS: Es ist keine andere Syntax zulässig.

$select
query

string

Wird verwendet, um Ereignisse nur mit den angegebenen Eigenschaften abzurufen.
Das argument $select ist eine durch Trennzeichen getrennte Liste von Eigenschaftsnamen, die zurückgegeben werden sollen. Mögliche Werte sind: Authorization, Claims, correlationId, description, eventDataId, eventName, eventTimestamp, httpRequest, level, operationId, operationName, properties, resourceGroupName, resourceProviderName, resourceId, status, submissionTimestamp, subStatus, subscriptionId

Antworten

Name Typ Beschreibung
200 OK

EventDataCollection

Erfolgreiche Anforderung zum Abrufen einer Seite von Ereignissen in den Mandantenaktivitätsprotokollen

Other Status Codes

ErrorResponse

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 Tenant Activity Logs with filter
Get Tenant Activity Logs with filter and select
Get Tenant Activity Logs with select
Get Tenant Activity Logs without filter or select

Get Tenant Activity Logs with filter

Beispielanforderung

GET https://management.azure.com/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 Tenant Activity Logs with filter and select

Beispielanforderung

GET https://management.azure.com/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=######"
}

Get Tenant Activity Logs with select

Beispielanforderung

GET https://management.azure.com/providers/Microsoft.Insights/eventtypes/management/values?api-version=2015-04-01&$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=######"
}

Get Tenant Activity Logs without filter or select

Beispielanforderung

GET https://management.azure.com/providers/Microsoft.Insights/eventtypes/management/values?api-version=2015-04-01

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=######"
}

Definitionen

Name Beschreibung
ErrorResponse

Beschreibt das Format der Fehlerantwort.

EventData

Die Azure-Ereignisprotokolleinträge sind vom Typ "EventData"

EventDataCollection

Stellt eine Auflistung von Ereignissen dar.

EventLevel

Die Ereignisebene

HttpRequestInfo

Die Http-Anforderungsinformationen.

LocalizableString

Die lokalisierbare Zeichenfolgenklasse.

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"

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

SenderAuthorization

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

LocalizableString

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

LocalizableString

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

HttpRequestInfo

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

EventLevel

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

LocalizableString

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

LocalizableString

der Name des Ressourcenanbieters der betroffenen Ressource.

resourceType

LocalizableString

der Ressourcentyp

status

LocalizableString

eine Zeichenfolge, die den Status des Vorgangs beschreibt. Einige typische Werte sind: "Gestartet", "In Bearbeitung", "Erfolgreich", "Fehlgeschlagen", "Gelöst".

subStatus

LocalizableString

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

EventData[]

diese Liste, die die Azure-Überwachungsprotokolle enthält.

EventLevel

Die Ereignisebene

Wert Beschreibung
Critical
Error
Informational
Verbose
Warning

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.