CreateTairInstance - 创建Tair(企业版)实例

创建云原生版的Tair(企业版)实例。

接口说明

选型参考资料,请参见云数据库 Tair(兼容 Redis)选型必读

请确保在使用该接口前,已充分了解云数据库 Tair(兼容 Redis)产品的收费方式和价格

说明
  • 关于控制台的操作方法,请参见创建 Tair 实例
  • 如需创建其他类型的实例,例如开源版或 Tair 内存型经典版实例,您可以调用 CreateInstance 接口。
  • 调试

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

    授权信息

    下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

    • 操作:是指具体的权限点。
    • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
    • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
      • 对于必选的资源类型,用背景高亮的方式表示。
      • 对于不支持资源级授权的操作,用全部资源表示。
    • 条件关键字:是指云产品自身定义的条件关键字。
    • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
    操作访问级别资源类型条件关键字关联操作
    kvstore:CreateTairInstancecreate
    *DBInstance
    acs:kvstore:{#regionId}:{#accountId}:instance/*
    • kvstore:InstanceClass
    • kvstore:InstanceType

    请求参数

    名称类型必填描述示例值
    RegionIdstring

    地域 ID,可调用 DescribeRegions 查询,使用此参数指定要创建实例的地域。

    cn-hangzhou
    InstanceNamestring

    实例名称,需满足下述要求:

    • 长度为 2~80 个字符。
    • 以大小写英文字母或中文开头,不支持空格和特殊字符:@/:=”<>{[]}
    apitest
    Passwordstring

    实例密码,需满足下述要求:

    • 长度为 8~32 位。
    • 需包含大写字母、小写字母、特殊字符和数字中的至少三种,支持的特殊字符为!@#$%^&*()_+-=
    Pass!123456
    InstanceClassstring

    实例规格,更多信息,请参见:

    tair.scm.standard.4m.32d
    ZoneIdstring

    主可用区 ID,可调用 DescribeRegions 查询,使用此参数指定要创建实例的可用区。

    说明 您也可以再传入 SecondaryZoneId 参数指定备可用区,主备节点将分别部署在指定的主可用区和备可用区,实现同城双中心主备架构。例如指定 ZoneId 参数为"cn-hangzhou-h",指定 SecondaryZoneId 参数为"cn-hangzhou-g"。
    cn-hangzhou-h
    SecondaryZoneIdstring

    备可用区 ID,可调用 DescribeRegions 查询。

    说明 本参数和 ZoneId 参数传入的值不能相同,且不可传入多可用区对应的 ID。
    cn-hangzhou-g
    ChargeTypestring

    付费类型,取值:

    • PrePaid(默认):预付费,即包年包月。
    • PostPaid:按量付费。
    PrePaid
    VpcIdstring

    专有网络 ID,可调用专有网络 VPC 的 DescribeVpcs 获取。

    vpc-bp1nme44gek34slfc****
    VSwitchIdstring

    该专有网络下的虚拟交换机 ID,可调用专有网络 VPC 的 DescribeVpcs 获取。

    vsw-bp1e7clcw529l773d****
    Periodinteger

    付费周期,单位为月,取值:1~912243660

    说明 ChargeType 取值为 PrePaid 时,本参数必须传入。
    1
    BusinessInfostring

    活动 ID、业务信息。

    000000000
    CouponNostring

    优惠码。

    youhuiquan_promotion_option_id_for_blank
    SrcDBInstanceIdstring

    如需基于某个实例的备份集创建新实例,请先在此参数中指定源实例 ID。

    说明 然后通过 BackupIdClusterBackupId(云原生集群架构建议使用 ClusterBackupId)或 RestoreTime 参数指定需要使用的备份集或指定时间点,本参数需要与上述 3 个中的任意一个参数组合使用。
    r-bp1zxszhcgatnx****
    BackupIdstring

    您可在此参数中指定源实例的备份集 ID,系统将使用该备份集中保存的数据创建新实例。通过调用 DescribeBackups 可查询 BackupId。如果源实例是集群实例,则此处需要填写源实例各个分片的备份集 id,并且通过逗号隔开,例如"10**,11**,15**"。

    说明 若您的实例是云原生架构实例,并且是集群实例,则建议您使用 DescribeClusterBackupList 查询出集群备份集 id,例如"cb-xx",然后填入 ClusterBackupId 请求参数来达到克隆集群实例的目的,免去您输入各个分片备份集 id 的烦恼。
    2158****20
    ClusterBackupIdstring

    部分新集群架构支持集群备份集 ID,您可以通过 DescribeClusterBackupList 接口获取。

    • 若支持,可输入指定的集群备份集 ID 即可,无需再填写 BackupId 参数。
    • 若不支持,请在 BackupId 参数中填写为原实例各个分片下的备份集 ID,通过逗号隔开,例如"2158****20,2158****22"等。
    cb-hyxdof5x9kqb****
    RecoverConfigModestring

    使用指定备份集创建实例时,是否从原备份集中恢复账号(account)、内核参数(whitelist)、白名单(config)信息。例如需恢复账号信息,则取值为{“account":true}

    默认为空,表示不从原备份集中恢复账号、内核参数、白名单信息。

    说明 本参数仅适用于云原生版实例,且需要原备份集中已保存了账号、内核参数、白名单信息。您可以通过 DescribeBackups 接口查询指定备份集中的 RecoverConfigMode 参数是否包含上述信息。
    {"whitelist":true,"config":true,"account":true}
    PrivateIpAddressstring

    指定实例的内网 IP 地址。

    说明 该地址需在实例所属交换机的网段内,您可以调用专有网络 VPC 的 DescribeVSwitches 获取网段信息。
    172.16.88.***
    AutoUseCouponstring

    是否使用代金券,取值:

    • true:使用代金券。
    • false(默认):不使用代金券。
    true
    AutoRenewstring

    是否开启自动续费,取值:

    • true:开启。
    • false(默认):不开启。
    true
    AutoRenewPeriodstring

    自动续费周期,单位为月,取值:123612

    说明 AutoRenew 取值为 true 时,本参数必须传入。
    3
    ResourceGroupIdstring

    目标资源组 ID。

    说明
  • 您可以通过调用 ListResourceGroups 接口或通过控制台获取资源组 ID 列表。相关操作,请参见查看资源组基本信息
  • 修改实例所属的资源组之前,您可以调用 ListResources 接口查看实例现在所属的资源组。
  • rg-acfmyiu4ekp****
    AutoPayboolean

    自动支付,取值固定为 true

    true
    ClientTokenstring

    用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,大小写敏感、不超过 64 个 ASCII 字符。

    ETnLKlblzczshOTUbOCz****
    StorageTypestring

    存储类型,取值为essd_pl1essd_pl2essd_pl3

    说明 InstanceType 取值为tair_essd时,且创建 ESSD 型时,才需要输入本参数。
    essd_pl1
    Storageinteger

    磁盘型实例的存储空间,不同的规格取值范围有所区别,详情请参见磁盘型规格

    说明 InstanceType 取值为tair_essd时,且创建 ESSD 型时,才需要输入本参数。对于创建 Tair 磁盘 SSD 型实例,容量字段按不同的规格定义为不同的固定值,无需指定该字段。
    60
    ShardTypestring

    实例类型,取值:

    • MASTER_SLAVE(默认):高可用,采用主从架构,可保障可用性。
    • STAND_ALONE:单副本,采用单节点架构。在节点故障后,数据会丢失,系统会自动拉起新的空实例。仅在单可用区时支持,且不支持创建集群与读写分离架构。
    MASTER_SLAVE
    ShardCountinteger

    实例中的数据节点个数,取值:

    • 1:默认值,即表示创建的实例为标准架构,仅拥有 1 个数据节点。
    • 2~32:传入该范围的值,即表示创建的实例为集群架构,拥有指定数量的数据节点。
    说明 InstanceType 取值为tair_rdbtair_scm时,本参数才可以传入 2~32,即只有内存型和持久内存型支持集群架构。
    2
    ReadOnlyCountinteger

    主可用区的只读节点数,本参数仅适用于创建云原生版读写分离架构实例,您可以通过该参数实现自定义只读节点数量,取值:1~9。

    说明 但该参数与 SlaveReadOnlyCount 的总和不能大于 9。
    5
    SlaveReadOnlyCountinteger

    用于多可用区读写分离实例创建时,指定备可用区的只读节点数量,该参数与 ReadOnlyCount 的总和不能大于 9。

    注意 创建多可用区读写分离实例 SlaveReadOnlyCount 和 SecondaryZoneId 需要同时指定。

    1
    EngineVersionstring

    数据库版本,默认取值:1.0,不同 Tair 产品类型传参规则:

    • Tair_rdb: Tair 内存型兼容 Redis 5.0、Redis 6.0 和 Redis 7.0 协议,传5.06.07.0
    • Tair_scm: Tair 持久内存兼容 Redis 6.0 协议,传1.0
    • Tair_essd: Tair 磁盘(ESSD/SSD)兼容 Redis 6.0 协议。 创建 ESSD 型请传入1.0、创建 SSD 型请传入2.0
    1.0
    InstanceTypestring

    存储介质,取值:

    • tair_rdb:内存型。
    • tair_scm:持久内存型。
    • tair_essd:磁盘型。
    tair_scm
    GlobalInstanceIdstring

    是否将本次新建的实例作为分布式实例中的子实例,通过该方式可创建分布实例。

    • 若希望新建的实例作为第一个子实例,请输入 true
    • 若希望新建的实例作为第二、三个子实例,请输入分布式实例 ID,例如 gr-bp14rkqrhac****。
    • 不作为分布式实例,您无需输入任何值。
    说明 若希望作为分布式实例,本次新建的实例需为 Tair 内存型。
    gr-bp14rkqrhac****
    Tagarray<object>

    实例的标签信息。

    object

    标签信息。

    Keystring

    标签的键,与 Tag Value 组成标签的键值对。

    说明 单次最多支持传入 5 组标签的键值对。
    key1_test
    Valuestring

    标签的值。

    说明 N 表示传入第几个标签的值。例如Tag.1.Value表示传入第一个标签的值;Tag.2.Value表示传入第二个标签的值。
    value1_test
    DryRunboolean

    是否对本次创建实例的操作执行预检查,取值:

    • true:执行预检查操作,不创建实例。检查项目包含请求参数、请求格式、业务限制和库存。如果检查不通过,则返回对应错误。如果检查通过,则返回错误码DryRunOperation
    • false(默认):发送正常请求,通过检查后直接创建实例。
    false
    Portinteger

    实例的服务端口,取值范围:1024~65535,默认值为 6379。

    6379
    GlobalSecurityGroupIdsstring

    实例的全局 IP 白名单模板,多个 IP 白名单模板请用英文逗号(,)分隔,不可重复。

    g-zsldxfiwjmti0kcm****
    ParamGroupIdstring

    参数模板 ID,根据新创建的参数模板参数创建实例,不可重复。

    g-50npzjcqb1ua6q6j****
    RestoreTimestring

    若源实例已开启数据闪回,您可在此参数中指定源实例备份保留周期内的任意时间点,系统将使用源实例在该时间点的备份数据创建新实例。格式为yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。

    2021-07-06T07:25:57Z

    返回参数

    名称类型描述示例值
    object

    对象。

    QPSlong

    每秒处理的最大读写操作数,单位为次/秒,此处为当前实例规格的理论值。

    100000
    ConnectionDomainstring

    实例的内网连接地址。

    r-bp13ac3d047b****.tairpena.rds.aliyuncs.com
    ChargeTypestring

    实例的付费类型,返回值:

    • PrePaid:预付费。
    • PostPaid:按量付费。
    PrePaid
    InstanceIdstring

    实例 ID。

    r-bp13ac3d047b****
    Portinteger

    实例的端口号。

    6379
    Configstring

    实例的详细配置,格式为 JSON 字符串。关于各参数的详细解释,请参见参数配置说明

    {\"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}
    RegionIdstring

    地域 ID。

    cn-hangzhou
    RequestIdstring

    请求 ID。

    12123216-4B00-4378-BE4B-08005BFC****
    Bandwidthlong

    实例的最大带宽,单位:MB/s。

    96
    Connectionslong

    实例的最大连接数。

    10000
    InstanceNamestring

    实例名称。

    说明 当传入了请求参数 InstanceName 时,本参数才会返回。
    redistest
    ZoneIdstring

    可用区 ID。

    cn-hangzhou-h
    InstanceStatusstring

    实例当前的状态,返回值固定为 Creating(创建中)。

    Creating
    TaskIdstring

    任务 ID。

    10****
    OrderIdlong

    订单 ID。

    2084452111111

    示例

    正常返回示例

    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错误码错误信息描述
    400MissingParameterPeriod is mandatory for this action.-
    400InvalidToken.MalformedThe Specified parameter Token is not valid.-
    400InvalidInstanceName.MalformedThe Specified parameter InstanceName is not valid.-
    400InvalidPassword.MalformedThe Specified parameter Password is not valid.-
    400InsufficientBalanceYour account does not have enough balance.账户余额不足,请先充值再操作。
    400QuotaExceed.AfterpayInstanceLiving afterpay instances quota exceeded.超过了支付实例配额。
    400InvalidCapacity.NotFoundThe Capacity provided does not exist in our records.所指定的存储规格不存在
    400ResourceNotAvailableResource you requested is not available for finance user.您所请求的资源对财务用户来说是不可用的。
    400PaymentMethodNotFoundNo payment method has been registered on the account.帐户上没有登记付款方法。
    400IdempotentParameterMismatchRequest uses a client token in a previous request but is not identical to that request.幂等性校验不过
    400QuotaNotEnoughQuota not enough in this zone.这个区域的配额是不够的。
    400QuotaExceedLiving afterpay instances quota exceed.超过了支付实例配额。
    400VpcServiceErrorInvoke vpc service failed.-
    400IzNotSupportVpcErrorSpecify iz not support vpc.指定 iz不支持Vpc。
    400InvalidvSwitchIdThe vpc does not cover the vswitch.-
    400InvalidIzNo.NotSupportedThe Specified vpc zone not supported.-
    400InvalidAccountPassword.FormatSpecified account password is not valid.-
    400InstanceClass.NotMatchCurrent instance class and instance type is not match.-
    400InvalidVPCId.NotFoundSpecified virtual vpc is not found.VPC未找到,建议检查VPC ID是否正确。
    400AccountMoneyValidateErrorAccount money validate error.-
    400RequestTokenConflictSpecified request token conflict.-
    400InvalidIPNotInSubnetError ip not in subnet.-
    400InvalidEngineVersion.MalformedSpecified engine version is not valid.无效的引擎版本
    400Zone.ClosedThe specified zone is closed.-
    400VSwithNotBelongToNotVpcFaultThe vSwitch does not belong to current vpc.-
    400PayIllegalAgreementPay mayi with holding agreement illegal.-
    400IllegalParamErrorvalidateSaleConditionWithSubArticle failed.-
    400CASH_BOOK_INSUFFICIENTNo payment method is specified for your account. We recommend that you add a payment method or maitain a minimum prepayment balance of INR 1000.-
    400InvalidRegion.FormatSpecified Region is not valid.指定的地域Region无效
    403RealNameAuthenticationErrorYour account has not passed the real-name authentication yet.您的帐户还没有通过实名认证。
    403AuthorizationFailureThe request processing has failed due to authorization failure.-
    403TokenServiceErrorThe specified token is duplicated, please change it.-
    403UserCannotBuyNotInnerCommodityThe user can not buy this commodity without alibaba group tag.-
    404InvalidvSwitchIdThe Specified vSwitchId zone not supported.指定的vswitch在此可用区不支持
    404InvalidVpcIdOrVswitchId.NotSupportedThe Specified vpcId or vSwitchId not supported.-

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

    变更历史

    变更时间变更内容概要操作
    2024-11-20OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情
    2024-10-09OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情
    2024-07-30OpenAPI 错误码发生变更查看变更详情
    2024-05-23OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情
    2024-04-26OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情
    2024-01-29OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情
    2024-01-12OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情
    2024-01-03OpenAPI 错误码发生变更查看变更详情
    2023-12-22OpenAPI 错误码发生变更查看变更详情
    2023-09-14OpenAPI 描述信息更新、OpenAPI 错误码发生变更查看变更详情
    2023-07-25OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情
    2023-06-21OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情
    2023-06-21OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情
    2023-04-03OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情
    2022-11-14OpenAPI 错误码发生变更查看变更详情
    2022-07-27OpenAPI 错误码发生变更查看变更详情
    2022-06-15OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更查看变更详情