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 |
|---|---|---|---|---|
|
subscription
|
path | True |
string minLength: 1 |
Identificador de la suscripción de destino. |
|
$filter
|
query | True |
string |
Reduce el conjunto de datos recopilados. |
|
api-version
|
query | True |
string minLength: 1 |
Versión de la API que se va a usar para esta operación. |
|
$select
|
query |
string |
Se usa para capturar eventos con solo las propiedades especificadas. |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
Solicitud correcta para obtener una página de eventos en los registros de actividad |
|
| Other Status Codes |
Respuesta de error que describe por qué se produjo un error en la operación. |
Seguridad
azure_auth
Flujo de 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 | suplantar la 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 |
|---|---|
|
Error |
Describe el formato de respuesta de error. |
|
Event |
Las entradas del registro de eventos de Azure son de tipo EventData. |
|
Event |
Representa la colección de eventos. |
|
Event |
el nivel de evento |
|
Http |
Información de solicitud Http. |
|
Localizable |
Clase de cadena localizable. |
|
Sender |
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 |
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 |
la categoría del evento. |
|
| 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 |
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 (date-time) |
marca de tiempo de cuando el servicio de Azure generó el evento procesando la solicitud correspondiente al evento. En formato ISO 8601. |
| httpRequest |
la información de la 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 lo requiera ARM para RBAC. Contiene eventDataID y una información de marca de tiempo. |
| level |
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 |
el nombre de la operación. |
|
| properties |
object |
el conjunto de <pares clave, valor> (normalmente un diccionario<cadena, cadena>) que incluye detalles sobre el evento. |
| resourceGroupName |
string |
el nombre del grupo de recursos del recurso afectado. |
| resourceId |
string |
el URI de recurso que identifica de forma única el recurso que provocó este evento. |
| resourceProviderName |
el nombre del proveedor de recursos del recurso afectado. |
|
| resourceType |
el tipo de recurso |
|
| status |
cadena que describe el estado de la operación. Algunos valores típicos son: Started, In progress, Succeeded, Failed, Resolved. |
|
| subStatus |
el subestado del evento. La mayoría de las veces, 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: 400), 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 puerta de enlace (código de estado HTTP: 504) |
|
| submissionTimestamp |
string (date-time) |
marca de tiempo de cuando el evento se puso a disposición para realizar consultas a través de esta API. Está en formato ISO 8601. Este valor no debe confundirse con eventTimestamp. Como puede haber un retraso entre la hora de aparició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 |
esta lista que incluye los registros de auditoría de Azure. |
EventLevel
el nivel de evento
| Valor | Description |
|---|---|
| Critical | |
| Error | |
| Warning | |
| Informational | |
| Verbose |
HttpRequestInfo
Información de 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 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: Administrador de suscripciones |
| scope |
string |
el ámbito. |