CreateCloudRouter

1. 接口描述

调用本接口用于创建一条三层网络。

准备工作

在你创建三层网络之前，你可以：

三层网络加入VPC：可以通过DescribeCloudRouterAvailableVpcs接口来获取可以使用的VPC。
三层网络加入数据中心端口： 可以通过DescribeCloudRouterAvailablePorts接口来获取可以使用的端口。
云接入支持的数据中心查询：
- 可以通过 DescribeGoogleRegions 查询Goolge 云接入点支持的数据中心信息。
- 可以通过 DescribeAWSRegions 查询AWS云接入点支持的数据中心信息。
- 可以通过 DescribeTencentRegions查询Tencent 云接入点支持的数据中心信息。

注意事项

目前只支持创建后付费的三层网络。
一个VPC仅可加入一个三层网络。
本接口为异步接口，当创建实例请求下发成功后会返回一个三层网络的ID，此时创建操作并未立即完成。在此期间实例的状态将会处于**DEPLOYING，创建结果可以通过调用DescribeCloudRouters 接口查询，如果状态(cloudRouterStatus)由DEPLOYING(创建中)变为RUNNING**(可用)，则代表创建成功，如果未查询到任何记录，则代表创建失败，创建过程中不可对三层网络进行任何操作。

2. 请求参数

以下请求参数列表仅列出了接口中需要的请求参数

参数名称	必选	类型	描述
cloudRouterName	否	String	三层网络的名称。长度不能超过255。默认为cloud-router-{当前时间戳秒}。
cloudRouterDescription	否	String	三层网络的描述信息。长度不能超过255。
edgePoints	否	Array of CreateCloudRouterEdgePoint	创建三层网络中的边缘连接点信息。
resourceGroupId	否	String	资源组的ID。如果不传，则会放到默认资源组。

参数名称

必选

类型

描述

cloudRouterName

否

String

三层网络的名称。长度不能超过255。默认为cloud-router-{当前时间戳秒}。

cloudRouterDescription

否

String

三层网络的描述信息。长度不能超过255。

edgePoints

否

Array of CreateCloudRouterEdgePoint

创建三层网络中的边缘连接点信息。

resourceGroupId

否

String

资源组的ID。

如果不传，则会放到默认资源组。

3. 响应结果

参数名称	类型	描述
requestId	String	唯一请求 ID。每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
cloudRouterId	String	三层网络ID。

参数名称

类型

描述

requestId

String

唯一请求 ID。

每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

cloudRouterId

String

三层网络ID。

4. 代码示例

1. 创建1个三层网络专线，接入点有2个, 接入点带宽大小都是 1Mbps。其中一个接入点是端口，另一个接入点是VPC。

POST /api/v2/sdn HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: CreateCloudRouter
<Common Request Params>

Request：
{
    "cloudRouterStatus":"RUNNING",
    "edgePoints":[
        {
            "ipAddress":"4.4.4.4/24",
            "vlanId": 1024,
            "portId":"your-portId",
            "bgpConnection":{
                "password":"",
                "peerIpAddress":"4.4.4.3",
                "localAsn":62610,
                "peerAsn":6543
            },
            "bandwidthMbps":1
        },
        {
            "vpcId":"your vpc id",
            "bandwidthMbps":1
        }
    ],
    "cloudRouterName":"Test",
    "cloudRouterDescription":"",
    "cloudRouterChargeType":"POSTPAID"
}

Response：
{   
  "requestId": "T05992D0C-7E8B-4047-B0C0-780F2CD549D3",
  "response": {
     "requestId": "T98044459-95B2-477E-9A2F-00253A70CC6E"，
     "cloudRouterId": "cloud router id"
  }
}

5. 开发者工具

Zenlayer Cloud API 2.0 提供了配套的开发工具集（SDK），未来会陆续支持更多开发语言，方便快速接入和使用Zenlayer的产品和服务。

6. 错误码

下面包含业务逻辑中遇到的错误码，其他错误码见公共错误码

HTTP状态码

错误码

说明

最后更新于7个月前