---
title: Règles de tag
description: Les règles de tag définissent les règles qui régissent les valeurs de tag acceptées pour une clé de tag donnée, limitées à une source de télémétrie…
breadcrumbs: Documentation > API > Règles de tag
---

> For the complete documentation index, see [llms.txt](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/llms.txt).

# Règles de tag

Les règles de tag définissent les règles qui régissent les valeurs de tag acceptées pour une clé de tag donnée,
limitées à une source de télémétrie particulière (telle que les logs, les spans ou les métriques). Les règles peuvent être de type
`blocking` (les données qui ne respectent pas la règle sont rejetées) ou `surfacing` (les données correspondantes
sont mises en évidence, mais ne sont pas bloquées). Chaque règle rapporte un `score` de conformité dérivé de la quantité de
télémétrie récente qui respecte la règle.

## [List tag rules](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/tag-rules/list-tag-rules.md) (preview)

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

## [Create a tag rule](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/tag-rules/create-a-tag-rule.md) (preview)

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

## [Get a tag rule](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/tag-rules/get-a-tag-rule.md) (preview)

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

## [Update a tag rule](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/tag-rules/update-a-tag-rule.md) (preview)

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

## [Delete a tag rule](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/tag-rules/delete-a-tag-rule.md) (preview)

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

## [Get a tag rule compliance score](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/tag-rules/get-a-tag-rule-compliance-score.md) (preview)

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