插入资源成员

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求语法

POST /organization/{organizationId}/{resourceType}/{resourceId}/members HTTP/1.1
Content-Type:application/json

accountId=String&roleName=String

请求参数

表 1. 请求Path参数
参数名称 类型 是否必选 示例 说明
organizationId String 5ebbc0228123212b59xxxxx

企业标识,也称企业id,字符串形式,可在云效访问链接中获取,如https://devops.aliyun.com/organization/【OrganizationId】

resourceType String pipeline

资源类型pipelne 流水线hostGroup主机组

resourceId Long 123

资源id

表 2. 请求Body参数
参数名称 类型 是否必选 示例 说明
accountId String 1111111111111

阿里云账号id

roleName String admin
  • 角色
  • 部署组 hostGroup user 成员,使用权限 admin 管理员,使用编辑权限owner 拥有者,所有权限 流水线
    • 流水线 pipelineowner 拥有者,所有权限admin 查看、运行、编辑权限 member 运行权限 viewer 查看权限

响应体语法

HTTP/1.1 200 OK
Content-Type:application/json

{
  "requestId" : "String",
  "errorMessage" : "String",
  "errorCode" : "String",
  "success" : Boolean
}

响应参数

表 3. 响应Body参数
参数名称 类型 示例 说明
requestId String ASSDS-ASSASX-XSAXSA-XSAXSAXS

请求id,每次请求都是唯一值,便于后续排查问题

errorMessage String ""

错误信息

errorCode String ""

错误码

success Boolean true

true 接口调用成功,false 接口调用失败

示例1

POST /organization/{organizationId}/{resourceType}/{resourceId}/members HTTP/1.1
Host:devops.cn-hangzhou.aliyuncs.com
Content-Type:application/json

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateResourceMemberResponse>
    <requestId>ASSDS-ASSASX-XSAXSA-XSAXSAXS</requestId>
    <errorMessage>""</errorMessage>
    <errorCode>""</errorCode>
    <success>true</success>
</CreateResourceMemberResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "requestId" : "ASSDS-ASSASX-XSAXSA-XSAXSAXS",
  "errorMessage" : "\"\"",
  "errorCode" : "\"\"",
  "success" : true
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParam.ParamNotPresent The parameter is invalid. 参数有误,请检查参数
400 InvalidUser.NotFound The user that is invoking the API service is not a registered user. 调用 api 的用户,未注册为云效用户
400 InvalidResourceRole.NotFoun The member role is invalid. 无效的成员角色,请检查参数
403 Forbidden.UserNotInCurrentOrganization The user is not in the organization and is not authorized to perform the operation. 当前用户不在该企业中,无权进行操作。
404 InvalidOrganization.NotFound The organization is not found. 企业不存在,请检查企业id是否正确

访问错误中心查看更多错误码。

开发者资源

  • SDK

    阿里云为您提供多种语言的SDK,帮助您快速通过API集成阿里云的产品和服务,推荐您使用SDK调用API,已免除您手动签名验证。

  • OpenAPI Explorer

    快速检索,可视化调试API,在线命令行工具,同步动态生成可执行的SDK代码示例。

  • 阿里云CLI

    阿里云资产管理和配置工具,可通过命令方式同时管理多个阿里云产品和服务,简单快捷,是您上云好帮手。