Eventos do Microsoft ToDo

Artigo
12/12/2023

Este artigo fornece as propriedades e o esquema para eventos de tarefa do Microsoft ToDo, que são publicados pela API do Microsoft Graph. Para obter uma introdução aos esquemas de eventos, consulte Esquema CloudEvents.

Tipos de eventos disponíveis

Esses eventos são acionados quando um todoTask é criado, atualizado ou excluído operando sobre esses recursos usando a API do Microsoft Graph. Observe que você só pode se inscrever para alterações de uma lista de tarefas específica.

Nome do evento	Description
Microsoft.Graph.ToDoCreated	Acionado quando uma tarefa todoTask na lista de tarefas Microsoft ToDo é criada.
Microsoft.Graph.ToDoAtualizado	Acionado quando uma tarefa todoTask na lista de tarefas do Microsoft ToDo é atualizada.
Microsoft.Graph.ToDoDeleted	Acionado quando uma todoTask na lista de tarefas do Microsoft ToDo é excluída.

Exemplo de evento

Quando um evento é acionado, o serviço Grade de Eventos envia dados sobre esse evento para os destinos de assinatura. Esta seção contém um exemplo da aparência desses dados para cada evento do Alerta de Segurança da Microsoft.

Evento Microsoft.Graph.ToDoCreated

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.ToDoCreated",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "TodoTask/<ToDoTask-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "expirationDateTime": "2023-10-01T06:21:57-07:00",
    "changeType": "Created",
    "subscriptionId": "<guid>",
    "resource": "todob2/graph/v1/users(<user-id>)/tasks",
    "clientState": "<user-provided secret>",
    "resourceData": {
      "id": "<ToDoTask-id>",
      "@odata.type": "#microsoft.graph.todoTask"
    }
  }
}

Evento Microsoft.Graph.ToDoUpdated

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.ToDoUpdated",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "TodoTask/<ToDoTask-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "expirationDateTime": "2023-10-01T06:21:57-07:00",
    "changeType": "Updated",
    "subscriptionId": "<guid>",
    "resource": "todob2/graph/v1/users(<user-id>)/tasks",
    "clientState": "<user-provided secret>",
    "resourceData": {
      "id": "<ToDoTask-id>",
      "@odata.type": "#microsoft.graph.todoTask"
    }
  }
}

Evento Microsoft.Graph.ToDoDeleted

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.ToDoDeleted",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "TodoTask/<ToDoTask-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "expirationDateTime": "2023-10-01T06:21:57-07:00",
    "changeType": "Deleted",
    "subscriptionId": "<guid>",
    "resource": "todob2/graph/v1/users(<user-id>)/tasks",
    "clientState": "<user-provided secret>",
    "resourceData": {
     "id": "<ToDoTask-id>",
     "@odata.type": "#microsoft.graph.todoTask"
    }
  }
}

Propriedades do evento

Um evento tem os seguintes dados de nível superior:

Propriedade	Type	Description
`source`	string	A origem do evento do locatário. Este campo não pode ser gravado. A API do Microsoft Graph fornece esse valor.
`subject`	string	Caminho definido pelo publicador para o assunto do evento.
`type`	string	Um dos tipos de evento para essa fonte de evento.
`time`	string	A hora em que o evento é gerado com base na hora UTC do provedor
`id`	string	Identificador exclusivo do evento.
`data`	objeto	Carga útil do evento que fornece os dados sobre a alteração do estado do recurso.
`specversion`	string	Versão da especificação do esquema CloudEvents.

O objeto de dados tem as seguintes propriedades:

Propriedade	Type	Description
`changeType`	string	O tipo de alteração do estado do recurso.
`resource`	string	O identificador de recurso para o qual o evento foi gerado.
`tenantId`	string	O ID da organização onde o alerta foi gerado.
`clientState`	string	Um segredo fornecido pelo usuário no momento da criação da assinatura da Graph API.
`@odata.type`	string	O tipo de alteração da API do Graph.
`@odata.id`	string	O identificador de recurso da API do Graph para o qual o evento foi gerado.
`id`	string	O identificador de recurso para o qual o evento foi gerado.
`subscriptionExpirationDateTime`	string	A hora no formato RFC 3339 em que a assinatura da Graph API expira.
`subscriptionId`	string	O identificador de assinatura da API do Graph.
`tenantId`	string	O identificador de locatário do Microsoft Entra.

Próximos passos

Para obter uma introdução aos Eventos de Parceiros da Grade de Eventos do Azure, consulte Visão geral de Eventos de Parceiros
Para obter informações sobre como assinar a API do Microsoft Graph para receber eventos, consulte Inscrever-se em eventos da API do Microsoft Graph.
Para obter informações sobre manipuladores de eventos da Grade de Eventos do Azure, consulte Manipuladores de eventos.
Para obter mais informações sobre como criar uma assinatura da Grade de Eventos do Azure, consulte Criar assinatura de evento e esquema de assinatura da Grade de Eventos.
Para obter informações sobre como configurar uma assinatura de evento para selecionar eventos específicos a serem entregues, consulte filtragem de eventos. Você também pode querer se referir a eventos de filtro.

Partilhar via