创建云原生版的Tair(企业版)实例。
接口说明
选型参考资料,请参见云数据库 Tair(兼容 Redis)选型必读。
请确保在使用该接口前,已充分了解云数据库 Tair(兼容 Redis)产品的收费方式和价格。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
kvstore:CreateTairInstance | create | *DBInstance acs:kvstore:{#regionId}:{#accountId}:instance/* |
| 无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 地域 ID,可调用 DescribeRegions 查询,使用此参数指定要创建实例的地域。 | cn-hangzhou |
InstanceName | string | 否 | 实例名称,需满足下述要求:
| apitest |
Password | string | 否 | 实例密码,需满足下述要求:
| Pass!123456 |
InstanceClass | string | 是 | tair.scm.standard.4m.32d | |
ZoneId | string | 是 | 主可用区 ID,可调用 DescribeRegions 查询,使用此参数指定要创建实例的可用区。 说明
您也可以再传入 SecondaryZoneId 参数指定备可用区,主备节点将分别部署在指定的主可用区和备可用区,实现同城双中心主备架构。例如指定 ZoneId 参数为"cn-hangzhou-h",指定 SecondaryZoneId 参数为"cn-hangzhou-g"。
| cn-hangzhou-h |
SecondaryZoneId | string | 否 | 备可用区 ID,可调用 DescribeRegions 查询。 说明
本参数和 ZoneId 参数传入的值不能相同,且不可传入多可用区对应的 ID。
| cn-hangzhou-g |
ChargeType | string | 否 | 付费类型,取值:
| PrePaid |
VpcId | string | 是 | 专有网络 ID,可调用专有网络 VPC 的 DescribeVpcs 获取。 | vpc-bp1nme44gek34slfc**** |
VSwitchId | string | 是 | 该专有网络下的虚拟交换机 ID,可调用专有网络 VPC 的 DescribeVpcs 获取。 | vsw-bp1e7clcw529l773d**** |
Period | integer | 否 | 付费周期,单位为月,取值:1~9、12、24、36、60 。 说明
当 ChargeType 取值为 PrePaid 时,本参数必须传入。
| 1 |
BusinessInfo | string | 否 | 活动 ID、业务信息。 | 000000000 |
CouponNo | string | 否 | 优惠码。 | youhuiquan_promotion_option_id_for_blank |
SrcDBInstanceId | string | 否 | 如需基于某个实例的备份集创建新实例,请先在此参数中指定源实例 ID。 说明
然后通过 BackupId、ClusterBackupId(云原生集群架构建议使用 ClusterBackupId)或 RestoreTime 参数指定需要使用的备份集或指定时间点,本参数需要与上述 3 个中的任意一个参数组合使用。
| r-bp1zxszhcgatnx**** |
BackupId | string | 否 | 您可在此参数中指定源实例的备份集 ID,系统将使用该备份集中保存的数据创建新实例。通过调用 DescribeBackups 可查询 BackupId。如果源实例是集群实例,则此处需要填写源实例各个分片的备份集 id,并且通过逗号隔开,例如"10**,11**,15**"。 说明
若您的实例是云原生架构实例,并且是集群实例,则建议您使用 DescribeClusterBackupList 查询出集群备份集 id,例如"cb-xx",然后填入 ClusterBackupId 请求参数来达到克隆集群实例的目的,免去您输入各个分片备份集 id 的烦恼。
| 2158****20 |
ClusterBackupId | string | 否 | 部分新集群架构支持集群备份集 ID,您可以通过 DescribeClusterBackupList 接口获取。
| cb-hyxdof5x9kqb**** |
RecoverConfigMode | string | 否 | 使用指定备份集创建实例时,是否从原备份集中恢复账号(account)、内核参数(whitelist)、白名单(config)信息。例如需恢复账号信息,则取值为 默认为空,表示不从原备份集中恢复账号、内核参数、白名单信息。 说明
本参数仅适用于云原生版实例,且需要原备份集中已保存了账号、内核参数、白名单信息。您可以通过 DescribeBackups 接口查询指定备份集中的 RecoverConfigMode 参数是否包含上述信息。
| {"whitelist":true,"config":true,"account":true} |
PrivateIpAddress | string | 否 | 指定实例的内网 IP 地址。 说明
该地址需在实例所属交换机的网段内,您可以调用专有网络 VPC 的 DescribeVSwitches 获取网段信息。
| 172.16.88.*** |
AutoUseCoupon | string | 否 | 是否使用代金券,取值:
| true |
AutoRenew | string | 否 | 是否开启自动续费,取值:
| true |
AutoRenewPeriod | string | 否 | 自动续费周期,单位为月,取值:1、2、3、6、12。 说明
当 AutoRenew 取值为 true 时,本参数必须传入。
| 3 |
ResourceGroupId | string | 否 | 目标资源组 ID。 说明
| rg-acfmyiu4ekp**** |
AutoPay | boolean | 否 | 自动支付,取值固定为 true。 | true |
ClientToken | string | 否 | 用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,大小写敏感、不超过 64 个 ASCII 字符。 | ETnLKlblzczshOTUbOCz**** |
StorageType | string | 否 | 存储类型,取值为essd_pl1、essd_pl2、essd_pl3。 说明
当 InstanceType 取值为tair_essd时,且创建 ESSD 型时,才需要输入本参数。
| essd_pl1 |
Storage | integer | 否 | 磁盘型实例的存储空间,不同的规格取值范围有所区别,详情请参见磁盘型规格。 说明
当 InstanceType 取值为tair_essd时,且创建 ESSD 型时,才需要输入本参数。对于创建 Tair 磁盘 SSD 型实例,容量字段按不同的规格定义为不同的固定值,无需指定该字段。
| 60 |
ShardType | string | 否 | 实例类型,取值:
| MASTER_SLAVE |
ShardCount | integer | 否 | 2 | |
ReadOnlyCount | integer | 否 | 主可用区的只读节点数,本参数仅适用于创建云原生版读写分离架构实例,您可以通过该参数实现自定义只读节点数量,取值:1~9。 说明
但该参数与 SlaveReadOnlyCount 的总和不能大于 9。
| 5 |
SlaveReadOnlyCount | integer | 否 | 用于多可用区读写分离实例创建时,指定备可用区的只读节点数量,该参数与 ReadOnlyCount 的总和不能大于 9。 注意 创建多可用区读写分离实例 SlaveReadOnlyCount 和 SecondaryZoneId 需要同时指定。 | 1 |
EngineVersion | string | 否 | 数据库版本,默认取值:1.0,不同 Tair 产品类型传参规则:
| 1.0 |
InstanceType | string | 是 | 存储介质,取值:
| tair_scm |
GlobalInstanceId | string | 否 | 是否将本次新建的实例作为分布式实例中的子实例,通过该方式可创建分布实例。
说明
若希望作为分布式实例,本次新建的实例需为 Tair 内存型。
| gr-bp14rkqrhac**** |
Tag | array<object> | 否 | 实例的标签信息。 | |
object | 否 | 标签信息。 | ||
Key | string | 否 | 标签的键,与 Tag Value 组成标签的键值对。 说明
单次最多支持传入 5 组标签的键值对。
| key1_test |
Value | string | 否 | 标签的值。 说明
N 表示传入第几个标签的值。例如Tag.1.Value表示传入第一个标签的值;Tag.2.Value表示传入第二个标签的值。
| value1_test |
DryRun | boolean | 否 | 是否对本次创建实例的操作执行预检查,取值:
| false |
Port | integer | 否 | 实例的服务端口,取值范围:1024~65535,默认值为 6379。 | 6379 |
GlobalSecurityGroupIds | string | 否 | 实例的全局 IP 白名单模板,多个 IP 白名单模板请用英文逗号(,)分隔,不可重复。 | g-zsldxfiwjmti0kcm**** |
ParamGroupId | string | 否 | 参数模板 ID,根据新创建的参数模板参数创建实例,不可重复。 | g-50npzjcqb1ua6q6j**** |
RestoreTime | string | 否 | 若源实例已开启数据闪回,您可在此参数中指定源实例备份保留周期内的任意时间点,系统将使用源实例在该时间点的备份数据创建新实例。格式为yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。 | 2021-07-06T07:25:57Z |
返回参数
示例
正常返回示例
JSON
格式
{
"QPS": 100000,
"ConnectionDomain": "r-bp13ac3d047b****.tairpena.rds.aliyuncs.com",
"ChargeType": "PrePaid",
"InstanceId": "r-bp13ac3d047b****",
"Port": 6379,
"Config": "{\\\"EvictionPolicy\\\":\\\"volatile-lru\\\",\\\"hash-max-ziplist-entries\\\":512,\\\"zset-max-ziplist-entries\\\":128,\\\"list-max-ziplist-entries\\\":512,\\\"list-max-ziplist-value\\\":64,\\\"zset-max-ziplist-value\\\":64,\\\"set-max-intset-entries\\\":512,\\\"hash-max-ziplist-value\\\":64}",
"RegionId": "cn-hangzhou",
"RequestId": "12123216-4B00-4378-BE4B-08005BFC****",
"Bandwidth": 96,
"Connections": 10000,
"InstanceName": "redistest",
"ZoneId": "cn-hangzhou-h",
"InstanceStatus": "Creating",
"TaskId": "10****",
"OrderId": 2084452111111
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | MissingParameter | Period is mandatory for this action. | - |
400 | InvalidToken.Malformed | The Specified parameter Token is not valid. | - |
400 | InvalidInstanceName.Malformed | The Specified parameter InstanceName is not valid. | - |
400 | InvalidPassword.Malformed | The Specified parameter Password is not valid. | - |
400 | InsufficientBalance | Your account does not have enough balance. | 账户余额不足,请先充值再操作。 |
400 | QuotaExceed.AfterpayInstance | Living afterpay instances quota exceeded. | 超过了支付实例配额。 |
400 | InvalidCapacity.NotFound | The Capacity provided does not exist in our records. | 所指定的存储规格不存在 |
400 | ResourceNotAvailable | Resource you requested is not available for finance user. | 您所请求的资源对财务用户来说是不可用的。 |
400 | PaymentMethodNotFound | No payment method has been registered on the account. | 帐户上没有登记付款方法。 |
400 | IdempotentParameterMismatch | Request uses a client token in a previous request but is not identical to that request. | 幂等性校验不过 |
400 | QuotaNotEnough | Quota not enough in this zone. | 这个区域的配额是不够的。 |
400 | QuotaExceed | Living afterpay instances quota exceed. | 超过了支付实例配额。 |
400 | VpcServiceError | Invoke vpc service failed. | - |
400 | IzNotSupportVpcError | Specify iz not support vpc. | 指定 iz不支持Vpc。 |
400 | InvalidvSwitchId | The vpc does not cover the vswitch. | - |
400 | InvalidIzNo.NotSupported | The Specified vpc zone not supported. | - |
400 | InvalidAccountPassword.Format | Specified account password is not valid. | - |
400 | InstanceClass.NotMatch | Current instance class and instance type is not match. | - |
400 | InvalidVPCId.NotFound | Specified virtual vpc is not found. | VPC未找到,建议检查VPC ID是否正确。 |
400 | AccountMoneyValidateError | Account money validate error. | - |
400 | RequestTokenConflict | Specified request token conflict. | - |
400 | InvalidIPNotInSubnet | Error ip not in subnet. | - |
400 | InvalidEngineVersion.Malformed | Specified engine version is not valid. | 无效的引擎版本 |
400 | Zone.Closed | The specified zone is closed. | - |
400 | VSwithNotBelongToNotVpcFault | The vSwitch does not belong to current vpc. | - |
400 | PayIllegalAgreement | Pay mayi with holding agreement illegal. | - |
400 | IllegalParamError | validateSaleConditionWithSubArticle failed. | - |
400 | CASH_BOOK_INSUFFICIENT | No payment method is specified for your account. We recommend that you add a payment method or maitain a minimum prepayment balance of INR 1000. | - |
400 | InvalidRegion.Format | Specified Region is not valid. | 指定的地域Region无效 |
403 | RealNameAuthenticationError | Your account has not passed the real-name authentication yet. | 您的帐户还没有通过实名认证。 |
403 | AuthorizationFailure | The request processing has failed due to authorization failure. | - |
403 | TokenServiceError | The specified token is duplicated, please change it. | - |
403 | UserCannotBuyNotInnerCommodity | The user can not buy this commodity without alibaba group tag. | - |
404 | InvalidvSwitchId | The Specified vSwitchId zone not supported. | 指定的vswitch在此可用区不支持 |
404 | InvalidVpcIdOrVswitchId.NotSupported | The Specified vpcId or vSwitchId not supported. | - |
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|---|---|
2024-11-20 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |
2024-10-09 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |
2024-07-30 | OpenAPI 错误码发生变更 | 查看变更详情 |
2024-05-23 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |
2024-04-26 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |
2024-01-29 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |
2024-01-12 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |
2024-01-03 | OpenAPI 错误码发生变更 | 查看变更详情 |
2023-12-22 | OpenAPI 错误码发生变更 | 查看变更详情 |
2023-09-14 | OpenAPI 描述信息更新、OpenAPI 错误码发生变更 | 查看变更详情 |
2023-07-25 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |
2023-06-21 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |
2023-06-21 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |
2023-04-03 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |
2022-11-14 | OpenAPI 错误码发生变更 | 查看变更详情 |
2022-07-27 | OpenAPI 错误码发生变更 | 查看变更详情 |
2022-06-15 | OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更 | 查看变更详情 |