Partilhar via

Exportar relatórios do Intune com Graph APIs

  • Artigo

Todos os relatórios migrados para a infraestrutura de relatórios do Intune estarão disponíveis para exportação a partir de uma única API de exportação de nível superior. Tem de utilizar a Microsoft Graph API para efetuar a chamada HTTP. O Microsoft Graph é uma API Web RESTful que permite que você acesse os recursos de serviço do Microsoft Cloud.

Observação

Para obter informações sobre como fazer chamadas à API REST, incluindo ferramentas para interagir com o Microsoft Graph, veja Utilizar a Microsoft Graph API.

O Microsoft Intune exportará relatórios com o seguinte ponto final da Microsoft Graph API:

https://graph.microsoft.com/beta/deviceManagement/reports/exportJobs
https://graph.microsoft.com/v1.0/deviceManagement/reports/exportJobs

Pedido e resposta de relatórios de dispositivos de exemplo

Ao fazer o pedido, tem de fornecer um reportName parâmetro como parte do corpo do pedido com base no relatório que pretende exportar. Segue-se um exemplo de um pedido de exportação para o relatório Dispositivos . Tem de utilizar o método POST HTTP no seu pedido. O método POST é utilizado para criar um novo recurso ou efetuar uma ação.

Exemplo de solicitação

O pedido abaixo contém o método HTTP utilizado no pedido para o Microsoft Graph.

{ 
    "reportName": "Devices", 
    "filter":"(OwnerType eq '1')", 
    "localizationType": "LocalizedValuesAsAdditionalColumn", 
    "format": "json",
    "select": [ 
        "DeviceName", 
        "managementAgent", 
        "ownerType", 
        "complianceState", 
        "OS", 
        "OSVersion", 
        "LastContact", 
        "UPN", 
        "DeviceId" 
    ]
}

Observação

Para obter dados, selecione colunas específicas, como as especificadas no exemplo acima. Não crie automatização em torno das colunas predefinidas de qualquer exportação de relatório. Deve criar a automatização para selecionar explicitamente colunas relevantes.

Exemplo de resposta

Com base no pedido POST acima, o Graph devolve uma mensagem de resposta. A mensagem de resposta são os dados que pediu ou o resultado da operação.

{ 
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#deviceManagement/reports/exportJobs/$entity", 
    "id": "Devices_05e62361-783b-4cec-b635-0aed0ecf14a3", 
    "reportName": "Devices", 
    "filter":"(OwnerType eq '1')", 
    "localizationType": "LocalizedValuesAsAdditionalColumn", 
    "select": [ 
        "DeviceName", 
        "managementAgent", 
        "ownerType", 
        "complianceState", 
        "OS", 
        "OSVersion", 
        "LastContact", 
        "UPN", 
        "DeviceId" 
    ], 
    "format": "csv", 
    "snapshotId": null, 
    "status": "notStarted", 
    "url": null, 
    "requestDateTime": "2020-08-19T03:43:32.1405758Z", 
    "expirationDateTime": "0001-01-01T00:00:00Z" 
}

Em seguida, pode utilizar o id campo para consultar o estado da exportação com um pedido GET:

Por exemplo: https://graph.microsoft.com/beta/deviceManagement/reports/exportJobs('Devices_05e62361-783b-4cec-b635-0aed0ecf14a3')

Terá de continuar a chamar este URL até obter uma resposta com um status: completed atributo. Terá o seguinte aspeto:

