[预览] 更新用户密码

更新指定用户的密码。

API 端点

POST https://{yourDomain}/identity/api/User/{userId}/changepassword

作用域

需要以下作用域：

• PM.User
• PM.User.Write

请求标头

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'

注意：如要获取 {access_token}，请确保通过此处描述的其中一种方法进行身份验证。

路径参数

路径参数	数据类型	描述
userId (必填)	字符串	要更新其密码的用户 ID。

请求正文

请求正文包含要向其添加用户的组织 ID，并可选择是否要包含要分配的组以将用户添加到其中。

{
  "oldPassword": "string",
  "newPassword": "string"
}

响应

200 OK

系统将在指定的组织中创建用户，并提供 ID。

400 Bad Request

无法创建用户。

{
    "errors": {
        "bypassBasicAuthRestriction": [
            "Unexpected character encountered while parsing value: h. Path 'bypassBasicAuthRestriction', line 17, position 35.",
            "Unexpected character encountered while parsing value: a. Path 'bypassBasicAuthRestriction', line 17, position 35."
        ]
    },
    "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
    "title": "One or more validation errors occurred.",
    "status": 400,
    "traceId": "00-aec3de9099a9934e9c31e26c19f5e0dd-8c0d3d5f476c7742-00"
}

请求示例

假设您收集了构建 API 调用所需的所有信息。

• 您的 {baseURL} 为：https://{yourDomain}/{organizationName}/{tenantName}/
• 您的 {access_token} 为：1234（出于长度考虑）。
• {userId} 为：har-3107

调用应如下所示 (cURL)：

curl --location --request POST 'https://{yourDomain}/{organizationName}/{tenantName}/identity_/api/User/har-3107/changepassword' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
  "oldPassword": "al0h0m0ra-account",
  "newPassword": "patr0nu5"
}'

以下是成功调用的响应：

{
    "succeeded": true,
    "errors": []
}