---
title: Downtimes
description: Les downtimes vous offrent un meilleur contrôle sur les notifications des monitors en vous permettant d'exclure globalement des périmètres des alertes.
breadcrumbs: Documentation > API > Downtimes
---

> For the complete documentation index, see [llms.txt](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/llms.txt).

# Downtimes

Les [downtimes](https://docs.datadoghq.com/monitors/notify/downtimes.md) vous offrent un meilleur contrôle sur les notifications des monitors en vous permettant d'exclure globalement des périmètres des alertes. Les paramètres de downtime, qui peuvent être programmés avec des heures de début et de fin, empêchent toutes les alertes liées aux tags Datadog spécifiés.

**Remarque :** les commandes `curl` nécessitent un [encodage de l'URL](https://curl.se/docs/url-syntax.html).

## [Récupérer tous les downtimes](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/fr/api/latest/downtimes/get-all-downtimes.md)

| Datadog site      | API endpoint                                      |
| ----------------- | ------------------------------------------------- |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/downtime     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/downtime |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/downtime |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/downtime      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/downtime |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/downtime |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/downtime |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/downtime      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/downtime  |

## [Planifier un downtime](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/fr/api/latest/downtimes/schedule-a-downtime.md)

| Datadog site      | API endpoint                                       |
| ----------------- | -------------------------------------------------- |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/downtime     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/downtime |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/downtime |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/downtime      |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/downtime |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/downtime |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/downtime |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/downtime      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/downtime  |

## [Annuler les downtimes selon le contexte](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/fr/api/latest/downtimes/cancel-downtimes-by-scope.md) (deprecated)

| Datadog site      | API endpoint                                                       |
| ----------------- | ------------------------------------------------------------------ |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v1/downtime/cancel/by_scope     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v1/downtime/cancel/by_scope |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v1/downtime/cancel/by_scope |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v1/downtime/cancel/by_scope      |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v1/downtime/cancel/by_scope |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v1/downtime/cancel/by_scope |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v1/downtime/cancel/by_scope |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v1/downtime/cancel/by_scope      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v1/downtime/cancel/by_scope  |

## [Annuler un downtime](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/fr/api/latest/downtimes/cancel-a-downtime.md)

| Datadog site      | API endpoint                                                       |
| ----------------- | ------------------------------------------------------------------ |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/downtime/{downtime_id}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/downtime/{downtime_id} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/downtime/{downtime_id} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/downtime/{downtime_id}      |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/downtime/{downtime_id} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/downtime/{downtime_id} |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v2/downtime/{downtime_id} |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/downtime/{downtime_id}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/downtime/{downtime_id}  |

## [Récupérer un downtime](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/fr/api/latest/downtimes/get-a-downtime.md)

| Datadog site      | API endpoint                                                    |
| ----------------- | --------------------------------------------------------------- |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/downtime/{downtime_id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/downtime/{downtime_id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/downtime/{downtime_id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/downtime/{downtime_id}      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/downtime/{downtime_id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/downtime/{downtime_id} |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/downtime/{downtime_id} |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/downtime/{downtime_id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/downtime/{downtime_id}  |

## [Mettre à jour un downtime](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/fr/api/latest/downtimes/update-a-downtime.md)

| Datadog site      | API endpoint                                                      |
| ----------------- | ----------------------------------------------------------------- |
| app.datadoghq.com | PATCH https://api.datadoghq.com/api/v2/downtime/{downtime_id}     |
| us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v2/downtime/{downtime_id} |
| us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v2/downtime/{downtime_id} |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v2/downtime/{downtime_id}      |
| ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v2/downtime/{downtime_id} |
| ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v2/downtime/{downtime_id} |
| uk1.datadoghq.com | PATCH https://api.uk1.datadoghq.com/api/v2/downtime/{downtime_id} |
| app.ddog-gov.com  | PATCH https://api.ddog-gov.com/api/v2/downtime/{downtime_id}      |
| us2.ddog-gov.com  | PATCH https://api.us2.ddog-gov.com/api/v2/downtime/{downtime_id}  |

## [Récupérer les downtimes actifs d'un monitor](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/fr/api/latest/downtimes/get-active-downtimes-for-a-monitor.md)

| Datadog site      | API endpoint                                                                   |
| ----------------- | ------------------------------------------------------------------------------ |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/monitor/{monitor_id}/downtime_matches     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/monitor/{monitor_id}/downtime_matches |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/monitor/{monitor_id}/downtime_matches |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/monitor/{monitor_id}/downtime_matches      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/monitor/{monitor_id}/downtime_matches |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/monitor/{monitor_id}/downtime_matches |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/monitor/{monitor_id}/downtime_matches |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/monitor/{monitor_id}/downtime_matches      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/monitor/{monitor_id}/downtime_matches  |