google-apis-logging_v2 0.10.0 → 0.14.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (8) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +17 -0
  3. data/lib/google/apis/logging_v2/classes.rb +397 -68
  4. data/lib/google/apis/logging_v2/gem_version.rb +3 -3
  5. data/lib/google/apis/logging_v2/representations.rb +142 -0
  6. data/lib/google/apis/logging_v2/service.rb +978 -364
  7. data/lib/google/apis/logging_v2.rb +2 -2
  8. metadata +13 -7
data/lib/google/apis/logging_v2/gem_version.rb CHANGED
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module LoggingV2
18
18
  # Version of the google-apis-logging_v2 gem
19
- GEM_VERSION = "0.10.0"
19
+ GEM_VERSION = "0.14.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
- GENERATOR_VERSION = "0.3.0"
22
+ GENERATOR_VERSION = "0.4.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20210522"
25
+ REVISION = "20210817"
26
26
  end
27
27
  end
28
28
  end
data/lib/google/apis/logging_v2/representations.rb CHANGED
@@ -34,12 +34,36 @@ module Google
34
34
  include Google::Apis::Core::JsonObjectSupport
35
35
  end
36
36
 
37
+ class CancelOperationRequest
38
+ class Representation < Google::Apis::Core::JsonRepresentation; end
39
+
40
+ include Google::Apis::Core::JsonObjectSupport
41
+ end
42
+
37
43
  class CmekSettings
38
44
  class Representation < Google::Apis::Core::JsonRepresentation; end
39
45
 
40
46
  include Google::Apis::Core::JsonObjectSupport
41
47
  end
42
48
 
49
+ class CopyLogEntriesMetadata
50
+ class Representation < Google::Apis::Core::JsonRepresentation; end
51
+
52
+ include Google::Apis::Core::JsonObjectSupport
53
+ end
54
+
55
+ class CopyLogEntriesRequest
56
+ class Representation < Google::Apis::Core::JsonRepresentation; end
57
+
58
+ include Google::Apis::Core::JsonObjectSupport
59
+ end
60
+
61
+ class CopyLogEntriesResponse
62
+ class Representation < Google::Apis::Core::JsonRepresentation; end
63
+
64
+ include Google::Apis::Core::JsonObjectSupport
65
+ end
66
+
43
67
  class Empty
44
68
  class Representation < Google::Apis::Core::JsonRepresentation; end
45
69
 
@@ -124,6 +148,12 @@ module Google
124
148
  include Google::Apis::Core::JsonObjectSupport
125
149
  end
126
150
 
151
+ class ListOperationsResponse
152
+ class Representation < Google::Apis::Core::JsonRepresentation; end
153
+
154
+ include Google::Apis::Core::JsonObjectSupport
155
+ end
156
+
127
157
  class ListSinksResponse
128
158
  class Representation < Google::Apis::Core::JsonRepresentation; end
129
159
 
@@ -226,6 +256,12 @@ module Google
226
256
  include Google::Apis::Core::JsonObjectSupport
227
257
  end
228
258
 
259
+ class Operation
260
+ class Representation < Google::Apis::Core::JsonRepresentation; end
261
+
262
+ include Google::Apis::Core::JsonObjectSupport
263
+ end
264
+
229
265
  class RequestLog
230
266
  class Representation < Google::Apis::Core::JsonRepresentation; end
231
267
 
@@ -244,12 +280,30 @@ module Google
244
280
  include Google::Apis::Core::JsonObjectSupport
245
281
  end
246
282
 
283
+ class Status
284
+ class Representation < Google::Apis::Core::JsonRepresentation; end
285
+
286
+ include Google::Apis::Core::JsonObjectSupport
287
+ end
288
+
247
289
  class SuppressionInfo
248
290
  class Representation < Google::Apis::Core::JsonRepresentation; end
249
291
 
250
292
  include Google::Apis::Core::JsonObjectSupport
251
293
  end
252
294
 
295
+ class TableFieldSchema
296
+ class Representation < Google::Apis::Core::JsonRepresentation; end
297
+
298
+ include Google::Apis::Core::JsonObjectSupport
299
+ end
300
+
301
+ class TableSchema
302
+ class Representation < Google::Apis::Core::JsonRepresentation; end
303
+
304
+ include Google::Apis::Core::JsonObjectSupport
305
+ end
306
+
253
307
  class TailLogEntriesRequest
254
308
  class Representation < Google::Apis::Core::JsonRepresentation; end
255
309
 
@@ -300,6 +354,12 @@ module Google
300
354
  end
301
355
  end
302
356
 
357
+ class CancelOperationRequest
358
+ # @private
359
+ class Representation < Google::Apis::Core::JsonRepresentation
360
+ end
361
+ end
362
+
303
363
  class CmekSettings
304
364
  # @private
305
365
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -309,6 +369,36 @@ module Google
309
369
  end
310
370
  end
311
371
 
372
+ class CopyLogEntriesMetadata
373
+ # @private
374
+ class Representation < Google::Apis::Core::JsonRepresentation
375
+ property :cancellation_requested, as: 'cancellationRequested'
376
+ property :end_time, as: 'endTime'
377
+ property :progress, as: 'progress'
378
+ property :request, as: 'request', class: Google::Apis::LoggingV2::CopyLogEntriesRequest, decorator: Google::Apis::LoggingV2::CopyLogEntriesRequest::Representation
379
+
380
+ property :start_time, as: 'startTime'
381
+ property :state, as: 'state'
382
+ property :writer_identity, as: 'writerIdentity'
383
+ end
384
+ end
385
+
386
+ class CopyLogEntriesRequest
387
+ # @private
388
+ class Representation < Google::Apis::Core::JsonRepresentation
389
+ property :destination, as: 'destination'
390
+ property :filter, as: 'filter'
391
+ property :name, as: 'name'
392
+ end
393
+ end
394
+
395
+ class CopyLogEntriesResponse
396
+ # @private
397
+ class Representation < Google::Apis::Core::JsonRepresentation
398
+ property :log_entries_copied_count, :numeric_string => true, as: 'logEntriesCopiedCount'
399
+ end
400
+ end
401
+
312
402
  class Empty
313
403
  # @private
314
404
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -444,6 +534,15 @@ module Google
444
534
  end
445
535
  end
446
536
 
537
+ class ListOperationsResponse
538
+ # @private
539
+ class Representation < Google::Apis::Core::JsonRepresentation
540
+ property :next_page_token, as: 'nextPageToken'
541
+ collection :operations, as: 'operations', class: Google::Apis::LoggingV2::Operation, decorator: Google::Apis::LoggingV2::Operation::Representation
542
+
543
+ end
544
+ end
545
+
447
546
  class ListSinksResponse
448
547
  # @private
449
548
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -603,6 +702,8 @@ module Google
603
702
  property :description, as: 'description'
604
703
  property :filter, as: 'filter'
605
704
  property :name, as: 'name'
705
+ property :schema, as: 'schema', class: Google::Apis::LoggingV2::TableSchema, decorator: Google::Apis::LoggingV2::TableSchema::Representation
706
+
606
707
  property :update_time, as: 'updateTime'
607
708
  end
608
709
  end
@@ -664,6 +765,18 @@ module Google
664
765
  end
665
766
  end
666
767
 
768
+ class Operation
769
+ # @private
770
+ class Representation < Google::Apis::Core::JsonRepresentation
771
+ property :done, as: 'done'
772
+ property :error, as: 'error', class: Google::Apis::LoggingV2::Status, decorator: Google::Apis::LoggingV2::Status::Representation
773
+
774
+ hash :metadata, as: 'metadata'
775
+ property :name, as: 'name'
776
+ hash :response, as: 'response'
777
+ end
778
+ end
779
+
667
780
  class RequestLog
668
781
  # @private
669
782
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -722,6 +835,15 @@ module Google
722
835
  end
723
836
  end
724
837
 
838
+ class Status
839
+ # @private
840
+ class Representation < Google::Apis::Core::JsonRepresentation
841
+ property :code, as: 'code'
842
+ collection :details, as: 'details'
843
+ property :message, as: 'message'
844
+ end
845
+ end
846
+
725
847
  class SuppressionInfo
726
848
  # @private
727
849
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -730,6 +852,26 @@ module Google
730
852
  end
731
853
  end
732
854
 
855
+ class TableFieldSchema
856
+ # @private
857
+ class Representation < Google::Apis::Core::JsonRepresentation
858
+ property :description, as: 'description'
859
+ collection :fields, as: 'fields', class: Google::Apis::LoggingV2::TableFieldSchema, decorator: Google::Apis::LoggingV2::TableFieldSchema::Representation
860
+
861
+ property :mode, as: 'mode'
862
+ property :name, as: 'name'
863
+ property :type, as: 'type'
864
+ end
865
+ end
866
+
867
+ class TableSchema
868
+ # @private
869
+ class Representation < Google::Apis::Core::JsonRepresentation
870
+ collection :fields, as: 'fields', class: Google::Apis::LoggingV2::TableFieldSchema, decorator: Google::Apis::LoggingV2::TableFieldSchema::Representation
871
+
872
+ end
873
+ end
874
+
733
875
  class TailLogEntriesRequest
734
876
  # @private
735
877
  class Representation < Google::Apis::Core::JsonRepresentation
data/lib/google/apis/logging_v2/service.rb CHANGED
@@ -52,14 +52,14 @@ module Google
52
52
  @batch_path = 'batch'
53
53
  end
54
54
 
55
- # Gets a bucket.
55
+ # Gets a log bucket.
56
56
  # @param [String] name
57
57
  # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
58
58
  # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
59
59
  # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
