Condividi tramite


Audit operations - Gets Audit Records

Ottiene i record di controllo tra un intervallo di date specificato Se il numero di record è maggiore di una pagina piena, verrà restituito un token di continuazione e il token di continuazione può essere usato per ottenere il set successivo di record di controllo. Questo servizio supporta solo il recupero AuditRecord per gli ultimi 90 giorni e una finestra massima di 30 giorni.

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}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
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

Intestazione della richiesta

Nome Necessario Tipo Descrizione
Authorization True

string

Token di autenticazione di connessione

ms-correlationid

string

ID correlazione

ms-requestid

string

ID richiesta

Risposte

Nome Tipo Descrizione
200 OK

PagedResourceCollection[AuditRecord]

La richiesta ha avuto esito positivo. Il corpo della risposta contiene un elenco dei record di controllo che corrispondono al filtro. Se la risposta viene inserita in pagine in base alle dimensioni della pagina, viene incluso un token di continuazione. Questo token può essere passato a /auditRecords?seek= per cercare i risultati del controllo.

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

400 Bad Request

Non è presente un input mancante o non valido. Il corpo della risposta fornirà i dettagli dell'errore.

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

401 Unauthorized

La richiesta non è stata autenticata. Il client deve prima eseguire l'autenticazione con il servizio API partner.

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

403 Forbidden

La richiesta è stata autenticata ma è stata rifiutata perché il chiamante non dispone dei diritti per richiamarlo.

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

404 Not Found

La risorsa non viene trovata o non è disponibile con i parametri di input specificati.

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

500 Internal Server Error

Il servizio API partner o una delle relative dipendenze non è riuscito a soddisfare la richiesta. I chiamanti possono riprovare.

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

Sicurezza

Authorization

Token di autenticazione di connessione

Tipo: apiKey
In: header

Definizioni

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

AuditRecord

Nome Tipo Descrizione
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 Descrizione
key

string

value

string

Nome Tipo Descrizione
body

string

headers

KeyValuePair[String,String][]

method

string

uri

string

PagedResourceCollection[AuditRecord]

Nome Tipo Descrizione
attributes

ResourceAttributes

continuationToken

string

items

AuditRecord[]

links

ResourceLinks

totalCount

integer

ResourceAttributes

Nome Tipo Descrizione
etag

string

objectType

string

Nome Tipo Descrizione
next

Link

previous

Link

self

Link