Sdílet prostřednictvím


Tenant Activity Logs - List

Získá protokoly aktivit pro tenanta.
Vše, co platí pro rozhraní API pro získání protokolů aktivit pro předplatné, se vztahuje na toto rozhraní API (parametry, $filter atd.).
Jednou z věcí, které je potřeba zdůraznit, je, že toto rozhraní API ne načíst protokoly v individuálním předplatném tenanta, ale pouze zobrazí protokoly, které byly generovány na úrovni tenanta.

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}

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
api-version
query True

string

minLength: 1

Verze rozhraní API, která se má použít pro tuto operaci.

$filter
query

string

Snižuje sadu shromážděných dat.
$filter je velmi omezený a umožňuje pouze následující vzory.
– Výpis událostí pro skupinu prostředků: $filter=eventTimestamp ge '' a eventTimestamp le '' and eventChannels eq 'Admin, Operation' and resourceGroupName eq ''.
– Výpis událostí pro prostředek: $filter=eventTimestamp ge '' a eventTimestamp le '' and eventChannels eq 'Admin, Operation' and resourceUri eq ''.
– Výpis událostí pro odběr: $filter=eventTimestamp ge '' a eventTimestamp le '' and eventChannels eq 'Admin, Operation'.
– Výpis událostí pro poskytovatele prostředků: $filter=eventTimestamp ge '' a eventTimestamp le '' and eventChannels eq 'Admin, Operation' a resourceProvider eq ''.
- Výpis událostí pro ID korelace: api-version=2014-04-01&$filter=eventTimestamp ge '2014-07-16T04:36:37.6407898Z a eventTimestamp le '2014-07-20T04:36:37.6407898Z' a eventChannels eq 'Admin, Operation' a correlationId eq ''
POZNÁMKA: Není povolena žádná jiná syntaxe.

$select
query

string

Slouží k načtení událostí pouze s danými vlastnostmi.
Argument $select je čárkami oddělený seznam názvů vlastností, které se mají vrátit. Možné hodnoty: authorization, claims, correlationId, description, eventDataId, eventName, eventTimestamp, httpRequest, level, operationId, operationName, properties, resourceGroupName, resourceProviderName, resourceId, status, submissionTimestamp, subStatus, subscriptionId

Odpovědi

Name Typ Description
200 OK

EventDataCollection

Úspěšná žádost o získání stránky událostí v protokolech aktivit tenanta

Other Status Codes

ErrorResponse

Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

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

Ukázkový požadavek

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'

Ukázková odpověď

