调用 DescribeCenServiceRouteEntries 接口，查询满足指定条件的云服务访问路由的详细信息。
参数名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeCenServiceRouteEntries | 要执行的操作，取值为DescribeCenServiceRouteEntries。 |
| Version | String | 是 | 2020-04-01 | API版本信息，当前版本为2020-04-01。 |
CenId | String | 否 | cen-2nim00ybaylts7trquyzt**** | 云企业网实例的ID。 |
| DestinationCidrBlock | String | 否 | 100.XX.XX.0/24 | 云服务的地址段，必须属于100.64.0.0/10或fd00:64::/32网段。 |
| ServiceRegionId | String | 否 | cn-beijing | 云服务所属的地域。 |
ServiceVpcId | String | 否 | vpc-3rlkeggyn6tc010exd32q**** | 访问云服务时使用的私有网络实例ID。 |
| CenRouteEntryIds.N | String | 否 | CenRouteEntryIds.1=rte-7qthudw0ll6jmc****&CenRouteEntryIds.rte-2fexiqjlgjif45oxruvso**** | 路由条目的ID。 |
| PageNumber | Integer | 否 | 1 | 列表的页码。默认值为1。 |
| PageSize | Integer | 否 | 10 | 分页查询时每页的行数。取值范围为1～100，默认值为20。 |
参数名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| PageNumber | Integer | 1 | 当前页码。 |
| PageSize | Integer | 1 | 当前分页的行数。 |
| TotalCount | Integer | 1 | 符合条件的路由条目总数。 |
| ServiceRouteEntries | Array of Struct | - | 云服务访问路由的详细信息。具体请参见下表“ ServiceRouteEntry结构 ”。 |
参数名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| CenId | String | cen-2nim00ybaylts7trquyzt**** | 云企业网实例的ID。 |
| Description | String | test-service-route | 云服务访问路由的描述信息。 |
| DestinationCidrBlock | String | 100.XX.XX.0/24 | 云服务部署的地址，属于100.64.0.0/10或fd00:64::/32网段。 |
| ServiceRegionId | String | cn-beijing | 云服务所属的地域。 |
| ServiceVpcId | String | vpc-3rlkeggyn6tc010exd32q**** | 访问云服务时使用的私有网络ID。 |
Status | String | Available | 云服务访问路由的状态。
|
PublishMode | String | Custom | 云服务访问路由的发布范围。
|
| PublishToInstances | Array of Struct | - | 云服务访问路由的发布信息。具体请参见下表“ PublishToInstance结构”。 |
| CreationTime | String | 2022-04-28T22:57:03+08:00 | 云服务访问路由的创建时间。 |
参数名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| InstanceRegionId | String | cn-beijing | 云服务访问路由发布的地域。 |
InstanceType | String | VPC | 云服务访问路由发布的网络实例类型。
|
| InstanceId | String | vpc-uf6o8d1dj8sjwxi6o**** | 云服务访问路由发布的网络实例ID。 |
GET /?Action=DescribeCenServiceRouteEntries&Version=2020-04-01&CenId=cen-2nim00ybaylts7trquyzt**** HTTP/1.1 Host: open.volcengineapi.com Service: cen Region: cn-beijing
{ "ResponseMetadata": { "RequestId": "20211222122528010225****", "Action": "DescribeCenServiceRouteEntries", "Version": "2020-04-01", "Service": "cen", "Region": "cn-beijing" }, "Result": { "PageNumber": 1, "PageSize": 1, "TotalCount": 1, "ServiceRouteEntries": [ { "CenId": "cen-2nim00ybaylts7trquyzt****", "DestinationCidrBlock": "100.XX.XX.0/24", "ServiceRegionId": "cn-beijing", "ServiceVpcId": "vpc-3rlkeggyn6tc010exd32q****", "Status": "Available", "CreationTime": "2022-04-28T22:57:03+08:00", "Description": "test-service-route", "PublishMode": "Custom", "PublishToInstances": [ { "InstanceRegionId": "cn-beijing", "InstanceType": "VPC", "InstanceId": "vpc-uf6o8d1dj8sjwxi6o****" }, { "InstanceRegionId": "cn-guangzhou", "InstanceType": "VPC", "InstanceId": "vpc-7qthudw0ll6jmc****" } ] } ] } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InvalidCidr.Malformed | The specified cidr block is malformed. | 指定的网段格式不合法。 |
| 400 | InvalidServiceRouteEntry.NotFound | The specified service route entry does not exist. | 指定的云服务访问路由不存在。 |
| 400 | QuotaExceeded.CenRouteEntry | You've reached the number of route entries can be published to CEN. | 已达到云企业网路由条目数量的配额上限。 |
| 409 | InvalidCen.InvalidStatus | The specified CEN instance is not in the correct status for the request. | 指定的云企业网实例所处的状态无法响应该请求，请稍后再试。 |
| 409 | InvalidServiceRouteEntry.InvalidStatus | The specified CEN service route is not in the correct status for the request. | 指定的云服务路由所处的状态无法响应该请求，请稍后再试。 |