Atualizar androidForWorkSettings

Namespace: microsoft.graph

Importante: As APIs Graph Microsoft na versão /beta estão sujeitas a alterações; não há suporte para uso de produção.

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.

Atualizar as propriedades de um objeto de androidForWorkSettings.

Pré-requisitos

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) DeviceManagementConfiguration.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Aplicativo DeviceManagementConfiguration.ReadWrite.All

Solicitação HTTP

PATCH /deviceManagement/androidForWorkSettings

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização <Token> de portador obrigatório.
Aceitar application/json

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON do objeto androidForWorkSettings.

A tabela a seguir mostra as propriedades obrigatórias ao criar androidForWorkSettings.

Propriedade Tipo Descrição
id Cadeia de caracteres O identificador de configurações do Android for Work
bindStatus androidForWorkBindStatus Vincular o status do locatário à API de EMM do Google. Os valores possíveis são: notBound, bound, boundAndValidated, unbinding.
lastAppSyncDateTime DateTimeOffset Hora da conclusão da última sincronização do aplicativo
lastAppSyncStatus androidForWorkSyncStatus Último resultado de sincronização de aplicativo. Os possíveis valores são: success, credentialsNotValid, androidForWorkApiError, managementServiceError, unknownError, none.
ownerUserPrincipalName String UPN proprietária que criou a empresa
ownerOrganizationName String Nome da organização usada ao integrar o Android for Work
lastModifiedDateTime DateTimeOffset Hora da última modificação das configurações do Android for Work
enrollmentTarget androidForWorkEnrollmentTarget Indica quais usuários podem registrar dispositivos no gerenciamento de dispositivos Android for Work. Os valores possíveis são: none, all, targeted, targetedAsEnrollmentRestrictions.
targetGroupIds String collection Especifica a quais grupos AAD podem registrar dispositivos no gerenciamento de dispositivos do Android for Work se enrollmentTarget estiver definido como 'Direcionado'
deviceOwnerManagementEnabled Boleano Indica se essa conta está sendo reativada para o Gerenciamento de Proprietários de Dispositivos Android com o CloudDPC.

Resposta

Se bem-sucedido, este método retornará um código de resposta 200 OK e um objeto androidForWorkSettings atualizado no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

PATCH https://graph.microsoft.com/beta/deviceManagement/androidForWorkSettings
Content-type: application/json
Content-length: 455

{
  "@odata.type": "#microsoft.graph.androidForWorkSettings",
  "bindStatus": "bound",
  "lastAppSyncDateTime": "2016-12-31T23:57:22.8606813-08:00",
  "lastAppSyncStatus": "credentialsNotValid",
  "ownerUserPrincipalName": "Owner User Principal Name value",
  "ownerOrganizationName": "Owner Organization Name value",
  "enrollmentTarget": "all",
  "targetGroupIds": [
    "Target Group Ids value"
  ],
  "deviceOwnerManagementEnabled": true
}

Resposta

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.

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

{
  "@odata.type": "#microsoft.graph.androidForWorkSettings",
  "id": "97adc169-c169-97ad-69c1-ad9769c1ad97",
  "bindStatus": "bound",
  "lastAppSyncDateTime": "2016-12-31T23:57:22.8606813-08:00",
  "lastAppSyncStatus": "credentialsNotValid",
  "ownerUserPrincipalName": "Owner User Principal Name value",
  "ownerOrganizationName": "Owner Organization Name value",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "enrollmentTarget": "all",
  "targetGroupIds": [
    "Target Group Ids value"
  ],
  "deviceOwnerManagementEnabled": true
}