创建账号并直接添加成员
前提条件
已获取阿里云账号或 RAM 用户的 AccessKey,并已为其授予调用本接口所需的 RAM 权限。建议将 AccessKey 配置为环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID 和 ALIBABA_CLOUD_ACCESS_KEY_SECRET,避免明文写入代码。
请求说明
-
HTTP 方法:POST
-
请求地址
地域
Endpoint
华北2(北京)
POST https://modelstudio.cn-beijing.aliyuncs.com/tokenplan/organization/member-additions -
认证方式
本接口是阿里云 OpenAPI,采用 AccessKey 签名(签名算法
ACS3-HMAC-SHA256),不支持Authorization: Bearer {API_KEY}方式。请求需携带公共请求头x-acs-action: AddOrganizationMember、x-acs-version: 2026-02-10、x-acs-date、x-acs-content-sha256、x-acs-signature-nonce以及Authorization。推荐使用阿里云 SDK 或 OpenAPI Explorer 发起调用,可免去自行计算签名。
请求参数
所有参数均通过 Query String 传递。
参数 | 类型 | 必选 | 描述 |
|---|---|---|---|
AccountName | string | 是 | 显示名称,若非空则同步更新账号的 name 字段 |
OrgRoleCode | string | 是 | 组织角色编码,只允许 ORG_ADMIN 或 ORG_MEMBER,默认 ORG_MEMBER |
SpecType | string | 否 | 席位规格 |
返回参数
参数 | 类型 | 描述 |
|---|---|---|
Success | boolean | 是否成功 |
Code | string | 响应状态码。 |
Message | string | 响应信息。 |
Data | object | 业务数据 |
AccountId | string | 账号 ID |
SeatAssigned | boolean | 席位分配是否成功 |
HttpStatusCode | integer | HTTP 状态码 |
RequestId | string | 请求唯一标识 |
请求示例
本接口使用阿里云 OpenAPI 签名,下例中 ${SIGNATURE} 需按 ACS3-HMAC-SHA256 算法计算得出,x-acs-date、x-acs-signature-nonce 需替换为实际值。示例 URL 中的中文取值为便于阅读未做编码;实际计算签名时,规范化请求(CanonicalRequest)的 Query String 需按 RFC 3986 对键和取值做百分号编码,否则会返回 SignatureDoesNotMatch。使用阿里云 SDK 时会自动处理。
curl -X POST "https://modelstudio.cn-beijing.aliyuncs.com/tokenplan/organization/member-additions?AccountName=账号名称&OrgRoleCode=ORG_MEMBER&SpecType=standard" \
--header "x-acs-action: AddOrganizationMember" \
--header "x-acs-version: 2026-02-10" \
--header "x-acs-date: 2026-01-01T12:00:00Z" \
--header "x-acs-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" \
--header "x-acs-signature-nonce: 3e3b2a9f0c7d4f8e9a1b2c3d4e5f6a7b" \
--header "Authorization: ACS3-HMAC-SHA256 Credential=${ALIBABA_CLOUD_ACCESS_KEY_ID},SignedHeaders=host;x-acs-action;x-acs-content-sha256;x-acs-date;x-acs-signature-nonce;x-acs-version,Signature=${SIGNATURE}"
返回示例
{
"Success": true,
"Data": {
"AccountId": "acc_123456789",
"SeatAssigned": true
}
}
错误码
如果调用失败,会返回错误信息。更多错误码及解决方法,请参见错误信息。