更新CAM用户同步

最近更新时间: 2026-10-12 00:11:05

1. 接口描述

接口请求域名： cic.api3.fincloud.tencent.com。

创建子用户同步任务

默认接口请求频率限制：20次/秒。

接口更新时间：2024-12-11 12:17:58。

接口既验签名又鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称 必选 允许NULL 类型 描述
Action 是 否 String 公共参数，本接口取值：UpdateUserSyncProvisioning
Version 是 否 String 公共参数，本接口取值：2021-03-31
Region 是 否 String 公共参数，地域信息本接口不需要传递此参数。
NewDescription 否 是 String 用户同步描述。
示例值： description
NewDuplicationStateful 否 是 String 冲突策略。当CIC 用户同步到 CAM 时，如果 CAM 中存在同名用户时的处理策略。取值： KeepBoth：两者都保留。当CIC 用户被同步到 CAM 时，如果 CAM 已经存在同名用户，则对CIC 用户的用户名添加后缀_cic后尝试创建该用户名的 CAM 用户。 TakeOver：替换。当CIC 用户被同步到 CAM 时，如果 CAM 已经存在同名用户，则直接将已经存在的 CAM 用户替换为CIC 同步用户。 
示例值： KeepBoth
NewDeletionStrategy 否 是 String 删除策略。删除 CAM 用户同步时，对已同步的 CAM 用户的处理策略。取值： Delete：删除。删除 CAM 用户同步时，会删除从CIC 已经同步到 CAM 中的 CAM 用户。 Keep：保留。删除 RAM 用户同步时，会保留从CIC 已经同步到 CAM 中的 CAM 用户。 
示例值： Delete
ZoneId 是 是 String 空间ID。
示例值： z-2d8shd8***
UserProvisioningId 是 是 String 用户同步的iD
示例值： up-sjisnw8ois

3. 输出参数

参数名称 类型 描述
RequestId String 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码 描述
FailedOperation.IdentityCenterNotOpen
FailedOperation.ZoneIdNotExist
ResourceNotFound.UserProvisioningNotFound

5. 示例

示例1 修改CAM用户同步

输入示例

{
  "ZoneId": "z-susn8xnsis",
  "UserProvisioningId": "up-xusjdjsss",
  "NewDescription": "this is cam user sync",
  "NewDuplicationStateful": "KeepBoth",
  "NewDeletionStrategy": "Delete"
}

输出示例

{
  "Response": {
    "RequestId": "e297543a-80de-4039-83c8-9d324545"
  }
}