CreateCenSummaryRouteEntry--云企业网-火山引擎

文档中心

立即注册

导航

CreateCenSummaryRouteEntry

最近更新时间：2024.11.15 14:37:59首次发布时间：2023.03.03 08:18:36

调用 CreateCenSummaryRouteEntry 接口，创建CEN汇总路由。

说明

汇总路由正在邀测中，暂仅支持完成企业认证的账号申请试用，如需试用，请联系客户经理。

使用说明

CEN中创建的汇总路由会发布到该CEN中挂载的所有专线网关路由表。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数名称	类型	是否必选	示例值	描述
Action	String	是	CreateCenSummaryRouteEntry	要执行的操作，取值为CreateCenSummaryRouteEntry。
Version	String	是	2020-04-01	API版本信息，当前版本为2020-04-01。
CenId	String	是	cen-7qthudw0ll6jmc****	云企业网实例ID。您可以调用 DescribeCens 接口，查询云企业网实例ID。
DestinationCidrBlock	String	是	172.XX.XX.0/24	CEN汇总路由的目标网段。
Description	String	否	This is an example description.	CEN汇总路由的描述信息。必须以字母、数字或中文开头，可包含字母、数字、中文和以下特殊字符：英文逗号（,）、点号（.）、下划线（_）、空格（）、等号（=）、短横线（-）、中文逗号（，）、中文句号（。）。长度限制为0 ~ 255个字符。不填则默认为空字符串。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

GET /?Action=CreateCenSummaryRouteEntry&Version=2020-04-01&CenId=cen-7qthudw0ll6jmc****&DestinationCidrBlock=172.XX.XX.0/24 HTTP/1.1
Host: open.volcengineapi.com
Service: cen
Region: cn-beijing

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2021081115253901022514606****",
        "Action": "CreateCenSummaryRouteEntry",
        "Version": "2020-04-01",
        "Service": "cen",
        "Region": "cn-beijing"
    },
    "Result": {}
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

HttpCode	错误码	错误信息	描述
400	InvalidCidr.Malformed	The specified cidr block is malformed.	指定的网段格式不合法。
400	InvalidDescription.Malformed	The specified description is malformed. Ensure the maximum length of description is 255.	指定的描述格式不合法，描述长度不能超过255个字符。
400	InvalidDescription.Malformed	The specified description is malformed.	指定的描述格式不合法，请修复描述格式后重试。
400	LimitExceeded.CenSummaryRouteEntry	You've reached the limit on the number of summary route entries that you can create on a CEN.	已达到在单个云企业网实例上可创建的汇总路由上限。
403	Forbidden.CreateCenSummaryRouteEntry	You are not authorized to create CEN summary route entry.	无权限创建云企业网汇总路由。
403	Forbidden.PublishIPv6CenRouteEntry	You are not authorized to publish IPv6 route entry to CEN.	无权限对指定的IPv6路由进行发布操作。
404	InvalidCen.NotFound	The specified CEN does not exist.	指定的云企业网实例不存在。
409	InvalidCen.InvalidStatus	The specified CEN instance is not in the correct status for the request.	指定的云企业网实例所处的状态无法响应该请求，请稍后再试。
409	InvalidCenSummaryRoute.Conflict	The specified summary route has already existed on the CEN.	指定的汇总路由已存在。