调用CreateNamespace接口创建命名空间。

调试

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

请求头

该接口使用公共请求头,无特殊请求头。更多信息,请参见公共请求和返回头

请求语法

POST /pop/v1/paas/namespace HTTP/1.1

请求参数

名称 类型 位置 是否必选 示例值 描述
NamespaceId String Query cn-beijing:test

长版命名空间ID。如果设置了该参数会继续生效而忽略NameSpaceShortId,为了兼容保留,推荐使用短版命名空间ID;格式为<RegionId>:<NamespaceId>NamespaceId仅允许小写英文字母和数字,例如cn-beijing:test,不超过32个字符。SAE支持的RegionId,请参见DescribeRegions

NamespaceName String Query name

命名空间名称。不超过64个字符。

NamespaceDescription String Query desc

命名空间描述信息,不超过100个字符。

NameSpaceShortId String Query test

短版命名空间ID,不需要带上region,推荐;不超过20个字符,仅允许小写英文字母和数字。

EnableMicroRegistration Boolean Query true

是否启用SAE内置注册中心:

  • true
  • false

默认为true,若不使用内置注册中心,填false可加快命名空间创建速度。

返回数据

名称 类型 示例值 描述
RequestId String 91F93257-7A4A-4BD3-9A7E-2F6EAE6D****

请求ID。

Message String success

调用结果的附加信息。

TraceId String 0a981dd515966966104121683d****

调用链ID,用于精确查询调用信息。

Data Object

命名空间信息。

NamespaceDescription String desc

命名空间描述信息。

NamespaceId String cn-beijing:test

命名空间ID。

NamespaceName String name

命名空间名称。

RegionId String cn-beijing

命名空间所在地域。

NameSpaceShortId String test

短版命名空间ID。

EnableMicroRegistration Boolean true

是否已启用SAE内置注册中心:

  • true
  • false
ErrorCode String

错误码。取值说明如下:

  • 请求成功:不返回ErrorCode字段。
  • 请求失败:返回ErrorCode字段。具体信息,请参见本文的错误码列表。
Code String 200

接口状态或POP错误码。取值说明如下:

  • 2xx:成功。
  • 3xx:重定向。
  • 4xx:请求错误。
  • 5xx:服务器错误。
Success Boolean true

创建命名空间是否成功。取值说明如下:

  • true:创建成功。
  • false:创建失败。

示例

请求示例

POST /pop/v1/paas/namespace?NamespaceId=cn-beijing:test&NamespaceName=name&NamespaceDescription=desc&NameSpaceShortId=test&EnableMicroRegistration=true HTTP/1.1
Host:sae.aliyuncs.com
Content-Type:application/json

正常返回示例

XML格式

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

<CreateNamespaceResponse>
    <RequestId>91F93257-7A4A-4BD3-9A7E-2F6EAE6D****</RequestId>
    <Message>success</Message>
    <TraceId>0a981dd515966966104121683d****</TraceId>
    <Data>
        <NamespaceDescription>desc</NamespaceDescription>
        <NamespaceId>cn-beijing:test</NamespaceId>
        <NamespaceName>name</NamespaceName>
        <RegionId>cn-beijing</RegionId>
        <NameSpaceShortId>test</NameSpaceShortId>
        <EnableMicroRegistration>true</EnableMicroRegistration>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</CreateNamespaceResponse>

JSON格式

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

{
  "RequestId" : "91F93257-7A4A-4BD3-9A7E-2F6EAE6D****",
  "Message" : "success",
  "TraceId" : "0a981dd515966966104121683d****",
  "Data" : {
    "NamespaceDescription" : "desc",
    "NamespaceId" : "cn-beijing:test",
    "NamespaceName" : "name",
    "RegionId" : "cn-beijing",
    "NameSpaceShortId" : "test",
    "EnableMicroRegistration" : true
  },
  "Code" : "200",
  "Success" : true
}

错误码

HttpCode 错误码 错误信息 描述
400 InstanceExist.NamespaceId The specified namespace ID already exists. 指定的命名空间ID已存在。
400 InvalidNamespace.WithUppercase This namespace does not support creating SAE apps because it contains uppercase letters. 命名空间不支持创建SAE应用,因为它带有大写字母。
400 InvalidNamespaceId.Format The specified NamespaceId is invalid. 指定的NamespaceId不合法。正确格式为[所属regionId]:[命名空间标识],例如cn-beijing:test,并且长度不能超过32个字符。
400 InvalidNamespaceIdSuffix.Format The specified NamespaceId is invalid. NamespaceId can only contain alphabetical letters or numbers. 指定的NamespaceId不合法。命名空间ID只能由字母或数字组成。
400 InvalidNamespaceName.Format The specified NamespaceName is invalid. The name of the namespace cannot exceed 63 characters in length. 指定的NamespaceName不合法。命名空间名称的长度不能超过63个字符。
400 InvalidOperation.NamespaceClusterNotDeleted The specified NamespaceId contains clusters. 指定的NamespaceId下还有集群。
400 Namespace.AppExists Please delete the application first. 请先删除应用。
400 System.Upgrading The system is being upgraded. Please try again later. 系统正在升级,请稍后操作。
400 Exceed.Namespace Too many namespaces have been created. 创建的命名空间过多。
500 OperationFailed.DauthHttpRequest request dauth failed. 请求认证系统失败。

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