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
}