文档首页/ 容器镜像服务 SWR/ CLI参考/ CLI命令参考(基础版)
更新时间:2026-08-27 GMT+08:00
分享

CLI命令参考(基础版)

组织管理

API名称

命令

描述

操作

创建组织

hcloud SWR CreateNamespace

创建组织

去调试

查询组织列表

hcloud SWR ListNamespaces

查询组织列表

去调试

删除组织

hcloud SWR DeleteNamespaces

删除组织

去调试

获取组织详情

hcloud SWR ShowNamespace

获取组织详情

去调试

镜像仓库管理

API名称

命令

描述

操作

在组织下创建镜像仓库

hcloud SWR CreateRepo

在组织下创建镜像仓库。

去调试

删除组织下的镜像仓库

hcloud SWR DeleteRepo

删除组织下的镜像仓库。

去调试

更新镜像仓库的概要信息

hcloud SWR UpdateRepo

更新租户组织下的镜像概要信息,包括镜像类型、是否公有、描述信息

去调试

查询镜像仓库概要信息

hcloud SWR ShowRepository

查询镜像仓库概要信息

去调试

查询镜像仓库列表

hcloud SWR ListReposDetails

查询镜像仓库列表

去调试

查询镜像仓库列表详情

hcloud SWR ListRepoDetails

查询镜像仓库列表详情

去调试

查询共享镜像列表

hcloud SWR ListSharedReposDetails

查询共享镜像列表

去调试

查询共享镜像列表详情

hcloud SWR ListSharedRepoDetails

查询共享镜像列表详情

去调试

镜像版本管理

API名称

命令

描述

操作

查询镜像tag列表

hcloud SWR ListRepositoryTags

查询镜像tag列表

去调试

创建镜像tag

hcloud SWR CreateRepoTag

创建镜像tag

去调试

查询镜像tag列表详情

hcloud SWR ListRepositoryTag

查询镜像tag列表详情

去调试

查询镜像的附件列表

hcloud SWR ListRepoAccessories

获取共享仓的镜像的附件列表

去调试

获取签名镜像关联的被签名镜像版本列表

hcloud SWR ListReferences

获取签名镜像关联的被签名镜像版本列表

去调试

查询指定tag的镜像详情

hcloud SWR ShowRepoTag

查询镜像仓库中指定tag的镜像

去调试

删除指定tag的镜像

hcloud SWR DeleteRepoTag

删除镜像仓库中指定tag的镜像

去调试

共享账号管理

API名称

命令

描述

操作

创建共享账号

hcloud SWR CreateRepoDomains

创建共享账号。镜像上传后,您可以共享私有镜像给其他账号,并授予下载该镜像的权限。

去调试

获取共享账号列表

hcloud SWR ListRepoDomains

获取共享账号列表

去调试

删除共享账号

hcloud SWR DeleteRepoDomains

删除共享账号

去调试

更新共享账号

hcloud SWR UpdateRepoDomains

更新共享账号

去调试

判断共享账号是否存在

hcloud SWR ShowAccessDomain

判断共享租户是否存在

去调试

API版本信息

API名称

命令

描述

操作

查询所有API版本信息

hcloud SWR ListApiVersions

查询所有API版本信息

去调试

查询指定API版本信息

hcloud SWR ShowApiVersion

查询指定API版本信息

去调试

组织权限管理

API名称

命令

描述

操作

创建组织权限

hcloud SWR CreateNamespaceAuth

创建组织权限

去调试

删除组织权限

hcloud SWR DeleteNamespaceAuth

删除组织权限

去调试

更新组织权限

hcloud SWR UpdateNamespaceAuth

更新组织权限

去调试

查询组织权限

hcloud SWR ShowNamespaceAuth

查询组织权限

去调试

镜像权限管理

API名称

命令

描述

操作

创建镜像权限

hcloud SWR CreateUserRepositoryAuth

创建镜像权限

去调试

删除镜像权限

hcloud SWR DeleteUserRepositoryAuth

删除镜像权限

去调试

更新镜像权限

hcloud SWR UpdateUserRepositoryAuth

更新镜像权限

去调试

查询镜像权限

hcloud SWR ShowUserRepositoryAuth

查询镜像权限

去调试

镜像同步管理

