华为云FLEXUS云服务_FLEXUS云数据库RDS-创建数据库实例:响应消息

时间:2024-08-07 10:52:05

响应消息

  • 正常响应要素说明
    表9 要素说明

    名称

    参数类型

    说明

    instance

    Object

    参数解释:

    实例信息。详情请参见表10

    order_id

    String

    参数解释:

    订单号。

    取值范围:

    不涉及。

    表10 instance说明

    名称

    参数类型

    说明

    id

    String

    参数解释:

    实例ID。

    取值范围:

    不涉及。

    name

    String

    参数解释:

    实例名称。用于表示实例的名称,同一租户下,同类型的实例名称可相同。

    取值范围:

    与请求参数值相同。

    status

    String

    参数解释:

    实例状态。

    取值范围:

    BUILD,表示创建中。

    datastore

    Object

    参数解释:

    数据库信息。详情请参见表11

    ha

    Object

    参数解释:

    HA配置参数,仅当您选择创建HA实例时该参数才可见。

    详情请参见表12

    port

    String

    参数解释:

    数据库端口信息。

    取值范围:

    与请求参数值相同。

    backup_strategy

    Object

    参数解释:

    自动备份策略。详情请参见表13

    flavor_ref

    String

    参数解释:

    规格码。

    取值范围:

    与请求参数值相同。

    volume

    Object

    参数解释:

    volume信息。详情请参见表14

    region

    String

    参数解释:

    区域ID。

    取值范围:

    与请求参数值相同。

    availability_zone

    String

    参数解释:

    可用区ID。

    取值范围:

    与请求参数值相同。

    vpc_id

    String

    参数解释:

    虚拟私有云ID。

    取值范围:

    vpc-default-smb

    subnet_id

    String

    参数解释:

    子网的网络ID信息。

    取值范围:

    subnet-default-smb

    security_group_id

    String

    参数解释:

    指定实例所属的安全组。

    取值范围:

    sg-default-smb

    charge_info

    Object

    参数解释:

    计费方式信息。详情请参见表15

    表11 datastore字段数据结构说明

    名称

    参数类型

    说明

    type

    String

    参数解释:

    数据库引擎。

    取值范围:

    MySQL

    version

    String

    参数解释:

    数据库版本。

    取值范围:

    5.7、8.0

    表12 ha字段数据结构说明

    名称

    参数类型

    说明

    mode

    String

    参数解释:

    实例主备模式。

    取值范围:

    HA,不区分大小写。

    replication_mode

    String

    参数解释:

    备机同步参数。

    取值范围:

    • async:异步模式。
    • semisync:半同步模式。
    表13 backupStrategy字段数据结构说明

    名称

    参数类型

    说明

    start_time

    String

    参数解释:

    备份时间段。自动备份将在该时间段内触发。

    取值范围:

    非空,格式必须为hh:mm-HH:MM且有效,当前时间指UTC时间。

    • HH取值必须比hh大1。
    • mm和MM取值必须相同,且取值必须为00、15、30或45。

    示例:

    • 08:15-09:15
    • 23:00-00:00

    如果请求体中“backup_strategy”为空,则响应体中 “start_time”默认返回“02:00-03:00”

    keep_days

    Integer

    参数解释:

    指定备份文件的可保存天数。

    取值范围:

    0~732。取值为0,表示关闭自动备份策略。如果需要延长保留时间请联系客服人员申请,自动备份最长可以保留2562天。

    如果请求体中“backup_strategy”为空,则响应体中 “keep_days”默认返回“7”

    表14 volume字段数据结构说明

    名称

    参数类型

    说明

    type

    String

    参数解释:

    磁盘类型。

    取值范围:

    CLOUDSSD:区分大小写,表示SSD云盘,仅支持通用型和独享型规格实例。

    size

    Integer

    参数解释:

    磁盘大小。

    取值范围:

    40 GB~4000 GB,必须为10的整数倍。

    表15 chargeInfo字段数据结构说明

    名称

    参数类型

    说明

    charge_mode

    String

    参数解释:

    计费模式。

    取值范围:

    prePaid:预付费,即包年/包月。

    period_num

    Integer

    参数解释:

    订购时长。

    取值范围:

    与请求参数值相同。

响应样例中参数“region”和“availability_zone”的值为示例值。

  • 正常响应样例

    创建FlexusRDS单机实例下发成功。

    {
    	"instance": {
    		"id": "dsfae23fsfdsae3435in01",
    		"name": "flexusrds-instance",
    		"datastore": {
    			"type": "MySQL",
    			"version": "5.7"
    		},
    		"flavor_ref": "rds.mysql.y1.large.2",
    		"volume": {
    			"type": "CLOUDSSD",
    			"size": 100
    		},
                    "region": "aaa",
    		"availability_zone": "bbb",
    		"vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce",
    		"subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f",
    		"security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5",
    		"port": "3306",
    		"backup_strategy": {
    			"start_time": "08:15-09:15",
    			"keep_days": 3
    		},
    		"charge_info": {
    			"charge_mode": "postPaid"
    		}
    	},
    	"job_id": "dff1d289-4d03-4942-8b9f-463ea07c000d"
    }

    创建FlexusRDS主备实例下发成功。

    {
      "instance":{ 
               "id": "dsfae23fsfdsae3435in01",
               "name": "flexusrds-instance-ha", 
               "datastore": { 
                 "type": "MySQL", 
                 "version": "5.7" 
                }, 
               "ha": {
                 "mode": "ha",
                 "replication_mode": "semisync"
               },
               "flavor_ref": "rds.mysql.y1.xlarge.2.ha",
               "volume": { 
                   "type": "CLOUDSSD", 
                   "size": 100 
                 },
               "region": "aaa",
               "availability_zone": "bbb,ccc",
               "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", 
               "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f",
               "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", 
               "port": "3306", 
               "backup_strategy": { 
                 "start_time": "08:15-09:15", 
                 "keep_days": 3 
                }, 
               "charge_info": {
                       "charge_mode": "postPaid"
                                   },
             },
      "job_id": "dff1d289-4d03-4942-8b9f-463ea07c000d" 
    }
  • 异常响应

    请参见异常请求结果

support.huaweicloud.com/api-flexusrds/rds_01_0002.html