tencent cloud

集团账号管理

  • 产品简介
  • 购买指南
  • 操作指南
    • 控制台概述
    • 集团组织设置
    • 部门管理
    • 成员账号管理
    • 成员财务管理
    • 成员访问管理
    • 资源管理
    • 成员审计
    • 集团身份管理
  • API 文档
    • 更新历史
    • 简介
    • API 概览
    • 调用方式
    • 组织设置相关接口
    • 部门与成员管理相关接口
    • 成员统一登录相关接口
    • 成员统一登录相关接口
    • 集团服务管理相关接口
    • 集团管理策略相关接口
    • 资源共享相关接口
    • 身份中心管理相关接口
    • 身份中心管理用户相关接口
    • 身份中心管理用户组相关接口
    • 身份中心管理SCIM同步相关接口
    • 身份中心管理单点登录相关接口
    • 身份中心管理权限配置相关接口
    • 身份中心管理多账号授权相关接口
    • 身份中心管理子用户同步相关接口
    • 数据结构
    • 错误码
    • 企业组织 API 2018-12-25
  • 相关协议
  • 常见问题
  • 词汇表
Documentation 集团账号管理 API 文档身份中心管理子用户同步相关接口查询CAM用户同步列表

查询CAM用户同步列表

Download
Focus Mode
Font Size
Last updated: 2026-05-26 23:21:08

1. 接口描述

接口请求域名： organization.intl.tencentcloudapi.com 。

查询CAM用户同步列表

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

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

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

参数名称 必选 类型 描述
Action 是 String 公共参数，本接口取值：ListUserSyncProvisionings。
Version 是 String 公共参数，本接口取值：2021-03-31。
Region 否 String 公共参数，此参数为可选参数。
ZoneId 是 String 空间 ID。
PrincipalId 否 String 用户同步 ID。取值： 当PrincipalType取值为Group时，该值为用户组 ID（g-****）。 当PrincipalType取值为User时，该值为用户 ID（u-****）。
NextToken 否 String 查询返回结果下一页的令牌。首次调用 API 不需要NextToken。 当您首次调用 API 时，如果返回数据总条数超过MaxResults限制，数据会被截断，只返回MaxResults条数据，同时，返回参数IsTruncated为true，返回一个NextToken。您可以使用上一次返回的NextToken继续调用 API，其他请求参数保持不变，查询被截断的数据。您可以按此方法多次查询，直到IsTruncated为false，表示全部数据查询完毕。
MaxResults 否 Integer 每页的最大数据条数。 取值范围：1~100。 默认值：10。
PrincipalType 否 String CAM 用户同步的身份类型。取值： User：表示同步的身份是用户。 Group：表示同步的身份是用户组。
TargetUin 否 Integer 集团账号目标账号的UIN。
TargetType 否 String 同步的集团账号目标账号的类型，ManagerUin管理账号;MemberUin成员账号
Filter 否 String 检测条件。

3. 输出参数

参数名称 类型 描述
NextToken String 查询返回结果下一页的令牌。 说明 只有IsTruncated为true时，才显示该参数。
TotalCounts Integer 符合请求参数条件的数据总条数。
MaxResults Integer 每页的最大数据条数。
IsTruncated Boolean 返回结果是否被截断。取值： true：已截断。 false：未截断。
UserProvisionings Array of UserProvisioning CAM同步的用户列表。
RequestId String 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 查询CAM用户同步列表

查询CAM用户同步列表

输入示例

POST / HTTP/1.1
Host: organization.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ListUserSyncProvisionings
<公共请求参数>

{
    "ZoneId": "z-dsjsisnus",
    "PrincipalId": "u-sjs9smss",
    "NextToken": "",
    "MaxResults": 10,
    "PrincipalType": "User",
    "TargetUin": 100000000002,
    "TargetType": "MemberUin",
    "Filter": "user1"
}

输出示例

{
    "Response": {
        "NextToken": "OTM0YzE4MzY2ZjdhMWM0MYZDhnYaxsiYTLI=",
        "TotalCounts": 30,
        "MaxResults": 10,
        "IsTruncated": true,
        "UserProvisionings": [
            {
                "UserProvisioningId": "up-siwnei3nso",
                "Description": "this is cam user sync",
                "Status": "Enabled",
                "PrincipalId": "u-swnd8wn3",
                "PrincipalName": "user1",
                "PrincipalType": "User",
                "TargetUin": 100000000002,
                "TargetName": "user2",
                "DuplicationStrategy": "KeepBoth",
                "DeletionStrategy": "Delete",
                "CreateTime": "2024-01-01 12:12:12",
                "UpdateTime": "2024-01-01 12:12:12",
                "TargetType": "MemberUin"
            }
        ],
        "RequestId": "e297543a-80de-4039-83c8-9d35d4545"
    }
}

5. 开发者资源

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

命令行工具

6. 错误码

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

错误码 描述
FailedOperation.IdentityCenterNotOpen CIC服务没有开通
FailedOperation.ZoneIdNotExist CIC服务的用户zoneId不存在
InvalidParameter.NextTokenInvalid 无效的nextToken
Previous Topic: 查询异步任务的状态Next Topic: 创建CAM用户同步

Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback