你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

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 '' 和 eventChannels eq '管理员, Operation' 和 resourceProvider eq ''。
- 列出相关 ID 的事件:api-version=2014-04-01&$filter=eventTimestamp ge '2014-07-16T04:36:37.640789 8Z 和 eventTimestamp le '2014-07-20T04:36:37.6407898Z' 和 eventChannels eq '管理员, Operation' and correlationId eq ''。
注意:不允许使用其他语法。

$select
query

string

用于提取仅具有给定属性的事件。
$select参数是要返回的属性名称的逗号分隔列表。 可能的值包括: authorizationclaimscorrelationIddescriptioneventDataIdeventNameeventTimestamphttpRequestleveloperationIdoperationNamepropertiesresourceGroupNameresourceProviderNameresourceIdstatussubmissionTimestampsubStatussubscriptionId

响应

名称 类型 说明
200 OK

EventDataCollection

成功请求获取租户活动日志中的事件页

Other Status Codes

ErrorResponse

描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流

类型: oauth2
流向: 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 属性。 这些通常包括“action”、“role”和“scope”

ErrorResponse

描述错误响应的格式。

名称 类型 说明
code

string

错误代码

message

string

指示操作失败原因的错误消息。

EventData

Azure 事件日志条目的类型为 EventData

名称 类型 说明
authorization

SenderAuthorization

发件人授权信息。

caller

string

已执行操作的用户的电子邮件地址、UPN 声明或 SPN 声明(基于可用性)。

category

LocalizableString

事件类别。

claims

object

用于标识 ARM 权限的键值对。

correlationId

string

相关性 ID,通常是字符串格式的 GUID。 关联 ID 在属于同一 uber 操作的事件之间共享。

description

string

事件的说明。

eventDataId

string

事件数据 ID。这是事件的唯一标识符。

eventName

LocalizableString

事件名称。 此值不应与 OperationName 混淆。 出于实际目的,OperationName 可能更吸引最终用户。

eventTimestamp

string

处理与事件对应的请求的 Azure 服务生成事件的时间戳。 它采用 ISO 8601 格式。

httpRequest

HttpRequestInfo

HTTP 请求信息。 通常包括发起事件的用户的“clientRequestId”、“clientIpAddress” (IP 地址) 和“method” (HTTP 方法,例如 PUT) 。

id

string

ARM for RBAC 所需的此事件的 ID。 它包含 EventDataID 和时间戳信息。

level

EventLevel

事件级别

operationId

string

它通常是在对应于单个操作的事件之间共享的 GUID。 此值不应与 EventName 混淆。

operationName

LocalizableString

操作名称。

properties

object

<键、值>对集 (通常是包含事件详细信息的字典<字符串、字符串>) 。

resourceGroupName

string

受影响资源的资源组名称。

resourceId

string

唯一标识导致此事件的资源的资源 URI。

resourceProviderName

LocalizableString

受影响资源的资源提供程序名称。

resourceType

LocalizableString

资源类型

status

LocalizableString

描述操作状态的字符串。 一些典型值包括:Started、In progress、Succeeded、Failed、Resolved。

subStatus

LocalizableString

事件子状态。 大多数情况下,如果包含,这会捕获 REST 调用的 HTTP 状态代码。 常见值包括:正常 (HTTP 状态代码:200) 、创建 (HTTP 状态代码:201) 、 接受 (HTTP 状态代码:202) ,无内容 (HTTP 状态代码:204) ,错误请求 (HTTP 状态代码:400) ,找不到 (http 状态代码:404) ,冲突 (HTTP 状态代码:409) ,内部服务器错误 (HTTP 状态代码: 500) ,服务不可用 (HTTP 状态代码:503) ,网关超时 (HTTP 状态代码:504)

submissionTimestamp

string

事件可通过此 API 进行查询的时间戳。 它采用 ISO 8601 格式。 此值不应混淆 eventTimestamp。 因为事件发生时间与将事件提交到 Azure 日志记录基础结构的时间之间可能存在延迟。

subscriptionId

string

Azure 订阅 ID 通常是 GUID。

tenantId

string

Azure 租户 ID

EventDataCollection

表示事件的集合。

名称 类型 说明
nextLink

string

提供用于检索下一组事件的链接。

value

EventData[]

此列表包含 Azure 审核日志。

EventLevel

事件级别

名称 类型 说明
Critical

string

Error

string

Informational

string

Verbose

string

Warning

string

HttpRequestInfo

Http 请求信息。

名称 类型 说明
clientIpAddress

string

客户端 IP 地址

clientRequestId

string

客户端请求 ID。

method

string

Http 请求方法。

uri

string

URI。

LocalizableString

可本地化的字符串类。

名称 类型 说明
localizedValue

string

区域设置特定的值。

value

string

固定值。

SenderAuthorization

执行导致此事件的操作的用户使用的授权。 这会捕获事件的 RBAC 属性。 这些通常包括“action”、“role”和“scope”

名称 类型 说明
action

string

允许的操作。 例如:microsoft.support/supporttickets/write

role

string

用户的角色。 例如:订阅管理员

scope

string

范围。