@@ -33,7 +33,8 @@ option objc_class_prefix = "GASM";
33
33
option php_namespace = "Google\\Cloud\\ServiceManagement\\V1" ;
34
34
option ruby_package = "Google::Cloud::ServiceManagement::V1" ;
35
35
36
- // [Google Service Management API](/service-management/overview)
36
+ // [Google Service Management
37
+ // API](https://cloud.google.com/service-infrastructure/docs/overview)
37
38
service ServiceManager {
38
39
option (google.api.default_host ) = "servicemanagement.googleapis.com" ;
39
40
option (google.api.oauth_scopes ) =
@@ -74,7 +75,8 @@ service ServiceManager {
74
75
// dedicated producer project.
75
76
//
76
77
// Operation<response: ManagedService>
77
- rpc CreateService (CreateServiceRequest ) returns (google .longrunning .Operation ) {
78
+ rpc CreateService (CreateServiceRequest )
79
+ returns (google .longrunning .Operation ) {
78
80
option (google.api.http ) = {
79
81
post : "/v1/services"
80
82
body : "service"
@@ -88,11 +90,14 @@ service ServiceManager {
88
90
89
91
// Deletes a managed service. This method will change the service to the
90
92
// `Soft-Delete` state for 30 days. Within this period, service producers may
91
- // call [UndeleteService][google.api.servicemanagement.v1.ServiceManager.UndeleteService] to restore the service.
92
- // After 30 days, the service will be permanently deleted.
93
+ // call
94
+ // [UndeleteService][google.api.servicemanagement.v1.ServiceManager.UndeleteService]
95
+ // to restore the service. After 30 days, the service will be permanently
96
+ // deleted.
93
97
//
94
98
// Operation<response: google.protobuf.Empty>
95
- rpc DeleteService (DeleteServiceRequest ) returns (google .longrunning .Operation ) {
99
+ rpc DeleteService (DeleteServiceRequest )
100
+ returns (google .longrunning .Operation ) {
96
101
option (google.api.http ) = {
97
102
delete : "/v1/services/{service_name}"
98
103
};
@@ -109,7 +114,8 @@ service ServiceManager {
109
114
// last 30 days.
110
115
//
111
116
// Operation<response: UndeleteServiceResponse>
112
- rpc UndeleteService (UndeleteServiceRequest ) returns (google .longrunning .Operation ) {
117
+ rpc UndeleteService (UndeleteServiceRequest )
118
+ returns (google .longrunning .Operation ) {
113
119
option (google.api.http ) = {
114
120
post : "/v1/services/{service_name}:undelete"
115
121
};
@@ -122,7 +128,8 @@ service ServiceManager {
122
128
123
129
// Lists the history of the service configuration for a managed service,
124
130
// from the newest to the oldest.
125
- rpc ListServiceConfigs (ListServiceConfigsRequest ) returns (ListServiceConfigsResponse ) {
131
+ rpc ListServiceConfigs (ListServiceConfigsRequest )
132
+ returns (ListServiceConfigsResponse ) {
126
133
option (google.api.http ) = {
127
134
get : "/v1/services/{service_name}/configs"
128
135
};
@@ -133,9 +140,7 @@ service ServiceManager {
133
140
rpc GetServiceConfig (GetServiceConfigRequest ) returns (google .api .Service ) {
134
141
option (google.api.http ) = {
135
142
get : "/v1/services/{service_name}/configs/{config_id}"
136
- additional_bindings {
137
- get : "/v1/services/{service_name}/config"
138
- }
143
+ additional_bindings { get : "/v1/services/{service_name}/config" }
139
144
};
140
145
option (google.api.method_signature ) = "service_name,config_id,view" ;
141
146
}
@@ -148,7 +153,8 @@ service ServiceManager {
148
153
// Only the 100 most recent service configurations and ones referenced by
149
154
// existing rollouts are kept for each service. The rest will be deleted
150
155
// eventually.
151
- rpc CreateServiceConfig (CreateServiceConfigRequest ) returns (google .api .Service ) {
156
+ rpc CreateServiceConfig (CreateServiceConfigRequest )
157
+ returns (google .api .Service ) {
152
158
option (google.api.http ) = {
153
159
post : "/v1/services/{service_name}/configs"
154
160
body : "service_config"
@@ -162,19 +168,22 @@ service ServiceManager {
162
168
// Specification). This method stores the source configurations as well as the
163
169
// generated service configuration. To rollout the service configuration to
164
170
// other services,
165
- // please call [CreateServiceRollout][google.api.servicemanagement.v1.ServiceManager.CreateServiceRollout].
171
+ // please call
172
+ // [CreateServiceRollout][google.api.servicemanagement.v1.ServiceManager.CreateServiceRollout].
166
173
//
167
174
// Only the 100 most recent configuration sources and ones referenced by
168
175
// existing service configurtions are kept for each service. The rest will be
169
176
// deleted eventually.
170
177
//
171
178
// Operation<response: SubmitConfigSourceResponse>
172
- rpc SubmitConfigSource (SubmitConfigSourceRequest ) returns (google .longrunning .Operation ) {
179
+ rpc SubmitConfigSource (SubmitConfigSourceRequest )
180
+ returns (google .longrunning .Operation ) {
173
181
option (google.api.http ) = {
174
182
post : "/v1/services/{service_name}/configs:submit"
175
183
body : "*"
176
184
};
177
- option (google.api.method_signature ) = "service_name,config_source,validate_only" ;
185
+ option (google.api.method_signature ) =
186
+ "service_name,config_source,validate_only" ;
178
187
option (google.longrunning.operation_info ) = {
179
188
response_type : "google.api.servicemanagement.v1.SubmitConfigSourceResponse"
180
189
metadata_type : "google.api.servicemanagement.v1.OperationMetadata"
@@ -183,14 +192,16 @@ service ServiceManager {
183
192
184
193
// Lists the history of the service configuration rollouts for a managed
185
194
// service, from the newest to the oldest.
186
- rpc ListServiceRollouts (ListServiceRolloutsRequest ) returns (ListServiceRolloutsResponse ) {
195
+ rpc ListServiceRollouts (ListServiceRolloutsRequest )
196
+ returns (ListServiceRolloutsResponse ) {
187
197
option (google.api.http ) = {
188
198
get : "/v1/services/{service_name}/rollouts"
189
199
};
190
200
option (google.api.method_signature ) = "service_name,filter" ;
191
201
}
192
202
193
- // Gets a service configuration [rollout][google.api.servicemanagement.v1.Rollout].
203
+ // Gets a service configuration
204
+ // [rollout][google.api.servicemanagement.v1.Rollout].
194
205
rpc GetServiceRollout (GetServiceRolloutRequest ) returns (Rollout ) {
195
206
option (google.api.http ) = {
196
207
get : "/v1/services/{service_name}/rollouts/{rollout_id}"
@@ -212,7 +223,8 @@ service ServiceManager {
212
223
// service. The rest will be deleted eventually.
213
224
//
214
225
// Operation<response: Rollout>
215
- rpc CreateServiceRollout (CreateServiceRolloutRequest ) returns (google .longrunning .Operation ) {
226
+ rpc CreateServiceRollout (CreateServiceRolloutRequest )
227
+ returns (google .longrunning .Operation ) {
216
228
option (google.api.http ) = {
217
229
post : "/v1/services/{service_name}/rollouts"
218
230
body : "rollout"
@@ -235,7 +247,8 @@ service ServiceManager {
235
247
// If GenerateConfigReportRequest.old_value is not specified, this method
236
248
// will compare GenerateConfigReportRequest.new_value with the last pushed
237
249
// service configuration.
238
- rpc GenerateConfigReport (GenerateConfigReportRequest ) returns (GenerateConfigReportResponse ) {
250
+ rpc GenerateConfigReport (GenerateConfigReportRequest )
251
+ returns (GenerateConfigReportResponse ) {
239
252
option (google.api.http ) = {
240
253
post : "/v1/services:generateConfigReport"
241
254
body : "*"
@@ -276,8 +289,8 @@ message ListServicesResponse {
276
289
277
290
// Request message for `GetService` method.
278
291
message GetServiceRequest {
279
- // Required. The name of the service. See the `ServiceManager` overview for naming
280
- // requirements. For example: `example.googleapis.com`.
292
+ // Required. The name of the service. See the `ServiceManager` overview for
293
+ // naming requirements. For example: `example.googleapis.com`.
281
294
string service_name = 1 [(google.api.field_behavior ) = REQUIRED ];
282
295
}
283
296
@@ -289,15 +302,17 @@ message CreateServiceRequest {
289
302
290
303
// Request message for DeleteService method.
291
304
message DeleteServiceRequest {
292
- // Required. The name of the service. See the [overview](/service-management/overview)
293
- // for naming requirements. For example: `example.googleapis.com`.
305
+ // Required. The name of the service. See the
306
+ // [overview](https://cloud.google.com/service-infrastructure/docs/overview) for naming requirements. For
307
+ // example: `example.googleapis.com`.
294
308
string service_name = 1 [(google.api.field_behavior ) = REQUIRED ];
295
309
}
296
310
297
311
// Request message for UndeleteService method.
298
312
message UndeleteServiceRequest {
299
- // Required. The name of the service. See the [overview](/service-management/overview)
300
- // for naming requirements. For example: `example.googleapis.com`.
313
+ // Required. The name of the service. See the
314
+ // [overview](https://cloud.google.com/service-infrastructure/docs/overview) for naming requirements. For
315
+ // example: `example.googleapis.com`.
301
316
string service_name = 1 [(google.api.field_behavior ) = REQUIRED ];
302
317
}
303
318
@@ -320,8 +335,9 @@ message GetServiceConfigRequest {
320
335
FULL = 1 ;
321
336
}
322
337
323
- // Required. The name of the service. See the [overview](/service-management/overview)
324
- // for naming requirements. For example: `example.googleapis.com`.
338
+ // Required. The name of the service. See the
339
+ // [overview](https://cloud.google.com/service-infrastructure/docs/overview) for naming requirements. For
340
+ // example: `example.googleapis.com`.
325
341
string service_name = 1 [(google.api.field_behavior ) = REQUIRED ];
326
342
327
343
// Required. The id of the service configuration resource.
@@ -337,8 +353,9 @@ message GetServiceConfigRequest {
337
353
338
354
// Request message for ListServiceConfigs method.
339
355
message ListServiceConfigsRequest {
340
- // Required. The name of the service. See the [overview](/service-management/overview)
341
- // for naming requirements. For example: `example.googleapis.com`.
356
+ // Required. The name of the service. See the
357
+ // [overview](https://cloud.google.com/service-infrastructure/docs/overview) for naming requirements. For
358
+ // example: `example.googleapis.com`.
342
359
string service_name = 1 [(google.api.field_behavior ) = REQUIRED ];
343
360
344
361
// The token of the page to retrieve.
@@ -360,18 +377,21 @@ message ListServiceConfigsResponse {
360
377
361
378
// Request message for CreateServiceConfig method.
362
379
message CreateServiceConfigRequest {
363
- // Required. The name of the service. See the [overview](/service-management/overview)
364
- // for naming requirements. For example: `example.googleapis.com`.
380
+ // Required. The name of the service. See the
381
+ // [overview](https://cloud.google.com/service-infrastructure/docs/overview) for naming requirements. For
382
+ // example: `example.googleapis.com`.
365
383
string service_name = 1 [(google.api.field_behavior ) = REQUIRED ];
366
384
367
385
// Required. The service configuration resource.
368
- google.api.Service service_config = 2 [(google.api.field_behavior ) = REQUIRED ];
386
+ google.api.Service service_config = 2
387
+ [(google.api.field_behavior ) = REQUIRED ];
369
388
}
370
389
371
390
// Request message for SubmitConfigSource method.
372
391
message SubmitConfigSourceRequest {
373
- // Required. The name of the service. See the [overview](/service-management/overview)
374
- // for naming requirements. For example: `example.googleapis.com`.
392
+ // Required. The name of the service. See the
393
+ // [overview](https://cloud.google.com/service-infrastructure/docs/overview) for naming requirements. For
394
+ // example: `example.googleapis.com`.
375
395
string service_name = 1 [(google.api.field_behavior ) = REQUIRED ];
376
396
377
397
// Required. The source configuration for the service.
@@ -391,8 +411,9 @@ message SubmitConfigSourceResponse {
391
411
392
412
// Request message for 'CreateServiceRollout'
393
413
message CreateServiceRolloutRequest {
394
- // Required. The name of the service. See the [overview](/service-management/overview)
395
- // for naming requirements. For example: `example.googleapis.com`.
414
+ // Required. The name of the service. See the
415
+ // [overview](https://cloud.google.com/service-infrastructure/docs/overview) for naming requirements. For
416
+ // example: `example.googleapis.com`.
396
417
string service_name = 1 [(google.api.field_behavior ) = REQUIRED ];
397
418
398
419
// Required. The rollout resource. The `service_name` field is output only.
@@ -401,8 +422,9 @@ message CreateServiceRolloutRequest {
401
422
402
423
// Request message for 'ListServiceRollouts'
403
424
message ListServiceRolloutsRequest {
404
- // Required. The name of the service. See the [overview](/service-management/overview)
405
- // for naming requirements. For example: `example.googleapis.com`.
425
+ // Required. The name of the service. See the
426
+ // [overview](https://cloud.google.com/service-infrastructure/docs/overview) for naming requirements. For
427
+ // example: `example.googleapis.com`.
406
428
string service_name = 1 [(google.api.field_behavior ) = REQUIRED ];
407
429
408
430
// The token of the page to retrieve.
@@ -415,10 +437,10 @@ message ListServiceRolloutsRequest {
415
437
// Required. Use `filter` to return subset of rollouts.
416
438
// The following filters are supported:
417
439
// -- To limit the results to only those in
418
- // [ status] (google.api.servicemanagement.v1.RolloutStatus) 'SUCCESS',
440
+ // status (google.api.servicemanagement.v1.RolloutStatus) 'SUCCESS',
419
441
// use filter='status=SUCCESS'
420
442
// -- To limit the results to those in
421
- // [ status] (google.api.servicemanagement.v1.RolloutStatus) 'CANCELLED'
443
+ // status (google.api.servicemanagement.v1.RolloutStatus) 'CANCELLED'
422
444
// or 'FAILED', use filter='status=CANCELLED OR status=FAILED'
423
445
string filter = 4 [(google.api.field_behavior ) = REQUIRED ];
424
446
}
@@ -434,8 +456,9 @@ message ListServiceRolloutsResponse {
434
456
435
457
// Request message for GetServiceRollout method.
436
458
message GetServiceRolloutRequest {
437
- // Required. The name of the service. See the [overview](/service-management/overview)
438
- // for naming requirements. For example: `example.googleapis.com`.
459
+ // Required. The name of the service. See the
460
+ // [overview](https://cloud.google.com/service-infrastructure/docs/overview) for naming requirements. For
461
+ // example: `example.googleapis.com`.
439
462
string service_name = 1 [(google.api.field_behavior ) = REQUIRED ];
440
463
441
464
// Required. The id of the rollout resource.
0 commit comments