blob: 90accbe6312f45a5d249b9e554bfe6fec213118d (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
|
syntax = "proto3";
package yandex.cloud.datatransfer.v1;
option go_package = "github.com/yandex-cloud/go-genproto/yandex/cloud/datatransfer/v1;datatransfer";
option java_package = "yandex.cloud.api.datatransfer.v1";
import "google/api/annotations.proto";
import "google/protobuf/field_mask.proto";
import "yandex/cloud/datatransfer/v1/endpoint.proto";
import "yandex/cloud/api/operation.proto";
import "yandex/cloud/operation/operation.proto";
service EndpointService {
rpc Get(GetEndpointRequest) returns (Endpoint) {
option (google.api.http) = { get: "/v1/endpoint/{endpoint_id}" };
}
rpc List(ListEndpointsRequest) returns (ListEndpointsResponse) {
option (google.api.http) = { get: "/v1/endpoints/list/{folder_id}" };
}
rpc Create(CreateEndpointRequest) returns (operation.Operation) {
option (google.api.http) = { post: "/v1/endpoint" body: "*" };
option (api.operation) = {
metadata: "CreateEndpointMetadata"
response: "Endpoint"
};
}
rpc Update(UpdateEndpointRequest) returns (operation.Operation) {
option (google.api.http) = { patch: "/v1/endpoint/{endpoint_id}" body: "*" };
option (api.operation) = {
metadata: "UpdateEndpointMetadata"
response: "Endpoint"
};
}
rpc Delete(DeleteEndpointRequest) returns (operation.Operation) {
option (google.api.http) = { delete: "/v1/endpoint/{endpoint_id}" };
option (api.operation) = {
metadata: "DeleteEndpointMetadata"
response: "google.protobuf.Empty"
};
}
}
message GetEndpointRequest {
string endpoint_id = 1;
}
message ListEndpointsRequest {
// Identifier of the folder containing the endpoints to be listed.
string folder_id = 1;
// The maximum number of endpoints to be sent in the response message. If the
// folder contains more endpoints than `page_size`, `next_page_token` will be
// included
// in the response message. Include it into the subsequent `ListEndpointRequest` to
// fetch the next page. Defaults to `100` if not specified. The maximum allowed
// value
// for this field is `500`.
int64 page_size = 2;
// Opaque value identifying the endpoints page to be fetched. Should be empty in
// the first `ListEndpointsRequest`. Subsequent requests should have this field
// filled
// with the `next_page_token` from the previous `ListEndpointsResponse`.
string page_token = 3;
}
message ListEndpointsResponse {
// The list of endpoints. If there are more endpoints in the folder, then
// `next_page_token` is a non-empty string to be included into the subsequent
// `ListEndpointsRequest` to fetch the next endpoints page.
repeated Endpoint endpoints = 1;
// Opaque value identifying the next endpoints page. This field is empty if there
// are no more endpoints in the folder. Otherwise, it is non-empty and should be
// included in the subsequent `ListEndpointsRequest` to fetch the next endpoints
// page.
string next_page_token = 2;
}
message CreateEndpointRequest {
reserved 5 to 51;
string folder_id = 1;
string name = 2;
string description = 3;
map<string,string> labels = 4;
EndpointSettings settings = 52;
}
message CreateEndpointMetadata {
string endpoint_id = 1;
}
message UpdateEndpointRequest {
reserved 1 to 9, 14 to 51, 53 to 59;
// Identifier of the endpoint to be updated.
string endpoint_id = 10;
// The new endpoint name. Must be unique within the folder.
string name = 11;
// The new description for the endpoint.
string description = 12;
map<string,string> labels = 13;
// The new endpoint name. Must be unique within the folder.
EndpointSettings settings = 52;
// Field mask specifying endpoint fields to be updated. Semantics for this field is
// described here:
// <https://pkg.go.dev/google.golang.org/protobuf/types/known/fieldmaskpb#FieldMask>
// The only exception: if the repeated field is specified in the mask, then
// the new value replaces the old one instead of being appended to the old one.
google.protobuf.FieldMask update_mask = 60;
}
message UpdateEndpointMetadata {
string endpoint_id = 1;
}
message DeleteEndpointRequest {
string endpoint_id = 1;
}
message DeleteEndpointMetadata {
string endpoint_id = 1;
}
|
