Tenant Activity Logs - List

  • Referência
Service:
Monitor
API Version:
2015-04-01

Obtém os Registos de Atividades do Inquilino.
Tudo o que é aplicável à API para obter os Registos de Atividades da subscrição é aplicável a esta API (os parâmetros, $filter, etc.).
Uma coisa a salientar aqui é que esta API não obtém os registos na subscrição individual do inquilino, mas apenas apresenta os registos que foram gerados ao nível do inquilino.

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

Parâmetros do URI

Name Em Necessário Tipo Description
api-version
 query True

string

A versão da API a utilizar para esta operação.
$filter
 query

string

Reduz o conjunto de dados recolhidos.
A $filter é muito restrita e permite apenas os seguintes padrões.
- Listar eventos para um grupo de recursos: $filter=eventTimestamp ge '' e eventTimestamp le '' e eventChannels eq 'Administração, Operation' e resourceGroupName eq ''.
- Listar eventos para o recurso: $filter=eventTimestamp ge '' e eventTimestamp le '' e eventChannels eq 'Administração, Operation' e resourceUri eq ''.
- Listar eventos para uma subscrição: $filter=eventTimestamp ge '' e eventTimestamp le '' e eventChannels eq 'Administração, Operation'.
- Listar eventos para um fornecedor de recursos: $filter=eventTimestamp ge '' e eventTimestamp le '' e eventChannels eq 'Administração, Operation' e resourceProvider eq ''.
- Listar eventos para um ID de correlação: api-version=2014-04-01&$filter=eventTimestamp ge '2014-07-16T04:36:37.6407898Z' e eventTimestamp le '2014-07-20T04:36:37.6407898Z' e eventChannels eq 'Administração, Operation' e correlationId eq ''.
NOTA: não é permitida outra sintaxe.
$select
 query

string

Utilizado para obter eventos apenas com as propriedades especificadas.
O argumento $select é uma lista separada por vírgulas de nomes de propriedade a serem devolvidos. Os valores possíveis são: authorization, claims, correlationId, description, eventDataId, eventName, eventTimestamp, httpRequest, level, operationId, operationName, properties, resourceGroupName, resourceProviderName, resourceId, status, submissionTimestamp, subStatus, subscriptionId

Respostas

Name Tipo Description
200 OK

EventDataCollection

Pedido com êxito para obter uma página de eventos nos registos de atividades do inquilino
Other Status Codes

ErrorResponse

Resposta de erro que descreve o motivo pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

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

Sample Request

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'

Sample Response

