---
title: Roles
description: Roles API는 Datadog 역할, 해당 역할이 부여하는 전역 권한 및 해당 역할에 속한 사용자를 생성하고 관리하는 데 사용됩니다.
breadcrumbs: 문서 > API > Roles
---

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

# Roles

Roles API는 Datadog 역할, 해당 역할이 부여하는
[전역 권한](https://docs.datadoghq.com/account_management/rbac.md) 및 해당 역할에 속한
사용자를 생성하고 관리하는 데 사용됩니다.

특정 계정 자산과 관련된 권한은 이 API를 사용하지 않고
Datadog 애플리케이션에서 역할에 부여할 수 있습니다. 예를 들어, 특정 로그 인덱스에 대한
읽기 액세스 권한을 역할에 부여하는 작업은 Datadog의
[Pipelines 페이지](https://app.datadoghq.com/logs/pipelines)에서 수행할 수 있습니다.

Datadog UI를 통해 역할을 일괄적으로 관리할 수도 있으며, 이를 통해
여러 역할에 하나의 권한을 동시에 할당할 수 있습니다.

## [권한 목록 표시](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/roles/list-permissions.md)

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

## [역할 목록 표시](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/roles/list-roles.md)

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

## [역할 생성](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/roles/create-role.md)

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

## [역할 불러오기](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/roles/get-a-role.md)

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

## [역할 업데이트](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/roles/update-a-role.md)

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

## [역할 삭제](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/roles/delete-role.md)

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

## [역할 권한 목록 표시](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/roles/list-permissions-for-a-role.md)

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

## [역할 권한 부여](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/roles/grant-permission-to-a-role.md)

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

## [권한 취소](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/roles/revoke-permission.md)

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

## [역할의 사용자 전체 불러오기](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/roles/get-all-users-of-a-role.md)

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

## [역할에 사용자 추가](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/roles/add-a-user-to-a-role.md)

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

## [역할에서 사용자 삭제](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/roles/remove-a-user-from-a-role.md)

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

## [기존 역할을 복제하여 새 역할 생성](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/roles/create-a-new-role-by-cloning-an-existing-role.md)

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

## [역할 템플릿 목록 표시](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/roles/list-role-templates.md) (preview)

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