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

简介: 调用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授权再进行操作。

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

相关文章
|
关系型数据库 中间件 数据库连接
drds读写分离与只读实例
drds读写分离与只读实例
345 3
|
SQL 运维 关系型数据库
PolarDB产品使用合集之PolarDB 2.3.0 版本的 CDC 功能支持 Polardb-X 到 Polardb-X 的数据同步吗
PolarDB产品使用合集涵盖了从创建与管理、数据管理、性能优化与诊断、安全与合规到生态与集成、运维与支持等全方位的功能和服务,旨在帮助企业轻松构建高可用、高性能且易于管理的数据库环境,满足不同业务场景的需求。用户可以通过阿里云控制台、API、SDK等方式便捷地使用这些功能,实现数据库的高效运维与持续优化。
|
关系型数据库 MySQL 分布式数据库
PolarDB API介绍
PolarDB API介绍
301 0
|
监控 关系型数据库 Shell
用shell脚本写一个监控drds实例的脚本
用shell脚本写一个监控drds实例的脚本
182 1
|
JSON 监控 关系型数据库
用python写一个监控drds实例的脚本
用python写一个监控drds实例的脚本
239 1
|
SQL 存储 分布式数据库
实践教程之PolarDB-X分区管理
PolarDB-X 为了方便用户体验,提供了免费的实验环境,您可以在实验环境里体验 PolarDB-X 的安装部署和各种内核特性。除了免费的实验,PolarDB-X 也提供免费的视频课程,手把手教你玩转 PolarDB-X 分布式数据库。本期实验将指导您如何进行PolarDB-X分区管理。
|
SQL Oracle 关系型数据库
Polar DB-O (兼容 Oracle 语法版本)和Polar DB PostgreSQL 版本概述(二)
Polar DB-O (兼容 Oracle 语法版本)和Polar DB PostgreSQL 版本概述(二)
2931 0
|
存储 运维 分布式数据库
《PolarDB-X开源分布式数据库实战进阶》——PolarDB-X分区管理(1)
《PolarDB-X开源分布式数据库实战进阶》——PolarDB-X分区管理(1)
357 0
|
弹性计算 分布式数据库 Docker
《PolarDB-X开源分布式数据库实战进阶》——PolarDB-X分区管理(2)
《PolarDB-X开源分布式数据库实战进阶》——PolarDB-X分区管理(2)
330 0
|
存储 分布式数据库
《PolarDB-X开源分布式数据库实战进阶》——PolarDB-X分区管理(3)
《PolarDB-X开源分布式数据库实战进阶》——PolarDB-X分区管理(3)
247 0

热门文章

最新文章

相关产品

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