Compartir a través de


Activity Logs - List

Proporciona la lista de registros de los registros de actividad.

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}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
subscriptionId
path True

string

Identificador de la suscripción de destino.

$filter
query True

string

Reduce el conjunto de datos recopilados.
Este argumento es necesario y también requiere al menos la fecha y la hora de inicio.
El argumento $filter está muy restringido y solo permite los siguientes patrones.
- Enumerar eventos de un grupo de recursos: $filter=eventTimestamp ge '2014-07-16T04:36:37.6407898Z' y eventTimestamp le '2014-07-20T04:36:37.6407898Z' y resourceGroupName eq 'resourceGroupName'.
- Enumerar eventos para el recurso: $filter=eventTimestamp ge '2014-07-16T04:36:37.6407898Z' y eventTimestamp le '2014-07-20T04:36:37.6407898Z' y resourceUri eq 'resourceURI'.
- Enumera los eventos de una suscripción en un intervalo de tiempo: $filter=eventTimestamp ge '2014-07-16T04:36:37.6407898Z' y eventTimestamp le '2014-07-20T04:36:37.6407898Z'.
- Enumeración de eventos para un proveedor de recursos: $filter=eventTimestamp ge '2014-07-16T04:36:37.6407898Z' y eventTimestamp le '2014-07-20T04:36:37.6407898Z' y resourceProvider eq 'resourceProviderName'.
- Enumerar eventos para un identificador de correlación: $filter=eventTimestamp ge '2014-07-16T04:36:37.6407898Z' y eventTimestamp le '2014-07-20T04:36:37.6407898Z' y correlationId eq 'correlationID'.

NOTA: No se permite ninguna otra sintaxis.

api-version
query True

string

Versión de API que se usará para la operación.

$select
query

string

Se usa para capturar eventos con solo las propiedades especificadas.
El argumento $select es una lista separada por comas de nombres de propiedad que se van a devolver. Los valores posibles son: authorization, claims, correlationId, description, eventDataId, eventName, eventTimestamp, httpRequest, level, operationId, operationName, properties, resourceGroupName, resourceProviderName, resourceId, status, submissionTimestamp, subStatus, subscriptionId

Respuestas

Nombre Tipo Description
200 OK

EventDataCollection

Solicitud correcta para obtener una página de eventos en los registros de actividad

Other Status Codes

ErrorResponse

Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

Get Activity Logs with filter
Get Activity Logs with filter and select

Get Activity Logs with filter

Solicitud de ejemplo

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'

Respuesta de muestra

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

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
ErrorResponse

Describe el formato de respuesta de error.

EventData

Las entradas del registro de eventos de Azure son de tipo EventData.

EventDataCollection

Representa la colección de eventos.

EventLevel

el nivel de evento

HttpRequestInfo

La información de la solicitud Http.

LocalizableString

Clase de cadena localizable.

SenderAuthorization

la autorización utilizada por el usuario que ha realizado la operación que llevó a este evento. Esto captura las propiedades RBAC del evento. Normalmente se incluyen "action", "role" y "scope"

ErrorResponse

Describe el formato de respuesta de error.

Nombre Tipo Description
code

string

Código de error

message

string

Mensaje de error que indica por qué se produjo un error en la operación.

EventData

Las entradas del registro de eventos de Azure son de tipo EventData.

Nombre Tipo Description
authorization

SenderAuthorization

Información de autorización del remitente.

caller

string

la dirección de correo electrónico del usuario que ha realizado la operación, la notificación UPN o la notificación SPN en función de la disponibilidad.

category

LocalizableString

la categoría de eventos.

claims

object

pares clave-valor para identificar los permisos de ARM.

correlationId

string

el identificador de correlación, normalmente un GUID en el formato de cadena. El identificador de correlación se comparte entre los eventos que pertenecen a la misma operación uber.

description

string

la descripción del evento.

eventDataId

string

