Événements Microsoft ToDo
Cet article fournit les propriétés et le schéma des événements Microsoft ToDo Task, publiés par l’API Microsoft Graph. Pour une introduction aux schémas d’événements, consultez le schéma CloudEvents.
Types d’événement disponibles
Ces événements sont déclenchés lorsqu’un todoTask est créé, mis à jour ou supprimé en fonctionnant sur ces ressources à l’aide de l’API Microsoft Graph. Notez que vous ne pouvez vous abonner qu’aux modifications d’une liste de tâches spécifique.
Nom de l’événement | Description |
---|---|
Microsoft.Graph.ToDoCreated | Déclenché lorsqu’un todoTask dans la liste des tâches Microsoft ToDo est créé. |
Microsoft.Graph.ToDoUpdated | Déclenché lorsqu’un todoTask dans la liste des tâches Microsoft ToDo est mis à jour. |
Microsoft.Graph.ToDoDeleted | Déclenché lorsqu’un todoTask dans la liste des tâches Microsoft ToDo est supprimé. |
Exemple d’événement
Lorsqu’un événement est déclenché, le service Event Grid envoie les données relatives à cet événement aux destinations d’abonnement. Cette section contient un exemple de ce à quoi ressemblent ces données pour chaque événement d’alerte de sécurité Microsoft.
Événement 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"
}
}
}
Événement 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"
}
}
}
Événement 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"
}
}
}
Propriétés d’événement
Un événement contient les données générales suivantes :
Propriété | Type | Description |
---|---|---|
source |
string | Source d’événement du locataire. Ce champ n’est pas modifiable. L’API Microsoft Graph fournit cette valeur. |
subject |
string | Chemin de l’objet de l’événement, défini par le serveur de publication. |
type |
string | Un des types d’événements pour cette source d’événement. |
time |
string | Heure à laquelle l’événement est généré selon l’heure UTC du fournisseur |
id |
string | Identificateur unique de l’événement. |
data |
object | Charge utile d’événement qui fournit les données relatives au changement d’état de la ressource. |
specversion |
string | Version de la spécification de schéma CloudEvents. |
L’objet de données comporte les propriétés suivantes :
Propriété | Type | Description |
---|---|---|
changeType |
string | Type de modification de l’état de la ressource. |
resource |
string | Identificateur de ressource pour lequel l’événement a été déclenché. |
tenantId |
string | ID de l’organisation où l’alerte a été déclenchée. |
clientState |
string | Secret fourni par l’utilisateur au moment de la création de l’abonnement à l’API Graph. |
@odata.type |
string | Type de modification de l’API Graph. |
@odata.id |
string | Identificateur de ressource de l’API Graph pour lequel l’événement a été déclenché. |
id |
string | Identificateur de ressource pour lequel l’événement a été déclenché. |
subscriptionExpirationDateTime |
string | Heure au format RFC 3339 à laquelle l’abonnement à l’API Graph expire. |
subscriptionId |
string | Identificateur d’abonnement à l’API Graph. |
tenantId |
string | Identificateur du locataire Microsoft Entra. |
Étapes suivantes
- Pour une présentation des événements partenaires de Azure Event Grid, consultez la vue d’ensemble des événements partenaires
- Pour plus d’informations sur la façon de s’abonner à l’API Microsoft Graph pour recevoir des événements, consultez s’abonner aux événements de l’API Microsoft Graph.
- Pour plus d’informations sur les gestionnaires d'événements Azure Event Grid, consultez les gestionnaires d’événements.
- Pour plus d’informations sur la création d’un abonnement à Azure Event Grid, consultez Créer un abonnement à un événement et Schéma d’abonnement à Event Grid.
- Pour plus d’informations sur la configuration d’un abonnement aux événements pour sélectionner des événements spécifiques à distribuer, consultez le filtrage des événements. Vous pouvez également faire référence à des événements de filtre.