# 查询服务网关关联的虚拟服务列表 - ShowGatewayRelatedVirtualService #### 功能介绍 查询服务网关关联的虚拟服务列表 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IEF/doc?api=ShowGatewayRelatedVirtualService)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ief/ief_02_1003.html)。 #### URI GET /v3/{project_id}/edgemgr/gateways/{gateway_id}/virtual-services 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目ID | | gateway_id | 是 | String | 网关ID | #### 请求参数 无 #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | count | Integer | 数量 | | virtual_services | Array of [VirtualServiceResp] objects | 虚拟服务列表 | 表3VirtualServiceResp | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | ID | | project_id | String | 项目ID | | meta_data | [VirtualServiceMetaData] object | 元数据 | | spec | [VirtualServiceSpec] object | 规约 | | created_at | String | 创建时间 | | updated_at | String | 更新时间 | 表4VirtualServiceMetaData | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | 名称 | 表5VirtualServiceSpec | 参数 | 参数类型 | 描述 | |:---|:---|:---| | hosts | Array of strings | 主机 | | gateways | Array of strings | 网关 | | http | Array of [HTTPRoute] objects | http | | tcp | Array of [TCPRoute] objects | tcp | | tls | Array of [TLSRoute] objects | tls | | export_to | Array of strings | export_to | 表6HTTPRoute | 参数 | 参数类型 | 描述 | |:---|:---|:---| | match | Array of [HTTPMatchRequest] objects | 匹配 | | route | Array of [HTTPRouteDestination] objects | 路由 | | rewrite | [HTTPRewrite] object | 重写 | | redirect | [HTTPRedirect] object | 重定向 | | retries | [HTTPRetry] object | 重试 | | fault | [HTTPFaultInjection] object | 失败 | | mirror | [Destination] object | 镜像 | 表7HTTPMatchRequest | 参数 | 参数类型 | 描述 | |:---|:---|:---| | uri | Map\ | uri | | scheme | Map\ | 模式 | | method | Map\ | 方法 | | authority | Map\ | 认证 | | headers | Map\\> | 请求头 | | port | Integer | 端口 | | source_labels | Map\ | 源码标签 | | gateways | Array of strings | 网关 | 表8HTTPRouteDestination | 参数 | 参数类型 | 描述 | |:---|:---|:---| | destination | [Destination] object | 目标路由 | | weight | Integer | 权重 | | headers | Map\\> | 头 | 表9HTTPRewrite | 参数 | 参数类型 | 描述 | |:---|:---|:---| | uri | String | URI | | authority | Map\ | 认证 | 表10HTTPRedirect | 参数 | 参数类型 | 描述 | |:---|:---|:---| | uri | String | uri | | authority | String | authority | 表11HTTPRetry | 参数 | 参数类型 | 描述 | |:---|:---|:---| | attempts | Integer | 尝试次数 | | per_try_timeout | String | 超时时间 | | retry_on | String | retry_on | 表12HTTPFaultInjection | 参数 | 参数类型 | 描述 | |:---|:---|:---| | delay | [Delay] object | 时延 | | abort | [Abort] object | 中断 | 表13Delay | 参数 | 参数类型 | 描述 | |:---|:---|:---| | percentage | Map\ | 百分比 | | fixed_delay | String | 固定时延 | 表14Abort | 参数 | 参数类型 | 描述 | |:---|:---|:---| | percentage | Map\ | 百分比 | | http_status | Integer | http状态 | 表15TCPRoute | 参数 | 参数类型 | 描述 | |:---|:---|:---| | match | Array of [L4MatchAttributes] objects | 匹配 | | route | Array of [RouteDestination] objects | 路由 | 表16L4MatchAttributes | 参数 | 参数类型 | 描述 | |:---|:---|:---| | destination_subnets | Array of strings | 目标子网 | | port | Integer | 端口 | | source_labels | Map\ | 源标签 | | gateways | Array of strings | 网关列表 | 表17TLSRoute | 参数 | 参数类型 | 描述 | |:---|:---|:---| | match | Array of [TLSMatchAttributes] objects | 匹配 | | route | Array of [RouteDestination] objects | 路由 | 表18TLSMatchAttributes | 参数 | 参数类型 | 描述 | |:---|:---|:---| | sni_hosts | Array of strings | sni主机 | | destination_subnets | String | 目标子网 | | port | Integer | 端口 | | source_labels | Map\ | 源标签 | | gateways | Array of strings | 网关 | 表19RouteDestination | 参数 | 参数类型 | 描述 | |:---|:---|:---| | destination | [Destination] object | 目标 | | weight | Integer | 权重 | 表20Destination | 参数 | 参数类型 | 描述 | |:---|:---|:---| | host | String | 主机 | | subset | String | 子网 | | port | Integer | 端口 | #### 请求示例 ``` /v3/{project_id}/edgemgr/gateways/{gateway_id}/virtual-services { } ``` #### 响应示例 **状态码：200** 查询服务网关关联的虚拟服务列表响应体 ``` { "count" : 0, "virtual_services" : [ { "id" : "string", "project_id" : "string", "meta_data" : { "name" : "string" }, "spec" : { "hosts" : [ "string" ], "gateways" : [ "string" ], "http" : [ { "match" : [ { "uri" : { "additionalProp1" : "string", "additionalProp2" : "string", "additionalProp3" : "string" }, "scheme" : { "additionalProp1" : "string", "additionalProp2" : "string", "additionalProp3" : "string" }, "method" : { "additionalProp1" : "string", "additionalProp2" : "string", "additionalProp3" : "string" }, "authority" : { "additionalProp1" : "string", "additionalProp2" : "string", "additionalProp3" : "string" }, "headers" : { "additionalProp1" : { "additionalProp1" : "string", "additionalProp2" : "string", "additionalProp3" : "string" }, "additionalProp2" : { "additionalProp1" : "string", "additionalProp2" : "string", "additionalProp3" : "string" }, "additionalProp3" : { "additionalProp1" : "string", "additionalProp2" : "string", "additionalProp3" : "string" } }, "port" : 0, "source_labels" : { "additionalProp1" : "string", "additionalProp2" : "string", "additionalProp3" : "string" }, "gateways" : [ "string" ] } ], "route" : [ { "destination" : { "host" : "string", "subset" : "string", "port" : 0 }, "weight" : 0, "headers" : { "additionalProp1" : { "additionalProp1" : "string", "additionalProp2" : "string", "additionalProp3" : "string" }, "additionalProp2" : { "additionalProp1" : "string", "additionalProp2" : "string", "additionalProp3" : "string" }, "additionalProp3" : { "additionalProp1" : "string", "additionalProp2" : "string", "additionalProp3" : "string" } } } ], "rewrite" : { "uri" : "string", "authority" : { "additionalProp1" : "string", "additionalProp2" : "string", "additionalProp3" : "string" } }, "redirect" : { "uri" : "string", "authority" : "string" }, "retries" : { "attempts" : 0, "per_try_timeout" : "string", "retry_on" : "string" }, "fault" : { "delay" : { "percentage" : { "additionalProp1" : 0, "additionalProp2" : 0, "additionalProp3" : 0 }, "fixed_delay" : "string" }, "abort" : { "percentage" : { "additionalProp1" : 0, "additionalProp2" : 0, "additionalProp3" : 0 }, "http_status" : 0 } }, "mirror" : { "host" : "string", "subset" : "string", "port" : 0 } } ], "tcp" : [ { "match" : [ { "destination_subnets" : [ "string" ], "port" : 0, "source_labels" : { "additionalProp1" : "string", "additionalProp2" : "string", "additionalProp3" : "string" }, "gateways" : [ "string" ] } ], "route" : [ { "destination" : { "host" : "string", "subset" : "string", "port" : 0 }, "weight" : 0 } ] } ], "tls" : [ { "match" : [ { "sni_hosts" : [ "string" ], "destination_subnets" : "string", "port" : 0, "source_labels" : { "additionalProp1" : "string", "additionalProp2" : "string", "additionalProp3" : "string" }, "gateways" : [ "string" ] } ], "route" : [ { "destination" : { "host" : "string", "subset" : "string", "port" : 0 }, "weight" : 0 } ] } ], "export_to" : [ "string" ] }, "created_at" : "string", "updated_at" : "string" } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 查询服务网关关联的虚拟服务列表响应体 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ief/ErrorCode.html)。