共用方式為


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 參數

名稱 位於 必要 類型 Description
api-version
query True

string

用於此作業的 API 版本。

$filter
query

string

減少收集的數據集。
$filter非常受限,只允許下列模式。
- 列出資源群組的事件:$filter=eventTimestamp ge '' 和 eventTimestamp le '' 和 eventChannels eq '管理員, Operation' and resourceGroupName eq ''。
- 列出資源的事件:$filter=eventTimestamp ge '' 和 eventTimestamp le '' 和 eventChannels eq '管理員, Operation' and resourceUri eq ''。
- 列出訂用帳戶的事件:$filter=eventTimestamp ge '' 和 eventTimestamp le '' 和 eventChannels eq '管理員, Operation'。
- 列出資源提供者的事件:$filter=eventTimestamp ge '' 和 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自變數是要傳回的屬性名稱逗號分隔清單。 可能的值為:authorizationclaimscorrelationIddescriptioneventDataIdeventNameeventTimestamphttpRequestleveloperationId、operationNamepropertiesresourceGroupNameresourceProviderNameresourceIdstatussubmissionTimestampsubStatussubscriptionId

回應

名稱 類型 Description
200 OK

EventDataCollection

成功要求以取得租用戶活動記錄中的事件頁面

Other Status Codes

ErrorResponse

描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱 Description
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=######"
}

定義

名稱 Description
ErrorResponse

描述錯誤回應的格式。

EventData

Azure 事件記錄檔項目的類型為 EventData

EventDataCollection

表示事件的集合。

EventLevel

事件層級

HttpRequestInfo

Http 要求資訊。

LocalizableString

可本地化的字串類別。

SenderAuthorization

執行導致此事件之作業的使用者所使用的授權。 這會擷取事件的 RBAC 屬性。 這些通常包括 'action'、'role' 和 'scope'

ErrorResponse

描述錯誤回應的格式。

名稱 類型 Description
code

string

錯誤碼

message

string

錯誤訊息,指出作業失敗的原因。

EventData

Azure 事件記錄檔項目的類型為 EventData

名稱 類型 Description
authorization

SenderAuthorization

寄件者授權資訊。

caller

string

已根據可用性執行作業、UPN 宣告或 SPN 宣告的使用者電子郵件位址。

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 要求資訊。 通常包括起始事件) 和 'method' (HTTP 方法之使用者的 'clientRequestId'、'clientIpAddress' (IP 位址,例如 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

描述作業狀態的字串。 一些典型的值為:Started、In progress、Succeeded、Failed、Resolved。

subStatus

LocalizableString

事件子狀態。 大部分時候,當包含時,這會擷取 REST 呼叫的 HTTP 狀態代碼。 常見的值為:OK (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 訂用帳戶標識碼通常是 GUID。

tenantId

string

Azure 租用戶標識碼

EventDataCollection

表示事件的集合。

名稱 類型 Description
nextLink

string

提供連結以擷取下一組事件。

value

EventData[]

此清單包含 Azure 稽核記錄。

EventLevel

事件層級

名稱 類型 Description
Critical

string

Error

string

Informational

string

Verbose

string

Warning

string

HttpRequestInfo

Http 要求資訊。

名稱 類型 Description
clientIpAddress

string

用戶端IP位址

clientRequestId

string

用戶端要求標識碼。

method

string

Http 要求方法。

uri

string

URI。

LocalizableString

可本地化的字串類別。

名稱 類型 Description
localizedValue

string

地區設定特定值。

value

string

非變異值。

SenderAuthorization

執行導致此事件之作業的使用者所使用的授權。 這會擷取事件的 RBAC 屬性。 這些通常包括 'action'、'role' 和 'scope'

名稱 類型 Description
action

string

允許的動作。 例如:microsoft.support/supporttickets/write

role

string

使用者的角色。 例如:訂用帳戶 管理員

scope

string

範圍。