---
title: ロール
description: Roles API は、Datadog ロールの作成と管理、ロールが付与する グローバル権限 および各ロールに属するユーザーの管理に使用されます。
breadcrumbs: ドキュメント > API > ロール
---

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

# ロール

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/jen.gilbert/astro-base/ja/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/jen.gilbert/astro-base/ja/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/jen.gilbert/astro-base/ja/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/jen.gilbert/astro-base/ja/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/jen.gilbert/astro-base/ja/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/jen.gilbert/astro-base/ja/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/jen.gilbert/astro-base/ja/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/jen.gilbert/astro-base/ja/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/jen.gilbert/astro-base/ja/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/jen.gilbert/astro-base/ja/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/jen.gilbert/astro-base/ja/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/jen.gilbert/astro-base/ja/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/jen.gilbert/astro-base/ja/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  |

## [List role templates](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/ja/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  |