在指定的镜像仓库实例下创建命名空间。 ## 接口说明单个标准版实例最多可创建 50 个命名空间。 ## 请求说明为获得低延迟，建议您根据资源所在的地域选择对应的服务地址，详情参见 [服务地址](https://www.volcengine.com/docs/6420/1584339)。 * 请求方式：POST * 请求地址：https://cr.cn\-beijing.volcengineapi.com?Action=CreateNamespace&Version=2022\-05\-12 ## 调试 ## 请求参数调用该 API 时，除了以下请求参数外，还需传入公共请求参数。公共请求参数说明，请参见 [火山引擎公共参数文档](https://www.volcengine.com/docs/6369/67268)。 |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |CreateNamespace |接口名称。当前 API 的名称为 `CreateNamespace`。 | |Version |String |是 |2022\-05\-12 |接口版本。当前 API 的版本为 `2022-05-12`。 | |Registry |String |是 |registrya |指定的镜像仓库实例名称。通过 [ListRegistries](https://www.volcengine.com/docs/6420/113746) 或在 [镜像仓库控制台](https://console.volcengine.com/cr) 的 **实例列表**页面获取。 | |Name |String |是 |library |命名空间名称。支持小写英文、数字、英文句号（.）、短划线（\-）、下划线（_），标点符号不能出现在首位或末位，也不能连续输入。长度限制为 2～90 个字符。|\ | | | | ||\ | | | | |* **标准版实例**：同一个镜像仓库实例下，名称必须唯一。|\ | | | | |* **体验版实例**：同一地域下，所有火山引擎账号范围内的命名空间名称需要保持唯一。如果您设置的命名空间名称已被占用，请尝试其他名称或者 [购买标准版实例](../6420/106367)。 | |ClientToken |String |否 |7fb07cc4\-dc14\-11ec\-a7ae\-af0220\*\*\*\*\*\* |用于保证请求幂等性的字符串。该字符串由调用方传入，需保证不同请求之间唯一。ClientToken 对大小写敏感，且最大值不超过 64 个 ASCII 字符。 | |Project |String |否 |projecta |命名空间所属项目的名称。参数值大小写敏感，不得超过 64 个字符。参数为空时，命名空间关联默认的 `default`项目。 | |RepositoryDefaultAccessLevel |String |否 |Public |命名空间下新建 OCI 制品仓库的默认公开属性，默认 Private。公开属性支持后续变更。|\ | | | | ||\ | | | | |* Public：公开，不需要访问密钥，支持直接访问。|\ | | | | |* Private：私有，需要输入访问密钥后才能够访问。 | ## 请求示例 ```json POST https://cr.cn-beijing.volcengineapi.com?Action=CreateNamespace&Version=2022-05-12 { "Registry": "registrya", "Name": "library" } ``` ## 返回参数无 ## 返回示例 ```json { "ResponseMetadata": { "RequestId": "540CFF28-407A-40B5-B6A5-74B****", "Action": "CreateNamespace", "Version": "2022-05-12", "Service": "cr", "Region": "cn-beijing" }, "Result": {} } ``` ## 错误码本接口错误码如下表所示，公共错误码请参见 [公共错误码](https://www.volcengine.com/docs/6420/79348)。 |**HTTP 状态码** |**错误码** |**错误信息** |**说明** | |---|---|---|---| |400 |OperationDenied.RegistryStatus |The action has been denied due to wrong status %s. |当前实例状态下不允许执行指定操作，请等待状态转换后重试。 | |400 |QuotaExceeded.Namespace |The quota of cr namespace is exceeded. |命名空间数量已达到配额限制，建议先清理掉无用的命名空间后重试。若确需提升配额，请参见 [如何扩充配额](https://www.volcengine.com/docs/6420/78518)。 |