seaweedfs/weed/pb/master.proto

381 lines
8.8 KiB
Protocol Buffer
Raw Normal View History

2017-01-10 09:01:12 +00:00
syntax = "proto3";
2018-05-10 06:11:54 +00:00
package master_pb;
2017-01-10 09:01:12 +00:00
2020-06-20 15:00:25 +00:00
option go_package = "github.com/chrislusf/seaweedfs/weed/pb/master_pb";
2017-01-10 09:01:12 +00:00
//////////////////////////////////////////////////
service Seaweed {
2021-11-06 01:11:40 +00:00
rpc SendHeartbeat (stream Heartbeat) returns (stream HeartbeatResponse) {
}
rpc KeepConnected (stream KeepConnectedRequest) returns (stream KeepConnectedResponse) {
}
rpc LookupVolume (LookupVolumeRequest) returns (LookupVolumeResponse) {
}
rpc Assign (AssignRequest) returns (AssignResponse) {
}
rpc Statistics (StatisticsRequest) returns (StatisticsResponse) {
}
rpc CollectionList (CollectionListRequest) returns (CollectionListResponse) {
}
rpc CollectionDelete (CollectionDeleteRequest) returns (CollectionDeleteResponse) {
}
rpc VolumeList (VolumeListRequest) returns (VolumeListResponse) {
}
rpc LookupEcVolume (LookupEcVolumeRequest) returns (LookupEcVolumeResponse) {
}
rpc VacuumVolume (VacuumVolumeRequest) returns (VacuumVolumeResponse) {
}
rpc GetMasterConfiguration (GetMasterConfigurationRequest) returns (GetMasterConfigurationResponse) {
}
rpc ListClusterNodes (ListClusterNodesRequest) returns (ListClusterNodesResponse) {
}
rpc LeaseAdminToken (LeaseAdminTokenRequest) returns (LeaseAdminTokenResponse) {
}
rpc ReleaseAdminToken (ReleaseAdminTokenRequest) returns (ReleaseAdminTokenResponse) {
}
2022-04-01 23:50:58 +00:00
rpc Ping (PingRequest) returns (PingResponse) {
}
2022-04-06 10:23:53 +00:00
rpc RaftListClusterServers (RaftListClusterServersRequest) returns (RaftListClusterServersResponse) {
}
rpc RaftAddServer (RaftAddServerRequest) returns (RaftAddServerResponse) {
}
rpc RaftRemoveServer (RaftRemoveServerRequest) returns (RaftRemoveServerResponse) {
}
2017-01-10 09:01:12 +00:00
}
//////////////////////////////////////////////////
message Heartbeat {
2021-11-06 01:11:40 +00:00
string ip = 1;
uint32 port = 2;
string public_url = 3;
uint64 max_file_key = 5;
string data_center = 6;
string rack = 7;
uint32 admin_port = 8;
repeated VolumeInformationMessage volumes = 9;
// delta volumes
repeated VolumeShortInformationMessage new_volumes = 10;
repeated VolumeShortInformationMessage deleted_volumes = 11;
bool has_no_volumes = 12;
// erasure coding
repeated VolumeEcShardInformationMessage ec_shards = 16;
// delta erasure coding shards
repeated VolumeEcShardInformationMessage new_ec_shards = 17;
repeated VolumeEcShardInformationMessage deleted_ec_shards = 18;
bool has_no_ec_shards = 19;
map<string, uint32> max_volume_counts = 4;
uint32 grpc_port = 20;
2017-01-10 09:01:12 +00:00
}
2017-01-10 09:01:12 +00:00
message HeartbeatResponse {
2021-11-06 01:11:40 +00:00
uint64 volume_size_limit = 1;
string leader = 2;
string metrics_address = 3;
uint32 metrics_interval_seconds = 4;
repeated StorageBackend storage_backends = 5;
2017-01-10 09:01:12 +00:00
}
message VolumeInformationMessage {
2021-11-06 01:11:40 +00:00
uint32 id = 1;
uint64 size = 2;
string collection = 3;
uint64 file_count = 4;
uint64 delete_count = 5;
uint64 deleted_byte_count = 6;
bool read_only = 7;
uint32 replica_placement = 8;
uint32 version = 9;
uint32 ttl = 10;
uint32 compact_revision = 11;
int64 modified_at_second = 12;
string remote_storage_name = 13;
string remote_storage_key = 14;
string disk_type = 15;
}
2019-04-20 18:35:20 +00:00
message VolumeShortInformationMessage {
2021-11-06 01:11:40 +00:00
uint32 id = 1;
string collection = 3;
uint32 replica_placement = 8;
uint32 version = 9;
uint32 ttl = 10;
string disk_type = 15;
2019-04-20 18:35:20 +00:00
}
message VolumeEcShardInformationMessage {
2021-11-06 01:11:40 +00:00
uint32 id = 1;
string collection = 2;
uint32 ec_index_bits = 3;
string disk_type = 4;
}
message StorageBackend {
2021-11-06 01:11:40 +00:00
string type = 1;
string id = 2;
map<string, string> properties = 3;
}
message Empty {
2017-01-10 09:01:12 +00:00
}
2018-06-24 22:19:57 +00:00
message SuperBlockExtra {
2021-11-06 01:11:40 +00:00
message ErasureCoding {
uint32 data = 1;
uint32 parity = 2;
repeated uint32 volume_ids = 3;
}
ErasureCoding erasure_coding = 1;
2018-06-24 22:19:57 +00:00
}
2018-07-27 08:54:45 +00:00
message KeepConnectedRequest {
2021-11-06 01:11:40 +00:00
string client_type = 1;
string client_address = 3;
string version = 4;
2022-05-02 04:59:16 +00:00
string filer_group = 5;
}
2018-07-27 08:54:45 +00:00
message VolumeLocation {
2021-11-06 01:11:40 +00:00
string url = 1;
string public_url = 2;
repeated uint32 new_vids = 3;
repeated uint32 deleted_vids = 4;
string leader = 5; // optional when leader is not itself
string data_center = 6; // optional when DataCenter is in use
uint32 grpc_port = 7;
repeated uint32 new_ec_vids = 8;
repeated uint32 deleted_ec_vids = 9;
2021-11-06 01:11:40 +00:00
}
message ClusterNodeUpdate {
string node_type = 1;
string address = 2;
bool is_leader = 3;
bool is_add = 4;
2022-05-02 04:59:16 +00:00
string filer_group = 5;
2021-11-06 01:11:40 +00:00
}
message KeepConnectedResponse {
VolumeLocation volume_location = 1;
ClusterNodeUpdate cluster_node_update = 2;
2018-07-27 08:54:45 +00:00
}
message LookupVolumeRequest {
2021-11-06 01:11:40 +00:00
repeated string volume_or_file_ids = 1;
string collection = 2; // optional, a bit faster if provided.
}
message LookupVolumeResponse {
2021-11-06 01:11:40 +00:00
message VolumeIdLocation {
string volume_or_file_id = 1;
repeated Location locations = 2;
string error = 3;
string auth = 4;
}
repeated VolumeIdLocation volume_id_locations = 1;
}
message Location {
2021-11-06 01:11:40 +00:00
string url = 1;
string public_url = 2;
uint32 grpc_port = 3;
}
message AssignRequest {
2021-11-06 01:11:40 +00:00
uint64 count = 1;
string replication = 2;
string collection = 3;
string ttl = 4;
string data_center = 5;
string rack = 6;
string data_node = 7;
uint32 memory_map_max_size_mb = 8;
uint32 Writable_volume_count = 9;
string disk_type = 10;
}
message AssignResponse {
2021-11-06 01:11:40 +00:00
string fid = 1;
uint64 count = 4;
string error = 5;
string auth = 6;
repeated Location replicas = 7;
Location location = 8;
}
message StatisticsRequest {
2021-11-06 01:11:40 +00:00
string replication = 1;
string collection = 2;
string ttl = 3;
string disk_type = 4;
}
message StatisticsResponse {
2021-11-06 01:11:40 +00:00
uint64 total_size = 4;
uint64 used_size = 5;
uint64 file_count = 6;
}
//
// collection related
//
message Collection {
2021-11-06 01:11:40 +00:00
string name = 1;
}
message CollectionListRequest {
2021-11-06 01:11:40 +00:00
bool include_normal_volumes = 1;
bool include_ec_volumes = 2;
}
message CollectionListResponse {
2021-11-06 01:11:40 +00:00
repeated Collection collections = 1;
}
message CollectionDeleteRequest {
2021-11-06 01:11:40 +00:00
string name = 1;
}
message CollectionDeleteResponse {
}
2019-03-18 03:27:08 +00:00
//
// volume related
//
2021-02-16 10:47:02 +00:00
message DiskInfo {
2021-11-06 01:11:40 +00:00
string type = 1;
int64 volume_count = 2;
int64 max_volume_count = 3;
int64 free_volume_count = 4;
int64 active_volume_count = 5;
repeated VolumeInformationMessage volume_infos = 6;
repeated VolumeEcShardInformationMessage ec_shard_infos = 7;
int64 remote_volume_count = 8;
2021-02-16 10:47:02 +00:00
}
message DataNodeInfo {
2021-11-06 01:11:40 +00:00
string id = 1;
map<string, DiskInfo> diskInfos = 2;
uint32 grpc_port = 3;
2019-03-18 03:27:08 +00:00
}
message RackInfo {
2021-11-06 01:11:40 +00:00
string id = 1;
repeated DataNodeInfo data_node_infos = 2;
map<string, DiskInfo> diskInfos = 3;
2019-03-18 03:27:08 +00:00
}
message DataCenterInfo {
2021-11-06 01:11:40 +00:00
string id = 1;
repeated RackInfo rack_infos = 2;
map<string, DiskInfo> diskInfos = 3;
2019-03-18 03:27:08 +00:00
}
message TopologyInfo {
2021-11-06 01:11:40 +00:00
string id = 1;
repeated DataCenterInfo data_center_infos = 2;
map<string, DiskInfo> diskInfos = 3;
2019-03-18 03:27:08 +00:00
}
message VolumeListRequest {
}
message VolumeListResponse {
2021-11-06 01:11:40 +00:00
TopologyInfo topology_info = 1;
uint64 volume_size_limit_mb = 2;
2019-03-18 03:27:08 +00:00
}
message LookupEcVolumeRequest {
2021-11-06 01:11:40 +00:00
uint32 volume_id = 1;
}
message LookupEcVolumeResponse {
2021-11-06 01:11:40 +00:00
uint32 volume_id = 1;
message EcShardIdLocation {
uint32 shard_id = 1;
repeated Location locations = 2;
}
repeated EcShardIdLocation shard_id_locations = 2;
}
2019-06-23 22:29:49 +00:00
2020-11-29 07:18:02 +00:00
message VacuumVolumeRequest {
2021-11-06 01:11:40 +00:00
float garbage_threshold = 1;
uint32 volume_id = 2;
string collection = 3;
2020-11-29 07:18:02 +00:00
}
message VacuumVolumeResponse {
}
2019-06-23 22:29:49 +00:00
message GetMasterConfigurationRequest {
}
message GetMasterConfigurationResponse {
2021-11-06 01:11:40 +00:00
string metrics_address = 1;
uint32 metrics_interval_seconds = 2;
repeated StorageBackend storage_backends = 3;
string default_replication = 4;
string leader = 5;
uint32 volume_size_limit_m_b = 6;
bool volume_preallocate = 7;
2019-06-23 22:29:49 +00:00
}
message ListClusterNodesRequest {
2021-11-06 01:11:40 +00:00
string client_type = 1;
2022-05-02 04:59:16 +00:00
string filer_group = 2;
}
message ListClusterNodesResponse {
2021-11-06 01:11:40 +00:00
message ClusterNode {
string address = 1;
string version = 2;
2021-11-06 21:23:35 +00:00
bool is_leader = 3;
2021-11-06 01:11:40 +00:00
}
repeated ClusterNode cluster_nodes = 1;
}
message LeaseAdminTokenRequest {
2021-11-06 01:11:40 +00:00
int64 previous_token = 1;
int64 previous_lock_time = 2;
string lock_name = 3;
string client_name = 4;
2021-12-10 21:24:38 +00:00
string message = 5;
}
message LeaseAdminTokenResponse {
2021-11-06 01:11:40 +00:00
int64 token = 1;
int64 lock_ts_ns = 2;
}
message ReleaseAdminTokenRequest {
2021-11-06 01:11:40 +00:00
int64 previous_token = 1;
int64 previous_lock_time = 2;
string lock_name = 3;
}
message ReleaseAdminTokenResponse {
}
2022-04-01 23:50:58 +00:00
message PingRequest {
string target = 1; // default to ping itself
string target_type = 2;
}
message PingResponse {
2022-04-16 19:45:49 +00:00
int64 start_time_ns = 1;
int64 remote_time_ns = 2;
int64 stop_time_ns = 3;
2022-04-01 23:50:58 +00:00
}
2022-04-06 10:23:53 +00:00
message RaftAddServerRequest {
string id = 1;
string address = 2;
bool voter = 3;
}
message RaftAddServerResponse {
}
message RaftRemoveServerRequest {
string id = 1;
2022-04-07 10:31:37 +00:00
bool force = 2;
2022-04-06 10:23:53 +00:00
}
message RaftRemoveServerResponse {
}
message RaftListClusterServersRequest {
}
message RaftListClusterServersResponse {
message ClusterServers {
string id = 1;
string address = 2;
string suffrage = 3; //
}
repeated ClusterServers cluster_servers = 1;
2022-04-16 19:45:49 +00:00
}