Actualizar remoteActionAudit

Espacio de nombres: microsoft.graph

Importante: Las API de Microsoft Graph en la versión /beta están sujetas a cambios; no se admite el uso de producción.

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.

Actualice las propiedades de un objeto remoteActionAudit .

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global	Gobierno de EE. UU. L4	Us Government L5 (DOD)	China operada por 21Vianet
✅	✅	✅	✅

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso	Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa)	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All
Delegado (cuenta personal de Microsoft)	No admitida.
Aplicación	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All

Solicitud HTTP

PATCH /deviceManagement/remoteActionAudits/{remoteActionAuditId}

Encabezados de solicitud

Encabezado	Valor
Authorization	{token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Aceptar	application/json

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON para el objeto remoteActionAudit .

En la tabla siguiente se muestran las propiedades necesarias al crear remoteActionAudit.

Propiedad	Tipo	Descripción
id	Cadena	Id. de informe.
deviceDisplayName	Cadena	Intune nombre del dispositivo.
userName	Cadena	[en desuso] En su lugar, use InitiatedByUserPrincipalName.
initiatedByUserPrincipalName	Cadena	El usuario que inició la acción del dispositivo, el formato es UPN.
acción	remoteAction	Nombre de la acción. Los valores posibles son: , , , , , enableLostModeremoteLock, locateDevicerecoverPasscodedisableLostModerebootNow, cleanWindowsDevice, activateDeviceEsimfullScanquickScangetFileVaultKeyrotateBitLockerKeysrotateFileVaultKeyshutDownautomaticRedeploymentsetDeviceNamedeprovisioninitiateMobileDeviceManagementKeyRecoveryreenabledisablefactoryResetKeepEnrollmentDatainitiateOnDemandProactiveRemediationlogoutSharedAppleDeviceActiveUserrotateLocalAdminPasswordlaunchRemoteHelpwindowsDefenderUpdateSignaturesmoveDeviceToOrganizationalUnitupdateDeviceAccountunknownFutureValue, revokeAppleVppLicensesremoveDeviceFirmwareConfigurationInterfaceManagement, . changeAssignmentspauseConfigurationRefreshinitiateDeviceAttestationdeleteresetPasscoderemoveCompanyDatafactoryResetunknown
requestDateTime	DateTimeOffset	Hora a la que se emitió la acción, dada en UTC.
deviceOwnerUserPrincipalName	Cadena	Upn del propietario del dispositivo.
deviceIMEI	Cadena	IMEI del dispositivo.
actionState	actionState	Estado de acción. Valores posibles: none, pending, canceled, active, done, failed, notSupported.
managedDeviceId	Cadena	Destino de acción.
deviceActionDetails	colección keyValuePair_2OfString_String	Detalles de DeviceAction
deviceActionCategory	deviceActionCategory	Categoría DeviceAction. Los valores posibles son single y bulk.
bulkDeviceActionId	Cadena	Identificador de BulkAction

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto remoteActionAudit actualizado en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

PATCH https://graph.microsoft.com/beta/deviceManagement/remoteActionAudits/{remoteActionAuditId}
Content-type: application/json
Content-length: 713

{
  "@odata.type": "#microsoft.graph.remoteActionAudit",
  "deviceDisplayName": "Device Display Name value",
  "userName": "User Name value",
  "initiatedByUserPrincipalName": "Initiated By User Principal Name value",
  "action": "factoryReset",
  "requestDateTime": "2017-01-01T00:03:07.1589002-08:00",
  "deviceOwnerUserPrincipalName": "Device Owner User Principal Name value",
  "deviceIMEI": "Device IMEI value",
  "actionState": "pending",
  "managedDeviceId": "Managed Device Id value",
  "deviceActionDetails": [
    {
      "@odata.type": "microsoft.graph.keyValuePair_2OfString_String"
    }
  ],
  "deviceActionCategory": "bulk",
  "bulkDeviceActionId": "Bulk Device Action Id value"
}

Respuesta

Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 762

{
  "@odata.type": "#microsoft.graph.remoteActionAudit",
  "id": "477f8d24-8d24-477f-248d-7f47248d7f47",
  "deviceDisplayName": "Device Display Name value",
  "userName": "User Name value",
  "initiatedByUserPrincipalName": "Initiated By User Principal Name value",
  "action": "factoryReset",
  "requestDateTime": "2017-01-01T00:03:07.1589002-08:00",
  "deviceOwnerUserPrincipalName": "Device Owner User Principal Name value",
  "deviceIMEI": "Device IMEI value",
  "actionState": "pending",
  "managedDeviceId": "Managed Device Id value",
  "deviceActionDetails": [
    {
      "@odata.type": "microsoft.graph.keyValuePair_2OfString_String"
    }
  ],
  "deviceActionCategory": "bulk",
  "bulkDeviceActionId": "Bulk Device Action Id value"
}