服务版本管理
1.服务版本列表
接口约束
无
URI
/cgw/v1/upstreamVersion/list
请求方法:GET
Accept: application/json
路径参数
无
Query参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
upstreamId | 是 | String | 服务内部Id | 7a2828074ef6e32e041a2ef124b19e63 | |
instId | 是 | String | 实例Id | 123456074ef6e32e041a2ef124b19e63 | |
serviceType | 是 | String | 服务参数类型 | nacos | |
namespace | 是 | String | 服务所在命名空间(Nacos参数类型时传namespaceId) | 7a2828074ef6e32e041a2ef124123456 | |
serviceName | 是 | String | 服务名称 | test |
请求参数
请求头header参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
regionId | 是 | String | 资源池编码 | 7a2828074ef6e32e041a2ef124b19e63 |
请求体body参数
无
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
statusCode | Integer | 接口状态码 | 2000 | |
code | String | 错误码,异常时非空 | CGW_1001 | |
returnObj | Array of Objects | 返回数据 | UpstreamVersionVO | |
message | String | 异常描述 | success |
表 UpstreamVersionVO
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
id | String | 服务版本内部id | 7a2828074ef6e32e041a2ef124b19e63 | |
instNum | Integer | 实例数 | 1 | |
instNumPercent | String | 实例比例% | 100.00% | |
labelName | String | 标签名原始值。用于传参,和tips展示 | __micro.service.env__ | |
labelNameVO | String | 标签名别名,用于web展示 | tag | |
labelValue | String | 标签值原始值。用于传参,和tips展示 | value | |
labelValueVO | String | 标签值别名,用于web展示 | 75b2e831c2 | |
upstreamId | String | 服务内部id | 7a2828074ef6e32e041a2ef124b19e63 | |
versionName | String | 服务版本名称 | test |
请求示例
请求url
https://127.0.0.1:8080/cgw/v1/upstreamVersion/list?upstreamId=00000000000000000052&instId=878da73f7dba36ff0ae80e004a4f28f9&namespace=40cacbb7-321e-4ce0-8ece-da44e14dcd02&serviceType=nacos&serviceName=mse-sc-gatewa
请求头header
{
"regionId": "1234567890"
}
请求体body
响应示例
{
"statusCode": 2000,
"message": "success",
"returnObj": [
{
"id": "00000000000000000055",
"upstreamId": "00000000000000000052",
"versionName": "v1",
"labelName": "__micro.service.env__",
"labelNameVO": "tag",
"labelValue": "[{\"desc\":\"k8s-pod-label\",\"priority\":100,\"tag\":\"75b2e831c2\",\"type\":\"tag\"}]",
"labelValueVO": "75b2e831c2",
"instNum": 1,
"instNumPercent": "100.00%"
}
]
}
状态码
请参考 状态码说明。
错误码
请参考 错误码说明。