CLI命令参考
组织管理
| API名称 | 命令 | 描述 | 操作 |
|---|---|---|---|
| 创建组织 | hcloud Organizations CreateOrganization | 创建组织。调用此接口的账号将自动成为新组织的管理账号，调用此接口的账号凭证必须是新组织管理账号的账号凭证。 | |
| 查询所属组织信息 | hcloud Organizations ShowOrganization | 查询账号所属组织的信息。此操作可以由组织中的任何账号调用。 | |
| 删除组织 | hcloud Organizations DeleteOrganization | 删除组织。您必须使用管理账号才能删除组织，并且先移除组织中的所有账号、组织单元和策略。 | |
| 离开当前组织 | hcloud Organizations LeaveOrganization | 此操作只能由组织的成员账号调用。只有当组织账号配置了作为独立账号运行所需的信息时，您才能作为成员账号离开组织。要离开的账号不能是组织启用的任何服务的委托管理员账号。 | |
| 列出组织的根 | hcloud Organizations ListRoots | 列出当前组织的根。此接口只能由组织的管理账号或作为服务委托管理员的成员账号调用。 |
组织单元管理
| API名称 | 命令 | 描述 | 操作 |
|---|---|---|---|
| 创建组织单元 | hcloud Organizations CreateOrganizationalUnit | 在根或父组织单元中创建组织单元。组织单元是账号的容器，使您能够对账号进行分组管理，并根据业务要求应用策略。此操作只能由组织的管理账号调用。 | |
| 列出组织单元 | hcloud Organizations ListOrganizationalUnits | 列出组织中的所有组织单元。如果指定父级组织单元，则将获得父级直系子级的组织单元列表。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。 | |
| 查询有关组织单元的信息 | hcloud Organizations ShowOrganizationalUnit | 查询有关组织单元的信息。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。 | |
| 更改组织单元名称 | hcloud Organizations UpdateOrganizationalUnit | 重命名指定的组织单元。重命名后组织单元ID不变，下属子组织单元和下属账号不变，组织单元绑定的策略不变。此操作只能由组织的管理账号调用。 | |
| 删除组织单元 | hcloud Organizations DeleteOrganizationalUnit | 从根或其他组织单元中删除组织单元。前提是您必须先移除该组织单元中的所有成员账号或将成员账号移动至其他组织单元，必须删除该组织单元中的所有子组织单元。此操作只能由组织的管理账号调用。 |
账号管理
| API名称 | 命令 | 描述 | 操作 |
|---|---|---|---|
| 创建账号 | hcloud Organizations CreateAccount | 创建一个账号，生成的账号将自动成为调用此接口的账号所属组织的成员。此操作只能由组织的管理账号调用。组织云服务将在新账号中创建所需的服务关联委托和账号访问委托。 | |
| 列出组织中的账号 | hcloud Organizations ListAccounts | 列出组织中的账号。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。如果指定父级组织单元，则将获得作为父级直系子级的所有账号的列表。 | |
| 创建帐号 | hcloud Organizations CreateResourceAccount | 创建一个帐号，不携带手机号邮箱联系方式，生成的帐号将自动成为调用此接口的帐号所属组织的成员。此操作只能由组织的管理帐号调用。组织云服务将在新帐号中创建所需的服务关联委托和帐号访问委托。 | |
| 关闭账号 | hcloud Organizations CloseAccount | 关闭账号。 | |
| 查询账号信息 | hcloud Organizations ShowAccount | 查询有关指定账号的信息。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。 | |
| 更新账号信息 | hcloud Organizations UpdateAccount | 更新指定的账号信息。此操作只能由组织的管理账号调用。 | |
| 移除指定的账号 | hcloud Organizations RemoveAccount | 从组织中移除指定的账号。移除的账号将成为一个独立账号，该账号不是任何组织的成员。此操作只能由组织的管理账号调用。只有当账号配置了作为独立账号运行所需的信息时，您才能从组织中移除账号。注意，要移除的账号不能是组织启用的任何服务的委托管理员账号。 | |
| 移动账号 | hcloud Organizations MoveAccount | 将账号从其当前源位置（根或组织单元）移动到指定的目标位置（根或组织单元）。 | |
| 邀请账号加入组织 | hcloud Organizations InviteAccount | 向另一个账号发送邀请，受邀账号将以成员账号加入您的组织。此操作只能由组织的管理账号调用。 | |
| 列出创建账号的状态 | hcloud Organizations ListCreateAccountStatuses | 列出组织中指定状态的账号创建请求。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。 | |
| 查询有关创建账号状态的信息 | hcloud Organizations ShowCreateAccountStatus | 检索创建账号的异步请求的当前状态。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。 | |
| 列出关闭账号的状态 | hcloud Organizations ListCloseAccountStatuses | 列出组织中指定状态的账号关闭请求。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。 |
邀请管理
| API名称 | 命令 | 描述 | 操作 |
|---|---|---|---|
| 查询邀请相关信息 | hcloud Organizations ShowHandshake | 查询组织中已有账号邀请的相关信息。此接口可以由组织中的任何账号调用。 | |
| 接受邀请 | hcloud Organizations AcceptHandshake | 向邀请的发起方发送应答，接受加入组织邀请。在您接受邀请后，此邀请信息将继续保留并出现在相关API的返回结果中，保留期限为30天。 | |
| 拒绝邀请 | hcloud Organizations DeclineHandshake | 拒绝邀请请求。受邀账号拒绝邀请，此时当前邀请状态将设置为拒绝，邀请停止。此接口只能由受邀账号调用。邀请发起者无法再次激活被拒绝的邀请，但可以重新发送新的邀请。 | |
| 取消邀请 | hcloud Organizations CancelHandshake | 取消邀请，此时邀请状态将设置为已取消。此接口只能由发起邀请的账号调用。取消邀请后，此邀请信息将继续保留并出现在相关API的返回结果中，保留期限为30天。 | |
| 列出收到的邀请 | hcloud Organizations ListReceivedHandshakes | 列出账号收到的所有邀请。此操作可以由任何账号调用。 | |
| 列出发送的邀请 | hcloud Organizations ListHandshakes | 列出所属组织发送的邀请。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。 |
可信服务管理
| API名称 | 命令 | 描述 | 操作 |
|---|---|---|---|
| 启用可信服务 | hcloud Organizations EnableTrustedService | 启用服务（由service_principal指定的服务）与组织的集成。启用可信服务后，允许指定的可信服务对组织中的所有账号创建服务关联委托。这允许可信服务代表您在组织及其账号中执行操作。此接口只能由组织的管理账号调用。 | |
| 禁用受信任服务 | hcloud Organizations DisableTrustedService | 禁用服务（由service_principal指定的服务）与组织的集成。禁用可信服务后，指定服务将不可以在组织中的新账号中创建服务关联委托。这意味着该服务无法代表您对组织中的任何新账号执行操作。在服务完成从组织中的清理之前，服务仍可以在旧账号中执行操作。此接口只能由组织的管理账号调用。 | |
| 列出组织的可信服务列表 | hcloud Organizations ListTrustedServices | 返回启用与组织集成的可信服务列表。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。 |
委托管理员管理
| API名称 | 命令 | 描述 | 操作 |
|---|---|---|---|
| 注册作为服务委托管理员 | hcloud Organizations RegisterDelegatedAdministrator | 指定成员账号能够管理指定服务的组织功能。此接口授予委托管理员对组织服务数据的只读访问权限。委托管理员账号中的IAM用户仍需要IAM权限才能访问和管理服务。此操作只能由组织的管理账号调用。 | |
| 注销服务的委托管理员 | hcloud Organizations DeregisterDelegatedAdministrator | 删除指定成员账号作为指定服务的委托管理员。此操作只能由组织的管理账号调用。 | |
| 列出指定账号是其委托管理员的服务 | hcloud Organizations ListDelegatedServices | 列出指定账号是其委托管理员的服务。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。 | |
| 列出此组织中指定为委托管理员的账号 | hcloud Organizations ListDelegatedAdministrators | 列出在此组织中指定为委派管理员的账号。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。 |
策略管理
| API名称 | 命令 | 描述 | 操作 |
|---|---|---|---|
| 创建策略 | hcloud Organizations CreatePolicy | 创建指定类型的策略。此操作只能由组织的管理账号调用。 | |
| 列出策略 | hcloud Organizations ListPolicies | 列出组织中的所有策略。如果指定了资源ID，例如组织单元ID或账号ID，则将获得该资源已绑定的策略列表。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。 | |
| 查询策略相关信息 | hcloud Organizations ShowPolicy | 检索策略的相关信息。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。 | |
| 更新策略 | hcloud Organizations UpdatePolicy | 更新策略，可以更新策略的名称、描述或内容。如果不提供任何参数，则策略将保持不变。您不能更改策略的类型。此操作只能由组织的管理账号调用。 | |
| 删除策略 | hcloud Organizations DeletePolicy | 从组织中删除指定的策略。在执行此操作之前，必须首先将策略跟所有组织单元、根和账号解绑。此操作只能由组织的管理账号调用。 | |
| 在根中启用策略类型 | hcloud Organizations EnablePolicyType | 在根中启用策略类型。在根中启用策略类型后，您可以将该类型的策略绑定到根、或该根中的任何组织单元和账号。这是在后台执行的异步请求。您可以使用ListRoots查看指定根的策略类型的状态。此操作只能由组织的管理账号调用。 | |
| 禁用根中的策略类型 | hcloud Organizations DisablePolicyType | 禁用根中的策略类型。只有在根中启用了特定类型的策略，才能将该类型的策略绑定到根中的实体。执行此操作后，您不能再将指定类型的策略绑定到该根或该根中的任何组织单元或账号。这是在后台执行的异步请求。您可以使用ListRoots查看指定根的策略类型的状态。此操作只能由组织的管理账号调用。 | |
| 将策略跟实体绑定 | hcloud Organizations AttachPolicy | 绑定策略到根、组织单元或个人账号。此操作只能由组织的管理账号调用。 | |
| 将策略跟实体解绑 | hcloud Organizations DetachPolicy | 从根、组织单元或账号解绑策略。此操作只能由组织的管理账号调用。 | |
| 列出跟指定策略绑定的所有实体 | hcloud Organizations ListEntitiesForPolicy | 列出跟指定策略绑定的所有根、组织单元和账号。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。 |
标签管理
| API名称 | 命令 | 描述 | 操作 |
|---|---|---|---|
| 列出绑定到指定资源的标签 | hcloud Organizations ListTagsForResource | 列出绑定到指定资源的标签。您可以将标签附加到组织中的账号、组织单元、根和策略。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。 | |
| 为指定资源添加标签 | hcloud Organizations TagResource | 向指定的资源添加一个或多个标签。目前，您可以将标签附加到组织中的账号、组织单元、根和策略。此操作只能由组织的管理账号调用。 | |
| 从指定资源中删除指定主键标签 | hcloud Organizations UntagResource | 从指定资源中删除具有指定主键的任何标签。您可以将标签绑定到组织中的账号、组织单元、根和策略。此操作只能由组织的管理账号调用。 | |
| 列出绑定到指定资源类型的标签 | hcloud Organizations ListTagResources | 列出绑定到指定资源类型的标签。您可以将标签附加到组织中的账号、组织单元、根和策略。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。 | |
| 为指定资源类型添加标签 | hcloud Organizations CreateTagResource | 向指定的资源类型添加一个或多个标签。目前，您可以将标签附加到组织中的账号、组织单元、根和策略。此操作只能由组织的管理账号调用。 | |
| 从指定资源类型中删除指定主键标签 | hcloud Organizations DeleteTagResource | 从指定资源类型中删除具有指定主键的任何标签。您可以将标签绑定到组织中的账号、组织单元、根和策略。此操作只能由组织的管理账号调用。 | |
| 根据资源类型及标签信息查询实例列表 | hcloud Organizations ListResourceInstances | 根据资源类型及标签信息查询实例列表。 | |
| 根据资源类型及标签信息查询实例数量 | hcloud Organizations ShowResourceInstancesCount | 根据资源类型及标签信息查询实例数量。 | |
| 查询资源标签 | hcloud Organizations ListResourceTags | 查询资源标签。 |
其他
| API名称 | 命令 | 描述 | 操作 |
|---|---|---|---|
| 查询有效的策略 | hcloud Organizations ShowEffectivePolicies | 查询指定策略类型和账号的有效策略信息。当前此接口不支持查询服务控制策略（service_control_policy）。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。 | |
| 列出组织中的根、组织单元和账号 | hcloud Organizations ListEntities | 列出组织中包含的所有根、组织单元和账号。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。您可以通过指定父ID和子ID参数来过滤实体。 | |
| 列出所有可以与组织服务集成的云服务 | hcloud Organizations ListServices | 列出所有可以与组织服务集成的云服务。集成后云服务将成为组织的可信服务。 | |
| 列出被添加到标签策略强制执行的资源类型 | hcloud Organizations ListTagPolicyServices | 列出被添加到标签策略强制执行的资源类型。 | |
| 列出租户的组织配额 | hcloud Organizations ListQuotas | 列出租户的组织配额。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。 |
策略试运行配置
试运行策略管理
| API名称 | 命令 | 描述 | 操作 |
|---|---|---|---|
| 创建试运行策略 | hcloud Organizations CreateDryRunPolicy | 创建指定类型的试运行策略。此操作只能由组织的管理账号调用。 | |
| 列出试运行策略 | hcloud Organizations ListDryRunPolicies | 列出组织中的所有试运行策略。如果指定了资源ID，例如组织单元ID或账号ID，则将获得该资源已绑定的策略列表。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。 | |
| 查询试运行策略相关信息 | hcloud Organizations ShowDryRunPolicy | 检索试运行策略的相关信息。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。 | |
| 更新试运行策略 | hcloud Organizations UpdateDryRunPolicy | 更新试运行策略，可以更新试运行策略的名称、描述或内容。如果不提供任何参数，则策略将保持不变。您不能更改策略的类型。此操作只能由组织的管理账号调用。 | |
| 删除试运行策略 | hcloud Organizations DeleteDryRunPolicy | 从组织中删除指定的试运行策略。在执行此操作之前，必须首先将策略跟所有组织单元、根和账号解绑。此操作只能由组织的管理账号调用。 | |
| 将试运行策略跟实体绑定 | hcloud Organizations AttachDryRunPolicy | 绑定试运行策略到根、组织单元或个人账户。此操作只能由组织的管理账号调用。 | |
| 将试运行策略跟实体解绑 | hcloud Organizations DetachDryRunPolicy | 从根、组织单元或账号解绑试运行策略。此操作只能由组织的管理账号调用。 | |
| 列出跟指定试运行策略绑定的所有实体 | hcloud Organizations ListEntitiesForDryRunPolicy | 列出跟指定试运行策略绑定的所有根、组织单元和账号。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。 |
