文档中心

大数据文件存储

管理命名空间

CreateNamespace - 创建命名空间

CreateNamespace - 创建命名空间

创建命名空间

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

Action string 必选示例值：CreateNamespace

要执行的操作，取值：CreateNamespace。

Version string 必选示例值：2024-08-01

API的版本，取值：2024-08-01。

Body

FileSystemId string 可选示例值：123456

文件系统 ID。

FileSystemName string 可选示例值：test

文件系统名称。

NamespaceType string 必选示例值：ACC_TOS

命名空间类型。

MountPath string 可选示例值：/test

挂载路径。

TosBucket string 可选示例值：test

挂载 TOS 桶。

TosRegion string 可选示例值：cn-beijing

挂载 TOS 桶所在地域。

TosPrefix string 可选示例值：test/

挂载 TOS 前缀。

TosCredentialType string 可选示例值：ServiceRole

访问 TOS 凭证类型。

TosStaticCredential object 可选示例值：详情请参见请求示例

访问 TOS 静态凭证。

AccessKeyId string 必选示例值：AKxxxx

用户标识，简称 AK。

SecretAccessKey string 必选示例值：SKxxxx

用户标识密钥，简称 SK。

TosRoleCredential object[] 可选示例值：详情请参见请求示例

访问 TOS 角色凭证。

AccountId string 必选示例值：2100000000

账号 ID。

Role string 必选示例值：RoleForTest

角色名称。

Description string 可选示例值：测试

描述。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

TaskId string 示例值：abcd

任务 ID。

NamespaceId string 示例值：123456

命名空间 ID。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidRequest	Invalid request in request body: %s.	请求体无效。
400	MissingParameter	The required parameter %s is not supplied.	缺少参数。
400	InvalidParameter	The specified parameter %s is not valid.	参数值无效。
400	NamespaceQuotaExceeded	Namespace quota has exceeded.	命名空间配额超限。
400	TosMountExists	The specified TOS mount already exists.	该对象存储挂载已存在。
400	BucketCrossAccountNotAllowed	The cross-account bucket is not allowed to be mounted.	跨账号桶不允许挂载。
400	NoPermissionToReadTos	The provided credentials have no permission to read TOS.	所提供的密钥没有权限读取TOS。
400	MountPathExists	The specified mount path already exists.	挂载路径已存在。
400	MountPathNested	The specified mount path is nested with the existing mount path %v.	挂载路径与已有路径%v嵌套。
400	InvalidNamespaceType	The Namespace type is invalid for this request.	该命名空间类型无法执行该请求。
400	InvalidFileSystemStatus	The FileSystem status is invalid for this request.	文件系统当前状态无法执行该请求。
400	InvalidFileSystemName	Invalid FileSystem name. Length must be between 2-63, name must start with a letter, contains only alphabets, numbers and '-'.	文件系统名称无效。长度必须介于2-63之间，名称必须以字母开头，仅包含字母、数字和'-'。
404	TosBucketNotFound	The specified TOS bucket does not exist.	该TOS桶不存在。
404	FileSystemNotFound	The specified FileSystem does not exist.	该文件系统不存在。
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	内部错误。

最近更新时间：2025.08.05 11:39:53

这个页面对您有帮助吗？

有用

有用

无用

无用