CreateDBInstance_云原生数据仓库 AnalyticDB PostgreSQL版_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

请确保在使用该接口前,已充分了解 AnalyticDB PostgreSQL 版产品的收费方式价格

流控信息

请求速率为3000/1(s)。更多流控信息,请前往配额中心查看

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
gpdb:CreateDBInstance
Create
DBInstance
acs:gpdb:{#regionId}:{#accountId}:dbinstance/*
gpdb:EncryptionType
gpdb:SSLEnabled

请求参数

字段名称字段详情
RegionIdstring

地域 ID。展开详情

示例值:cn-hangzhou参考取值来源:
    DescribeRegions
ZoneIdstring

可用区 ID。展开详情

示例值:cn-hangzhou-i
EngineVersionstring

引擎版本,取值如下:展开详情

示例值:6.0
Enginestring

数据库引擎,取值为 gpdb

示例值:gpdb
DBInstanceClassstring

实例规格,详细说明请参见 DBInstanceClass 参数补充说明。展开详情

示例值:gpdb.group.segsdx1参考取值来源:
    DescribeDBInstanceAttribute
DBInstanceGroupCountstring

计算组数量。取值为:2、4、8、12、16、24、32、64、96、128。展开详情

示例值:2参考取值来源:
    DescribeDBInstanceAttribute
DBInstanceDescriptionstring

实例描述。

示例值:test
SecurityIPListstring

IP 白名单。展开详情

示例值:127.0.0.1参考取值来源:
    DescribeDBInstanceIPArrayList
PayTypestring

计费类型,取值如下:展开详情

示例值:Prepaid
Periodstring

购买资源的时长单位。取值如下:展开详情

示例值:Month
UsedTimestring

购买资源的时长。取值如下:展开详情

示例值:1
ClientTokenstring

幂等性校验。更多信息,请参见如何保证幂等性

示例值:0c593ea1-3bea-11e9-b96b-88**********
InstanceNetworkTypestring

实例网络类型,取值为 VPC展开详情

示例值:VPC参考取值来源:
    DescribeDBInstanceNetInfo
VPCIdstring

VPC ID。展开详情

示例值:vpc-bp19ame5m1r3oejns****
VSwitchIdstring

vSwitch ID。展开详情

示例值:vsw-bp1cpq8mr64paltkb****参考取值来源:
    DescribeRdsVSwitchs
PrivateIpAddressstring

该参数已废弃,无需传入该参数。

示例值:null
SegStorageTypestring

磁盘存储类型,目前仅支持 ESSD 云盘,取值为:cloud_essd展开详情

示例值:cloud_essd
SegDiskPerformanceLevelstring

ESSD 云盘的性能级别,取值如下:展开详情

示例值:pl1枚举值:pl0pl1pl2
InstanceSpecstring

计算节点规格。展开详情

示例值:2C16G
SegNodeNumstring

计算节点个数,取值说明:展开详情

示例值:4
MasterNodeNumstring

该参数已废弃,无需传入该参数。

示例值:null
DBInstanceModestring

实例资源类型,取值说明:展开详情

示例值:StorageElastic参考取值来源:
    DescribeDBInstances
StorageTypestring

该参数已废弃,无需传入该参数。

示例值:null
DBInstanceCategorystring

实例系列。取值说明:展开详情

示例值:HighAvailability
ResourceGroupIdstring

实例所在的企业资源组 ID。

示例值:rg-bp67acfmxazb4p****参考取值来源:
    DescribeDBResourceGroup
StorageSizeinteger<int64>

存储空间大小,单位 GB,取值范围为 50~8000展开详情

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:200
CreateSampleDataboolean

是否在实例创建完成后,加载样本数据集,取值如下:展开详情

示例值:false
Tagarray<object>

第 N 个标签。N 的取值范围:1~20。

子级条数 <= 21
ServerlessResourceinteger<int32>

计算资源阈值。取值范围 8~32,步长为 8,单位为 ACU。默认值为 32。展开详情

示例值:32
IdleTimeinteger<int32>

空闲释放等待时长。即当无业务流量的时长达到指定时长后,实例转为空闲状态。单位为秒,最小值为 60,默认值为 600。展开详情

示例值:600
ServerlessModestring

Serverless 实例的模式,取值如下:展开详情

示例值:Auto
EncryptionTypestring

加密类型,取值说明:展开详情

示例值:CloudDisk
EncryptionKeystring

密钥 ID。展开详情

示例值:0d2470df-da7b-4786-b981-88888888****
VectorConfigurationStatusstring

是否开启向量引擎优化。取值说明:展开详情

示例值:enabled
MasterCUinteger<int32>

Master 资源,取值如下: 展开详情

示例值:8 CU
SrcDbInstanceNamestring

克隆源实例 ID。展开详情

示例值:gp-bp***************
BackupIdstring

备份集 ID。展开详情

示例值:1111111111参考取值来源:
    DescribeBackupJob
EnableSSLboolean

是否开启 SSL 加密。取值说明:展开详情

示例值:false
ProdTypestring

产品类型。取值说明:展开详情

示例值:standard
DeployModestring

部署模式。取值说明:展开详情

示例值:single
StandbyZoneIdstring

备可用区 ID。展开详情

示例值:cn-hangzhou-j
StandbyVSwitchIdstring

备可用区 VSwitch ID。展开详情

示例值:vsw-bp1cpq8mr64paltkb****
MasterAISpecstring

如果您需要将 Master 节点变更为 MasterAI 节点,请指定该参数。展开详情

示例值:ADB.AIMedium.2参考取值来源:
    DescribeDBInstanceAttribute
AINodeSpecInfosarray<object>
子级条数 <= 100

请求说明

DBInstanceClass 参数补充说明

目前,AnalyticDB for PostgreSQL 支持如下两种实例规格:

  • 高性能:规格名称以 gpdb.group.segsdx 开始,特点是可以提供更好的 I/O 能力,带来更高的性能。
  • 高容量:规格名称以 gpdb.group.seghdx 开始,特点是可以提供更大、更实惠的空间,满足更高的存储需求。

因此,在选择实例规格时,建议您根据需要的存储空间和计算能力进行选择。

同时,AnalyticDB for PostgreSQL 支持基于 OSS 的外部表扩展,并可通过 gzip 实现外部存储上的数据压缩,不需要参与实时计算的数据可以存放到外部存储以进一步节省存储成本。

高性能实例的规格信息如下表所示:


【高性能】规格

CPU

内存

存储空间

gpdb.group.segsdx1

1 Core

8 GB

80 GB SSD

gpdb.group.segsdx2

2 Cores

16 GB

160 GB SSD

gpdb.group.segsdx16

16 Cores

128 GB

1.28 TB SSD

高容量型实例的规格信息如下表所示:


【高容量】规格

CPU

内存

存储空间

gpdb.group.seghdx4

4 Cores

32 GB

2 TB HDD

gpdb.group.seghdx36

36 Cores

288 GB

18 TB HDD

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:5414A4E5-4C36-4461-95FC-************
DBInstanceIdstring

实例 ID。

示例值:gp-bp12ga6v69h86****
Portstring

该参数已废弃,故不会返回参数值。展开详情

示例值:3432
ConnectionStringstring

该参数已废弃,故不会返回参数值。展开详情

示例值:gp-bp12ga6v69h86****.gpdb.rds.aliyuncs.com
OrderIdstring

订单编号。

示例值:111111111111

返回示例

变更历史

变更时间变更内容概要操作
2025-02-17
新增请求参数AINodeSpecInfos
2025-02-12
新增请求参数MasterAISpec
2024-10-11
新增请求参数DeployMode
新增请求参数StandbyZoneId
新增请求参数StandbyVSwitchId
2024-05-13
变更请求参数SecurityIPList
2024-01-04
新增请求参数ProdType
2023-12-18
新增请求参数EnableSSL
2023-09-18
变更请求参数DBInstanceMode
  • 1
  • 2
  • 10 条/页

相关示例

创建ADBPG存储预留模式实例
2021-10-14