4.5.4.3 查询应用详情-基于名称
可通过此接口基于应用名称查询应用详情。
基本信息
请求地址:
https://SDPC-IP:4433/api/v3/resource/queryByName
请求方式:GET
请求头(Header)
- 请求体(Body)
参数 | 中文名称 | 必须 | 类型 | 描述 |
---|---|---|---|---|
name | 应用名称 | 是 | string | 应用名称 |
- 请求示例
基于应用id查询:
curl --location --request GET 'https://SDPC-IP:4433/api/v3/resource/queryByName?name=web1' \
--header 'Content-Type: application/json' \
--header 'X-Ca-Key: {{X-Ca-Key}}' \
--header 'X-Ca-Nonce: {{X-Ca-Nonce}}' \
--header 'X-Ca-TimeStamp: {{X-Ca-TimeStamp}}' \
--header 'X-Ca-Sign: {{X-Ca-Sign}}' \
--header 'Cookie: locale=zh-cn'
- 响应数据
参数 | 中文名称 | 类型 | 描述 |
---|---|---|---|
code | 响应码 | string | OK 表示成功,其他表示出错。具体含义请参考错误码定义 |
data | 响应数据 | object | 应用列表 |
├─ id | 应用ID | string | 应用ID |
├─ name | 应用名称 | string | 应用名称 |
├─ description | 应用描述 | string | 应用描述 |
├─ accessModel | 访问模式 | string | 访问模式: "WEB"表示WEB模式; "L3VPN"表示隧道模式 |
├─ subModel | 访问子模式 | string | 访问子模式: "WEB"表示标准WEB; "L3VPN"表示标准隧道 "TUN2WEB"表示隧道转web模式 |
├─ groupId | 应用分类id | string | 所属应用分类ID |
├─ groupName | 应用分类名称 | string | 所属应用分类名称 |
├─ nodeGroupId | 所属节点id | string | 节点区域ID |
├─ nodeGroupName | 所属节点名称 | string | 节点区域名称 |
├─ addressList | 后端服务器地址列表 | object [] | 后端服务器地址列表,仅隧道应用 |
├─ ├─ protocol | 协议 | string | 协议 |
├─ ├─ host | 地址 | string | 地址 |
├─ ├─ port | 端口 | string | 端口 |
├─ excludeAddress | 排除地址配置 | object | 排除地址配置 |
├─ ├─ status | 排除地址启用状态 | number | 排除地址启用状态,0启用,1禁用 |
├─ ├─ excludeAddressList | 排除地址列表 | object[] | 排除地址列表数组 |
├─ ├─ ├─ host | 地址 | string | 地址 |
├─ ├─ ├─ port | 端口 | string | 端口 |
├─ ├─ ├─ protocol | 协议 | string | 协议 |
├─ appAddress | 后端服务器地址 | string | 后端服务器地址,仅web应用 |
├─ accessAddress | 前端访问地址 | string | 前端访问地址,仅web应用 |
├─ accessEntry | 浏览器打开地址 | string | 浏览器打开地址 |
├─ accessAddressAliasList | 前端访问地址别名列表 | object [] | 前端访问地址别名列表,仅web应用 |
├─ ├─ protocol | 协议 | string | 协议 |
├─ ├─ host | 地址 | string | 地址 |
├─ ├─ port | 端口 | string | 端口 |
├─ status | 应用状态 | number | 应用启用状态,0:禁用;1:启用 |
├─ allowApply | 是否允许自助申请 | number | 是否允许用户自助申请此应用权限权限 |
├─ iconId | 应用图标id | string | 应用图标id |
├─ iconPath | 应用图标路径 | string | 应用图标路径 |
├─ iconType | 应用图标类型 | string | 应用图标类型 |
├─ enableAuthFree | 免认证启用状态 | number | 免认证启用状态 |
├─ trustedCertId | 授信证书id | string | 授信证书id |
├─ trustedCertName | 授信证书名称 | string | 授信证书名称 |
├─ enableTransparentProxy | 是否启用透明代理 | number | 1表示透明代理模式,0表示智能改写模式 |
├─ isHide | 应用可见性 | number | 应用可见性,0表示允许用户可见(显示在应用中心), 1表示用户不可见(不显示在应用中心) |
├─ authFreeIp | ip限制 | object[] | 当authFreeIp为空数组且enableAuthFree为1时,表示全部IP免认证; 当authFreeIp为非空数组且enableAuthFree为1时,表示指定IP免认证; |
├─ pathList | 访问路径范围 | object [] | 访问路径范围 |
├─├─ desc | 描述 | string | 描述 |
├─├─ path | 路径 | string | 路径 |
├─ excludePathStatus | 排除路径范围启用状态 | number | 排除路径范围启用状态,1表示启用,0表示禁用 |
├─ excludePathList | 排除路径范围 | object [] | 排除路径范围 |
├─├─ desc | 描述 | string | 描述 |
├─├─ path | 路径 | string | 路径 |
├─ enableLoadBalance | 是否启用负载均衡 | number | 是否启用负载均衡,1表示启用,0表示禁用 |
├─ macOpenModel | mac平台打开方式 | string | mac平台打开方式,默认为"default-browser" |
├─ linuxOpenModel | linux平台打开方式 | string | linux平台打开方式,默认为"default-browser" |
├─ windowsOpenModel | windows打开方式 | string | windows打开方式,默认为"default-browser" |
├─ watermarkEnable | 是否开启水印 | number | 是否开启水印,1表示启用,0表示禁用 |
├─ enableTCPPrefL3 | 是否开启隧道长连接 | boolean | 是否开启隧道长连接,1表示启用,0表示禁用 |
msg | 描述信息 | string | 描述信息 |
traceId | 调用链id | string |
返回示例
{
"code": "OK",
"data": {
"id": "4cffbdb0-daf7-11ee-99c1-ad5ce62be579",
"name": "web1",
"description": "testaaa",
"accessModel": "WEB",
"subModel": "WEB",
"groupId": "default",
"groupName": "默认分类",
"nodeGroupId": "162a5d3c-2266-4643-9c50-c5e619fa7e6e",
"excludeAddress": {
"status": 0,
"excludeAddressList": []
},
"appAddress": "https://1.2.3.4",
"accessAddress": "https://test.com",
"accessEntry": "https://test.com/客服体系/专家中心/零信任专家组",
"status": 1,
"allowApply": 1,
"iconId": "1",
"iconPath": "/portal/preset_icon/batch333_000.png",
"iconType": "font",
"enableAuthFree": 1,
"trustedCertId": "default",
"trustedCertName": "内置web应用证书(国际密码标准)",
"isHide": 0,
"authFreeIp": [],
"pathList": [
{
"desc": "heihei",
"path": "/客服体系/专家中心/*"
}
],
"excludePathStatus": 1,
"excludePathList": [
{
"desc": "paichu范围",
"path": "/客服体系/专家中心/零信任专家组/d"
}
],
"enableLoadBalance": 0,
"macOpenModel": "default-browser",
"linuxOpenModel": "default-browser",
"windowsOpenModel": "default-browser",
"watermarkEnable": 1,
"enableTCPPrefL3": false
},
"msg": "请求成功",
"traceId": "00302c8803d10172"
}
错误码