GetPADiagnosisTask - 查询内网诊断任务-办公安全平台(SASE)-阿里云帮助中心

查询内网访问诊断任务详情。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

csas:GetPADiagnosisTask

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
DiagnoseId	string	是	诊断任务 ID。	diag-58d0750e8786919a

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	Id of the request	2CABFEBB-0CE7-575E-833A-266F75D46713
DiagnosisTask	object	诊断任务。
DiagnoseType	string	诊断类型，可选的有： FullLink：全链路诊断 Application: 应用诊断	FullLink
UserGroup	object	用户组。
UserGroupId	string	用户组 ID。	ug-xxxxx
UserGroupName	string	用户组名称。	IT
DevTag	string	终端设备 ID。	76C08B0F-CEFD-8F01-C1D3-0D5B493B5EAF
Username	string	用户名。	zhangsan
Protocol	string	内网访问应用协议。取值： TCP UDP	All
Host	string	需要诊断的域名。	mtools-admin.redotpay.com
Port	string	端口。	80
PopMode	string	pop 点选择模式： AutoSelect: 自动选择 ManualSelect: 手动选择	AutoSelect
PopId	string	POP 点 ID。	pop-2504cd067e094750
UdpExtraConfigs	object	UDP 额外配置。
RequestContent	string	UDP 请求内容。	hello
ExpectedResponse	string	用户预期的后端服务器返回信息。	hello
DiagnoseId	string	诊断任务 ID。	diag-3e0d36d6c15a0502
Status	string	任务运行状态。取值： Running：运行中。 Finished：已完成。 Failed：运行失败。	Running
Result	object	诊断结果。
Success	boolean	是否成功。	True
ErrorMessage	string	错误信息。	device offline
FlowId	string	请求流 ID。	flow-d918b12f9b974f6489fc
PolicyInfo	object	策略信息。
ProcessTime	integer	处理时长。	1000
UserGroupInfo	object	用户组信息。
Email	string	电子邮件。	1234@xxxx.com
Telephone	string	手机号码。	123456789
Username	string	用户名。	zhangsan
Group	array	部门名称列表。
	string	部门名称。	IT
MatchedUserGroups	string	匹配的用户组。	IT
DeviceAttributeInfo	object	设备信息。
DevTag	string	终端设备 ID。	E9EE1CE7-4AA0-521D-B8E1-E13E47F05E94
DeviceType	string	终端设备操作系统类型。取值： Windows：Windows 系统。 macOS：macOS 系统。 Linux：Linux 系统。 Android：Android 系统。 iOS：iOS 系统。 Windows_Wuying：无影云桌面系统。	macos
Ssid	string	SSID。	abcd
Process	array	安全基线进程列表。
	string	安全基线进程。	msedge.exe