60
60
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[
61
- # LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-project-id/locations/
62
- # my-location/buckets/my-bucket-id".
61
+ # LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/
62
+ # global/buckets/my-bucket"
63
63
  # @param [String] fields
64
64
  # Selector specifying which fields to include in a partial response.
65
65
  # @param [String] quota_user
@@ -87,11 +87,11 @@ module Google
87
87
  execute_or_queue_command(command, &block)
88
88
  end
89
89
 
90
- # Gets a view.
90
+ # Gets a view on a log bucket..
91
91
  # @param [String] name
92
92
  # Required. The resource name of the policy: "projects/[PROJECT_ID]/locations/[
93
- # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "projects/my-
94
- # project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id".
93
+ # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-
94
+ # project/locations/global/buckets/my-bucket/views/my-view"
95
95
  # @param [String] fields
96
96
  # Selector specifying which fields to include in a partial response.
97
97
  # @param [String] quota_user
@@ -125,8 +125,8 @@ module Google
125
125
  # @param [String] parent
126
126
  # Required. The parent resource in which to create the exclusion: "projects/[
127
127
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
128
- # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
129
- # project", "organizations/123456789".
128
+ # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" For examples:"projects/my-logging-
129
+ # project" "organizations/123456789"
130
130
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
131
131
  # @param [String] fields
132
132
  # Selector specifying which fields to include in a partial response.
@@ -162,8 +162,8 @@ module Google
162
162
  # Required. The resource name of an existing exclusion to delete: "projects/[
163
163
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
164
164
  # exclusions/[EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[
165
- # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "
166
- # projects/my-project-id/exclusions/my-exclusion-id".
165
+ # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"
166
+ # projects/my-project/exclusions/my-exclusion"
167
167
  # @param [String] fields
168
168
  # Selector specifying which fields to include in a partial response.
169
169
  # @param [String] quota_user
@@ -196,8 +196,8 @@ module Google
196
196
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
197
197
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
198
198
  # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
199
- # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
200
- # id/exclusions/my-exclusion-id".
199
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
200
+ # project/exclusions/my-exclusion"
201
201
  # @param [String] fields
202
202
  # Selector specifying which fields to include in a partial response.
203
203
  # @param [String] quota_user
@@ -273,8 +273,8 @@ module Google
273
273
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
274
274
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
275
275
  # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
276
- # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
277
- # id/exclusions/my-exclusion-id".
276
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
277
+ # project/exclusions/my-exclusion"
278
278
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
279
279
  # @param [String] update_mask
280
280
  # Required. A non-empty list of fields to change in the existing exclusion. New
@@ -386,12 +386,12 @@ module Google
386
386
  execute_or_queue_command(command, &block)
387
387
  end
388
388
 
389
- # Creates a bucket that can be used to store log entries. Once a bucket has been
390
- # created, the region cannot be changed.
389
+ # Creates a log bucket that can be used to store log entries. After a bucket has
390
+ # been created, the bucket's location cannot be changed.
391
391
  # @param [String] parent
392
- # Required. The resource in which to create the bucket: "projects/[PROJECT_ID]/
393
- # locations/[LOCATION_ID]" Example: "projects/my-logging-project/locations/
394
- # global"
392
+ # Required. The resource in which to create the log bucket: "projects/[
393
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
394
+ # locations/global"
395
395
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
396
396
  # @param [String] bucket_id
397
397
  # Required. A client-assigned identifier such as "my-bucket". Identifiers are
@@ -427,16 +427,16 @@ module Google
427
427
  execute_or_queue_command(command, &block)
428
428
  end
429
429
 
430
- # Deletes a bucket. Moves the bucket to the DELETE_REQUESTED state. After 7 days,
431
- # the bucket will be purged and all logs in the bucket will be permanently
432
- # deleted.
430
+ # Deletes a log bucket.Changes the bucket's lifecycle_state to the
431
+ # DELETE_REQUESTED state. After 7 days, the bucket will be purged and all log
432
+ # entries in the bucket will be permanently deleted.
433
433
  # @param [String] name
434
434
  # Required. The full resource name of the bucket to delete. "projects/[
435
435
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
436
436
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
437
437
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
438
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
439
- # project-id/locations/my-location/buckets/my-bucket-id".
438
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
439
+ # my-project/locations/global/buckets/my-bucket"
440
440
  # @param [String] fields
441
441
  # Selector specifying which fields to include in a partial response.
442
442
  # @param [String] quota_user
@@ -464,7 +464,7 @@ module Google
464
464
  execute_or_queue_command(command, &block)
465
465
  end
466
466
 
467
- # Lists buckets.
467
+ # Lists log buckets.
468
468
  # @param [String] parent
469
469
  # Required. The parent resource whose buckets are to be listed: "projects/[
470
470
  # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -510,27 +510,27 @@ module Google
510
510
  execute_or_queue_command(command, &block)
511
511
  end
512
512
 
513
- # Updates a bucket. This method replaces the following fields in the existing
514
- # bucket with values from the new bucket: retention_periodIf the retention
515
- # period is decreased and the bucket is locked, FAILED_PRECONDITION will be
516
- # returned.If the bucket has a LifecycleState of DELETE_REQUESTED,
517
- # FAILED_PRECONDITION will be returned.A buckets region may not be modified
518
- # after it is created.
513
+ # Updates a log bucket. This method replaces the following fields in the
514
+ # existing bucket with values from the new bucket: retention_periodIf the
515
+ # retention period is decreased and the bucket is locked, FAILED_PRECONDITION
516
+ # will be returned.If the bucket has a lifecycle_state of DELETE_REQUESTED, then
517
+ # FAILED_PRECONDITION will be returned.After a bucket has been created, the
518
+ # bucket's location cannot be changed.
519
519
  # @param [String] name
520
520
  # Required. The full resource name of the bucket to update. "projects/[
521
521
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
522
522
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
523
523
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
524
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
525
- # project-id/locations/my-location/buckets/my-bucket-id". Also requires
526
- # permission "resourcemanager.projects.updateLiens" to set the locked property
524
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
525
+ # my-project/locations/global/buckets/my-bucket"
527
526
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
528
527
  # @param [String] update_mask
529
528
  # Required. Field mask that specifies the fields in bucket that need an update.
530
529
  # A bucket field will be overwritten if, and only if, it is in the update mask.
531
530
  # name and output only fields cannot be updated.For a detailed FieldMask
532
- # definition, see https://developers.google.com/protocol-buffers/docs/reference/
533
- # google.protobuf#google.protobuf.FieldMaskExample: updateMask=retention_days.
531
+ # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
532
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
533
+ # retention_days
534
534
  # @param [String] fields
535
535
  # Selector specifying which fields to include in a partial response.
536
536
  # @param [String] quota_user
@@ -561,15 +561,15 @@ module Google
561
561
  execute_or_queue_command(command, &block)
562
562
  end
563
563
 
564
- # Undeletes a bucket. A bucket that has been deleted may be undeleted within the
565
- # grace period of 7 days.
564
+ # Undeletes a log bucket. A bucket that has been deleted can be undeleted within
565
+ # the grace period of 7 days.
566
566
  # @param [String] name
567
567
  # Required. The full resource name of the bucket to undelete. "projects/[
568
568
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
569
569
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
570
570
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
571
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
572
- # project-id/locations/my-location/buckets/my-bucket-id".
571
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
572
+ # my-project/locations/global/buckets/my-bucket"
573
573
  # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_request_object
574
574
  # @param [String] fields
575
575
  # Selector specifying which fields to include in a partial response.
@@ -600,12 +600,12 @@ module Google
600
600
  execute_or_queue_command(command, &block)
601
601
  end
602
602
 
603
- # Creates a view over logs in a bucket. A bucket may contain a maximum of 50
604
- # views.
603
+ # Creates a view over log entries in a log bucket. A bucket may contain a
604
+ # maximum of 30 views.
605
605
  # @param [String] parent
606
- # Required. The bucket in which to create the view "projects/[PROJECT_ID]/
607
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-logging-
608
- # project/locations/my-location/buckets/my-bucket"
606
+ # Required. The bucket in which to create the view `"projects/[PROJECT_ID]/
607
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"` For example:"projects/my-project/
608
+ # locations/global/buckets/my-bucket"
609
609
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
610
610
  # @param [String] view_id
611
611
  # Required. The id to use for this view.
@@ -639,12 +639,11 @@ module Google
639
639
  execute_or_queue_command(command, &block)
640
640
  end
641
641
 
642
- # Deletes a view from a bucket.
642
+ # Deletes a view on a log bucket.
643
643
  # @param [String] name
644
644
  # Required. The full resource name of the view to delete: "projects/[PROJECT_ID]/
645
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
646
- # projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
647
- # view-id".
645
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
646
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
648
647
  # @param [String] fields
649
648
  # Selector specifying which fields to include in a partial response.
650
649
  # @param [String] quota_user
@@ -672,12 +671,12 @@ module Google
672
671
  execute_or_queue_command(command, &block)
673
672
  end
674
673
 
675
- # Lists views on a bucket.
674
+ # Lists views on a log bucket.
676
675
  # @param [String] parent
677
676
  # Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
678
677
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
679
678
  # @param [Fixnum] page_size
680
- # Optional. The maximum number of results to return from this request. Non-
679
+ # Optional. The maximum number of results to return from this request.Non-
681
680
  # positive values are ignored. The presence of nextPageToken in the response
682
681
  # indicates that more results might be available.
683
682
  # @param [String] page_token
@@ -714,20 +713,19 @@ module Google
714
713
  execute_or_queue_command(command, &block)
715
714
  end
716
715
 
717
- # Updates a view. This method replaces the following fields in the existing view
718
- # with values from the new view: filter.
716
+ # Updates a view on a log bucket. This method replaces the following fields in
717
+ # the existing view with values from the new view: filter.
719
718
  # @param [String] name
720
719
  # Required. The full resource name of the view to update "projects/[PROJECT_ID]/
721
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
722
- # projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
723
- # view-id".
720
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
721
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
724
722
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
725
723
  # @param [String] update_mask
726
724
  # Optional. Field mask that specifies the fields in view that need an update. A
727
725
  # field will be overwritten if, and only if, it is in the update mask. name and
728
726
  # output only fields cannot be updated.For a detailed FieldMask definition, see
729
727
  # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
730
- # google.protobuf.FieldMaskExample: updateMask=filter.
728
+ # google.protobuf.FieldMaskFor example: updateMask=filter
731
729
  # @param [String] fields
732
730
  # Selector specifying which fields to include in a partial response.
733
731
  # @param [String] quota_user
@@ -758,6 +756,92 @@ module Google
758
756
  execute_or_queue_command(command, &block)
759
757
  end
760
758
 
759
+ # Starts asynchronous cancellation on a long-running operation. The server makes
760
+ # a best effort to cancel the operation, but success is not guaranteed. If the
761
+ # server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.
762
+ # Clients can use Operations.GetOperation or other methods to check whether the
763
+ # cancellation succeeded or whether the operation completed despite cancellation.
764
+ # On successful cancellation, the operation is not deleted; instead, it becomes
765
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
766
+ # corresponding to Code.CANCELLED.
767
+ # @param [String] name
768
+ # The name of the operation resource to be cancelled.
769
+ # @param [Google::Apis::LoggingV2::CancelOperationRequest] cancel_operation_request_object
770
+ # @param [String] fields
771
+ # Selector specifying which fields to include in a partial response.
772
+ # @param [String] quota_user
773
+ # Available to use for quota purposes for server-side applications. Can be any
774
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
775
+ # @param [Google::Apis::RequestOptions] options
776
+ # Request-specific options
777
+ #
778
+ # @yield [result, err] Result & error if block supplied
779
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
780
+ # @yieldparam err [StandardError] error object if request failed
781
+ #
782
+ # @return [Google::Apis::LoggingV2::Empty]
783
+ #
784
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
785
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
786
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
787
+ def cancel_billing_account_location_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
788
+ command = make_simple_command(:post, 'v2/{+name}:cancel', options)
789
+ command.request_representation = Google::Apis::LoggingV2::CancelOperationRequest::Representation
790
+ command.request_object = cancel_operation_request_object
791
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
792
+ command.response_class = Google::Apis::LoggingV2::Empty
793
+ command.params['name'] = name unless name.nil?
794
+ command.query['fields'] = fields unless fields.nil?
795
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
796
+ execute_or_queue_command(command, &block)
797
+ end
798
+
799
+ # Lists operations that match the specified filter in the request. If the server
800
+ # doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name binding
801
+ # allows API services to override the binding to use different resource name
802
+ # schemes, such as users/*/operations. To override the binding, API services can
803
+ # add a binding such as "/v1/`name=users/*`/operations" to their service
804
+ # configuration. For backwards compatibility, the default name includes the
805
+ # operations collection id, however overriding users must ensure the name
806
+ # binding is the parent resource, without the operations collection id.
807
+ # @param [String] name
808
+ # The name of the operation's parent resource.
809
+ # @param [String] filter
810
+ # The standard list filter.
811
+ # @param [Fixnum] page_size
812
+ # The standard list page size.
813
+ # @param [String] page_token
814
+ # The standard list page token.
815
+ # @param [String] fields
816
+ # Selector specifying which fields to include in a partial response.
817
+ # @param [String] quota_user
818
+ # Available to use for quota purposes for server-side applications. Can be any
819
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
820
+ # @param [Google::Apis::RequestOptions] options
821
+ # Request-specific options
822
+ #
823
+ # @yield [result, err] Result & error if block supplied
824
+ # @yieldparam result [Google::Apis::LoggingV2::ListOperationsResponse] parsed result object
825
+ # @yieldparam err [StandardError] error object if request failed
826
+ #
827
+ # @return [Google::Apis::LoggingV2::ListOperationsResponse]
828
+ #
829
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
830
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
831
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
832
+ def list_billing_account_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
833
+ command = make_simple_command(:get, 'v2/{+name}/operations', options)
834
+ command.response_representation = Google::Apis::LoggingV2::ListOperationsResponse::Representation
835
+ command.response_class = Google::Apis::LoggingV2::ListOperationsResponse
836
+ command.params['name'] = name unless name.nil?
837
+ command.query['filter'] = filter unless filter.nil?
838
+ command.query['pageSize'] = page_size unless page_size.nil?
839
+ command.query['pageToken'] = page_token unless page_token.nil?
840
+ command.query['fields'] = fields unless fields.nil?
841
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
842
+ execute_or_queue_command(command, &block)
843
+ end
844
+
761
845
  # Deletes all the log entries in a log for the _Default Log Bucket. The log
762
846
  # reappears if it receives new entries. Log entries written shortly before the
763
847
  # delete operation might not be deleted. Entries received after the delete
@@ -850,6 +934,37 @@ module Google
850
934
  execute_or_queue_command(command, &block)
851
935
  end
852
936
 
937
+ # Gets the latest state of a long-running operation. Clients can use this method
938
+ # to poll the operation result at intervals as recommended by the API service.
939
+ # @param [String] name
940
+ # The name of the operation resource.
941
+ # @param [String] fields
942
+ # Selector specifying which fields to include in a partial response.
943
+ # @param [String] quota_user
944
+ # Available to use for quota purposes for server-side applications. Can be any
945
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
946
+ # @param [Google::Apis::RequestOptions] options
947
+ # Request-specific options
948
+ #
949
+ # @yield [result, err] Result & error if block supplied
950
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
951
+ # @yieldparam err [StandardError] error object if request failed
952
+ #
953
+ # @return [Google::Apis::LoggingV2::Operation]
954
+ #
955
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
956
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
957
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
958
+ def get_billing_account_operation(name, fields: nil, quota_user: nil, options: nil, &block)
959
+ command = make_simple_command(:get, 'v2/{+name}', options)
960
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
961
+ command.response_class = Google::Apis::LoggingV2::Operation
962
+ command.params['name'] = name unless name.nil?
963
+ command.query['fields'] = fields unless fields.nil?
964
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
965
+ execute_or_queue_command(command, &block)
966
+ end
967
+
853
968
  # Creates a sink that exports specified log entries to a destination. The export
854
969
  # of newly-ingested log entries begins immediately, unless the sink's
855
970
  # writer_identity is not permitted to write to the destination. A sink can
@@ -857,14 +972,14 @@ module Google
857
972
  # @param [String] parent
858
973
  # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" "
859
974
  # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" "
860
- # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/
861
- # 123456789".
975
+ # folders/[FOLDER_ID]" For examples:"projects/my-project" "organizations/
976
+ # 123456789"
862
977
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
863
978
  # @param [Boolean] unique_writer_identity
864
979
  # Optional. Determines the kind of IAM identity returned as writer_identity in
865
980
  # the new sink. If this value is omitted or set to false, and if the sink's
866
981
  # parent is a project, then the value returned as writer_identity is the same
867
- # group or service account used by Logging before the addition of writer
982
+ # group or service account used by Cloud Logging before the addition of writer
868
983
  # identities to this API. The sink's destination must be in the same project as
869
984
  # the sink itself.If this field is set to true, or if the sink is owned by a non-
870
985
  # project resource such as an organization, then the value of writer_identity
@@ -906,8 +1021,8 @@ module Google
906
1021
  # Required. The full resource name of the sink to delete, including the parent
907
1022
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
908
1023
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
909
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
910
- # Example: "projects/my-project-id/sinks/my-sink-id".
1024
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
1025
+ # example:"projects/my-project/sinks/my-sink"
911
1026
  # @param [String] fields
912
1027
  # Selector specifying which fields to include in a partial response.
913
1028
  # @param [String] quota_user
@@ -939,8 +1054,8 @@ module Google
939
1054
  # @param [String] sink_name
940
1055
  # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID]
941
1056
  # " "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
942
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
943
- # Example: "projects/my-project-id/sinks/my-sink-id".
1057
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
1058
+ # example:"projects/my-project/sinks/my-sink"
944
1059
  # @param [String] fields
945
1060
  # Selector specifying which fields to include in a partial response.
946
1061
  # @param [String] quota_user
@@ -1018,8 +1133,8 @@ module Google
1018
1133
  # Required. The full resource name of the sink to update, including the parent
1019
1134
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
1020
1135
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
1021
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
1022
- # Example: "projects/my-project-id/sinks/my-sink-id".
1136
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
1137
+ # example:"projects/my-project/sinks/my-sink"
1023
1138
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
1024
1139
  # @param [Boolean] unique_writer_identity
1025
1140
  # Optional. See sinks.create for a description of this field. When updating a
@@ -1035,10 +1150,11 @@ module Google
1035
1150
  # sink field will be overwritten if, and only if, it is in the update mask. name
1036
1151
  # and output only fields cannot be updated.An empty updateMask is temporarily
1037
1152
  # treated as using the following mask for backwards compatibility purposes:
1038
- # destination,filter,includeChildren At some point in the future, behavior will
1153
+ # destination,filter,includeChildrenAt some point in the future, behavior will
1039
1154
  # be removed and specifying an empty updateMask will be an error.For a detailed
1040
1155
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
1041
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
1156
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
1157
+ # filter
1042
1158
  # @param [String] fields
1043
1159
  # Selector specifying which fields to include in a partial response.
1044
1160
  # @param [String] quota_user
@@ -1077,8 +1193,8 @@ module Google
1077
1193
  # Required. The full resource name of the sink to update, including the parent
1078
1194
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
1079
1195
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
1080
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
1081
- # Example: "projects/my-project-id/sinks/my-sink-id".
1196
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
1197
+ # example:"projects/my-project/sinks/my-sink"
1082
1198
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
1083
1199
  # @param [Boolean] unique_writer_identity
1084
1200
  # Optional. See sinks.create for a description of this field. When updating a
@@ -1094,10 +1210,11 @@ module Google
1094
1210
  # sink field will be overwritten if, and only if, it is in the update mask. name
1095
1211
  # and output only fields cannot be updated.An empty updateMask is temporarily
1096
1212
  # treated as using the following mask for backwards compatibility purposes:
1097
- # destination,filter,includeChildren At some point in the future, behavior will
1213
+ # destination,filter,includeChildrenAt some point in the future, behavior will
1098
1214
  # be removed and specifying an empty updateMask will be an error.For a detailed
1099
1215
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
1100
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
1216
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
1217
+ # filter
1101
1218
  # @param [String] fields
1102
1219
  # Selector specifying which fields to include in a partial response.
1103
1220
  # @param [String] quota_user
@@ -1129,6 +1246,36 @@ module Google
1129
1246
  execute_or_queue_command(command, &block)
1130
1247
  end
1131
1248
 
1249
+ # Copies a set of log entries from a log bucket to a Cloud Storage bucket.
1250
+ # @param [Google::Apis::LoggingV2::CopyLogEntriesRequest] copy_log_entries_request_object
1251
+ # @param [String] fields
1252
+ # Selector specifying which fields to include in a partial response.
1253
+ # @param [String] quota_user
1254
+ # Available to use for quota purposes for server-side applications. Can be any
1255
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1256
+ # @param [Google::Apis::RequestOptions] options
1257
+ # Request-specific options
1258
+ #
1259
+ # @yield [result, err] Result & error if block supplied
1260
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
1261
+ # @yieldparam err [StandardError] error object if request failed
1262
+ #
1263
+ # @return [Google::Apis::LoggingV2::Operation]
1264
+ #
1265
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1266
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1267
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1268
+ def copy_entry_log_entries(copy_log_entries_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1269
+ command = make_simple_command(:post, 'v2/entries:copy', options)
1270
+ command.request_representation = Google::Apis::LoggingV2::CopyLogEntriesRequest::Representation
1271
+ command.request_object = copy_log_entries_request_object
1272
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
1273
+ command.response_class = Google::Apis::LoggingV2::Operation
1274
+ command.query['fields'] = fields unless fields.nil?
1275
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1276
+ execute_or_queue_command(command, &block)
1277
+ end
1278
+
1132
1279
  # Lists log entries. Use this method to retrieve log entries that originated
1133
1280
  # from a project/folder/organization/billing account. For ways to export log
1134
1281
  # entries, see Exporting Logs (https://cloud.google.com/logging/docs/export).
@@ -1232,8 +1379,8 @@ module Google
1232
1379
  # @param [String] parent
1233
1380
  # Required. The parent resource in which to create the exclusion: "projects/[
1234
1381
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
1235
- # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
1236
- # project", "organizations/123456789".
1382
+ # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" For examples:"projects/my-logging-
1383
+ # project" "organizations/123456789"
1237
1384
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
1238
1385
  # @param [String] fields
1239
1386
  # Selector specifying which fields to include in a partial response.
@@ -1269,8 +1416,8 @@ module Google
1269
1416
  # Required. The resource name of an existing exclusion to delete: "projects/[
1270
1417
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
1271
1418
  # exclusions/[EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[
1272
- # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "
1273
- # projects/my-project-id/exclusions/my-exclusion-id".
1419
+ # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"
1420
+ # projects/my-project/exclusions/my-exclusion"
1274
1421
  # @param [String] fields
1275
1422
  # Selector specifying which fields to include in a partial response.
1276
1423
  # @param [String] quota_user
@@ -1303,8 +1450,8 @@ module Google
1303
1450
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
1304
1451
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
1305
1452
  # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
1306
- # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
1307
- # id/exclusions/my-exclusion-id".
1453
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
1454
+ # project/exclusions/my-exclusion"
1308
1455
  # @param [String] fields
1309
1456
  # Selector specifying which fields to include in a partial response.
1310
1457
  # @param [String] quota_user
@@ -1380,8 +1527,8 @@ module Google
1380
1527
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
1381
1528
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
1382
1529
  # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
1383
- # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
1384
- # id/exclusions/my-exclusion-id".
1530
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
1531
+ # project/exclusions/my-exclusion"
1385
1532
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
1386
1533
  # @param [String] update_mask
1387
1534
  # Required. A non-empty list of fields to change in the existing exclusion. New
@@ -1426,8 +1573,8 @@ module Google
1426
1573
  # @param [String] parent
1427
1574
  # Required. The parent resource in which to create the exclusion: "projects/[
1428
1575
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
1429
- # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
1430
- # project", "organizations/123456789".
1576
+ # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" For examples:"projects/my-logging-
1577
+ # project" "organizations/123456789"
1431
1578
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
1432
1579
  # @param [String] fields
1433
1580
  # Selector specifying which fields to include in a partial response.
@@ -1463,8 +1610,8 @@ module Google
1463
1610
  # Required. The resource name of an existing exclusion to delete: "projects/[
1464
1611
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
1465
1612
  # exclusions/[EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[
1466
- # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "
1467
- # projects/my-project-id/exclusions/my-exclusion-id".
1613
+ # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"
1614
+ # projects/my-project/exclusions/my-exclusion"
1468
1615
  # @param [String] fields
1469
1616
  # Selector specifying which fields to include in a partial response.
1470
1617
  # @param [String] quota_user
@@ -1497,8 +1644,8 @@ module Google
1497
1644
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
1498
1645
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
1499
1646
  # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
1500
- # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
1501
- # id/exclusions/my-exclusion-id".
1647
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
1648
+ # project/exclusions/my-exclusion"
1502
1649
  # @param [String] fields
1503
1650
  # Selector specifying which fields to include in a partial response.
1504
1651
  # @param [String] quota_user
@@ -1574,8 +1721,8 @@ module Google
1574
1721
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
1575
1722
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
1576
1723
  # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
1577
- # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
1578
- # id/exclusions/my-exclusion-id".
1724
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
1725
+ # project/exclusions/my-exclusion"
1579
1726
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
1580
1727
  # @param [String] update_mask
1581
1728
  # Required. A non-empty list of fields to change in the existing exclusion. New
@@ -1687,12 +1834,12 @@ module Google
1687
1834
  execute_or_queue_command(command, &block)
1688
1835
  end
1689
1836
 
1690
- # Creates a bucket that can be used to store log entries. Once a bucket has been
1691
- # created, the region cannot be changed.
1837
+ # Creates a log bucket that can be used to store log entries. After a bucket has
1838
+ # been created, the bucket's location cannot be changed.
1692
1839
  # @param [String] parent
1693
- # Required. The resource in which to create the bucket: "projects/[PROJECT_ID]/
1694
- # locations/[LOCATION_ID]" Example: "projects/my-logging-project/locations/
1695
- # global"
1840
+ # Required. The resource in which to create the log bucket: "projects/[
1841
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
1842
+ # locations/global"
1696
1843
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
1697
1844
  # @param [String] bucket_id
1698
1845
  # Required. A client-assigned identifier such as "my-bucket". Identifiers are
@@ -1728,16 +1875,16 @@ module Google
1728
1875
  execute_or_queue_command(command, &block)
1729
1876
  end
1730
1877
 
1731
- # Deletes a bucket. Moves the bucket to the DELETE_REQUESTED state. After 7 days,
1732
- # the bucket will be purged and all logs in the bucket will be permanently
1733
- # deleted.
1878
+ # Deletes a log bucket.Changes the bucket's lifecycle_state to the
1879
+ # DELETE_REQUESTED state. After 7 days, the bucket will be purged and all log
1880
+ # entries in the bucket will be permanently deleted.
1734
1881
  # @param [String] name
1735
1882
  # Required. The full resource name of the bucket to delete. "projects/[
1736
1883
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
1737
1884
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
1738
1885
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
1739
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
1740
- # project-id/locations/my-location/buckets/my-bucket-id".
1886
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
1887
+ # my-project/locations/global/buckets/my-bucket"
1741
1888
  # @param [String] fields
1742
1889
  # Selector specifying which fields to include in a partial response.
1743
1890
  # @param [String] quota_user
@@ -1765,14 +1912,14 @@ module Google
1765
1912
  execute_or_queue_command(command, &block)
1766
1913
  end
1767
1914
 
1768
- # Gets a bucket.
1915
+ # Gets a log bucket.
1769
1916
  # @param [String] name
1770
1917
  # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
1771
1918
  # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
1772
1919
  # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
1773
1920
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[
1774
- # LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-project-id/locations/
1775
- # my-location/buckets/my-bucket-id".
1921
+ # LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/
1922
+ # global/buckets/my-bucket"
1776
1923
  # @param [String] fields
1777
1924
  # Selector specifying which fields to include in a partial response.
1778
1925
  # @param [String] quota_user
@@ -1800,7 +1947,7 @@ module Google
1800
1947
  execute_or_queue_command(command, &block)
1801
1948
  end
1802
1949
 
1803
- # Lists buckets.
1950
+ # Lists log buckets.
1804
1951
  # @param [String] parent
1805
1952
  # Required. The parent resource whose buckets are to be listed: "projects/[
1806
1953
  # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -1846,27 +1993,27 @@ module Google
1846
1993
  execute_or_queue_command(command, &block)
1847
1994
  end
1848
1995
 
1849
- # Updates a bucket. This method replaces the following fields in the existing
1850
- # bucket with values from the new bucket: retention_periodIf the retention
1851
- # period is decreased and the bucket is locked, FAILED_PRECONDITION will be
1852
- # returned.If the bucket has a LifecycleState of DELETE_REQUESTED,
1853
- # FAILED_PRECONDITION will be returned.A buckets region may not be modified
1854
- # after it is created.
1996
+ # Updates a log bucket. This method replaces the following fields in the
1997
+ # existing bucket with values from the new bucket: retention_periodIf the
1998
+ # retention period is decreased and the bucket is locked, FAILED_PRECONDITION
1999
+ # will be returned.If the bucket has a lifecycle_state of DELETE_REQUESTED, then
2000
+ # FAILED_PRECONDITION will be returned.After a bucket has been created, the
2001
+ # bucket's location cannot be changed.
1855
2002
  # @param [String] name
1856
2003
  # Required. The full resource name of the bucket to update. "projects/[
1857
2004
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
1858
2005
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
1859
2006
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
1860
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
1861
- # project-id/locations/my-location/buckets/my-bucket-id". Also requires
1862
- # permission "resourcemanager.projects.updateLiens" to set the locked property
2007
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
2008
+ # my-project/locations/global/buckets/my-bucket"
1863
2009
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
1864
2010
  # @param [String] update_mask
1865
2011
  # Required. Field mask that specifies the fields in bucket that need an update.
1866
2012
  # A bucket field will be overwritten if, and only if, it is in the update mask.
1867
2013
  # name and output only fields cannot be updated.For a detailed FieldMask
1868
- # definition, see https://developers.google.com/protocol-buffers/docs/reference/
1869
- # google.protobuf#google.protobuf.FieldMaskExample: updateMask=retention_days.
2014
+ # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
2015
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
2016
+ # retention_days
1870
2017
  # @param [String] fields
1871
2018
  # Selector specifying which fields to include in a partial response.
1872
2019
  # @param [String] quota_user
@@ -1897,15 +2044,15 @@ module Google
1897
2044
  execute_or_queue_command(command, &block)
1898
2045
  end
1899
2046
 
1900
- # Undeletes a bucket. A bucket that has been deleted may be undeleted within the
1901
- # grace period of 7 days.
2047
+ # Undeletes a log bucket. A bucket that has been deleted can be undeleted within
2048
+ # the grace period of 7 days.
1902
2049
  # @param [String] name
1903
2050
  # Required. The full resource name of the bucket to undelete. "projects/[
1904
2051
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
1905
2052
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
1906
2053
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
1907
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
1908
- # project-id/locations/my-location/buckets/my-bucket-id".
2054
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
2055
+ # my-project/locations/global/buckets/my-bucket"
1909
2056
  # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_request_object
1910
2057
  # @param [String] fields
1911
2058
  # Selector specifying which fields to include in a partial response.
@@ -1936,12 +2083,12 @@ module Google
1936
2083
  execute_or_queue_command(command, &block)
1937
2084
  end
1938
2085
 
1939
- # Creates a view over logs in a bucket. A bucket may contain a maximum of 50
1940
- # views.
2086
+ # Creates a view over log entries in a log bucket. A bucket may contain a
2087
+ # maximum of 30 views.
1941
2088
  # @param [String] parent
1942
- # Required. The bucket in which to create the view "projects/[PROJECT_ID]/
1943
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-logging-
1944
- # project/locations/my-location/buckets/my-bucket"
2089
+ # Required. The bucket in which to create the view `"projects/[PROJECT_ID]/
2090
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"` For example:"projects/my-project/
2091
+ # locations/global/buckets/my-bucket"
1945
2092
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
1946
2093
  # @param [String] view_id
1947
2094
  # Required. The id to use for this view.
@@ -1975,12 +2122,11 @@ module Google
1975
2122
  execute_or_queue_command(command, &block)
1976
2123
  end
1977
2124
 
1978
- # Deletes a view from a bucket.
2125
+ # Deletes a view on a log bucket.
1979
2126
  # @param [String] name
1980
2127
  # Required. The full resource name of the view to delete: "projects/[PROJECT_ID]/
1981
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
1982
- # projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
1983
- # view-id".
2128
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
2129
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
1984
2130
  # @param [String] fields
1985
2131
  # Selector specifying which fields to include in a partial response.
1986
2132
  # @param [String] quota_user
@@ -2008,11 +2154,11 @@ module Google
2008
2154
  execute_or_queue_command(command, &block)
2009
2155
  end
2010
2156
 
2011
- # Gets a view.
2157
+ # Gets a view on a log bucket..
2012
2158
  # @param [String] name
2013
2159
  # Required. The resource name of the policy: "projects/[PROJECT_ID]/locations/[
2014
- # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "projects/my-
2015
- # project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id".
2160
+ # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-
2161
+ # project/locations/global/buckets/my-bucket/views/my-view"
2016
2162
  # @param [String] fields
2017
2163
  # Selector specifying which fields to include in a partial response.
2018
2164
  # @param [String] quota_user
@@ -2040,12 +2186,12 @@ module Google
2040
2186
  execute_or_queue_command(command, &block)
2041
2187
  end
2042
2188
 
2043
- # Lists views on a bucket.
2189
+ # Lists views on a log bucket.
2044
2190
  # @param [String] parent
2045
2191
  # Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
2046
2192
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
2047
2193
  # @param [Fixnum] page_size
2048
- # Optional. The maximum number of results to return from this request. Non-
2194
+ # Optional. The maximum number of results to return from this request.Non-
2049
2195
  # positive values are ignored. The presence of nextPageToken in the response
2050
2196
  # indicates that more results might be available.
2051
2197
  # @param [String] page_token
@@ -2082,20 +2228,19 @@ module Google
2082
2228
  execute_or_queue_command(command, &block)
2083
2229
  end
2084
2230
 
2085
- # Updates a view. This method replaces the following fields in the existing view
2086
- # with values from the new view: filter.
2231
+ # Updates a view on a log bucket. This method replaces the following fields in
2232
+ # the existing view with values from the new view: filter.
2087
2233
  # @param [String] name
2088
2234
  # Required. The full resource name of the view to update "projects/[PROJECT_ID]/
2089
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
2090
- # projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
2091
- # view-id".
2235
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
2236
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
2092
2237
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
2093
2238
  # @param [String] update_mask
2094
2239
  # Optional. Field mask that specifies the fields in view that need an update. A
2095
2240
  # field will be overwritten if, and only if, it is in the update mask. name and
2096
2241
  # output only fields cannot be updated.For a detailed FieldMask definition, see
2097
2242
  # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
2098
- # google.protobuf.FieldMaskExample: updateMask=filter.
2243
+ # google.protobuf.FieldMaskFor example: updateMask=filter
2099
2244
  # @param [String] fields
2100
2245
  # Selector specifying which fields to include in a partial response.
2101
2246
  # @param [String] quota_user
@@ -2126,6 +2271,123 @@ module Google
2126
2271
  execute_or_queue_command(command, &block)
2127
2272
  end
2128
2273
 
2274
+ # Starts asynchronous cancellation on a long-running operation. The server makes
2275
+ # a best effort to cancel the operation, but success is not guaranteed. If the
2276
+ # server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.
2277
+ # Clients can use Operations.GetOperation or other methods to check whether the
2278
+ # cancellation succeeded or whether the operation completed despite cancellation.
2279
+ # On successful cancellation, the operation is not deleted; instead, it becomes
2280
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
2281
+ # corresponding to Code.CANCELLED.
2282
+ # @param [String] name
2283
+ # The name of the operation resource to be cancelled.
2284
+ # @param [Google::Apis::LoggingV2::CancelOperationRequest] cancel_operation_request_object
2285
+ # @param [String] fields
2286
+ # Selector specifying which fields to include in a partial response.
2287
+ # @param [String] quota_user
2288
+ # Available to use for quota purposes for server-side applications. Can be any
2289
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2290
+ # @param [Google::Apis::RequestOptions] options
2291
+ # Request-specific options
2292
+ #
2293
+ # @yield [result, err] Result & error if block supplied
2294
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
2295
+ # @yieldparam err [StandardError] error object if request failed
2296
+ #
2297
+ # @return [Google::Apis::LoggingV2::Empty]
2298
+ #
2299
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2300
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2301
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2302
+ def cancel_folder_location_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2303
+ command = make_simple_command(:post, 'v2/{+name}:cancel', options)
2304
+ command.request_representation = Google::Apis::LoggingV2::CancelOperationRequest::Representation
2305
+ command.request_object = cancel_operation_request_object
2306
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
2307
+ command.response_class = Google::Apis::LoggingV2::Empty
2308
+ command.params['name'] = name unless name.nil?
2309
+ command.query['fields'] = fields unless fields.nil?
2310
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2311
+ execute_or_queue_command(command, &block)
2312
+ end
2313
+
2314
+ # Gets the latest state of a long-running operation. Clients can use this method
2315
+ # to poll the operation result at intervals as recommended by the API service.
2316
+ # @param [String] name
2317
+ # The name of the operation resource.
2318
+ # @param [String] fields
2319
+ # Selector specifying which fields to include in a partial response.
2320
+ # @param [String] quota_user
2321
+ # Available to use for quota purposes for server-side applications. Can be any
2322
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2323
+ # @param [Google::Apis::RequestOptions] options
2324
+ # Request-specific options
2325
+ #
2326
+ # @yield [result, err] Result & error if block supplied
2327
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
2328
+ # @yieldparam err [StandardError] error object if request failed
2329
+ #
2330
+ # @return [Google::Apis::LoggingV2::Operation]
2331
+ #
2332
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2333
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2334
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2335
+ def get_folder_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
2336
+ command = make_simple_command(:get, 'v2/{+name}', options)
2337
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
2338
+ command.response_class = Google::Apis::LoggingV2::Operation
2339
+ command.params['name'] = name unless name.nil?
2340
+ command.query['fields'] = fields unless fields.nil?
2341
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2342
+ execute_or_queue_command(command, &block)
2343
+ end
2344
+
2345
+ # Lists operations that match the specified filter in the request. If the server
2346
+ # doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name binding
2347
+ # allows API services to override the binding to use different resource name
2348
+ # schemes, such as users/*/operations. To override the binding, API services can
2349
+ # add a binding such as "/v1/`name=users/*`/operations" to their service
2350
+ # configuration. For backwards compatibility, the default name includes the
2351
+ # operations collection id, however overriding users must ensure the name
2352
+ # binding is the parent resource, without the operations collection id.
2353
+ # @param [String] name
2354
+ # The name of the operation's parent resource.
2355
+ # @param [String] filter
2356
+ # The standard list filter.
2357
+ # @param [Fixnum] page_size
2358
+ # The standard list page size.
2359
+ # @param [String] page_token
2360
+ # The standard list page token.
2361
+ # @param [String] fields
2362
+ # Selector specifying which fields to include in a partial response.
2363
+ # @param [String] quota_user
2364
+ # Available to use for quota purposes for server-side applications. Can be any
2365
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2366
+ # @param [Google::Apis::RequestOptions] options
2367
+ # Request-specific options
2368
+ #
2369
+ # @yield [result, err] Result & error if block supplied
2370
+ # @yieldparam result [Google::Apis::LoggingV2::ListOperationsResponse] parsed result object
2371
+ # @yieldparam err [StandardError] error object if request failed
2372
+ #
2373
+ # @return [Google::Apis::LoggingV2::ListOperationsResponse]
2374
+ #
2375
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2376
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2377
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2378
+ def list_folder_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2379
+ command = make_simple_command(:get, 'v2/{+name}/operations', options)
2380
+ command.response_representation = Google::Apis::LoggingV2::ListOperationsResponse::Representation
2381
+ command.response_class = Google::Apis::LoggingV2::ListOperationsResponse
2382
+ command.params['name'] = name unless name.nil?
2383
+ command.query['filter'] = filter unless filter.nil?
2384
+ command.query['pageSize'] = page_size unless page_size.nil?
2385
+ command.query['pageToken'] = page_token unless page_token.nil?
2386
+ command.query['fields'] = fields unless fields.nil?
2387
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2388
+ execute_or_queue_command(command, &block)
2389
+ end
2390
+
2129
2391
  # Deletes all the log entries in a log for the _Default Log Bucket. The log
2130
2392
  # reappears if it receives new entries. Log entries written shortly before the
2131
2393
  # delete operation might not be deleted. Entries received after the delete
@@ -2225,14 +2487,14 @@ module Google
2225
2487
  # @param [String] parent
2226
2488
  # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" "
2227
2489
  # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" "
2228
- # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/
2229
- # 123456789".
2490
+ # folders/[FOLDER_ID]" For examples:"projects/my-project" "organizations/
2491
+ # 123456789"
2230
2492
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
2231
2493
  # @param [Boolean] unique_writer_identity
2232
2494
  # Optional. Determines the kind of IAM identity returned as writer_identity in
2233
2495
  # the new sink. If this value is omitted or set to false, and if the sink's
2234
2496
  # parent is a project, then the value returned as writer_identity is the same
2235
- # group or service account used by Logging before the addition of writer
2497
+ # group or service account used by Cloud Logging before the addition of writer
2236
2498
  # identities to this API. The sink's destination must be in the same project as
2237
2499
  # the sink itself.If this field is set to true, or if the sink is owned by a non-
2238
2500
  # project resource such as an organization, then the value of writer_identity
@@ -2274,8 +2536,8 @@ module Google
2274
2536
  # Required. The full resource name of the sink to delete, including the parent
2275
2537
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
2276
2538
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
2277
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
2278
- # Example: "projects/my-project-id/sinks/my-sink-id".
2539
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
2540
+ # example:"projects/my-project/sinks/my-sink"
2279
2541
  # @param [String] fields
2280
2542
  # Selector specifying which fields to include in a partial response.
2281
2543
  # @param [String] quota_user
@@ -2307,8 +2569,8 @@ module Google
2307
2569
  # @param [String] sink_name
2308
2570
  # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID]
2309
2571
  # " "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
2310
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
2311
- # Example: "projects/my-project-id/sinks/my-sink-id".
2572
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
2573
+ # example:"projects/my-project/sinks/my-sink"
2312
2574
  # @param [String] fields
2313
2575
  # Selector specifying which fields to include in a partial response.
2314
2576
  # @param [String] quota_user
@@ -2386,8 +2648,8 @@ module Google
2386
2648
  # Required. The full resource name of the sink to update, including the parent
2387
2649
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
2388
2650
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
2389
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
2390
- # Example: "projects/my-project-id/sinks/my-sink-id".
2651
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
2652
+ # example:"projects/my-project/sinks/my-sink"
2391
2653
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
2392
2654
  # @param [Boolean] unique_writer_identity
2393
2655
  # Optional. See sinks.create for a description of this field. When updating a
@@ -2403,10 +2665,11 @@ module Google
2403
2665
  # sink field will be overwritten if, and only if, it is in the update mask. name
2404
2666
  # and output only fields cannot be updated.An empty updateMask is temporarily
2405
2667
  # treated as using the following mask for backwards compatibility purposes:
2406
- # destination,filter,includeChildren At some point in the future, behavior will
2668
+ # destination,filter,includeChildrenAt some point in the future, behavior will
2407
2669
  # be removed and specifying an empty updateMask will be an error.For a detailed
2408
2670
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
2409
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
2671
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
2672
+ # filter
2410
2673
  # @param [String] fields
2411
2674
  # Selector specifying which fields to include in a partial response.
2412
2675
  # @param [String] quota_user
@@ -2445,8 +2708,8 @@ module Google
2445
2708
  # Required. The full resource name of the sink to update, including the parent
2446
2709
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
2447
2710
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
2448
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
2449
- # Example: "projects/my-project-id/sinks/my-sink-id".
2711
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
2712
+ # example:"projects/my-project/sinks/my-sink"
2450
2713
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
2451
2714
  # @param [Boolean] unique_writer_identity
2452
2715
  # Optional. See sinks.create for a description of this field. When updating a
@@ -2462,10 +2725,11 @@ module Google
2462
2725
  # sink field will be overwritten if, and only if, it is in the update mask. name
2463
2726
  # and output only fields cannot be updated.An empty updateMask is temporarily
2464
2727
  # treated as using the following mask for backwards compatibility purposes:
2465
- # destination,filter,includeChildren At some point in the future, behavior will
2728
+ # destination,filter,includeChildrenAt some point in the future, behavior will
2466
2729
  # be removed and specifying an empty updateMask will be an error.For a detailed
2467
2730
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
2468
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
2731
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
2732
+ # filter
2469
2733
  # @param [String] fields
2470
2734
  # Selector specifying which fields to include in a partial response.
2471
2735
  # @param [String] quota_user
@@ -2570,12 +2834,12 @@ module Google
2570
2834
  execute_or_queue_command(command, &block)
2571
2835
  end
2572
2836
 
2573
- # Creates a bucket that can be used to store log entries. Once a bucket has been
2574
- # created, the region cannot be changed.
2837
+ # Creates a log bucket that can be used to store log entries. After a bucket has
2838
+ # been created, the bucket's location cannot be changed.
2575
2839
  # @param [String] parent
2576
- # Required. The resource in which to create the bucket: "projects/[PROJECT_ID]/
2577
- # locations/[LOCATION_ID]" Example: "projects/my-logging-project/locations/
2578
- # global"
2840
+ # Required. The resource in which to create the log bucket: "projects/[
2841
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
2842
+ # locations/global"
2579
2843
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
2580
2844
  # @param [String] bucket_id
2581
2845
  # Required. A client-assigned identifier such as "my-bucket". Identifiers are
@@ -2611,16 +2875,16 @@ module Google
2611
2875
  execute_or_queue_command(command, &block)
2612
2876
  end
2613
2877
 
2614
- # Deletes a bucket. Moves the bucket to the DELETE_REQUESTED state. After 7 days,
2615
- # the bucket will be purged and all logs in the bucket will be permanently
2616
- # deleted.
2878
+ # Deletes a log bucket.Changes the bucket's lifecycle_state to the
2879
+ # DELETE_REQUESTED state. After 7 days, the bucket will be purged and all log
2880
+ # entries in the bucket will be permanently deleted.
2617
2881
  # @param [String] name
2618
2882
  # Required. The full resource name of the bucket to delete. "projects/[
2619
2883
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
2620
2884
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
2621
2885
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
2622
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
2623
- # project-id/locations/my-location/buckets/my-bucket-id".
2886
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
2887
+ # my-project/locations/global/buckets/my-bucket"
2624
2888
  # @param [String] fields
2625
2889
  # Selector specifying which fields to include in a partial response.
2626
2890
  # @param [String] quota_user
@@ -2648,14 +2912,14 @@ module Google
2648
2912
  execute_or_queue_command(command, &block)
2649
2913
  end
2650
2914
 
2651
- # Gets a bucket.
2915
+ # Gets a log bucket.
2652
2916
  # @param [String] name
2653
2917
  # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
2654
2918
  # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
2655
2919
  # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
2656
2920
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[
2657
- # LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-project-id/locations/
2658
- # my-location/buckets/my-bucket-id".
2921
+ # LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/
2922
+ # global/buckets/my-bucket"
2659
2923
  # @param [String] fields
2660
2924
  # Selector specifying which fields to include in a partial response.
2661
2925
  # @param [String] quota_user
@@ -2683,7 +2947,7 @@ module Google
2683
2947
  execute_or_queue_command(command, &block)
2684
2948
  end
2685
2949
 
2686
- # Lists buckets.
2950
+ # Lists log buckets.
2687
2951
  # @param [String] parent
2688
2952
  # Required. The parent resource whose buckets are to be listed: "projects/[
2689
2953
  # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -2729,27 +2993,27 @@ module Google
2729
2993
  execute_or_queue_command(command, &block)
2730
2994
  end
2731
2995
 
2732
- # Updates a bucket. This method replaces the following fields in the existing
2733
- # bucket with values from the new bucket: retention_periodIf the retention
2734
- # period is decreased and the bucket is locked, FAILED_PRECONDITION will be
2735
- # returned.If the bucket has a LifecycleState of DELETE_REQUESTED,
2736
- # FAILED_PRECONDITION will be returned.A buckets region may not be modified
2737
- # after it is created.
2996
+ # Updates a log bucket. This method replaces the following fields in the
2997
+ # existing bucket with values from the new bucket: retention_periodIf the
2998
+ # retention period is decreased and the bucket is locked, FAILED_PRECONDITION
2999
+ # will be returned.If the bucket has a lifecycle_state of DELETE_REQUESTED, then
3000
+ # FAILED_PRECONDITION will be returned.After a bucket has been created, the
3001
+ # bucket's location cannot be changed.
2738
3002
  # @param [String] name
2739
3003
  # Required. The full resource name of the bucket to update. "projects/[
2740
3004
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
2741
3005
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
2742
3006
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
2743
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
2744
- # project-id/locations/my-location/buckets/my-bucket-id". Also requires
2745
- # permission "resourcemanager.projects.updateLiens" to set the locked property
3007
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
3008
+ # my-project/locations/global/buckets/my-bucket"
2746
3009
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
2747
3010
  # @param [String] update_mask
2748
3011
  # Required. Field mask that specifies the fields in bucket that need an update.
2749
3012
  # A bucket field will be overwritten if, and only if, it is in the update mask.
2750
3013
  # name and output only fields cannot be updated.For a detailed FieldMask
2751
- # definition, see https://developers.google.com/protocol-buffers/docs/reference/
2752
- # google.protobuf#google.protobuf.FieldMaskExample: updateMask=retention_days.
3014
+ # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
3015
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
3016
+ # retention_days
2753
3017
  # @param [String] fields
2754
3018
  # Selector specifying which fields to include in a partial response.
2755
3019
  # @param [String] quota_user
@@ -2780,15 +3044,15 @@ module Google
2780
3044
  execute_or_queue_command(command, &block)
2781
3045
  end
2782
3046
 
2783
- # Undeletes a bucket. A bucket that has been deleted may be undeleted within the
2784
- # grace period of 7 days.
3047
+ # Undeletes a log bucket. A bucket that has been deleted can be undeleted within
3048
+ # the grace period of 7 days.
2785
3049
  # @param [String] name
2786
3050
  # Required. The full resource name of the bucket to undelete. "projects/[
2787
3051
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
2788
3052
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
2789
3053
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
2790
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
2791
- # project-id/locations/my-location/buckets/my-bucket-id".
3054
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
3055
+ # my-project/locations/global/buckets/my-bucket"
2792
3056
  # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_request_object
2793
3057
  # @param [String] fields
2794
3058
  # Selector specifying which fields to include in a partial response.
@@ -2819,12 +3083,12 @@ module Google
2819
3083
  execute_or_queue_command(command, &block)
2820
3084
  end
2821
3085
 
2822
- # Creates a view over logs in a bucket. A bucket may contain a maximum of 50
2823
- # views.
3086
+ # Creates a view over log entries in a log bucket. A bucket may contain a
3087
+ # maximum of 30 views.
2824
3088
  # @param [String] parent
2825
- # Required. The bucket in which to create the view "projects/[PROJECT_ID]/
2826
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-logging-
2827
- # project/locations/my-location/buckets/my-bucket"
3089
+ # Required. The bucket in which to create the view `"projects/[PROJECT_ID]/
3090
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"` For example:"projects/my-project/
3091
+ # locations/global/buckets/my-bucket"
2828
3092
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
2829
3093
  # @param [String] view_id
2830
3094
  # Required. The id to use for this view.
@@ -2858,12 +3122,11 @@ module Google
2858
3122
  execute_or_queue_command(command, &block)
2859
3123
  end
2860
3124
 
2861
- # Deletes a view from a bucket.
3125
+ # Deletes a view on a log bucket.
2862
3126
  # @param [String] name
2863
3127
  # Required. The full resource name of the view to delete: "projects/[PROJECT_ID]/
2864
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
2865
- # projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
2866
- # view-id".
3128
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
3129
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
2867
3130
  # @param [String] fields
2868
3131
  # Selector specifying which fields to include in a partial response.
2869
3132
  # @param [String] quota_user
@@ -2891,11 +3154,11 @@ module Google
2891
3154
  execute_or_queue_command(command, &block)
2892
3155
  end
2893
3156
 
2894
- # Gets a view.
3157
+ # Gets a view on a log bucket..
2895
3158
  # @param [String] name
2896
3159
  # Required. The resource name of the policy: "projects/[PROJECT_ID]/locations/[
2897
- # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "projects/my-
2898
- # project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id".
3160
+ # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-
3161
+ # project/locations/global/buckets/my-bucket/views/my-view"
2899
3162
  # @param [String] fields
2900
3163
  # Selector specifying which fields to include in a partial response.
2901
3164
  # @param [String] quota_user
@@ -2923,12 +3186,12 @@ module Google
2923
3186
  execute_or_queue_command(command, &block)
2924
3187
  end
2925
3188
 
2926
- # Lists views on a bucket.
3189
+ # Lists views on a log bucket.
2927
3190
  # @param [String] parent
2928
3191
  # Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
2929
3192
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
2930
3193
  # @param [Fixnum] page_size
2931
- # Optional. The maximum number of results to return from this request. Non-
3194
+ # Optional. The maximum number of results to return from this request.Non-
2932
3195
  # positive values are ignored. The presence of nextPageToken in the response
2933
3196
  # indicates that more results might be available.
2934
3197
  # @param [String] page_token
@@ -2965,20 +3228,19 @@ module Google
2965
3228
  execute_or_queue_command(command, &block)
2966
3229
  end
2967
3230
 
2968
- # Updates a view. This method replaces the following fields in the existing view
2969
- # with values from the new view: filter.
3231
+ # Updates a view on a log bucket. This method replaces the following fields in
3232
+ # the existing view with values from the new view: filter.
2970
3233
  # @param [String] name
2971
3234
  # Required. The full resource name of the view to update "projects/[PROJECT_ID]/
2972
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
2973
- # projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
2974
- # view-id".
3235
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
3236
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
2975
3237
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
2976
3238
  # @param [String] update_mask
2977
3239
  # Optional. Field mask that specifies the fields in view that need an update. A
2978
3240
  # field will be overwritten if, and only if, it is in the update mask. name and
2979
3241
  # output only fields cannot be updated.For a detailed FieldMask definition, see
2980
3242
  # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
2981
- # google.protobuf.FieldMaskExample: updateMask=filter.
3243
+ # google.protobuf.FieldMaskFor example: updateMask=filter
2982
3244
  # @param [String] fields
2983
3245
  # Selector specifying which fields to include in a partial response.
2984
3246
  # @param [String] quota_user
@@ -3009,6 +3271,123 @@ module Google
3009
3271
  execute_or_queue_command(command, &block)
3010
3272
  end
3011
3273
 
3274
+ # Starts asynchronous cancellation on a long-running operation. The server makes
3275
+ # a best effort to cancel the operation, but success is not guaranteed. If the
3276
+ # server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.
3277
+ # Clients can use Operations.GetOperation or other methods to check whether the
3278
+ # cancellation succeeded or whether the operation completed despite cancellation.
3279
+ # On successful cancellation, the operation is not deleted; instead, it becomes
3280
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
3281
+ # corresponding to Code.CANCELLED.
3282
+ # @param [String] name
3283
+ # The name of the operation resource to be cancelled.
3284
+ # @param [Google::Apis::LoggingV2::CancelOperationRequest] cancel_operation_request_object
3285
+ # @param [String] fields
3286
+ # Selector specifying which fields to include in a partial response.
3287
+ # @param [String] quota_user
3288
+ # Available to use for quota purposes for server-side applications. Can be any
3289
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3290
+ # @param [Google::Apis::RequestOptions] options
3291
+ # Request-specific options
3292
+ #
3293
+ # @yield [result, err] Result & error if block supplied
3294
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
3295
+ # @yieldparam err [StandardError] error object if request failed
3296
+ #
3297
+ # @return [Google::Apis::LoggingV2::Empty]
3298
+ #
3299
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3300
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3301
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3302
+ def cancel_location_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3303
+ command = make_simple_command(:post, 'v2/{+name}:cancel', options)
3304
+ command.request_representation = Google::Apis::LoggingV2::CancelOperationRequest::Representation
3305
+ command.request_object = cancel_operation_request_object
3306
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
3307
+ command.response_class = Google::Apis::LoggingV2::Empty
3308
+ command.params['name'] = name unless name.nil?
3309
+ command.query['fields'] = fields unless fields.nil?
3310
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3311
+ execute_or_queue_command(command, &block)
3312
+ end
3313
+
3314
+ # Gets the latest state of a long-running operation. Clients can use this method
3315
+ # to poll the operation result at intervals as recommended by the API service.
3316
+ # @param [String] name
3317
+ # The name of the operation resource.
3318
+ # @param [String] fields
3319
+ # Selector specifying which fields to include in a partial response.
3320
+ # @param [String] quota_user
3321
+ # Available to use for quota purposes for server-side applications. Can be any
3322
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3323
+ # @param [Google::Apis::RequestOptions] options
3324
+ # Request-specific options
3325
+ #
3326
+ # @yield [result, err] Result & error if block supplied
3327
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
3328
+ # @yieldparam err [StandardError] error object if request failed
3329
+ #
3330
+ # @return [Google::Apis::LoggingV2::Operation]
3331
+ #
3332
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3333
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3334
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3335
+ def get_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
3336
+ command = make_simple_command(:get, 'v2/{+name}', options)
3337
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
3338
+ command.response_class = Google::Apis::LoggingV2::Operation
3339
+ command.params['name'] = name unless name.nil?
3340
+ command.query['fields'] = fields unless fields.nil?
3341
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3342
+ execute_or_queue_command(command, &block)
3343
+ end
3344
+
3345
+ # Lists operations that match the specified filter in the request. If the server
3346
+ # doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name binding
3347
+ # allows API services to override the binding to use different resource name
3348
+ # schemes, such as users/*/operations. To override the binding, API services can
3349
+ # add a binding such as "/v1/`name=users/*`/operations" to their service
3350
+ # configuration. For backwards compatibility, the default name includes the
3351
+ # operations collection id, however overriding users must ensure the name
3352
+ # binding is the parent resource, without the operations collection id.
3353
+ # @param [String] name
3354
+ # The name of the operation's parent resource.
3355
+ # @param [String] filter
3356
+ # The standard list filter.
3357
+ # @param [Fixnum] page_size
3358
+ # The standard list page size.
3359
+ # @param [String] page_token
3360
+ # The standard list page token.
3361
+ # @param [String] fields
3362
+ # Selector specifying which fields to include in a partial response.
3363
+ # @param [String] quota_user
3364
+ # Available to use for quota purposes for server-side applications. Can be any
3365
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3366
+ # @param [Google::Apis::RequestOptions] options
3367
+ # Request-specific options
3368
+ #
3369
+ # @yield [result, err] Result & error if block supplied
3370
+ # @yieldparam result [Google::Apis::LoggingV2::ListOperationsResponse] parsed result object
3371
+ # @yieldparam err [StandardError] error object if request failed
3372
+ #
3373
+ # @return [Google::Apis::LoggingV2::ListOperationsResponse]
3374
+ #
3375
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3376
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3377
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3378
+ def list_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3379
+ command = make_simple_command(:get, 'v2/{+name}/operations', options)
3380
+ command.response_representation = Google::Apis::LoggingV2::ListOperationsResponse::Representation
3381
+ command.response_class = Google::Apis::LoggingV2::ListOperationsResponse
3382
+ command.params['name'] = name unless name.nil?
3383
+ command.query['filter'] = filter unless filter.nil?
3384
+ command.query['pageSize'] = page_size unless page_size.nil?
3385
+ command.query['pageToken'] = page_token unless page_token.nil?
3386
+ command.query['fields'] = fields unless fields.nil?
3387
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3388
+ execute_or_queue_command(command, &block)
3389
+ end
3390
+
3012
3391
  # Deletes all the log entries in a log for the _Default Log Bucket. The log
3013
3392
  # reappears if it receives new entries. Log entries written shortly before the
3014
3393
  # delete operation might not be deleted. Entries received after the delete
@@ -3148,7 +3527,7 @@ module Google
3148
3527
  # Required. The resource for which to retrieve CMEK settings. "projects/[
3149
3528
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
3150
3529
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
3151
- # cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the
3530
+ # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
3152
3531
  # Logs Router can currently only be configured for GCP organizations. Once
3153
3532
  # configured, it applies to all projects and folders in the GCP organization.
3154
3533
  # @param [String] fields
@@ -3190,15 +3569,15 @@ module Google
3190
3569
  # Required. The resource name for the CMEK settings to update. "projects/[
3191
3570
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
3192
3571
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
3193
- # cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the
3572
+ # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
3194
3573
  # Logs Router can currently only be configured for GCP organizations. Once
3195
3574
  # configured, it applies to all projects and folders in the GCP organization.
3196
3575
  # @param [Google::Apis::LoggingV2::CmekSettings] cmek_settings_object
3197
3576
  # @param [String] update_mask
3198
3577
  # Optional. Field mask identifying which fields from cmek_settings should be
3199
3578
  # updated. A field will be overwritten if and only if it is in the update mask.
3200
- # Output only fields cannot be updated.See FieldMask for more information.
3201
- # Example: "updateMask=kmsKeyName"
3579
+ # Output only fields cannot be updated.See FieldMask for more information.For
3580
+ # example: "updateMask=kmsKeyName"
3202
3581
  # @param [String] fields
3203
3582
  # Selector specifying which fields to include in a partial response.
3204
3583
  # @param [String] quota_user
@@ -3235,8 +3614,8 @@ module Google
3235
3614
  # @param [String] parent
3236
3615
  # Required. The parent resource in which to create the exclusion: "projects/[
3237
3616
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
3238
- # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
3239
- # project", "organizations/123456789".
3617
+ # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" For examples:"projects/my-logging-
3618
+ # project" "organizations/123456789"
3240
3619
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
3241
3620
  # @param [String] fields
3242
3621
  # Selector specifying which fields to include in a partial response.
@@ -3272,8 +3651,8 @@ module Google
3272
3651
  # Required. The resource name of an existing exclusion to delete: "projects/[
3273
3652
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
3274
3653
  # exclusions/[EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[
3275
- # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "
3276
- # projects/my-project-id/exclusions/my-exclusion-id".
3654
+ # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"
3655
+ # projects/my-project/exclusions/my-exclusion"
3277
3656
  # @param [String] fields
3278
3657
  # Selector specifying which fields to include in a partial response.
3279
3658
  # @param [String] quota_user
@@ -3306,8 +3685,8 @@ module Google
3306
3685
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
3307
3686
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
3308
3687
  # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
3309
- # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
3310
- # id/exclusions/my-exclusion-id".
3688
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
3689
+ # project/exclusions/my-exclusion"
3311
3690
  # @param [String] fields
3312
3691
  # Selector specifying which fields to include in a partial response.
3313
3692
  # @param [String] quota_user
@@ -3383,8 +3762,8 @@ module Google
3383
3762
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
3384
3763
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
3385
3764
  # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
3386
- # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
3387
- # id/exclusions/my-exclusion-id".
3765
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
3766
+ # project/exclusions/my-exclusion"
3388
3767
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
3389
3768
  # @param [String] update_mask
3390
3769
  # Required. A non-empty list of fields to change in the existing exclusion. New
@@ -3496,12 +3875,12 @@ module Google
3496
3875
  execute_or_queue_command(command, &block)
3497
3876
  end
3498
3877
 
3499
- # Creates a bucket that can be used to store log entries. Once a bucket has been
3500
- # created, the region cannot be changed.
3878
+ # Creates a log bucket that can be used to store log entries. After a bucket has
3879
+ # been created, the bucket's location cannot be changed.
3501
3880
  # @param [String] parent
3502
- # Required. The resource in which to create the bucket: "projects/[PROJECT_ID]/
3503
- # locations/[LOCATION_ID]" Example: "projects/my-logging-project/locations/
3504
- # global"
3881
+ # Required. The resource in which to create the log bucket: "projects/[
3882
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
3883
+ # locations/global"
3505
3884
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
3506
3885
  # @param [String] bucket_id
3507
3886
  # Required. A client-assigned identifier such as "my-bucket". Identifiers are
@@ -3537,16 +3916,16 @@ module Google
3537
3916
  execute_or_queue_command(command, &block)
3538
3917
  end
3539
3918
 
3540
- # Deletes a bucket. Moves the bucket to the DELETE_REQUESTED state. After 7 days,
3541
- # the bucket will be purged and all logs in the bucket will be permanently
3542
- # deleted.
3919
+ # Deletes a log bucket.Changes the bucket's lifecycle_state to the
3920
+ # DELETE_REQUESTED state. After 7 days, the bucket will be purged and all log
3921
+ # entries in the bucket will be permanently deleted.
3543
3922
  # @param [String] name
3544
3923
  # Required. The full resource name of the bucket to delete. "projects/[
3545
3924
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
3546
3925
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
3547
3926
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
3548
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
3549
- # project-id/locations/my-location/buckets/my-bucket-id".
3927
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
3928
+ # my-project/locations/global/buckets/my-bucket"
3550
3929
  # @param [String] fields
3551
3930
  # Selector specifying which fields to include in a partial response.
3552
3931
  # @param [String] quota_user
@@ -3574,14 +3953,14 @@ module Google
3574
3953
  execute_or_queue_command(command, &block)
3575
3954
  end
3576
3955
 
3577
- # Gets a bucket.
3956
+ # Gets a log bucket.
3578
3957
  # @param [String] name
3579
3958
  # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
3580
3959
  # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
3581
3960
  # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
3582
3961
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[
3583
- # LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-project-id/locations/
3584
- # my-location/buckets/my-bucket-id".
3962
+ # LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/
3963
+ # global/buckets/my-bucket"
3585
3964
  # @param [String] fields
3586
3965
  # Selector specifying which fields to include in a partial response.
3587
3966
  # @param [String] quota_user
@@ -3609,7 +3988,7 @@ module Google
3609
3988
  execute_or_queue_command(command, &block)
3610
3989
  end
3611
3990
 
3612
- # Lists buckets.
3991
+ # Lists log buckets.
3613
3992
  # @param [String] parent
3614
3993
  # Required. The parent resource whose buckets are to be listed: "projects/[
3615
3994
  # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -3655,27 +4034,27 @@ module Google
3655
4034
  execute_or_queue_command(command, &block)
3656
4035
  end
3657
4036
 
3658
- # Updates a bucket. This method replaces the following fields in the existing
3659
- # bucket with values from the new bucket: retention_periodIf the retention
3660
- # period is decreased and the bucket is locked, FAILED_PRECONDITION will be
3661
- # returned.If the bucket has a LifecycleState of DELETE_REQUESTED,
3662
- # FAILED_PRECONDITION will be returned.A buckets region may not be modified
3663
- # after it is created.
4037
+ # Updates a log bucket. This method replaces the following fields in the
4038
+ # existing bucket with values from the new bucket: retention_periodIf the
4039
+ # retention period is decreased and the bucket is locked, FAILED_PRECONDITION
4040
+ # will be returned.If the bucket has a lifecycle_state of DELETE_REQUESTED, then
4041
+ # FAILED_PRECONDITION will be returned.After a bucket has been created, the
4042
+ # bucket's location cannot be changed.
3664
4043
  # @param [String] name
3665
4044
  # Required. The full resource name of the bucket to update. "projects/[
3666
4045
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
3667
4046
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
3668
4047
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
3669
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
3670
- # project-id/locations/my-location/buckets/my-bucket-id". Also requires
3671
- # permission "resourcemanager.projects.updateLiens" to set the locked property
4048
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
4049
+ # my-project/locations/global/buckets/my-bucket"
3672
4050
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
3673
4051
  # @param [String] update_mask
3674
4052
  # Required. Field mask that specifies the fields in bucket that need an update.
3675
4053
  # A bucket field will be overwritten if, and only if, it is in the update mask.
3676
4054
  # name and output only fields cannot be updated.For a detailed FieldMask
3677
- # definition, see https://developers.google.com/protocol-buffers/docs/reference/
3678
- # google.protobuf#google.protobuf.FieldMaskExample: updateMask=retention_days.
4055
+ # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
4056
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
4057
+ # retention_days
3679
4058
  # @param [String] fields
3680
4059
  # Selector specifying which fields to include in a partial response.
3681
4060
  # @param [String] quota_user
@@ -3706,15 +4085,15 @@ module Google
3706
4085
  execute_or_queue_command(command, &block)
3707
4086
  end
3708
4087
 
3709
- # Undeletes a bucket. A bucket that has been deleted may be undeleted within the
3710
- # grace period of 7 days.
4088
+ # Undeletes a log bucket. A bucket that has been deleted can be undeleted within
4089
+ # the grace period of 7 days.
3711
4090
  # @param [String] name
3712
4091
  # Required. The full resource name of the bucket to undelete. "projects/[
3713
4092
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
3714
4093
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
3715
4094
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
3716
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
3717
- # project-id/locations/my-location/buckets/my-bucket-id".
4095
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
4096
+ # my-project/locations/global/buckets/my-bucket"
3718
4097
  # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_request_object
3719
4098
  # @param [String] fields
3720
4099
  # Selector specifying which fields to include in a partial response.
@@ -3745,12 +4124,12 @@ module Google
3745
4124
  execute_or_queue_command(command, &block)
3746
4125
  end
3747
4126
 
3748
- # Creates a view over logs in a bucket. A bucket may contain a maximum of 50
3749
- # views.
4127
+ # Creates a view over log entries in a log bucket. A bucket may contain a
4128
+ # maximum of 30 views.
3750
4129
  # @param [String] parent
3751
- # Required. The bucket in which to create the view "projects/[PROJECT_ID]/
3752
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-logging-
3753
- # project/locations/my-location/buckets/my-bucket"
4130
+ # Required. The bucket in which to create the view `"projects/[PROJECT_ID]/
4131
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"` For example:"projects/my-project/
4132
+ # locations/global/buckets/my-bucket"
3754
4133
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
3755
4134
  # @param [String] view_id
3756
4135
  # Required. The id to use for this view.
@@ -3784,12 +4163,11 @@ module Google
3784
4163
  execute_or_queue_command(command, &block)
3785
4164
  end
3786
4165
 
3787
- # Deletes a view from a bucket.
4166
+ # Deletes a view on a log bucket.
3788
4167
  # @param [String] name
3789
4168
  # Required. The full resource name of the view to delete: "projects/[PROJECT_ID]/
3790
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
3791
- # projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
3792
- # view-id".
4169
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
4170
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
3793
4171
  # @param [String] fields
3794
4172
  # Selector specifying which fields to include in a partial response.
3795
4173
  # @param [String] quota_user
@@ -3817,11 +4195,11 @@ module Google
3817
4195
  execute_or_queue_command(command, &block)
3818
4196
  end
3819
4197
 
3820
- # Gets a view.
4198
+ # Gets a view on a log bucket..
3821
4199
  # @param [String] name
3822
4200
  # Required. The resource name of the policy: "projects/[PROJECT_ID]/locations/[
3823
- # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "projects/my-
3824
- # project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id".
4201
+ # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-
4202
+ # project/locations/global/buckets/my-bucket/views/my-view"
3825
4203
  # @param [String] fields
3826
4204
  # Selector specifying which fields to include in a partial response.
3827
4205
  # @param [String] quota_user
@@ -3849,12 +4227,12 @@ module Google
3849
4227
  execute_or_queue_command(command, &block)
3850
4228
  end
3851
4229
 
3852
- # Lists views on a bucket.
4230
+ # Lists views on a log bucket.
3853
4231
  # @param [String] parent
3854
4232
  # Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
3855
4233
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
3856
4234
  # @param [Fixnum] page_size
3857
- # Optional. The maximum number of results to return from this request. Non-
4235
+ # Optional. The maximum number of results to return from this request.Non-
3858
4236
  # positive values are ignored. The presence of nextPageToken in the response
3859
4237
  # indicates that more results might be available.
3860
4238
  # @param [String] page_token
@@ -3891,20 +4269,19 @@ module Google
3891
4269
  execute_or_queue_command(command, &block)
3892
4270
  end
3893
4271
 
3894
- # Updates a view. This method replaces the following fields in the existing view
3895
- # with values from the new view: filter.
4272
+ # Updates a view on a log bucket. This method replaces the following fields in
4273
+ # the existing view with values from the new view: filter.
3896
4274
  # @param [String] name
3897
4275
  # Required. The full resource name of the view to update "projects/[PROJECT_ID]/
3898
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
3899
- # projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
3900
- # view-id".
4276
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
4277
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
3901
4278
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
3902
4279
  # @param [String] update_mask
3903
4280
  # Optional. Field mask that specifies the fields in view that need an update. A
3904
4281
  # field will be overwritten if, and only if, it is in the update mask. name and
3905
4282
  # output only fields cannot be updated.For a detailed FieldMask definition, see
3906
4283
  # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
3907
- # google.protobuf.FieldMaskExample: updateMask=filter.
4284
+ # google.protobuf.FieldMaskFor example: updateMask=filter
3908
4285
  # @param [String] fields
3909
4286
  # Selector specifying which fields to include in a partial response.
3910
4287
  # @param [String] quota_user
@@ -3935,6 +4312,123 @@ module Google
3935
4312
  execute_or_queue_command(command, &block)
3936
4313
  end
3937
4314
 
4315
+ # Starts asynchronous cancellation on a long-running operation. The server makes
4316
+ # a best effort to cancel the operation, but success is not guaranteed. If the
4317
+ # server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.
4318
+ # Clients can use Operations.GetOperation or other methods to check whether the
4319
+ # cancellation succeeded or whether the operation completed despite cancellation.
4320
+ # On successful cancellation, the operation is not deleted; instead, it becomes
4321
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
4322
+ # corresponding to Code.CANCELLED.
4323
+ # @param [String] name
4324
+ # The name of the operation resource to be cancelled.
4325
+ # @param [Google::Apis::LoggingV2::CancelOperationRequest] cancel_operation_request_object
4326
+ # @param [String] fields
4327
+ # Selector specifying which fields to include in a partial response.
4328
+ # @param [String] quota_user
4329
+ # Available to use for quota purposes for server-side applications. Can be any
4330
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4331
+ # @param [Google::Apis::RequestOptions] options
4332
+ # Request-specific options
4333
+ #
4334
+ # @yield [result, err] Result & error if block supplied
4335
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
4336
+ # @yieldparam err [StandardError] error object if request failed
4337
+ #
4338
+ # @return [Google::Apis::LoggingV2::Empty]
4339
+ #
4340
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4341
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4342
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4343
+ def cancel_organization_location_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
4344
+ command = make_simple_command(:post, 'v2/{+name}:cancel', options)
4345
+ command.request_representation = Google::Apis::LoggingV2::CancelOperationRequest::Representation
4346
+ command.request_object = cancel_operation_request_object
4347
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
4348
+ command.response_class = Google::Apis::LoggingV2::Empty
4349
+ command.params['name'] = name unless name.nil?
4350
+ command.query['fields'] = fields unless fields.nil?
4351
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4352
+ execute_or_queue_command(command, &block)
4353
+ end
4354
+
4355
+ # Gets the latest state of a long-running operation. Clients can use this method
4356
+ # to poll the operation result at intervals as recommended by the API service.
4357
+ # @param [String] name
4358
+ # The name of the operation resource.
4359
+ # @param [String] fields
4360
+ # Selector specifying which fields to include in a partial response.
4361
+ # @param [String] quota_user
4362
+ # Available to use for quota purposes for server-side applications. Can be any
4363
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4364
+ # @param [Google::Apis::RequestOptions] options
4365
+ # Request-specific options
4366
+ #
4367
+ # @yield [result, err] Result & error if block supplied
4368
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
4369
+ # @yieldparam err [StandardError] error object if request failed
4370
+ #
4371
+ # @return [Google::Apis::LoggingV2::Operation]
4372
+ #
4373
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4374
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4375
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4376
+ def get_organization_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
4377
+ command = make_simple_command(:get, 'v2/{+name}', options)
4378
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
4379
+ command.response_class = Google::Apis::LoggingV2::Operation
4380
+ command.params['name'] = name unless name.nil?
4381
+ command.query['fields'] = fields unless fields.nil?
4382
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4383
+ execute_or_queue_command(command, &block)
4384
+ end
4385
+
4386
+ # Lists operations that match the specified filter in the request. If the server
4387
+ # doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name binding
4388
+ # allows API services to override the binding to use different resource name
4389
+ # schemes, such as users/*/operations. To override the binding, API services can
4390
+ # add a binding such as "/v1/`name=users/*`/operations" to their service
4391
+ # configuration. For backwards compatibility, the default name includes the
4392
+ # operations collection id, however overriding users must ensure the name
4393
+ # binding is the parent resource, without the operations collection id.
4394
+ # @param [String] name
4395
+ # The name of the operation's parent resource.
4396
+ # @param [String] filter
4397
+ # The standard list filter.
4398
+ # @param [Fixnum] page_size
4399
+ # The standard list page size.
4400
+ # @param [String] page_token
4401
+ # The standard list page token.
4402
+ # @param [String] fields
4403
+ # Selector specifying which fields to include in a partial response.
4404
+ # @param [String] quota_user
4405
+ # Available to use for quota purposes for server-side applications. Can be any
4406
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4407
+ # @param [Google::Apis::RequestOptions] options
4408
+ # Request-specific options
4409
+ #
4410
+ # @yield [result, err] Result & error if block supplied
4411
+ # @yieldparam result [Google::Apis::LoggingV2::ListOperationsResponse] parsed result object
4412
+ # @yieldparam err [StandardError] error object if request failed
4413
+ #
4414
+ # @return [Google::Apis::LoggingV2::ListOperationsResponse]
4415
+ #
4416
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4417
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4418
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4419
+ def list_organization_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
4420
+ command = make_simple_command(:get, 'v2/{+name}/operations', options)
4421
+ command.response_representation = Google::Apis::LoggingV2::ListOperationsResponse::Representation
4422
+ command.response_class = Google::Apis::LoggingV2::ListOperationsResponse
4423
+ command.params['name'] = name unless name.nil?
4424
+ command.query['filter'] = filter unless filter.nil?
4425
+ command.query['pageSize'] = page_size unless page_size.nil?
4426
+ command.query['pageToken'] = page_token unless page_token.nil?
4427
+ command.query['fields'] = fields unless fields.nil?
4428
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4429
+ execute_or_queue_command(command, &block)
4430
+ end
4431
+
3938
4432
  # Deletes all the log entries in a log for the _Default Log Bucket. The log
3939
4433
  # reappears if it receives new entries. Log entries written shortly before the
3940
4434
  # delete operation might not be deleted. Entries received after the delete
@@ -4034,14 +4528,14 @@ module Google
4034
4528
  # @param [String] parent
4035
4529
  # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" "
4036
4530
  # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" "
4037
- # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/
4038
- # 123456789".
4531
+ # folders/[FOLDER_ID]" For examples:"projects/my-project" "organizations/
4532
+ # 123456789"
4039
4533
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
4040
4534
  # @param [Boolean] unique_writer_identity
4041
4535
  # Optional. Determines the kind of IAM identity returned as writer_identity in
4042
4536
  # the new sink. If this value is omitted or set to false, and if the sink's
4043
4537
  # parent is a project, then the value returned as writer_identity is the same
4044
- # group or service account used by Logging before the addition of writer
4538
+ # group or service account used by Cloud Logging before the addition of writer
4045
4539
  # identities to this API. The sink's destination must be in the same project as
4046
4540
  # the sink itself.If this field is set to true, or if the sink is owned by a non-
4047
4541
  # project resource such as an organization, then the value of writer_identity
@@ -4083,8 +4577,8 @@ module Google
4083
4577
  # Required. The full resource name of the sink to delete, including the parent
4084
4578
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
4085
4579
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
4086
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
4087
- # Example: "projects/my-project-id/sinks/my-sink-id".
4580
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
4581
+ # example:"projects/my-project/sinks/my-sink"
4088
4582
  # @param [String] fields
4089
4583
  # Selector specifying which fields to include in a partial response.
4090
4584
  # @param [String] quota_user
@@ -4116,8 +4610,8 @@ module Google
4116
4610
  # @param [String] sink_name
4117
4611
  # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID]
4118
4612
  # " "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
4119
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
4120
- # Example: "projects/my-project-id/sinks/my-sink-id".
4613
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
4614
+ # example:"projects/my-project/sinks/my-sink"
4121
4615
  # @param [String] fields
4122
4616
  # Selector specifying which fields to include in a partial response.
4123
4617
  # @param [String] quota_user
@@ -4195,8 +4689,8 @@ module Google
4195
4689
  # Required. The full resource name of the sink to update, including the parent
4196
4690
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
4197
4691
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
4198
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
4199
- # Example: "projects/my-project-id/sinks/my-sink-id".
4692
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
4693
+ # example:"projects/my-project/sinks/my-sink"
4200
4694
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
4201
4695
  # @param [Boolean] unique_writer_identity
4202
4696
  # Optional. See sinks.create for a description of this field. When updating a
@@ -4212,10 +4706,11 @@ module Google
4212
4706
  # sink field will be overwritten if, and only if, it is in the update mask. name
4213
4707
  # and output only fields cannot be updated.An empty updateMask is temporarily
4214
4708
  # treated as using the following mask for backwards compatibility purposes:
4215
- # destination,filter,includeChildren At some point in the future, behavior will
4709
+ # destination,filter,includeChildrenAt some point in the future, behavior will
4216
4710
  # be removed and specifying an empty updateMask will be an error.For a detailed
4217
4711
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
4218
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
4712
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
4713
+ # filter
4219
4714
  # @param [String] fields
4220
4715
  # Selector specifying which fields to include in a partial response.
4221
4716
  # @param [String] quota_user
@@ -4254,8 +4749,8 @@ module Google
4254
4749
  # Required. The full resource name of the sink to update, including the parent
4255
4750
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
4256
4751
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
4257
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
4258
- # Example: "projects/my-project-id/sinks/my-sink-id".
4752
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
4753
+ # example:"projects/my-project/sinks/my-sink"
4259
4754
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
4260
4755
  # @param [Boolean] unique_writer_identity
4261
4756
  # Optional. See sinks.create for a description of this field. When updating a
@@ -4271,10 +4766,11 @@ module Google
4271
4766
  # sink field will be overwritten if, and only if, it is in the update mask. name
4272
4767
  # and output only fields cannot be updated.An empty updateMask is temporarily
4273
4768
  # treated as using the following mask for backwards compatibility purposes:
4274
- # destination,filter,includeChildren At some point in the future, behavior will
4769
+ # destination,filter,includeChildrenAt some point in the future, behavior will
4275
4770
  # be removed and specifying an empty updateMask will be an error.For a detailed
4276
4771
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
4277
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
4772
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
4773
+ # filter
4278
4774
  # @param [String] fields
4279
4775
  # Selector specifying which fields to include in a partial response.
4280
4776
  # @param [String] quota_user
@@ -4312,8 +4808,8 @@ module Google
4312
4808
  # @param [String] parent
4313
4809
  # Required. The parent resource in which to create the exclusion: "projects/[
4314
4810
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
4315
- # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
4316
- # project", "organizations/123456789".
4811
+ # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" For examples:"projects/my-logging-
4812
+ # project" "organizations/123456789"
4317
4813
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
4318
4814
  # @param [String] fields
4319
4815
  # Selector specifying which fields to include in a partial response.
@@ -4349,8 +4845,8 @@ module Google
4349
4845
  # Required. The resource name of an existing exclusion to delete: "projects/[
4350
4846
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
4351
4847
  # exclusions/[EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[
4352
- # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "
4353
- # projects/my-project-id/exclusions/my-exclusion-id".
4848
+ # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"
4849
+ # projects/my-project/exclusions/my-exclusion"
4354
4850
  # @param [String] fields
4355
4851
  # Selector specifying which fields to include in a partial response.
4356
4852
  # @param [String] quota_user
@@ -4383,8 +4879,8 @@ module Google
4383
4879
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
4384
4880
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
4385
4881
  # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
4386
- # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
4387
- # id/exclusions/my-exclusion-id".
4882
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
4883
+ # project/exclusions/my-exclusion"
4388
4884
  # @param [String] fields
4389
4885
  # Selector specifying which fields to include in a partial response.
4390
4886
  # @param [String] quota_user
@@ -4460,8 +4956,8 @@ module Google
4460
4956
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
4461
4957
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
4462
4958
  # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
4463
- # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
4464
- # id/exclusions/my-exclusion-id".
4959
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
4960
+ # project/exclusions/my-exclusion"
4465
4961
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
4466
4962
  # @param [String] update_mask
4467
4963
  # Required. A non-empty list of fields to change in the existing exclusion. New
@@ -4573,12 +5069,12 @@ module Google
4573
5069
  execute_or_queue_command(command, &block)
4574
5070
  end
4575
5071
 
4576
- # Creates a bucket that can be used to store log entries. Once a bucket has been
4577
- # created, the region cannot be changed.
5072
+ # Creates a log bucket that can be used to store log entries. After a bucket has
5073
+ # been created, the bucket's location cannot be changed.
4578
5074
  # @param [String] parent
4579
- # Required. The resource in which to create the bucket: "projects/[PROJECT_ID]/
4580
- # locations/[LOCATION_ID]" Example: "projects/my-logging-project/locations/
4581
- # global"
5075
+ # Required. The resource in which to create the log bucket: "projects/[
5076
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
5077
+ # locations/global"
4582
5078
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
4583
5079
  # @param [String] bucket_id
4584
5080
  # Required. A client-assigned identifier such as "my-bucket". Identifiers are
@@ -4614,16 +5110,16 @@ module Google
4614
5110
  execute_or_queue_command(command, &block)
4615
5111
  end
4616
5112
 
4617
- # Deletes a bucket. Moves the bucket to the DELETE_REQUESTED state. After 7 days,
4618
- # the bucket will be purged and all logs in the bucket will be permanently
4619
- # deleted.
5113
+ # Deletes a log bucket.Changes the bucket's lifecycle_state to the
5114
+ # DELETE_REQUESTED state. After 7 days, the bucket will be purged and all log
5115
+ # entries in the bucket will be permanently deleted.
4620
5116
  # @param [String] name
4621
5117
  # Required. The full resource name of the bucket to delete. "projects/[
4622
5118
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
4623
5119
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
4624
5120
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
4625
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
4626
- # project-id/locations/my-location/buckets/my-bucket-id".
5121
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
5122
+ # my-project/locations/global/buckets/my-bucket"
4627
5123
  # @param [String] fields
4628
5124
  # Selector specifying which fields to include in a partial response.
4629
5125
  # @param [String] quota_user
@@ -4651,14 +5147,14 @@ module Google
4651
5147
  execute_or_queue_command(command, &block)
4652
5148
  end
4653
5149
 
4654
- # Gets a bucket.
5150
+ # Gets a log bucket.
4655
5151
  # @param [String] name
4656
5152
  # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
4657
5153
  # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
4658
5154
  # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
4659
5155
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[
4660
- # LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-project-id/locations/
4661
- # my-location/buckets/my-bucket-id".
5156
+ # LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/
5157
+ # global/buckets/my-bucket"
4662
5158
  # @param [String] fields
4663
5159
  # Selector specifying which fields to include in a partial response.
4664
5160
  # @param [String] quota_user
@@ -4686,7 +5182,7 @@ module Google
4686
5182
  execute_or_queue_command(command, &block)
4687
5183
  end
4688
5184
 
4689
- # Lists buckets.
5185
+ # Lists log buckets.
4690
5186
  # @param [String] parent
4691
5187
  # Required. The parent resource whose buckets are to be listed: "projects/[
4692
5188
  # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -4732,27 +5228,27 @@ module Google
4732
5228
  execute_or_queue_command(command, &block)
4733
5229
  end
4734
5230
 
4735
- # Updates a bucket. This method replaces the following fields in the existing
4736
- # bucket with values from the new bucket: retention_periodIf the retention
4737
- # period is decreased and the bucket is locked, FAILED_PRECONDITION will be
4738
- # returned.If the bucket has a LifecycleState of DELETE_REQUESTED,
4739
- # FAILED_PRECONDITION will be returned.A buckets region may not be modified
4740
- # after it is created.
5231
+ # Updates a log bucket. This method replaces the following fields in the
5232
+ # existing bucket with values from the new bucket: retention_periodIf the
5233
+ # retention period is decreased and the bucket is locked, FAILED_PRECONDITION
5234
+ # will be returned.If the bucket has a lifecycle_state of DELETE_REQUESTED, then
5235
+ # FAILED_PRECONDITION will be returned.After a bucket has been created, the
5236
+ # bucket's location cannot be changed.
4741
5237
  # @param [String] name
4742
5238
  # Required. The full resource name of the bucket to update. "projects/[
4743
5239
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
4744
5240
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
4745
5241
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
4746
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
4747
- # project-id/locations/my-location/buckets/my-bucket-id". Also requires
4748
- # permission "resourcemanager.projects.updateLiens" to set the locked property
5242
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
5243
+ # my-project/locations/global/buckets/my-bucket"
4749
5244
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
4750
5245
  # @param [String] update_mask
4751
5246
  # Required. Field mask that specifies the fields in bucket that need an update.
4752
5247
  # A bucket field will be overwritten if, and only if, it is in the update mask.
4753
5248
  # name and output only fields cannot be updated.For a detailed FieldMask
4754
- # definition, see https://developers.google.com/protocol-buffers/docs/reference/
4755
- # google.protobuf#google.protobuf.FieldMaskExample: updateMask=retention_days.
5249
+ # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
5250
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
5251
+ # retention_days
4756
5252
  # @param [String] fields
4757
5253
  # Selector specifying which fields to include in a partial response.
4758
5254
  # @param [String] quota_user
@@ -4783,15 +5279,15 @@ module Google
4783
5279
  execute_or_queue_command(command, &block)
4784
5280
  end
4785
5281
 
4786
- # Undeletes a bucket. A bucket that has been deleted may be undeleted within the
4787
- # grace period of 7 days.
5282
+ # Undeletes a log bucket. A bucket that has been deleted can be undeleted within
5283
+ # the grace period of 7 days.
4788
5284
  # @param [String] name
4789
5285
  # Required. The full resource name of the bucket to undelete. "projects/[
4790
5286
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
4791
5287
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
4792
5288
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
4793
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
4794
- # project-id/locations/my-location/buckets/my-bucket-id".
5289
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
5290
+ # my-project/locations/global/buckets/my-bucket"
4795
5291
  # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_request_object
4796
5292
  # @param [String] fields
4797
5293
  # Selector specifying which fields to include in a partial response.
@@ -4822,12 +5318,12 @@ module Google
4822
5318
  execute_or_queue_command(command, &block)
4823
5319
  end
4824
5320
 
4825
- # Creates a view over logs in a bucket. A bucket may contain a maximum of 50
4826
- # views.
5321
+ # Creates a view over log entries in a log bucket. A bucket may contain a
5322
+ # maximum of 30 views.
4827
5323
  # @param [String] parent
4828
- # Required. The bucket in which to create the view "projects/[PROJECT_ID]/
4829
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-logging-
4830
- # project/locations/my-location/buckets/my-bucket"
5324
+ # Required. The bucket in which to create the view `"projects/[PROJECT_ID]/
5325
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"` For example:"projects/my-project/
5326
+ # locations/global/buckets/my-bucket"
4831
5327
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
4832
5328
  # @param [String] view_id
4833
5329
  # Required. The id to use for this view.
@@ -4861,12 +5357,11 @@ module Google
4861
5357
  execute_or_queue_command(command, &block)
4862
5358
  end
4863
5359
 
4864
- # Deletes a view from a bucket.
5360
+ # Deletes a view on a log bucket.
4865
5361
  # @param [String] name
4866
5362
  # Required. The full resource name of the view to delete: "projects/[PROJECT_ID]/
4867
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
4868
- # projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
4869
- # view-id".
5363
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
5364
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
4870
5365
  # @param [String] fields
4871
5366
  # Selector specifying which fields to include in a partial response.
4872
5367
  # @param [String] quota_user
@@ -4894,11 +5389,11 @@ module Google
4894
5389
  execute_or_queue_command(command, &block)
4895
5390
  end
4896
5391
 
4897
- # Gets a view.
5392
+ # Gets a view on a log bucket..
4898
5393
  # @param [String] name
4899
5394
  # Required. The resource name of the policy: "projects/[PROJECT_ID]/locations/[
4900
- # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "projects/my-
4901
- # project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id".
5395
+ # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-
5396
+ # project/locations/global/buckets/my-bucket/views/my-view"
4902
5397
  # @param [String] fields
4903
5398
  # Selector specifying which fields to include in a partial response.
4904
5399
  # @param [String] quota_user
@@ -4926,12 +5421,12 @@ module Google
4926
5421
  execute_or_queue_command(command, &block)
4927
5422
  end
4928
5423
 
4929
- # Lists views on a bucket.
5424
+ # Lists views on a log bucket.
4930
5425
  # @param [String] parent
4931
5426
  # Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
4932
5427
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
4933
5428
  # @param [Fixnum] page_size
4934
- # Optional. The maximum number of results to return from this request. Non-
5429
+ # Optional. The maximum number of results to return from this request.Non-
4935
5430
  # positive values are ignored. The presence of nextPageToken in the response
4936
5431
  # indicates that more results might be available.
4937
5432
  # @param [String] page_token
@@ -4968,20 +5463,19 @@ module Google
4968
5463
  execute_or_queue_command(command, &block)
4969
5464
  end
4970
5465
 
4971
- # Updates a view. This method replaces the following fields in the existing view
4972
- # with values from the new view: filter.
5466
+ # Updates a view on a log bucket. This method replaces the following fields in
5467
+ # the existing view with values from the new view: filter.
4973
5468
  # @param [String] name
4974
5469
  # Required. The full resource name of the view to update "projects/[PROJECT_ID]/
4975
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
4976
- # projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
4977
- # view-id".
5470
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
5471
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
4978
5472
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
4979
5473
  # @param [String] update_mask
4980
5474
  # Optional. Field mask that specifies the fields in view that need an update. A
4981
5475
  # field will be overwritten if, and only if, it is in the update mask. name and
4982
5476
  # output only fields cannot be updated.For a detailed FieldMask definition, see
4983
5477
  # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
4984
- # google.protobuf.FieldMaskExample: updateMask=filter.
5478
+ # google.protobuf.FieldMaskFor example: updateMask=filter
4985
5479
  # @param [String] fields
4986
5480
  # Selector specifying which fields to include in a partial response.
4987
5481
  # @param [String] quota_user
@@ -5012,6 +5506,123 @@ module Google
5012
5506
  execute_or_queue_command(command, &block)
5013
5507
  end
5014
5508
 
5509
+ # Starts asynchronous cancellation on a long-running operation. The server makes
5510
+ # a best effort to cancel the operation, but success is not guaranteed. If the
5511
+ # server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.
5512
+ # Clients can use Operations.GetOperation or other methods to check whether the
5513
+ # cancellation succeeded or whether the operation completed despite cancellation.
5514
+ # On successful cancellation, the operation is not deleted; instead, it becomes
5515
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
5516
+ # corresponding to Code.CANCELLED.
5517
+ # @param [String] name
5518
+ # The name of the operation resource to be cancelled.
5519
+ # @param [Google::Apis::LoggingV2::CancelOperationRequest] cancel_operation_request_object
5520
+ # @param [String] fields
5521
+ # Selector specifying which fields to include in a partial response.
5522
+ # @param [String] quota_user
5523
+ # Available to use for quota purposes for server-side applications. Can be any
5524
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5525
+ # @param [Google::Apis::RequestOptions] options
5526
+ # Request-specific options
5527
+ #
5528
+ # @yield [result, err] Result & error if block supplied
5529
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
5530
+ # @yieldparam err [StandardError] error object if request failed
5531
+ #
5532
+ # @return [Google::Apis::LoggingV2::Empty]
5533
+ #
5534
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5535
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5536
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5537
+ def cancel_project_location_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
5538
+ command = make_simple_command(:post, 'v2/{+name}:cancel', options)
5539
+ command.request_representation = Google::Apis::LoggingV2::CancelOperationRequest::Representation
5540
+ command.request_object = cancel_operation_request_object
5541
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
5542
+ command.response_class = Google::Apis::LoggingV2::Empty
5543
+ command.params['name'] = name unless name.nil?
5544
+ command.query['fields'] = fields unless fields.nil?
5545
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5546
+ execute_or_queue_command(command, &block)
5547
+ end
5548
+
5549
+ # Gets the latest state of a long-running operation. Clients can use this method
5550
+ # to poll the operation result at intervals as recommended by the API service.
5551
+ # @param [String] name
5552
+ # The name of the operation resource.
5553
+ # @param [String] fields
5554
+ # Selector specifying which fields to include in a partial response.
5555
+ # @param [String] quota_user
5556
+ # Available to use for quota purposes for server-side applications. Can be any
5557
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5558
+ # @param [Google::Apis::RequestOptions] options
5559
+ # Request-specific options
5560
+ #
5561
+ # @yield [result, err] Result & error if block supplied
5562
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
5563
+ # @yieldparam err [StandardError] error object if request failed
5564
+ #
5565
+ # @return [Google::Apis::LoggingV2::Operation]
5566
+ #
5567
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5568
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5569
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5570
+ def get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
5571
+ command = make_simple_command(:get, 'v2/{+name}', options)
5572
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
5573
+ command.response_class = Google::Apis::LoggingV2::Operation
5574
+ command.params['name'] = name unless name.nil?
5575
+ command.query['fields'] = fields unless fields.nil?
5576
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5577
+ execute_or_queue_command(command, &block)
5578
+ end
5579
+
5580
+ # Lists operations that match the specified filter in the request. If the server
5581
+ # doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name binding
5582
+ # allows API services to override the binding to use different resource name
5583
+ # schemes, such as users/*/operations. To override the binding, API services can
5584
+ # add a binding such as "/v1/`name=users/*`/operations" to their service
5585
+ # configuration. For backwards compatibility, the default name includes the
5586
+ # operations collection id, however overriding users must ensure the name
5587
+ # binding is the parent resource, without the operations collection id.
5588
+ # @param [String] name
5589
+ # The name of the operation's parent resource.
5590
+ # @param [String] filter
5591
+ # The standard list filter.
5592
+ # @param [Fixnum] page_size
5593
+ # The standard list page size.
5594
+ # @param [String] page_token
5595
+ # The standard list page token.
5596
+ # @param [String] fields
5597
+ # Selector specifying which fields to include in a partial response.
5598
+ # @param [String] quota_user
5599
+ # Available to use for quota purposes for server-side applications. Can be any
5600
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5601
+ # @param [Google::Apis::RequestOptions] options
5602
+ # Request-specific options
5603
+ #
5604
+ # @yield [result, err] Result & error if block supplied
5605
+ # @yieldparam result [Google::Apis::LoggingV2::ListOperationsResponse] parsed result object
5606
+ # @yieldparam err [StandardError] error object if request failed
5607
+ #
5608
+ # @return [Google::Apis::LoggingV2::ListOperationsResponse]
5609
+ #
5610
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5611
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5612
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5613
+ def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
5614
+ command = make_simple_command(:get, 'v2/{+name}/operations', options)
5615
+ command.response_representation = Google::Apis::LoggingV2::ListOperationsResponse::Representation
5616
+ command.response_class = Google::Apis::LoggingV2::ListOperationsResponse
5617
+ command.params['name'] = name unless name.nil?
5618
+ command.query['filter'] = filter unless filter.nil?
5619
+ command.query['pageSize'] = page_size unless page_size.nil?
5620
+ command.query['pageToken'] = page_token unless page_token.nil?
5621
+ command.query['fields'] = fields unless fields.nil?
5622
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5623
+ execute_or_queue_command(command, &block)
5624
+ end
5625
+
5015
5626
  # Deletes all the log entries in a log for the _Default Log Bucket. The log
5016
5627
  # reappears if it receives new entries. Log entries written shortly before the
5017
5628
  # delete operation might not be deleted. Entries received after the delete
@@ -5285,14 +5896,14 @@ module Google
5285
5896
  # @param [String] parent
5286
5897
  # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" "
5287
5898
  # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" "
5288
- # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/
5289
- # 123456789".
5899
+ # folders/[FOLDER_ID]" For examples:"projects/my-project" "organizations/
5900
+ # 123456789"
5290
5901
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
5291
5902
  # @param [Boolean] unique_writer_identity
5292
5903
  # Optional. Determines the kind of IAM identity returned as writer_identity in
5293
5904
  # the new sink. If this value is omitted or set to false, and if the sink's
5294
5905
  # parent is a project, then the value returned as writer_identity is the same
5295
- # group or service account used by Logging before the addition of writer
5906
+ # group or service account used by Cloud Logging before the addition of writer
5296
5907
  # identities to this API. The sink's destination must be in the same project as
5297
5908
  # the sink itself.If this field is set to true, or if the sink is owned by a non-
5298
5909
  # project resource such as an organization, then the value of writer_identity
@@ -5334,8 +5945,8 @@ module Google
5334
5945
  # Required. The full resource name of the sink to delete, including the parent
5335
5946
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
5336
5947
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
5337
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
5338
- # Example: "projects/my-project-id/sinks/my-sink-id".
5948
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
5949
+ # example:"projects/my-project/sinks/my-sink"
5339
5950
  # @param [String] fields
5340
5951
  # Selector specifying which fields to include in a partial response.
5341
5952
  # @param [String] quota_user
@@ -5367,8 +5978,8 @@ module Google
5367
5978
  # @param [String] sink_name
5368
5979
  # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID]
5369
5980
  # " "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
5370
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
5371
- # Example: "projects/my-project-id/sinks/my-sink-id".
5981
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
5982
+ # example:"projects/my-project/sinks/my-sink"
5372
5983
  # @param [String] fields
5373
5984
  # Selector specifying which fields to include in a partial response.
5374
5985
  # @param [String] quota_user
@@ -5446,8 +6057,8 @@ module Google
5446
6057
  # Required. The full resource name of the sink to update, including the parent
5447
6058
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
5448
6059
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
5449
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
5450
- # Example: "projects/my-project-id/sinks/my-sink-id".
6060
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
6061
+ # example:"projects/my-project/sinks/my-sink"
5451
6062
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
5452
6063
  # @param [Boolean] unique_writer_identity
5453
6064
  # Optional. See sinks.create for a description of this field. When updating a
@@ -5463,10 +6074,11 @@ module Google
5463
6074
  # sink field will be overwritten if, and only if, it is in the update mask. name
5464
6075
  # and output only fields cannot be updated.An empty updateMask is temporarily
5465
6076
  # treated as using the following mask for backwards compatibility purposes:
5466
- # destination,filter,includeChildren At some point in the future, behavior will
6077
+ # destination,filter,includeChildrenAt some point in the future, behavior will
5467
6078
  # be removed and specifying an empty updateMask will be an error.For a detailed
5468
6079
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
5469
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
6080
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
6081
+ # filter
5470
6082
  # @param [String] fields
5471
6083
  # Selector specifying which fields to include in a partial response.
5472
6084
  # @param [String] quota_user
@@ -5505,8 +6117,8 @@ module Google
5505
6117
  # Required. The full resource name of the sink to update, including the parent
5506
6118
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
5507
6119
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
5508
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
5509
- # Example: "projects/my-project-id/sinks/my-sink-id".
6120
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
6121
+ # example:"projects/my-project/sinks/my-sink"
5510
6122
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
5511
6123
  # @param [Boolean] unique_writer_identity
5512
6124
  # Optional. See sinks.create for a description of this field. When updating a
@@ -5522,10 +6134,11 @@ module Google
5522
6134
  # sink field will be overwritten if, and only if, it is in the update mask. name
5523
6135
  # and output only fields cannot be updated.An empty updateMask is temporarily
5524
6136
  # treated as using the following mask for backwards compatibility purposes:
5525
- # destination,filter,includeChildren At some point in the future, behavior will
6137
+ # destination,filter,includeChildrenAt some point in the future, behavior will
5526
6138
  # be removed and specifying an empty updateMask will be an error.For a detailed
5527
6139
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
5528
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
6140
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
6141
+ # filter
5529
6142
  # @param [String] fields
5530
6143
  # Selector specifying which fields to include in a partial response.
5531
6144
  # @param [String] quota_user
@@ -5564,14 +6177,14 @@ module Google
5564
6177
  # @param [String] parent
5565
6178
  # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" "
5566
6179
  # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" "
5567
- # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/
5568
- # 123456789".
6180
+ # folders/[FOLDER_ID]" For examples:"projects/my-project" "organizations/
6181
+ # 123456789"
5569
6182
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
5570
6183
  # @param [Boolean] unique_writer_identity
5571
6184
  # Optional. Determines the kind of IAM identity returned as writer_identity in
5572
6185
  # the new sink. If this value is omitted or set to false, and if the sink's
5573
6186
  # parent is a project, then the value returned as writer_identity is the same
5574
- # group or service account used by Logging before the addition of writer
6187
+ # group or service account used by Cloud Logging before the addition of writer
5575
6188
  # identities to this API. The sink's destination must be in the same project as
5576
6189
  # the sink itself.If this field is set to true, or if the sink is owned by a non-
5577
6190
  # project resource such as an organization, then the value of writer_identity
@@ -5613,8 +6226,8 @@ module Google
5613
6226
  # Required. The full resource name of the sink to delete, including the parent
5614
6227
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
5615
6228
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
5616
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
5617
- # Example: "projects/my-project-id/sinks/my-sink-id".
6229
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
6230
+ # example:"projects/my-project/sinks/my-sink"
5618
6231
  # @param [String] fields
5619
6232
  # Selector specifying which fields to include in a partial response.
5620
6233
  # @param [String] quota_user
@@ -5646,8 +6259,8 @@ module Google
5646
6259
  # @param [String] sink_name
5647
6260
  # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID]
5648
6261
  # " "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
5649
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
5650
- # Example: "projects/my-project-id/sinks/my-sink-id".
6262
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
6263
+ # example:"projects/my-project/sinks/my-sink"
5651
6264
  # @param [String] fields
5652
6265
  # Selector specifying which fields to include in a partial response.
5653
6266
  # @param [String] quota_user
@@ -5725,8 +6338,8 @@ module Google
5725
6338
  # Required. The full resource name of the sink to update, including the parent
5726
6339
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
5727
6340
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
5728
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
5729
- # Example: "projects/my-project-id/sinks/my-sink-id".
6341
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
6342
+ # example:"projects/my-project/sinks/my-sink"
5730
6343
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
5731
6344
  # @param [Boolean] unique_writer_identity
5732
6345
  # Optional. See sinks.create for a description of this field. When updating a
@@ -5742,10 +6355,11 @@ module Google
5742
6355
  # sink field will be overwritten if, and only if, it is in the update mask. name
5743
6356
  # and output only fields cannot be updated.An empty updateMask is temporarily
5744
6357
  # treated as using the following mask for backwards compatibility purposes:
5745
- # destination,filter,includeChildren At some point in the future, behavior will
6358
+ # destination,filter,includeChildrenAt some point in the future, behavior will
5746
6359
  # be removed and specifying an empty updateMask will be an error.For a detailed
5747
6360
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
5748
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
6361
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
6362
+ # filter
5749
6363
  # @param [String] fields
5750
6364
  # Selector specifying which fields to include in a partial response.
5751
6365
  # @param [String] quota_user
@@ -5786,7 +6400,7 @@ module Google
5786
6400
  # Required. The resource for which to retrieve CMEK settings. "projects/[
5787
6401
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
5788
6402
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
5789
- # cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the
6403
+ # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
5790
6404
  # Logs Router can currently only be configured for GCP organizations. Once
5791
6405
  # configured, it applies to all projects and folders in the GCP organization.
5792
6406
  # @param [String] fields
@@ -5828,15 +6442,15 @@ module Google
5828
6442
  # Required. The resource name for the CMEK settings to update. "projects/[
5829
6443
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
5830
6444
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
5831
- # cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the
6445
+ # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
5832
6446
  # Logs Router can currently only be configured for GCP organizations. Once
5833
6447
  # configured, it applies to all projects and folders in the GCP organization.
5834
6448
  # @param [Google::Apis::LoggingV2::CmekSettings] cmek_settings_object
5835
6449
  # @param [String] update_mask
5836
6450
  # Optional. Field mask identifying which fields from cmek_settings should be
5837
6451
  # updated. A field will be overwritten if and only if it is in the update mask.
5838
- # Output only fields cannot be updated.See FieldMask for more information.
5839
- # Example: "updateMask=kmsKeyName"
6452
+ # Output only fields cannot be updated.See FieldMask for more information.For
6453
+ # example: "updateMask=kmsKeyName"
5840
6454
  # @param [String] fields
5841
6455
  # Selector specifying which fields to include in a partial response.
5842
6456
  # @param [String] quota_user