CloneDatabase--云数据库 PostgreSQL 版-火山引擎

文档中心

立即注册

导航

CloneDatabase

最近更新时间：2025.06.10 11:39:06首次发布时间：2025.06.05 17:21:56

调用 CloneDatabase 接口克隆已有数据库。

请求类型

异步请求。

注意事项

一个实例下仅能存在一个克隆数据库的任务。
一个实例下最多可创建 2000 个数据库。当实例的数据库数量已达 2000 时，不能克隆数据库。
仅支持克隆表数量不超过 1000 的数据库。
在克隆数据库过程中，不可对数据库进行 DDL 操作。

请求参数

参数	类型	是否必选	示例值	描述
InstanceId	String	是	postgres-a3e7eb2f****	实例 ID
SourceDBName	String	是	database	源数据库名称。
NewDBName	String	否	database_clone	设定新数据库的名称。数据库名称应满足以下规则：在实例内名称唯一。长度为 2~63 个字符。以字母开头，以字母或数字结尾。由字母、数字、下划线（_）或中划线（-）组成。在数据库名称中禁用某些预留字或关键词，所有被禁用的关键词请参见禁用关键词。说明如不设定，则默认以`源数据库名称`+`_clone_`+`时间戳`为新数据库命名。
DataOption	String	否
PLPGSQLOption	String	否	View,Procedure	克隆数据库的 PL/pgSQL 选项。可取多个值，多个值之间用英文逗号（,）分隔。 `View`：视图。 `Procedure`：存储过程。 `Function`：函数。 `Trigger`：触发器。

返回参数

null

示例

请求示例

POST /?Action=CloneDatabase&Version=2022-01-01 HTTP/1.1
Content-Type: application/json
Host: rds-postgresql.cn-beijing.volcengineapi.com
X-Date: 20231002T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_postgresql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****
{
    "InstanceId": "postgres-a3e7eb2f****",
    "SourceDBName": "database",
    "NewDBName": "database_clone",
    "DataOption": "Metadata",
    "PLPGSQLOption": "View,Procedure"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2025050718082836C31DDC1C9EEA9716A6-2ac462",
        "Action": "CloneDatabase",
        "Version": "2022-01-01",
        "Service": "rds_postgresql",
        "Region": "cn-beijijng"
    },
    "Result": null
}