tencent cloud

APIs

创建组织成员

Download
聚焦模式
字号
最后更新时间: 2026-04-24 16:29:10

1. 接口描述

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

创建组织成员

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

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

2. 输入参数

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

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:CreateOrganizationMember。
Version String 公共参数,本接口取值:2021-03-31。
Region String 公共参数,本接口不需要传递此参数。
Name String

成员名称。最大长度为25个字符,支持英文字母、数字、汉字、符号+@、&._[]-:,

PolicyType String

关系策略。取值:Financial

PermissionIds.N Array of Integer 成员财务权限ID列表。7-代付费,7 默认必须
NodeId Integer

成员所属部门的节点ID。可以通过DescribeOrganizationNodes获取

AccountName String

账号名称。最大长度为25个字符,支持英文字母、数字、汉字、符号+@、&._[]-:,

Remark String

备注。

RecordId Integer

成员创建记录ID。创建异常重试时需要

PayUin String

代付者Uin。成员代付费时需要

IdentityRoleID.N Array of Integer

成员访问身份ID列表。可以调用ListOrganizationIdentity获取,1默认支持

AuthRelationId Integer 认证主体关系ID。给不同主体创建成员时需要
Tags.N Array of Tag

成员标签列表。最大10个

3. 输出参数

参数名称 类型 描述
Uin Integer

成员Uin。

RequestId String 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 创建组织成员

输入示例

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

{
    "Name": "member_name",
    "PolicyType": "Financial",
    "PermissionIds": [
        1,
        2
    ],
    "NodeId": 100000000001,
    "AccountName": "member_name"
}

输出示例

{
    "Response": {
        "Uin": 111111111111,
        "RequestId": "baf86769-f4d5-47bd-8efc-3644add42458"
    }
}

5. 开发者资源

SDK

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

命令行工具

6. 错误码

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

错误码 描述
FailedOperation.AuthInfoEmpty 用户未实名。
FailedOperation.AuthNotEnterprise 用户非企业实名。
FailedOperation.CreateAccount 创建成员异常。
FailedOperation.CreateBillingPermissionErr 添加计费权限失败。
FailedOperation.CreateMemberAuthOverLimit 账号实名认证超过上限。
FailedOperation.CreateRecordAlreadySuccess 创建已成功。
FailedOperation.CreateRecordNotExist 创建记录不存在。
FailedOperation.CreateRole 创建角色异常。
FailedOperation.GetAuthInfo 查询实名信息出错。
FailedOperation.MemberNameUsed 名字已经被使用。
FailedOperation.OperateBillingPermissionErr 操作计费侧成员权限错误。
FailedOperation.OrganizationMemberNameUsed 成员名已存在。
FailedOperation.OrganizationNodeNotExist 组织节点不存在。
FailedOperation.OrganizationPermissionIllegal 组织权限不合法。
FailedOperation.OrganizationPolicyIllegal 组织策略不合法。
FailedOperation.PartnerManagementErr 调用经销系统报错。
FailedOperation.PayUinIllegal 代付者不合法。
FailedOperation.TagResourcesError 打标签异常。
InternalError 内部错误。
InvalidParameter 参数错误。
InvalidParameter.OrganizationMemberNotExist 组织成员不存在。
InvalidParameter.TagError 标签值错误。
LimitExceeded.CreateMemberOverLimit 创建成员超过上限。
LimitExceeded.OrganizationMemberOverLimit 成员超过上限。
ResourceNotFound.OrganizationAuthRelationNotExist 认证主体不存在。
ResourceNotFound.OrganizationMemberNotExist 组织成员不存在。
ResourceNotFound.OrganizationNodeNotExist 组织节点不在。
ResourceNotFound.OrganizationNotExist 企业组织不存在。
UnsupportedOperation.AbnormalFinancialStatusOfAdmin 代付者财务状态异常,不支持代付费。
UnsupportedOperation.AddDelegatePayerNotAllow 不允许添加代付关系。
UnsupportedOperation.AddDiscountInheritNotAllow 不允许添加优惠继承关系。
UnsupportedOperation.ExistedAgent 成员或者代付者存在经销商。
UnsupportedOperation.ExistedClient 成员或者代付者存在经销商子客。
UnsupportedOperation.InconsistentUserTypes 用户类型不一致。
UnsupportedOperation.ManagementSystemError 调用经管系统报错。
UnsupportedOperation.MemberAccountArrears 成员账户欠费。
UnsupportedOperation.MemberDiscountInheritExisted 成员存在优惠继承。
UnsupportedOperation.MemberExistAccountLevelDiscountInherit 成员存在账户级优惠。
UnsupportedOperation.MemberIsAgent 账号是代理商或代客。
UnsupportedOperation.OrderInProgressExisted 存在在途订单。
UnsupportedOperation.OwnerDiscountInheritExisted 管理员存在优惠继承。
UnsupportedOperation.PayerArrearsAndNoCreditAccount 代付者欠费且未开通信用账户。
UnsupportedOperation.PayerExistAccountLevelDiscountInherit 代付者存在账户级优惠。
UnsupportedOperation.SecondaryDistributorSubClientExisted 存在二级经销商子客,不支持代付费。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