{
  "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

Ukázkový požadavek

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

Ukázková odpověď

{
  "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

Ukázkový požadavek

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

Ukázková odpověď

{
  "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

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
ErrorResponse

Popisuje formát odpovědi na chybu.

EventData

Položky protokolu událostí Azure jsou typu EventData.

EventDataCollection

Představuje kolekci událostí.

EventLevel

úroveň události

HttpRequestInfo

Informace o požadavku HTTP.

LocalizableString

Lokalizovatelná třída řetězce.

SenderAuthorization

autorizaci použitou uživatelem, který provedl operaci, která vedla k této události. Tím se zachytí vlastnosti RBAC události. Obvykle se jedná o akci, roli a obor.

ErrorResponse

Popisuje formát odpovědi na chybu.

Name Typ Description
code

string

Kód chyby

message

string

Chybová zpráva označující, proč operace selhala.

EventData

Položky protokolu událostí Azure jsou typu EventData.

Name Typ Description
authorization

SenderAuthorization

Informace o autorizaci odesílatele.

caller

string

e-mailovou adresu uživatele, který provedl operaci, deklaraci hlavního názvu uživatele (UPN) nebo deklaraci hlavního názvu uživatele (SPN) na základě dostupnosti.

category

LocalizableString

kategorie události.

claims

object

Páry klíč-hodnota k identifikaci oprávnění ARM.

correlationId

string

ID korelace, obvykle identifikátor GUID ve formátu řetězce. ID korelace se sdílí mezi událostmi, které patří do stejné operace uber.

description

string

popis události.

eventDataId

string

ID dat události. Toto je jedinečný identifikátor události.

eventName

LocalizableString

název události. Tato hodnota by neměla být zaměňována s OperationName. Pro praktické účely může být OperationName pro koncové uživatele zajímavější.

eventTimestamp

string (date-time)

časové razítko, kdy událost vygenerovala služba Azure, zpracovává požadavek odpovídající události. Je ve formátu ISO 8601.

httpRequest

HttpRequestInfo

informace o požadavku HTTP. Obvykle zahrnuje "clientRequestId", "clientIpAddress" (IP adresa uživatele, který inicioval událost) a metodu (metodu HTTP, např. PUT).

id

string

ID této události, jak vyžaduje ARM pro RBAC. Obsahuje ID Události a informace o časovém razítku.

level

EventLevel

úroveň události

operationId

string

Obvykle se jedná o identifikátor GUID sdílený mezi událostmi odpovídajícími jedné operaci. Tato hodnota by neměla být zaměňována s EventName.

operationName

LocalizableString

název operace.

properties

object

sada <Klíč, hodnota> páry (obvykle slovníkový<řetězec, řetězec>), který obsahuje podrobnosti o události.

resourceGroupName

string

název skupiny prostředků ovlivněného prostředku.

resourceId

string

identifikátor URI prostředku, který jednoznačně identifikuje prostředek, který způsobil tuto událost.

resourceProviderName

LocalizableString

název poskytovatele prostředků ovlivněného prostředku.

resourceType

LocalizableString

typ prostředku

status

LocalizableString

řetězec popisující stav operace. Mezi typické hodnoty patří: Spuštěno, Probíhá, Úspěch, Selhání, Vyřešeno.

subStatus

LocalizableString

dílčí stav události. Ve většině případů, když je tato funkce zahrnuta, zachycuje stavový kód HTTP volání REST. Mezi běžné hodnoty patří: OK (stavový kód HTTP: 200), vytvoření (stavový kód HTTP: 201), přijato (stavový kód HTTP: 202), bez obsahu (stavový kód HTTP: 204), chybný požadavek (stavový kód HTTP: 400) ), Nenalezena (stavový kód HTTP: 404), konflikt (stavový kód HTTP: 409), vnitřní chyba serveru (stavový kód HTTP: 500), nedostupná služba (stavový kód HTTP:503), vypršení časového limitu brány (stavový kód HTTP: 504)

submissionTimestamp

string (date-time)

časové razítko, kdy byla událost k dispozici pro dotazování prostřednictvím tohoto rozhraní API. Je ve formátu ISO 8601. Tato hodnota by neměla být zmatená eventTimestamp. Vzhledem k tomu, že mezi časem výskytu události a časem odeslání události do infrastruktury protokolování Azure může dojít ke zpoždění.

subscriptionId

string

ID předplatného Azure obvykle identifikátor GUID.

tenantId

string

ID tenanta Azure

EventDataCollection

Představuje kolekci událostí.

Name Typ Description
nextLink

string

Poskytuje odkaz pro načtení další sady událostí.

value

EventData[]

tento seznam obsahuje protokoly auditu Azure.

EventLevel

úroveň události

Hodnota Description
Critical
Error
Warning
Informational
Verbose

HttpRequestInfo

Informace o požadavku HTTP.

Name Typ Description
clientIpAddress

string

IP adresa klienta

clientRequestId

string

ID požadavku klienta.

method

string

metoda požadavku HTTP.

uri

string

identifikátor URI.

LocalizableString

Lokalizovatelná třída řetězce.

Name Typ Description
localizedValue

string

konkrétní hodnotu národního prostředí.

value

string

invariantní hodnota.

SenderAuthorization

autorizaci použitou uživatelem, který provedl operaci, která vedla k této události. Tím se zachytí vlastnosti RBAC události. Obvykle se jedná o akci, roli a obor.

Name Typ Description
action

string

přípustné akce. Například: microsoft.support/supporttickets/write

role

string

role uživatele. Příklad: Správce předplatného

scope

string

rozsah.