--- title: 사용자 패치 description: 지정된 user_uuid를 가진 사용자를 패치합니다. Datadog 역할을 업데이트하려면 path를 roles로 설정하고 value를 역할 UUID가 포함된 역할 객체 배열로 설정하여 작업을 보냅니다. breadcrumbs: 문서 > API > 사용자 패치 --- > For the complete documentation index, see [llms.txt](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/llms.txt). # 사용자 패치 ## v2 (latest) | Datadog site | API endpoint | | ----------------- | ----------------------------------------------------------------- | | app.datadoghq.com | PATCH https://api.datadoghq.com/api/v2/scim/Users/{user_uuid} | | us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v2/scim/Users/{user_uuid} | | us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v2/scim/Users/{user_uuid} | | app.datadoghq.eu | PATCH https://api.datadoghq.eu/api/v2/scim/Users/{user_uuid} | | ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v2/scim/Users/{user_uuid} | | ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v2/scim/Users/{user_uuid} | | uk1.datadoghq.com | PATCH https://api.uk1.datadoghq.com/api/v2/scim/Users/{user_uuid} | | app.ddog-gov.com | PATCH https://api.ddog-gov.com/api/v2/scim/Users/{user_uuid} | | us2.ddog-gov.com | PATCH https://api.us2.ddog-gov.com/api/v2/scim/Users/{user_uuid} | ### Overview 지정된 `user_uuid`를 가진 사용자를 패치합니다. Datadog 역할을 업데이트하려면 `path`를 `roles`로 설정하고 `value`를 역할 UUID가 포함된 역할 객체 배열로 설정하여 작업을 보냅니다. This endpoint requires all of the following permissions: - `user_access_invite` - `user_access_manage` ### Arguments #### Path Parameters | Field | Type | Description | | ---------------------- | ------ | ----------- | | user_uuid [*required*] | string | None | ### Request #### Body Data (required) {% tabs %} {% tab label="Model" %} | Parent field | Field | Type | Description | | ------------ | ---------- | -------- | ------------------------------------------------------------------------------------------------------------------------------ | | | Operations | [object] | 사용자 패치를 위한 요청 객체입니다. | | Operations | op | enum | The operation to be performed. Allowed enum values: `add`, `replace`. | | Operations | path | string | An attribute path describing the target of the operation. | | Operations | value | any | New value to use for the patch operation. When `path` is `roles`, use an array of role objects with each role UUID in `value`. | | | schemas | [string] | Input JSON Schemas | {% /tab %} {% tab label="Example" %} ```json { "Operations": [ { "op": "string", "path": "roles", "value": [ "00000000-0000-0000-0000-000000000001" ] } ], "schemas": [ "urn:ietf:params:scim:api:messages:2.0:PatchOp" ] } ``` {% /tab %} {% /tabs %} ### Response {% tabs %} {% tab label="200" %} OK {% tabs %} {% tab label="Model" %} Definition of a user. | Parent field | Field | Type | Description | | ------------ | ------------------ | --------- | ---------------------------------------------------------------------------------------------------------------------- | | | active | boolean | A Boolean value indicating the User's administrative status. | | | 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. | | | id | string | The identifier of the resource. Not required when creating a user. | | | 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. | | | 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. | | | 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. | | | schemas | [string] | User JSON Schemas. | | | title | string | The user's title. | | | userName | string | Unique identifier for the User. | {% /tab %} {% tab label="Example" %} ```json { "active": false, "emails": [ { "primary": false, "type": "string", "value": "string" } ], "id": "string", "meta": { "created": "2024-10-17 12:53:35.793883+00:00", "lastModified": "2024-10-19 12:53:35.793883+00:00", "location": "https://app.datadoghq.com/api/scim/v2/Users/13a95654-b76d-478d-8636-157a7e461d7c", "resourceType": "User" }, "name": { "formatted": "string" }, "roles": [ { "display": "Datadog Read Only Role", "value": "00000000-0000-0000-0000-000000000001" } ], "schemas": [ "urn:ietf:params:scim:schemas:core:2.0:User" ], "title": "string", "userName": "string" } ``` {% /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="403" %} Forbidden {% 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="404" %} Not Found {% 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 ## default # Path parameters export user_uuid="CHANGE_ME" # 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 PATCH "https://api.${DD_SITE}/api/v2/scim/Users/${user_uuid}" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${DD_BEARER_TOKEN}" \ -d @- << EOF { "Operations": [ { "op": "replace", "path": "title", "value": "CEO" }, { "op": "replace", "path": "roles", "value": [ { "value": "00000000-0000-0000-0000-000000000001" } ] }, { "op": "replace", "value": { "name": { "formatted": "John Doe" } } } ], "schemas": [ "urn:ietf:params:scim:api:messages:2.0:PatchOp" ] } EOF ## json-request-body # Path parameters export user_uuid="CHANGE_ME" # 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 PATCH "https://api.${DD_SITE}/api/v2/scim/Users/${user_uuid}" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${DD_BEARER_TOKEN}" \ -d @- << EOF { "Operations": [ { "op": "replace", "path": "title", "value": "CEO" }, { "op": "replace", "path": "roles", "value": [ { "value": "00000000-0000-0000-0000-000000000001" } ] }, { "op": "replace", "value": { "name": { "formatted": "John Doe" } } } ], "schemas": [ "urn:ietf:params:scim:api:messages:2.0:PatchOp" ] } EOF ``` {% /tab %} {% /tabs %}