相关文章推荐
谦和的苦瓜  ·  Word JavaScript API ...·  1 年前    · 
打篮球的匕首  ·  MongoDB:12-MongoDB ...·  1 年前    · 

查询服务器的端口资产的资产指纹信息。

调试

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

调试
调试

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用 全部资源 表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 访问级别 资源类型 条件关键字 关联操作
yundun-sas:DescribePropertyPortDetail Read
  • 全部资源
    acs:yundun-sas:*:{#accountId}:*

请求参数

名称 类型 必填 描述 示例值
Remark string

要查询的服务器的名称或 IP 地址。

192.168.XX.XX
Port string

要查询的服务器的监听端口号。

22
ProcName string

服务器进程的名称。

sshd
Uuid string

要查询的服务器的 UUID。

50d213b4-3a35-427a-b8a5-04b0c7e1****
CurrentPage integer

设置从返回结果的第几页开始显示查询结果。默认值为 1 ,表示从第 1 页开始显示。

1
PageSize integer

设置分页查询时,每页显示的端口资产的指纹信息的数量。默认值为 10 ,表示每页显示 10 条端口资产的指纹信息。

10
BindIp string

端口绑定 IP。

0.0.XX.XX
Extend string

端口号是否支持模糊查询。要设置支持模糊查询时,请将该参数的取值设置为 1 ,其他值或取值为空则表示不支持模糊查询。

1
ResourceDirectoryAccountId long

资源目录成员账号主账号 ID。

调用 DescribeMonitorAccounts 接口可以获取该参数。
127608589417****

返回参数

名称 类型 描述 示例值
object
RequestId string

本次调用请求的 ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

0FA7F1F4-488D-52CA-9BFC-3E47793B49D1
PageInfo object

查询结果页面显示的信息。

CurrentPage integer

分页查询时,当前页的页码。

1
PageSize integer

分页查询时,每页显示的端口资产的指纹信息的数量。默认值为 10 ,表示每页显示 10 条端口资产的指纹信息。

10
TotalCount integer

查询到的端口资产的指纹信息的总数量。

1
Count integer

当前页面显示的账户资产的指纹信息的数量

1
Propertys object []

查询到的端口资产的指纹信息的详情列表。

InternetIp string

服务器的公网 IP 地址。

192.168.XX.XX
Pid string

监听端口对应服务器的运行进程的标识符。

522
BindIp string

端口绑定 IP。

0.0.X.X
Ip string

监听端口绑定的网卡的 IP。

192.168.XX.XX
ProcName string

服务器进程的名称。

sshd
InstanceId string

服务器的实例 ID。

i-hp35tftuh52wbp1g****
Port string

监听端口。

22
IntranetIp string

服务器的私网 IP 地址。

100.104.XX.XX
Uuid string

服务器的 UUID。

162eb349-c2d9-4f8b-805c-75b43d4c****
InstanceName string

服务器实例的名称。

hc-host-****
Proto string

监听端口使用的网络协议。

tcp
CreateTimestamp long

资产指纹的最新扫描的时间戳。单位为毫秒。

1649149566000

示例

正常返回示例

JSON 格式

{
  "RequestId": "0FA7F1F4-488D-52CA-9BFC-3E47793B49D1",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 10,
    "TotalCount": 1,
    "Count": 1
  "Propertys": [
      "InternetIp": "192.168.XX.XX",
      "Pid": "522",
      "BindIp": "0.0.X.X",
      "Ip": "192.168.XX.XX",
      "ProcName": "sshd",
      "InstanceId": "i-hp35tftuh52wbp1g****",
      "Port": "22",
      "IntranetIp": "100.104.XX.XX",
      "Uuid": "162eb349-c2d9-4f8b-805c-75b43d4c****",
      "InstanceName": "hc-host-****",
      "Proto": "tcp",
      "CreateTimestamp": 1649149566000
}

错误码

HTTP status code 错误码 错误信息 描述
400 IllegalParam Illegal param 无效参数
400 RdCheckNoPermission Resource directory account verification has no permission. 资源目录账号校验无权限。
403 NoPermission caller has no permission 当前操作未被授权,请联系主账号在RAM控制台进行授权后再执行操作。
500 RdCheckInnerError Resource directory account service internal error. 资源目录账号服务内部错误。
500 ServerError ServerError 服务故障,请稍后重试!

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

变更历史

变更时间 变更内容概要 操作
2023-11-14 OpenAPI 错误码发生变更、OpenAPI 入参发生变更 看变更集
变更项 变更内容
错误码 OpenAPI 错误码发生变更
    错误码 400 变更
    新增错误码:500
入参 OpenAPI 入参发生变更
    新增入参:ResourceDirectoryAccountId
2022-01-05 OpenAPI 错误码发生变更、OpenAPI 入参发生变更 看变更集
变更项 变更内容
错误码 OpenAPI 错误码发生变更
    新增错误码:400
入参 OpenAPI 入参发生变更
    新增入参:BindIp