Status code:
200 
{
  "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

Sample Request

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

Sample Response

Status code:
200 
{
  "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

Sample Request

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

Sample Response

Status code:
200 
{
  "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

Sample Request

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

Sample Response

Status code:
200 
{
  "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=######"
}

Definições

Name Description
ErrorResponse

Descreve o formato da resposta de Erro.
EventData

As entradas do registo de eventos do Azure são do tipo EventData
EventDataCollection

Representa uma coleção de eventos.
EventLevel

o nível de evento
HttpRequestInfo

As informações do pedido Http.
LocalizableString

A classe de cadeia localizável.
SenderAuthorization

a autorização utilizada pelo utilizador que efetuou a operação que levou a este evento. Esta ação captura as propriedades RBAC do evento. Normalmente, estas incluem a "ação", a "função" e o "âmbito"

ErrorResponse

Descreve o formato da resposta de Erro.

Name Tipo Description
code

string

Código de erro
message

string

Mensagem de erro a indicar o motivo pela qual a operação falhou.

EventData

As entradas do registo de eventos do Azure são do tipo EventData

Name Tipo Description
authorization

SenderAuthorization

As informações de autorização do remetente.
caller

string

o endereço de e-mail do utilizador que efetuou a operação, a afirmação upn ou afirmação SPN com base na disponibilidade.
category

LocalizableString

a categoria de evento.
claims

object

pares chave valor para identificar permissões arm.
correlationId

string

o ID de correlação, normalmente um GUID no formato de cadeia. O ID de correlação é partilhado entre os eventos que pertencem à mesma operação uber.
description

string

a descrição do evento.
eventDataId

string

o ID de dados do evento. Este é um identificador exclusivo para um evento.
eventName

LocalizableString

o nome do evento. Este valor não deve ser confundido com OperationName. Para fins práticos, o OperationName pode ser mais apelativo para os utilizadores finais.
eventTimestamp

string

o carimbo de data/hora de quando o evento foi gerado pelo serviço do Azure a processar o pedido correspondente ao evento. Está no formato ISO 8601.
httpRequest

HttpRequestInfo

as informações do pedido HTTP. Normalmente, inclui "clientRequestId", "clientIpAddress" (endereço IP do utilizador que iniciou o evento) e "método" (método HTTP, por exemplo, PUT).
id

string

o ID deste evento, conforme exigido pelo ARM para RBAC. Contém o EventDataID e uma informação de carimbo de data/hora.
level

EventLevel

o nível de evento
operationId

string

Normalmente, é um GUID partilhado entre os eventos correspondentes a uma única operação. Este valor não deve ser confundido com EventName.
operationName

LocalizableString

o nome da operação.
properties

object

o conjunto de <pares Chave, Valor> (normalmente uma Cadeia de Dicionário<, Cadeia>) que inclui detalhes sobre o evento.
resourceGroupName

string

o nome do grupo de recursos do recurso afetado.
resourceId

string

o URI do recurso que identifica exclusivamente o recurso que causou este evento.
resourceProviderName

LocalizableString

o nome do fornecedor de recursos do recurso afetado.
resourceType

LocalizableString

o tipo de recurso
status

LocalizableString

uma cadeia que descreve o estado da operação. Alguns valores típicos são: Iniciado, Em curso, Com Êxito, Com Falhas, Resolvido.
subStatus

LocalizableString

o subestatório do evento. Na maioria das vezes, quando incluído, esta ação captura o código de estado HTTP da chamada REST. Os valores comuns são: OK (Código de Estado HTTP: 200), Criado (Código de Estado HTTP: 201), Aceite (Código de Estado HTTP: 202), Sem Conteúdo (Código de Estado HTTP: 204), Pedido Incorreto(Código de Estado HTTP: 400), Não Encontrado (Código de Estado HTTP: 404), Conflito (Código de Estado HTTP: 409), Erro interno do Servidor (Código de Estado HTTP: 500), Serviço Indisponível (Código de Estado HTTP:503), Tempo Limite do Gateway (Código de Estado HTTP: 504)
submissionTimestamp

string

o carimbo de data/hora de quando o evento ficou disponível para consulta através desta API. Está no formato ISO 8601. Este valor não deve ser confuso eventTimestamp. Como pode haver um atraso entre a hora da ocorrência do evento e a hora em que o evento é submetido para a infraestrutura de registo do Azure.
subscriptionId

string

normalmente, o ID da subscrição do Azure é um GUID.
tenantId

string

o ID do inquilino do Azure

EventDataCollection

Representa uma coleção de eventos.

Name Tipo Description
nextLink

string

Fornece a ligação para obter o próximo conjunto de eventos.
value

EventData[]

esta lista que inclui os registos de auditoria do Azure.

EventLevel

o nível de evento

Name Tipo Description
Critical

string

Error

string

Informational

string

Verbose

string

Warning

string

HttpRequestInfo

As informações do pedido Http.

Name Tipo Description
clientIpAddress

string

o Endereço IP do cliente
clientRequestId

string

o ID do pedido do cliente.
method

string

o método de pedido Http.
uri

string

o Uri.

LocalizableString

A classe de cadeia localizável.

Name Tipo Description
localizedValue

string

o valor específico da região.
value

string

o valor invariante.

SenderAuthorization

a autorização utilizada pelo utilizador que efetuou a operação que levou a este evento. Esta ação captura as propriedades RBAC do evento. Normalmente, estas incluem a "ação", a "função" e o "âmbito"

Name Tipo Description
action

string

as ações permitidas. Por exemplo: microsoft.support/supporttickets/write
role

string

a função do utilizador. Por exemplo: subscrição Administração
scope

string

o âmbito.