增加一些API注释

This commit is contained in:
GoEdgeLab
2023-08-06 19:33:45 +08:00
parent b7704886db
commit d80b7ffc36
3 changed files with 32 additions and 32 deletions

View File

@@ -35,9 +35,9 @@ type CreateHTTPCacheTaskRequest struct {
sizeCache protoimpl.SizeCache
unknownFields protoimpl.UnknownFields
Type string `protobuf:"bytes,1,opt,name=type,proto3" json:"type,omitempty"` // 类型清理purge预热fetch
KeyType string `protobuf:"bytes,2,opt,name=keyType,proto3" json:"keyType,omitempty"` // Key类型单个URLkey目录prefix;预热的时候只能为 key
Keys []string `protobuf:"bytes,3,rep,name=keys,proto3" json:"keys,omitempty"` // 要清理的Key
Type string `protobuf:"bytes,1,opt,name=type,proto3" json:"type,omitempty"` // 任务类型,值为 purge 或者 fetchpurge删除缓存fetch预热缓存
KeyType string `protobuf:"bytes,2,opt,name=keyType,proto3" json:"keyType,omitempty"` // Key类型,值为 key 或者 prefix如果是 key 表示处理的是URL如果是 prefix 表示处理的是目录;预热的时候只能为 key
Keys []string `protobuf:"bytes,3,rep,name=keys,proto3" json:"keys,omitempty"` // 要清理的Key根据Key类型keyType来输入不同的内容
}
func (x *CreateHTTPCacheTaskRequest) Reset() {
@@ -98,8 +98,8 @@ type CreateHTTPCacheTaskResponse struct {
sizeCache protoimpl.SizeCache
unknownFields protoimpl.UnknownFields
HttpCacheTaskId int64 `protobuf:"varint,1,opt,name=httpCacheTaskId,proto3" json:"httpCacheTaskId,omitempty"`
CountKeys int64 `protobuf:"varint,2,opt,name=countKeys,proto3" json:"countKeys,omitempty"`
HttpCacheTaskId int64 `protobuf:"varint,1,opt,name=httpCacheTaskId,proto3" json:"httpCacheTaskId,omitempty"` // 生成的任务ID
CountKeys int64 `protobuf:"varint,2,opt,name=countKeys,proto3" json:"countKeys,omitempty"` // 任务中包含的Key
}
func (x *CreateHTTPCacheTaskResponse) Reset() {
@@ -232,7 +232,7 @@ type FindEnabledHTTPCacheTaskRequest struct {
sizeCache protoimpl.SizeCache
unknownFields protoimpl.UnknownFields
HttpCacheTaskId int64 `protobuf:"varint,1,opt,name=httpCacheTaskId,proto3" json:"httpCacheTaskId,omitempty"`
HttpCacheTaskId int64 `protobuf:"varint,1,opt,name=httpCacheTaskId,proto3" json:"httpCacheTaskId,omitempty"` // 任务ID
}
func (x *FindEnabledHTTPCacheTaskRequest) Reset() {
@@ -279,7 +279,7 @@ type FindEnabledHTTPCacheTaskResponse struct {
sizeCache protoimpl.SizeCache
unknownFields protoimpl.UnknownFields
HttpCacheTask *HTTPCacheTask `protobuf:"bytes,1,opt,name=httpCacheTask,proto3" json:"httpCacheTask,omitempty"`
HttpCacheTask *HTTPCacheTask `protobuf:"bytes,1,opt,name=httpCacheTask,proto3" json:"httpCacheTask,omitempty"` // 任务信息
}
func (x *FindEnabledHTTPCacheTaskResponse) Reset() {
@@ -327,8 +327,8 @@ type ListHTTPCacheTasksRequest struct {
sizeCache protoimpl.SizeCache
unknownFields protoimpl.UnknownFields
Offset int64 `protobuf:"varint,1,opt,name=offset,proto3" json:"offset,omitempty"`
Size int64 `protobuf:"varint,2,opt,name=size,proto3" json:"size,omitempty"`
Offset int64 `protobuf:"varint,1,opt,name=offset,proto3" json:"offset,omitempty"` // 查询起始位置
Size int64 `protobuf:"varint,2,opt,name=size,proto3" json:"size,omitempty"` // 查询条数
}
func (x *ListHTTPCacheTasksRequest) Reset() {
@@ -382,7 +382,7 @@ type ListHTTPCacheTasksResponse struct {
sizeCache protoimpl.SizeCache
unknownFields protoimpl.UnknownFields
HttpCacheTasks []*HTTPCacheTask `protobuf:"bytes,1,rep,name=httpCacheTasks,proto3" json:"httpCacheTasks,omitempty"`
HttpCacheTasks []*HTTPCacheTask `protobuf:"bytes,1,rep,name=httpCacheTasks,proto3" json:"httpCacheTasks,omitempty"` // 一组任务信息
}
func (x *ListHTTPCacheTasksResponse) Reset() {
@@ -430,7 +430,7 @@ type DeleteHTTPCacheTaskRequest struct {
sizeCache protoimpl.SizeCache
unknownFields protoimpl.UnknownFields
HttpCacheTaskId int64 `protobuf:"varint,1,opt,name=httpCacheTaskId,proto3" json:"httpCacheTaskId,omitempty"`
HttpCacheTaskId int64 `protobuf:"varint,1,opt,name=httpCacheTaskId,proto3" json:"httpCacheTaskId,omitempty"` // 任务ID
}
func (x *DeleteHTTPCacheTaskRequest) Reset() {
@@ -478,7 +478,7 @@ type ResetHTTPCacheTaskRequest struct {
sizeCache protoimpl.SizeCache
unknownFields protoimpl.UnknownFields
HttpCacheTaskId int64 `protobuf:"varint,1,opt,name=httpCacheTaskId,proto3" json:"httpCacheTaskId,omitempty"`
HttpCacheTaskId int64 `protobuf:"varint,1,opt,name=httpCacheTaskId,proto3" json:"httpCacheTaskId,omitempty"` // 任务ID
}
func (x *ResetHTTPCacheTaskRequest) Reset() {

View File

@@ -32,14 +32,14 @@ service HTTPCacheTaskService {
// 创建任务
message CreateHTTPCacheTaskRequest {
string type = 1; // 类型清理purge预热fetch
string keyType = 2; // Key类型单个URLkey目录prefix;预热的时候只能为 key
repeated string keys = 3; // 要清理的Key
string type = 1; // 任务类型,值为 purge 或者 fetchpurge删除缓存fetch预热缓存
string keyType = 2; // Key类型,值为 key 或者 prefix如果是 key 表示处理的是URL如果是 prefix 表示处理的是目录;预热的时候只能为 key
repeated string keys = 3; // 要清理的Key根据Key类型keyType来输入不同的内容
}
message CreateHTTPCacheTaskResponse {
int64 httpCacheTaskId = 1;
int64 countKeys = 2;
int64 httpCacheTaskId = 1; // 生成的任务ID
int64 countKeys = 2; // 任务中包含的Key
}
// 计算任务总数量
@@ -54,29 +54,29 @@ message CountDoingHTTPCacheTasksRequest {
// 查找单个任务
message FindEnabledHTTPCacheTaskRequest {
int64 httpCacheTaskId = 1;
int64 httpCacheTaskId = 1; // 任务ID
}
message FindEnabledHTTPCacheTaskResponse {
HTTPCacheTask httpCacheTask = 1;
HTTPCacheTask httpCacheTask = 1; // 任务信息
}
// 列出单页任务
message ListHTTPCacheTasksRequest {
int64 offset = 1;
int64 size = 2;
int64 offset = 1; // 查询起始位置
int64 size = 2; // 查询条数
}
message ListHTTPCacheTasksResponse {
repeated HTTPCacheTask httpCacheTasks = 1;
repeated HTTPCacheTask httpCacheTasks = 1; // 一组任务信息
}
// 删除任务
message DeleteHTTPCacheTaskRequest {
int64 httpCacheTaskId = 1;
int64 httpCacheTaskId = 1; // 任务ID
}
// 重置任务状态
message ResetHTTPCacheTaskRequest {
int64 httpCacheTaskId = 1;
int64 httpCacheTaskId = 1; // 任务ID
}