Acessar deviceManagement

Namespace: microsoft.graph

Importante: APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção.

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

Leia as propriedades e as relações do objeto deviceManagement.

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 (por fluxo de   trabalho)	Permissões (de privilégios máximos a mínimos)
Delegado (conta corporativa ou de estudante)
Android for Work	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All
Auditoria	DeviceManagementApps.ReadWrite.All, DeviceManagementApps.Read.All
Termos da empresa	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All
Configuração do dispositivo	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All
Intenção do dispositivo	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All
Gerenciamento de dispositivo	DeviceManagementManagedDevices.ReadWrite.All, DeviceManagementManagedDevices.Read.All
SIM Eletrônico	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All
Inscrição	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All
Esgrima	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All
Notificação	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All
Odj	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All
Integração	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All
Conjunto de Políticas	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All
RBAC	DeviceManagementRBAC.ReadWrite.All, DeviceManagementRBAC.Read.All
Acesso remoto	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All
Assistência remota	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All
Atualização de Software	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All
Gerenciamento de despesas de telecomunicações	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All
Solução de problemas	DeviceManagementManagedDevices.ReadWrite.All, DeviceManagementManagedDevices.Read.All
Proteção de Informações do Windows	DeviceManagementApps.ReadWrite.All, DeviceManagementApps.Read.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo
Android for Work	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All
Auditoria	DeviceManagementApps.ReadWrite.All, DeviceManagementApps.Read.All
Termos da empresa	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All
Configuração do dispositivo	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All
Intenção do dispositivo	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All
Gerenciamento de dispositivo	DeviceManagementManagedDevices.ReadWrite.All, DeviceManagementManagedDevices.Read.All
SIM Eletrônico	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All
Inscrição	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All
Esgrima	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All
Notificação	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All
Odj	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All
Integração	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All
Conjunto de Políticas	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All
RBAC	DeviceManagementRBAC.ReadWrite.All, DeviceManagementRBAC.Read.All
Acesso remoto	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All
Assistência remota	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All
Atualização de Software	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All
Gerenciamento de despesas de telecomunicações	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All
Solução de problemas	DeviceManagementManagedDevices.ReadWrite.All, DeviceManagementManagedDevices.Read.All
Proteção de Informações do Windows	DeviceManagementApps.ReadWrite.All, DeviceManagementApps.Read.All

Solicitação HTTP

GET /deviceManagement

Parâmetros de consulta opcionais

Este método dá suporte a Parâmetros de consulta OData para ajudar a personalizar a resposta.

Cabeçalhos de solicitação

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

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se tiver êxito, este método retornará o código de resposta 200 OK e o objeto deviceManagement no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

GET https://graph.microsoft.com/beta/deviceManagement

Resposta

Aqui estão exemplos da resposta.

Observação: os objetos de resposta mostrados aqui podem ser truncados para brevidade.

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

{
  "value": {
    "@odata.type": "#microsoft.graph.deviceManagement",
    "id": "0b283420-3420-0b28-2034-280b2034280b"
  }
}

As propriedades apropriadas para o fluxo de trabalho são retornadas.

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

{
  "value": {
    "@odata.type": "#microsoft.graph.deviceManagement",
    "id": "0b283420-3420-0b28-2034-280b2034280b",
    "subscriptionState": "active",
    "subscriptions": "intune",
    "adminConsent": {
      "@odata.type": "microsoft.graph.adminConsent",
      "shareAPNSData": "granted"
    },
    "deviceProtectionOverview": {
      "@odata.type": "microsoft.graph.deviceProtectionOverview",
      "totalReportedDeviceCount": 8,
      "inactiveThreatAgentDeviceCount": 14,
      "unknownStateThreatAgentDeviceCount": 2,
      "pendingSignatureUpdateDeviceCount": 1,
      "cleanDeviceCount": 0,
      "pendingFullScanDeviceCount": 10,
      "pendingRestartDeviceCount": 9,
      "pendingManualStepsDeviceCount": 13,
      "pendingOfflineScanDeviceCount": 13,
      "criticalFailuresDeviceCount": 11
    },
    "accountMoveCompletionDateTime": "2017-01-01T00:01:17.9006709-08:00"
  }
}