Actualizar mobileAppInstallStatusUpdate mobileAppInstallStatus

Espacio de nombres: microsoft.graphNamespace: 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.Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Actualice las propiedades de un objeto mobileAppInstallStatus .Update the properties of a mobileAppInstallStatus object.

Requisitos previosPrerequisites

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.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permisoPermission type Permisos (de más a menos privilegiados)Permissions (from most to least privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account) DeviceManagementApps.ReadWrite.AllDeviceManagementApps.ReadWrite.All
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No admitida.Not supported.
AplicaciónApplication DeviceManagementApps.ReadWrite.AllDeviceManagementApps.ReadWrite.All

Solicitud HTTPHTTP Request

PATCH /deviceAppManagement/mobileApps/{mobileAppId}/deviceStatuses/{mobileAppInstallStatusId}
PATCH /deviceAppManagement/mobileApps/{mobileAppId}/userStatuses/{userAppInstallStatusId}/deviceStatuses/{mobileAppInstallStatusId}

Encabezados de solicitudRequest headers

EncabezadoHeader ValorValue
AuthorizationAuthorization Se requiere <token> de portador.Bearer <token> Required.
AceptarAccept application/jsonapplication/json

Cuerpo de la solicitudRequest body

En el cuerpo de la solicitud, especifique una representación JSON del objeto mobileAppInstallStatus .In the request body, supply a JSON representation for the mobileAppInstallStatus object.

En la tabla siguiente se muestran las propiedades necesarias para crear el mobileAppInstallStatus.The following table shows the properties that are required when you create the mobileAppInstallStatus.

PropiedadProperty TipoType DescripciónDescription
idid CadenaString Clave de la entidad.Key of the entity.
deviceNamedeviceName CadenaString Nombre del dispositivoDevice name
deviceIddeviceId CadenaString IDENTIFICADOR de dispositivoDevice ID
lastSyncDateTimelastSyncDateTime DateTimeOffsetDateTimeOffset Fecha y hora de la última sincronizaciónLast sync date time
mobileAppInstallStatusValuemobileAppInstallStatusValue resultantAppStateresultantAppState El estado de instalación de la aplicación.The install state of the app. Valores posibles: installed, failed, notInstalled, uninstallFailed, pendingInstall, unknown, notApplicable.Possible values are: installed, failed, notInstalled, uninstallFailed, pendingInstall, unknown, notApplicable.
installStateinstallState resultantAppStateresultantAppState El estado de instalación de la aplicación.The install state of the app. Valores posibles: installed, failed, notInstalled, uninstallFailed, pendingInstall, unknown, notApplicable.Possible values are: installed, failed, notInstalled, uninstallFailed, pendingInstall, unknown, notApplicable.
installStateDetailinstallStateDetail resultantAppStateDetailresultantAppStateDetail Los detalles del estado de la instalación de la aplicación.The install state detail of the app. Los valores posibles son: noAdditionalDetails , dependencyFailedToInstall , dependencyWithRequirementsNotMet , dependencyPendingReboot ,,, dependencyWithAutoInstallDisabled iosAppStoreUpdateFailedToInstall vppAppHasUpdateAvailable ,,, userRejectedUpdate seeInstallErrorCode autoInstallDisabled managedAppNoLongerPresent userRejectedInstall userIsNotLoggedIntoAppStore seeUninstallErrorCode pendingReboot installingDependencies contentDownloaded powerShellScriptRequirementNotMet registryRequirementNotMet fileSystemRequirementNotMet platformNotApplicable minimumCpuSpeedNotMet minimumLogicalProcessorCountNotMet minimumPhysicalMemoryNotMet minimumOsVersionNotMet minimumDiskSpaceNotMet processorArchitectureNotApplicable ,,,,,,,,,,,,,,,, y.Possible values are: noAdditionalDetails, dependencyFailedToInstall, dependencyWithRequirementsNotMet, dependencyPendingReboot, dependencyWithAutoInstallDisabled, iosAppStoreUpdateFailedToInstall, vppAppHasUpdateAvailable, userRejectedUpdate, seeInstallErrorCode, autoInstallDisabled, managedAppNoLongerPresent, userRejectedInstall, userIsNotLoggedIntoAppStore, seeUninstallErrorCode, pendingReboot, installingDependencies, contentDownloaded, powerShellScriptRequirementNotMet, registryRequirementNotMet, fileSystemRequirementNotMet, platformNotApplicable, minimumCpuSpeedNotMet, minimumLogicalProcessorCountNotMet, minimumPhysicalMemoryNotMet, minimumOsVersionNotMet, minimumDiskSpaceNotMet, processorArchitectureNotApplicable.
errorCodeerrorCode Int32Int32 Código de error de los errores de instalación o desinstalación.The error code for install or uninstall failures.
osVersionosVersion CadenaString Versión del sistema operativoOS Version
osDescriptionosDescription StringString Descripción del sistema operativoOS Description
userNameuserName CadenaString Nombre de usuario del dispositivoDevice User Name
userPrincipalNameuserPrincipalName CadenaString Nombre principal de usuarioUser Principal Name
displayVersiondisplayVersion CadenaString Versión para usuarios legibles de la aplicaciónHuman readable version of the application

RespuestaResponse

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto mobileAppInstallStatus actualizado en el cuerpo de la respuesta.If successful, this method returns a 200 OK response code and an updated mobileAppInstallStatus object in the response body.

EjemploExample

SolicitudRequest

Aquí tiene un ejemplo de la solicitud.Here is an example of the request.

PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}/deviceStatuses/{mobileAppInstallStatusId}
Content-type: application/json
Content-length: 555

{
  "@odata.type": "#microsoft.graph.mobileAppInstallStatus",
  "deviceName": "Device Name value",
  "deviceId": "Device Id value",
  "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
  "mobileAppInstallStatusValue": "failed",
  "installState": "failed",
  "installStateDetail": "dependencyFailedToInstall",
  "errorCode": 9,
  "osVersion": "Os Version value",
  "osDescription": "Os Description value",
  "userName": "User Name value",
  "userPrincipalName": "User Principal Name value",
  "displayVersion": "Display Version value"
}

RespuestaResponse

Aquí tiene un ejemplo de la respuesta. Nota: Puede que el objeto de respuesta que aparece aquí se trunque para abreviar. Todas las propiedades se devolverán de una llamada real.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

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

{
  "@odata.type": "#microsoft.graph.mobileAppInstallStatus",
  "id": "7560ee45-ee45-7560-45ee-607545ee6075",
  "deviceName": "Device Name value",
  "deviceId": "Device Id value",
  "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
  "mobileAppInstallStatusValue": "failed",
  "installState": "failed",
  "installStateDetail": "dependencyFailedToInstall",
  "errorCode": 9,
  "osVersion": "Os Version value",
  "osDescription": "Os Description value",
  "userName": "User Name value",
  "userPrincipalName": "User Principal Name value",
  "displayVersion": "Display Version value"
}