首页 云原生内存数据库Tair API参考 API目录 生命周期管理 CreateInstance - 创建一个Redis实例

CreateInstance - 创建一个Redis实例

创建一个Redis实例。

接口说明

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

本接口可创建Redis本地盘版、Redis云盘版、Tair内存型本地盘版实例,如需创建Tair云盘版实例,请调用CreateTairInstance接口。

说明该API对应的控制台操作方法和选型建议,请参见创建Redis实例

调试

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

调试

授权信息

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

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

请求参数

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

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

cn-hangzhou
Tokenstring

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

ETnLKlblzczshOTUbOCz****
InstanceNamestring

实例名称。 名称为2~80个字符,以大小写字母或中文开头,不支持字符@/:=”<>{[]}和空格。

apitest
Passwordstring

实例密码。 长度为8-32位,需包含大写字母、小写字母、特殊字符和数字中的至少三种,允许的特殊字符包括!@#$%^&*()_+-=

Pass!123456
Capacitylong

实例的存储容量,单位为MB。

说明调用此接口需至少传递CapacityInstanceClass中的一个参数。
16384
InstanceClassstring

实例的规格,例如redis.master.small.default为社区版(本地盘)标准版双副本1GB主从版实例,详细信息请参见规格查询导航

说明调用此接口需至少传递CapacityInstanceClass中的一个参数。
redis.master.small.default
ZoneIdstring

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

cn-hangzhou-e
ChargeTypestring

付费类型,取值:

  • PrePaid:预付费。
  • PostPaid:按量付费。
说明默认为PostPaid
PostPaid
NetworkTypestring

网络类型,取值:

  • VPC:专有网络,默认值。
VPC
VpcIdstring

VPC网络的ID。

vpc-bp1nme44gek34slfc****
VSwitchIdstring

虚拟交换机的ID。

vsw-bp1e7clcw529l773d****
Periodstring

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

说明ChargeType取值为PrePaid时,本参数才可用且必须传入。
12
BusinessInfostring

活动ID、业务信息。

000000000
CouponNostring

优惠码,默认值为:youhuiquan_promotion_option_id_for_blank

youhuiquan_promotion_option_id_for_blank
SrcDBInstanceIdstring

如需基于某个实例的备份数据创建新实例,请先在此参数中指定源实例的ID,然后通过BackupId或者RestoreTime参数指定需要使用的备份数据。

r-bp1zxszhcgatnx****
BackupIdstring

如需基于某个实例的备份数据创建新实例,在通过SrcDBInstanceId指定源实例后,您可在此参数中指定源实例的备份集ID,系统将使用该备份集中保存的数据创建新实例。通过调用DescribeBackups可查询BackupId。

说明设置SrcDBInstanceId后,您需要在BackupIdRestoreTime参数中选择其一来指定备份数据。
111111111
InstanceTypestring

实例类型,取值:

  • Redis
  • Memcache
说明默认为Redis
Redis
EngineVersionstring

版本号,取值:4.05.06.07.0

说明默认值为5.0
4.0
PrivateIpAddressstring

指定新实例的内网IP地址。

说明内网IP需在实例所属的交换机网段内。
172.16.0.***
AutoUseCouponstring

是否使用代金券,取值:

  • true:使用代金券。
  • false:不使用代金券。
说明默认值:false
false
AutoRenewstring

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

  • true:开启。
  • false:不开启。
说明默认值:false
true
AutoRenewPeriodstring

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

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

资源组ID。

rg-resourcegroupid1
RestoreTimestring

如需基于某个实例的备份数据创建新实例,在通过SrcDBInstanceId指定源实例后,您可在此参数中指定源实例备份保留周期内的任意时间点,系统将使用源实例在该时间点的备份数据创建新实例。格式为yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

说明设置SrcDBInstanceId后,您需要在BackupIdRestoreTime参数中选择其一来指定备份数据。
2019-06-19T16:00:00Z
DedicatedHostGroupIdstring

专属集群ID,在专属集群内创建Redis实例时需传入本参数。

dhg-uv4fnk6r7zff****
ShardCountinteger

分片数,本参数仅适用于创建云盘版集群架构实例,您可以通过该参数实现自定义分片数量。

4
ReadOnlyCountinteger

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

5
GlobalInstanceIdstring

分布式实例ID,本参数仅适用于中国站。

如需将新创建的Redis实例追加为分布式实例中的新子实例,本参数才可用且必须传入。相关说明与控制台操作,请参见为分布式实例添加子实例

gr-bp14rkqrhac****
GlobalInstanceboolean

是否将本次新建的实例作为分布式实例中的第一个子实例,通过该方式可创建分布实例,取值:

  • true:作为第一个子实例。
  • false:不作为第一个子实例,默认值。
