Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(99)

Side by Side Diff: common/api/logdog_coordinator/registration/v1/service.proto

Issue 1967273002: LogDog: Implement RegisterPrefix RPC. (Closed) Base URL: https://github.com/luci/luci-go@logdog-butler-register-coordinator-endpoint
Patch Set: Updated patchset dependency Created 4 years, 7 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
OLDNEW
1 // Copyright 2016 The Chromium Authors. All rights reserved. 1 // Copyright 2016 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be 2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file. 3 // found in the LICENSE file.
4 4
5 syntax = "proto3"; 5 syntax = "proto3";
6 6
7 package logdog; 7 package logdog;
8 8
9 import "google/protobuf/duration.proto"; 9 import "google/protobuf/duration.proto";
10 10
11 // RegisterPrefixRequest registers a new Prefix with the Coordinator. 11 // RegisterPrefixRequest registers a new Prefix with the Coordinator.
12 message RegisterPrefixRequest { 12 message RegisterPrefixRequest {
13 // The log stream's project. 13 // The log stream's project.
14 string project = 1; 14 string project = 1;
15
16 // The log stream prefix to register.
17 string prefix = 2;
18
15 // Optional information about the registering agent. 19 // Optional information about the registering agent.
16 repeated string source_info = 2; 20 repeated string source_info = 3;
17
18 // The protobuf version string for this stream.
19 string proto_version = 3;
20 // The serialized LogStreamDescriptor protobuf for this stream. The stream's
21 // path is extracted from this field.
22 bytes desc = 4;
23 21
24 // The prefix expiration time. If <= 0, the project's default prefix 22 // The prefix expiration time. If <= 0, the project's default prefix
25 // expiration period will be applied. 23 // expiration period will be applied.
26 // 24 //
27 // The prefix will be closed by the Coordinator after its expiration period. 25 // The prefix will be closed by the Coordinator after its expiration period.
28 // Once closed, new stream registration requests will no longer be accepted. 26 // Once closed, new stream registration requests will no longer be accepted.
29 // 27 //
30 // If supplied, this value should exceed the timeout of the local task, else 28 // If supplied, this value should exceed the timeout of the local task, else
31 // some of the task's streams may be dropped due to failing registration. 29 // some of the task's streams may be dropped due to failing registration.
32 google.protobuf.Duration expiration = 5; 30 google.protobuf.Duration expiration = 10;
33 } 31 }
34 32
35 // The response message for the RegisterPrefix RPC. 33 // The response message for the RegisterPrefix RPC.
36 message RegisterPrefixResponse { 34 message RegisterPrefixResponse {
37 // Secret is the prefix's secret. This must be included verbatim in Butler 35 // Secret is the prefix's secret. This must be included verbatim in Butler
38 // bundles to assert ownership of this prefix. 36 // bundles to assert ownership of this prefix.
39 bytes secret = 1; 37 bytes secret = 1;
40 38
41 // The name of the Pub/Sub topic to publish butlerproto-formatted Butler log 39 // The name of the Pub/Sub topic to publish butlerproto-formatted Butler log
42 // bundles to. 40 // bundles to.
(...skipping 10 matching lines...) Expand all
53 // 51 //
54 // This should be called by a Butler instance to gain the ability to publish 52 // This should be called by a Butler instance to gain the ability to publish
55 // to a prefix space. The caller must have WRITE access to its project's 53 // to a prefix space. The caller must have WRITE access to its project's
56 // stream space. If WRITE access is not present, this will fail with the 54 // stream space. If WRITE access is not present, this will fail with the
57 // "PermissionDenied" gRPC code. 55 // "PermissionDenied" gRPC code.
58 // 56 //
59 // A stream prefix may be registered at most once. Additional registration 57 // A stream prefix may be registered at most once. Additional registration
60 // requests will fail with the "AlreadyExists" gRPC code. 58 // requests will fail with the "AlreadyExists" gRPC code.
61 rpc RegisterPrefix(RegisterPrefixRequest) returns (RegisterPrefixResponse); 59 rpc RegisterPrefix(RegisterPrefixRequest) returns (RegisterPrefixResponse);
62 } 60 }
OLDNEW

Powered by Google App Engine
This is Rietveld 408576698