Atualizar userAppInstallStatusUpdate userAppInstallStatus

  • 2 minutos para o fim da leitura

Namespace: microsoft.graphNamespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; não há suporte para uso de produção.Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Atualize as propriedades de um objeto userAppInstallStatus.Update the properties of a userAppInstallStatus object.

Pré-requisitosPrerequisites

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegada (conta corporativa ou de estudante)Delegated (work or school account) DeviceManagementApps.ReadWrite.AllDeviceManagementApps.ReadWrite.All
Delegada (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication DeviceManagementApps.ReadWrite.AllDeviceManagementApps.ReadWrite.All

Solicitação HTTPHTTP Request

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

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization <Token> de portador obrigatório.Bearer <token> Required.
AceitarAccept application/jsonapplication/json

Corpo da solicitaçãoRequest body

No corpo da solicitação, fornece uma representação JSON para o objeto userAppInstallStatus.In the request body, supply a JSON representation for the userAppInstallStatus object.

A tabela a seguir mostra as propriedades que são necessárias ao criar o userAppInstallStatus.The following table shows the properties that are required when you create the userAppInstallStatus.

PropriedadeProperty TipoType DescriçãoDescription
idid Cadeia de caracteresString Chave da entidade.Key of the entity.
userNameuserName Cadeia de caracteresString Nome de usuário.User name.
userPrincipalNameuserPrincipalName Cadeia de caracteresString Nome principal do usuário.User Principal Name.
installedDeviceCountinstalledDeviceCount Int32Int32 Contagem de dispositivos instalados.Installed Device Count.
failedDeviceCountfailedDeviceCount Int32Int32 Falha na contagem de dispositivos.Failed Device Count.
notInstalledDeviceCountnotInstalledDeviceCount Int32Int32 Sem contagem de dispositivos instalados.Not installed device count.

RespostaResponse

Se tiver êxito, este método retornará um código de resposta e um 200 OK objeto userAppInstallStatus atualizado no corpo da resposta.If successful, this method returns a 200 OK response code and an updated userAppInstallStatus object in the response body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}/userStatuses/{userAppInstallStatusId}
Content-type: application/json
Content-length: 239

{
  "@odata.type": "#microsoft.graph.userAppInstallStatus",
  "userName": "User Name value",
  "userPrincipalName": "User Principal Name value",
  "installedDeviceCount": 4,
  "failedDeviceCount": 1,
  "notInstalledDeviceCount": 7
}

RespostaResponse

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada 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: 288

{
  "@odata.type": "#microsoft.graph.userAppInstallStatus",
  "id": "14959a2a-9a2a-1495-2a9a-95142a9a9514",
  "userName": "User Name value",
  "userPrincipalName": "User Principal Name value",
  "installedDeviceCount": 4,
  "failedDeviceCount": 1,
  "notInstalledDeviceCount": 7
}