DescribeTerminalSessions - 查看Session Manager会话历史记录

查看Session Manager会话历史记录。

接口说明

支持查看 4 周内创建的 Session Manager 会话记录。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	地域 ID。	cn-hangzhou
InstanceId	string	否	实例 ID。	i-bp1i7gg30r52z2em****
SessionId	string	否	会话 ID。	s-hz023od0x9****
MaxResults	integer	否	分页查询时每页的最大条目数。最大值为 100。默认值为 10。	10
NextToken	string	否	查询凭证（Token），取值为上一次 API 调用返回的 NextToken 参数值。	AAAAAdDWBF2****

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
NextToken	string	本次调用返回的查询凭证值。	AAAAAdDWBF2****
Sessions	object []	会话列表。
CreationTime	string	会话的创建时间。	2024-01-19T09:15:46Z
TargetServer	string	通过实例访问 VPC 内的目标服务地址。	192.168.0.246
PortNumber	integer	ECS 实例的端口号，用于数据转发。若未设置数据转发的端口号，则该值为空。	22
PrincipalId	string	身份标识。按照身份类型`IdentityType`，取值如下：当前调用者是阿里云账号：返回阿里云账号 ID。当前调用者是 RAM 用户：返回 RAM 用户 ID。当前调用者是角色扮演：返回角色扮演实际委托人 ID。	123456xxxx
Username	string	连接时的用户名。	root
ClientIP	string	远程连接的客户 IP。	192.168.1.1
IdentityType	string	身份类型。当前支持的身份类型包括： Account：阿里云账号（主账号）。 RAMUser：RAM 用户。 AssumedRoleUser：RAM 角色。	RAMUser
SessionId	string	会话 ID。	s-hz023od0x9****
Connections	object []	连接信息列表。
ClosedReason	string	连接结束原因。仅在状态（`Status`）为`Disconnected`、`Terminated`、`Failed`时返回该参数。可能值： InstanceNotExists：指定的实例不存在或已释放。 InstanceNotRunning：该实例不在运行中。 DeliveryTimeout：连接超时。 AgentNeedUpgrade：云助手 Agent 需要升级。 AgentNotOnline：云助手 Agent 未连接到服务器。 MessageFormatInvalid：消息格式不合法。 AgentSocketClosed：连接正常关闭。 ClientClosed：会话管理客户端关闭了连接。	AgentNeedUpgrade
EndTime	string	连接结束时间。	2024-01-19T09:16:46Z
Status	string	会话状态，可能值： Connecting：连接中。 Connected：已连接。 Disconnected：连接断开。 Terminating：会话终止中。 Terminated：会话已终止。 Failed：连接失败。	Connecting
StartTime	string	连接开始时间。	2024-01-19T09:16:40Z
InstanceId	string	实例 ID。	i-bp1i7gg30r52z2em****

示例

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "NextToken": "AAAAAdDWBF2****",
  "Sessions": {
    "Session": [
      {
        "CreationTime": "2024-01-19T09:15:46Z",
        "TargetServer": "192.168.0.246",
        "PortNumber": 22,
        "PrincipalId": "123456xxxx",
        "Username": "root",
        "ClientIP": "192.168.1.1",
        "IdentityType": "RAMUser",
        "SessionId": "s-hz023od0x9****",
        "Connections": {
          "Connection": [
            {
              "ClosedReason": "AgentNeedUpgrade",
              "EndTime": "2024-01-19T09:16:46Z",
              "Status": "Connecting",
              "StartTime": "2024-01-19T09:16:40Z",
              "InstanceId": "i-bp1i7gg30r52z2em****"
            }
          ]
        }
      }
    ]
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameter.NextToken	The specified parameter NextToken is not valid.	指定的参数NextToken不合法。
400	InvalidParameter.MaxResults	The specified parameter MaxResults is not valid.	指定的参数MaxResults不合法。
404	InvalidRegionId.NotFound	The specified parameter RegionId does not exist.	指定的地域ID不存在。
500	InternalError	An error occurred when you dispatched the request.	发送请求时发生错误，请稍后重试。

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