更新时间：2026-10-20 GMT+08:00

迁移资源 - MigrateVaultResource

功能介绍

将资源迁移到另一个存储库，迁移过程中不删除备份。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，当前API调用无需身份策略权限。

URI

POST /v3/{project_id}/vaults/{vault_id}/migrateresources

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目ID，获取方法请参见获取项目ID 约束限制：不涉及取值范围：不涉及默认取值：不涉及
vault_id	是	String	参数解释：存储库ID，获取方法请参见获取存储库ID 约束限制：不涉及取值范围：不涉及默认取值：不涉及

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	否	String	参数解释：用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。约束限制：不涉及取值范围：不涉及默认取值：不涉及

表3 请求Body参数
参数	是否必选	参数类型	描述
destination_vault_id	是	String	参数解释：目标存储库ID，获取方法请参见获取存储库ID 约束限制：不涉及取值范围：不涉及默认取值：不涉及
resource_ids	是	Array of strings	参数解释：待迁移的资源ID列表，多个资源ID间以英文逗号分隔约束限制：不涉及取值范围：资源ID格式为UUID 默认取值：不涉及

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
migrated_resources	Array of strings	参数解释：迁移资源列表取值范围：不涉及

请求示例

迁移备份资源从源存储库到目标存储库且不删除源备份。

POST https://{endpoint}/v3/f841e01fd2b14e7fa41b6ae7aa6b0594/vaults/79bd9daa-884f-4f84-b8fe-235d58cd927d/migrateresources

{
  "resource_ids" : [ "abcdde3f-e0e3-403a-b690-fc259dd70008" ],
  "destination_vault_id" : "fe578a6c-d1a8-4790-bd52-5954af4d446c"
}

响应示例

状态码：200

{
  "migrated_resources" : [ "fe578a6c-d1a8-4790-bd52-5954af4d446c" ]
}

状态码

状态码	描述
200	OK

错误码

请参见错误码。

父主题： 存储库