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

调试

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

请求参数


名称	类型	是否必选	示例值	描述
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	包年或包月实例的购买时长。当`PricingCycle`为`year`时，取值范围为1~3。当`PricingCycle`为`month`时，取值范围为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		结果详情。
DrdsInstanceIdList	List	drds************	实例ID。
OrderId	Long	111111111111111	订单ID。
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授权再进行操作。

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

调试

请求参数

返回数据

示例

错误码

发表回复 取消回复

发表回复取消回复