alt-orchestra/talos
1
0
Fork 0
Code Issues Pull Requests Actions 27 Packages Projects Releases Wiki Activity

feat: add storage API

Browse Source 
This is the initial implementation of a storage API.

Signed-off-by: Andrew Rynhard <andrew@rynhard.io>
This commit is contained in:
Andrew Rynhard 2020-11-11 09:17:46 -08:00 committed by talos-bot
parent 026244097a
commit 71321214a1
9 changed files with 1574 additions and 1038 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
Dockerfile
View File

@ -78,6 +78,8 @@ COPY ./api/health/health.proto /api/health/health.proto
RUN protoc -I/api --go_out=plugins=grpc,paths=source_relative:/api health/health.proto
COPY ./api/security/security.proto /api/security/security.proto
RUN protoc -I/api --go_out=plugins=grpc,paths=source_relative:/api security/security.proto
COPY ./api/storage/storage.proto /api/storage/storage.proto
RUN protoc -I/api --go_out=plugins=grpc,paths=source_relative:/api storage/storage.proto
COPY ./api/machine/machine.proto /api/machine/machine.proto
RUN protoc -I/api --go_out=plugins=grpc,paths=source_relative:/api machine/machine.proto
COPY ./api/time/time.proto /api/time/time.proto
@ -103,6 +105,7 @@ COPY --from=generate-build /api/machine/machine.pb.go /pkg/machinery/api/machine
COPY --from=generate-build /api/time/time.pb.go /pkg/machinery/api/time/
COPY --from=generate-build /api/network/network.pb.go /pkg/machinery/api/network/
COPY --from=generate-build /api/cluster/cluster.pb.go /pkg/machinery/api/cluster/
COPY --from=generate-build /api/storage/storage.pb.go /pkg/machinery/api/storage/
COPY --from=generate-build /pkg/machinery/config/types/v1alpha1/*_doc.go /pkg/machinery/config/types/v1alpha1/
# The base target provides a container that can be used to build all Talos
@ -636,6 +639,7 @@ RUN protoc \
-I/protos/machine \
-I/protos/network \
-I/protos/security \
-I/protos/storage \
-I/protos/time \
--doc_opt=/tmp/markdown.tmpl,api.md \
--doc_out=/tmp \
@ -643,6 +647,7 @@ RUN protoc \
/protos/machine/*.proto \
/protos/network/*.proto \
/protos/security/*.proto \
/protos/storage/*.proto \
/protos/time/*.proto
FROM scratch AS docs

2
api/machine/machine.proto
View File

@ -11,10 +11,12 @@ import "google/protobuf/any.proto";
import "google/protobuf/empty.proto";
import "google/protobuf/timestamp.proto";
import "common/common.proto";
import "storage/storage.proto";
service MaintenanceService {
rpc ApplyConfiguration(ApplyConfigurationRequest)
returns(ApplyConfigurationResponse);
rpc Disks(google.protobuf.Empty) returns (storage.DisksResponse);
}
// The machine service definition.

32
api/storage/storage.proto Normal file
View File

@ -0,0 +1,32 @@
syntax = "proto3";
package storage;
option go_package = "github.com/talos-systems/talos/pkg/machinery/api/storage";
option java_multiple_files = true;
option java_outer_classname = "StorageApi";
option java_package = "com.storage.api";
import "google/protobuf/empty.proto";
import "common/common.proto";
// StorageService represents the storage service.
service StorageService {
rpc Disks(google.protobuf.Empty) returns (DisksResponse);
}
// Disk represents a disk.
message Disk {
// Size indicates the disk size in bytes.
uint64 size = 1;
// Model idicates the disk model.
string model = 2;
// DeviceName indicates the disk name (e.g. `sda`).
string device_name = 3;
}
// DisksResponse represents the response of the `Disks` RPC.
message DisksResponse{
common.Metadata metadata = 1;
repeated Disk disks = 2;
}

2
go.mod
View File

@ -57,7 +57,7 @@ require (
github.com/syndtr/gocapability v0.0.0-20180916011248-d98352740cb2
github.com/talos-systems/bootkube-plugin v0.0.0-20200915135634-229d57e818f3
github.com/talos-systems/crypto v0.2.1-0.20201028152949-d0c3eef149ec
github.com/talos-systems/go-blockdevice v0.1.1-0.20201030204209-b4e67d73d70d
github.com/talos-systems/go-blockdevice v0.1.1-0.20201111103554-874213371a3f
github.com/talos-systems/go-loadbalancer v0.1.0
github.com/talos-systems/go-procfs v0.0.0-20200219015357-57c7311fdd45
github.com/talos-systems/go-retry v0.1.1-0.20200922131245-752f081252cf

4
go.sum
View File

@ -819,8 +819,8 @@ github.com/talos-systems/crypto v0.2.0 h1:UwT8uhJ0eDlklY0vYwo1+LGoFgiqkPqjQnae6j
github.com/talos-systems/crypto v0.2.0/go.mod h1:KwqG+jANKU1FNQIapmioHQ5fkovY1DJkAqMenjYBGh0=
github.com/talos-systems/crypto v0.2.1-0.20201028152949-d0c3eef149ec h1:qO6KZJ1XbXQmkTcaonJYsTduNrKWGFfp9Tykc63raA4=
github.com/talos-systems/crypto v0.2.1-0.20201028152949-d0c3eef149ec/go.mod h1:KwqG+jANKU1FNQIapmioHQ5fkovY1DJkAqMenjYBGh0=
github.com/talos-systems/go-blockdevice v0.1.1-0.20201030204209-b4e67d73d70d h1:sziRi0JYiHhJ6BECcnjLFwARzT9LmJ8CsEhrQvUciDM=
github.com/talos-systems/go-blockdevice v0.1.1-0.20201030204209-b4e67d73d70d/go.mod h1:efEE9wjtgxiovqsZAV39xlOd/AOI/0sLuZqb5jEgeqo=
github.com/talos-systems/go-blockdevice v0.1.1-0.20201111103554-874213371a3f h1:DiWsa6+uyi9fuxWBs9NpLYDCs3OIg+HwEvSlVjkAm0U=
github.com/talos-systems/go-blockdevice v0.1.1-0.20201111103554-874213371a3f/go.mod h1:efEE9wjtgxiovqsZAV39xlOd/AOI/0sLuZqb5jEgeqo=
github.com/talos-systems/go-loadbalancer v0.1.0 h1:MQFONvSjoleU8RrKq1O1Z8CyTCJGd4SLqdAHDlR6o9s=
github.com/talos-systems/go-loadbalancer v0.1.0/go.mod h1:D5Qjfz+29WVjONWECZvOkmaLsBb3f5YeWME0u/5HmIc=
github.com/talos-systems/go-procfs v0.0.0-20200219015357-57c7311fdd45 h1:FND/LgzFHTBdJBOeZVzdO6B47kxQZvSIzb9AMIXYotg=

28
internal/app/maintenance/server/server.go
View File

@ -9,10 +9,13 @@ import (
"fmt"
"log"
"github.com/golang/protobuf/ptypes/empty"
"github.com/talos-systems/go-blockdevice/blockdevice/util"
"google.golang.org/grpc"
"github.com/talos-systems/talos/internal/app/machined/pkg/runtime"
"github.com/talos-systems/talos/pkg/machinery/api/machine"
"github.com/talos-systems/talos/pkg/machinery/api/storage"
"github.com/talos-systems/talos/pkg/machinery/config/configloader"
)
@ -38,6 +41,7 @@ func (s *Server) Register(obj *grpc.Server) {
s.server = obj
machine.RegisterMaintenanceServiceServer(obj, s)
storage.RegisterStorageServiceServer(obj, s)
}
// ApplyConfiguration implements machine.MaintenanceService.
@ -61,3 +65,27 @@ func (s *Server) ApplyConfiguration(ctx context.Context, in *machine.ApplyConfig
return reply, nil
}
// Disks implements machine.MaintenanceService.
func (s *Server) Disks(ctx context.Context, in *empty.Empty) (reply *storage.DisksResponse, err error) {
disks, err := util.GetDisks()
if err != nil {
return nil, err
}
diskList := make([]*storage.Disk, len(disks))
for i, disk := range disks {
diskList[i] = &storage.Disk{
DeviceName: disk.DeviceName,
Model: disk.Model,
Size: disk.Size,
}
}
reply = &storage.DisksResponse{
Disks: diskList,
}
return reply, nil
}

2116
pkg/machinery/api/machine/machine.pb.go
View File

File diff suppressed because it is too large Load Diff

357
pkg/machinery/api/storage/storage.pb.go Normal file
View File

@ -0,0 +1,357 @@
// Code generated by protoc-gen-go. DO NOT EDIT.
// versions:
// protoc-gen-go v1.23.0
// protoc v3.12.3
// source: storage/storage.proto
package storage
import (
context "context"
reflect "reflect"
sync "sync"
proto "github.com/golang/protobuf/proto"
empty "github.com/golang/protobuf/ptypes/empty"
grpc "google.golang.org/grpc"
codes "google.golang.org/grpc/codes"
status "google.golang.org/grpc/status"
protoreflect "google.golang.org/protobuf/reflect/protoreflect"
protoimpl "google.golang.org/protobuf/runtime/protoimpl"
common "github.com/talos-systems/talos/pkg/machinery/api/common"
)
const (
// Verify that this generated code is sufficiently up-to-date.
_ = protoimpl.EnforceVersion(20 - protoimpl.MinVersion)
// Verify that runtime/protoimpl is sufficiently up-to-date.
_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
)
// This is a compile-time assertion that a sufficiently up-to-date version
// of the legacy proto package is being used.
const _ = proto.ProtoPackageIsVersion4
// Disk represents a disk.
type Disk struct {
state protoimpl.MessageState
sizeCache protoimpl.SizeCache
unknownFields protoimpl.UnknownFields
// Size indicates the disk size in bytes.
Size uint64 `protobuf:"varint,1,opt,name=size,proto3" json:"size,omitempty"`
// Model idicates the disk model.
Model string `protobuf:"bytes,2,opt,name=model,proto3" json:"model,omitempty"`
// DeviceName indicates the disk name (e.g. `sda`).
DeviceName string `protobuf:"bytes,3,opt,name=device_name,json=deviceName,proto3" json:"device_name,omitempty"`
}
func (x *Disk) Reset() {
*x = Disk{}
if protoimpl.UnsafeEnabled {
mi := &file_storage_storage_proto_msgTypes[0]
ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
ms.StoreMessageInfo(mi)
}
}
func (x *Disk) String() string {
return protoimpl.X.MessageStringOf(x)
}
func (*Disk) ProtoMessage() {}
func (x *Disk) ProtoReflect() protoreflect.Message {
mi := &file_storage_storage_proto_msgTypes[0]
if protoimpl.UnsafeEnabled && x != nil {
ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
if ms.LoadMessageInfo() == nil {
ms.StoreMessageInfo(mi)
}
return ms
}
return mi.MessageOf(x)
}
// Deprecated: Use Disk.ProtoReflect.Descriptor instead.
func (*Disk) Descriptor() ([]byte, []int) {
return file_storage_storage_proto_rawDescGZIP(), []int{0}
}
func (x *Disk) GetSize() uint64 {
if x != nil {
return x.Size
}
return 0
}
func (x *Disk) GetModel() string {
if x != nil {
return x.Model
}
return ""
}
func (x *Disk) GetDeviceName() string {
if x != nil {
return x.DeviceName
}
return ""
}
// DisksResponse represents the response of the `Disks` RPC.
type DisksResponse struct {
state protoimpl.MessageState
sizeCache protoimpl.SizeCache
unknownFields protoimpl.UnknownFields
Metadata *common.Metadata `protobuf:"bytes,1,opt,name=metadata,proto3" json:"metadata,omitempty"`
Disks []*Disk `protobuf:"bytes,2,rep,name=disks,proto3" json:"disks,omitempty"`
}
func (x *DisksResponse) Reset() {
*x = DisksResponse{}
if protoimpl.UnsafeEnabled {
mi := &file_storage_storage_proto_msgTypes[1]
ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
ms.StoreMessageInfo(mi)
}
}
func (x *DisksResponse) String() string {
return protoimpl.X.MessageStringOf(x)
}
func (*DisksResponse) ProtoMessage() {}
func (x *DisksResponse) ProtoReflect() protoreflect.Message {
mi := &file_storage_storage_proto_msgTypes[1]
if protoimpl.UnsafeEnabled && x != nil {
ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
if ms.LoadMessageInfo() == nil {
ms.StoreMessageInfo(mi)
}
return ms
}
return mi.MessageOf(x)
}
// Deprecated: Use DisksResponse.ProtoReflect.Descriptor instead.
func (*DisksResponse) Descriptor() ([]byte, []int) {
return file_storage_storage_proto_rawDescGZIP(), []int{1}
}
func (x *DisksResponse) GetMetadata() *common.Metadata {
if x != nil {
return x.Metadata
}
return nil
}
func (x *DisksResponse) GetDisks() []*Disk {
if x != nil {
return x.Disks
}
return nil
}
var File_storage_storage_proto protoreflect.FileDescriptor
var file_storage_storage_proto_rawDesc = []byte{
0x0a, 0x15, 0x73, 0x74, 0x6f, 0x72, 0x61, 0x67, 0x65, 0x2f, 0x73, 0x74, 0x6f, 0x72, 0x61, 0x67,
0x65, 0x2e, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x12, 0x07, 0x73, 0x74, 0x6f, 0x72, 0x61, 0x67, 0x65,
0x1a, 0x1b, 0x67, 0x6f, 0x6f, 0x67, 0x6c, 0x65, 0x2f, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x62, 0x75,
0x66, 0x2f, 0x65, 0x6d, 0x70, 0x74, 0x79, 0x2e, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x1a, 0x13, 0x63,
0x6f, 0x6d, 0x6d, 0x6f, 0x6e, 0x2f, 0x63, 0x6f, 0x6d, 0x6d, 0x6f, 0x6e, 0x2e, 0x70, 0x72, 0x6f,
0x74, 0x6f, 0x22, 0x51, 0x0a, 0x04, 0x44, 0x69, 0x73, 0x6b, 0x12, 0x12, 0x0a, 0x04, 0x73, 0x69,
0x7a, 0x65, 0x18, 0x01, 0x20, 0x01, 0x28, 0x04, 0x52, 0x04, 0x73, 0x69, 0x7a, 0x65, 0x12, 0x14,
0x0a, 0x05, 0x6d, 0x6f, 0x64, 0x65, 0x6c, 0x18, 0x02, 0x20, 0x01, 0x28, 0x09, 0x52, 0x05, 0x6d,
0x6f, 0x64, 0x65, 0x6c, 0x12, 0x1f, 0x0a, 0x0b, 0x64, 0x65, 0x76, 0x69, 0x63, 0x65, 0x5f, 0x6e,
0x61, 0x6d, 0x65, 0x18, 0x03, 0x20, 0x01, 0x28, 0x09, 0x52, 0x0a, 0x64, 0x65, 0x76, 0x69, 0x63,
0x65, 0x4e, 0x61, 0x6d, 0x65, 0x22, 0x62, 0x0a, 0x0d, 0x44, 0x69, 0x73, 0x6b, 0x73, 0x52, 0x65,
0x73, 0x70, 0x6f, 0x6e, 0x73, 0x65, 0x12, 0x2c, 0x0a, 0x08, 0x6d, 0x65, 0x74, 0x61, 0x64, 0x61,
0x74, 0x61, 0x18, 0x01, 0x20, 0x01, 0x28, 0x0b, 0x32, 0x10, 0x2e, 0x63, 0x6f, 0x6d, 0x6d, 0x6f,
0x6e, 0x2e, 0x4d, 0x65, 0x74, 0x61, 0x64, 0x61, 0x74, 0x61, 0x52, 0x08, 0x6d, 0x65, 0x74, 0x61,
0x64, 0x61, 0x74, 0x61, 0x12, 0x23, 0x0a, 0x05, 0x64, 0x69, 0x73, 0x6b, 0x73, 0x18, 0x02, 0x20,
0x03, 0x28, 0x0b, 0x32, 0x0d, 0x2e, 0x73, 0x74, 0x6f, 0x72, 0x61, 0x67, 0x65, 0x2e, 0x44, 0x69,
0x73, 0x6b, 0x52, 0x05, 0x64, 0x69, 0x73, 0x6b, 0x73, 0x32, 0x49, 0x0a, 0x0e, 0x53, 0x74, 0x6f,
0x72, 0x61, 0x67, 0x65, 0x53, 0x65, 0x72, 0x76, 0x69, 0x63, 0x65, 0x12, 0x37, 0x0a, 0x05, 0x44,
0x69, 0x73, 0x6b, 0x73, 0x12, 0x16, 0x2e, 0x67, 0x6f, 0x6f, 0x67, 0x6c, 0x65, 0x2e, 0x70, 0x72,
0x6f, 0x74, 0x6f, 0x62, 0x75, 0x66, 0x2e, 0x45, 0x6d, 0x70, 0x74, 0x79, 0x1a, 0x16, 0x2e, 0x73,
0x74, 0x6f, 0x72, 0x61, 0x67, 0x65, 0x2e, 0x44, 0x69, 0x73, 0x6b, 0x73, 0x52, 0x65, 0x73, 0x70,
0x6f, 0x6e, 0x73, 0x65, 0x42, 0x59, 0x0a, 0x0f, 0x63, 0x6f, 0x6d, 0x2e, 0x73, 0x74, 0x6f, 0x72,
0x61, 0x67, 0x65, 0x2e, 0x61, 0x70, 0x69, 0x42, 0x0a, 0x53, 0x74, 0x6f, 0x72, 0x61, 0x67, 0x65,
0x41, 0x70, 0x69, 0x50, 0x01, 0x5a, 0x38, 0x67, 0x69, 0x74, 0x68, 0x75, 0x62, 0x2e, 0x63, 0x6f,
0x6d, 0x2f, 0x74, 0x61, 0x6c, 0x6f, 0x73, 0x2d, 0x73, 0x79, 0x73, 0x74, 0x65, 0x6d, 0x73, 0x2f,
0x74, 0x61, 0x6c, 0x6f, 0x73, 0x2f, 0x70, 0x6b, 0x67, 0x2f, 0x6d, 0x61, 0x63, 0x68, 0x69, 0x6e,
0x65, 0x72, 0x79, 0x2f, 0x61, 0x70, 0x69, 0x2f, 0x73, 0x74, 0x6f, 0x72, 0x61, 0x67, 0x65, 0x62,
0x06, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x33,
}
var (
file_storage_storage_proto_rawDescOnce sync.Once
file_storage_storage_proto_rawDescData = file_storage_storage_proto_rawDesc
)
func file_storage_storage_proto_rawDescGZIP() []byte {
file_storage_storage_proto_rawDescOnce.Do(func() {
file_storage_storage_proto_rawDescData = protoimpl.X.CompressGZIP(file_storage_storage_proto_rawDescData)
})
return file_storage_storage_proto_rawDescData
}
var (
file_storage_storage_proto_msgTypes = make([]protoimpl.MessageInfo, 2)
file_storage_storage_proto_goTypes = []interface{}{
(*Disk)(nil), // 0: storage.Disk
(*DisksResponse)(nil), // 1: storage.DisksResponse
(*common.Metadata)(nil), // 2: common.Metadata
(*empty.Empty)(nil), // 3: google.protobuf.Empty
}
)
var file_storage_storage_proto_depIdxs = []int32{
2, // 0: storage.DisksResponse.metadata:type_name -> common.Metadata
0, // 1: storage.DisksResponse.disks:type_name -> storage.Disk
3, // 2: storage.StorageService.Disks:input_type -> google.protobuf.Empty
1, // 3: storage.StorageService.Disks:output_type -> storage.DisksResponse
3, // [3:4] is the sub-list for method output_type
2, // [2:3] is the sub-list for method input_type
2, // [2:2] is the sub-list for extension type_name
2, // [2:2] is the sub-list for extension extendee
0, // [0:2] is the sub-list for field type_name
}
func init() { file_storage_storage_proto_init() }
func file_storage_storage_proto_init() {
if File_storage_storage_proto != nil {
return
}
if !protoimpl.UnsafeEnabled {
file_storage_storage_proto_msgTypes[0].Exporter = func(v interface{}, i int) interface{} {
switch v := v.(*Disk); i {
case 0:
return &v.state
case 1:
return &v.sizeCache
case 2:
return &v.unknownFields
default:
return nil
}
}
file_storage_storage_proto_msgTypes[1].Exporter = func(v interface{}, i int) interface{} {
switch v := v.(*DisksResponse); i {
case 0:
return &v.state
case 1:
return &v.sizeCache
case 2:
return &v.unknownFields
default:
return nil
}
}
}
type x struct{}
out := protoimpl.TypeBuilder{
File: protoimpl.DescBuilder{
GoPackagePath: reflect.TypeOf(x{}).PkgPath(),
RawDescriptor: file_storage_storage_proto_rawDesc,
NumEnums: 0,
NumMessages: 2,
NumExtensions: 0,
NumServices: 1,
},
GoTypes: file_storage_storage_proto_goTypes,
DependencyIndexes: file_storage_storage_proto_depIdxs,
MessageInfos: file_storage_storage_proto_msgTypes,
}.Build()
File_storage_storage_proto = out.File
file_storage_storage_proto_rawDesc = nil
file_storage_storage_proto_goTypes = nil
file_storage_storage_proto_depIdxs = nil
}
// Reference imports to suppress errors if they are not otherwise used.
var (
_ context.Context
_ grpc.ClientConnInterface
)
// This is a compile-time assertion to ensure that this generated file
// is compatible with the grpc package it is being compiled against.
const _ = grpc.SupportPackageIsVersion6
// StorageServiceClient is the client API for StorageService service.
//
// For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream.
type StorageServiceClient interface {
Disks(ctx context.Context, in *empty.Empty, opts ...grpc.CallOption) (*DisksResponse, error)
}
type storageServiceClient struct {
cc grpc.ClientConnInterface
}
func NewStorageServiceClient(cc grpc.ClientConnInterface) StorageServiceClient {
return &storageServiceClient{cc}
}
func (c *storageServiceClient) Disks(ctx context.Context, in *empty.Empty, opts ...grpc.CallOption) (*DisksResponse, error) {
out := new(DisksResponse)
err := c.cc.Invoke(ctx, "/storage.StorageService/Disks", in, out, opts...)
if err != nil {
return nil, err
}
return out, nil
}
// StorageServiceServer is the server API for StorageService service.
type StorageServiceServer interface {
Disks(context.Context, *empty.Empty) (*DisksResponse, error)
}
// UnimplementedStorageServiceServer can be embedded to have forward compatible implementations.
type UnimplementedStorageServiceServer struct {
}
func (*UnimplementedStorageServiceServer) Disks(context.Context, *empty.Empty) (*DisksResponse, error) {
return nil, status.Errorf(codes.Unimplemented, "method Disks not implemented")
}
func RegisterStorageServiceServer(s *grpc.Server, srv StorageServiceServer) {
s.RegisterService(&_StorageService_serviceDesc, srv)
}
func _StorageService_Disks_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
in := new(empty.Empty)
if err := dec(in); err != nil {
return nil, err
}
if interceptor == nil {
return srv.(StorageServiceServer).Disks(ctx, in)
}
info := &grpc.UnaryServerInfo{
Server: srv,
FullMethod: "/storage.StorageService/Disks",
}
handler := func(ctx context.Context, req interface{}) (interface{}, error) {
return srv.(StorageServiceServer).Disks(ctx, req.(*empty.Empty))
}
return interceptor(ctx, in, info, handler)
}
var _StorageService_serviceDesc = grpc.ServiceDesc{
ServiceName: "storage.StorageService",
HandlerType: (*StorageServiceServer)(nil),
Methods: []grpc.MethodDesc{
{
MethodName: "Disks",
Handler: _StorageService_Disks_Handler,
},
},
Streams: []grpc.StreamDesc{},
Metadata: "storage/storage.proto",
}

66
website/content/docs/v0.7/Reference/api.md
View File

@ -157,6 +157,12 @@ title: API
- [SecurityService](#securityapi.SecurityService)
- [storage/storage.proto](#storage/storage.proto)
- [Disk](#storage.Disk)
- [DisksResponse](#storage.DisksResponse)
- [StorageService](#storage.StorageService)
- [time/time.proto](#time/time.proto)
- [Time](#time.Time)
- [TimeRequest](#time.TimeRequest)
@ -2230,6 +2236,7 @@ The machine service definition.
| Method Name | Request Type | Response Type | Description |
| ----------- | ------------ | ------------- | ------------|
| ApplyConfiguration | [ApplyConfigurationRequest](#machine.ApplyConfigurationRequest) | [ApplyConfigurationResponse](#machine.ApplyConfigurationResponse) | |
| Disks | [.google.protobuf.Empty](#google.protobuf.Empty) | [.storage.DisksResponse](#storage.DisksResponse) | |
<!-- end services -->
@ -2540,6 +2547,65 @@ The security service definition.
<a name="storage/storage.proto"></a>
<p align="right"><a href="#top">Top</a></p>
## storage/storage.proto
<a name="storage.Disk"></a>
### Disk
Disk represents a disk.
| Field | Type | Label | Description |
| ----- | ---- | ----- | ----------- |
| size | [uint64](#uint64) | | Size indicates the disk size in bytes. |
| model | [string](#string) | | Model idicates the disk model. |
| device_name | [string](#string) | | DeviceName indicates the disk name (e.g. `sda`). |
<a name="storage.DisksResponse"></a>
### DisksResponse
DisksResponse represents the response of the `Disks` RPC.
| Field | Type | Label | Description |
| ----- | ---- | ----- | ----------- |
| metadata | [common.Metadata](#common.Metadata) | | |
| disks | [Disk](#storage.Disk) | repeated | |
<!-- end messages -->
<!-- end enums -->
<!-- end HasExtensions -->
<a name="storage.StorageService"></a>
### StorageService
StorageService represents the storage service.
| Method Name | Request Type | Response Type | Description |
| ----------- | ------------ | ------------- | ------------|
| Disks | [.google.protobuf.Empty](#google.protobuf.Empty) | [DisksResponse](#storage.DisksResponse) | |
<!-- end services -->
<a name="time/time.proto"></a>
<p align="right"><a href="#top">Top</a></p>