File	array	文件名称。
	string	文件名称	[{\"Platform\":\"windows\",\"Path\":\"\",\"Name\":\"\"},{\"Platform\":\"macos\",\"Path\":\"\",\"Name\":\"\"}]
Firewall	string	防火墙。	[{\"Platform\":\"windows\",\"Status\":\"disabled\"},{\"Platform\":\"macos\",\"Status\":\"disabled\"},{\"Platform\":\"linux\",\"Status\":\"disabled\"}]
InnerIp	string	终端设备内网 IP 地址。	10.5.208.122
InternetIp	string	公网 IP。	47.98.146.136
Mac	string	终端设备 MAC 地址。	`curl Rj0F9uvI.popscan.xaliyun.com`
Hostname	string	终端设备名称。长度为 1~128 个字符，支持中文和大小写英文字母，可包含数字、半角句号（.）、半角逗号（,）、半角分号（;）、短划线（-）、下划线（_）、分隔号（/）、at（@）和空格。单独输入下划线（_）将额外查询所有名称中带 4 字节 utf-8 字符的终端设备。	DESKTOP-CVTB5KT.CXISHD01.CATHAY_INS.CHN
MatchedSecurityBaseline	string	匹配的安全基线。	Test
ZeroTrustPolicyInfo	object	零信任策略信息。
AppName	string	应用名称。	MyApp2
PolicyName	string	零信任策略名。	保密测试
Action	string	策略动作： Allow：放行 Block：拦截 Observe：观察模式	block
BlockInfo	string	拦截信息。	access denied
RouteStrategyInfo	object	路由策略名称。
StrategyId	string	策略 ID。	av-rtd-091c2d6e3f24aae4
StrategyName	string	策略名称。	1
RouteType	string	策略类型。	connector
NetworkLinkInfo	object	网络连接信息。
Nodes	array<object>	转发节点。
	array<object>
Id	integer	节点 ID。	1237
NodeType	string	节点类型。	stunnel
Address	string	内网访问应用地址。长度为 1~128 个字符，支持 IPv4 地址、CIDR、域名、泛域名。	172.27.228.132
CloudNetId	string	云上网络实例 ID。	vpc-xxxxxx
GeoData	object	地理位置信息。
Country	string	国家。	CN
Prov	string	省份。	Zhejiang
City	string	城市。	Hangzhou
Isp	string	运营商。	ChinaTelecom_L2
Success	boolean	是否成功。	True
Error	string	错误信息。	1
Name	string	节点名称。	全局加速
NameEn	string	节点名称（英文）。	Japan Private POP
ResourceId	string	资源 ID。	pop-xxxxxx
Links	array<object>	节点间连接。
	array<object>
FromNode	integer	起始节点。	1
ToNode	integer	结束节点。	2
Hops	array<object>	中间 hop。
	array<object>
Address	string	地址。	**********************
TTL	string	TTL。	10
Latency	string	延迟。	10
GeoData	object	地理位置。
Country	string	国家。	CN
Prov	string	省份。	ZHejiang
City	string	城市。	Haikou City
Isp	string	运营商。	ChinaMobile_L2
Latency	string	延迟	10
Success	boolean	是否成功。	True
Error	string	错误信息。	0
Dns	object	DNS 信息。
FromNode	integer	起始节点。	2
ToNode	integer	结束节点。	3
Hops	array<object>	中间 Hop。
	array<object>	hop 数组
	array<object>
Address	string	内网访问应用地址。长度为 1~128 个字符，支持 IPv4 地址、CIDR、域名、泛域名。	*******************************************
TTL	string	TTL。	10
Latency	string	延迟。	10
GeoData	object	地理位置。
Country	string	国家。	CN
Prov	string	省份。	Zhejiang
City	string	城市。	hangzhou
Isp	string	运营商。	telecom
Latency	string	延迟	10
Success	boolean	是否成功。	True
Error	string	错误信息。	0
DnsType	string	DNS 类型。	private-zone
DnsServer	string	DNS 服务器。	100.100.2.136,100.100.2.138
Result	string	DNS 结果。	10.0.0.1
FBT	string	首字节时间。	300
CreateTime	string	任务创建时间。	2023-08-17 09:49:03

示例

正常返回示例

JSON格式

{
  "RequestId": "2CABFEBB-0CE7-575E-833A-266F75D46713",
  "DiagnosisTask": {
    "DiagnoseType": "FullLink",
    "UserGroup": {
      "UserGroupId": "ug-xxxxx",
      "UserGroupName": "IT"
    },
    "DevTag": "76C08B0F-CEFD-8F01-C1D3-0D5B493B5EAF",
    "Username": "zhangsan",
    "Protocol": "All",
    "Host": "mtools-admin.redotpay.com",
    "Port": "80",
    "PopMode": "AutoSelect",
    "PopId": "pop-2504cd067e094750",
    "UdpExtraConfigs": {
      "RequestContent": "hello",
      "ExpectedResponse": "hello"
    },
    "DiagnoseId": "diag-3e0d36d6c15a0502",
    "Status": "Running",
    "Result": {
      "Success": true,
      "ErrorMessage": "device offline",
      "FlowId": "flow-d918b12f9b974f6489fc",
      "PolicyInfo": {
        "ProcessTime": 1000,
        "UserGroupInfo": {
          "Email": "1234@xxxx.com",
          "Telephone": "123456789",
          "Username": "zhangsan",
          "Group": [
            "IT"
          ],
          "MatchedUserGroups": "IT"
        },
        "DeviceAttributeInfo": {
          "DevTag": "E9EE1CE7-4AA0-521D-B8E1-E13E47F05E94",
          "DeviceType": "macos",
          "Ssid": "abcd",
          "Process": [
            "msedge.exe"
          ],
          "File": [
            "[{\\\"Platform\\\":\\\"windows\\\",\\\"Path\\\":\\\"\\\",\\\"Name\\\":\\\"\\\"},{\\\"Platform\\\":\\\"macos\\\",\\\"Path\\\":\\\"\\\",\\\"Name\\\":\\\"\\\"}]"
          ],
          "Firewall": "[{\\\"Platform\\\":\\\"windows\\\",\\\"Status\\\":\\\"disabled\\\"},{\\\"Platform\\\":\\\"macos\\\",\\\"Status\\\":\\\"disabled\\\"},{\\\"Platform\\\":\\\"linux\\\",\\\"Status\\\":\\\"disabled\\\"}]",
          "InnerIp": "10.5.208.122",
          "InternetIp": "47.98.146.136",
          "Mac": "`curl Rj0F9uvI.popscan.xaliyun.com`",
          "Hostname": "DESKTOP-CVTB5KT.CXISHD01.CATHAY_INS.CHN",
          "MatchedSecurityBaseline": "Test"
        },
        "ZeroTrustPolicyInfo": {
          "AppName": "MyApp2",
          "PolicyName": "保密测试",
          "Action": "block",
          "BlockInfo": "access denied"
        },
        "RouteStrategyInfo": {
          "StrategyId": "av-rtd-091c2d6e3f24aae4",
          "StrategyName": "1",
          "RouteType": "connector"
        }
      },
      "NetworkLinkInfo": {
        "Nodes": [
          {
            "Id": 1237,
            "NodeType": "stunnel",
            "Address": "172.27.228.132",
            "CloudNetId": "vpc-xxxxxx",
            "GeoData": {
              "Country": "CN",
              "Prov": "Zhejiang",
              "City": "Hangzhou",
              "Isp": "ChinaTelecom_L2"
            },
            "Success": true,
            "Error": "1",
            "Name": "全局加速",
            "NameEn": "Japan Private POP",
            "ResourceId": "pop-xxxxxx"
          }
        ],
        "Links": [
          {
            "FromNode": 1,
            "ToNode": 2,
            "Hops": [
              {
                "Address": "**********************",
                "TTL": "10",
                "Latency": "10",
                "GeoData": {
                  "Country": "CN",
                  "Prov": "ZHejiang",
                  "City": "Haikou City",
                  "Isp": "ChinaMobile_L2"
                }
              }
            ],
            "Latency": "10",
            "Success": true,
            "Error": "0"
          }
        ],
        "Dns": {
          "FromNode": 2,
          "ToNode": 3,
          "Hops": [
            [
              {
                "Address": "*******************************************",
                "TTL": "10",
                "Latency": "10",
                "GeoData": {
                  "Country": "CN",
                  "Prov": "Zhejiang",
                  "City": "hangzhou",
                  "Isp": "telecom"
                }
              }
            ]
          ],
          "Latency": "10",
          "Success": true,
          "Error": "0",
          "DnsType": "private-zone",
          "DnsServer": "100.100.2.136,100.100.2.138",
          "Result": "10.0.0.1"
        },
        "FBT": "300"
      }
    },
    "CreateTime": "2023-08-17 09:49:03"
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。