Partilhar via


Audit operations - Gets Audit Records

Obtém os registros de auditoria entre um determinado intervalo de datas Se o número de registros for maior que uma página cheia, um token de continuação será retornado e o token de continuação poderá ser usado para obter o próximo conjunto de registros de auditoria. Este serviço suporta apenas a recuperação AuditRecord dos últimos 90 dias e uma janela máxima de 30 dias.

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}

Parâmetros do URI

Name Em Necessário Tipo 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

Cabeçalho do Pedido

Name Necessário Tipo Description
Authorization True

string

Token de autenticação do portador

ms-correlationid

string

ID de correlação

ms-requestid

string

ID do pedido

Respostas

Name Tipo Description
200 OK

PagedResourceCollection[AuditRecord]

O pedido foi bem-sucedido. O corpo da resposta contém uma lista dos registros de auditoria que correspondem ao filtro. Um token de continuação será incluído se a resposta for paginada pelo tamanho da página. Esse token pode ser passado para /auditRecords?seek= para buscar resultados de auditoria.

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

400 Bad Request

Havia uma entrada ausente ou inválida. O corpo da resposta fornecerá os detalhes do erro.

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

401 Unauthorized

O pedido não foi autenticado. O cliente precisa se autenticar com o serviço de API do parceiro primeiro.

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

403 Forbidden

O pedido foi autenticado, mas foi recusado, uma vez que o autor da chamada não tem o direito de o invocar.

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

404 Not Found

O recurso não é encontrado ou não está disponível com os parâmetros de entrada fornecidos.

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

500 Internal Server Error

O serviço de API do parceiro ou uma de suas dependências não conseguiu atender à solicitação. Os chamadores podem tentar novamente.

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

Segurança

Authorization

Token de autenticação do portador

Tipo: apiKey
Em: header

Definições

Name Description
AuditRecord
KeyValuePair[String,String]
Link
PagedResourceCollection[AuditRecord]
ResourceAttributes
ResourceLinks

AuditRecord

Name Tipo 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]

Name Tipo Description
key

string

value

string

Name Tipo Description
body

string

headers

KeyValuePair[String,String][]

method

string

uri

string

PagedResourceCollection[AuditRecord]

Name Tipo Description
attributes

ResourceAttributes

continuationToken

string

items

AuditRecord[]

links

ResourceLinks

totalCount

integer

ResourceAttributes

Name Tipo Description
etag

string

objectType

string

Name Tipo Description
next

Link

previous

Link

self

Link