seaweedfs/weed/pb/master.proto

317 lines
7.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 {
rpc SendHeartbeat (stream Heartbeat) returns (stream HeartbeatResponse) {
}
rpc SubscribeVolumeLocationUpdates (stream SubscribeVolumeLocationUpdatesRequest) returns (stream VolumeLocation) {
2018-07-27 08:54:45 +00:00
}
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) {
}
2019-03-18 03:27:08 +00:00
rpc VolumeList (VolumeListRequest) returns (VolumeListResponse) {
}
rpc LookupEcVolume (LookupEcVolumeRequest) returns (LookupEcVolumeResponse) {
}
2020-11-29 07:18:02 +00:00
rpc VacuumVolume (VacuumVolumeRequest) returns (VacuumVolumeResponse) {
}
2019-06-23 22:29:49 +00:00
rpc GetMasterConfiguration (GetMasterConfigurationRequest) returns (GetMasterConfigurationResponse) {
}
rpc ListClusterNodes (ListClusterNodesRequest) returns (ListClusterNodesResponse) {
}
rpc LeaseAdminToken (LeaseAdminTokenRequest) returns (LeaseAdminTokenResponse) {
}
rpc ReleaseAdminToken (ReleaseAdminTokenRequest) returns (ReleaseAdminTokenResponse) {
}
2017-01-10 09:01:12 +00:00
}
//////////////////////////////////////////////////
message Heartbeat {
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;
2019-04-20 18:35:20 +00:00
// delta volumes
repeated VolumeShortInformationMessage new_volumes = 10;
repeated VolumeShortInformationMessage deleted_volumes = 11;
2019-06-05 20:32:33 +00:00
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;
2019-06-05 20:32:33 +00:00
bool has_no_ec_shards = 19;
2021-02-16 10:47:02 +00:00
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 {
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 {
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;
2020-12-14 07:08:21 +00:00
string disk_type = 15;
}
2019-04-20 18:35:20 +00:00
message VolumeShortInformationMessage {
uint32 id = 1;
string collection = 3;
uint32 replica_placement = 8;
2019-04-21 06:53:37 +00:00
uint32 version = 9;
2019-04-20 18:35:20 +00:00
uint32 ttl = 10;
2020-12-14 07:08:21 +00:00
string disk_type = 15;
2019-04-20 18:35:20 +00:00
}
message VolumeEcShardInformationMessage {
uint32 id = 1;
string collection = 2;
uint32 ec_index_bits = 3;
2021-02-16 10:47:02 +00:00
string disk_type = 4;
}
message StorageBackend {
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 {
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 SubscribeVolumeLocationUpdatesRequest {
string client_type = 1;
string client_address = 3;
string version = 4;
}
2018-07-27 08:54:45 +00:00
message VolumeLocation {
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
2020-11-11 23:10:06 +00:00
string data_center = 6; // optional when DataCenter is in use
uint32 grpc_port = 7;
2018-07-27 08:54:45 +00:00
}
message LookupVolumeRequest {
2021-08-13 04:40:33 +00:00
repeated string volume_or_file_ids = 1;
string collection = 2; // optional, a bit faster if provided.
}
message LookupVolumeResponse {
message VolumeIdLocation {
2021-08-13 04:40:33 +00:00
string volume_or_file_id = 1;
repeated Location locations = 2;
string error = 3;
2021-08-13 04:40:33 +00:00
string auth = 4;
}
repeated VolumeIdLocation volume_id_locations = 1;
}
message Location {
string url = 1;
string public_url = 2;
uint32 grpc_port = 3;
}
message AssignRequest {
uint64 count = 1;
string replication = 2;
string collection = 3;
string ttl = 4;
string data_center = 5;
string rack = 6;
string data_node = 7;
2019-10-22 05:57:01 +00:00
uint32 memory_map_max_size_mb = 8;
2019-11-10 20:05:45 +00:00
uint32 Writable_volume_count = 9;
2020-12-14 07:08:21 +00:00
string disk_type = 10;
}
message AssignResponse {
string fid = 1;
uint64 count = 4;
string error = 5;
2019-02-15 08:09:19 +00:00
string auth = 6;
repeated Location replicas = 7;
Location location = 8;
}
message StatisticsRequest {
string replication = 1;
string collection = 2;
string ttl = 3;
2020-12-14 07:08:21 +00:00
string disk_type = 4;
}
message StatisticsResponse {
uint64 total_size = 4;
uint64 used_size = 5;
uint64 file_count = 6;
}
//
// collection related
//
message Collection {
string name = 1;
}
message CollectionListRequest {
2019-05-30 16:27:23 +00:00
bool include_normal_volumes = 1;
bool include_ec_volumes = 2;
}
message CollectionListResponse {
repeated Collection collections = 1;
}
message CollectionDeleteRequest {
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 {
string type = 1;
int64 volume_count = 2;
int64 max_volume_count = 3;
int64 free_volume_count = 4;
int64 active_volume_count = 5;
2019-03-18 03:27:08 +00:00
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 {
string id = 1;
map<string, DiskInfo> diskInfos = 2;
uint32 grpc_port = 3;
2019-03-18 03:27:08 +00:00
}
message RackInfo {
string id = 1;
2021-02-16 10:47:02 +00:00
repeated DataNodeInfo data_node_infos = 2;
map<string, DiskInfo> diskInfos = 3;
2019-03-18 03:27:08 +00:00
}
message DataCenterInfo {
string id = 1;
2021-02-16 10:47:02 +00:00
repeated RackInfo rack_infos = 2;
map<string, DiskInfo> diskInfos = 3;
2019-03-18 03:27:08 +00:00
}
message TopologyInfo {
string id = 1;
2021-02-16 10:47:02 +00:00
repeated DataCenterInfo data_center_infos = 2;
map<string, DiskInfo> diskInfos = 3;
2019-03-18 03:27:08 +00:00
}
message VolumeListRequest {
}
message VolumeListResponse {
TopologyInfo topology_info = 1;
2019-05-06 04:17:23 +00:00
uint64 volume_size_limit_mb = 2;
2019-03-18 03:27:08 +00:00
}
message LookupEcVolumeRequest {
uint32 volume_id = 1;
}
message LookupEcVolumeResponse {
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 {
float garbage_threshold = 1;
}
message VacuumVolumeResponse {
}
2019-06-23 22:29:49 +00:00
message GetMasterConfigurationRequest {
}
message GetMasterConfigurationResponse {
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 {
string client_type = 1;
}
message ListClusterNodesResponse {
message ClusterNode {
string address = 1;
string version = 2;
}
repeated ClusterNode cluster_nodes = 1;
}
message LeaseAdminTokenRequest {
int64 previous_token = 1;
int64 previous_lock_time = 2;
2020-05-26 01:39:53 +00:00
string lock_name = 3;
string client_name = 4;
}
message LeaseAdminTokenResponse {
2020-04-23 09:31:04 +00:00
int64 token = 1;
int64 lock_ts_ns = 2;
}
message ReleaseAdminTokenRequest {
int64 previous_token = 1;
int64 previous_lock_time = 2;
2020-05-26 01:39:53 +00:00
string lock_name = 3;
}
message ReleaseAdminTokenResponse {
}