服务来源管理
1.创建服务来源
接口描述
从同租户下资源池添加服务来源。
接口约束
无
URI
POST /cgw/v1/upstreamSource/create
Content-Type: application/json
路径参数
Query参数
请求参数
请求头header参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
regionId | 是 | String | 资源池编码 | 7a2828074ef6e32e041a2ef124b19e63 |
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
id | 是 | String | 服务来源的实例ID | 7a2828074ef6e32e041a2ef124123456 | |
idName | 是 | String | 服务来源的实例名称 | rcc-etrs | |
instId | 是 | String | 实例Id | 123456074ef6e32e041a2ef124123456 | |
kubernetesInfo | 否 | Object | kubernetes来源的连接参数,创建容器来源时填写 | KubernetesSourceInfo | |
namespaceLabelSelector | 否 | Array of Objects | 监听的命名空间标签选择器 | K8sLabelDTO | |
nacosInfo | 否 | Object | nacos来源的连接参数,创建nacos来源时填写 | NacosSourceInfo | |
relatedInfo | 否 | String | 服务来源实例关联信息 | 1.1.1.1:47588 | |
type | 是 | String | 服务来源类型,如 nacos 或者 kubernetes | nacos | |
watchK8sIngressFlag | 否 | Boolean | 是否监听K8s ingress | false |
表 KubernetesSourceInfo
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
host | 是 | String | 从ccse获取的k8s实例ip | 987456074ef6e32e041a2ef124123456 | |
port | 是 | String | 从ccse获取的k8s实例端口 | 6443 | |
schema | 是 | String | 从ccse获取的k8s实例schema | http | |
token | 是 | String | 从ccse心获取的k8s实例token | token |
表 K8sLabelDTO
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
labelName | 否 | String | 标签名 | version | |
labelValue | 否 | String | 标签值 | v1 |
表 NacosSourceInfo
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
fetchInterval | 否 | Integer | 定时fetch间隔,默认30秒 | 30 | |
nacosNodes | 是 | Array of Objects | nacos实例(集群)节点信息 | NacosNode | |
prefix | 否 | String | 前缀配置,默认为"/nacos/v1" | /nacos/v1 | |
timeout | 否 | Object | 访问nacos时的超时配置 | Timeout | |
weight | 否 | Integer | 权重,默认100 | 100 |
表 NacosNode
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
host | 是 | String | 从注册中心获取的nacos实例ip | 1.1.1.1 | |
password | 是 | String | 从注册中心获取的nacos实例密码 | passwd | |
port | 是 | String | 从注册中心获取的nacos实例端口 | 47588 | |
username | 是 | String | 从注册中心获取的nacos实例用户名 | rcc-etrs |
表 Timeout
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
connect | 否 | Float | 连接超时,默认2000毫秒 | 2000 | |
read | 否 | Float | 接收超时,默认5000毫秒 | 2000 | |
send | 否 | Float | 发送超时,默认2000毫秒 | 2000 |
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
statusCode | Integer | 接口状态码 | 2000 | |
code | String | 错误码,异常时非空 | CGW_1001 | |
returnObj | Object | 返回数据 | {} | |
message | String | 异常描述 | success |
请求示例
请求url
https://127.0.0.1:8080/cgw/v1/upstreamSource/create
请求头header
{
"regionId": "1234567890"
}
请求体body
{
"type": "nacos",
"nacosInfo": {
"nacosNodes": [
{
"host": "192.168.128.119",
"port": "47588",
"username": "msegateway",
"password": "7vihYqnXeRSvoUD+EEURjRRxUcqHHC09fxdjSnA+PXXsEuA5An/rg66sZkg/1LxRNS2JGNCM7cs="
}
]
},
"relatedInfo": "192.168.128.119:47588",
"id": "76fb7717e5bd9a15a9f926d26e640537",
"idName": "mse-test-chenjh123",
"instId": "878da73f7dba36ff0ae80e004a4f28f9"
}
响应示例
{
"statusCode": 2000,
"returnObj": {},
"message": "success"
}
状态码
请参考 状态码说明。
错误码
请参考 错误码说明。