• 添加 组织架构41188的全体成员 和 组织架构41189的腾讯正式员工 到项目 10104801，角色为 测试人员 产品人员
  • curl 使用 Basic Auth 鉴权调用示例
  • curl 使用 OAuth Access Token 鉴权调用示例
  • 返回结果
  • 说明

说明

将组织架构关联到项目的用户组

url

https://apiv2.tapd.tencent.com/workspaces/add_workspace_organization_members

支持格式

JSON/XML（默认JSON格式）

HTTP请求方式

POST

请求数限制

将某一组织架构绑定到某一用户组, 会生成一对绑定关系。 此接口支持将若干个(记为m个)组织架构同时绑定到若干个(记为n个)用户组, 生成m*n对绑定关系。

请求参数

字段名	必选	类型及范围	说明	特殊规则
workspace_id	是	integer	待加入的项目ID	无
organizations	是	string	分号隔开的组织架构ID列表, 形如 41188;41189;	每个组织架构ID尾部可以指定具体的成员类别, 形如 41188:tencent_regular,tencent_partner;41189:subsidiary_regular,subsidiary_outsource;
role_ids	是	string	分号隔开的用户组ID列表	无
operator	是	string	操作人	无

调用示例及返回结果

添加 组织架构41188的全体成员 和 组织架构41189的腾讯正式员工 到项目 10104801，角色为 测试人员 产品人员

curl 使用 Basic Auth 鉴权调用示例

curl -u "api_user:api_password" -d 'workspace_id=10104801&operator=davidning&organizations=41188;41189:tencent_regular;&role_ids=1000000000000000010;1000000000000000015;' 'https://apiv2.tapd.tencent.com/workspaces/add_workspace_organization_members'

curl 使用 OAuth Access Token 鉴权调用示例

curl -H 'Authorization: Bearer ACCESS_TOKEN' -d 'workspace_id=10104801&operator=davidning&organizations=41188;41189:tencent_regular;&role_ids=1000000000000000010;1000000000000000015;' 'https://apiv2.tapd.tencent.com/workspaces/add_workspace_organization_members'

返回结果

{
    "status": 1,
    "data": {
        "success": true
    },
    "info": "success"
}

说明

• organization_id的值是组织架构对应的ID, 具体可以由太湖提供的组织架构相关接口 (opens new window)获取

• 每个组织架构ID尾部可以指定具体的成员类别, 若不指定则代表组织架构下的全体成员。

• 此接口支持将若干个(记为m个)组织架构同时绑定到若干个(记为n个)用户组, 生成m*n对绑定关系。 若在请求之前, 项目下已有旧的绑定关系, 其与请求内容里某一条关系的组织架构和用户组都相同, 则会覆盖更新这些旧的绑定关系。 例如: 第一次调用API指定某组织架构X的全员和组织架构Y的全员加入某用户组A和用户组B, 第二次调用API指定X的腾讯正式员工加入A 则最终的结果是: A中仅有X的腾讯正式员工和Y的全员, B中有X的全员和Y的全员。

• 组织架构ID尾部可以指定的成员类别一共有六类: tencent_regular: 腾讯正式, tencent_outsource: 腾讯外包(v_), tencent_partner: 腾讯合作伙伴(p_), subsidiary_regular: 子公司正式, subsidiary_outsource: 子公司外包, subsidiary_partner: 子公司合作伙伴。 其中前4类较为常用, 后2类较为少见, 多为TME的外包和合作伙伴。