Compartilhar via


Criar managedAppLogCollectionRequest

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.

Crie um novo objeto managedAppLogCollectionRequest .

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, DeviceManagementApps.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Application DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All

Solicitação HTTP

POST /deviceAppManagement/managedAppRegistrations/{managedAppRegistrationId}/managedAppLogCollectionRequests

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 do pedido, forneça uma representação JSON para o objeto managedAppLogCollectionRequest.

A tabela seguinte mostra as propriedades necessárias quando cria o managedAppLogCollectionRequest.

Propriedade Tipo Descrição
id Cadeia de caracteres O identificador exclusivo do pedido de recolha de registos de aplicações geridas. Este ID é atribuído durante a hora de criação do pedido. Somente leitura.
managedAppRegistrationId Cadeia de caracteres O identificador exclusivo da instância da aplicação para a qual foram recolhidos registos de diagnóstico. Somente leitura.
status Cadeia de caracteres Indica o status do pedido de recolha de registos de aplicações – pendente, concluído ou com falha. A predefinição está pendente.
requestedBy Cadeia de caracteres O nome principal de utilizador associado ao pedido para a coleção de registos de aplicações geridas. Somente leitura.
requestedByUserPrincipalName Cadeia de caracteres O nome principal de utilizador associado ao pedido para a coleção de registos de aplicações geridas. Somente leitura.
requestedDateTime DateTimeOffset DateTime de quando o pedido de carregamento de registo foi recebido. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite em UTC no dia 1º de janeiro de 2014 teria esta aparência: '2014-01-01T00:00:00Z'. Retornado por padrão. Somente leitura.
completedDateTime DateTimeOffset DateTime de quando o pedido de carregamento de registo foi concluído. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite em UTC no dia 1º de janeiro de 2014 teria esta aparência: '2014-01-01T00:00:00Z'. Retornado por padrão. Somente leitura.
userLogUploadConsent managedAppLogUploadConsent Indica se o utilizador associado ao dispositivo deu consentimento para a recolha de registos. O utilizador tem de dar consentimento antes de os registos de diagnóstico poderem ser recolhidos. aceite significa que o utilizador consentiu. recusado significa que o utilizador recusou. desconhecido é o valor predefinido. O Pedido de Recolha de Registos tem de ser concluído dentro de 24 horas ou será abandonado e eliminado. Somente leitura. Os valores possíveis são: unknown, declined, accepted, unknownFutureValue.
uploadedLogs coleção managedAppLogUpload A coleção de resultados de carregamento de registos conforme comunicado por cada componente no dispositivo. Estes componentes podem ser a própria aplicação, o SDK de Gestão de Aplicações Móveis (MAM) e outros componentes no dispositivo que são pedidos para carregar registos de diagnóstico. Somente leitura.
versão String Versão da entidade.

Resposta

Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto managedAppLogCollectionRequest no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

POST https://graph.microsoft.com/beta/deviceAppManagement/managedAppRegistrations/{managedAppRegistrationId}/managedAppLogCollectionRequests
Content-type: application/json
Content-length: 799

{
  "@odata.type": "#microsoft.graph.managedAppLogCollectionRequest",
  "managedAppRegistrationId": "Managed App Registration Id value",
  "status": "Status value",
  "requestedBy": "Requested By value",
  "requestedByUserPrincipalName": "Requested By User Principal Name value",
  "requestedDateTime": "2017-01-01T00:01:49.2071853-08:00",
  "completedDateTime": "2016-12-31T23:58:52.3534526-08:00",
  "userLogUploadConsent": "declined",
  "uploadedLogs": [
    {
      "@odata.type": "microsoft.graph.managedAppLogUpload",
      "managedAppComponent": "Managed App Component value",
      "managedAppComponentDescription": "Managed App Component Description value",
      "status": "inProgress",
      "referenceId": "Reference Id value"
    }
  ],
  "version": "Version value"
}

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 201 Created
Content-Type: application/json
Content-Length: 848

{
  "@odata.type": "#microsoft.graph.managedAppLogCollectionRequest",
  "id": "95b5bd26-bd26-95b5-26bd-b59526bdb595",
  "managedAppRegistrationId": "Managed App Registration Id value",
  "status": "Status value",
  "requestedBy": "Requested By value",
  "requestedByUserPrincipalName": "Requested By User Principal Name value",
  "requestedDateTime": "2017-01-01T00:01:49.2071853-08:00",
  "completedDateTime": "2016-12-31T23:58:52.3534526-08:00",
  "userLogUploadConsent": "declined",
  "uploadedLogs": [
    {
      "@odata.type": "microsoft.graph.managedAppLogUpload",
      "managedAppComponent": "Managed App Component value",
      "managedAppComponentDescription": "Managed App Component Description value",
      "status": "inProgress",
      "referenceId": "Reference Id value"
    }
  ],
  "version": "Version value"
}