为了帮助您快速使用私有网络 api,这里给出一个示例,该示例先创建一个vpc。
在搭建一个 vpc 之前,必须要规划好您的 cidrBlock(即网段)。VPC 创建成功后 cidrBlock 是不能修改的。有关创建 VPC 的详细信息请参考创建私有网络页面。
这里我们创建一个私有网络,其公共请求参数的 Action 字段 CreateVpc,接口请求参数如下表:
参数名称 | 描述 | 取值 |
---|---|---|
vpcName | VPC 名称 | 1-60个中文、英文大小写的字母、数字和下划线分隔符 |
cidrBlock | 私有网络 CIDR 网段 | VPC 网段,可选值 10.0.0.0/16、172.16.0.0/16和192.168.0.0/16及它们包含的子网,详见 VPC 网段规划说明 |
subnetSet.n | 子网数组 | 可选项 |
subnetSet.n.subnetName | 子网名称 | 1-60个中文、英文大小写的字母、数字和下划线分隔符 |
subnetSet.n.cidrBlock | 子网网段 | 子网网段必须要在vpc网段内 |
subnetSet.n.zoneId | 可用区 ID | 详见可用区说明 |
结合公共请求参数和接口请求参数,最终得到的请求形式如下:
https://vpc.api.qcloud.com/v2/index.php?Action=CreateVpc &<公共请求参数> &vpcName=bbbtest &cidrBlock=192.168.0.0/16 &subnetSet.0.subnetName=wikitest &subnetSet.0.cidrBlock=192.168.1.0/24 &subnetSet.0.zoneId=800001
上述请求的返回结果如下,由结果可知,新创建的启动配置 ID 为vpc-2ari9m7h。
{
"code": 0,
"message": "",
"vpcId": "gz_vpc_266",
"uniqVpcId": "vpc-2ari9m7h",
"vpcCreateTime": "2015-11-06 11:33:52",
"subnetSet": [
{
"subnetId": "gz_subnet_18720",
"unSubnetId": "subnet-5gu2jxf4",
"routeTableId": "gz_rtb_8751",
"subnetName": "wikitest",
"cidrBlock": "192.168.1.0/24",
"zoneId": 800001
}
],
"routeTableSet": [
{
"routeTableId": "gz_rtb_8751",
"routeTableType": 1,
"routeTableName": "默认"
}
]
}