调用 CreateCenServiceRouteEntry 接口,配置指定的云服务访问路由。
说明
自定义云服务访问路由发布范围的功能正在邀测中,如需试用,请联系客户经理。
下表中,PublishToInstances.N.a类型参数中的“N”表示云服务访问路由发布信息的序号,需按照数字顺序从1开始填写,单次调用数量上限100个。多个云服务访问路由的发布信息之间使用&分隔。
参数名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateCenServiceRouteEntry | 要执行的操作,取值为CreateCenServiceRouteEntry。 |
Version | String | 是 | 2020-04-01 | API版本信息,当前版本为2020-04-01。 |
Description | String | 否 | test-service-route | 云服务访问的描述信息。
|
CenId | String | 是 | cen-2nim00ybaylts7trquyzt**** | 云企业网实例的ID。 |
DestinationCidrBlock | String | 是 | 100.XX.XX.0/24 | 云服务部署的地址,必须属于 说明 云企业网支持IPv6的功能正在邀测中,如需试用,请联系客户经理。 |
ServiceRegionId | String | 是 | cn-beijing | 云服务所属的地域。 |
ServiceVpcId | String | 是 | vpc-3rlkeggyn6tc010exd32q**** | 访问云服务时使用的私有网络实例ID。 说明 该私有网络必须与云服务属于相同地域,且已加载至对应的云企业网实例中。 |
PublishMode | String | 否 | LocalDCGW | 云服务访问路由的发布范围。
|
PublishToInstances.N.InstanceType | String | 否 | PublishToInstances.1.InstanceType=VPC&PublishToInstances.2.InstanceType=VPC | 云服务访问路由需要发布的网络实例类型。
|
PublishToInstances.N.InstanceRegionId | String | 否 | PublishToInstances.1.InstanceRegionId=cn-guangzhou&PublishToInstances.2.InstanceRegionId=cn-beijing | 云服务访问路由需要发布的地域。
|
PublishToInstances.N.InstanceId | String | 否 | PublishToInstances.1.InstanceId=vpc-7qthudw0ll6jmc****&PublishToInstances.2.InstanceId=vpc-uf6o8d1dj8sjwxi6o**** | 云服务访问路由需要发布的网络实例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 | 错误码 | 错误信息 | 描述 |
---|---|---|---|
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 | InvalidServiceRoute.Existed | The specified service route already exists. | 指定的云服务访问路由已经存在。 |
400 | InvalidServiceRoute.Malformed | The specified destination cidr block is malformed. | 指定的云服务访问路由的目的网段不在100.64.0.0/10或fd00:64::/32内。 |
400 | InvalidServiceRoute.PublishInstanceDuplicated | The specified publish instance is specified more than once in the request. | 指定的发布实例存在重复。 |
400 | QuotaExceeded.CenRouteEntry | You've reached the number of route entries can be published to CEN. | 已达到云企业网路由条目数量的配额上限。 |
403 | Forbidden.CreateServiceRoute | You are not authorized to perform operations on the service route. | 无权限对指定资源进行操作, 请开通云服务访问的白名单。 |
403 | Forbidden.PublishIPv6CenRouteEntry | You are not authorized to publish IPv6 route entry to CEN. | 无权限对指定的IPv6路由进行发布操作。 |
404 | InvalidCen.NotFound | The specified CEN does not exist. | 指定的云企业网实例不存在。 |
403 | InvalidCenAttachedInstance.NotFound | The specified CEN attached instance does not exist. | 指定的网络实例不存在。 |
403 | InvalidServiceRoute.PublishInstanceNotFound | The specified publish instance does not exist. | 指定的发布实例不存在。 |
409 | InvalidCen.InvalidStatus | The specified CEN instance is not in the correct status for the request. | 指定的云企业网实例所处的状态无法响应该请求,请稍后再试。 |
409 | InvalidServiceRoute.Conflict | There is conflict between the specified service route and existed routes. | 指定的云服务路由和云企业网路由表中已存在的路由存在冲突。 |