Поделиться через


Tenant Activity Logs - List

Возвращает журналы действий для клиента.
Все, что применимо к API для получения журналов действий для подписки, применимо к этому API (параметры, $filter и т. д.).
Следует отметить, что этот API не извлекает журналы в отдельной подписке клиента, а только отображает журналы, созданные на уровне клиента.

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

Имя В Обязательно Тип Описание
api-version
query True

string

Версия API, используемая для данной операции.

$filter
query

string

Сокращает набор собираемых данных.
$filter очень ограничена и допускает только следующие шаблоны.
— Список событий для группы ресурсов: $filter=eventTimestamp ge '' and eventTimestamp le '' and eventChannels eq 'Администратор, Operation' и resourceGroupName eq ''.
— Список событий для ресурса: $filter=eventTimestamp ge '' and eventTimestamp le '' and eventChannels eq 'Администратор, Operation' и resourceUri eq ''.
— Список событий для подписки: $filter=eventTimestamp ge '' and eventTimestamp le '' and eventChannels eq 'Администратор, Operation'.
— Список событий для поставщика ресурсов: $filter=eventTimestamp ge '' and eventTimestamp le '' and eventChannels eq 'Администратор, Operation' and resourceProvider eq ''.
— Список событий для идентификатора корреляции: api-version=2014-04-01&$filter=eventTimestamp ge '2014-07-16T04:36:37.6407898Z и eventTimestamp le '2014-07-20T04:36:37.6407898Z' и eventChannels eq 'Администратор, Operation' and correlationId eq ''.
ПРИМЕЧАНИЕ. Другие синтаксисы не допускаются.

$select
query

string

Используется для получения событий только с заданными свойствами.
Аргумент $select представляет собой список возвращаемых имен свойств, разделенных запятыми. Возможные значения: authorization, claims, correlationId, description, eventDataId, eventName, eventTimestamp, httpRequest, level, operationId, operationName, properties, resourceGroupName, resourceProviderName, resourceId, status, submissionTimestamp, subStatus, subscriptionId

Ответы

Имя Тип Описание
200 OK

EventDataCollection

Успешный запрос на получение страницы событий в журналах действий клиента

Other Status Codes

ErrorResponse

Ответ об ошибке, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

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

Образец запроса

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'

Пример ответа

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

Образец запроса

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

Пример ответа

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

Образец запроса

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

Пример ответа

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

Образец запроса

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

Пример ответа

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

Определения

Имя Описание
ErrorResponse

Описывает формат ответа об ошибке.

EventData

Записи журнала событий Azure относятся к типу EventData.

EventDataCollection

Представляет коллекцию событий.

EventLevel

уровень событий

HttpRequestInfo

Сведения о HTTP-запросе.

LocalizableString

Локализуемый строковый класс.

SenderAuthorization

авторизация, используемая пользователем, выполнившим операцию, которая привела к этому событию. Это фиксирует свойства RBAC события. Обычно к ним относятся "действие", "роль" и "область".

ErrorResponse

Описывает формат ответа об ошибке.

Имя Тип Описание
code

string

Код ошибки

message

string

Сообщение об ошибке, указывающее, почему операция завершилась сбоем.

EventData

Записи журнала событий Azure относятся к типу EventData.

Имя Тип Описание
authorization

SenderAuthorization

Сведения об авторизации отправителя.

caller

string

адрес электронной почты пользователя, выполнившего операцию, утверждение имени участника-пользователя или имя субъекта-службы в зависимости от доступности.

category

LocalizableString

категория событий.

claims

object

пары "ключ-значение" для определения разрешений ARM.

correlationId

string

Идентификатор корреляции, обычно GUID в строковом формате. Идентификатор корреляции используется совместно между событиями, принадлежащими одной и той же операции uber.

description

string

описание события.

eventDataId

string

идентификатор данных события. Это уникальный идентификатор события.

eventName

LocalizableString

имя события. Это значение не следует путать с OperationName. Для практических целей OperationName может быть более привлекательным для конечных пользователей.

eventTimestamp

string

метку времени, когда событие было создано службой Azure, обрабатывающей запрос, соответствующий событию. Он в формате ISO 8601.

httpRequest

HttpRequestInfo

сведения о HTTP-запросе. Обычно включает "clientRequestId", "clientIpAddress" (IP-адрес пользователя, инициировавшего событие) и "метод" (метод HTTP, например PUT).

id

string

Идентификатор этого события в соответствии с требованиями ARM для RBAC. Он содержит идентификатор EventDataID и сведения о метке времени.

level

EventLevel

уровень событий

operationId

string

Обычно это GUID, совместно используемый для событий, соответствующих одной операции. Это значение не следует путать с EventName.

operationName

LocalizableString

имя операции.

properties

object

набор <пар "ключ- значение> " (обычно это строка словаря<, строка>), который содержит сведения о событии.

resourceGroupName

string

имя группы ресурсов затронутого ресурса.

resourceId

string

универсальный код ресурса (URI), который однозначно идентифицирует ресурс, вызвавшего это событие.

resourceProviderName

LocalizableString

имя поставщика ресурсов затронутого ресурса.

resourceType

LocalizableString

тип ресурса;

status

LocalizableString

строка, описывающая состояние операции. Некоторые типичные значения: Запущено, Выполняется, Успешно, Сбой, Разрешено.

subStatus

LocalizableString

вложенное состояние события. В большинстве случаев при включении он записывает код состояния HTTP вызова REST. Общие значения: ОК (код состояния HTTP: 200), Создано (код состояния HTTP: 201), Принято (код состояния HTTP: 202), Нет содержимого (код состояния HTTP: 204), Недопустимый запрос (код состояния HTTP: 40).0), не найдено (код состояния HTTP: 404), конфликт (код состояния HTTP: 409), внутренняя ошибка сервера (код состояния HTTP: 500), служба недоступна (код состояния HTTP:503), время ожидания шлюза (код состояния HTTP: 504)

submissionTimestamp

string

метка времени, когда событие стало доступным для запроса через этот API. Он имеет формат ISO 8601. Это значение не следует путать eventTimestamp. Так как между временем возникновения события и временем отправки события в инфраструктуру ведения журнала Azure может возникнуть задержка.

subscriptionId

string

Идентификатор подписки Azure обычно является GUID.

tenantId

string

Идентификатор клиента Azure

EventDataCollection

Представляет коллекцию событий.

Имя Тип Описание
nextLink

string

Предоставляет ссылку для получения следующего набора событий.

value

EventData[]

этот список, включающий журналы аудита Azure.

EventLevel

уровень событий

Имя Тип Описание
Critical

string

Error

string

Informational

string

Verbose

string

Warning

string

HttpRequestInfo

Сведения о HTTP-запросе.

Имя Тип Описание
clientIpAddress

string

IP-адрес клиента;

clientRequestId

string

идентификатор запроса клиента.

method

string

метод HTTP-запроса.

uri

string

универсальный код ресурса (URI).

LocalizableString

Локализуемый строковый класс.

Имя Тип Описание
localizedValue

string

конкретное значение языкового стандарта.

value

string

инвариантное значение.

SenderAuthorization

авторизация, используемая пользователем, выполнившим операцию, которая привела к этому событию. Это фиксирует свойства RBAC события. Обычно к ним относятся "действие", "роль" и "область".

Имя Тип Описание
action

string

допустимые действия. Например: microsoft.support/supporttickets/write

role

string

роль пользователя. Например: Администратор подписки

scope

string

область.