---
title: 태그
description: "태그 엔드포인트를 사용하면 호스트에 태그를 할당할 수 있습니다(예: role:database). 이 태그는 호스트에 전송되는 모든 메트릭에 적용됩니다. 특정 호스트를 가져오고 싶거나 특정 호스트에 태그를 적용하려면 호스트를 이름으로 참조(…"
breadcrumbs: 문서 > API > 태그
---

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

# 태그

태그 엔드포인트를 사용하면 호스트에 태그를 할당할 수
있습니다(예: `role:database`). 이 태그는 호스트에 전송되는
모든 메트릭에 적용됩니다. 특정 호스트를 가져오고 싶거나
특정 호스트에 태그를 적용하려면 호스트를 이름으로 참조(
(`yourhost.example.com`)하세요.

태그를 담당하는 인프라스트럭처 구성 요소는 소스로 구분됩니다. 유효한 소스 예시로는 nagios, hudson, jenkins, users, feed, chef, puppet, git, bitbucket, fabric, capistrano 등이 있습니다.

자세한 내용은 [태그 사용하기](https://docs.datadoghq.com/getting_started/tagging.md)를 참고하세요.

## [모든 호스트 태그 가져오기](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/ko/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  |

## [호스트 태그 가져오기](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/ko/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}  |

## [호스트에 태그 추가하기](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/ko/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}  |

## [호스트 태그 업데이트하기](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/ko/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}  |

## [호스트 태그 제거하기](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/ko/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}  |