创建实例

最近更新时间:2019-05-28 15:07:31

CreateDBInstance 创建实例

创建MySQL实例(高可用实例或单实例)。 目前仅支持在VPC机房创建实例,所以用户在创建时需指定vpc网络信息,如果需要在basic机房创建实例可联系售后处理。

请求参数

英文名称 中文名称 类型 是否必须 备注
Action 调用接口名称 String 取固定值:CreateDBInstance
Version API版本号 String 取固定值:2016-07-01
DBInstanceClass 实例规格 String 区分大小写,取值示例:"db.ram.1 db.disk.5"表示内存1GB,磁盘5GB的实例。客户只能购买特定规格的套餐,否则将会报错。套餐规格具体可以参见文档说明。
DBInstanceName 实例名称 String 不超过256个字节,仅支持中文、大小写字母、数字、减号和下划线
Engine 实例中数据库引擎的名称 String 区分大小写,取值范围:mysql、percona
EngineVersion 实例中数据库引擎的版本 String 取值范围:5.5、5.6、5.7
MasterUserPassword 数据库用户密码 String 8-30个字符,必须包含大小写字母和数字,支持的特殊字符为!@#$%^&*()_+=-
MasterUserName 数据库用户名 String root, rdsrepladmin, rdsadmin不可用
DBInstanceType 数据库类型 String 区分大小写,取值范围:高可用实例:HRDS、单实例:SINGLERDS
PubliclyAccessible 是否使用VPC Boolean 现只能创建VPC实例,请固定传入true作为参数。
VpcId VPC domain_id String VPC网络ID,可在网络控制台获取。
SubnetId VPC vnet_id String 终端子网ID,可在网络控制台获取(注意类型必须为终端子网)。
PreferredBackupTime 自动备份发起时间范围 String 格式(hh:mm-hh:mm,如:01:00-02:00),如不指定后台将随机分配
DBParameterGroupId 参数组id String 指定实例的参数组,如不指定,系统将采用默认的参数组来创建实例。用户需事先在控制台创建好参数组。
Port 数据库连接端口 String 默认3306
BillType 计费方式 String 默认值:YEAR_MONTH,取值范围:YEAR_MONTH(包年包月),DAY(按日计费)。计费相关
Duration 购买时长 String 默认值:1
DurationUnit 购买时长单位 String 取值范围:M(月),默认值:M(区分大小写)
AvailabilityZone.N 可用区字段 String 示例(AvailabilityZone.1=cn-beijing-6a&AvailabilityZone.2=cn-beijing-6b),表示实例的主副本在a区,备副本在b区。如果没有跨可用区的需求,建议将实例创建在云主机的可用区内已减少网络延时。
ProjectId 项目Id Integer 可从IAM获取ProjectId。可按项目来进行细粒度权限控制,将实例归类到某个项目下

返回值

英文名称 中文名称 类型 备注
RequestId 请求ID String --
DBInstance RDS实例信息 DBInstance --

请求示例

http://krds.api.ksyun.com/?Action=CreateDBInstance&Version=2016-07-01&DBInstanceClass=db.ram.1|db.disk.10&DBInstanceName=test&Engine=mysql&EngineVersion=5.6&MasterUserName=test&MasterUserPassword=Test123456&DBInstanceType=HA&PubliclyAccessible=true&VpcId=b33a2276-64a8-4c04-b28e-da253c8add32&SubnetId=c2e0abd7-13df-461a-bd8d-3b92faebf111&BillType=DAY

示例返回

{
    "Data": {
        "DBInstance": {
            "DBInstanceClass": {
                "Id": "RDSOpenAPI_0772c82ea87c666d",
                "Vcpus": 1,
                "Disk": 10,
                "Ram": 1
            },
            "DBInstanceIdentifier": "bb2d111a-af44-41ee-b10d-754f23bc59e1",
            "DBInstanceName": "test",
            "DBInstanceStatus": "CREATING",
            "DBInstanceType": "HA",
            "DBParameterGroupId": "3b9aeb7b-552b-4707-92b2-15f0278bb73e",
            "GroupId": "71e2bd82-423d-41ae-a9e6-2131a447d780",
            "SecurityGroupId": "55705",
            "Vip": "0.0.0.0",
            "Port": 3306,
            "Engine": "mysql",
            "EngineVersion": "5.6",
            "InstanceCreateTime": "2018-03-20T11:03:22+0800",
            "MasterUserName": "test",
            "DatastoreVersionId": "96867ed6-6f6a-4006-bbc5-46c1f22d63a9",
            "Region": "cn-beijing-6",
            "VpcId": "0f71c616-6f5e-4f24-b809-59eb84016367",
            "PubliclyAccessible": false,
            "ReadReplicaDBInstanceIdentifiers": [],
            "BillType": "DAY",
            "OrderType": "REGULAR",
            "OrderSource": "OPENAPI",
            "MultiAvailabilityZone": false,
            "ProductId": "ed8b94df-68e0-47dc-a86b-017d1426a8cd",
            "DiskUsed": 0,
            "OrderUse": "BUY",
            "ProjectId": 0,
            "ProjectName": "默认项目"
        }
    },
    "RequestId": "1345b363-c988-44f5-9274-63709ff80b1e"
}

金山云,开启您的云计算之旅

立即注册