Querying Bastion Host File Transfer Records

Updated on 2025-02-10 GMT+08:00

View PDF

Function

Query file transfer records of a bastion host.

URI

GET /v2/servicerequest/authorizations/{authorization_id}/authorization-details/{authorization_detail_id}/sessions/{session_id}/operation-file-logs

**Table 1** Path parameters
Parameter	Mandatory	Type	Description
authorization_id	Yes	String	Specifies the authorization ID. Minimum length: 1 Maximum length: 32
authorization_detail_id	Yes	Long	Specifies the authorization detail ID. Minimum value: 0 Maximum value: 9223372036854775807
session_id	Yes	Long	Specifies the session ID. Minimum value: 0 Maximum value: 9223372036854775807

**Table 2** Query parameters
Parameter	Mandatory	Type	Description
group_id	No	String	Specifies the group ID. Minimum length: 0 Maximum length: 64
sort	No	Integer	1: In ascending order by operation time; 0: In descending order by operation time. The default value is 0. Minimum value: 0 Maximum value: 1 Default value: 0
offset	No	Integer	Specifies the query offset. Minimum value: 0 Maximum value: 65535 Default value: 0
limit	No	Integer	Specifies the limited number of records that can be queried. Minimum value: 1 Maximum value: 100 Default value: 10

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Specifies the user token. It can be obtained by calling the IAM API (value of X-Subject-Token in the response header). Minimum length: 1 Maximum length: 5000
X-Language	No	String	Specifies the language environment. The value is a common language description character string, for example, zh-cn. It is zh-cn by default. Some internationalization information, such as the service ticket type and name, is displayed based on the language environment. Minimum length: 1 Maximum length: 32
X-Time-Zone	No	String	Specifies the time zone. The value is a common time zone description character string, for example, GMT+8. It is GMT+8 by default. Time-related data is processed based on the time zone of the environment. Minimum length: 1 Maximum length: 32

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
total_count	Integer	Specifies the total number. Minimum value: 0 Maximum value: 9223372036854775807
file_ops_list	Array of FileOperateLog objects	Specifies the file record list.

**Table 5** FileOperateLog
Parameter	Type	Description
duration	String	Indicates the transfer time, in hh:ii:ss format. Minimum length: 0 Maximum length: 64
operate_time	String	Indicates the operation time. Minimum length: 0 Maximum length: 64
operate_type	String	Indicates the operation type. Minimum length: 0 Maximum length: 64
file_name	String	Indicates the file name. Minimum length: 0 Maximum length: 512
from_path	String	Indicates the source path. Minimum length: 0 Maximum length: 1024
to_path	String	Indicates the target path. Minimum length: 0 Maximum length: 1024
file_size	String	Indicates the file size, in KB, MB, or GB. Minimum length: 0 Maximum length: 64
oper_result	String	Indicates the operation result. Minimum length: 0 Maximum length: 64

Request Example

None

Example Response

Status code: 200

Response of status code 200

{
  "total_count" : 1,
  "file_ops_list" : [ {
    "duration" : "test",
    "operate_time" : "test",
    "operate_type" : "test",
    "file_name" : "test",
    "from_path" : "test",
    "to_path" : "test",
    "file_size" : "test",
    "oper_result" : "test"
  } ]
}