You need to enable JavaScript to run this app.
导航

CreateRepository

最近更新时间2022.09.28 10:40:10

首次发布时间2022.06.14 21:29:04

在指定命名空间下创建 OCI 制品仓库。

请求参数

参数名类型是否必须示例值描述
ActionStringCreateRepository公共参数,本接口值:CreateRepository。
VersionString2022-05-12公共参数,本接口值:2022-05-12。
RegistryStringregistrya指定命名空间所属的镜像仓库实例名称。在 镜像仓库控制台实例列表 页面,获取实例名称。
NamespaceStringlibrary目标命名空间名称。在 镜像仓库控制台 目标实例的 命名空间 页面,获取命名空间名称。
NameStringrepositoryaOCI 制品仓库名称。同一个命名空间下,名称必须唯一。支持小写英文、数字、分隔符(分隔符可输入一个./、一个或多个-、一个或两个_,且分隔符不能出现在首位或末位,不能连续出现),长度限制为 2~128 个字符。
DescriptionStringThis is a descriptionOCI 制品仓库描述信息。长度不超过 300 个字符。
AccessLevelStringPrivateOCI 制品仓库的类型。
  • Public:拥有全读写权限的子用户可推送或拉取镜像,其他用户可匿名拉取镜像。
  • Private:拥有全读写权限的子用户可推送或拉取镜像 ,拥有只读权限的子用户可拉取镜像。

默认值为 Private

ClientTokenStringed6b1190-dc17-11ec-9519-eb58a7******用于保证请求幂等性的字符串。该字符串由调用方传入,需保证不同请求之间唯一。ClientToken 对大小写敏感,且最大值不超过 64 个 ASCII 字符。

调用该 API 时,除了上述请求参数外,还需传入公共请求参数。公共请求参数说明,请参见 火山引擎公共参数文档

请求示例

POST /?Action=CreateRepository
&Version=2022-05-12
&<公共参数>

Body
{
    "Registry": "registrya",
    "Namespace": "library",
    "Name": "repositorya",
    "AccessLevel": "Private"
}

返回参数

返回示例

{
    "ResponseMetadata" : {
        "RequestId": "540CFF28-407A-40B5-B6A5-74Bxxxxxxxxx",
        "Action": "CreateRepository",
        "Version": "2022-05-12",
        "Service": "cr",
        "Region": "cn-beijing",
    },
    "Result": {}

错误码

本接口错误码如下表所示,公共错误码请参见 公共错误码

HTTP状态码错误码错误信息处理措施
400QuotaExceeded.RepositoryThe quota of cr repository is exceeded.OCI 制品数量已达到配额限制,建议先清理掉无用的 OCI 制品后重试。若确需提升配额,请参见 如何扩充配额
400OperationDenied.RegistryStatusThe action has been denied due to wrong status %s.当前实例状态下不允许执行指定操作,请等待状态转换后重试。