API名称

命令

描述

操作

获取镜像自动同步任务信息

hcloud SWR ShowSyncJob

创建镜像自动同步任务后,可以通过此接口查询该任务的状态,以判断是否同步成功。

去调试

获取镜像自动同步任务列表

hcloud SWR ListImageAutoSyncReposDetails

获取为当前镜像仓库所创建的所有自动同步任务。

去调试

创建镜像自动同步任务

hcloud SWR CreateImageSyncRepo

创建镜像自动同步任务,帮助您把最新推送的镜像自动同步到其他区域镜像仓库内。 镜像自动同步帮助您把最新推送的镜像自动同步到其他区域镜像仓库内,后期镜像有更新时,目标仓库的镜像也会自动更新,但已有的镜像不会自动同步。已有镜像的同步需要手动操作,详情请参见手动同步镜像。

去调试

删除镜像自动同步任务

hcloud SWR DeleteImageSyncRepo

根据目标区域、目标组织删除指定的镜像自动同步任务。

去调试

手动同步镜像

hcloud SWR CreateManualImageSyncRepo

对于镜像仓库已有的镜像,如果想在其他区域使用,需要手动触发镜像同步。 判断是否同步成功的方法如下:响应状态码为200,无报错信息,表示同步成功。通过SWR管理控制台或调用查询镜像仓库概要信息接口,在目标区域的目标组织下,若存在所同步的镜像版本表示同步成功。

去调试

获取可进行镜像同步的区域列表

hcloud SWR ListSyncRegions

获取可进行镜像同步的区域列表,用户可以将镜像手动或自动同步到此接口返回的区域。

去调试

触发器管理

API名称

命令

描述

操作

创建触发器

hcloud SWR CreateTrigger

创建触发器

去调试

获取镜像仓库下的触发器列表

hcloud SWR ListTriggersDetails

获取镜像仓库下的触发器列表

去调试

删除触发器

hcloud SWR DeleteTrigger

删除触发器

去调试

获取触发器详情

hcloud SWR ShowTrigger

获取触发器详情

去调试

更新触发器配置

hcloud SWR UpdateTrigger

更新触发器配置

去调试

镜像老化规则管理

API名称

命令

描述

操作

创建镜像老化规则

hcloud SWR CreateRetention

创建镜像老化规则

去调试

获取镜像老化规则列表

hcloud SWR ListRetentions

获取镜像老化规则列表

去调试

删除镜像老化规则

hcloud SWR DeleteRetention

删除镜像老化规则

去调试

获取镜像老化规则记录

hcloud SWR ShowRetention

获取镜像老化规则记录

去调试

修改镜像老化规则

hcloud SWR UpdateRetention

修改镜像老化规则

去调试

获取镜像老化记录

hcloud SWR ListRetentionHistories

获取镜像老化记录

去调试

临时登录指令

API名称

命令

描述

操作

生成临时登录指令

hcloud SWR CreateSecret

调用该接口,通过获取响应消息头的X-Swr-Dockerlogin的值及响应消息体的host值,可生成临时登录指令。

去调试

生成增强型登录指令(新)

hcloud SWR CreateAuthorizationToken

调用该接口,通过获取响应消息头的X-Swr-Dockerlogin的值及响应消息体的host值,可生成增强型登录指令,注:此接口只支持IAM新平面的调用方式。

去调试

配额管理

API名称

命令

描述

操作

获取配额信息

hcloud SWR ListQuotas

获取配额信息

去调试

其他

API名称

命令

描述

操作

查询服务特性开关信息

hcloud SWR ShowShareFeatureGates

查询服务特性开关信息

去调试

获取租户资源统计信息

hcloud SWR ShowDomainResourceReports

获取租户资源统计信息

去调试

获取租户总览信息

hcloud SWR ShowDomainOverview

获取租户总览信息

去调试

创建委托

hcloud SWR CreateAgency

租户首次使用SWR服务时创建SWR服务内部委托,一般由前端控制台自动调用,用户无需手动调用。

去调试

查询委托是否存在

hcloud SWR CheckAgency

检查租户是否已委托SWR服务通过触发器功能调用CCE、CCI服务,一般由前端控制台自动调用,用户无需手动调用。

去调试

相关文档