PATCH https://api.ap1.datadoghq.com/api/v2/scim/Users/{user_uuid}https://api.ap2.datadoghq.com/api/v2/scim/Users/{user_uuid}https://api.datadoghq.eu/api/v2/scim/Users/{user_uuid}https://api.ddog-gov.com/api/v2/scim/Users/{user_uuid}https://api.us2.ddog-gov.com/api/v2/scim/Users/{user_uuid}https://api.uk1.datadoghq.com/api/v2/scim/Users/{user_uuid}https://api.datadoghq.com/api/v2/scim/Users/{user_uuid}https://api.us3.datadoghq.com/api/v2/scim/Users/{user_uuid}https://api.us5.datadoghq.com/api/v2/scim/Users/{user_uuid}

概要

指定した user_uuid を持つユーザーをパッチ更新します。 This endpoint requires all of the following permissions:

  • user_access_invite
  • user_access_manage

  • 引数

    パスパラメーター

    名前

    種類

    説明

    user_uuid [required]

    string

    None

    リクエスト

    Body Data (required)

    Expand All

    フィールド

    種類

    説明

    Operations

    [object]

    A list of update operations to be performed on a user.

    op

    enum

    The operation to be performed. Allowed enum values: add,replace

    path

    string

    An attribute path describing the target of the operation.

    value

    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

    {
      "Operations": [
        {
          "op": "string",
          "path": "roles",
          "value": [
            "00000000-0000-0000-0000-000000000001"
          ]
        }
      ],
      "schemas": [
        "urn:ietf:params:scim:api:messages:2.0:PatchOp"
      ]
    }

    応答

    OK

    Definition of a user.

    Expand All

    フィールド

    種類

    説明

    active

    boolean

    A Boolean value indicating the User's administrative status.

    emails

    [object]

    Email addresses for the user.

    primary

    boolean

    Boolean indicating if this email is the primary email address.

    type

    enum

    The type of email. Allowed enum values: work

    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.

    created

    date-time

    The date and time the user was created.

    lastModified

    date-time

    The date and time the user was last changed.

    location

    string

    URL identifying the resource.

    resourceType

    string

    Type of resource.

    name

    object

    The components of user's real 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.

    display

    string

    Human-readable Datadog role name returned in responses.

    value [required]

    string

    Datadog role UUID.

    schemas

    [string]

    User JSON Schemas.

    title

    string

    The user's title.

    userName

    string

    Unique identifier for the User.

    {
      "active": false,
      "emails": [
        {
          "primary": false,
          "type": "string",
          "value": "string"
        }
      ],
      "id": "string",
      "meta": {
        "created": "2024-10-17T12:53:35.793Z",
        "lastModified": "2024-10-19T12:53:35.793Z",
        "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"
    }

    Bad Request

    API error response.

    Expand All

    フィールド

    種類

    説明

    errors [required]

    [string]

    A list of errors.

    {
      "errors": [
        "Bad Request"
      ]
    }

    Forbidden

    API error response.

    Expand All

    フィールド

    種類

    説明

    errors [required]

    [string]

    A list of errors.

    {
      "errors": [
        "Bad Request"
      ]
    }

    Not Found

    API error response.

    Expand All

    フィールド

    種類

    説明

    errors [required]

    [string]

    A list of errors.

    {
      "errors": [
        "Bad Request"
      ]
    }

    Too many requests

    API error response.

    Expand All

    フィールド

    種類

    説明

    errors [required]

    [string]

    A list of errors.

    {
      "errors": [
        "Bad Request"
      ]
    }

    コード例

                      ## default
    # 
    
    # Path parameters
    export user_uuid="CHANGE_ME"
    # Curl command
    curl -X PATCH "https://api.ap1.datadoghq.com"https://api.ap2.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.us2.ddog-gov.com"https://api.uk1.datadoghq.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/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"
    # Curl command
    curl -X PATCH "https://api.ap1.datadoghq.com"https://api.ap2.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.us2.ddog-gov.com"https://api.uk1.datadoghq.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/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