共用方式為


Audit operations - Gets Audit Records

取得指定日期範圍之間的稽核記錄如果記錄數目超過頁面完整,則會傳回接續令牌,而且接續令牌可用來取得下一組稽核記錄。 此服務僅支持過去 90 天的 AuditRecord 擷取,最多 30 天的時間範圍。

GET https://api.partnercenter.microsoft.com/auditactivity/v{version}/auditrecords?auditRequest.startDate={auditRequest.startDate}
GET https://api.partnercenter.microsoft.com/auditactivity/v{version}/auditrecords?auditRequest.filter.field={auditRequest.filter.field}&auditRequest.filter.value={auditRequest.filter.value}&auditRequest.filter.operator={auditRequest.filter.operator}&auditRequest.startDate={auditRequest.startDate}&auditRequest.endDate={auditRequest.endDate}&auditRequest.size={auditRequest.size}

URI 參數

名稱 位於 必要 類型 Description
version
path True

string

auditRequest.startDate
query True

string

date-time
auditRequest.endDate
query

string

date-time
auditRequest.filter.field
query

string

auditRequest.filter.operator
query

integer

int32
auditRequest.filter.value
query

string

auditRequest.size
query

integer

int32

要求標頭

名稱 必要 類型 Description
Authorization True

string

持有人驗證令牌

ms-correlationid

string

相互關聯標識碼

ms-requestid

string

要求標識碼

回應

名稱 類型 Description
200 OK

PagedResourceCollection[AuditRecord]

要求成功。 回應本文包含符合篩選條件的稽核記錄清單。 如果回應是以頁面大小分頁,則會包含接續令牌。 此令牌可以傳遞至 /auditRecords?seek= 以搜尋稽核結果。

Media Types: "application/json", "text/json"

400 Bad Request

輸入遺失或無效。 回應本文會提供錯誤詳細數據。

Media Types: "application/json", "text/json"

401 Unauthorized

要求未通過驗證。 客戶端必須先向合作夥伴 API 服務進行驗證。

Media Types: "application/json", "text/json"

403 Forbidden

要求已通過驗證,但因為呼叫端沒有叫用要求的許可權而遭到拒絕。

Media Types: "application/json", "text/json"

404 Not Found

找不到資源,或無法使用指定的輸入參數。

Media Types: "application/json", "text/json"

500 Internal Server Error

合作夥伴 API 服務或其其中一個相依性無法滿足要求。 來電者可能會重試此狀況。

Media Types: "application/json", "text/json"

安全性

Authorization

持有人驗證令牌

類型: apiKey
位於: header

定義

名稱 Description
AuditRecord
KeyValuePair[String,String]
Link
PagedResourceCollection[AuditRecord]
ResourceAttributes
ResourceLinks

AuditRecord

名稱 類型 Description
applicationId

string

attributes

ResourceAttributes

customerId

string

customerName

string

customizedData

KeyValuePair[String,String][]

id

string

operationDate

string

operationStatus enum:
  • decline
  • failed
  • progress
  • succeeded
operationType enum:
  • add_application_credential
  • add_customer
  • add_user_member
  • cancel_credit
  • convert_trial_subscription
  • create_agreement
  • create_credit
  • create_customer_user
  • create_mpn_association
  • create_order
  • create_partner_relationship
  • create_partner_user
  • create_referral
  • create_related_referral
  • create_self_serve_policy
  • create_self_serve_policy
  • create_transfer
  • dap_admin_relationship_approved
  • dap_admin_relationship_approved
  • dap_admin_relationship_terminated
  • dap_admin_relationship_terminated
  • delete_customer
  • delete_customer_user
  • delete_self_serve_policy
  • delete_tip_customer
  • device_deleted
  • device_updated
  • devices_update_attempted
  • devices_upload_to_existing_batch_attempted
  • devices_upload_to_new_batch_attempted
  • extend_relationship
  • get_software_download_link
  • get_software_key
  • granular_admin_access_assignment_activated
  • granular_admin_access_assignment_created
  • granular_admin_access_assignment_deleted
  • granular_admin_access_assignment_updated
  • granular_admin_relationship_activated
  • granular_admin_relationship_approved
  • granular_admin_relationship_cleaned_up
  • granular_admin_relationship_expired
  • granular_admin_relationship_terminated
  • granular_admin_relationship_termination_requested
  • increase_spending_limit
  • policy_created
  • policy_deleted
  • policy_updated
  • ready_invoice
  • register_application
  • remove_application_credential
  • remove_partner_customer_relationship
  • remove_partner_relationship
  • remove_partner_user
  • remove_user_member
  • reset_customer_user_password
  • restore_customer_user
  • software_attestation
  • unregister_application
  • update_company_info
  • update_credit
  • update_customer_billing_profile
  • update_customer_partner_contract_company_name
  • update_customer_qualification
  • update_customer_spending_budget
  • update_customer_user
  • update_customer_user_licenses
  • update_customer_user_principal_name
  • update_mpn_association
  • update_order
  • update_partner_user
  • update_referral
  • update_related_referral
  • update_self_serve_policy
  • update_sfb_customer_user_licenses
  • update_subscription
  • update_transfer
  • upgrade_subscription
originalCorrelationId

string

partnerId

string

resourceNewValue

string

resourceOldValue

string

resourceType enum:
  • agreement
  • application
  • application_credential
  • credit
  • customer
  • customer_directory_role
  • customer_user
  • device
  • granular_admin_access_assignment
  • granular_admin_relationship
  • invoice
  • license
  • mpn_association
  • order
  • partner_customer_dap
  • partner_customer_relationship
  • partner_relationship
  • partner_user
  • policy
  • referral
  • self_serve_policy
  • software_download_link
  • software_key
  • software_page
  • spending_limit
  • subscription
  • third_party_add_on
  • transfer
sessionId

string

userPrincipalName

string

KeyValuePair[String,String]

名稱 類型 Description
key

string

value

string

名稱 類型 Description
body

string

headers

KeyValuePair[String,String][]

method

string

uri

string

PagedResourceCollection[AuditRecord]

名稱 類型 Description
attributes

ResourceAttributes

continuationToken

string

items

AuditRecord[]

links

ResourceLinks

totalCount

integer

ResourceAttributes

名稱 類型 Description
etag

string

objectType

string

名稱 類型 Description
next

Link

previous

Link

self

Link