You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: concepts/change-notifications-delivery-webhooks.md
+6-6Lines changed: 6 additions & 6 deletions
Original file line number
Diff line number
Diff line change
@@ -30,24 +30,24 @@ Your endpoint must provide correct, consistent, and timely HTTP responses in ord
30
30
Your endpoint must also continue to remain authenticated to Microsoft Graph, either by continually renewing your subscription or by responding to lifecycle notifications.
31
31
32
32
### HTTP codes and retry logic
33
-
Once the Microsoft Graph change notifications service receives a 2xx class code from your endpoint, the notification is considered sent. As long as the change notifications service receives any other HTML response (even an error code) within 3 seconds, the service continues to try to deliver the notification for up to 4 hours.
33
+
Once the Microsoft Graph change notifications service receives a 2xx class code from your endpoint, the notification is considered sent. As long as the change notifications service receives any other HTML response (even an error code) within 10 seconds, the service continues to try to deliver the notification for up to 4 hours.
34
34
35
35
- If you're able to process the notification within a 3-second window, you should return a `200 - OK` status code to Microsoft Graph
36
-
- If your service may take more than 3 seconds to process the notification, then you may choose to persist the notification in a queue on your endpoint and return `202 - Accepted` status code to Microsoft Graph.
36
+
- If your service may take more than 10 seconds to process the notification, then you may choose to persist the notification in a queue on your endpoint and return `202 - Accepted` status code to Microsoft Graph.
37
37
- If the notification isn't processed or queued, return a 5xx class code to indicate an error so that Microsoft Graph can retry the notification.
38
38
39
39
Notifications that fail to deliver will be retried at exponential backoff intervals. Missed notifications may take up to 4 hours to resend once your endpoint comes online.
40
40
41
41
### Throttling
42
42
For security and performance reasons, Microsoft Graph throttles notifications sent to endpoints that become slow or unresponsive. This may include dropping notifications in a way that they can't be recovered.
43
43
44
-
1. An endpoint is marked "slow" once more than 10% of responses take longer than 3 seconds in a 10-minute window.
44
+
1. An endpoint is marked "slow" once more than 10% of responses take longer than 10 seconds in a 10-minute window.
45
45
- Once an endpoint has been marked "slow", any new notifications will be sent on a 10-second delay.
46
-
- An endpoint exits the "slow" state once less than 10% of responses take longer than 3 seconds in a 10-minute window.
46
+
- An endpoint exits the "slow" state once less than 10% of responses take longer than 10 seconds in a 10-minute window.
47
47
48
-
2. An endpoint is marked "drop" once more than 15% of responses take longer than 3 seconds in a 10-minute window.
48
+
2. An endpoint is marked "drop" once more than 15% of responses take longer than 10 seconds in a 10-minute window.
49
49
- Once an endpoint has been marked "drop", any new notifications will be dropped, for up to 10 minutes
50
-
- An endpoint exits the "drop" state once less than 15% of responses take longer than 3 seconds in a 10-minute window.
50
+
- An endpoint exits the "drop" state once less than 15% of responses take longer than 10 seconds in a 10-minute window.
51
51
52
52
If your endpoint is unable to meet these performance characteristics, consider using [Event Hubs](/graph/change-notifications-delivery-event-hubs) or [Event Grid](/azure/event-grid/subscribe-to-graph-api-events?context=graph/context) as a target for receiving notifications.
0 commit comments