{ 
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#deviceManagement/reports/exportJobs/$entity", 
    "id": "Devices_05e62361-783b-4cec-b635-0aed0ecf14a3", 
    "reportName": "Devices", 
    "filter":"(OwnerType eq '1')", 
    "localizationType": "LocalizedValuesAsAdditionalColumn", 
    "select": [ 
        "DeviceName", 
        "managementAgent", 
        "ownerType", 
        "complianceState", 
        "OS", 
        "OSVersion", 
        "LastContact", 
        "UPN", 
        "DeviceId" 
    ], 
    "format": "csv", 
    "snapshotId": null, 
    "status": "completed", 
    "url": "https://amsua0702repexpstorage.blob.core.windows.net/cec055a4-97f0-4889-b790-dc7ad0d12c29/Devices_05e62361-783b-4cec-b635-0aed0ecf14a3.zip?sv=2019-02-02&sr=b&sig=%2BP%2B4gGiZf0YzlQRuAV5Ji9Beorg4nnOtP%2F7bbFGH7GY%3D&skoid=1db6df02-4c8b-4cb3-8394-7ac2390642f8&sktid=72f988bf-86f1-41af-91ab-2d7cd011db47&skt=2020-08-19T03%3A48%3A32Z&ske=2020-08-19T09%3A44%3A23Z&sks=b&skv=2019-02-02&se=2020-08-19T09%3A44%3A23Z&sp=r", 
    "requestDateTime": "2020-08-19T03:43:32.1405758Z", 
    "expirationDateTime": "2020-08-19T09:44:23.8540289Z" 
}

Em seguida, pode transferir diretamente o CSV comprimido a url partir do campo .

Parâmetros do relatório

Existem cinco parâmetros principais que pode submeter no corpo do pedido para definir o pedido de exportação:

  • reportName:Necessário. Este parâmetro é o nome do relatório que pretende especificar.
  • filter: não é necessário para a maioria dos relatórios. Tenha em atenção que o parâmetro de filtro é uma cadeia.
  • select: não é necessário. Especifique as colunas do relatório que pretende. Só serão aceites nomes de coluna válidos relevantes para o relatório que está a chamar.
  • format: não é necessário. Por predefinição, os dados são apresentados no csv formato . Especifique para exportar json o ficheiro no formato JSON.
  • localizationType: este parâmetro controla o comportamento de localização do relatório. Os valores possíveis são: LocalizedValuesAsAdditionalColumn e ReplaceLocalizableValues.

Comportamento de localização

O localizationType parâmetro controla o comportamento de localização do relatório. Os valores possíveis para este parâmetro são LocalizedValuesAsAdditionalColumn e ReplaceLocalizableValues.

LocalizedValuesAsAdditionalColumn report value (Valor do relatório LocalizedValuesAsAdditionalColumn)

Este valor para o localizationType parâmetro é o valor predefinido. Será inserido automaticamente se o localizationType parâmetro não for especificado. Este valor especifica que o Intune fornece duas colunas para cada coluna localizável.

  • valor de enumeração: a coluna de valor de enumeração contém uma cadeia não processada ou um conjunto de números que não são alterados, independentemente da região. Esta coluna estará abaixo do nome da coluna original (veja exemplo).
  • valor de cadeia localizado: esta coluna será o nome da coluna original com _loc anexado. Irá conter valores de cadeia legíveis por humanos e condicionais de região (veja exemplo).

Exemplo

SO OS_loc
1 Windows
1 Windows
1 Windows
2 iOS
3 Android
4 Mac

ReplaceLocalizableValues report value (Valor do relatório ReplaceLocalizableValues)

O valor do relatório ReplaceLocalizableValues devolverá apenas uma coluna por atributo localizado. Esta coluna irá conter o nome da coluna original com os valores localizados.

Exemplo

SO
Windows
Windows
Windows
iOS
Android
Mac

Para colunas sem valores localizados, apenas é devolvida uma única coluna com o nome de coluna verdadeiro e os valores de coluna verdadeiros.

Importante

O localizationType parâmetro é relevante para qualquer experiência de exportação alojada pela infraestrutura de relatórios do Intune com algumas exceções. OsDevices tipos de relatório e DevicesWithInventory não respeitarão o localizationType parâmetro devido aos requisitos de compatibilidade legados.

Próximas etapas