Compartilhar via


Atualizar androidForWorkSettings

Namespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; a utilização de produção não é suportada.

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.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Uma das seguintes permissões é necessá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.
Application DeviceManagementConfiguration.ReadWrite.All

Solicitação HTTP

PATCH /deviceManagement/androidForWorkSettings

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
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 String O identificador de configurações do Android for Work
bindStatus androidForWorkBindStatus Vincular status do inquilino à API do Google EMM. 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 aplicações. 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 que utilizadores podem inscrever dispositivos na gestão 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 Booliano Indica se esta conta está em voo para a Gestão de Proprietários de Dispositivos Android com 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
}