创建系统账号
更新时间 2026-03-11 10:03:17
最近更新时间: 2026-03-11 10:03:17
接口功能介绍
创建系统账号
接口约束
无
URI
POST /v2/createSystemAccount
路径参数 无
Query参数 无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| Content-Type | 是 | String | 类型 | application/json | |
| regionId | 是 | String | 资源池编码（资源池ID，您可以查看容器镜像服务资源池获取） | bb9fdb42056f11eda1610242ac110002 |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| instanceId | 是 | String | 实例ID | f04e47d9b48747958c9f4516cf1a8d82 | |
| systemAccountName | 是 | String | 系统账号名称。格式要求：以crs$开头，由字母、数字、下划线或短横线组成，长度1-25个字符，不能以下划线或短横线开头或结尾 | crs$test_account | |
| description | 否 | String | 描述信息，最大255个字符 | 测试系统账号 | |
| expirable | 是 | Boolean | 是否设置过期时间 | true | |
| expirationTime | 否 | String | 过期时间，格式：yyyy-MM-dd HH:mm:ss | 2025-12-31 23:59:59 | |
| scope | 是 | String | 权限范围。可选值：all（全部命名空间）、namespace（指定命名空间） | all | |
| auth | 否 | String | 权限类型。当scope为all时必填，可选值：push（推送权限）、pull（拉取权限） | push | |
| auths | 否 | Array of Objects | 权限列表。当scope为namespace时必填 | auths | |
| 表 auths |
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| namespaceId | 是 | String | 命名空间ID | f5b49578426e6da458fb9aba36d8cfdb | |
| auth | 是 | String | 权限类型。可选值：push（推送权限）、pull（拉取权限） | push |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 响应码 （800为请求成功，900为失败 ） | 800 | |
| message | String | 返回信息 | ||
| error | String | 错误码 | ||
| returnObj | Object | 返回结果 | returnObj | |
| 表 returnObj |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| systemAccountId | String | 系统账号ID | cf9f5ca532e4e8195cbaa6ba94cfa4f2 | |
| systemAccountName | String | 系统账号名称 | crs$test_account | |
| systemAccountPassword | String | 系统账号密码 | 896e29dac24f46a3ae85bf056ff70b19 |
枚举参数
无
请求示例
请求url
POST https://crs-global.ctapi.ctyun.cn/v2/createSystemAccount
请求头header
{
"Content-Type": "application/json",
"regionId": "bb9fdb42056f11eda1610242ac110002"
}
请求体body
{
"instanceId": "f04e47d9b48747958c9f4516cf1a8d82",
"systemAccountName": "crs$test_account",
"description": "测试系统账号",
"expirable": true,
"expirationTime": "2025-12-31 23:59:59",
"scope": "namespace",
"auths": [
{
"namespaceId": "f5b49578426e6da458fb9aba36d8cfdb",
"auth": "push"
},
{
"namespaceId": "a1b2c3d4e5f678901234567890123456",
"auth": "pull"
}
]
}
响应示例
{
"statusCode": 800,
"message": "",
"returnObj": {
"systemAccountId": "cf9f5ca532e4e8195cbaa6ba94cfa4f2",
"systemAccountName": "crs$test_account",
"systemAccountPassword": "896e29dac24f46a3ae85bf056ff70b19"
}
}
状态码
请参考 状态码
错误码
请参考 错误码
