23
23
* <pre>
24
24
* Manages long-running operations with an API service.
25
25
* When an API method normally takes long time to complete, it can be designed
26
- * to return [Operation][google.longrunning.Operation] to the client, and the client can use this
27
- * interface to receive the real response asynchronously by polling the
28
- * operation resource, or pass the operation resource to another API (such as
29
- * Google Cloud Pub/Sub API) to receive the response. Any API service that
30
- * returns long-running operations should implement the `Operations` interface
31
- * so developers can have a consistent client experience.
26
+ * to return [Operation][google.longrunning.Operation] to the client, and the
27
+ * client can use this interface to receive the real response asynchronously by
28
+ * polling the operation resource, or pass the operation resource to another API
29
+ * (such as Pub/Sub API) to receive the response. Any API service that returns
30
+ * long-running operations should implement the `Operations` interface so
31
+ * developers can have a consistent client experience.
32
32
* </pre>
33
33
*/
34
34
@ javax .annotation .Generated (
@@ -296,12 +296,12 @@ public OperationsFutureStub newStub(
296
296
* <pre>
297
297
* Manages long-running operations with an API service.
298
298
* When an API method normally takes long time to complete, it can be designed
299
- * to return [Operation][google.longrunning.Operation] to the client, and the client can use this
300
- * interface to receive the real response asynchronously by polling the
301
- * operation resource, or pass the operation resource to another API (such as
302
- * Google Cloud Pub/Sub API) to receive the response. Any API service that
303
- * returns long-running operations should implement the `Operations` interface
304
- * so developers can have a consistent client experience.
299
+ * to return [Operation][google.longrunning.Operation] to the client, and the
300
+ * client can use this interface to receive the real response asynchronously by
301
+ * polling the operation resource, or pass the operation resource to another API
302
+ * (such as Pub/Sub API) to receive the response. Any API service that returns
303
+ * long-running operations should implement the `Operations` interface so
304
+ * developers can have a consistent client experience.
305
305
* </pre>
306
306
*/
307
307
public interface AsyncService {
@@ -312,13 +312,6 @@ public interface AsyncService {
312
312
* <pre>
313
313
* Lists operations that match the specified filter in the request. If the
314
314
* server doesn't support this method, it returns `UNIMPLEMENTED`.
315
- * NOTE: the `name` binding allows API services to override the binding
316
- * to use different resource name schemes, such as `users/*/operations`. To
317
- * override the binding, API services can add a binding such as
318
- * `"/v1/{name=users/*}/operations"` to their service configuration.
319
- * For backwards compatibility, the default name includes the operations
320
- * collection id, however overriding users must ensure the name binding
321
- * is the parent resource, without the operations collection id.
322
315
* </pre>
323
316
*/
324
317
default void listOperations (
@@ -374,8 +367,9 @@ default void deleteOperation(
374
367
* other methods to check whether the cancellation succeeded or whether the
375
368
* operation completed despite cancellation. On successful cancellation,
376
369
* the operation is not deleted; instead, it becomes an operation with
377
- * an [Operation.error][google.longrunning.Operation.error] value with a [google.rpc.Status.code][google.rpc.Status.code] of 1,
378
- * corresponding to `Code.CANCELLED`.
370
+ * an [Operation.error][google.longrunning.Operation.error] value with a
371
+ * [google.rpc.Status.code][google.rpc.Status.code] of `1`, corresponding to
372
+ * `Code.CANCELLED`.
379
373
* </pre>
380
374
*/
381
375
default void cancelOperation (
@@ -414,12 +408,12 @@ default void waitOperation(
414
408
* <pre>
415
409
* Manages long-running operations with an API service.
416
410
* When an API method normally takes long time to complete, it can be designed
417
- * to return [Operation][google.longrunning.Operation] to the client, and the client can use this
418
- * interface to receive the real response asynchronously by polling the
419
- * operation resource, or pass the operation resource to another API (such as
420
- * Google Cloud Pub/Sub API) to receive the response. Any API service that
421
- * returns long-running operations should implement the `Operations` interface
422
- * so developers can have a consistent client experience.
411
+ * to return [Operation][google.longrunning.Operation] to the client, and the
412
+ * client can use this interface to receive the real response asynchronously by
413
+ * polling the operation resource, or pass the operation resource to another API
414
+ * (such as Pub/Sub API) to receive the response. Any API service that returns
415
+ * long-running operations should implement the `Operations` interface so
416
+ * developers can have a consistent client experience.
423
417
* </pre>
424
418
*/
425
419
public abstract static class OperationsImplBase implements io .grpc .BindableService , AsyncService {
@@ -436,12 +430,12 @@ public final io.grpc.ServerServiceDefinition bindService() {
436
430
* <pre>
437
431
* Manages long-running operations with an API service.
438
432
* When an API method normally takes long time to complete, it can be designed
439
- * to return [Operation][google.longrunning.Operation] to the client, and the client can use this
440
- * interface to receive the real response asynchronously by polling the
441
- * operation resource, or pass the operation resource to another API (such as
442
- * Google Cloud Pub/Sub API) to receive the response. Any API service that
443
- * returns long-running operations should implement the `Operations` interface
444
- * so developers can have a consistent client experience.
433
+ * to return [Operation][google.longrunning.Operation] to the client, and the
434
+ * client can use this interface to receive the real response asynchronously by
435
+ * polling the operation resource, or pass the operation resource to another API
436
+ * (such as Pub/Sub API) to receive the response. Any API service that returns
437
+ * long-running operations should implement the `Operations` interface so
438
+ * developers can have a consistent client experience.
445
439
* </pre>
446
440
*/
447
441
public static final class OperationsStub extends io .grpc .stub .AbstractAsyncStub <OperationsStub > {
@@ -460,13 +454,6 @@ protected OperationsStub build(io.grpc.Channel channel, io.grpc.CallOptions call
460
454
* <pre>
461
455
* Lists operations that match the specified filter in the request. If the
462
456
* server doesn't support this method, it returns `UNIMPLEMENTED`.
463
- * NOTE: the `name` binding allows API services to override the binding
464
- * to use different resource name schemes, such as `users/*/operations`. To
465
- * override the binding, API services can add a binding such as
466
- * `"/v1/{name=users/*}/operations"` to their service configuration.
467
- * For backwards compatibility, the default name includes the operations
468
- * collection id, however overriding users must ensure the name binding
469
- * is the parent resource, without the operations collection id.
470
457
* </pre>
471
458
*/
472
459
public void listOperations (
@@ -528,8 +515,9 @@ public void deleteOperation(
528
515
* other methods to check whether the cancellation succeeded or whether the
529
516
* operation completed despite cancellation. On successful cancellation,
530
517
* the operation is not deleted; instead, it becomes an operation with
531
- * an [Operation.error][google.longrunning.Operation.error] value with a [google.rpc.Status.code][google.rpc.Status.code] of 1,
532
- * corresponding to `Code.CANCELLED`.
518
+ * an [Operation.error][google.longrunning.Operation.error] value with a
519
+ * [google.rpc.Status.code][google.rpc.Status.code] of `1`, corresponding to
520
+ * `Code.CANCELLED`.
533
521
* </pre>
534
522
*/
535
523
public void cancelOperation (
@@ -572,12 +560,12 @@ public void waitOperation(
572
560
* <pre>
573
561
* Manages long-running operations with an API service.
574
562
* When an API method normally takes long time to complete, it can be designed
575
- * to return [Operation][google.longrunning.Operation] to the client, and the client can use this
576
- * interface to receive the real response asynchronously by polling the
577
- * operation resource, or pass the operation resource to another API (such as
578
- * Google Cloud Pub/Sub API) to receive the response. Any API service that
579
- * returns long-running operations should implement the `Operations` interface
580
- * so developers can have a consistent client experience.
563
+ * to return [Operation][google.longrunning.Operation] to the client, and the
564
+ * client can use this interface to receive the real response asynchronously by
565
+ * polling the operation resource, or pass the operation resource to another API
566
+ * (such as Pub/Sub API) to receive the response. Any API service that returns
567
+ * long-running operations should implement the `Operations` interface so
568
+ * developers can have a consistent client experience.
581
569
* </pre>
582
570
*/
583
571
public static final class OperationsBlockingStub
@@ -598,13 +586,6 @@ protected OperationsBlockingStub build(
598
586
* <pre>
599
587
* Lists operations that match the specified filter in the request. If the
600
588
* server doesn't support this method, it returns `UNIMPLEMENTED`.
601
- * NOTE: the `name` binding allows API services to override the binding
602
- * to use different resource name schemes, such as `users/*/operations`. To
603
- * override the binding, API services can add a binding such as
604
- * `"/v1/{name=users/*}/operations"` to their service configuration.
605
- * For backwards compatibility, the default name includes the operations
606
- * collection id, however overriding users must ensure the name binding
607
- * is the parent resource, without the operations collection id.
608
589
* </pre>
609
590
*/
610
591
public com .google .longrunning .ListOperationsResponse listOperations (
@@ -656,8 +637,9 @@ public com.google.protobuf.Empty deleteOperation(
656
637
* other methods to check whether the cancellation succeeded or whether the
657
638
* operation completed despite cancellation. On successful cancellation,
658
639
* the operation is not deleted; instead, it becomes an operation with
659
- * an [Operation.error][google.longrunning.Operation.error] value with a [google.rpc.Status.code][google.rpc.Status.code] of 1,
660
- * corresponding to `Code.CANCELLED`.
640
+ * an [Operation.error][google.longrunning.Operation.error] value with a
641
+ * [google.rpc.Status.code][google.rpc.Status.code] of `1`, corresponding to
642
+ * `Code.CANCELLED`.
661
643
* </pre>
662
644
*/
663
645
public com .google .protobuf .Empty cancelOperation (
@@ -694,12 +676,12 @@ public com.google.longrunning.Operation waitOperation(
694
676
* <pre>
695
677
* Manages long-running operations with an API service.
696
678
* When an API method normally takes long time to complete, it can be designed
697
- * to return [Operation][google.longrunning.Operation] to the client, and the client can use this
698
- * interface to receive the real response asynchronously by polling the
699
- * operation resource, or pass the operation resource to another API (such as
700
- * Google Cloud Pub/Sub API) to receive the response. Any API service that
701
- * returns long-running operations should implement the `Operations` interface
702
- * so developers can have a consistent client experience.
679
+ * to return [Operation][google.longrunning.Operation] to the client, and the
680
+ * client can use this interface to receive the real response asynchronously by
681
+ * polling the operation resource, or pass the operation resource to another API
682
+ * (such as Pub/Sub API) to receive the response. Any API service that returns
683
+ * long-running operations should implement the `Operations` interface so
684
+ * developers can have a consistent client experience.
703
685
* </pre>
704
686
*/
705
687
public static final class OperationsFutureStub
@@ -719,13 +701,6 @@ protected OperationsFutureStub build(io.grpc.Channel channel, io.grpc.CallOption
719
701
* <pre>
720
702
* Lists operations that match the specified filter in the request. If the
721
703
* server doesn't support this method, it returns `UNIMPLEMENTED`.
722
- * NOTE: the `name` binding allows API services to override the binding
723
- * to use different resource name schemes, such as `users/*/operations`. To
724
- * override the binding, API services can add a binding such as
725
- * `"/v1/{name=users/*}/operations"` to their service configuration.
726
- * For backwards compatibility, the default name includes the operations
727
- * collection id, however overriding users must ensure the name binding
728
- * is the parent resource, without the operations collection id.
729
704
* </pre>
730
705
*/
731
706
public com .google .common .util .concurrent .ListenableFuture <
@@ -778,8 +753,9 @@ protected OperationsFutureStub build(io.grpc.Channel channel, io.grpc.CallOption
778
753
* other methods to check whether the cancellation succeeded or whether the
779
754
* operation completed despite cancellation. On successful cancellation,
780
755
* the operation is not deleted; instead, it becomes an operation with
781
- * an [Operation.error][google.longrunning.Operation.error] value with a [google.rpc.Status.code][google.rpc.Status.code] of 1,
782
- * corresponding to `Code.CANCELLED`.
756
+ * an [Operation.error][google.longrunning.Operation.error] value with a
757
+ * [google.rpc.Status.code][google.rpc.Status.code] of `1`, corresponding to
758
+ * `Code.CANCELLED`.
783
759
* </pre>
784
760
*/
785
761
public com .google .common .util .concurrent .ListenableFuture <com .google .protobuf .Empty >
0 commit comments