el identificador de datos del evento. Se trata de un identificador único para un evento.

eventName

LocalizableString

el nombre del evento. Este valor no debe confundirse con OperationName. Con fines prácticos, OperationName podría ser más atractivo para los usuarios finales.

eventTimestamp

string

la marca de tiempo de cuando el servicio de Azure generó el evento que procesa la solicitud correspondiente al evento. Está en formato ISO 8601.

httpRequest

HttpRequestInfo

la información de solicitud HTTP. Normalmente incluye "clientRequestId", "clientIpAddress" (dirección IP del usuario que inició el evento) y "method" (método HTTP, por ejemplo, PUT).

id

string

el identificador de este evento según sea necesario para ARM para RBAC. Contiene eventDataID y una información de marca de tiempo.

level

EventLevel

el nivel de evento

operationId

string

Normalmente es un GUID compartido entre los eventos correspondientes a una sola operación. Este valor no debe confundirse con EventName.

operationName

LocalizableString

el nombre de la operación.

properties

object

el conjunto de <pares clave, valor> (normalmente una cadena de diccionario<, cadena>) que incluye detalles sobre el evento.

resourceGroupName

string

el nombre del grupo de recursos del recurso afectado.

resourceId

string

el URI del recurso que identifica de forma única el recurso que provocó este evento.

resourceProviderName

LocalizableString

el nombre del proveedor de recursos del recurso afectado.

resourceType

LocalizableString

el tipo de recurso

status

LocalizableString

una cadena que describe el estado de la operación. Algunos valores típicos son: Started, In progress, Succeeded, Failed, Resolved.

subStatus

LocalizableString

el subestado del evento. La mayor parte del tiempo, cuando se incluye, captura el código de estado HTTP de la llamada REST. Los valores comunes son: Ok (código de estado HTTP: 200), creado (código de estado HTTP: 201), aceptado (código de estado HTTP: 202), sin contenido (código de estado HTTP: 204), solicitud incorrecta (código de estado HTTP: 40)0), no encontrado (código de estado HTTP: 404), conflicto (código de estado HTTP: 409), error interno del servidor (código de estado HTTP: 500), servicio no disponible (código de estado HTTP:503), tiempo de espera de la puerta de enlace (código de estado HTTP: 504)

submissionTimestamp

string

la marca de tiempo de cuando el evento estaba disponible para realizar consultas a través de esta API. Está en formato ISO 8601. Este valor no debe confundirse eventTimestamp. Como puede haber un retraso entre la hora de repetición del evento y la hora en que se envía el evento a la infraestructura de registro de Azure.

subscriptionId

string

el identificador de suscripción de Azure suele ser un GUID.

tenantId

string

el identificador de inquilino de Azure

EventDataCollection

Representa la colección de eventos.

Nombre Tipo Description
nextLink

string

Proporciona el vínculo para recuperar el siguiente conjunto de eventos.

value

EventData[]

esta lista que incluye los registros de auditoría de Azure.

EventLevel

el nivel de evento

Nombre Tipo Description
Critical

string

Error

string

Informational

string

Verbose

string

Warning

string

HttpRequestInfo

La información de la solicitud Http.

Nombre Tipo Description
clientIpAddress

string

la dirección IP del cliente

clientRequestId

string

el identificador de solicitud de cliente.

method

string

el método de solicitud Http.

uri

string

el URI.

LocalizableString

Clase de cadena localizable.

Nombre Tipo Description
localizedValue

string

valor específico de la configuración regional.

value

string

el valor invariable.

SenderAuthorization

la autorización utilizada por el usuario que ha realizado la operación que llevó a este evento. Esto captura las propiedades RBAC del evento. Normalmente se incluyen "action", "role" y "scope"

Nombre Tipo Description
action

string

las acciones permitidas. Por ejemplo: microsoft.support/supporttickets/write

role

string

el rol del usuario. Por ejemplo: Administración de suscripción

scope

string

el ámbito.