PolarDB-X 1.0-API参考-1.0(2019版本)-实例管理-CreateDrdsInstance

本文涉及的产品
云原生数据库 PolarDB 分布式版,标准版 2核8GB
简介: 调用CreateDrdsInstance接口创建新实例。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

drds-expansion1.png 调试

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateDrdsInstance

系统规定参数,取值为CreateDrdsInstance

ClientToken String c1dd299c-10c6-11ea-bbbb-************

用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符,且该参数值中不能包含非ASCII字符。

ZoneId String cn-hangzhou-e

可用区ID。

PayType String drdsPost

付费类型,取值范围如下:

  • drdsPre:包年包月(也称预付费)。
  • drdsPost:按量付费(也称后付费)。
  • drdsRo:创建只读实例时,默认按量付费模式。
Quantity Integer 1

创建实例的数量,仅支持传入1,即一次只能创建一个实例。

RegionId String cn-hangzhou

地域ID。

Specification String drds.sn1.4c16g.8C32G

实例规格码,取值由实例系列加具体实例规格组成,例如drds.sn1.4c8g.8C16G

关于实例规格详情,请参见实例规格

Type String PRIVATE

实例类型,仅支持PRIVATE,即专享实例。

说明 您也可以传入1表示专享实例。

Description String test

实例描述,需满足如下要求:

  • 不能以http://https://开头。
  • 必须以字母或中文开头,可包含大小写字母、中文、数字、下划线(_)或短划线(-)。
  • 长度为2~256个字符。
InstanceSeries String drds.sn1.4c16g

实例系列参数,取值范围如下:

  • drds.sn2.4c16g:入门版
  • drds.sn2.8c32g:标准版
  • drds.sn2.16c64g:企业版
VpcId String vpc-**********

专有网络ID。

VswitchId String vsw-**********

虚拟交换机ID。

isHa Boolean true

是否为高可用实例。

PricingCycle String month

指定预付费实例为包年或包月类型,取值范围如下:

  • year:年
  • month:月

说明 若付费类型为drdsPre,该参数为必传参数。

Duration Integer 1

包年或包月实例的购买时长。

  • PricingCycleyear时,取值范围为1~3。
  • PricingCyclemonth时,取值范围为1~9。

说明 仅当付费类型是drdsPre时该参数生效。

IsAutoRenew Boolean true

是否自动续费,取值范围如下:

  • true:如果按月购买则自动续费一个月,如果按年购买则自动续费一年。
  • false:不自动续费。

说明 仅当付费类型为drdsPre时该参数生效。

MasterInstId String drds***********

主实例ID,仅在创建只读实例时填写。

MySQLVersion Integer 5

实例支持的MySQL版本,取值范围如下:

  • 5:与MySQL 5.x完全兼容(默认)
  • 8:与MySQL 8.0完全兼容

说明 仅当创建主实例时该参数生效,只读实例的MySQL版本默认与主实例相同。

ResourceGroupId String rg-************

资源组ID。

返回数据

名称 类型 示例值 描述
Data Struct

结果详情。

RequestId String D99D4644-A70D-49A3-B8B4-767ACC50****

请求ID。

Success Boolean true

请求结果。

示例

请求示例


http(s)://drds.aliyuncs.com/?Action=CreateDrdsInstance
&ClientToken=c1dd299c-10c6-11ea-bbbb-************
&ZoneId=cn-hangzhou-e
&PayType=drdsPost
&Quantity=1
&RegionId=cn-hangzhou
&Specification=drds.sn1.4c16g.8C32G
&Type=PRIVATE
&Description=test
&<公共请求参数>

正常返回示例

XML 格式


<CreateDrdsInstanceResponse>
  <Data>
        <OrderId>111111111111111</OrderId>
        <DrdsInstanceIdList>
              <drdsInstanceIdList>drds************</drdsInstanceIdList>
        </DrdsInstanceIdList>
  </Data>
  <RequestId>D99D4644-A70D-49A3-B8B4-767ACC50****</RequestId>
  <Success>true</Success>
</CreateDrdsInstanceResponse>

JSON 格式


{
  "Data": {
    "OrderId": "111111111111111",
    "DrdsInstanceIdList": {
      "drdsInstanceIdList": [
        "drds************"
      ]
    }
  },
  "RequestId": "D99D4644-A70D-49A3-B8B4-767ACC50****",
  "Success": true
}

错误码

HttpCode 错误码 错误信息 描述
400 ActionUnauthorized The specified action is not available for you 指定的action未授权,请您先做RAM授权再进行操作。

访问错误中心查看更多错误码。

相关实践学习
Polardb-x 弹性伸缩实验
本实验主要介绍如何对PolarDB-X进行手动收缩扩容,了解PolarDB-X 中各个节点的含义,以及如何对不同配置的PolarDB-x 进行压测。
相关文章
|
5月前
|
Java API Maven
淘东电商项目(05) - Swagger及网关统一管理API
淘东电商项目(05) - Swagger及网关统一管理API
72 0
|
4月前
|
安全 大数据 API
elasticsearch|大数据|elasticsearch的api部分实战操作以及用户和密码的管理
elasticsearch|大数据|elasticsearch的api部分实战操作以及用户和密码的管理
63 0
|
5月前
|
Java API Maven
微服务技术系列教程(27) - SpringCloud- Zuul整合Swagger管理微服务所有API
微服务技术系列教程(27) - SpringCloud- Zuul整合Swagger管理微服务所有API
56 0
|
1月前
|
监控 供应链 测试技术
如何利用API接口进行高效的商品变体管理?
要利用API接口进行高效的商品变体管理,您需要执行一系列策略和技术步骤来确保数据的准确性和实时性。以下是详细的指南:
|
6月前
|
JSON 数据可视化 安全
Swagger 管理 API 的一些经验分享
Swagger 管理 API 的一些经验分享
113 0
|
2月前
|
关系型数据库 中间件 数据库连接
drds读写分离与只读实例
drds读写分离与只读实例
30 3
|
3月前
|
运维 监控 前端开发
功能强大的国产API管理神器 Eolink,亲测好用
功能强大的国产API管理神器 Eolink,亲测好用
26 0
功能强大的国产API管理神器 Eolink,亲测好用
|
4月前
|
消息中间件 Kafka API
kafka topic 管理api
kafka topic 管理api
38 0
|
4月前
|
算法 关系型数据库 API
Python【算法中心 02】Web框架Django管理页面使用(管理员账号创建+API使用+应用添加)GreenPlum数据库引擎及API测试
Python【算法中心 02】Web框架Django管理页面使用(管理员账号创建+API使用+应用添加)GreenPlum数据库引擎及API测试
42 0
|
5月前
|
API
Vue3.0实现todolist-使用状态管理的api
Vue3.0实现todolist-使用状态管理的api
22 1

热门文章

最新文章

相关产品

  • 云原生分布式数据库 PolarDB-X