说明
  • 如需传入true,本次新建的实例需为Tair内存型,引擎版本为5.0。
  • 本参数仅适用于中国站。
  • false
    SecondaryZoneIdstring

    备可用区ID,可调用DescribeZones接口查询。

    说明传入本参数可以实现主备数据节点分布在不同的可用区,实现跨可用区容灾,可承受机房级别的故障。
    cn-hangzhou-h
    Portstring

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

    6379
    DryRunboolean

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

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

    实例的标签信息。

    object

    对象。

    Keystring

    标签的键。

    说明
  • N表示传入第几个标签的键,单个实例最多可绑定20个标签。例如Tag.1.Key表示传入第一个标签的键;Tag.2.Key表示传入第二个标签的键。
  • 如果标签的键不存在,则自动创建。
  • testkey
    Valuestring

    标签的值。

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

    返回参数

    名称类型描述示例值
    object

    对象。

    VpcIdstring

    专有网络(VPC)的ID。

    vpc-bp1nme44gek34slfc****
    QPSlong

    每秒访问次数,此处为当前规格实例的理论值。

    100000
    Capacitylong

    实例的存储容量,单位:MB。

    16384
    ConnectionDomainstring

    Redis实例的内网连接地址。

    r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com
    ChargeTypestring

    付费类型,返回值:

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

    网络类型,返回值:

    • CLASSIC:经典网络。
    • VPC:专有网络。
    VPC
    InstanceIdstring

    实例ID(全局唯一)。

    r-bp1zxszhcgatnx****
    Portinteger

    Redis服务端口。

    6379
    Configstring

    实例的详细配置。

    {\"EvictionPolicy\":\"volatile-lru\",\"hash-max-ziplist-entries\":512,\"zset-max-ziplist-entries\":128,\"zset-max-ziplist-value\":64,\"set-max-intset-entries\":512,\"hash-max-ziplist-value\":64}
    RegionIdstring

    实例所在地域。

    cn-hongkong
    EndTimestring

    预付费实例到期时间,格式为yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

    2019-01-18T16:00:00Z
    VSwitchIdstring

    虚拟交换机ID。

    vsw-bp1e7clcw529l773d****
    RequestIdstring

    请求ID。

    5DEA3CC9-F81D-4387-8E97-CEA40F09****
    NodeTypestring

    节点类型,返回值:

    • STAND_ALONE:单副本。
    • MASTER_SLAVE:双副本。
    MASTER_SLAVE
    Connectionslong

    实例连接数限制。

    10000
    Bandwidthlong

    实例带宽限制,单位:MB/s。

    32
    InstanceNamestring

    实例名称。

    apitest
    ZoneIdstring

    实例所属的可用区的ID。

    cn-hangzhou-b
    InstanceStatusstring

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

    Creating
    PrivateIpAddrstring

    实例的内网IP地址。

    172.16.0.10
    UserNamestring

    连接Redis的账号,默认包含一个以实例ID命名的账号。

    r-bp1zxszhcgatnx****
    OrderIdlong

    订单id。

    2084452111111

    示例

    正常返回示例

    JSON格式

    {
      "VpcId": "vpc-bp1nme44gek34slfc****",
      "QPS": 100000,
      "Capacity": 16384,
      "ConnectionDomain": "r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com",
      "ChargeType": "PostPaid",
      "NetworkType": "VPC",
      "InstanceId": "r-bp1zxszhcgatnx****",
      "Port": 6379,
      "Config": "{\\\"EvictionPolicy\\\":\\\"volatile-lru\\\",\\\"hash-max-ziplist-entries\\\":512,\\\"zset-max-ziplist-entries\\\":128,\\\"zset-max-ziplist-value\\\":64,\\\"set-max-intset-entries\\\":512,\\\"hash-max-ziplist-value\\\":64}",
      "RegionId": "cn-hongkong",
      "EndTime": "2019-01-18T16:00:00Z",
      "VSwitchId": "vsw-bp1e7clcw529l773d****",
      "RequestId": "5DEA3CC9-F81D-4387-8E97-CEA40F09****",
      "NodeType": "MASTER_SLAVE",
      "Connections": 10000,
      "Bandwidth": 32,
      "InstanceName": "apitest",
      "ZoneId": "cn-hangzhou-b",
      "InstanceStatus": "Creating",
      "PrivateIpAddr": "172.16.0.10",
      "UserName": "r-bp1zxszhcgatnx****",
      "OrderId": 2084452111111
    }

    错误码

    Http code错误码错误信息描述
    400ZoneIdNotFoundSpecify iz not support switch network.-
    400InvalidShardInfo.FormatShard total number is out of range.-
    400InvalidInstancelevelSpecified Instance level dose not match gdc other member instance level.-
    400InvalidBackupLogStatusBackup logs are not enabled for the specified source instance.-
    400InvalidStatusSpecified instance status is Modifying.-
    400SecurityRisk.AuthVerificationwe have detected a risk with your default payment method. An email and notification has been sent to you. Please re-submit your order before after verificaiton.-
    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.Capacity 容量非法。
    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.-
    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.-
    400DryRunOperationRequest validation has been passed with DryRun flag set.-
    400ResourceGroupNotExistThe Specified ResourceGroupId does not exist.-
    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.-
    404InvalidvSwitchIdThe Specified vSwitchId zone not supported.-
    404InvalidVpcIdOrVswitchId.NotSupportedThe Specified vpcId or vSwitchId not supported.-

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

    变更历史

    变更时间变更内容概要操作
    2022-06-15
    变更返回参数
    2022-03-01
    变更请求参数EngineVersion
    变更请求参数AutoRenew
    2022-03-01
    新增请求参数ShardCount
    2022-02-22
    变更错误码400
    阿里云首页 云原生内存数据库Tair 相关技术圈