更新时间:2026-08-28 GMT+08:00
分享

CLI命令参考

共享资源权限

API名称

命令

描述

操作

检索共享资源权限列表

hcloud RAM ListPermissions

检索指定资源类型的共享资源权限列表。

去调试

检索资源共享权限内容

hcloud RAM ShowPermission

检索指定资源类型的共享资源指定版本的权限内容,如果不指定权限版本,则返回默认版本的权限内容。

去调试

获取权限的所有版本

hcloud RAM ListPermissionVersions

获取权限的所有版本。

去调试

资源共享实例

API名称

命令

描述

操作

创建资源共享实例

hcloud RAM CreateResourceShare

创建一个资源共享实例。您可以指定需要共享的资源列表,资源使用者列表,以及授予资源使用者的权限列表。

去调试

检索资源共享实例

hcloud RAM SearchResourceShares

检索您创建的或者共享给您的资源共享实例详情。

去调试

更新资源共享实例

hcloud RAM UpdateResourceShare

修改资源共享实例的特定属性。

去调试

删除资源共享实例

hcloud RAM DeleteResourceShare

删除指定的资源共享实例。此操作不会删除实体资源,仅停止向其他账号共享资源。

去调试

绑定的资源使用者和共享资源

API名称

命令

描述

操作

绑定资源使用者和共享资源

hcloud RAM AssociateResourceShare

向资源共享实例绑定指定的资源使用者列表或共享资源列表。对于新增的共享资源,有权访问此资源共享实例的资源使用者获得该共享资源的访问权限。对于新增的资源使用者,获得对此资源共享实例中共享资源的访问权限。

去调试

移除资源使用者或共享资源

hcloud RAM DisassociateResourceShare

将指定的资源使用者或共享资源从指定的资源共享实例中移除。资源使用者也可以从指定的资源共享实例中主动退出。

去调试

检索绑定的资源使用者和共享资源

hcloud RAM SearchResourceShareAssociations

检索您拥有的资源共享实例中绑定的共享资源和资源使用者。

去调试

绑定的共享资源权限

API名称

命令

描述

操作

绑定或替换共享资源权限

hcloud RAM AssociateResourceSharePermission

为资源共享实例中包含的资源类型绑定或替换共享资源权限。 对于资源共享实例中的每一种资源类型,您可以设置唯一权限。仅当资源共享实例中当前没有该资源类型的资源时,您才能绑定新的共享资源权限。

去调试

移除共享资源权限

hcloud RAM DisassociateResourceSharePermission

移除资源共享实例绑定的共享资源权限。权限更改立即生效。只有当目前资源共享实例中没有绑定相关资源类型时,您才能从资源共享实例中移除共享资源权限。

去调试

检索绑定的共享资源权限

hcloud RAM ListResourceSharePermissions

检索资源共享实例关联的共享资源权限。

去调试

标签管理

API名称

命令

描述

操作

查询已使用的标签列表

hcloud RAM ListResourceShareTags

查询资源共享实例已使用标签的列表。

去调试

根据标签信息查询实例列表

hcloud RAM ListResourceSharesByTags

根据标签信息查询资源共享实例列表。

去调试

根据标签信息查询实例数量

hcloud RAM SearchResourceShareCountByTags

根据标签信息查询资源共享实例数量。

去调试

资源共享实例增加标签

hcloud RAM BatchCreateResourceShareTags

资源共享实例增加标签。

去调试

删除资源共享实例的标签

hcloud RAM BatchDeleteResourceShareTags

删除资源共享实例指定的标签。

去调试

共享资源

API名称

命令

描述

操作

检索共享的资源

hcloud RAM SearchSharedResources

检索您共享的或共享给您的资源。

去调试

检索共享的不同资源

hcloud RAM SearchDistinctSharedResources

检索您添加到资源共享或被共享给您的不同资源。

去调试

资源使用者

API名称

命令

描述

操作

检索资源使用者或者资源所有者

hcloud RAM SearchSharedPrincipals

检索共享资源的使用者或者共享给您的资源所有者。

去调试

检索不同的资源使用者或者资源所有者

hcloud RAM SearchDistinctPrincipals

检索您正在共享资源的不同使用者或共享给您的不同资源所有者。

去调试

资源共享邀请

API名称

命令

描述

操作

接受共享邀请

hcloud RAM AcceptResourceShareInvitation

接受来自其他账号的资源共享邀请。

去调试

拒绝共享邀请

hcloud RAM RejectResourceShareInvitation

拒绝来自其他账号的资源共享邀请。

去调试

检索共享邀请

hcloud RAM SearchResourceShareInvitation

通过条件检索资源共享邀请。

去调试

组织共享

API名称

命令

描述

操作

检索是否启用与组织共享

hcloud RAM ShowOrganizationShare

检索是否启用与组织共享资源。

去调试

启用与组织共享

hcloud RAM EnableOrganizationShare

启用与组织共享资源。

去调试

关闭与组织共享

hcloud RAM DisableOrganizationShare

关闭与组织共享资源。

去调试

其他操作

API名称

命令

描述

操作

查询资源共享的配额

hcloud RAM ListQuota

查询当前账号的资源共享配额信息。

去调试

检索云服务资源类型

hcloud RAM ListResourceTypes

查询已对接云服务的资源类型和区域等信息。

去调试

相关文档