Atualizar deviceManagementReportSchedule

Namespace: microsoft.graph

Importante: As APIs Graph Microsoft na versão /beta estão sujeitas a alterações; não há suporte para uso de produção.

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

Atualize as propriedades de um objeto deviceManagementReportSchedule.

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 Permissões (da com menos para a com mais privilégios)
Delegada (conta corporativa ou de estudante) DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All
Delegada (conta pessoal da Microsoft) Sem suporte.
Aplicativo DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All

Solicitação HTTP

PATCH /deviceManagement/reports/reportSchedules/{deviceManagementReportScheduleId}

Cabeçalhos de solicitação

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

Corpo da solicitação

No corpo da solicitação, fornece uma representação JSON para o objeto deviceManagementReportSchedule.

A tabela a seguir mostra as propriedades que são necessárias ao criar deviceManagementReportSchedule.

Propriedade Tipo Descrição
id String Identificador exclusivo dessa entidade
reportScheduleName Cadeia de caracteres Nome da agenda
assunto Cadeia de caracteres Assunto dos relatórios agendados que são entregues
emails Coleção String Emails para os quais os relatórios agendados são entregues
recurrence deviceManagementScheduledReportRecurrence Frequência de entrega de relatório agendada. Os valores possíveis são: none, daily, weekly, monthly.
startDateTime DateTimeOffset Hora em que a entrega dos relatórios agendados é iniciada
endDateTime DateTimeOffset Hora em que a entrega dos relatórios agendados termina
userId Cadeia de caracteres A ID do Usuário que criou o relatório
reportName Cadeia de caracteres Nome do relatório
filter Cadeia de caracteres Filtros aplicados no relatório
select Coleção String Colunas selecionadas no relatório
orderBy Coleção String Ordenação de colunas no relatório
formato deviceManagementReportFileFormat Formato do relatório agendado. Os valores possíveis são: csv e pdf.

Resposta

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

Exemplo

Solicitação

Este é um exemplo da solicitação.

PATCH https://graph.microsoft.com/beta/deviceManagement/reports/reportSchedules/{deviceManagementReportScheduleId}
Content-type: application/json
Content-length: 539

{
  "@odata.type": "#microsoft.graph.deviceManagementReportSchedule",
  "reportScheduleName": "Report Schedule Name value",
  "subject": "Subject value",
  "emails": [
    "Emails value"
  ],
  "recurrence": "daily",
  "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
  "endDateTime": "2017-01-01T00:03:30.9241974-08:00",
  "userId": "User Id value",
  "reportName": "Report Name value",
  "filter": "Filter value",
  "select": [
    "Select value"
  ],
  "orderBy": [
    "Order By value"
  ],
  "format": "pdf"
}

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: 588

{
  "@odata.type": "#microsoft.graph.deviceManagementReportSchedule",
  "id": "00bb9785-9785-00bb-8597-bb008597bb00",
  "reportScheduleName": "Report Schedule Name value",
  "subject": "Subject value",
  "emails": [
    "Emails value"
  ],
  "recurrence": "daily",
  "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
  "endDateTime": "2017-01-01T00:03:30.9241974-08:00",
  "userId": "User Id value",
  "reportName": "Report Name value",
  "filter": "Filter value",
  "select": [
    "Select value"
  ],
  "orderBy": [
    "Order By value"
  ],
  "format": "pdf"
}