Johan Brandhorst-Satzkorn
b1d6a1da9a
* Install buf with go install This reduces the impact of using buf on our dependency closure, which was significant. It also avoids potential issues with building buf given our own internal dependency constraints. This has caused issues (including crashes!) in the past. See https://github.com/cockroachdb/cockroach/issues/67216#issuecomment-874176186 for more discussion on using tool dependencies generally, and https://github.com/bufbuild/buf/issues/52 for an example of where this sort of thing caused an issue for a user. * Upgrade buf version We should migrate to v1 sooner rather than later, as it has some breaking changes from v0. * Change buf lint/breaking commands These commands were moved up one level for v1 * Migrate to buf.yaml to v1 * Remove unused imports These were uncovered by using "buf lint". * Use buf v1.3.1 * Depend on googleapis and grpc-gateway via BSR * Switch to buf for proto generation * Remove third party dependency * Remove unused tools and scripts * Move local protos up one level * Temporarily don't fail on breaking changes * Generate CI config * Fix generation of controller.json * Replace use of deprecated flag * Remove unused import, regenerate files * Remove temporary skipping over breaking check
116 lines
3.8 KiB
Protocol Buffer
116 lines
3.8 KiB
Protocol Buffer
syntax = "proto3";
|
|
|
|
package controller.api.resources.sessions.v1;
|
|
|
|
option go_package = "github.com/hashicorp/boundary/sdk/pbs/controller/api/resources/sessions;sessions";
|
|
|
|
import "google/protobuf/timestamp.proto";
|
|
import "controller/api/resources/scopes/v1/scope.proto";
|
|
|
|
message WorkerInfo {
|
|
// The address of the worker.
|
|
string address = 10;
|
|
}
|
|
|
|
message SessionState {
|
|
// The status of the Session, e.g. "pending", "active", "canceling", "terminated".
|
|
string status = 10;
|
|
|
|
// Output only. The time the Session entered this state.
|
|
google.protobuf.Timestamp start_time = 20 [json_name = "start_time"];
|
|
|
|
// Output only. The time the Session stopped being in this state.
|
|
google.protobuf.Timestamp end_time = 30 [json_name = "end_time"];
|
|
}
|
|
|
|
// Connection contains information about a specific connection in a session
|
|
message Connection {
|
|
|
|
// client_tcp_address of the connection
|
|
string client_tcp_address = 3;
|
|
|
|
// client_tcp_port of the connection
|
|
uint32 client_tcp_port = 4;
|
|
|
|
// endpoint_tcp_address of the connection
|
|
string endpoint_tcp_address = 5;
|
|
|
|
// endpoint_tcp_port of the connection
|
|
uint32 endpoint_tcp_port = 6;
|
|
|
|
// bytes_up of the connection
|
|
uint64 bytes_up = 7;
|
|
|
|
// bytes_down of the connection
|
|
uint64 bytes_down = 8;
|
|
|
|
// closed_reason of the conneciont
|
|
string closed_reason = 9;
|
|
}
|
|
|
|
// Session contains all fields related to a Session resource
|
|
message Session {
|
|
// Output only. The ID of the Session.
|
|
string id = 10;
|
|
|
|
// Output only. The ID of the Target that created this Session.
|
|
string target_id = 20 [json_name = "target_id"];
|
|
|
|
// Output only. Scope information for this resource.
|
|
resources.scopes.v1.ScopeInfo scope = 30;
|
|
|
|
// Output only. The time this resource was created.
|
|
google.protobuf.Timestamp created_time = 60 [json_name = "created_time"];
|
|
|
|
// Output only. The time this resource was last updated.
|
|
google.protobuf.Timestamp updated_time = 70 [json_name = "updated_time"];
|
|
|
|
// Version is used when canceling this Session to ensure that the operation is acting on a known session state.
|
|
uint32 version = 80;
|
|
|
|
// Output only. Type of the Session (e.g. tcp).
|
|
string type = 90;
|
|
|
|
// Output only. After this time the connection will be expired, e.g. forcefully terminated.
|
|
google.protobuf.Timestamp expiration_time = 100 [json_name = "expiration_time"];
|
|
|
|
// Output only. The ID of the Auth Token used to authenticate.
|
|
string auth_token_id = 110 [json_name = "auth_token_id"];
|
|
|
|
// Output only. The ID of the User that requested the Session.
|
|
string user_id = 120 [json_name = "user_id"];
|
|
|
|
// Output only. The Host Set sourcing the Host for this Session.
|
|
string host_set_id = 130 [json_name = "host_set_id"];
|
|
|
|
// Output only. The Host used by the Session.
|
|
string host_id = 140 [json_name = "host_id"];
|
|
|
|
// Output only. The Scope of the Session.
|
|
string scope_id = 150 [json_name = "scope_id"];
|
|
|
|
// Output only. The endpoint of the Session; that is, the address to which the worker is proxying data.
|
|
string endpoint = 160;
|
|
|
|
// Output only. The states of this Session in descending order from the current state to the first.
|
|
repeated SessionState states = 170;
|
|
|
|
// Output only. The current status of this Session.
|
|
string status = 180;
|
|
|
|
// Output only. Worker information given to the client.
|
|
repeated WorkerInfo worker_info = 190 [json_name = "worker_info"];
|
|
|
|
// Output only. The certificate generated for the session. Raw DER bytes.
|
|
bytes certificate = 200;
|
|
|
|
// Output only. If the session is terminated, this provides a short description as to why.
|
|
string termination_reason = 210 [json_name = "termination_reason"];
|
|
|
|
// Output only. The available actions on this resource for this user.
|
|
repeated string authorized_actions = 300 [json_name="authorized_actions"];
|
|
|
|
// Output only. The associated connections with this session.
|
|
repeated Connection connections = 310;
|
|
}
|