Boundary Controller HTTP API
Session Recording Service
ListSessionRecordings lists all Session recordings. Session recordings are ordered by start_time descending (most recently started first).
Query Parameters
scope_id string The scope in which to list session recordings. Must be set unless recursive is set.
recursive boolean Whether to recurse into child scopes when listing. If set and scope_id is empty, shows session recordings in all scopes the caller has access to.
Successful Response
id string The ID of the Session recording.
id string Output only. The ID of the Scope.
type string Output only. The type of the Scope.
name string Output only. The name of the Scope, if any.
description string Output only. The description of the Scope, if any.
parent_scope_id string Output only. The ID of the parent Scope, if any. This field will be empty if this is the "global" scope.
session_id string The ID of the Session which this Session Recording recorded.
storage_bucket_id string The ID of the Storage Bucket for the Target of this Session Recording.
bytes_up string The total number of bytes uploaded from the client in the Session. This includes all bytes uploaded over all Connections, including any protocol overhead.
bytes_down string The total number of bytes downloaded to the client in the Session. This includes all bytes downloaded over all Connections, including any protocol overhead.
created_time string The time the Session Recording was created in the controller.
updated_time string The time of the most recent update to the Session Recording.
start_time string The time the Session started.
end_time string The time the Session ended.
duration string The total duration of the Session.
type string Type of the Session that was recorded (e.g. ssh).
state string The current state of the session recording. One of "started", "available" and "unknown".
error_details string Any error seen during the closing of the session recording. Currently only set if state is "unknown".
mime_types string[] endpoint string The endpoint of the Session; that is, the address to which the egress worker connected.
id string The ID of the Connection recording.
bytes_up string The total number of bytes uploaded from the client in the Connection. This includes any protocol overhead.
bytes_down string The total number of bytes downloaded to the client in the Connection. This includes any protocol overhead.
created_time string The time the Connection was created in the controller.
updated_time string The time of the most recent update to the Connection.
start_time string The time the Connection started.
end_time string The time the Connection ended.
duration string The total duration of the Connection.
mime_types string[] id string The ID of the Channel recording.
bytes_up string The total number of bytes uploaded from the client in the Channel.
bytes_down string The total number of bytes downloaded to the client in the Channel.
created_time string The time the Channel was created in the controller.
updated_time string The time of the most recent update to the Channel.
start_time string The time the Channel started.
end_time string The time the Channel ended.
duration string The total duration of the Channel.
mime_types string[] id string The ID of the User.
name string The name of the User that created the Session.
description string The description of the User that created the Session.
id string Output only. The ID of the Scope.
type string Output only. The type of the Scope.
name string Output only. The name of the Scope, if any.
description string Output only. The description of the Scope, if any.
parent_scope_id string Output only. The ID of the parent Scope, if any. This field will be empty if this is the "global" scope.
id string The ID of the Target.
name string The name of the Target, if set.
description string The description of the Target, if set.
id string Output only. The ID of the Scope.
type string Output only. The type of the Scope.
name string Output only. The name of the Scope, if any.
description string Output only. The description of the Scope, if any.
parent_scope_id string Output only. The ID of the parent Scope, if any. This field will be empty if this is the "global" scope.
session_max_seconds integer Maximum total lifetime of a created Session, in seconds.
session_connection_limit integer Maximum number of connections allowed in a Session. Unlimited is indicated by the value -1.
worker_filter string Optional boolean expression to filter the workers that are allowed to satisfy this request.
egress_worker_filter string Optional boolean expressions to filter the egress workers that are allowed to satisfy this request.
ingress_worker_filter string Optional boolean expressions to filter the ingress workers that are allowed to satisfy this request.
type string The type of the Target.
attributes object The attributes that are applicable for the specific Target.
id string The ID of the Host
id string The ID of the Host Catalog
id string Output only. The ID of the Scope.
type string Output only. The type of the Scope.
name string Output only. The name of the Scope, if any.
description string Output only. The description of the Scope, if any.
parent_scope_id string Output only. The ID of the parent Scope, if any. This field will be empty if this is the "global" scope.
plugin_id string The plugin id used by this Host Catalog, if any.
name string The name of the Host Catalog, if set
description string The description of the Host Catalog.
type string The type of the Host Catalog. This will be either "static" or "plugin"
attributes object The attributes of the Host Catalog.
name string The name of the Host, if set.
description string The description of the Host, if set.
type string The type of the host. This will be either "static" or "plugin"
attributes object The attributes that are applicable for the specific Host.
external_id string The external id of the Host, if any.
external_name string The external name of the Host, if any.
authorized_actions string[] GetSessionRecording returns a stored Session recording if present. The provided request must include the Session recording ID for the Session recording being retrieved, or the ID of the Session that was recorded. If that ID is missing, malformed or reference a non existing resource, an error is returned.
Path Parameters
id string RequiredRequiredThe ID of the Session recording, or the ID of the Session that was recorded.
Successful Response
id string The ID of the Session recording.
id string Output only. The ID of the Scope.
type string Output only. The type of the Scope.
name string Output only. The name of the Scope, if any.
description string Output only. The description of the Scope, if any.
parent_scope_id string Output only. The ID of the parent Scope, if any. This field will be empty if this is the "global" scope.
session_id string The ID of the Session which this Session Recording recorded.
storage_bucket_id string The ID of the Storage Bucket for the Target of this Session Recording.
bytes_up string The total number of bytes uploaded from the client in the Session. This includes all bytes uploaded over all Connections, including any protocol overhead.
bytes_down string The total number of bytes downloaded to the client in the Session. This includes all bytes downloaded over all Connections, including any protocol overhead.
created_time string The time the Session Recording was created in the controller.
updated_time string The time of the most recent update to the Session Recording.
start_time string The time the Session started.
end_time string The time the Session ended.
duration string The total duration of the Session.
type string Type of the Session that was recorded (e.g. ssh).
state string The current state of the session recording. One of "started", "available" and "unknown".
error_details string Any error seen during the closing of the session recording. Currently only set if state is "unknown".
mime_types string[] endpoint string The endpoint of the Session; that is, the address to which the egress worker connected.
id string The ID of the Connection recording.
bytes_up string The total number of bytes uploaded from the client in the Connection. This includes any protocol overhead.
bytes_down string The total number of bytes downloaded to the client in the Connection. This includes any protocol overhead.
created_time string The time the Connection was created in the controller.
updated_time string The time of the most recent update to the Connection.
start_time string The time the Connection started.
end_time string The time the Connection ended.
duration string The total duration of the Connection.
mime_types string[] id string The ID of the Channel recording.
bytes_up string The total number of bytes uploaded from the client in the Channel.
bytes_down string The total number of bytes downloaded to the client in the Channel.
created_time string The time the Channel was created in the controller.
updated_time string The time of the most recent update to the Channel.
start_time string The time the Channel started.
end_time string The time the Channel ended.
duration string The total duration of the Channel.
mime_types string[] id string The ID of the User.
name string The name of the User that created the Session.
description string The description of the User that created the Session.
id string Output only. The ID of the Scope.
type string Output only. The type of the Scope.
name string Output only. The name of the Scope, if any.
description string Output only. The description of the Scope, if any.
parent_scope_id string Output only. The ID of the parent Scope, if any. This field will be empty if this is the "global" scope.
id string The ID of the Target.
name string The name of the Target, if set.
description string The description of the Target, if set.
id string Output only. The ID of the Scope.
type string Output only. The type of the Scope.
name string Output only. The name of the Scope, if any.
description string Output only. The description of the Scope, if any.
parent_scope_id string Output only. The ID of the parent Scope, if any. This field will be empty if this is the "global" scope.
session_max_seconds integer Maximum total lifetime of a created Session, in seconds.
session_connection_limit integer Maximum number of connections allowed in a Session. Unlimited is indicated by the value -1.
worker_filter string Optional boolean expression to filter the workers that are allowed to satisfy this request.
egress_worker_filter string Optional boolean expressions to filter the egress workers that are allowed to satisfy this request.
ingress_worker_filter string Optional boolean expressions to filter the ingress workers that are allowed to satisfy this request.
type string The type of the Target.
attributes object The attributes that are applicable for the specific Target.
id string The ID of the Host
id string The ID of the Host Catalog
id string Output only. The ID of the Scope.
type string Output only. The type of the Scope.
name string Output only. The name of the Scope, if any.
description string Output only. The description of the Scope, if any.
parent_scope_id string Output only. The ID of the parent Scope, if any. This field will be empty if this is the "global" scope.
plugin_id string The plugin id used by this Host Catalog, if any.
name string The name of the Host Catalog, if set
description string The description of the Host Catalog.
type string The type of the Host Catalog. This will be either "static" or "plugin"
attributes object The attributes of the Host Catalog.
name string The name of the Host, if set.
description string The description of the Host, if set.
type string The type of the host. This will be either "static" or "plugin"
attributes object The attributes that are applicable for the specific Host.
external_id string The external id of the Host, if any.
external_name string The external name of the Host, if any.
authorized_actions string[] Download returns the contents of the specified resource in the specified mime type. Supports both Session ID and Session recording ID for looking up a Session recording. Supports both Connection ID and Connection recording ID to look up a Connection recording. A Channel recording ID is required to look up a Channel recording. The only supported mime type is "application/x-asciicast".
Path Parameters
id string RequiredRequiredThe ID of the resource that should be downloaded. Supported types:
- Session ID and Session recording ID for Session recordings
- Connection ID and Connection recording ID for Connection recordings
- Channel recording ID for Channel recordings
Query Parameters
mime_type string The format of the response. The only supported mime type is "application/x-asciicast". Defaults to "application/x-asciicast" if not set.
Successful Response