Compartilhar 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. Esse serviço dá suporte apenas à recuperação AuditRecord nos últimos 90 dias e a 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 de URI

Nome Em Obrigató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 da solicitação

Nome Obrigatório Tipo Description
Authorization True

string

Token de autenticação de portador

ms-correlationid

string

ID de correlação

ms-requestid

string

ID da solicitação

Respostas

Nome Tipo Description
200 OK

PagedResourceCollection[AuditRecord]

A solicitação foi bem-sucedida. 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

A solicitação não foi autenticada. O cliente precisa se autenticar com o serviço de API do parceiro primeiro.

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

403 Forbidden

A solicitação foi autenticada, mas foi recusada, pois o chamador não tem os direitos de invocá-la.

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

404 Not Found

O recurso não foi 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 falhou ao atender à solicitação. Os chamadores podem repetir isso.

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

Segurança

Authorization

Token de autenticação de portador

Type: apiKey
In: header

Definições

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

AuditRecord

Nome 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]

Nome Tipo Description
key

string

value

string

Nome Tipo Description
body

string

headers

KeyValuePair[String,String][]

method

string

uri

string

PagedResourceCollection[AuditRecord]

Nome Tipo Description
attributes

ResourceAttributes

continuationToken

string

items

AuditRecord[]

links

ResourceLinks

totalCount

integer

ResourceAttributes

Nome Tipo Description
etag

string

objectType

string

Nome Tipo Description
next

Link

previous

Link

self

Link