--- title: 사용자 목록 description: 조직의 사용자를 나열합니다. 결과는 startIndex 및 count 파라미터에 의해 페이지별로 표시됩니다. 결과는 filter 파라미터를 사용하여 범위를 좁힐 수 있습니다. 응답에는 roles 속성에 각 사용자에게 할당된 Datadog 역할이 포함됩니다. breadcrumbs: 문서 > API > 사용자 목록 --- > For the complete documentation index, see [llms.txt](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/llms.txt). # 사용자 목록 ## v2 (latest) | Datadog site | API endpoint | | ----------------- | --------------------------------------------------- | | app.datadoghq.com | GET https://api.datadoghq.com/api/v2/scim/Users | | us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/scim/Users | | us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/scim/Users | | app.datadoghq.eu | GET https://api.datadoghq.eu/api/v2/scim/Users | | ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/scim/Users | | ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/scim/Users | | uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/scim/Users | | app.ddog-gov.com | GET https://api.ddog-gov.com/api/v2/scim/Users | | us2.ddog-gov.com | GET https://api.us2.ddog-gov.com/api/v2/scim/Users | ### Overview 조직의 사용자를 나열합니다. 결과는 `startIndex` 및 `count` 파라미터에 의해 페이지별로 표시됩니다. 결과는 `filter` 파라미터를 사용하여 범위를 좁힐 수 있습니다. 응답에는 `roles` 속성에 각 사용자에게 할당된 Datadog 역할이 포함됩니다. This endpoint requires all of the following permissions: - `user_access_invite` - `user_access_manage` ### Arguments #### Query Strings | Field | Type | Description | | ---------- | ------- | --------------------------------------------------------------------------------------------------------------------------- | | startIndex | integer | Specifies the start index to fetch the results (1-indexed). Default: `1`. | | count | integer | Specifies the number of users to be returned. Default: `20`. | | filter | string | Specifies the url encoded filter to use to narrow down the results. Filter should be of the form `userName eq `. | ### Response {% tabs %} {% tab label="200" %} OK {% tabs %} {% tab label="Model" %} List users response object. | Parent field | Field | Type | Description | | ------------ | ------------------ | --------- | ---------------------------------------------------------------------------------------------------------------------- | | | Resources | [object] | List of users matching the request criteria. | | Resources | active | boolean | A Boolean value indicating the User's administrative status. | | Resources | emails | [object] | Email addresses for the user. | | emails | primary | boolean | Boolean indicating if this email is the primary email address. | | emails | type | enum | The type of email. Allowed enum values: `work`. | | emails | value | string | Email addresses for the user. | | Resources | id | string | The identifier of the resource. Not required when creating a user. | | Resources | meta | object | Metadata associated with a user. | | meta | created | date-time | The date and time the user was created. | | meta | lastModified | date-time | The date and time the user was last changed. | | meta | location | string | URL identifying the resource. | | meta | resourceType | string | Type of resource. | | Resources | name | object | The components of user's real name | | name | formatted | string | The full name, including all middle names, titles, and suffixes as appropriate, formatted for display. | | Resources | roles | [object] | Datadog roles assigned to the user. Provide the role UUID in `value` when provisioning or updating roles through SCIM. | | roles | display | string | Human-readable Datadog role name returned in responses. Read-only. | | roles | value [*required*] | string | Datadog role UUID. | | Resources | schemas | [string] | User JSON Schemas. | | Resources | title | string | The user's title. | | Resources | userName | string | Unique identifier for the User. | | | itemsPerPage | int64 | Number of users returned per page. | | | schemas | [string] | List response JSON Schemas. | | | startIndex | int64 | Starting index of the users for this page (1-indexed). | | | totalResults | int64 | Total number of users matching the request criteria. | {% /tab %} {% tab label="Example" %} ```json { "Resources": [ { "active": true, "emails": [ { "primary": true, "type": "work", "value": "john.doe@datadoghq.com" } ], "id": "e43536e9-33fe-43f8-90b8-d3e39a7dd6ad", "meta": { "created": "2024-11-22T15:05:52.055138963Z", "lastModified": "2024-11-22T15:05:52.055139017Z", "location": "https://app.datadoghq.com/api/scim/v2/Users/e43536e9-33fe-43f8-90b8-d3e39a7dd6ad", "resourceType": "User" }, "name": { "formatted": "John Doe" }, "roles": [ { "display": "Datadog Read Only Role", "value": "00000000-0000-0000-0000-000000000001" } ], "schemas": [ "urn:ietf:params:scim:schemas:core:2.0:User" ], "title": "Mr.", "userName": "john.doe@datadoghq.com" }, { "active": true, "emails": [ { "primary": true, "type": "work", "value": "jane.doe@datadoghq.com" } ], "id": "79ef0d28-f257-4829-97e6-d23d2a26cb1a", "meta": { "created": "2024-11-22T15:05:52.055139748Z", "lastModified": "2024-11-22T15:05:52.055139813Z", "location": "https://app.datadoghq.com/api/scim/v2/Users/79ef0d28-f257-4829-97e6-d23d2a26cb1a", "resourceType": "User" }, "name": { "formatted": "Jane Doe" }, "roles": [ { "display": "Datadog Standard Role", "value": "00000000-0000-0000-0000-000000000002" } ], "schemas": [ "urn:ietf:params:scim:schemas:core:2.0:User" ], "title": "Mrs.", "userName": "jane.doe@datadoghq.com" } ], "itemsPerPage": 2, "schemas": [ "urn:ietf:params:scim:api:messages:2.0:ListResponse" ], "startIndex": 1, "totalResults": 2 } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="400" %} Bad Request {% tabs %} {% tab label="Model" %} API error response. | Field | Type | Description | | ------------------- | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="429" %} Too many requests {% tabs %} {% tab label="Model" %} API error response. | Field | Type | Description | | ------------------- | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% /tabs %} ### Code Example {% tabs %} {% tab label="Curl" %} ```bash # Set your Datadog site and credentials export DD_SITE="datadoghq.com" # Or us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ap1.datadoghq.com, ap2.datadoghq.com, uk1.datadoghq.com, ddog-gov.com, us2.ddog-gov.com export DD_BEARER_TOKEN="" curl -X GET "https://api.${DD_SITE}/api/v2/scim/Users" \ -H "Accept: application/json" \ -H "Authorization: Bearer ${DD_BEARER_TOKEN}" ``` {% /tab %} {% /tabs %}