You need to enable JavaScript to run this app.
导航
云企业网
  • 文档首页
    • /
  • 云企业网

CreateCenServiceRouteEntry

最近更新时间：2024.04.22 17:46:09

首次发布时间：2022.08.08 14:40:11

我的收藏

调用 CreateCenServiceRouteEntry 接口，配置指定的云服务访问路由。

使用说明

  • 自定义云服务访问路由发布范围的功能正在邀测中，如需使用相关参数，请联系客户经理。
  • a.N.b类型的参数中，“N”表示云服务访问路由发布信息的序号，需按照数字顺序从1开始填写，单次调用数量上限100个。多个标签之间使用&分隔。

调试

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

请求参数

参数名称
类型
是否必选
示例值
描述
ActionString是CreateCenServiceRouteEntry要执行的操作，取值为CreateCenServiceRouteEntry。
VersionString是2020-04-01API版本信息，当前版本为2020-04-01。
CenIdString是cen-2nim00ybaylts7trquyzt****云企业网实例的ID。您可以调用DescribeCens接口获取云企业网实例ID。

DestinationCidrBlock

String

是

100.XX.XX.0/24

云服务部署的地址，必须属于100.64.0.0/10或fd00:64::/32网段。

说明

云企业网支持IPv6的功能正在邀测中国，如需使用，请联系客户经理。

ServiceRegionIdString是cn-beijing云服务所属的地域。

ServiceVpcId

String

是

vpc-3rlkeggyn6tc010exd32q****

访问云服务时使用的私有网络实例ID。您可以调用DescribeVpcs接口获取私有网络的ID。

说明

该私有网络必须与云服务属于相同地域，且已加载至对应的云企业网实例中。

Description

String

否

test-service-route

云服务访问的描述信息。

  • 必须以字母、数字或中文开头，可包含字母、数字、中文和以下特殊字符：英文逗号（,）、点号（.）、下划线（_）、空格（ ）、等号（=）、中划线（-）、中文逗号（，）、中文句号（。）。
  • 长度限制为0 ~ 255个字符。
  • 不传入该参数或该参数不传入数值时，默认为空字符串。

PublishMode

String

否

LocalDCGW

云服务访问路由的发布范围。

  • LocalDCGW（默认值）：表示自动将该云服务访问路由发布到云服务所在地域中所有已加载至CEN实例的专线网关。
  • Custom：表示手动指定该云服务访问路由需要发布到的网络实例。

PublishToInstances.N.InstanceRegionId

String

否

PublishToInstances.1.InstanceRegionId=cn-guangzhou&PublishToInstances.2.InstanceRegionId=cn-beijing

云服务访问路由需要发布的地域。
云企业网服务支持的地域可参见区域与地域。

PublishToInstances.N.InstanceType

String

否

PublishToInstances.1.InstanceType=VPC&PublishToInstances.2.InstanceType=VPC

云服务访问路由需要发布的网络实例类型。取值如下：

  • VPC：私有网络。
  • DCGW：专线网关。

PublishToInstances.N.InstanceId

String

否

PublishToInstances.1.InstanceId=vpc-7qthudw0ll6jmc****&PublishToInstances.2.InstanceId=vpc-uf6o8d1dj8sjwxi6o****

云服务访问路由需要发布的网络实例ID。

返回参数

参数名称
类型
示例值
描述
RequestIdString20211222122528010225****请求ID。

请求示例

GET /?Action=CreateCenServiceRouteEntry&Version=2020-04-01&CenId=cen-2nim00ybaylts7trquyzt****&DestinationCidrBlock=100.XX.XX.0/24&ServiceRegionId=cn-beijing&ServiceVpcId=vpc-3rlkeggyn6tc010exd32q**** HTTP/1.1
Host: open.volcengineapi.com
Service: cen
Region: cn-beijing

返回示例

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

错误码

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

HttpCode错误码错误信息描述
400InvalidCidr.MalformedThe specified cidr block is malformed.指定的网段格式不合法。
400InvalidDescription.MalformedThe specified description is malformed. Ensure the maximum length of description is 255.指定的描述格式不合法，描述长度不能超过255个字符。
400InvalidDescription.MalformedThe specified description is malformed.指定的描述格式不合法，请修复描述格式后重试。
400InvalidServiceRoute.MalformedThe specified destination cidr block is malformed.指定的云服务访问路由的目的网段不在100.64.0.0/10或fd00:64::/32内。
400InvalidServiceRoute.ExistedThe specified service route already exists.指定的云服务访问路由已经存在。
400QuotaExceeded.CenRouteEntryYou've reached the number of route entries can be published to CEN.已达到云企业网路由条目数量的配额上限。
400InvalidServiceRoute.PublishInstanceDuplicatedThe specified publish instance is specified more than once in the request.指定的发布实例存在重复。
403Forbidden.PublishIPv6CenRouteEntryYou are not authorized to publish IPv6 route entry to CEN.无权限对指定的IPv6路由进行发布操作。
404InvalidServiceRoute.PublishInstanceNotFoundThe specified publish instance does not exist.指定的发布实例不存在。
404InvalidCen.NotFoundThe specified CEN does not exist.指定的云企业网实例不存在。
404InvalidCenAttachedInstance.NotFoundThe specified CEN attached instance does not exist.指定的网络实例不存在。
409InvalidCen.InvalidStatusThe specified CEN instance is not in the correct status for the request.指定的云企业网实例所处的状态无法响应该请求，请稍后再试。
409InvalidServiceRoute.ConflictThere is conflict between the specified service route and existed routes.指定的云服务路由和云企业网路由表中已存在的路由存在冲突。