---
title: Tags
description: "L'endpoint de tags vous permet d'attribuer des tags aux hosts, par exemple : role:database."
breadcrumbs: Documentation > API > Tags
---

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

# Tags

L'endpoint de tags vous permet d'attribuer des tags aux hosts,
par exemple : `role:database`. Ces tags sont appliqués à
toutes les métriques envoyées par le host. Référencez les hosts par leur nom
(`yourhost.example.com`) lors de la récupération et de l'application
de tags sur un host particulier.

Le composant de votre infrastructure responsable d'un tag est identifié
par une source. Par exemple, parmi les sources valides figurent nagios, hudson, jenkins, users, feed, chef, puppet, git, bitbucket, fabric, capistrano, etc. Retrouvez la liste complète des noms de types de sources dans [Attributs de source de l'API](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value.md).

Pour en savoir plus sur les tags, consultez [Débuter avec les tags](https://docs.datadoghq.com/getting_started/tagging.md).

## [Récupérer tous les tags de host](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/tags/get-all-host-tags.md)

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

## [Récupérer des tags de host](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/tags/get-host-tags.md)

| Datadog site      | API endpoint                                                    |
| ----------------- | --------------------------------------------------------------- |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v1/tags/hosts/{host_name}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v1/tags/hosts/{host_name} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v1/tags/hosts/{host_name} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v1/tags/hosts/{host_name}      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v1/tags/hosts/{host_name} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v1/tags/hosts/{host_name} |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v1/tags/hosts/{host_name} |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v1/tags/hosts/{host_name}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v1/tags/hosts/{host_name}  |

## [Ajouter des tags à un host](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/tags/add-tags-to-a-host.md)

| Datadog site      | API endpoint                                                     |
| ----------------- | ---------------------------------------------------------------- |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v1/tags/hosts/{host_name}     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v1/tags/hosts/{host_name} |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v1/tags/hosts/{host_name} |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v1/tags/hosts/{host_name}      |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v1/tags/hosts/{host_name} |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v1/tags/hosts/{host_name} |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v1/tags/hosts/{host_name} |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v1/tags/hosts/{host_name}      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v1/tags/hosts/{host_name}  |

## [Mettre à jour les tags d'un host](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/tags/update-host-tags.md)

| Datadog site      | API endpoint                                                    |
| ----------------- | --------------------------------------------------------------- |
| app.datadoghq.com | PUT https://api.datadoghq.com/api/v1/tags/hosts/{host_name}     |
| us3.datadoghq.com | PUT https://api.us3.datadoghq.com/api/v1/tags/hosts/{host_name} |
| us5.datadoghq.com | PUT https://api.us5.datadoghq.com/api/v1/tags/hosts/{host_name} |
| app.datadoghq.eu  | PUT https://api.datadoghq.eu/api/v1/tags/hosts/{host_name}      |
| ap1.datadoghq.com | PUT https://api.ap1.datadoghq.com/api/v1/tags/hosts/{host_name} |
| ap2.datadoghq.com | PUT https://api.ap2.datadoghq.com/api/v1/tags/hosts/{host_name} |
| uk1.datadoghq.com | PUT https://api.uk1.datadoghq.com/api/v1/tags/hosts/{host_name} |
| app.ddog-gov.com  | PUT https://api.ddog-gov.com/api/v1/tags/hosts/{host_name}      |
| us2.ddog-gov.com  | PUT https://api.us2.ddog-gov.com/api/v1/tags/hosts/{host_name}  |

## [Supprimer les tags d'un host](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/tags/remove-host-tags.md)

| Datadog site      | API endpoint                                                       |
| ----------------- | ------------------------------------------------------------------ |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v1/tags/hosts/{host_name}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v1/tags/hosts/{host_name} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v1/tags/hosts/{host_name} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v1/tags/hosts/{host_name}      |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v1/tags/hosts/{host_name} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v1/tags/hosts/{host_name} |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v1/tags/hosts/{host_name} |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v1/tags/hosts/{host_name}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v1/tags/hosts/{host_name}  |