Skip to content

Commit 97bfa1b

Browse files
authored
Update change-notifications-delivery-webhooks.md
Updated timeout period from 3 seconds to 10 seconds.
1 parent 73b8146 commit 97bfa1b

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

concepts/change-notifications-delivery-webhooks.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -30,24 +30,24 @@ Your endpoint must provide correct, consistent, and timely HTTP responses in ord
3030
Your endpoint must also continue to remain authenticated to Microsoft Graph, either by continually renewing your subscription or by responding to lifecycle notifications.
3131

3232
### 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.
3434

3535
- 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.
3737
- 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.
3838

3939
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.
4040

4141
### Throttling
4242
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.
4343

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.
4545
- 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.
4747

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.
4949
- 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.
5151

5252
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.
5353

0 commit comments

Comments
 (0)