Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Importante: A Microsoft suporta Intune /beta APIs, mas estão sujeitas a alterações mais frequentes. Quando possível, a Microsoft recomenda a utilização da versão v1.0. Verifique a disponibilidade de uma API na versão v1.0 com o seletor de Versã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.
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 valores possíveis 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
}